react-native-gtkx 0.1.0-alpha.1

package/dist/vite/index.js

@@ -0,0 +1,127 @@
+// react-native-gtkx/vite — makes a gtkx project React Native compatible.
+// The gtkx CLI (dev and build) starts vite with an inline config that never
+// sets `configFile: false`, so vite picks up the project's vite.config.ts
+// 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.
+import { existsSync } from "node:fs";
+import { dirname, extname, isAbsolute, resolve } from "node:path";
+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";
+/**
+ * Maps `react-native` (and its subpaths) to `react-native-gtkx`.
+ * Returns null for every other specifier, including `react-native-gtkx`
+ * itself and lookalikes such as `react-native-web`.
+ */
+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)}`;
+    }
+    return null;
+};
+/** Splits a vite specifier into its path part and its `?query` suffix. */
+export const splitQuery = (source) => {
+    const index = source.indexOf("?");
+    if (index === -1) {
+        return { specifier: source, query: "" };
+    }
+    return { specifier: source.slice(0, index), query: source.slice(index) };
+};
+const isRelative = (specifier) => specifier.startsWith("./") || specifier.startsWith("../");
+/**
+ * Ordered platform suffixes, platform-major: every extension of the first
+ * platform is tried before any extension of the next one
+ * (`.linux.tsx`, `.linux.ts`, …, `.native.tsx`, …).
+ */
+export const platformSuffixes = (options = {}) => {
+    const platforms = options.platforms ?? DEFAULT_PLATFORMS;
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    return platforms.flatMap((platform) => extensions.map((extension) => `.${platform}.${extension}`));
+};
+/**
+ * Candidate file paths for an extensionless base path, in priority order:
+ * direct platform files first, then platform index files of a directory —
+ * mirroring Metro, which exhausts file resolution before directory resolution.
+ * The base file itself is not a candidate: when no platform file exists the
+ * plugin bails out and the default resolver picks the base module.
+ */
+export const platformCandidates = (base, options = {}) => {
+    const suffixes = platformSuffixes(options);
+    return [
+        ...suffixes.map((suffix) => `${base}${suffix}`),
+        ...suffixes.map((suffix) => `${base}/index${suffix}`),
+    ];
+};
+/**
+ * Metro platform-extension resolution for a single import:
+ * only extensionless relative (or absolute) specifiers participate; the first
+ * existing candidate wins; the `?query` suffix is carried over. Returns null
+ * when the import is out of scope or no platform file exists, handing the
+ * import back to the default resolver.
+ */
+export const resolvePlatformSpecifier = (source, importer, exists, options = {}) => {
+    if (importer === undefined || source.startsWith("\0")) {
+        return null;
+    }
+    const { specifier, query } = splitQuery(source);
+    if (!isRelative(specifier) && !isAbsolute(specifier)) {
+        return null;
+    }
+    if (extname(specifier) !== "") {
+        return null;
+    }
+    const base = isAbsolute(specifier)
+        ? specifier
+        : resolve(dirname(splitQuery(importer).specifier), specifier);
+    for (const candidate of platformCandidates(base, options)) {
+        if (exists(candidate)) {
+            return candidate + query;
+        }
+    }
+    return null;
+};
+/**
+ * Vite plugin: aliases `react-native` (and subpaths) to `react-native-gtkx`
+ * 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.
+            //
+            // "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.
+            noExternal: ["react-native-gtkx", "react-native"],
+        },
+    }),
+    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

@@ -0,0 +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\"\n\n/**\n * Maps `react-native` (and its subpaths) to `react-native-gtkx`.\n * Returns null for every other specifier, including `react-native-gtkx`\n * itself and lookalikes such as `react-native-web`.\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  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/**\n * Metro platform-extension resolution for a single import:\n * only extensionless relative (or absolute) specifiers participate; the first\n * existing candidate wins; the `?query` suffix is carried over. Returns null\n * when 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  if (extname(specifier) !== \"\") {\n    return null\n  }\n  const base = isAbsolute(specifier)\n    ? specifier\n    : resolve(dirname(splitQuery(importer).specifier), specifier)\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      noExternal: [\"react-native-gtkx\", \"react-native\"],\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"]}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "react-native-gtkx",
+  "version": "0.1.0-alpha.1",
+  "description": "React Native components and APIs for Linux desktop, rendered as native GTK4 widgets via gtkx",
+  "license": "MIT",
+  "author": "Anton Petrov <anton@itsmepetrov.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itsmepetrov/react-native-gtkx.git",
+    "directory": "packages/react-native-gtkx"
+  },
+  "homepage": "https://github.com/itsmepetrov/react-native-gtkx#readme",
+  "bugs": "https://github.com/itsmepetrov/react-native-gtkx/issues",
+  "keywords": [
+    "react-native",
+    "react",
+    "gtk",
+    "gtk4",
+    "libadwaita",
+    "linux",
+    "desktop",
+    "gnome",
+    "yoga",
+    "out-of-tree-platform"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=22.15"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./metro": {
+      "types": "./dist/metro/index.d.ts",
+      "default": "./dist/metro/index.js"
+    },
+    "./runner": {
+      "types": "./dist/runner/index.d.ts",
+      "default": "./dist/runner/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite/index.d.ts",
+      "default": "./dist/vite/index.js"
+    },
+    "./types": {
+      "types": "./types.d.ts",
+      "default": "./types.js"
+    }
+  },
+  "scripts": {
+    "prepack": "bash ../../scripts/sync-package-readme.sh",
+    "build:dist": "rm -rf dist && tsc -p tsconfig.build.json",
+    "watch:dist": "tsc -p tsconfig.build.json --watch --preserveWatchOutput"
+  },
+  "peerDependencies": {
+    "react": "^19",
+    "vite": "^7.0.0 || ^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@gtkx/cli": "1.0.0-rc.1",
+    "@gtkx/config": "1.0.0-rc.1",
+    "@gtkx/css": "1.0.0-rc.1",
+    "@gtkx/react": "1.0.0-rc.1",
+    "@gtkx/runtime": "1.0.0-rc.1",
+    "yoga-layout": "^3.2.1"
+  },
+  "devDependencies": {
+    "@gtkx/testing": "1.0.0-rc.1",
+    "@gtkx/vitest": "1.0.0-rc.1",
+    "vite": "^8.1.4"
+  },
+  "files": [
+    "dist",
+    "react-native.config.js",
+    "types.d.ts",
+    "types.js"
+  ]
+}

package/react-native.config.js

@@ -0,0 +1,21 @@
+// Out-of-tree platform declaration (the react-native-windows model): apps
+// depending on this package get the "linux" platform and the run-linux
+// command registered with the RN CLI. The package is type:module, so this
+// config is an ES module — the CLI loads dependency configs through a
+// loader that accepts both. The self-reference resolves through the
+// exports map into the built dist.
+import { commands } from "react-native-gtkx/runner"
+
+export default {
+  commands,
+  platforms: {
+    linux: {
+      npmPackageName: "react-native-gtkx",
+      // The out-of-tree contract requires both hooks. They feed autolinking
+      // of platform-native project files — our "native" is plain Node
+      // modules resolved at runtime, so there is nothing to link.
+      projectConfig: () => null,
+      dependencyConfig: () => null,
+    },
+  },
+}

package/types.d.ts

@@ -0,0 +1,43 @@
+// TypeScript extensions for the linux platform, applied to the STOCK
+// react-native types via module augmentation. Reference this file once in
+// the app — e.g. an env.d.ts containing:
+//
+//   import "react-native-gtkx/types"
+//
+// and `Platform.select({ linux: ... })` typechecks against the regular
+// react-native types (interfaces merge; the closed inline parameter types
+// of the stock overloads cannot be reopened, so the linux-aware signatures
+// are added as overloads). Future platform-specific props on standard
+// components (the react-native-windows pattern) belong here too.
+//
+// Known limitation: `Platform.OS === "linux"` cannot be taught to the
+// stock types — property types do not merge. Use
+// `Platform.select({ linux: ..., default: ... })` in typed code.
+
+declare module "react-native" {
+  interface PlatformStatic {
+    select<T>(
+      specifics: {
+        linux?: T
+        ios?: T
+        android?: T
+        macos?: T
+        windows?: T
+        web?: T
+        native?: T
+      } & { default: T },
+    ): T
+    select<T>(specifics: {
+      linux: T
+      ios?: T
+      android?: T
+      macos?: T
+      windows?: T
+      web?: T
+      native?: T
+      default?: T
+    }): T | undefined
+  }
+}
+
+export {}

package/types.js

@@ -0,0 +1,4 @@
+// Runtime stub for the type-only "react-native-gtkx/types" subpath: the
+// module exists purely for its ambient declarations (see types.d.ts), but
+// an accidental runtime import must not crash.
+export {}