react-native-gtkx 0.1.0-alpha.4 → 0.2.0-alpha.1

package/dist/svg/view-box.js

@@ -0,0 +1,108 @@
+// Pure viewBox / preserveAspectRatio math (SVG 1.1 §7.11). No gtkx imports —
+// the bridge feeds the result into Gtk.Snapshot.scale()/translate(), but the
+// arithmetic itself has nothing to do with GTK and is fully unit-testable.
+// "minX minY width height", comma or whitespace separated (SVG allows
+// either). Returns null for anything that doesn't parse to exactly 4
+// numbers or has a non-positive size — callers fall back to the identity
+// transform, same as SVG does when viewBox is absent.
+export const parseViewBox = (value) => {
+    if (!value) {
+        return null;
+    }
+    const parts = value
+        .trim()
+        .split(/[\s,]+/)
+        .map(Number);
+    if (parts.length !== 4 || parts.some((n) => Number.isNaN(n))) {
+        return null;
+    }
+    const [minX, minY, width, height] = parts;
+    if (width <= 0 || height <= 0) {
+        return null;
+    }
+    return { minX, minY, width, height };
+};
+const ALIGN_PATTERN = /^x(Min|Mid|Max)Y(Min|Mid|Max)$/;
+export const DEFAULT_PRESERVE_ASPECT_RATIO = {
+    align: { x: "mid", y: "mid" },
+    meetOrSlice: "meet",
+};
+// Tolerant like the transform-string parser: unrecognized tokens fall back
+// to the SVG default (xMidYMid meet) rather than throwing.
+export const parsePreserveAspectRatio = (value) => {
+    if (!value) {
+        return DEFAULT_PRESERVE_ASPECT_RATIO;
+    }
+    const tokens = value.trim().split(/\s+/);
+    const alignToken = tokens[0] ?? "";
+    const meetOrSlice = tokens[1] === "slice" ? "slice" : "meet";
+    if (alignToken === "none") {
+        return { align: "none", meetOrSlice };
+    }
+    const match = ALIGN_PATTERN.exec(alignToken);
+    if (!match) {
+        return DEFAULT_PRESERVE_ASPECT_RATIO;
+    }
+    const x = match[1].toLowerCase();
+    const y = match[2].toLowerCase();
+    return { align: { x, y }, meetOrSlice };
+};
+const IDENTITY = {
+    scaleX: 1,
+    scaleY: 1,
+    translateX: 0,
+    translateY: 0,
+};
+/**
+ * Maps viewBox user-space coordinates onto a `viewportWidth` x
+ * `viewportHeight` box: `screen = user * scale + translate`. Mirrors the SVG
+ * algorithm exactly (see spec §7.11) — "none" stretches independently per
+ * axis, "meet" fits the whole viewBox inside the viewport (letterboxing),
+ * "slice" fills the viewport and overflows the viewBox (the bridge clips to
+ * the viewport bounds, same as a real SVG renderer).
+ */
+export const resolveViewBoxTransform = (viewBox, viewportWidth, viewportHeight, preserveAspectRatio = DEFAULT_PRESERVE_ASPECT_RATIO) => {
+    if (!viewBox || viewportWidth <= 0 || viewportHeight <= 0) {
+        return IDENTITY;
+    }
+    const rawScaleX = viewportWidth / viewBox.width;
+    const rawScaleY = viewportHeight / viewBox.height;
+    let scaleX;
+    let scaleY;
+    if (preserveAspectRatio.align === "none") {
+        scaleX = rawScaleX;
+        scaleY = rawScaleY;
+    }
+    else {
+        const scale = preserveAspectRatio.meetOrSlice === "meet"
+            ? Math.min(rawScaleX, rawScaleY)
+            : Math.max(rawScaleX, rawScaleY);
+        scaleX = scale;
+        scaleY = scale;
+    }
+    let alignOffsetX = 0;
+    let alignOffsetY = 0;
+    if (preserveAspectRatio.align !== "none") {
+        const extraX = viewportWidth - viewBox.width * scaleX;
+        const extraY = viewportHeight - viewBox.height * scaleY;
+        if (preserveAspectRatio.align.x === "mid") {
+            alignOffsetX = extraX / 2;
+        }
+        else if (preserveAspectRatio.align.x === "max") {
+            alignOffsetX = extraX;
+        }
+        if (preserveAspectRatio.align.y === "mid") {
+            alignOffsetY = extraY / 2;
+        }
+        else if (preserveAspectRatio.align.y === "max") {
+            alignOffsetY = extraY;
+        }
+    }
+    return {
+        scaleX,
+        scaleY,
+        translateX: alignOffsetX - viewBox.minX * scaleX,
+        translateY: alignOffsetY - viewBox.minY * scaleY,
+    };
+};
+//# sourceMappingURL=view-box.js.map

