react-native-gtkx 0.1.0-alpha.1

package/dist/metro/index.js

@@ -0,0 +1,119 @@
+// Metro preset for the linux out-of-tree platform: wrap the app's Metro
+// config with `withLinuxPlatform` and the standard RN toolchain bundles for
+// `--platform linux`.
+//
+// What it does on top of RN defaults (validated by spike/rn-platform):
+//
+// 1. Adds "linux" to resolver.platforms (`.linux.tsx` extensions and
+//    Platform.OS come along with it).
+// 2. Redirects `react-native` (and subpaths) to `react-native-gtkx` — the
+//    out-of-tree npmPackageName declaration alone does not alias imports
+//    for `bundle`, the resolver has to.
+// 3. EXTERNALIZES host-side singletons. Unlike react-native-windows, whose
+//    native side lives outside the JS bundle by construction, our "native"
+//    is Node modules with NAPI bindings (@gtkx/*) plus yoga-layout's WASM —
+//    Metro cannot bundle those. react (and its jsx runtimes) must also stay
+//    host-side: the reconciler inside @gtkx/react and the app have to share
+//    one React instance. Every external resolves to a generated proxy that
+//    reads the real module from global.__hostModules — the run-linux host
+//    injects them before executing the bundle.
+// 4. Proxies Node builtins through the host's require: apps on this
+//    platform may use the whole Node API, it is a platform feature.
+// 5. Drops InitializeCore (RN's mobile environment polyfills): the runtime
+//    environment IS Node, the host provides everything.
+import { mkdirSync, writeFileSync } from "node:fs";
+import { builtinModules, isBuiltin } from "node:module";
+import { join } from "node:path";
+/** Modules the run-linux host provides to the bundle at runtime. */
+export const HOST_MODULE_EXTERNALS = [
+    "@gtkx/css",
+    "@gtkx/gi/adw",
+    "@gtkx/gi/gdk",
+    "@gtkx/gi/gio",
+    "@gtkx/gi/glib",
+    "@gtkx/gi/graphene",
+    "@gtkx/gi/gsk",
+    "@gtkx/gi/gtk",
+    "@gtkx/gi/pango",
+    "@gtkx/jsx/gtk",
+    "@gtkx/react",
+    "@gtkx/runtime",
+    "react",
+    "react/jsx-runtime",
+    "react/jsx-dev-runtime",
+    "yoga-layout",
+];
+export const LINUX_PLATFORM = "linux";
+const sanitize = (name) => name.replace(/[@/:]/g, "_") + ".js";
+const hostModuleProxy = (name) => 
+// The run-linux host guarantees __hostModules before executing the bundle.
+`module.exports = global.__hostModules[${JSON.stringify(name)}]\n`;
+const builtinProxy = (name) => `module.exports = global.__hostRequire(${JSON.stringify(name)})\n`;
+// Every proxy is generated eagerly when the config loads: Metro crawls the
+// file map before transforming, and files that appear mid-build lose the
+// race ("Failed to get the SHA-1"). The builtin list is finite, so the
+// whole proxy set can exist up front.
+const generateProxies = (dir, externals) => {
+    mkdirSync(dir, { recursive: true });
+    for (const name of externals) {
+        writeFileSync(join(dir, sanitize(name)), hostModuleProxy(name));
+    }
+    for (const bare of builtinModules) {
+        writeFileSync(join(dir, sanitize(bare)), builtinProxy(bare));
+        writeFileSync(join(dir, sanitize(`node:${bare}`)), builtinProxy(`node:${bare}`));
+    }
+};
+/**
+ * Wraps a Metro config (RN's getDefaultConfig output) with everything the
+ * linux platform needs. Composes with an existing custom resolveRequest —
+ * non-linux platforms fall through to it untouched.
+ */
+export const withLinuxPlatform = (config, options = {}) => {
+    const externals = new Set([
+        ...HOST_MODULE_EXTERNALS,
+        ...(options.externals ?? []),
+    ]);
+    const proxyDir = options.proxyDir ??
+        join(config.projectRoot ?? process.cwd(), "node_modules", ".react-native-gtkx", "metro-externals");
+    generateProxies(proxyDir, externals);
+    const previousResolve = config.resolver?.resolveRequest ?? null;
+    const fallback = (context, moduleName, platform) => previousResolve
+        ? previousResolve(context, moduleName, platform)
+        : context.resolveRequest(context, moduleName, platform);
+    const resolveRequest = (context, moduleName, platform) => {
+        if (platform !== LINUX_PLATFORM) {
+            return fallback(context, moduleName, platform);
+        }
+        if (externals.has(moduleName) || isBuiltin(moduleName)) {
+            return {
+                type: "sourceFile",
+                filePath: join(proxyDir, sanitize(moduleName)),
+            };
+        }
+        if (moduleName === "react-native" ||
+            moduleName.startsWith("react-native/")) {
+            return fallback(context, moduleName.replace(/^react-native/, "react-native-gtkx"), platform);
+        }
+        return fallback(context, moduleName, platform);
+    };
+    // The cast: T may carry narrower resolver/serializer types than the ones
+    // rebuilt here — the runtime shape is a strict superset of both.
+    return {
+        ...config,
+        resolver: {
+            ...config.resolver,
+            platforms: [
+                ...new Set([...(config.resolver?.platforms ?? []), LINUX_PLATFORM]),
+            ],
+            resolveRequest,
+        },
+        serializer: {
+            ...config.serializer,
+            // RN prepends InitializeCore (Hermes Promise, nativeLoggingHook
+            // console...). Our runtime environment IS Node — nothing to
+            // initialize inside the bundle.
+            getModulesRunBeforeMainModule: () => [],
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/metro/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metro/index.ts"],"names":[],"mappings":"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","sourcesContent":["// Metro preset for the linux out-of-tree platform: wrap the app's Metro\n// config with `withLinuxPlatform` and the standard RN toolchain bundles for\n// `--platform linux`.\n//\n// What it does on top of RN defaults (validated by spike/rn-platform):\n//\n// 1. Adds \"linux\" to resolver.platforms (`.linux.tsx` extensions and\n//    Platform.OS come along with it).\n// 2. Redirects `react-native` (and subpaths) to `react-native-gtkx` — the\n//    out-of-tree npmPackageName declaration alone does not alias imports\n//    for `bundle`, the resolver has to.\n// 3. EXTERNALIZES host-side singletons. Unlike react-native-windows, whose\n//    native side lives outside the JS bundle by construction, our \"native\"\n//    is Node modules with NAPI bindings (@gtkx/*) plus yoga-layout's WASM —\n//    Metro cannot bundle those. react (and its jsx runtimes) must also stay\n//    host-side: the reconciler inside @gtkx/react and the app have to share\n//    one React instance. Every external resolves to a generated proxy that\n//    reads the real module from global.__hostModules — the run-linux host\n//    injects them before executing the bundle.\n// 4. Proxies Node builtins through the host's require: apps on this\n//    platform may use the whole Node API, it is a platform feature.\n// 5. Drops InitializeCore (RN's mobile environment polyfills): the runtime\n//    environment IS Node, the host provides everything.\nimport { mkdirSync, writeFileSync } from \"node:fs\"\nimport { builtinModules, isBuiltin } from \"node:module\"\nimport { join } from \"node:path\"\n\n/** Modules the run-linux host provides to the bundle at runtime. */\nexport const HOST_MODULE_EXTERNALS = [\n  \"@gtkx/css\",\n  \"@gtkx/gi/adw\",\n  \"@gtkx/gi/gdk\",\n  \"@gtkx/gi/gio\",\n  \"@gtkx/gi/glib\",\n  \"@gtkx/gi/graphene\",\n  \"@gtkx/gi/gsk\",\n  \"@gtkx/gi/gtk\",\n  \"@gtkx/gi/pango\",\n  \"@gtkx/jsx/gtk\",\n  \"@gtkx/react\",\n  \"@gtkx/runtime\",\n  \"react\",\n  \"react/jsx-runtime\",\n  \"react/jsx-dev-runtime\",\n  \"yoga-layout\",\n]\n\nexport const LINUX_PLATFORM = \"linux\"\n\n// Structural slices of Metro's config/resolution types: Metro is the app's\n// dependency, not ours — depending on its types here would pin versions.\nexport type MetroResolutionContext = {\n  resolveRequest: MetroResolver\n}\nexport type MetroResolution = { type: string; filePath?: string }\nexport type MetroResolver = (\n  context: MetroResolutionContext,\n  moduleName: string,\n  platform: string | null,\n) => MetroResolution\n\nexport type MetroLikeConfig = {\n  projectRoot?: string\n  resolver?: {\n    platforms?: readonly string[]\n    resolveRequest?: MetroResolver | null\n  }\n  serializer?: {\n    getModulesRunBeforeMainModule?: (entryFilePath: string) => string[]\n  }\n}\n\nexport type LinuxPlatformOptions = {\n  /** Extra host-provided modules to keep out of the bundle. */\n  externals?: readonly string[]\n  /** Proxy directory override (default: node_modules/.react-native-gtkx). */\n  proxyDir?: string\n}\n\nconst sanitize = (name: string): string => name.replace(/[@/:]/g, \"_\") + \".js\"\n\nconst hostModuleProxy = (name: string): string =>\n  // The run-linux host guarantees __hostModules before executing the bundle.\n  `module.exports = global.__hostModules[${JSON.stringify(name)}]\\n`\n\nconst builtinProxy = (name: string): string =>\n  `module.exports = global.__hostRequire(${JSON.stringify(name)})\\n`\n\n// Every proxy is generated eagerly when the config loads: Metro crawls the\n// file map before transforming, and files that appear mid-build lose the\n// race (\"Failed to get the SHA-1\"). The builtin list is finite, so the\n// whole proxy set can exist up front.\nconst generateProxies = (dir: string, externals: Set<string>): void => {\n  mkdirSync(dir, { recursive: true })\n  for (const name of externals) {\n    writeFileSync(join(dir, sanitize(name)), hostModuleProxy(name))\n  }\n  for (const bare of builtinModules) {\n    writeFileSync(join(dir, sanitize(bare)), builtinProxy(bare))\n    writeFileSync(\n      join(dir, sanitize(`node:${bare}`)),\n      builtinProxy(`node:${bare}`),\n    )\n  }\n}\n\nexport type LinuxPlatformConfig<T extends MetroLikeConfig> = T & {\n  resolver: {\n    platforms: string[]\n    resolveRequest: MetroResolver\n  }\n  serializer: {\n    getModulesRunBeforeMainModule: (entryFilePath: string) => string[]\n  }\n}\n\n/**\n * Wraps a Metro config (RN's getDefaultConfig output) with everything the\n * linux platform needs. Composes with an existing custom resolveRequest —\n * non-linux platforms fall through to it untouched.\n */\nexport const withLinuxPlatform = <T extends MetroLikeConfig>(\n  config: T,\n  options: LinuxPlatformOptions = {},\n): LinuxPlatformConfig<T> => {\n  const externals = new Set([\n    ...HOST_MODULE_EXTERNALS,\n    ...(options.externals ?? []),\n  ])\n  const proxyDir =\n    options.proxyDir ??\n    join(\n      config.projectRoot ?? process.cwd(),\n      \"node_modules\",\n      \".react-native-gtkx\",\n      \"metro-externals\",\n    )\n  generateProxies(proxyDir, externals)\n  const previousResolve = config.resolver?.resolveRequest ?? null\n\n  const fallback: MetroResolver = (context, moduleName, platform) =>\n    previousResolve\n      ? previousResolve(context, moduleName, platform)\n      : context.resolveRequest(context, moduleName, platform)\n\n  const resolveRequest: MetroResolver = (context, moduleName, platform) => {\n    if (platform !== LINUX_PLATFORM) {\n      return fallback(context, moduleName, platform)\n    }\n    if (externals.has(moduleName) || isBuiltin(moduleName)) {\n      return {\n        type: \"sourceFile\",\n        filePath: join(proxyDir, sanitize(moduleName)),\n      }\n    }\n    if (\n      moduleName === \"react-native\" ||\n      moduleName.startsWith(\"react-native/\")\n    ) {\n      return fallback(\n        context,\n        moduleName.replace(/^react-native/, \"react-native-gtkx\"),\n        platform,\n      )\n    }\n    return fallback(context, moduleName, platform)\n  }\n\n  // The cast: T may carry narrower resolver/serializer types than the ones\n  // rebuilt here — the runtime shape is a strict superset of both.\n  return {\n    ...config,\n    resolver: {\n      ...config.resolver,\n      platforms: [\n        ...new Set([...(config.resolver?.platforms ?? []), LINUX_PLATFORM]),\n      ],\n      resolveRequest,\n    },\n    serializer: {\n      ...config.serializer,\n      // RN prepends InitializeCore (Hermes Promise, nativeLoggingHook\n      // console...). Our runtime environment IS Node — nothing to\n      // initialize inside the bundle.\n      getModulesRunBeforeMainModule: () => [],\n    },\n  } as LinuxPlatformConfig<T>\n}\n"]}

package/dist/runner/host-dev.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runner/host-dev.js

@@ -0,0 +1,208 @@
+// The DEV host: fetch the dev bundle from a Metro dev server, execute it,
+// subscribe to HMR updates and let react-refresh re-render through the
+// @gtkx/react reconciler with component state preserved. Spawned by
+// `run-linux --dev` as `node dist/runner/host-dev.js <bundle-url>`; exits
+// with code 65 when a full refresh is required — the supervisor restarts.
+//
+// Division of labor (validated by spike/rn-platform, FINDINGS-dev.md):
+// metro-runtime's dev require scopes the react-refresh registration per
+// module and applies hot updates once global.__ReactRefresh exists; its
+// HMRClient speaks the /hot websocket protocol verbatim over Node's
+// global WebSocket. This file only adds the dev pieces on top of the
+// release host (./host.ts — deliberately self-contained twins: both must
+// stay runnable under bare Node, so they cannot share a relative
+// extensionless import).
+import { createRequire, registerHooks } from "node:module";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import vm from "node:vm";
+import { HOST_MODULE_EXTERNALS } from "react-native-gtkx/metro";
+const fail = (message) => {
+    console.error(`[react-native-gtkx] ${message}`);
+    process.exit(1);
+};
+if (typeof registerHooks !== "function") {
+    fail(`Node ${process.version} lacks module.registerHooks — the linux host needs Node >= 22.15.`);
+}
+// react and the reconciler must run their DEV builds for react-refresh.
+process.env.NODE_ENV = process.env.NODE_ENV ?? "development";
+const bundleUrl = process.argv[2];
+if (!bundleUrl) {
+    fail("usage: node host-dev.js <metro-dev-bundle-url>");
+}
+// Resolution anchors: react-refresh and metro-runtime ship with the APP's
+// react-native; @gtkx/* resolve as this package's dependencies; react must
+// be the exact instance the reconciler sees (see host.ts).
+const fromApp = createRequire(join(process.cwd(), "package.json"));
+const fromPackage = createRequire(import.meta.url);
+const fromGtkxReact = createRequire(fromPackage.resolve("@gtkx/react"));
+// --- react-refresh: inject BEFORE @gtkx/react loads (the reconciler
+// registers into the patched devtools hook).
+const RefreshRuntime = fromApp("react-refresh/runtime");
+RefreshRuntime.injectIntoGlobalHook(globalThis);
+globalThis.$RefreshReg$ = () => { };
+globalThis.$RefreshSig$ = () => (type) => type;
+globalThis.__ReactRefresh = {
+    ...RefreshRuntime,
+    performFullRefresh(reason) {
+        console.warn(`[react-native-gtkx] full refresh required (${reason}) — restarting`);
+        process.exit(65);
+    },
+};
+// --- virtual:gtkx-config (same mechanism as the release host).
+const { loadConfig } = await import(pathToFileURL(fromPackage.resolve("@gtkx/config")).href);
+const { config: gtkxConfig } = await loadConfig(process.cwd());
+if (!gtkxConfig.applicationId) {
+    fail("gtkx.config.ts with an applicationId is required in the app root " +
+        '(export default defineConfig({ applicationId: "...", libraries: [...] })).');
+}
+const configModuleUrl = new URL("./__virtual-gtkx-config.mjs", import.meta.url)
+    .href;
+const configModuleSource = [
+    `export * from "@gtkx/jsx/metadata";`,
+    `export const applicationId = ${JSON.stringify(gtkxConfig.applicationId)};`,
+].join("\n");
+registerHooks({
+    resolve(specifier, context, nextResolve) {
+        if (specifier === "virtual:gtkx-config") {
+            return { url: configModuleUrl, shortCircuit: true };
+        }
+        return nextResolve(specifier, context);
+    },
+    load(url, context, nextLoad) {
+        if (url === configModuleUrl) {
+            return {
+                format: "module",
+                source: configModuleSource,
+                shortCircuit: true,
+            };
+        }
+        return nextLoad(url, context);
+    },
+});
+// --- host modules (same interop merging as the release host).
+const resolveExternal = (name) => name === "react" || name.startsWith("react/")
+    ? fromGtkxReact.resolve(name)
+    : fromPackage.resolve(name);
+const load = async (name) => {
+    const namespace = await import(pathToFileURL(resolveExternal(name)).href);
+    const merged = { __esModule: true, ...namespace };
+    if (!("default" in namespace)) {
+        merged.default = namespace;
+    }
+    return merged;
+};
+globalThis.__hostModules = {};
+for (const name of HOST_MODULE_EXTERNALS) {
+    try {
+        globalThis.__hostModules[name] = await load(name);
+    }
+    catch (error) {
+        fail(`failed to load host module "${name}" — is the codegen store in ` +
+            `place (npx gtkx codegen) and GTK4/libadwaita installed?\n${String(error)}`);
+    }
+}
+globalThis.__hostRequire = createRequire(import.meta.url);
+// --- Dev Menu (Ctrl+Shift+D, the react-native-windows precedent).
+// Installed before the bundle runs so DevSettings.reload works from app
+// code; the key controller attaches once the app window exists.
+const requestReload = (reason) => {
+    console.warn(`[react-native-gtkx] reload requested${reason ? ` (${reason})` : ""} — restarting`);
+    return process.exit(65);
+};
+globalThis.__rnGtkxDevHost = { reload: requestReload };
+const installDevMenu = () => {
+    const gtk = globalThis.__hostModules["@gtkx/gi/gtk"];
+    const gdk = globalThis.__hostModules["@gtkx/gi/gdk"];
+    const adw = globalThis.__hostModules["@gtkx/gi/adw"];
+    const gio = globalThis.__hostModules["@gtkx/gi/gio"];
+    // GDK keysyms for latin letters equal their ASCII codes.
+    const KEY_UPPER_D = 0x44;
+    const KEY_LOWER_D = 0x64;
+    let menuOpen = false;
+    const openDevMenu = async (window) => {
+        if (menuOpen) {
+            return;
+        }
+        menuOpen = true;
+        try {
+            const items = globalThis.__rnGtkxDevMenuItems ?? [];
+            const dialog = new adw.AlertDialog();
+            dialog.setHeading("React Native Dev Menu");
+            dialog.setBody(bundleUrl);
+            dialog.addResponse("cancel", "Cancel");
+            items.forEach((item, index) => {
+                dialog.addResponse(`custom-${index}`, item.title);
+            });
+            dialog.addResponse("reload", "Reload");
+            dialog.setResponseAppearance("reload", adw.ResponseAppearance.SUGGESTED);
+            dialog.setDefaultResponse("reload");
+            dialog.setCloseResponse("cancel");
+            const response = await dialog.choose(window);
+            if (response === "reload") {
+                requestReload();
+            }
+            const custom = /^custom-(\d+)$/.exec(response);
+            if (custom) {
+                items[Number(custom[1])]?.handler();
+            }
+        }
+        catch (error) {
+            console.error(`[react-native-gtkx] dev menu failed: ${String(error)}`);
+        }
+        finally {
+            menuOpen = false;
+        }
+    };
+    const attach = () => {
+        const window = gio.Application.getDefault()?.getActiveWindow?.();
+        if (!window) {
+            // The bundle opens the window asynchronously (application activate).
+            setTimeout(attach, 200);
+            return;
+        }
+        const controller = new gtk.EventControllerKey();
+        controller.on("key-pressed", (keyval, _keycode, state) => {
+            const modifiers = state;
+            const wanted = (modifiers & gdk.ModifierType.CONTROL_MASK) !== 0 &&
+                (modifiers & gdk.ModifierType.SHIFT_MASK) !== 0 &&
+                (keyval === KEY_UPPER_D || keyval === KEY_LOWER_D);
+            if (wanted) {
+                void openDevMenu(window);
+                return true;
+            }
+            return false;
+        });
+        window.addController(controller);
+        console.warn("[react-native-gtkx] dev menu ready (Ctrl+Shift+D)");
+    };
+    attach();
+};
+// --- fetch and run the dev bundle.
+let response;
+try {
+    response = await fetch(bundleUrl);
+}
+catch {
+    fail(`Metro dev server is not reachable (${bundleUrl}).`);
+    throw new Error("unreachable");
+}
+if (!response.ok) {
+    fail(`Metro returned ${response.status} for the dev bundle:\n${await response.text()}`);
+}
+vm.runInThisContext(await response.text(), { filename: bundleUrl });
+installDevMenu();
+const HMRClient = fromApp("metro-runtime/src/modules/HMRClient");
+const client = new HMRClient(bundleUrl.replace(/^http/, "ws").replace(/\/[^/]*$/, "/hot"));
+client.send(JSON.stringify({ type: "register-entrypoints", entryPoints: [bundleUrl] }));
+client.enable();
+client.on("update-done", () => {
+    console.warn("[react-native-gtkx] hot update applied");
+});
+client.on("error", (body) => {
+    console.error(`[react-native-gtkx] Metro error (${body?.type ?? "unknown"}):\n${body?.message ?? ""}`);
+});
+client.on("close", () => {
+    console.warn("[react-native-gtkx] HMR connection closed (the window keeps running without hot updates)");
+});
+//# sourceMappingURL=host-dev.js.map

package/dist/runner/host-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-dev.js","sourceRoot":"","sources":["../../src/runner/host-dev.ts"],"names":[],"mappings":"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","sourcesContent":["// The DEV host: fetch the dev bundle from a Metro dev server, execute it,\n// subscribe to HMR updates and let react-refresh re-render through the\n// @gtkx/react reconciler with component state preserved. Spawned by\n// `run-linux --dev` as `node dist/runner/host-dev.js <bundle-url>`; exits\n// with code 65 when a full refresh is required — the supervisor restarts.\n//\n// Division of labor (validated by spike/rn-platform, FINDINGS-dev.md):\n// metro-runtime's dev require scopes the react-refresh registration per\n// module and applies hot updates once global.__ReactRefresh exists; its\n// HMRClient speaks the /hot websocket protocol verbatim over Node's\n// global WebSocket. This file only adds the dev pieces on top of the\n// release host (./host.ts — deliberately self-contained twins: both must\n// stay runnable under bare Node, so they cannot share a relative\n// extensionless import).\nimport { createRequire, registerHooks } from \"node:module\"\nimport { join } from \"node:path\"\nimport { pathToFileURL } from \"node:url\"\nimport vm from \"node:vm\"\nimport { HOST_MODULE_EXTERNALS } from \"react-native-gtkx/metro\"\n\ntype HostModule = Record<string, unknown>\n\nconst fail = (message: string): never => {\n  console.error(`[react-native-gtkx] ${message}`)\n  process.exit(1)\n}\n\nif (typeof registerHooks !== \"function\") {\n  fail(\n    `Node ${process.version} lacks module.registerHooks — the linux host needs Node >= 22.15.`,\n  )\n}\n\n// react and the reconciler must run their DEV builds for react-refresh.\nprocess.env.NODE_ENV = process.env.NODE_ENV ?? \"development\"\n\nconst bundleUrl = process.argv[2]\nif (!bundleUrl) {\n  fail(\"usage: node host-dev.js <metro-dev-bundle-url>\")\n}\n\n// Resolution anchors: react-refresh and metro-runtime ship with the APP's\n// react-native; @gtkx/* resolve as this package's dependencies; react must\n// be the exact instance the reconciler sees (see host.ts).\nconst fromApp = createRequire(join(process.cwd(), \"package.json\"))\nconst fromPackage = createRequire(import.meta.url)\nconst fromGtkxReact = createRequire(fromPackage.resolve(\"@gtkx/react\"))\n\n// --- react-refresh: inject BEFORE @gtkx/react loads (the reconciler\n// registers into the patched devtools hook).\nconst RefreshRuntime = fromApp(\"react-refresh/runtime\") as Record<\n  string,\n  unknown\n> & { injectIntoGlobalHook(target: unknown): void }\nRefreshRuntime.injectIntoGlobalHook(globalThis)\nglobalThis.$RefreshReg$ = () => {}\nglobalThis.$RefreshSig$ = () => (type: unknown) => type\nglobalThis.__ReactRefresh = {\n  ...RefreshRuntime,\n  performFullRefresh(reason: string) {\n    console.warn(\n      `[react-native-gtkx] full refresh required (${reason}) — restarting`,\n    )\n    process.exit(65)\n  },\n}\n\n// --- virtual:gtkx-config (same mechanism as the release host).\nconst { loadConfig } = await import(\n  pathToFileURL(fromPackage.resolve(\"@gtkx/config\")).href\n)\nconst { config: gtkxConfig } = await loadConfig(process.cwd())\nif (!gtkxConfig.applicationId) {\n  fail(\n    \"gtkx.config.ts with an applicationId is required in the app root \" +\n      '(export default defineConfig({ applicationId: \"...\", libraries: [...] })).',\n  )\n}\nconst configModuleUrl = new URL(\"./__virtual-gtkx-config.mjs\", import.meta.url)\n  .href\nconst configModuleSource = [\n  `export * from \"@gtkx/jsx/metadata\";`,\n  `export const applicationId = ${JSON.stringify(gtkxConfig.applicationId)};`,\n].join(\"\\n\")\nregisterHooks({\n  resolve(specifier, context, nextResolve) {\n    if (specifier === \"virtual:gtkx-config\") {\n      return { url: configModuleUrl, shortCircuit: true }\n    }\n    return nextResolve(specifier, context)\n  },\n  load(url, context, nextLoad) {\n    if (url === configModuleUrl) {\n      return {\n        format: \"module\",\n        source: configModuleSource,\n        shortCircuit: true,\n      }\n    }\n    return nextLoad(url, context)\n  },\n})\n\n// --- host modules (same interop merging as the release host).\nconst resolveExternal = (name: string): string =>\n  name === \"react\" || name.startsWith(\"react/\")\n    ? fromGtkxReact.resolve(name)\n    : fromPackage.resolve(name)\n\nconst load = async (name: string): Promise<HostModule> => {\n  const namespace: HostModule = await import(\n    pathToFileURL(resolveExternal(name)).href\n  )\n  const merged: HostModule = { __esModule: true, ...namespace }\n  if (!(\"default\" in namespace)) {\n    merged.default = namespace\n  }\n  return merged\n}\n\nglobalThis.__hostModules = {}\nfor (const name of HOST_MODULE_EXTERNALS) {\n  try {\n    globalThis.__hostModules[name] = await load(name)\n  } catch (error) {\n    fail(\n      `failed to load host module \"${name}\" — is the codegen store in ` +\n        `place (npx gtkx codegen) and GTK4/libadwaita installed?\\n${String(error)}`,\n    )\n  }\n}\nglobalThis.__hostRequire = createRequire(import.meta.url)\n\n// --- Dev Menu (Ctrl+Shift+D, the react-native-windows precedent).\n// Installed before the bundle runs so DevSettings.reload works from app\n// code; the key controller attaches once the app window exists.\nconst requestReload = (reason?: string): never => {\n  console.warn(\n    `[react-native-gtkx] reload requested${reason ? ` (${reason})` : \"\"} — restarting`,\n  )\n  return process.exit(65)\n}\nglobalThis.__rnGtkxDevHost = { reload: requestReload }\n\n// Structural slices of the GTK wrappers the menu touches — the host talks\n// to codegen namespaces through __hostModules, untyped by design.\ntype DevMenuWindow = { addController(controller: unknown): void }\ntype DevMenuDialog = {\n  setHeading(heading: string): void\n  setBody(body: string): void\n  addResponse(id: string, label: string): void\n  setResponseAppearance(id: string, appearance: unknown): void\n  setDefaultResponse(id: string): void\n  setCloseResponse(id: string): void\n  choose(parent: DevMenuWindow): Promise<string>\n}\n\nconst installDevMenu = (): void => {\n  const gtk = globalThis.__hostModules[\"@gtkx/gi/gtk\"] as {\n    EventControllerKey: new () => {\n      on(signal: string, handler: (...args: unknown[]) => unknown): void\n    }\n  }\n  const gdk = globalThis.__hostModules[\"@gtkx/gi/gdk\"] as {\n    ModifierType: { CONTROL_MASK: number; SHIFT_MASK: number }\n  }\n  const adw = globalThis.__hostModules[\"@gtkx/gi/adw\"] as {\n    AlertDialog: new () => DevMenuDialog\n    ResponseAppearance: { SUGGESTED: unknown }\n  }\n  const gio = globalThis.__hostModules[\"@gtkx/gi/gio\"] as {\n    Application: {\n      getDefault():\n        { getActiveWindow?: () => DevMenuWindow | null } | null | undefined\n    }\n  }\n  // GDK keysyms for latin letters equal their ASCII codes.\n  const KEY_UPPER_D = 0x44\n  const KEY_LOWER_D = 0x64\n\n  let menuOpen = false\n  const openDevMenu = async (window: DevMenuWindow): Promise<void> => {\n    if (menuOpen) {\n      return\n    }\n    menuOpen = true\n    try {\n      const items = globalThis.__rnGtkxDevMenuItems ?? []\n      const dialog = new adw.AlertDialog()\n      dialog.setHeading(\"React Native Dev Menu\")\n      dialog.setBody(bundleUrl!)\n      dialog.addResponse(\"cancel\", \"Cancel\")\n      items.forEach((item, index) => {\n        dialog.addResponse(`custom-${index}`, item.title)\n      })\n      dialog.addResponse(\"reload\", \"Reload\")\n      dialog.setResponseAppearance(\"reload\", adw.ResponseAppearance.SUGGESTED)\n      dialog.setDefaultResponse(\"reload\")\n      dialog.setCloseResponse(\"cancel\")\n      const response = await dialog.choose(window)\n      if (response === \"reload\") {\n        requestReload()\n      }\n      const custom = /^custom-(\\d+)$/.exec(response)\n      if (custom) {\n        items[Number(custom[1])]?.handler()\n      }\n    } catch (error) {\n      console.error(`[react-native-gtkx] dev menu failed: ${String(error)}`)\n    } finally {\n      menuOpen = false\n    }\n  }\n\n  const attach = (): void => {\n    const window = gio.Application.getDefault()?.getActiveWindow?.()\n    if (!window) {\n      // The bundle opens the window asynchronously (application activate).\n      setTimeout(attach, 200)\n      return\n    }\n    const controller = new gtk.EventControllerKey()\n    controller.on(\"key-pressed\", (keyval, _keycode, state) => {\n      const modifiers = state as number\n      const wanted =\n        (modifiers & gdk.ModifierType.CONTROL_MASK) !== 0 &&\n        (modifiers & gdk.ModifierType.SHIFT_MASK) !== 0 &&\n        (keyval === KEY_UPPER_D || keyval === KEY_LOWER_D)\n      if (wanted) {\n        void openDevMenu(window)\n        return true\n      }\n      return false\n    })\n    window.addController(controller)\n    console.warn(\"[react-native-gtkx] dev menu ready (Ctrl+Shift+D)\")\n  }\n  attach()\n}\n\n// --- fetch and run the dev bundle.\nlet response: Response\ntry {\n  response = await fetch(bundleUrl!)\n} catch {\n  fail(`Metro dev server is not reachable (${bundleUrl}).`)\n  throw new Error(\"unreachable\")\n}\nif (!response.ok) {\n  fail(\n    `Metro returned ${response.status} for the dev bundle:\\n${await response.text()}`,\n  )\n}\nvm.runInThisContext(await response.text(), { filename: bundleUrl })\ninstallDevMenu()\n\n// --- HMR: metro-runtime's own client (ships with react-native).\ntype HmrErrorBody = { type?: string; message?: string }\ntype HmrClient = {\n  send(message: string): void\n  enable(): void\n  on(event: string, listener: (body?: HmrErrorBody) => void): void\n}\nconst HMRClient = fromApp(\"metro-runtime/src/modules/HMRClient\") as new (\n  url: string,\n) => HmrClient\nconst client = new HMRClient(\n  bundleUrl!.replace(/^http/, \"ws\").replace(/\\/[^/]*$/, \"/hot\"),\n)\nclient.send(\n  JSON.stringify({ type: \"register-entrypoints\", entryPoints: [bundleUrl] }),\n)\nclient.enable()\nclient.on(\"update-done\", () => {\n  console.warn(\"[react-native-gtkx] hot update applied\")\n})\nclient.on(\"error\", (body) => {\n  console.error(\n    `[react-native-gtkx] Metro error (${body?.type ?? \"unknown\"}):\\n${body?.message ?? \"\"}`,\n  )\n})\nclient.on(\"close\", () => {\n  console.warn(\n    \"[react-native-gtkx] HMR connection closed (the window keeps running without hot updates)\",\n  )\n})\n"]}

package/dist/runner/host.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runner/host.js

@@ -0,0 +1,101 @@
+// The Node+GTK host: executes a Metro jsbundle built for the linux
+// platform. Spawned by the run-linux command as
+// `node dist/runner/host.js <bundle>`; the bundle's externalized proxies
+// (see ../metro) read the modules injected here.
+//
+// This file must stay runnable under BARE Node: no extensionless relative
+// imports — only builtins, bare dependency specifiers and the package
+// self-reference (resolved through the exports map).
+import { readFileSync } from "node:fs";
+import { createRequire, registerHooks } from "node:module";
+import { pathToFileURL } from "node:url";
+import vm from "node:vm";
+import { HOST_MODULE_EXTERNALS } from "react-native-gtkx/metro";
+const fail = (message) => {
+    console.error(`[react-native-gtkx] ${message}`);
+    process.exit(1);
+};
+if (typeof registerHooks !== "function") {
+    fail(`Node ${process.version} lacks module.registerHooks — the linux host needs Node >= 22.15.`);
+}
+// Resolution anchors. @gtkx/* and @gtkx/config resolve as THIS package's
+// dependencies; react resolves FROM @gtkx/react's real location — the
+// reconciler and the app must share one React instance, and anchoring at
+// the app could pick up a second copy installed by npm peer auto-install.
+const fromPackage = createRequire(import.meta.url);
+const fromGtkxReact = createRequire(fromPackage.resolve("@gtkx/react"));
+const resolveExternal = (name) => name === "react" || name.startsWith("react/")
+    ? fromGtkxReact.resolve(name)
+    : fromPackage.resolve(name);
+// import() handles both ESM and CJS; merge a `default` for Babel's
+// default-import interop when the module has none of its own.
+const load = async (name) => {
+    const namespace = await import(pathToFileURL(resolveExternal(name)).href);
+    const merged = { __esModule: true, ...namespace };
+    if (!("default" in namespace)) {
+        merged.default = namespace;
+    }
+    return merged;
+};
+// @gtkx/react imports `virtual:gtkx-config` (JSX metadata + the resolved
+// applicationId); in the vite path the gtkx CLI plugin serves it. Replicate
+// it with a loader hook. The fake module URL is anchored inside this
+// package so the re-exported bare specifier resolves through node_modules.
+const { loadConfig } = await import("@gtkx/config");
+const { config: gtkxConfig } = await loadConfig(process.cwd());
+if (!gtkxConfig.applicationId) {
+    fail("gtkx.config.ts with an applicationId is required in the app root " +
+        '(export default defineConfig({ applicationId: "...", libraries: [...] })).');
+}
+const configModuleUrl = new URL("./__virtual-gtkx-config.mjs", import.meta.url)
+    .href;
+const configModuleSource = [
+    `export * from "@gtkx/jsx/metadata";`,
+    `export const applicationId = ${JSON.stringify(gtkxConfig.applicationId)};`,
+].join("\n");
+registerHooks({
+    resolve(specifier, context, nextResolve) {
+        if (specifier === "virtual:gtkx-config") {
+            return { url: configModuleUrl, shortCircuit: true };
+        }
+        return nextResolve(specifier, context);
+    },
+    load(url, context, nextLoad) {
+        if (url === configModuleUrl) {
+            return {
+                format: "module",
+                source: configModuleSource,
+                shortCircuit: true,
+            };
+        }
+        return nextLoad(url, context);
+    },
+});
+globalThis.__hostModules = {};
+for (const name of HOST_MODULE_EXTERNALS) {
+    try {
+        globalThis.__hostModules[name] = await load(name);
+    }
+    catch (error) {
+        fail(`failed to load host module "${name}" — is the codegen store in ` +
+            `place (npx gtkx codegen) and GTK4/libadwaita installed?\n${String(error)}`);
+    }
+}
+// Node builtin proxies resolve lazily through the host's own require.
+globalThis.__hostRequire = createRequire(import.meta.url);
+const bundlePath = process.argv[2];
+if (!bundlePath) {
+    fail("usage: node host.js <path/to/main.jsbundle>");
+}
+let source;
+try {
+    source = readFileSync(bundlePath, "utf8");
+}
+catch {
+    fail(`bundle not found at ${bundlePath} — run react-native run-linux.`);
+    throw new Error("unreachable");
+}
+// The entry calls AppRegistry.runApplication itself (the react-native-web
+// pattern); the GLib main loop keeps the process alive afterwards.
+vm.runInThisContext(source, { filename: bundlePath });
+//# sourceMappingURL=host.js.map

package/dist/runner/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/runner/host.ts"],"names":[],"mappings":"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","sourcesContent":["// The Node+GTK host: executes a Metro jsbundle built for the linux\n// platform. Spawned by the run-linux command as\n// `node dist/runner/host.js <bundle>`; the bundle's externalized proxies\n// (see ../metro) read the modules injected here.\n//\n// This file must stay runnable under BARE Node: no extensionless relative\n// imports — only builtins, bare dependency specifiers and the package\n// self-reference (resolved through the exports map).\nimport { readFileSync } from \"node:fs\"\nimport { createRequire, registerHooks } from \"node:module\"\nimport { pathToFileURL } from \"node:url\"\nimport vm from \"node:vm\"\nimport { HOST_MODULE_EXTERNALS } from \"react-native-gtkx/metro\"\n\ntype HostModule = Record<string, unknown>\n\nconst fail = (message: string): never => {\n  console.error(`[react-native-gtkx] ${message}`)\n  process.exit(1)\n}\n\nif (typeof registerHooks !== \"function\") {\n  fail(\n    `Node ${process.version} lacks module.registerHooks — the linux host needs Node >= 22.15.`,\n  )\n}\n\n// Resolution anchors. @gtkx/* and @gtkx/config resolve as THIS package's\n// dependencies; react resolves FROM @gtkx/react's real location — the\n// reconciler and the app must share one React instance, and anchoring at\n// the app could pick up a second copy installed by npm peer auto-install.\nconst fromPackage = createRequire(import.meta.url)\nconst fromGtkxReact = createRequire(fromPackage.resolve(\"@gtkx/react\"))\n\nconst resolveExternal = (name: string): string =>\n  name === \"react\" || name.startsWith(\"react/\")\n    ? fromGtkxReact.resolve(name)\n    : fromPackage.resolve(name)\n\n// import() handles both ESM and CJS; merge a `default` for Babel's\n// default-import interop when the module has none of its own.\nconst load = async (name: string): Promise<HostModule> => {\n  const namespace: HostModule = await import(\n    pathToFileURL(resolveExternal(name)).href\n  )\n  const merged: HostModule = { __esModule: true, ...namespace }\n  if (!(\"default\" in namespace)) {\n    merged.default = namespace\n  }\n  return merged\n}\n\n// @gtkx/react imports `virtual:gtkx-config` (JSX metadata + the resolved\n// applicationId); in the vite path the gtkx CLI plugin serves it. Replicate\n// it with a loader hook. The fake module URL is anchored inside this\n// package so the re-exported bare specifier resolves through node_modules.\nconst { loadConfig } = await import(\"@gtkx/config\")\nconst { config: gtkxConfig } = await loadConfig(process.cwd())\nif (!gtkxConfig.applicationId) {\n  fail(\n    \"gtkx.config.ts with an applicationId is required in the app root \" +\n      '(export default defineConfig({ applicationId: \"...\", libraries: [...] })).',\n  )\n}\nconst configModuleUrl = new URL(\"./__virtual-gtkx-config.mjs\", import.meta.url)\n  .href\nconst configModuleSource = [\n  `export * from \"@gtkx/jsx/metadata\";`,\n  `export const applicationId = ${JSON.stringify(gtkxConfig.applicationId)};`,\n].join(\"\\n\")\nregisterHooks({\n  resolve(specifier, context, nextResolve) {\n    if (specifier === \"virtual:gtkx-config\") {\n      return { url: configModuleUrl, shortCircuit: true }\n    }\n    return nextResolve(specifier, context)\n  },\n  load(url, context, nextLoad) {\n    if (url === configModuleUrl) {\n      return {\n        format: \"module\",\n        source: configModuleSource,\n        shortCircuit: true,\n      }\n    }\n    return nextLoad(url, context)\n  },\n})\n\nglobalThis.__hostModules = {}\nfor (const name of HOST_MODULE_EXTERNALS) {\n  try {\n    globalThis.__hostModules[name] = await load(name)\n  } catch (error) {\n    fail(\n      `failed to load host module \"${name}\" — is the codegen store in ` +\n        `place (npx gtkx codegen) and GTK4/libadwaita installed?\\n${String(error)}`,\n    )\n  }\n}\n// Node builtin proxies resolve lazily through the host's own require.\nglobalThis.__hostRequire = createRequire(import.meta.url)\n\nconst bundlePath = process.argv[2]\nif (!bundlePath) {\n  fail(\"usage: node host.js <path/to/main.jsbundle>\")\n}\nlet source: string\ntry {\n  source = readFileSync(bundlePath!, \"utf8\")\n} catch {\n  fail(`bundle not found at ${bundlePath} — run react-native run-linux.`)\n  throw new Error(\"unreachable\")\n}\n// The entry calls AppRegistry.runApplication itself (the react-native-web\n// pattern); the GLib main loop keeps the process alive afterwards.\nvm.runInThisContext(source, { filename: bundlePath })\n"]}

package/dist/runner/index.d.ts

@@ -0,0 +1,26 @@
+type CliConfig = {
+    root: string;
+};
+type RunLinuxArgs = {
+    entryFile: string;
+    bundleOutput?: string;
+    skipBundling?: boolean;
+    dev?: boolean;
+    port?: string;
+};
+/** Commands contributed to the RN CLI by the package's react-native.config.js. */
+export declare const commands: {
+    name: string;
+    description: string;
+    options: ({
+        name: string;
+        description: string;
+        default: string;
+    } | {
+        name: string;
+        description: string;
+        default?: undefined;
+    })[];
+    func: (_argv: string[], config: CliConfig, args: RunLinuxArgs) => Promise<void>;
+}[];
+export {};