feat: CModule support

Author: std-microblock

deps/libffi.lua

@@ -0,0 +1,12 @@
+package("libtcc")
+    set_homepage("https://bellard.org/tcc/")
+    set_description("Tiny C Compiler")
+
+    set_urls("https://github.com/std-microblock/tinycc.git")
+    add_versions("2026.03.30+1", "38caec5487b44da82ed9b25699e13cdab8845b77")
+
+    add_configs("shared", {description = "Build shared library.", default = false, type = "boolean", readonly = true})
+
+    on_install(function(package)
+        import("package.tools.xmake").install(package)
+    end)

deps/libtcc.lua

@@ -15,3 +15,4 @@
 #include "native_memory_access_monitor.h"
 #include "native_process.h"
 #include "script_lifecycle.h"
+#include "native_cmodule.h"

src/core/bindings/binding_types.h

@@ -836,6 +836,30 @@ template<> struct js_bind<chromatic::js::ScriptLifecycle> {
     }
 };
 
+template <> struct qjs::js_traits<chromatic::js::NativeCModule> {
+    static chromatic::js::NativeCModule unwrap(JSContext *ctx, JSValueConst v) {
+        chromatic::js::NativeCModule obj;
+
+        return obj;
+    }
+
+    static JSValue wrap(JSContext *ctx, const chromatic::js::NativeCModule &val) noexcept {
+        JSValue obj = JS_NewObject(ctx);
+
+        return obj;
+    }
+};
+template<> struct js_bind<chromatic::js::NativeCModule> {
+    static void bind(qjs::Context::Module &mod) {
+        mod.class_<chromatic::js::NativeCModule>("NativeCModule")
+            .constructor<std::string, std::vector<std::string>, std::vector<uint64_t>>()
+                .fun<&chromatic::js::NativeCModule::getSymbol>("getSymbol")
+                .fun<&chromatic::js::NativeCModule::listSymbols>("listSymbols")
+                .fun<&chromatic::js::NativeCModule::dispose>("dispose")
+            ;
+    }
+};
+
 inline void chromatic_bindAll(qjs::Context::Module &mod) {
 
     js_bind<chromatic::js::NativePointer>::bind(mod);
@@ -882,4 +906,6 @@ inline void chromatic_bindAll(qjs::Context::Module &mod) {
 
     js_bind<chromatic::js::ScriptLifecycle>::bind(mod);
 
+    js_bind<chromatic::js::NativeCModule>::bind(mod);
+
 }

src/core/bindings/generated_bindings/binding_qjs.h

@@ -930,5 +930,26 @@ export class ScriptLifecycle {
      */
     static _callDisposeCallbacks(): void
 }
+export class NativeCModule {
+	constructor(code: string, symbolNames: Array<string>, symbolAddresses: Array<number>);
+	/**
+     *  Get the address of a named exported symbol. Returns null pointer if not
+     *  found.
+     * @param name: string
+     * @returns NativePointer
+     */
+    getSymbol(name: string): NativePointer
+	/**
+     *  Get all exported global symbol names.
+      @returns Array<string>
+     */
+    listSymbols(): Array<string>
+	/**
+     *  Eagerly unmap the module from memory.
+     *  Calls void finalize(void) if defined, then frees the TCC state.
+      @returns void
+     */
+    dispose(): void
+}
 }