package/dist/svg/view-box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-box.js","sourceRoot":"","sources":["../../src/svg/view-box.ts"],"names":[],"mappings":"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","sourcesContent":["// Pure viewBox / preserveAspectRatio math (SVG 1.1 §7.11). No gtkx imports —\n// the bridge feeds the result into Gtk.Snapshot.scale()/translate(), but the\n// arithmetic itself has nothing to do with GTK and is fully unit-testable.\n\nexport type ViewBox = {\n  minX: number\n  minY: number\n  width: number\n  height: number\n}\n\n// \"minX minY width height\", comma or whitespace separated (SVG allows\n// either). Returns null for anything that doesn't parse to exactly 4\n// numbers or has a non-positive size — callers fall back to the identity\n// transform, same as SVG does when viewBox is absent.\nexport const parseViewBox = (value: string | undefined): ViewBox | null => {\n  if (!value) {\n    return null\n  }\n  const parts = value\n    .trim()\n    .split(/[\\s,]+/)\n    .map(Number)\n  if (parts.length !== 4 || parts.some((n) => Number.isNaN(n))) {\n    return null\n  }\n  const [minX, minY, width, height] = parts as [number, number, number, number]\n  if (width <= 0 || height <= 0) {\n    return null\n  }\n  return { minX, minY, width, height }\n}\n\nexport type AlignX = \"min\" | \"mid\" | \"max\"\nexport type AlignY = \"min\" | \"mid\" | \"max\"\nexport type MeetOrSlice = \"meet\" | \"slice\"\n\nexport type PreserveAspectRatio = {\n  align: \"none\" | { x: AlignX; y: AlignY }\n  meetOrSlice: MeetOrSlice\n}\n\nconst ALIGN_PATTERN = /^x(Min|Mid|Max)Y(Min|Mid|Max)$/\n\nexport const DEFAULT_PRESERVE_ASPECT_RATIO: PreserveAspectRatio = {\n  align: { x: \"mid\", y: \"mid\" },\n  meetOrSlice: \"meet\",\n}\n\n// Tolerant like the transform-string parser: unrecognized tokens fall back\n// to the SVG default (xMidYMid meet) rather than throwing.\nexport const parsePreserveAspectRatio = (\n  value: string | undefined,\n): PreserveAspectRatio => {\n  if (!value) {\n    return DEFAULT_PRESERVE_ASPECT_RATIO\n  }\n  const tokens = value.trim().split(/\\s+/)\n  const alignToken = tokens[0] ?? \"\"\n  const meetOrSlice: MeetOrSlice = tokens[1] === \"slice\" ? \"slice\" : \"meet\"\n  if (alignToken === \"none\") {\n    return { align: \"none\", meetOrSlice }\n  }\n  const match = ALIGN_PATTERN.exec(alignToken)\n  if (!match) {\n    return DEFAULT_PRESERVE_ASPECT_RATIO\n  }\n  const x = match[1]!.toLowerCase() as AlignX\n  const y = match[2]!.toLowerCase() as AlignY\n  return { align: { x, y }, meetOrSlice }\n}\n\nexport type ViewBoxTransform = {\n  scaleX: number\n  scaleY: number\n  translateX: number\n  translateY: number\n}\n\nconst IDENTITY: ViewBoxTransform = {\n  scaleX: 1,\n  scaleY: 1,\n  translateX: 0,\n  translateY: 0,\n}\n\n/**\n * Maps viewBox user-space coordinates onto a `viewportWidth` x\n * `viewportHeight` box: `screen = user * scale + translate`. Mirrors the SVG\n * algorithm exactly (see spec §7.11) — \"none\" stretches independently per\n * axis, \"meet\" fits the whole viewBox inside the viewport (letterboxing),\n * \"slice\" fills the viewport and overflows the viewBox (the bridge clips to\n * the viewport bounds, same as a real SVG renderer).\n */\nexport const resolveViewBoxTransform = (\n  viewBox: ViewBox | null,\n  viewportWidth: number,\n  viewportHeight: number,\n  preserveAspectRatio: PreserveAspectRatio = DEFAULT_PRESERVE_ASPECT_RATIO,\n): ViewBoxTransform => {\n  if (!viewBox || viewportWidth <= 0 || viewportHeight <= 0) {\n    return IDENTITY\n  }\n  const rawScaleX = viewportWidth / viewBox.width\n  const rawScaleY = viewportHeight / viewBox.height\n\n  let scaleX: number\n  let scaleY: number\n  if (preserveAspectRatio.align === \"none\") {\n    scaleX = rawScaleX\n    scaleY = rawScaleY\n  } else {\n    const scale =\n      preserveAspectRatio.meetOrSlice === \"meet\"\n        ? Math.min(rawScaleX, rawScaleY)\n        : Math.max(rawScaleX, rawScaleY)\n    scaleX = scale\n    scaleY = scale\n  }\n\n  let alignOffsetX = 0\n  let alignOffsetY = 0\n  if (preserveAspectRatio.align !== \"none\") {\n    const extraX = viewportWidth - viewBox.width * scaleX\n    const extraY = viewportHeight - viewBox.height * scaleY\n    if (preserveAspectRatio.align.x === \"mid\") {\n      alignOffsetX = extraX / 2\n    } else if (preserveAspectRatio.align.x === \"max\") {\n      alignOffsetX = extraX\n    }\n    if (preserveAspectRatio.align.y === \"mid\") {\n      alignOffsetY = extraY / 2\n    } else if (preserveAspectRatio.align.y === \"max\") {\n      alignOffsetY = extraY\n    }\n  }\n\n  return {\n    scaleX,\n    scaleY,\n    translateX: alignOffsetX - viewBox.minX * scaleX,\n    translateY: alignOffsetY - viewBox.minY * scaleY,\n  }\n}\n"]}

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

