react-native-gtkx 0.2.0-alpha.1 → 0.3.0-alpha.1

package/dist/vite/index.js

@@ -4,42 +4,30 @@
 // from the root and merges it beneath the CLI config; this preset plugs in
 // there as a single plugin.
 //
-// Single self-contained file on purpose: vite loads the config's imported
-// packages with BARE Node, so this subpath (like ./metro and ./runner) must
-// not contain extensionless relative imports — the pure resolution helpers
-// live here rather than in a sibling module.
+// vite loads the config's imported packages with BARE Node, so this subpath
+// (like ./metro and ./runner) must not contain EXTENSIONLESS relative imports
+// — the pure resolution helpers live here rather than in a sibling module,
+// and the one import that does cross a file boundary spells out its `.js`.
 import { existsSync } from "node:fs";
 import { dirname, extname, isAbsolute, resolve } from "node:path";
+import { applyAliases, compileAliases, DEFAULT_ALIAS_TABLE, } from "../aliases/index.js";
+// Re-exported so an app configuring `aliases` never has to reach past the
+// preset subpath it already imports.
+export { CONFIGURABLE_ALIASES, DEFAULT_ALIASES, PLATFORM_ALIAS, } from "../aliases/index.js";
 export const DEFAULT_PLATFORMS = ["linux", "native"];
 export const DEFAULT_EXTENSIONS = ["tsx", "ts", "jsx", "js"];
-const REACT_NATIVE = "react-native";
 const REACT_NATIVE_GTKX = "react-native-gtkx";
-const REACT_NATIVE_SVG = "react-native-svg";
-const REACT_NATIVE_GTKX_SVG = "react-native-gtkx/svg";
 /**
- * Maps `react-native` (and its subpaths) to `react-native-gtkx`, and
- * `react-native-svg` (and its subpaths) to the `react-native-gtkx/svg`
- * compat subpath (see src/svg-compat/index.ts) — same rationale, same exact-
- * match-or-slash-prefix guard so a lookalike package name (`react-native-
- * svg-icons`, the same shape of trap `react-native-web` is for the plain
- * `react-native` case below) is never aliased by accident. Returns null for
- * every other specifier, including `react-native-gtkx` itself.
+ * Applies the DEFAULT alias table (../aliases/index.ts) to one specifier:
+ * `react-native` and its subpaths onto `react-native-gtkx`, and the five
+ * package substitutions onto their compat subpaths. Returns null for every
+ * other specifier, including `react-native-gtkx` itself.
+ *
+ * Exported for tests and for apps driving vite by hand. The plugin does NOT
+ * call it — the plugin resolves through the table its own `aliases` option
+ * produced, so an app's deltas apply.
  */