@@ -0,0 +1 @@
+export { Circle, Defs, Ellipse, G, Line, LinearGradient, Path, Polygon, Polyline, RadialGradient, Rect, Stop, Svg, Svg as default, type AnimatableNumber, type CircleProps, type DefsProps, type EllipseProps, type GProps, type LinearGradientProps, type LineProps, type PathProps, type PolygonProps, type PolylineProps, type RadialGradientProps, type RectProps, type StopProps, type SvgFillRule, type SvgLineCap, type SvgLineJoin, type SvgProps, } from "../components/svg/index";

package/dist/svg-compat/index.js

@@ -0,0 +1,16 @@
+// react-native-svg compatibility subpath (by the same pattern as
+// react-native-gtkx/navigation): re-exports our SVG component set in the
+// shape portable code expects — `Svg` as both the default and a named
+// export, everything else named — once an app aliases the bare
+// react-native-svg package name to this subpath. See the alias the metro/
+// vite presets add automatically (packages/react-native-gtkx/src/metro/
+// index.ts, src/vite/index.ts), or a manual bundler alias for apps using
+// neither. The upstream package itself is never a dependency of this one;
+// nothing here imports it — this module only mirrors its export shape.
+//
+// Deliberate gaps against react-native-svg's full surface (see docs/api.md
+// "Svg" for the complete list and the reasoning): no SvgXml/SvgUri (SVG
+// files already load through Image, a different mechanism), no Text/
+// TSpan/TextPath, no Mask/ClipPath/Filter/Marker/Symbol/Use/Pattern.
+export { Circle, Defs, Ellipse, G, Line, LinearGradient, Path, Polygon, Polyline, RadialGradient, Rect, Stop, Svg, Svg as default, } from "../components/svg/index";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/svg-compat/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,yEAAyE;AACzE,sEAAsE;AACtE,+DAA+D;AAC/D,0EAA0E;AAC1E,wEAAwE;AACxE,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,qEAAqE;AACrE,qEAAqE;AACrE,OAAO,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,CAAC,EACD,IAAI,EACJ,cAAc,EACd,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,cAAc,EACd,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,GAAG,IAAI,OAAO,GAkBf,MAAM,yBAAyB,CAAA","sourcesContent":["// react-native-svg compatibility subpath (by the same pattern as\n// react-native-gtkx/navigation): re-exports our SVG component set in the\n// shape portable code expects — `Svg` as both the default and a named\n// export, everything else named — once an app aliases the bare\n// react-native-svg package name to this subpath. See the alias the metro/\n// vite presets add automatically (packages/react-native-gtkx/src/metro/\n// index.ts, src/vite/index.ts), or a manual bundler alias for apps using\n// neither. The upstream package itself is never a dependency of this one;\n// nothing here imports it — this module only mirrors its export shape.\n//\n// Deliberate gaps against react-native-svg's full surface (see docs/api.md\n// \"Svg\" for the complete list and the reasoning): no SvgXml/SvgUri (SVG\n// files already load through Image, a different mechanism), no Text/\n// TSpan/TextPath, no Mask/ClipPath/Filter/Marker/Symbol/Use/Pattern.\nexport {\n  Circle,\n  Defs,\n  Ellipse,\n  G,\n  Line,\n  LinearGradient,\n  Path,\n  Polygon,\n  Polyline,\n  RadialGradient,\n  Rect,\n  Stop,\n  Svg,\n  Svg as default,\n  type AnimatableNumber,\n  type CircleProps,\n  type DefsProps,\n  type EllipseProps,\n  type GProps,\n  type LinearGradientProps,\n  type LineProps,\n  type PathProps,\n  type PolygonProps,\n  type PolylineProps,\n  type RadialGradientProps,\n  type RectProps,\n  type StopProps,\n  type SvgFillRule,\n  type SvgLineCap,\n  type SvgLineJoin,\n  type SvgProps,\n} from \"../components/svg/index\"\n"]}