-export const rewriteReactNativeImport = (source) => {
-    if (source === REACT_NATIVE) {
-        return REACT_NATIVE_GTKX;
-    }
-    if (source.startsWith(`${REACT_NATIVE}/`)) {
-        return `${REACT_NATIVE_GTKX}${source.slice(REACT_NATIVE.length)}`;
-    }
-    if (source === REACT_NATIVE_SVG) {
-        return REACT_NATIVE_GTKX_SVG;
-    }
-    if (source.startsWith(`${REACT_NATIVE_SVG}/`)) {
-        return `${REACT_NATIVE_GTKX_SVG}${source.slice(REACT_NATIVE_SVG.length)}`;
-    }
-    return null;
-};
+export const rewriteReactNativeImport = (source) => applyAliases(DEFAULT_ALIAS_TABLE, source);
 /** Splits a vite specifier into its path part and its `?query` suffix. */
 export const splitQuery = (source) => {
     const index = source.indexOf("?");
@@ -115,60 +103,117 @@ export const resolvePlatformSpecifier = (source, importer, exists, options = {})
  * and resolves Metro-style platform extensions
  * (`.linux.tsx` → `.native.tsx` → base) for extensionless imports.
  */
-export const reactNativeGtkx = (options = {}) => ({
-    name: "react-native-gtkx:preset",
-    // Before vite's own resolver and the gtkx CLI plugins: the alias must win
-    // over node resolution and platform files must win over the base file.
-    enforce: "pre",
-    config: () => ({
-        ssr: {
-            // `gtkx dev` runs vite with ssr.external: true, which would hand
-            // react-native-gtkx straight to node. Keep the package inside the
-            // vite pipeline; noExternal wins over external: true.
+export const reactNativeGtkx = (options = {}) => {
+    // Throws on an unknown key, an overlapping pattern or an attempt to remove
+    // the platform alias — at config load, naming what is valid.
+    const aliases = compileAliases(options.aliases);
+    return {
+        name: "react-native-gtkx:preset",
+        // Before vite's own resolver and the gtkx CLI plugins: the alias must win
+        // over node resolution and platform files must win over the base file.
+        enforce: "pre",
+        config: (_config, env) => ({
+            // `__DEV__` is part of the react-native runtime contract, not a Metro
+            // detail: RN's own modules branch on it and so does every library
+            // written against them (`@gorhom/bottom-sheet`'s logger and four of its
+            // components read it at module scope). The Metro path gets it from the
+            // app's stock RN preset; nothing supplied it on the vite path, so a
+            // library that reads it crashed the bundle at startup with
+            // "ReferenceError: __DEV__ is not defined" — found by building
+            // spike/core-exports rather than by reading anything.
             //
-            // "react-native" must be listed too: with ssr.external: true vite
-            // externalizes a bare import BEFORE the plugin pipeline whenever the
-            // package resolves natively — and the real react-native (a Flow
-            // codebase Node cannot parse) exists in RN monorepos. noExternal
-            // forces the full plugin resolution, where the alias rewrites the
-            // import to react-native-gtkx.
-            // @react-navigation must go through the pipeline too: it imports
-            // "react-native", and an externalized copy resolves that to the real
-            // Flow package (SyntaxError: Unexpected token 'typeof') instead of
-            // our alias. Only bites on the dev path — a production build inlines
-            // everything anyway.
-            noExternal: ["react-native-gtkx", "react-native", /^@react-navigation\//],
-        },
-        resolve: {
-            // RC2-WORKAROUND(runtime-dedupe): see docs/gtkx-rc2-notes.md
-            // The gtkx runtime and react are single-instance hosts: when the app
-            // and react-native-gtkx resolve them from different node_modules
-            // (file:-installed package, nested installs), two bundled copies
-            // double-init the runtime and GLib aborts. dedupe pins every copy to
-            // the project's own resolution.
-            dedupe: [
-                "@gtkx/css",
-                "@gtkx/gi",
-                "@gtkx/jsx",
-                "@gtkx/native",
-                "@gtkx/react",
-                "@gtkx/runtime",
-                // react-navigation is context-based: two bundled copies of core
-                // fail with "couldn't find a navigation context".
-                "@react-navigation/core",
-                "@react-navigation/native",
-                "react",
-            ],
+            // vite's mode is the honest source: `gtkx dev` builds in development,
+            // `gtkx build` in production, which is exactly the distinction RN draws.
+            define: {
+                __DEV__: JSON.stringify(env.mode !== "production"),
+            },
+            ssr: {
+                // `gtkx dev` runs vite with ssr.external: true, which would hand
+                // react-native-gtkx straight to node. Keep the package inside the
+                // vite pipeline; noExternal wins over external: true.
+                //
+                // "react-native" must be listed too: with ssr.external: true vite
+                // externalizes a bare import BEFORE the plugin pipeline whenever the
+                // package resolves natively — and the real react-native (a Flow
+                // codebase Node cannot parse) exists in RN monorepos. noExternal
+                // forces the full plugin resolution, where the alias rewrites the
+                // import to react-native-gtkx.
+                // "react-native-reanimated" for the same reason as "react-native": an
+                // app that also ships iOS/Android keeps the real package installed, it
+                // resolves natively, and ssr.external: true would hand Node a codebase
+                // built around a Babel plugin and a worklet runtime before the alias
+                // ever gets a chance to rewrite the import.
+                // "react-native-worklets" is the same case one package over — it is
+                // where that worklet runtime actually lives since Reanimated 4.
+                //
+                // The rule those are instances of, stated once so the next alias does
+                // not have to rediscover it: EVERY package name in the alias table must
+                // be listed here. An alias is a resolveId hook, and a bare specifier
+                // that vite externalizes never reaches one — so on the dev path the
+                // alias silently loses to whatever is installed under the real name.
+                // That is not hypothetical: an app that also ships iOS and Android has
+                // all of them in node_modules, which is the case the alias exists to
+                // serve. `react-native-gesture-handler` proved it — this list once held
+                // three of the six names, its real package loaded, and it failed on an
+                // extensionless internal import Node cannot resolve (found by running
+                // the gallery's upstream-libraries section, which installs it).
+                //
+                // So the list is DERIVED rather than written out: it is exactly the
+                // table's package names, and a name can no longer go missing from one
+                // of the two places it has to appear.
+                //
+                // `aliases.names` includes the packages an app turned OFF with `false`,
+                // deliberately. Dropping an alias means the REAL package loads, and the
+                // real package imports `react-native` at module scope — an import that
+                // only reaches the platform alias if Node never gets the package first.
+                // Un-aliasing a package is therefore a reason to keep it inside the
+                // pipeline, not a reason to let it out.
+                noExternal: [
+                    REACT_NATIVE_GTKX,
+                    ...aliases.names,
+                    // @react-navigation is not aliased, but must go through the pipeline
+                    // too: it imports `react-native`, and an externalized copy resolves
+                    // that to the real Flow package (SyntaxError: Unexpected token
+                    // 'typeof') instead of our alias. Only bites on the dev path — a
+                    // production build inlines everything anyway.
+                    /^@react-navigation\//,
+                ],
+            },
+            resolve: {
+                // RC4-WORKAROUND(runtime-dedupe): see docs/gtkx-rc4-notes.md
+                // The gtkx runtime and react are single-instance hosts: when the app
+                // and react-native-gtkx resolve them from different node_modules
+                // (file:-installed package, nested installs), two bundled copies
+                // double-init the runtime and GLib aborts. dedupe pins every copy to
+                // the project's own resolution.
+                dedupe: [
+                    "@gtkx/css",
+                    "@gtkx/gi",
+                    "@gtkx/jsx",
+                    "@gtkx/native",
+                    "@gtkx/react",
+                    "@gtkx/runtime",
+                    // react-navigation is context-based: two bundled copies of core
+                    // fail with "couldn't find a navigation context".
+                    "@react-navigation/core",
+                    "@react-navigation/native",
+                    "react",
+                ],
+            },
+        }),
+        async resolveId(source, importer) {
+            // The app's table, not the default one: a package dropped with `false`
+            // falls through to vite's own resolution and the real package loads.
+            const aliased = applyAliases(aliases, source);
+            if (aliased !== null) {
+                const resolved = await this.resolve(aliased, importer, {
+                    skipSelf: true,
+                });
+                return resolved ?? aliased;
+            }
+            return resolvePlatformSpecifier(source, importer, existsSync, options);
         },
-    }),
-    async resolveId(source, importer) {
-        const aliased = rewriteReactNativeImport(source);
-        if (aliased !== null) {
-            const resolved = await this.resolve(aliased, importer, { skipSelf: true });
-            return resolved ?? aliased;
-        }
-        return resolvePlatformSpecifier(source, importer, existsSync, options);
-    },
-});
+    };
+};
 export default reactNativeGtkx;
 //# sourceMappingURL=index.js.map

package/dist/vite/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"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","sourcesContent":["// react-native-gtkx/vite — makes a gtkx project React Native compatible.\n// The gtkx CLI (dev and build) starts vite with an inline config that never\n// sets `configFile: false`, so vite picks up the project's vite.config.ts\n// from the root and merges it beneath the CLI config; this preset plugs in\n// there as a single plugin.\n//\n// Single self-contained file on purpose: vite loads the config's imported\n// packages with BARE Node, so this subpath (like ./metro and ./runner) must\n// not contain extensionless relative imports — the pure resolution helpers\n// live here rather than in a sibling module.\nimport { existsSync } from \"node:fs\"\nimport { dirname, extname, isAbsolute, resolve } from \"node:path\"\nimport type { Plugin } from \"vite\"\n\n// --- pure resolution logic (unit-tested directly) -----------------------\n\n/** Options shared by the preset factory and the pure resolver helpers. */\nexport type PlatformResolutionOptions = {\n  /** Platform suffix priority, most specific first. Default: [\"linux\", \"native\"]. */\n  platforms?: readonly string[]\n  /** Source extensions tried for every platform suffix. Default: [\"tsx\", \"ts\", \"jsx\", \"js\"]. */\n  extensions?: readonly string[]\n}\n\n/** Predicate the plugin injects as fs.existsSync; tests inject fakes. */\nexport type FileExists = (filePath: string) => boolean\n\nexport const DEFAULT_PLATFORMS: readonly string[] = [\"linux\", \"native\"]\nexport const DEFAULT_EXTENSIONS: readonly string[] = [\"tsx\", \"ts\", \"jsx\", \"js\"]\n\nconst REACT_NATIVE = \"react-native\"\nconst REACT_NATIVE_GTKX = \"react-native-gtkx\"\nconst REACT_NATIVE_SVG = \"react-native-svg\"\nconst REACT_NATIVE_GTKX_SVG = \"react-native-gtkx/svg\"\n\n/**\n * Maps `react-native` (and its subpaths) to `react-native-gtkx`, and\n * `react-native-svg` (and its subpaths) to the `react-native-gtkx/svg`\n * compat subpath (see src/svg-compat/index.ts) — same rationale, same exact-\n * match-or-slash-prefix guard so a lookalike package name (`react-native-\n * svg-icons`, the same shape of trap `react-native-web` is for the plain\n * `react-native` case below) is never aliased by accident. Returns null for\n * every other specifier, including `react-native-gtkx` itself.\n */\nexport const rewriteReactNativeImport = (source: string): string | null => {\n  if (source === REACT_NATIVE) {\n    return REACT_NATIVE_GTKX\n  }\n  if (source.startsWith(`${REACT_NATIVE}/`)) {\n    return `${REACT_NATIVE_GTKX}${source.slice(REACT_NATIVE.length)}`\n  }\n  if (source === REACT_NATIVE_SVG) {\n    return REACT_NATIVE_GTKX_SVG\n  }\n  if (source.startsWith(`${REACT_NATIVE_SVG}/`)) {\n    return `${REACT_NATIVE_GTKX_SVG}${source.slice(REACT_NATIVE_SVG.length)}`\n  }\n  return null\n}\n\n/** Splits a vite specifier into its path part and its `?query` suffix. */\nexport const splitQuery = (\n  source: string,\n): { specifier: string; query: string } => {\n  const index = source.indexOf(\"?\")\n  if (index === -1) {\n    return { specifier: source, query: \"\" }\n  }\n  return { specifier: source.slice(0, index), query: source.slice(index) }\n}\n\nconst isRelative = (specifier: string): boolean =>\n  specifier.startsWith(\"./\") || specifier.startsWith(\"../\")\n\n/**\n * Ordered platform suffixes, platform-major: every extension of the first\n * platform is tried before any extension of the next one\n * (`.linux.tsx`, `.linux.ts`, …, `.native.tsx`, …).\n */\nexport const platformSuffixes = (\n  options: PlatformResolutionOptions = {},\n): string[] => {\n  const platforms = options.platforms ?? DEFAULT_PLATFORMS\n  const extensions = options.extensions ?? DEFAULT_EXTENSIONS\n  return platforms.flatMap((platform) =>\n    extensions.map((extension) => `.${platform}.${extension}`),\n  )\n}\n\n/**\n * Candidate file paths for an extensionless base path, in priority order:\n * direct platform files first, then platform index files of a directory —\n * mirroring Metro, which exhausts file resolution before directory resolution.\n * The base file itself is not a candidate: when no platform file exists the\n * plugin bails out and the default resolver picks the base module.\n */\nexport const platformCandidates = (\n  base: string,\n  options: PlatformResolutionOptions = {},\n): string[] => {\n  const suffixes = platformSuffixes(options)\n  return [\n    ...suffixes.map((suffix) => `${base}${suffix}`),\n    ...suffixes.map((suffix) => `${base}/index${suffix}`),\n  ]\n}\n\n// Source extensions Metro strips before trying platform variants: an\n// import of \"./useLinking.js\" (the TS-ESM style react-navigation and most\n// compiled RN libraries use) must still find useLinking.native.tsx /\n// useLinking.native.js — Metro resolves the BASE name platform-first, the\n// literal file is only the fallback.\nconst STRIPPABLE_EXTENSIONS = new Set([\".js\", \".jsx\", \".mjs\", \".ts\", \".tsx\"])\n\n/**\n * Metro platform-extension resolution for a single import: relative (or\n * absolute) specifiers that are extensionless — or carry a strippable\n * source extension — try platform candidates first; the first existing\n * candidate wins; the `?query` suffix is carried over. Returns null when\n * the import is out of scope or no platform file exists, handing the\n * import back to the default resolver.\n */\nexport const resolvePlatformSpecifier = (\n  source: string,\n  importer: string | undefined,\n  exists: FileExists,\n  options: PlatformResolutionOptions = {},\n): string | null => {\n  if (importer === undefined || source.startsWith(\"\\0\")) {\n    return null\n  }\n  const { specifier, query } = splitQuery(source)\n  if (!isRelative(specifier) && !isAbsolute(specifier)) {\n    return null\n  }\n  const extension = extname(specifier)\n  if (extension !== \"\" && !STRIPPABLE_EXTENSIONS.has(extension)) {\n    return null\n  }\n  const withExtension = isAbsolute(specifier)\n    ? specifier\n    : resolve(dirname(splitQuery(importer).specifier), specifier)\n  const base =\n    extension === \"\" ? withExtension : withExtension.slice(0, -extension.length)\n  for (const candidate of platformCandidates(base, options)) {\n    if (exists(candidate)) {\n      return candidate + query\n    }\n  }\n  return null\n}\n\n// --- the vite plugin ----------------------------------------------------\n\nexport type ReactNativeGtkxOptions = PlatformResolutionOptions\n\n/**\n * Vite plugin: aliases `react-native` (and subpaths) to `react-native-gtkx`\n * and resolves Metro-style platform extensions\n * (`.linux.tsx` → `.native.tsx` → base) for extensionless imports.\n */\nexport const reactNativeGtkx = (\n  options: ReactNativeGtkxOptions = {},\n): Plugin => ({\n  name: \"react-native-gtkx:preset\",\n  // Before vite's own resolver and the gtkx CLI plugins: the alias must win\n  // over node resolution and platform files must win over the base file.\n  enforce: \"pre\",\n\n  config: () => ({\n    ssr: {\n      // `gtkx dev` runs vite with ssr.external: true, which would hand\n      // react-native-gtkx straight to node. Keep the package inside the\n      // vite pipeline; noExternal wins over external: true.\n      //\n      // \"react-native\" must be listed too: with ssr.external: true vite\n      // externalizes a bare import BEFORE the plugin pipeline whenever the\n      // package resolves natively — and the real react-native (a Flow\n      // codebase Node cannot parse) exists in RN monorepos. noExternal\n      // forces the full plugin resolution, where the alias rewrites the\n      // import to react-native-gtkx.\n      // @react-navigation must go through the pipeline too: it imports\n      // \"react-native\", and an externalized copy resolves that to the real\n      // Flow package (SyntaxError: Unexpected token 'typeof') instead of\n      // our alias. Only bites on the dev path — a production build inlines\n      // everything anyway.\n      noExternal: [\"react-native-gtkx\", \"react-native\", /^@react-navigation\\//],\n    },\n    resolve: {\n      // RC2-WORKAROUND(runtime-dedupe): see docs/gtkx-rc2-notes.md\n      // The gtkx runtime and react are single-instance hosts: when the app\n      // and react-native-gtkx resolve them from different node_modules\n      // (file:-installed package, nested installs), two bundled copies\n      // double-init the runtime and GLib aborts. dedupe pins every copy to\n      // the project's own resolution.\n      dedupe: [\n        \"@gtkx/css\",\n        \"@gtkx/gi\",\n        \"@gtkx/jsx\",\n        \"@gtkx/native\",\n        \"@gtkx/react\",\n        \"@gtkx/runtime\",\n        // react-navigation is context-based: two bundled copies of core\n        // fail with \"couldn't find a navigation context\".\n        \"@react-navigation/core\",\n        \"@react-navigation/native\",\n        \"react\",\n      ],\n    },\n  }),\n\n  async resolveId(source, importer) {\n    const aliased = rewriteReactNativeImport(source)\n    if (aliased !== null) {\n      const resolved = await this.resolve(aliased, importer, { skipSelf: true })\n      return resolved ?? aliased\n    }\n    return resolvePlatformSpecifier(source, importer, existsSync, options)\n  },\n})\n\nexport default reactNativeGtkx\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vite/index.ts"],"names":[],"mappings":"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","sourcesContent":["// react-native-gtkx/vite — makes a gtkx project React Native compatible.\n// The gtkx CLI (dev and build) starts vite with an inline config that never\n// sets `configFile: false`, so vite picks up the project's vite.config.ts\n// from the root and merges it beneath the CLI config; this preset plugs in\n// there as a single plugin.\n//\n// vite loads the config's imported packages with BARE Node, so this subpath\n// (like ./metro and ./runner) must not contain EXTENSIONLESS relative imports\n// — the pure resolution helpers live here rather than in a sibling module,\n// and the one import that does cross a file boundary spells out its `.js`.\nimport { existsSync } from \"node:fs\"\nimport { dirname, extname, isAbsolute, resolve } from \"node:path\"\nimport type { Plugin } from \"vite\"\nimport {\n  applyAliases,\n  compileAliases,\n  DEFAULT_ALIAS_TABLE,\n  type AliasOverrides,\n} from \"../aliases/index.js\"\n\n// Re-exported so an app configuring `aliases` never has to reach past the\n// preset subpath it already imports.\nexport {\n  CONFIGURABLE_ALIASES,\n  DEFAULT_ALIASES,\n  PLATFORM_ALIAS,\n} from \"../aliases/index.js\"\nexport type {\n  AliasOverride,\n  AliasOverrides,\n  AliasPattern,\n  AliasTable,\n  CompiledAlias,\n} from \"../aliases/index.js\"\n\n// --- pure resolution logic (unit-tested directly) -----------------------\n\n/** Options shared by the preset factory and the pure resolver helpers. */\nexport type PlatformResolutionOptions = {\n  /** Platform suffix priority, most specific first. Default: [\"linux\", \"native\"]. */\n  platforms?: readonly string[]\n  /** Source extensions tried for every platform suffix. Default: [\"tsx\", \"ts\", \"jsx\", \"js\"]. */\n  extensions?: readonly string[]\n}\n\n/** Predicate the plugin injects as fs.existsSync; tests inject fakes. */\nexport type FileExists = (filePath: string) => boolean\n\nexport const DEFAULT_PLATFORMS: readonly string[] = [\"linux\", \"native\"]\nexport const DEFAULT_EXTENSIONS: readonly string[] = [\"tsx\", \"ts\", \"jsx\", \"js\"]\n\nconst REACT_NATIVE_GTKX = \"react-native-gtkx\"\n\n/**\n * Applies the DEFAULT alias table (../aliases/index.ts) to one specifier:\n * `react-native` and its subpaths onto `react-native-gtkx`, and the five\n * package substitutions onto their compat subpaths. Returns null for every\n * other specifier, including `react-native-gtkx` itself.\n *\n * Exported for tests and for apps driving vite by hand. The plugin does NOT\n * call it — the plugin resolves through the table its own `aliases` option\n * produced, so an app's deltas apply.\n */\nexport const rewriteReactNativeImport = (source: string): string | null =>\n  applyAliases(DEFAULT_ALIAS_TABLE, source)\n\n/** Splits a vite specifier into its path part and its `?query` suffix. */\nexport const splitQuery = (\n  source: string,\n): { specifier: string; query: string } => {\n  const index = source.indexOf(\"?\")\n  if (index === -1) {\n    return { specifier: source, query: \"\" }\n  }\n  return { specifier: source.slice(0, index), query: source.slice(index) }\n}\n\nconst isRelative = (specifier: string): boolean =>\n  specifier.startsWith(\"./\") || specifier.startsWith(\"../\")\n\n/**\n * Ordered platform suffixes, platform-major: every extension of the first\n * platform is tried before any extension of the next one\n * (`.linux.tsx`, `.linux.ts`, …, `.native.tsx`, …).\n */\nexport const platformSuffixes = (\n  options: PlatformResolutionOptions = {},\n): string[] => {\n  const platforms = options.platforms ?? DEFAULT_PLATFORMS\n  const extensions = options.extensions ?? DEFAULT_EXTENSIONS\n  return platforms.flatMap((platform) =>\n    extensions.map((extension) => `.${platform}.${extension}`),\n  )\n}\n\n/**\n * Candidate file paths for an extensionless base path, in priority order:\n * direct platform files first, then platform index files of a directory —\n * mirroring Metro, which exhausts file resolution before directory resolution.\n * The base file itself is not a candidate: when no platform file exists the\n * plugin bails out and the default resolver picks the base module.\n */\nexport const platformCandidates = (\n  base: string,\n  options: PlatformResolutionOptions = {},\n): string[] => {\n  const suffixes = platformSuffixes(options)\n  return [\n    ...suffixes.map((suffix) => `${base}${suffix}`),\n    ...suffixes.map((suffix) => `${base}/index${suffix}`),\n  ]\n}\n\n// Source extensions Metro strips before trying platform variants: an\n// import of \"./useLinking.js\" (the TS-ESM style react-navigation and most\n// compiled RN libraries use) must still find useLinking.native.tsx /\n// useLinking.native.js — Metro resolves the BASE name platform-first, the\n// literal file is only the fallback.\nconst STRIPPABLE_EXTENSIONS = new Set([\".js\", \".jsx\", \".mjs\", \".ts\", \".tsx\"])\n\n/**\n * Metro platform-extension resolution for a single import: relative (or\n * absolute) specifiers that are extensionless — or carry a strippable\n * source extension — try platform candidates first; the first existing\n * candidate wins; the `?query` suffix is carried over. Returns null when\n * the import is out of scope or no platform file exists, handing the\n * import back to the default resolver.\n */\nexport const resolvePlatformSpecifier = (\n  source: string,\n  importer: string | undefined,\n  exists: FileExists,\n  options: PlatformResolutionOptions = {},\n): string | null => {\n  if (importer === undefined || source.startsWith(\"\\0\")) {\n    return null\n  }\n  const { specifier, query } = splitQuery(source)\n  if (!isRelative(specifier) && !isAbsolute(specifier)) {\n    return null\n  }\n  const extension = extname(specifier)\n  if (extension !== \"\" && !STRIPPABLE_EXTENSIONS.has(extension)) {\n    return null\n  }\n  const withExtension = isAbsolute(specifier)\n    ? specifier\n    : resolve(dirname(splitQuery(importer).specifier), specifier)\n  const base =\n    extension === \"\" ? withExtension : withExtension.slice(0, -extension.length)\n  for (const candidate of platformCandidates(base, options)) {\n    if (exists(candidate)) {\n      return candidate + query\n    }\n  }\n  return null\n}\n\n// --- the vite plugin ----------------------------------------------------\n\nexport type ReactNativeGtkxOptions = PlatformResolutionOptions & {\n  /**\n   * Deltas over the preset's package aliases, keyed by package name — a\n   * string target, a `{ pattern, replace }` rule, or `false` to drop one of\n   * ours so the real package loads. Identical semantics to the Metro\n   * preset's option of the same name: both compile the same table.\n   * Invalid entries throw here, while the config is being read.\n   */\n  aliases?: AliasOverrides\n}\n\n/**\n * Vite plugin: aliases `react-native` (and subpaths) to `react-native-gtkx`\n * and resolves Metro-style platform extensions\n * (`.linux.tsx` → `.native.tsx` → base) for extensionless imports.\n */\nexport const reactNativeGtkx = (\n  options: ReactNativeGtkxOptions = {},\n): Plugin => {\n  // Throws on an unknown key, an overlapping pattern or an attempt to remove\n  // the platform alias — at config load, naming what is valid.\n  const aliases = compileAliases(options.aliases)\n  return {\n    name: \"react-native-gtkx:preset\",\n    // Before vite's own resolver and the gtkx CLI plugins: the alias must win\n    // over node resolution and platform files must win over the base file.\n    enforce: \"pre\",\n\n    config: (_config, env) => ({\n      // `__DEV__` is part of the react-native runtime contract, not a Metro\n      // detail: RN's own modules branch on it and so does every library\n      // written against them (`@gorhom/bottom-sheet`'s logger and four of its\n      // components read it at module scope). The Metro path gets it from the\n      // app's stock RN preset; nothing supplied it on the vite path, so a\n      // library that reads it crashed the bundle at startup with\n      // \"ReferenceError: __DEV__ is not defined\" — found by building\n      // spike/core-exports rather than by reading anything.\n      //\n      // vite's mode is the honest source: `gtkx dev` builds in development,\n      // `gtkx build` in production, which is exactly the distinction RN draws.\n      define: {\n        __DEV__: JSON.stringify(env.mode !== \"production\"),\n      },\n      ssr: {\n        // `gtkx dev` runs vite with ssr.external: true, which would hand\n        // react-native-gtkx straight to node. Keep the package inside the\n        // vite pipeline; noExternal wins over external: true.\n        //\n        // \"react-native\" must be listed too: with ssr.external: true vite\n        // externalizes a bare import BEFORE the plugin pipeline whenever the\n        // package resolves natively — and the real react-native (a Flow\n        // codebase Node cannot parse) exists in RN monorepos. noExternal\n        // forces the full plugin resolution, where the alias rewrites the\n        // import to react-native-gtkx.\n        // \"react-native-reanimated\" for the same reason as \"react-native\": an\n        // app that also ships iOS/Android keeps the real package installed, it\n        // resolves natively, and ssr.external: true would hand Node a codebase\n        // built around a Babel plugin and a worklet runtime before the alias\n        // ever gets a chance to rewrite the import.\n        // \"react-native-worklets\" is the same case one package over — it is\n        // where that worklet runtime actually lives since Reanimated 4.\n        //\n        // The rule those are instances of, stated once so the next alias does\n        // not have to rediscover it: EVERY package name in the alias table must\n        // be listed here. An alias is a resolveId hook, and a bare specifier\n        // that vite externalizes never reaches one — so on the dev path the\n        // alias silently loses to whatever is installed under the real name.\n        // That is not hypothetical: an app that also ships iOS and Android has\n        // all of them in node_modules, which is the case the alias exists to\n        // serve. `react-native-gesture-handler` proved it — this list once held\n        // three of the six names, its real package loaded, and it failed on an\n        // extensionless internal import Node cannot resolve (found by running\n        // the gallery's upstream-libraries section, which installs it).\n        //\n        // So the list is DERIVED rather than written out: it is exactly the\n        // table's package names, and a name can no longer go missing from one\n        // of the two places it has to appear.\n        //\n        // `aliases.names` includes the packages an app turned OFF with `false`,\n        // deliberately. Dropping an alias means the REAL package loads, and the\n        // real package imports `react-native` at module scope — an import that\n        // only reaches the platform alias if Node never gets the package first.\n        // Un-aliasing a package is therefore a reason to keep it inside the\n        // pipeline, not a reason to let it out.\n        noExternal: [\n          REACT_NATIVE_GTKX,\n          ...aliases.names,\n          // @react-navigation is not aliased, but must go through the pipeline\n          // too: it imports `react-native`, and an externalized copy resolves\n          // that to the real Flow package (SyntaxError: Unexpected token\n          // 'typeof') instead of our alias. Only bites on the dev path — a\n          // production build inlines everything anyway.\n          /^@react-navigation\\//,\n        ],\n      },\n      resolve: {\n        // RC4-WORKAROUND(runtime-dedupe): see docs/gtkx-rc4-notes.md\n        // The gtkx runtime and react are single-instance hosts: when the app\n        // and react-native-gtkx resolve them from different node_modules\n        // (file:-installed package, nested installs), two bundled copies\n        // double-init the runtime and GLib aborts. dedupe pins every copy to\n        // the project's own resolution.\n        dedupe: [\n          \"@gtkx/css\",\n          \"@gtkx/gi\",\n          \"@gtkx/jsx\",\n          \"@gtkx/native\",\n          \"@gtkx/react\",\n          \"@gtkx/runtime\",\n          // react-navigation is context-based: two bundled copies of core\n          // fail with \"couldn't find a navigation context\".\n          \"@react-navigation/core\",\n          \"@react-navigation/native\",\n          \"react\",\n        ],\n      },\n    }),\n\n    async resolveId(source, importer) {\n      // The app's table, not the default one: a package dropped with `false`\n      // falls through to vite's own resolution and the real package loads.\n      const aliased = applyAliases(aliases, source)\n      if (aliased !== null) {\n        const resolved = await this.resolve(aliased, importer, {\n          skipSelf: true,\n        })\n        return resolved ?? aliased\n      }\n      return resolvePlatformSpecifier(source, importer, existsSync, options)\n    },\n  }\n}\n\nexport default reactNativeGtkx\n"]}

package/dist/vitest/index.d.ts

@@ -1,4 +1,4 @@
-import type { GtkxPluginOptions } from "@gtkx/vitest";
+import type { PluginOptions as GtkxPluginOptions } from "@gtkx/vitest";
 import type { UserWorkspaceConfig } from "vitest/config";
 import { type ReactNativeGtkxOptions } from "../vite/index.js";
 /**
@@ -26,7 +26,7 @@ export type ReactNativeGtkxTestOptions = {
     /**
      * Run this project's test files serially. Default: false — window-resize
      * signal delivery races when several per-worker headless compositors run
-     * at once (see docs/gtkx-rc2-notes.md); the suite this recipe is proven
+     * at once (see docs/gtkx-rc4-notes.md); the suite this recipe is proven
      * on takes seconds, so serial execution is the cheap fix. Override once a
      * suite is large enough for parallelism to matter more than that race.
      */

package/dist/vitest/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vitest/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE;AACxE,uEAAuE;AACvE,mDAAmD;AACnD,EAAE;AACF,iEAAiE;AACjE,2EAA2E;AAC3E,yEAAyE;AACzE,4EAA4E;AAC5E,qEAAqE;AACrE,0EAA0E;AAC1E,sEAAsE;AACtE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAI7C,OAAO,EAAE,eAAe,EAA+B,MAAM,kBAAkB,CAAA;AAkC/E,MAAM,eAAe,GAAG,CAAC,wBAAwB,CAAC,CAAA;AAClD,MAAM,mBAAmB,GAAwB,CAAC,mBAAmB,CAAC,CAAA;AACtE,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAExE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,UAAsC,EAAE,EACV,EAAE;IAChC,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAA;IACnD,MAAM,OAAO,GAAa;QACxB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC;KAClC,CAAA;IACD,OAAO;QACL,OAAO;QACP,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe;YAC3C,UAAU,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YACvD,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,MAAM,EAAE,CAAC,GAAG,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;iBAChE;aACF;YACD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;SAClD;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe,mBAAmB,CAAA","sourcesContent":["// react-native-gtkx/vitest — the vitest recipe this repo's own test suite\n// runs on (see vitest.config.ts's \"gtk\" project), packaged for a consumer\n// app: the @gtkx/vitest headless-compositor plugin, the react-native-gtkx\n// vite preset (react-native alias + Metro-style platform extensions), a\n// default inline-deps list for RN libraries that import \"react-native\"\n// themselves, and the React act-environment setup.\n//\n// Self-contained like ./vite, ./metro and ./runner: a consumer's\n// vitest.config.ts is loaded the same way vite.config.ts is (vite's config\n// loader bundles only the user's own relative import graph; node_modules\n// imports stay bare specifiers, resolved afterwards by plain Node ESM) — so\n// this file must not contain extensionless relative imports. The one\n// relative import below carries an explicit \".js\" extension, which a real\n// sibling file on disk resolves under plain Node without any bundler.\nimport { fileURLToPath, URL } from \"node:url\"\nimport type { GtkxPluginOptions } from \"@gtkx/vitest\"\nimport type { Plugin } from \"vite\"\nimport type { UserWorkspaceConfig } from \"vitest/config\"\nimport { reactNativeGtkx, type ReactNativeGtkxOptions } from \"../vite/index.js\"\n\n/**\n * Options accepted by {@link reactNativeGtkxTest}. Every field is optional\n * and falls back to the recipe this repo's own test suite runs on.\n */\nexport type ReactNativeGtkxTestOptions = {\n  /** Vitest project name. Default: \"gtk\". */\n  name?: string\n  /** Test file glob(s), relative to the project root. Default: `[\"**\\/*.gtk.test.{ts,tsx}\"]`. */\n  include?: string[]\n  /** Headless compositor size/compositor, forwarded to @gtkx/vitest's plugin. */\n  headless?: GtkxPluginOptions\n  /** Metro-style platform resolution options, forwarded to the vite preset. */\n  platform?: ReactNativeGtkxOptions\n  /**\n   * Extra `server.deps.inline` patterns, merged after the default\n   * (`/@react-navigation/`). Needed for any node_modules library that\n   * itself imports \"react-native\" — Vitest externalizes node_modules code\n   * by default, a path the react-native alias cannot reach.\n   */\n  inlineDeps?: (string | RegExp)[]\n  /** Extra setup files, run after the built-in React act-environment setup. */\n  setupFiles?: string[]\n  /**\n   * Run this project's test files serially. Default: false — window-resize\n   * signal delivery races when several per-worker headless compositors run\n   * at once (see docs/gtkx-rc2-notes.md); the suite this recipe is proven\n   * on takes seconds, so serial execution is the cheap fix. Override once a\n   * suite is large enough for parallelism to matter more than that race.\n   */\n  fileParallelism?: boolean\n}\n\nconst DEFAULT_INCLUDE = [\"**/*.gtk.test.{ts,tsx}\"]\nconst DEFAULT_INLINE_DEPS: (string | RegExp)[] = [/@react-navigation/]\nconst SETUP_FILE = fileURLToPath(new URL(\"./setup.js\", import.meta.url))\n\n/**\n * A ready Vitest project config for react-native-gtkx component tests: the\n * headless Wayland compositor, the react-native alias and platform\n * extensions, and the React act-environment setup — the same recipe this\n * repo's own suite runs on. Use the result as a whole config\n * (`defineConfig(reactNativeGtkxTest())`) or as one entry of\n * `test.projects` alongside a portable \"unit\" project.\n *\n * Requires a headless Wayland compositor on PATH (`sway` by default —\n * `apt install sway xwayland dbus`, see docs/getting-started.md) and\n * `gtkx codegen` to have already generated the project's `@gtkx/gi`\n * bindings — a bare `vitest run` does not trigger codegen itself, unlike\n * `gtkx dev`/`gtkx build`. A missing compositor or codegen store fails with\n * a readable error (e.g. `Cannot find the \"sway\" executable on PATH`), not\n * a hang.\n */\nexport const reactNativeGtkxTest = async (\n  options: ReactNativeGtkxTestOptions = {},\n): Promise<UserWorkspaceConfig> => {\n  const gtkx = (await import(\"@gtkx/vitest\")).default\n  const plugins: Plugin[] = [\n    gtkx(options.headless),\n    reactNativeGtkx(options.platform),\n  ]\n  return {\n    plugins,\n    test: {\n      name: options.name ?? \"gtk\",\n      include: options.include ?? DEFAULT_INCLUDE,\n      setupFiles: [SETUP_FILE, ...(options.setupFiles ?? [])],\n      server: {\n        deps: {\n          inline: [...DEFAULT_INLINE_DEPS, ...(options.inlineDeps ?? [])],\n        },\n      },\n      fileParallelism: options.fileParallelism ?? false,\n    },\n  }\n}\n\nexport default reactNativeGtkxTest\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vitest/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,wEAAwE;AACxE,uEAAuE;AACvE,mDAAmD;AACnD,EAAE;AACF,iEAAiE;AACjE,2EAA2E;AAC3E,yEAAyE;AACzE,4EAA4E;AAC5E,qEAAqE;AACrE,0EAA0E;AAC1E,sEAAsE;AACtE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAI7C,OAAO,EAAE,eAAe,EAA+B,MAAM,kBAAkB,CAAA;AAkC/E,MAAM,eAAe,GAAG,CAAC,wBAAwB,CAAC,CAAA;AAClD,MAAM,mBAAmB,GAAwB,CAAC,mBAAmB,CAAC,CAAA;AACtE,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAExE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,UAAsC,EAAE,EACV,EAAE;IAChC,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAA;IACnD,MAAM,OAAO,GAAa;QACxB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC;KAClC,CAAA;IACD,OAAO;QACL,OAAO;QACP,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe;YAC3C,UAAU,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YACvD,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,MAAM,EAAE,CAAC,GAAG,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;iBAChE;aACF;YACD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;SAClD;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe,mBAAmB,CAAA","sourcesContent":["// react-native-gtkx/vitest — the vitest recipe this repo's own test suite\n// runs on (see vitest.config.ts's \"gtk\" project), packaged for a consumer\n// app: the @gtkx/vitest headless-compositor plugin, the react-native-gtkx\n// vite preset (react-native alias + Metro-style platform extensions), a\n// default inline-deps list for RN libraries that import \"react-native\"\n// themselves, and the React act-environment setup.\n//\n// Self-contained like ./vite, ./metro and ./runner: a consumer's\n// vitest.config.ts is loaded the same way vite.config.ts is (vite's config\n// loader bundles only the user's own relative import graph; node_modules\n// imports stay bare specifiers, resolved afterwards by plain Node ESM) — so\n// this file must not contain extensionless relative imports. The one\n// relative import below carries an explicit \".js\" extension, which a real\n// sibling file on disk resolves under plain Node without any bundler.\nimport { fileURLToPath, URL } from \"node:url\"\nimport type { PluginOptions as GtkxPluginOptions } from \"@gtkx/vitest\"\nimport type { Plugin } from \"vite\"\nimport type { UserWorkspaceConfig } from \"vitest/config\"\nimport { reactNativeGtkx, type ReactNativeGtkxOptions } from \"../vite/index.js\"\n\n/**\n * Options accepted by {@link reactNativeGtkxTest}. Every field is optional\n * and falls back to the recipe this repo's own test suite runs on.\n */\nexport type ReactNativeGtkxTestOptions = {\n  /** Vitest project name. Default: \"gtk\". */\n  name?: string\n  /** Test file glob(s), relative to the project root. Default: `[\"**\\/*.gtk.test.{ts,tsx}\"]`. */\n  include?: string[]\n  /** Headless compositor size/compositor, forwarded to @gtkx/vitest's plugin. */\n  headless?: GtkxPluginOptions\n  /** Metro-style platform resolution options, forwarded to the vite preset. */\n  platform?: ReactNativeGtkxOptions\n  /**\n   * Extra `server.deps.inline` patterns, merged after the default\n   * (`/@react-navigation/`). Needed for any node_modules library that\n   * itself imports \"react-native\" — Vitest externalizes node_modules code\n   * by default, a path the react-native alias cannot reach.\n   */\n  inlineDeps?: (string | RegExp)[]\n  /** Extra setup files, run after the built-in React act-environment setup. */\n  setupFiles?: string[]\n  /**\n   * Run this project's test files serially. Default: false — window-resize\n   * signal delivery races when several per-worker headless compositors run\n   * at once (see docs/gtkx-rc4-notes.md); the suite this recipe is proven\n   * on takes seconds, so serial execution is the cheap fix. Override once a\n   * suite is large enough for parallelism to matter more than that race.\n   */\n  fileParallelism?: boolean\n}\n\nconst DEFAULT_INCLUDE = [\"**/*.gtk.test.{ts,tsx}\"]\nconst DEFAULT_INLINE_DEPS: (string | RegExp)[] = [/@react-navigation/]\nconst SETUP_FILE = fileURLToPath(new URL(\"./setup.js\", import.meta.url))\n\n/**\n * A ready Vitest project config for react-native-gtkx component tests: the\n * headless Wayland compositor, the react-native alias and platform\n * extensions, and the React act-environment setup — the same recipe this\n * repo's own suite runs on. Use the result as a whole config\n * (`defineConfig(reactNativeGtkxTest())`) or as one entry of\n * `test.projects` alongside a portable \"unit\" project.\n *\n * Requires a headless Wayland compositor on PATH (`sway` by default —\n * `apt install sway xwayland dbus`, see docs/getting-started.md) and\n * `gtkx codegen` to have already generated the project's `@gtkx/gi`\n * bindings — a bare `vitest run` does not trigger codegen itself, unlike\n * `gtkx dev`/`gtkx build`. A missing compositor or codegen store fails with\n * a readable error (e.g. `Cannot find the \"sway\" executable on PATH`), not\n * a hang.\n */\nexport const reactNativeGtkxTest = async (\n  options: ReactNativeGtkxTestOptions = {},\n): Promise<UserWorkspaceConfig> => {\n  const gtkx = (await import(\"@gtkx/vitest\")).default\n  const plugins: Plugin[] = [\n    gtkx(options.headless),\n    reactNativeGtkx(options.platform),\n  ]\n  return {\n    plugins,\n    test: {\n      name: options.name ?? \"gtk\",\n      include: options.include ?? DEFAULT_INCLUDE,\n      setupFiles: [SETUP_FILE, ...(options.setupFiles ?? [])],\n      server: {\n        deps: {\n          inline: [...DEFAULT_INLINE_DEPS, ...(options.inlineDeps ?? [])],\n        },\n      },\n      fileParallelism: options.fileParallelism ?? false,\n    },\n  }\n}\n\nexport default reactNativeGtkxTest\n"]}

package/dist/worklets-compat/index.d.ts

@@ -0,0 +1,4 @@
+declare const runOnUI: <A extends unknown[]>(worklet: (...args: A) => unknown) => (...args: A) => void, scheduleOnUI: <A extends unknown[]>(worklet: (...args: A) => unknown, ...args: A) => void, runOnJS: <A extends unknown[]>(fn: (...args: A) => unknown) => (...args: A) => void, scheduleOnRN: <A extends unknown[]>(fn: (...args: A) => unknown, ...args: A) => void, runOnUIAsync: <A extends unknown[], R>(worklet: (...args: A) => R, ...args: A) => Promise<R>;
+export { runOnJS, runOnUI, runOnUIAsync, scheduleOnRN, scheduleOnUI };
+export { callMicrotasks, createSerializable, createShareable, createSynchronizable, createWorkletRuntime, executeOnUIRuntimeSync, getDynamicFeatureFlag, getRuntimeKind, getStaticFeatureFlag, getUIRuntimeHolder, getUISchedulerHolder, isBundleModeEnabled, isRNRuntime, isSerializableRef, isShareable, isShareableRef, isSynchronizable, isUIRuntime, isWorkerRuntime, isWorkletFunction, isWorkletRuntime, makeShareable, makeShareableCloneOnUIRecursive, makeShareableCloneRecursive, registerCustomSerializable, runOnRuntime, runOnRuntimeAsync, runOnRuntimeAsyncWithId, runOnRuntimeSync, runOnRuntimeSyncWithId, RuntimeKind, runOnUISync, scheduleOnRuntime, scheduleOnRuntimeWithId, serializableMappingCache, setDynamicFeatureFlag, shareableMappingCache, toggleSlowAnimationsOnUIRuntime, UIRuntimeId, WorkletsModule, } from "./surface";
+export type { SerializableRef, ShareableRef, WorkletFunction, WorkletRuntime, } from "./surface";

package/dist/worklets-compat/index.js

@@ -0,0 +1,28 @@
+// react-native-gtkx/worklets — the `react-native-worklets` name, on a
+// platform with one thread.
+//
+// Reanimated 4 moved the worklet surface into its own package, and libraries
+// import it under that name rather than through Reanimated. That is not a
+// detail: `react-native-reanimated-dnd` 2.0.0 pulls `scheduleOnRN` and
+// `scheduleOnUI` out of it at module scope in five of its hooks
+// (useDraggable, useDroppable, useSortable, useHorizontalSortable,
+// useGridSortable) with no `try { require } catch` anywhere, so an unaliased
+// package name fails at IMPORT rather than at use. Aliasing
+// `react-native-reanimated` alone left that wall standing one package over.
+//
+// The surface itself already existed — this module adds the NAME. Both
+// presets alias the package onto it (src/vite/index.ts, src/metro/index.ts),
+// and the thread functions are the very same instance the Reanimated surface
+// exports, so `scheduleOnUI` reached through either package name queues into
+// one batch. Upstream has the same property for the same reason: Reanimated
+// re-exports them from here.
+//
+// What is implemented and what refuses is decided by upstream's own
+// non-native build rather than by us — see surface.ts, which is also where
+// everything that needs no clock lives so unit tests can reach it without
+// GTK. docs/api.md records the boundary.
+import { createWorkletsSurface } from "./surface";
+const { runOnUI, scheduleOnUI, runOnJS, scheduleOnRN, runOnUIAsync } = createWorkletsSurface();
+export { runOnJS, runOnUI, runOnUIAsync, scheduleOnRN, scheduleOnUI };
+export { callMicrotasks, createSerializable, createShareable, createSynchronizable, createWorkletRuntime, executeOnUIRuntimeSync, getDynamicFeatureFlag, getRuntimeKind, getStaticFeatureFlag, getUIRuntimeHolder, getUISchedulerHolder, isBundleModeEnabled, isRNRuntime, isSerializableRef, isShareable, isShareableRef, isSynchronizable, isUIRuntime, isWorkerRuntime, isWorkletFunction, isWorkletRuntime, makeShareable, makeShareableCloneOnUIRecursive, makeShareableCloneRecursive, registerCustomSerializable, runOnRuntime, runOnRuntimeAsync, runOnRuntimeAsyncWithId, runOnRuntimeSync, runOnRuntimeSyncWithId, RuntimeKind, runOnUISync, scheduleOnRuntime, scheduleOnRuntimeWithId, serializableMappingCache, setDynamicFeatureFlag, shareableMappingCache, toggleSlowAnimationsOnUIRuntime, UIRuntimeId, WorkletsModule, } from "./surface";
+//# sourceMappingURL=index.js.map

package/dist/worklets-compat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worklets-compat/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,4BAA4B;AAC5B,EAAE;AACF,6EAA6E;AAC7E,0EAA0E;AAC1E,uEAAuE;AACvE,gEAAgE;AAChE,mEAAmE;AACnE,6EAA6E;AAC7E,4DAA4D;AAC5D,4EAA4E;AAC5E,EAAE;AACF,uEAAuE;AACvE,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,6BAA6B;AAC7B,EAAE;AACF,oEAAoE;AACpE,2EAA2E;AAC3E,0EAA0E;AAC1E,yCAAyC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAEjD,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,GAClE,qBAAqB,EAAE,CAAA;AAEzB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAA;AAErE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,+BAA+B,EAC/B,WAAW,EACX,cAAc,GACf,MAAM,WAAW,CAAA","sourcesContent":["// react-native-gtkx/worklets — the `react-native-worklets` name, on a\n// platform with one thread.\n//\n// Reanimated 4 moved the worklet surface into its own package, and libraries\n// import it under that name rather than through Reanimated. That is not a\n// detail: `react-native-reanimated-dnd` 2.0.0 pulls `scheduleOnRN` and\n// `scheduleOnUI` out of it at module scope in five of its hooks\n// (useDraggable, useDroppable, useSortable, useHorizontalSortable,\n// useGridSortable) with no `try { require } catch` anywhere, so an unaliased\n// package name fails at IMPORT rather than at use. Aliasing\n// `react-native-reanimated` alone left that wall standing one package over.\n//\n// The surface itself already existed — this module adds the NAME. Both\n// presets alias the package onto it (src/vite/index.ts, src/metro/index.ts),\n// and the thread functions are the very same instance the Reanimated surface\n// exports, so `scheduleOnUI` reached through either package name queues into\n// one batch. Upstream has the same property for the same reason: Reanimated\n// re-exports them from here.\n//\n// What is implemented and what refuses is decided by upstream's own\n// non-native build rather than by us — see surface.ts, which is also where\n// everything that needs no clock lives so unit tests can reach it without\n// GTK. docs/api.md records the boundary.\nimport { createWorkletsSurface } from \"./surface\"\n\nconst { runOnUI, scheduleOnUI, runOnJS, scheduleOnRN, runOnUIAsync } =\n  createWorkletsSurface()\n\nexport { runOnJS, runOnUI, runOnUIAsync, scheduleOnRN, scheduleOnUI }\n\nexport {\n  callMicrotasks,\n  createSerializable,\n  createShareable,\n  createSynchronizable,\n  createWorkletRuntime,\n  executeOnUIRuntimeSync,\n  getDynamicFeatureFlag,\n  getRuntimeKind,\n  getStaticFeatureFlag,\n  getUIRuntimeHolder,\n  getUISchedulerHolder,\n  isBundleModeEnabled,\n  isRNRuntime,\n  isSerializableRef,\n  isShareable,\n  isShareableRef,\n  isSynchronizable,\n  isUIRuntime,\n  isWorkerRuntime,\n  isWorkletFunction,\n  isWorkletRuntime,\n  makeShareable,\n  makeShareableCloneOnUIRecursive,\n  makeShareableCloneRecursive,\n  registerCustomSerializable,\n  runOnRuntime,\n  runOnRuntimeAsync,\n  runOnRuntimeAsyncWithId,\n  runOnRuntimeSync,\n  runOnRuntimeSyncWithId,\n  RuntimeKind,\n  runOnUISync,\n  scheduleOnRuntime,\n  scheduleOnRuntimeWithId,\n  serializableMappingCache,\n  setDynamicFeatureFlag,\n  shareableMappingCache,\n  toggleSlowAnimationsOnUIRuntime,\n  UIRuntimeId,\n  WorkletsModule,\n} from \"./surface\"\n\nexport type {\n  SerializableRef,\n  ShareableRef,\n  WorkletFunction,\n  WorkletRuntime,\n} from \"./surface\"\n"]}

package/dist/worklets-compat/surface.d.ts

@@ -0,0 +1,110 @@
+/** A function the Babel plugin processed. Never produced on this platform. */
+export type WorkletFunction<Args extends unknown[] = unknown[], ReturnValue = unknown> = ((...args: Args) => ReturnValue) & {
+    __workletHash?: number;
+};
+/** Upstream's handle for a runtime that cannot exist here — see the refusals. */
+export type WorkletRuntime = {
+    __workletRuntime: true;
+};
+/** Upstream's serializer handle. Identity here: nothing leaves this runtime. */
+export type SerializableRef<T = unknown> = T;
+/** @deprecated Upstream's former name for {@link SerializableRef}. */
+export type ShareableRef<T = unknown> = SerializableRef<T>;
+/**
+ * The thread surface. `runOnUI`/`runOnJS`/`scheduleOnUI`/`scheduleOnRN` come
+ * from the same `createThreads` the Reanimated surface uses — index.ts hands
+ * both modules the SAME instance, so a job queued through either name lands
+ * in the same batch, as it does upstream where one package re-exports the
+ * other.
+ */
+export declare const createWorkletsSurface: () => {
+    runOnUIAsync: <A extends unknown[], R>(worklet: (...args: A) => R, ...args: A) => Promise<R>;
+    runOnUI: <A extends unknown[]>(worklet: (...args: A) => unknown) => (...args: A) => void;
+    scheduleOnUI: <A extends unknown[]>(worklet: (...args: A) => unknown, ...args: A) => void;
+    runOnJS: <A extends unknown[]>(fn: (...args: A) => unknown) => (...args: A) => void;
+    scheduleOnRN: <A extends unknown[]>(fn: (...args: A) => unknown, ...args: A) => void;
+};
+export { isWorkletFunction } from "../reanimated-compat/threads";
+/**
+ * Upstream's runtime taxonomy. There is one runtime here and it is the React
+ * Native one — GTK's main loop IS the JS thread — which is exactly what
+ * upstream's non-native path reports too: its initializer sets
+ * `__RUNTIME_KIND` to `ReactNative` and never changes it.
+ */
+export declare enum RuntimeKind {
+    ReactNative = 1,
+    UI = 2,
+    Worker = 3
+}
+export declare const getRuntimeKind: () => RuntimeKind;
+export declare const isRNRuntime: () => boolean;
+export declare const isUIRuntime: () => boolean;
+export declare const isWorkerRuntime: () => boolean;
+export declare const isWorkletRuntime: () => boolean;
+/** Mirrored as data, as upstream's non-native `runtimes.ts` does. */
+export declare const UIRuntimeId: number;
+/**
+ * The serializer, which on a single-runtime path is a file of identity
+ * functions — a value never leaves the runtime it was made in, so there is
+ * nothing to clone and nothing to register.
+ */
+export declare const createSerializable: <T>(value: T) => SerializableRef<T>;
+export declare const isSerializableRef: (value: unknown) => boolean;
+export declare const registerCustomSerializable: (registration: unknown) => void;
+export declare const makeShareable: <T>(value: T) => T;
+export declare const makeShareableCloneRecursive: <T>(value: T) => SerializableRef<T>;
+export declare const makeShareableCloneOnUIRecursive: <T>(value: T) => SerializableRef<T>;
+/** @deprecated Upstream's former name for {@link isSerializableRef}. */
+export declare const isShareableRef: (value: unknown) => boolean;
+/** The mapping cache upstream keeps for the serializer, which has nothing to map. */
+export declare const serializableMappingCache: {
+    set(serializable: object, ref?: unknown): void;
+    get(key: object): unknown;
+};
+/** @deprecated Upstream's former name for {@link serializableMappingCache}. */
+export declare const shareableMappingCache: {
+    set(serializable: object, ref?: unknown): void;
+    get(key: object): unknown;
+};
+/** Deprecated and a documented no-op upstream, kept callable for source parity. */
+export declare const callMicrotasks: () => void;
+/** Structural checks, portable exactly as upstream writes them. */
+export declare const isShareable: (value: unknown) => boolean;
+export declare const isSynchronizable: (value: unknown) => boolean;
+/**
+ * Bundle mode is a Babel/Metro transform of upstream's own plugin, which this
+ * platform never runs — so the honest answer is upstream's non-native one.
+ */
+export declare const isBundleModeEnabled: () => boolean;
+/** A debug toggle for the UI runtime's clock, which is this platform's only clock. */
+export declare const toggleSlowAnimationsOnUIRuntime: () => boolean;
+/**
+ * Feature flags gate upstream's own native experiments. None of them exist
+ * here, so every flag reads false and setting one changes nothing — again
+ * upstream's non-native answer rather than an invention.
+ */
+export declare const getStaticFeatureFlag: (name: string) => boolean;
+export declare const getDynamicFeatureFlag: (name: string) => boolean;
+export declare const setDynamicFeatureFlag: (name: string, value: boolean) => void;
+export declare const createWorkletRuntime: any;
+export declare const runOnRuntime: any;
+export declare const runOnRuntimeAsync: any;
+export declare const runOnRuntimeAsyncWithId: any;
+export declare const runOnRuntimeSync: any;
+export declare const runOnRuntimeSyncWithId: any;
+export declare const scheduleOnRuntime: any;
+export declare const scheduleOnRuntimeWithId: any;
+export declare const getUIRuntimeHolder: any;
+export declare const getUISchedulerHolder: any;
+export declare const runOnUISync: any;
+export declare const executeOnUIRuntimeSync: any;
+export declare const createShareable: any;
+export declare const createSynchronizable: any;
+/**
+ * The TurboModule behind the whole package. Upstream's non-native build
+ * exports it as `null`, which fails as "cannot read properties of null" and
+ * names nothing; this refuses by name instead. The one deliberate deviation
+ * from the mirror rule above, and it can only ever turn a worse error into a
+ * better one — nothing that works against `null` works against a refusal.
+ */
+export declare const WorkletsModule: any;