package/dist/testing/index.d.ts

@@ -0,0 +1,14 @@
+import type { RenderHookOptions, RenderHookResult, RenderResult } from "@gtkx/testing";
+export * from "@gtkx/testing";
+/**
+ * Like `renderHook`, but first creates and presents a harness window (via
+ * `render(null)`), so window-dependent hooks have a toplevel to read.
+ * Cleanup is automatic — @gtkx/testing tears down every active render
+ * (including the harness window) after each test.
+ */
+export declare function renderHookWithWindow<Result>(callback: () => Result, options?: RenderHookOptions<undefined>): Promise<RenderHookResult<Result, undefined> & {
+    window: RenderResult["container"];
+}>;
+export declare function renderHookWithWindow<Result, Props>(callback: (props: Props) => Result, options: RenderHookOptions<Props>): Promise<RenderHookResult<Result, Props> & {
+    window: RenderResult["container"];
+}>;

package/dist/testing/index.js

@@ -0,0 +1,14 @@
+import { render, renderHook } from "@gtkx/testing";
+// react-native-gtkx/testing — @gtkx/testing's queries, render, renderHook,
+// fireEvent and userEvent already operate on the real GTK widget tree our
+// RN components render into, so `getByText` on a `Text` or `userEvent.click`
+// on a `Pressable` already work with no RN-flavoured wrapper: this subpath
+// re-exports that surface as-is, one import source for a consumer, plus the
+// one genuinely repeated workaround (see below).
+export * from "@gtkx/testing";
+export async function renderHookWithWindow(callback, options) {
+    const { container: window } = await render(null);
+    const hook = await renderHook(callback, options);
+    return { ...hook, window };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAOlD,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,iDAAiD;AACjD,cAAc,eAAe,CAAA;AA2B7B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAmC,EACnC,OAAkC;IAIlC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,QAAoC,EACpC,OAAmC,CACpC,CAAA;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAA;AAC5B,CAAC","sourcesContent":["import { render, renderHook } from \"@gtkx/testing\"\nimport type {\n  RenderHookOptions,\n  RenderHookResult,\n  RenderResult,\n} from \"@gtkx/testing\"\n\n// react-native-gtkx/testing — @gtkx/testing's queries, render, renderHook,\n// fireEvent and userEvent already operate on the real GTK widget tree our\n// RN components render into, so `getByText` on a `Text` or `userEvent.click`\n// on a `Pressable` already work with no RN-flavoured wrapper: this subpath\n// re-exports that surface as-is, one import source for a consumer, plus the\n// one genuinely repeated workaround (see below).\nexport * from \"@gtkx/testing\"\n\n// RC2-WORKAROUND(renderhook-no-window): see docs/gtkx-rc2-notes.md\n// @gtkx/testing's renderHook() always mounts its test component into a bare\n// Gtk.Box, so a hook that reads the active toplevel (useWindowDimensions,\n// anything through Gtk.Window.getToplevels()) has nothing to read. render()\n// always creates and presents a harness window when no container is given,\n// regardless of what it renders — rendering null is enough to get one.\n\n/**\n * Like `renderHook`, but first creates and presents a harness window (via\n * `render(null)`), so window-dependent hooks have a toplevel to read.\n * Cleanup is automatic — @gtkx/testing tears down every active render\n * (including the harness window) after each test.\n */\nexport function renderHookWithWindow<Result>(\n  callback: () => Result,\n  options?: RenderHookOptions<undefined>,\n): Promise<\n  RenderHookResult<Result, undefined> & { window: RenderResult[\"container\"] }\n>\nexport function renderHookWithWindow<Result, Props>(\n  callback: (props: Props) => Result,\n  options: RenderHookOptions<Props>,\n): Promise<\n  RenderHookResult<Result, Props> & { window: RenderResult[\"container\"] }\n>\nexport async function renderHookWithWindow<Result, Props>(\n  callback: (props?: Props) => Result,\n  options?: RenderHookOptions<Props>,\n): Promise<\n  RenderHookResult<Result, Props> & { window: RenderResult[\"container\"] }\n> {\n  const { container: window } = await render(null)\n  const hook = await renderHook(\n    callback as (props: Props) => Result,\n    options as RenderHookOptions<Props>,\n  )\n  return { ...hook, window }\n}\n"]}

package/dist/vite/index.d.ts

@@ -11,9 +11,13 @@ export type FileExists = (filePath: string) => boolean;
 export declare const DEFAULT_PLATFORMS: readonly string[];
 export declare const DEFAULT_EXTENSIONS: readonly string[];
 /**
- * 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`.
+ * 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.
  */
 export declare const rewriteReactNativeImport: (source: string) => string | null;
 /** Splits a vite specifier into its path part and its `?query` suffix. */

package/dist/vite/index.js

@@ -14,10 +14,16 @@ 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`.
- * Returns null for every other specifier, including `react-native-gtkx`
- * itself and lookalikes such as `react-native-web`.
+ * 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.
  */
 export const rewriteReactNativeImport = (source) => {
     if (source === REACT_NATIVE) {
@@ -26,6 +32,12 @@ export const rewriteReactNativeImport = (source) => {
     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;
 };
 /** Splits a vite specifier into its path part and its `?query` suffix. */

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\"\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// 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":"AAAA,yEAAyE;AACzE,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,4BAA4B;AAC5B,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,2EAA2E;AAC3E,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgBjE,MAAM,CAAC,MAAM,iBAAiB,GAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;AAE/E,MAAM,YAAY,GAAG,cAAc,CAAA;AACnC,MAAM,iBAAiB,GAAG,mBAAmB,CAAA;AAC7C,MAAM,gBAAgB,GAAG,kBAAkB,CAAA;AAC3C,MAAM,qBAAqB,GAAG,uBAAuB,CAAA;AAErD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAiB,EAAE;IACxE,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;QAC5B,OAAO,iBAAiB,CAAA;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,GAAG,iBAAiB,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IACnE,CAAC;IACD,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChC,OAAO,qBAAqB,CAAA;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,GAAG,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAA;IAC3E,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAc,EACwB,EAAE;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IACzC,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAA;AAC1E,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAW,EAAE,CAChD,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,UAAqC,EAAE,EAC7B,EAAE;IACZ,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAA;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAA;IAC3D,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACpC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC,CAC3D,CAAA;AACH,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAAY,EACZ,UAAqC,EAAE,EAC7B,EAAE;IACZ,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC1C,OAAO;QACL,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;QAC/C,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,SAAS,MAAM,EAAE,CAAC;KACtD,CAAA;AACH,CAAC,CAAA;AAED,qEAAqE;AACrE,0EAA0E;AAC1E,qEAAqE;AACrE,0EAA0E;AAC1E,qCAAqC;AACrC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,MAAc,EACd,QAA4B,EAC5B,MAAkB,EAClB,UAAqC,EAAE,EACxB,EAAE;IACjB,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAC/C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IACpC,IAAI,SAAS,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC;QACzC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAA;IAC/D,MAAM,IAAI,GACR,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC9E,KAAK,MAAM,SAAS,IAAI,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QAC1D,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,GAAG,KAAK,CAAA;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAMD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,UAAkC,EAAE,EAC5B,EAAE,CAAC,CAAC;IACZ,IAAI,EAAE,0BAA0B;IAChC,0EAA0E;IAC1E,uEAAuE;IACvE,OAAO,EAAE,KAAK;IAEd,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACb,GAAG,EAAE;YACH,iEAAiE;YACjE,kEAAkE;YAClE,sDAAsD;YACtD,EAAE;YACF,kEAAkE;YAClE,qEAAqE;YACrE,gEAAgE;YAChE,iEAAiE;YACjE,kEAAkE;YAClE,+BAA+B;YAC/B,iEAAiE;YACjE,qEAAqE;YACrE,mEAAmE;YACnE,qEAAqE;YACrE,qBAAqB;YACrB,UAAU,EAAE,CAAC,mBAAmB,EAAE,cAAc,EAAE,sBAAsB,CAAC;SAC1E;QACD,OAAO,EAAE;YACP,6DAA6D;YAC7D,qEAAqE;YACrE,iEAAiE;YACjE,iEAAiE;YACjE,qEAAqE;YACrE,gCAAgC;YAChC,MAAM,EAAE;gBACN,WAAW;gBACX,UAAU;gBACV,WAAW;gBACX,cAAc;gBACd,aAAa;gBACb,eAAe;gBACf,gEAAgE;gBAChE,kDAAkD;gBAClD,wBAAwB;gBACxB,0BAA0B;gBAC1B,OAAO;aACR;SACF;KACF,CAAC;IAEF,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ;QAC9B,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAA;QAChD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YAC1E,OAAO,QAAQ,IAAI,OAAO,CAAA;QAC5B,CAAC;QACD,OAAO,wBAAwB,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;IACxE,CAAC;CACF,CAAC,CAAA;AAEF,eAAe,eAAe,CAAA","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"]}

package/dist/vitest/index.d.ts

@@ -0,0 +1,52 @@
+import type { GtkxPluginOptions } from "@gtkx/vitest";
+import type { UserWorkspaceConfig } from "vitest/config";
+import { type ReactNativeGtkxOptions } from "../vite/index.js";
+/**
+ * Options accepted by {@link reactNativeGtkxTest}. Every field is optional
+ * and falls back to the recipe this repo's own test suite runs on.
+ */
+export type ReactNativeGtkxTestOptions = {
+    /** Vitest project name. Default: "gtk". */
+    name?: string;
+    /** Test file glob(s), relative to the project root. Default: `["**\/*.gtk.test.{ts,tsx}"]`. */
+    include?: string[];
+    /** Headless compositor size/compositor, forwarded to @gtkx/vitest's plugin. */
+    headless?: GtkxPluginOptions;
+    /** Metro-style platform resolution options, forwarded to the vite preset. */
+    platform?: ReactNativeGtkxOptions;
+    /**
+     * Extra `server.deps.inline` patterns, merged after the default
+     * (`/@react-navigation/`). Needed for any node_modules library that
+     * itself imports "react-native" — Vitest externalizes node_modules code
+     * by default, a path the react-native alias cannot reach.
+     */
+    inlineDeps?: (string | RegExp)[];
+    /** Extra setup files, run after the built-in React act-environment setup. */
+    setupFiles?: string[];
+    /**
+     * 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
+     * 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.
+     */
+    fileParallelism?: boolean;
+};
+/**
+ * A ready Vitest project config for react-native-gtkx component tests: the
+ * headless Wayland compositor, the react-native alias and platform
+ * extensions, and the React act-environment setup — the same recipe this
+ * repo's own suite runs on. Use the result as a whole config
+ * (`defineConfig(reactNativeGtkxTest())`) or as one entry of
+ * `test.projects` alongside a portable "unit" project.
+ *
+ * Requires a headless Wayland compositor on PATH (`sway` by default —
+ * `apt install sway xwayland dbus`, see docs/getting-started.md) and
+ * `gtkx codegen` to have already generated the project's `@gtkx/gi`
+ * bindings — a bare `vitest run` does not trigger codegen itself, unlike
+ * `gtkx dev`/`gtkx build`. A missing compositor or codegen store fails with
+ * a readable error (e.g. `Cannot find the "sway" executable on PATH`), not
+ * a hang.
+ */
+export declare const reactNativeGtkxTest: (options?: ReactNativeGtkxTestOptions) => Promise<UserWorkspaceConfig>;
+export default reactNativeGtkxTest;

package/dist/vitest/index.js

@@ -0,0 +1,58 @@
+// react-native-gtkx/vitest — the vitest recipe this repo's own test suite
+// runs on (see vitest.config.ts's "gtk" project), packaged for a consumer
+// app: the @gtkx/vitest headless-compositor plugin, the react-native-gtkx
+// vite preset (react-native alias + Metro-style platform extensions), a
+// default inline-deps list for RN libraries that import "react-native"
+// themselves, and the React act-environment setup.
+//
+// Self-contained like ./vite, ./metro and ./runner: a consumer's
+// vitest.config.ts is loaded the same way vite.config.ts is (vite's config
+// loader bundles only the user's own relative import graph; node_modules
+// imports stay bare specifiers, resolved afterwards by plain Node ESM) — so
+// this file must not contain extensionless relative imports. The one
+// relative import below carries an explicit ".js" extension, which a real
+// sibling file on disk resolves under plain Node without any bundler.
+import { fileURLToPath, URL } from "node:url";
+import { reactNativeGtkx } from "../vite/index.js";
+const DEFAULT_INCLUDE = ["**/*.gtk.test.{ts,tsx}"];
+const DEFAULT_INLINE_DEPS = [/@react-navigation/];
+const SETUP_FILE = fileURLToPath(new URL("./setup.js", import.meta.url));
+/**
+ * A ready Vitest project config for react-native-gtkx component tests: the
+ * headless Wayland compositor, the react-native alias and platform
+ * extensions, and the React act-environment setup — the same recipe this
+ * repo's own suite runs on. Use the result as a whole config
+ * (`defineConfig(reactNativeGtkxTest())`) or as one entry of
+ * `test.projects` alongside a portable "unit" project.
+ *
+ * Requires a headless Wayland compositor on PATH (`sway` by default —
+ * `apt install sway xwayland dbus`, see docs/getting-started.md) and
+ * `gtkx codegen` to have already generated the project's `@gtkx/gi`
+ * bindings — a bare `vitest run` does not trigger codegen itself, unlike
+ * `gtkx dev`/`gtkx build`. A missing compositor or codegen store fails with
+ * a readable error (e.g. `Cannot find the "sway" executable on PATH`), not
+ * a hang.
+ */
+export const reactNativeGtkxTest = async (options = {}) => {
+    const gtkx = (await import("@gtkx/vitest")).default;
+    const plugins = [
+        gtkx(options.headless),
+        reactNativeGtkx(options.platform),
+    ];
+    return {
+        plugins,
+        test: {
+            name: options.name ?? "gtk",
+            include: options.include ?? DEFAULT_INCLUDE,
+            setupFiles: [SETUP_FILE, ...(options.setupFiles ?? [])],
+            server: {
+                deps: {
+                    inline: [...DEFAULT_INLINE_DEPS, ...(options.inlineDeps ?? [])],
+                },
+            },
+            fileParallelism: options.fileParallelism ?? false,
+        },
+    };
+};
+export default reactNativeGtkxTest;
+//# sourceMappingURL=index.js.map

package/dist/vitest/index.js.map

@@ -0,0 +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"]}

package/dist/vitest/setup.d.ts

@@ -0,0 +1,4 @@
+declare global {
+    var IS_REACT_ACT_ENVIRONMENT: boolean | undefined;
+}
+export {};

package/dist/vitest/setup.js

@@ -0,0 +1,22 @@
+// The React "act environment" flag. React batches and warns about updates
+// outside of `act()` unless this is set — required for @gtkx/testing's
+// render/renderHook to behave like React Testing Library. Referenced by an
+// absolute path computed with `import.meta.url` (see index.ts), not
+// statically imported, so it is a plain vitest setupFiles entry like
+// @gtkx/vitest's own worker-setup.js.
+import { beforeAll } from "vitest";
+const setActEnvironment = (value) => {
+    Object.defineProperty(globalThis, "IS_REACT_ACT_ENVIRONMENT", {
+        value,
+        configurable: true,
+        writable: true,
+    });
+};
+beforeAll(() => {
+    const previous = globalThis.IS_REACT_ACT_ENVIRONMENT;
+    setActEnvironment(true);
+    return () => {
+        setActEnvironment(previous);
+    };
+});
+//# sourceMappingURL=setup.js.map

package/dist/vitest/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/vitest/setup.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,uEAAuE;AACvE,2EAA2E;AAC3E,oEAAoE;AACpE,qEAAqE;AACrE,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAMlC,MAAM,iBAAiB,GAAG,CAAC,KAA0B,EAAQ,EAAE;IAC7D,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,0BAA0B,EAAE;QAC5D,KAAK;QACL,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,QAAQ,GAAG,UAAU,CAAC,wBAAwB,CAAA;IACpD,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAEvB,OAAO,GAAG,EAAE;QACV,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC,CAAA;AACH,CAAC,CAAC,CAAA","sourcesContent":["// The React \"act environment\" flag. React batches and warns about updates\n// outside of `act()` unless this is set — required for @gtkx/testing's\n// render/renderHook to behave like React Testing Library. Referenced by an\n// absolute path computed with `import.meta.url` (see index.ts), not\n// statically imported, so it is a plain vitest setupFiles entry like\n// @gtkx/vitest's own worker-setup.js.\nimport { beforeAll } from \"vitest\"\n\ndeclare global {\n  var IS_REACT_ACT_ENVIRONMENT: boolean | undefined\n}\n\nconst setActEnvironment = (value: boolean | undefined): void => {\n  Object.defineProperty(globalThis, \"IS_REACT_ACT_ENVIRONMENT\", {\n    value,\n    configurable: true,\n    writable: true,\n  })\n}\n\nbeforeAll(() => {\n  const previous = globalThis.IS_REACT_ACT_ENVIRONMENT\n  setActEnvironment(true)\n\n  return () => {\n    setActEnvironment(previous)\n  }\n})\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-gtkx",
-  "version": "0.1.0-alpha.4",
+  "version": "0.2.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>",
@@ -47,24 +47,56 @@
       "types": "./dist/navigation/index.d.ts",
       "default": "./dist/navigation/index.js"
     },
+    "./svg": {
+      "types": "./dist/svg-compat/index.d.ts",
+      "default": "./dist/svg-compat/index.js"
+    },
+    "./gtk": {
+      "types": "./dist/gtk/index.d.ts",
+      "default": "./dist/gtk/index.js"
+    },
+    "./adw": {
+      "types": "./dist/adw/index.d.ts",
+      "default": "./dist/adw/index.js"
+    },
+    "./common": {
+      "types": "./dist/common/index.d.ts",
+      "default": "./dist/common/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "default": "./dist/mcp/index.js"
+    },
     "./vite": {
       "types": "./dist/vite/index.d.ts",
       "default": "./dist/vite/index.js"
     },
+    "./vitest": {
+      "types": "./dist/vitest/index.d.ts",
+      "default": "./dist/vitest/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    },
     "./types": {
       "types": "./types.d.ts",
       "default": "./types.js"
     }
   },
+  "bin": {
+    "react-native-gtkx-mcp": "./dist/mcp/bin.js"
+  },
   "scripts": {
-    "prepack": "bash ../../scripts/sync-package-readme.sh",
-    "build:dist": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepack": "node ../../scripts/sync-package-readme.ts",
+    "build:dist": "rm -rf dist && tsc -p tsconfig.build.json && chmod +x dist/mcp/bin.js",
     "watch:dist": "tsc -p tsconfig.build.json --watch --preserveWatchOutput"
   },
   "peerDependencies": {
-    "@react-navigation/native": "^7.0.0",
+    "@react-navigation/native": "^8.0.0-alpha.40 || ^8.0.0",
     "react": "^19.2",
-    "vite": "^7.0.0 || ^8.0.0"
+    "vite": "^7.0.0 || ^8.0.0",
+    "vitest": ">=4"
   },
   "peerDependenciesMeta": {
     "@react-navigation/native": {
@@ -72,19 +104,26 @@
     },
     "vite": {
       "optional": true
+    },
+    "vitest": {
+      "optional": true
     }
   },
   "dependencies": {
     "@gtkx/cli": "1.0.0-rc.2",
+    "@gtkx/codegen": "1.0.0-rc.2",
     "@gtkx/config": "1.0.0-rc.2",
     "@gtkx/css": "1.0.0-rc.2",
     "@gtkx/react": "1.0.0-rc.2",
     "@gtkx/runtime": "1.0.0-rc.2",
-    "yoga-layout": "^3.2.1"
-  },
-  "devDependencies": {
     "@gtkx/testing": "1.0.0-rc.2",
     "@gtkx/vitest": "1.0.0-rc.2",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "rolldown": "^1.1.5",
+    "yoga-layout": "^3.2.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
     "vite": "^8.1.4"
   },
   "files": [