@multiplatform.one/vite-plugin-gnome 6.2.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2021 [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,61 @@
+# @multiplatform.one/vite-plugin-gnome
+
+Vite plugin that makes Tamagui render under
+[react-gnome](https://github.com/bitspur/react-gnome) (GTK4 / GJS /
+libadwaita). Real Tamagui (`@tamagui/core/native`) assumes a
+react-native-web-lite runtime; under GJS none of that holds, so this
+package patches the bundler's view of the upstream packages instead of
+reimplementing them.
+
+Pairs with `@react-gnome/vite-plugin`, which carries the GENERIC
+react-gnome-under-GJS settings (react-native → @react-gnome aliases,
+react-native-first resolve conditions, GJS `define` shims, React
+dedupe, the polyfills-first contract). This package carries only the
+Tamagui-specific parts.
+
+## Exports
+
+| export                          | what it is                                                                                                                                                                            |
+| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `tamaguiPlugin`                 | per-source `transform` (lazy-init/StyleSheet/Platform fixes, hover + animation gates, sheet/portal native-build fixes) + post-bundle `generateBundle` (duplicate-`init_esm$1` dedupe) |
+| `tamaguiAliases(options)`       | `@tamagui/core` + `@tamagui/web` → `@tamagui/core/native`, `tamagui` meta-package → your lean barrel, optional lucide shim (string finds)                                             |
+| `tamaguiLinkedAliases(options)` | same entries as exact-match regexes — for alias lists that mix in absolute-path replacements (pnpm `link:` consumers)                                                                 |
+| `tamaguiPatchAnchors`           | every regex the patches anchor on, exported for the anchor-verification test                                                                                                          |
+
+## Usage
+
+```ts
+import { gnomeAliases, gnomeConditions, gnomeDefine } from "@react-gnome/vite-plugin";
+import { tamaguiAliases, tamaguiPlugin } from "@multiplatform.one/vite-plugin-gnome";
+import { resolve } from "node:path";
+
+export default defineConfig({
+  plugins: [react(), tamaguiPlugin],
+  resolve: {
+    conditions: [...gnomeConditions],
+    alias: [
+      ...gnomeAliases(reactGnomePackagesDir),
+      ...tamaguiAliases({
+        tamaguiBarrel: resolve(import.meta.dirname, "src/tamagui-barrel.ts"),
+      }),
+    ],
+  },
+  define: gnomeDefine("production"),
+});
+```
+
+## The anchor-verification test
+
+The patches are FRAGILE BY DESIGN: each one anchors on a regex over the
+`@tamagui/*` dist files. A Tamagui version bump that reshapes those
+files makes a patch silently no-op in the build — the breakage only
+surfaces as runtime failures under GJS. `tests/anchors.test.ts` asserts
+every anchor still matches the pinned `@tamagui/*` devDependencies:
+
+```sh
+pnpm --filter @multiplatform.one/vite-plugin-gnome test
+```
+
+**When bumping Tamagui:** bump the `@tamagui/core` / `@tamagui/sheet` /
+`@tamagui/portal` devDependencies here in lockstep with the app, run
+the test, and re-derive any anchor it reports as lost.

package/lib/index.cjs

@@ -0,0 +1,222 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/index.ts
+const sheetPatch = {
+	name: "sheet-animated-view-relative-position",
+	module: "@tamagui/sheet",
+	precondition: "forcedContentHeight",
+	find: /(style:\s*\[\s*\{\s*\n?\s*)position:\s*['"]absolute['"](,\s*\n?\s*zIndex,\s*\n?\s*width:\s*['"]100%['"],\s*\n?\s*height:\s*forcedContentHeight)/g,
+	replace: "$1position: \"relative\"$2"
+};
+const portalPatch = {
+	name: "portal-needs-repropagation-on-gnome",
+	module: "@tamagui/portal",
+	precondition: "needsPortalRepropagation",
+	find: /return isAndroid \|\| isIos;/,
+	replace: "return true; /* react-gnome: Gorhom portal loses context on every native platform */"
+};
+const corePrecondition = "console.warn(\"no-op native\")";
+const corePatches = [
+	{
+		name: "core-noop-native-stub",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /function\s*\(\s*\)\s*\{\s*console\.warn\("no-op native"\);?\s*\}/g,
+		replace: "function(input) { return input && typeof input === 'object' ? Object.entries(input) : []; }"
+	},
+	{
+		name: "core-pass-down-prop-reorder",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /\} else viewProps\[key\] = val;/,
+		replace: "} else { delete viewProps[key]; viewProps[key] = val; }"
+	},
+	{
+		name: "core-text-ancestor-context",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /native\.unstable_TextAncestorContext/g,
+		replace: "(native.unstable_TextAncestorContext || native.TextAncestorContext)"
+	},
+	{
+		name: "core-init-platform-chain",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var\s+init_Platform\s*=\s*__esmMin\(\(\(\)\s*=>\s*\{\s*init_esm\$1\(\);\s*\}\)\);/,
+		replace: "var init_Platform = __esmMin((() => { init_esm$1(); init_Platform$1(); }));"
+	},
+	{
+		name: "core-stylesheet-declaration-shims",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /function StyleSheet\(styles, options\) \{\}/g,
+		replace: "function StyleSheet(styles, options) {} StyleSheet.create = (s) => s; StyleSheet.compose = (a, b) => [a, b]; StyleSheet.flatten = (s) => Array.isArray(s) ? Object.assign({}, ...s.filter(Boolean)) : (s || {}); StyleSheet.hairlineWidth = 1; StyleSheet.absoluteFill = { position: 'absolute', left: 0, right: 0, top: 0, bottom: 0 }; StyleSheet.absoluteFillObject = StyleSheet.absoluteFill;"
+	},
+	{
+		name: "core-runtime-animation-prop-gate",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var hasAnimationProp = Boolean\(!isHOC && "transition" in props \|\| props\.style && hasAnimatedStyleValue\(props\.style\)\);/,
+		replace: "var hasAnimationProp = Boolean(!isHOC && (\"transition\" in props || \"animation\" in props) || props.style && hasAnimatedStyleValue(props.style));"
+	},
+	{
+		name: "core-attach-hover-on-desktop",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var attachHover = false;/g,
+		replace: "var attachHover = Boolean(needsHoverState || onHoverIn || onHoverOut || onMouseEnter || onMouseLeave);"
+	},
+	{
+		name: "core-forward-hover-handlers",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /if \(events\.onBlur\) viewProps\["onBlur"\] = events\.onBlur;/,
+		replace: "if (events.onBlur) viewProps[\"onBlur\"] = events.onBlur; if (events.onMouseEnter) viewProps[\"onMouseEnter\"] = events.onMouseEnter; if (events.onMouseLeave) viewProps[\"onMouseLeave\"] = events.onMouseLeave;"
+	},
+	{
+		name: "core-use-did-finish-ssr",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /function useDidFinishSSR\(\)\s*\{\s*react\.useContext\(ClientOnlyContext\);\s*return true;\s*\}/g,
+		replace: "function useDidFinishSSR() { return true; }"
+	},
+	{
+		name: "core-use-is-client-only",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var useIsClientOnly;\s*var (init_index_native\$\d+)/g,
+		replace: "var useIsClientOnly = () => false; var $1"
+	},
+	{
+		name: "core-use-isomorphic-insertion-effect",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var useIsomorphicInsertionEffect;/g,
+		replace: "var useIsomorphicInsertionEffect = (react.useInsertionEffect || react.useLayoutEffect);"
+	}
+];
+const initEsmVendorSignature = {
+	name: "core-init-esm-vendor-signature",
+	module: "@tamagui/core",
+	precondition: "init_AssetRegistry();",
+	find: /var\s+init_esm\$1\s*=\s*__esmMin\(\(\(\)\s*=>\s*\{\s*init_AssetRegistry\(\);/
+};
+/**
+* Every source pattern the patch set anchors on, in apply order. The
+* package's anchor-verification test asserts each one still matches
+* the pinned @tamagui/* dist files — the loud-failure guard for
+* Tamagui version bumps.
+*/
+const tamaguiPatchAnchors = [
+	sheetPatch,
+	portalPatch,
+	...corePatches,
+	initEsmVendorSignature
+];
+const tamaguiPlugin = {
+	name: "rgn-tamagui-noop-fix",
+	enforce: "post",
+	transform(code, id) {
+		if (id.includes(sheetPatch.module) && code.includes(sheetPatch.precondition)) {
+			const out = code.replace(sheetPatch.find, sheetPatch.replace);
+			if (out !== code) return out;
+		}
+		if (id.includes(portalPatch.module) && code.includes(portalPatch.precondition)) {
+			const out = code.replace(portalPatch.find, portalPatch.replace);
+			if (out !== code) return out;
+		}
+		if (!id.includes("@tamagui/core") && !id.includes("@tamagui/web")) return;
+		if (!code.includes(corePrecondition)) return;
+		let out = code;
+		for (const patch of corePatches) out = out.replace(patch.find, patch.replace);
+		return out;
+	},
+	generateBundle(_opts, bundle) {
+		for (const fileName of Object.keys(bundle)) {
+			const c = bundle[fileName];
+			if (c.type !== "chunk") continue;
+			let src = c.code;
+			const m = src.match(initEsmVendorSignature.find);
+			if (!m || m.index === void 0) continue;
+			const firstDeclIdx = m.index;
+			const bodyStart = src.indexOf("{", firstDeclIdx + 29);
+			let depth = 1;
+			let i = bodyStart + 1;
+			for (; i < src.length && depth > 0; i++) if (src[i] === "{") depth++;
+			else if (src[i] === "}") depth--;
+			const firstEnd = src.indexOf("));", i) + 3;
+			const renamed = src.slice(firstDeclIdx, firstEnd).replace("var init_esm$1 = __esmMin", "var init_esm$1_vendor = __esmMin");
+			const secondDeclStart = src.indexOf("var init_esm$1 = __esmMin", firstEnd);
+			if (secondDeclStart < 0) continue;
+			const between = src.slice(firstEnd, secondDeclStart).replace(/init_esm\$1\(\)/g, "init_esm$1_vendor()");
+			const sBody = src.indexOf("{", secondDeclStart + 29);
+			let d2 = 1;
+			let j = sBody + 1;
+			for (; j < src.length && d2 > 0; j++) if (src[j] === "{") d2++;
+			else if (src[j] === "}") d2--;
+			const secondDeclEnd = src.indexOf("));", j) + 3;
+			const secondPatched = src.slice(secondDeclStart, secondDeclEnd).replace("init_esm$1();", "init_esm$1_vendor();");
+			src = src.slice(0, firstDeclIdx) + renamed + between + secondPatched + src.slice(secondDeclEnd);
+			c.code = src;
+		}
+	}
+};
+/**
+* Tamagui-specific resolver aliases for consumers whose @tamagui/*
+* packages resolve by bare name (string finds keep @rollup/plugin-alias
+* prefix semantics). Funnels `@tamagui/core` / `@tamagui/web` both into
+* the single `@tamagui/core/native` module so the TamaguiProvider's
+* config registry and high-level component lookups land in one place.
+*/
+function tamaguiAliases(options) {
+	return [
+		...options.lucideIcons ? [{
+			find: "@tamagui/lucide-icons-2",
+			replacement: options.lucideIcons
+		}] : [],
+		{
+			find: "@tamagui/core",
+			replacement: "@tamagui/core/native"
+		},
+		{
+			find: "@tamagui/web",
+			replacement: "@tamagui/core/native"
+		},
+		{
+			find: "tamagui",
+			replacement: options.tamaguiBarrel
+		}
+	];
+}
+/**
+* Same aliases with exact-match regexes — for consumers whose alias
+* list mixes in absolute-path replacements (e.g. apps pulling
+* @react-gnome in over pnpm `link:`), where a plain string prefix
+* alias could re-mangle other entries' replacements.
+*/
+function tamaguiLinkedAliases(options) {
+	return [
+		...options.lucideIcons ? [{
+			find: /^@tamagui\/lucide-icons-2$/,
+			replacement: options.lucideIcons
+		}] : [],
+		{
+			find: /^@tamagui\/core$/,
+			replacement: "@tamagui/core/native"
+		},
+		{
+			find: /^@tamagui\/web$/,
+			replacement: "@tamagui/core/native"
+		},
+		{
+			find: /^tamagui$/,
+			replacement: options.tamaguiBarrel
+		}
+	];
+}
+
+//#endregion
+exports.tamaguiAliases = tamaguiAliases;
+exports.tamaguiLinkedAliases = tamaguiLinkedAliases;
+exports.tamaguiPatchAnchors = tamaguiPatchAnchors;
+exports.tamaguiPlugin = tamaguiPlugin;

package/lib/index.mjs

@@ -0,0 +1,217 @@
+//#region src/index.ts
+const sheetPatch = {
+	name: "sheet-animated-view-relative-position",
+	module: "@tamagui/sheet",
+	precondition: "forcedContentHeight",
+	find: /(style:\s*\[\s*\{\s*\n?\s*)position:\s*['"]absolute['"](,\s*\n?\s*zIndex,\s*\n?\s*width:\s*['"]100%['"],\s*\n?\s*height:\s*forcedContentHeight)/g,
+	replace: "$1position: \"relative\"$2"
+};
+const portalPatch = {
+	name: "portal-needs-repropagation-on-gnome",
+	module: "@tamagui/portal",
+	precondition: "needsPortalRepropagation",
+	find: /return isAndroid \|\| isIos;/,
+	replace: "return true; /* react-gnome: Gorhom portal loses context on every native platform */"
+};
+const corePrecondition = "console.warn(\"no-op native\")";
+const corePatches = [
+	{
+		name: "core-noop-native-stub",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /function\s*\(\s*\)\s*\{\s*console\.warn\("no-op native"\);?\s*\}/g,
+		replace: "function(input) { return input && typeof input === 'object' ? Object.entries(input) : []; }"
+	},
+	{
+		name: "core-pass-down-prop-reorder",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /\} else viewProps\[key\] = val;/,
+		replace: "} else { delete viewProps[key]; viewProps[key] = val; }"
+	},
+	{
+		name: "core-text-ancestor-context",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /native\.unstable_TextAncestorContext/g,
+		replace: "(native.unstable_TextAncestorContext || native.TextAncestorContext)"
+	},
+	{
+		name: "core-init-platform-chain",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var\s+init_Platform\s*=\s*__esmMin\(\(\(\)\s*=>\s*\{\s*init_esm\$1\(\);\s*\}\)\);/,
+		replace: "var init_Platform = __esmMin((() => { init_esm$1(); init_Platform$1(); }));"
+	},
+	{
+		name: "core-stylesheet-declaration-shims",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /function StyleSheet\(styles, options\) \{\}/g,
+		replace: "function StyleSheet(styles, options) {} StyleSheet.create = (s) => s; StyleSheet.compose = (a, b) => [a, b]; StyleSheet.flatten = (s) => Array.isArray(s) ? Object.assign({}, ...s.filter(Boolean)) : (s || {}); StyleSheet.hairlineWidth = 1; StyleSheet.absoluteFill = { position: 'absolute', left: 0, right: 0, top: 0, bottom: 0 }; StyleSheet.absoluteFillObject = StyleSheet.absoluteFill;"
+	},
+	{
+		name: "core-runtime-animation-prop-gate",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var hasAnimationProp = Boolean\(!isHOC && "transition" in props \|\| props\.style && hasAnimatedStyleValue\(props\.style\)\);/,
+		replace: "var hasAnimationProp = Boolean(!isHOC && (\"transition\" in props || \"animation\" in props) || props.style && hasAnimatedStyleValue(props.style));"
+	},
+	{
+		name: "core-attach-hover-on-desktop",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var attachHover = false;/g,
+		replace: "var attachHover = Boolean(needsHoverState || onHoverIn || onHoverOut || onMouseEnter || onMouseLeave);"
+	},
+	{
+		name: "core-forward-hover-handlers",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /if \(events\.onBlur\) viewProps\["onBlur"\] = events\.onBlur;/,
+		replace: "if (events.onBlur) viewProps[\"onBlur\"] = events.onBlur; if (events.onMouseEnter) viewProps[\"onMouseEnter\"] = events.onMouseEnter; if (events.onMouseLeave) viewProps[\"onMouseLeave\"] = events.onMouseLeave;"
+	},
+	{
+		name: "core-use-did-finish-ssr",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /function useDidFinishSSR\(\)\s*\{\s*react\.useContext\(ClientOnlyContext\);\s*return true;\s*\}/g,
+		replace: "function useDidFinishSSR() { return true; }"
+	},
+	{
+		name: "core-use-is-client-only",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var useIsClientOnly;\s*var (init_index_native\$\d+)/g,
+		replace: "var useIsClientOnly = () => false; var $1"
+	},
+	{
+		name: "core-use-isomorphic-insertion-effect",
+		module: "@tamagui/core",
+		precondition: corePrecondition,
+		find: /var useIsomorphicInsertionEffect;/g,
+		replace: "var useIsomorphicInsertionEffect = (react.useInsertionEffect || react.useLayoutEffect);"
+	}
+];
+const initEsmVendorSignature = {
+	name: "core-init-esm-vendor-signature",
+	module: "@tamagui/core",
+	precondition: "init_AssetRegistry();",
+	find: /var\s+init_esm\$1\s*=\s*__esmMin\(\(\(\)\s*=>\s*\{\s*init_AssetRegistry\(\);/
+};
+/**
+* Every source pattern the patch set anchors on, in apply order. The
+* package's anchor-verification test asserts each one still matches
+* the pinned @tamagui/* dist files — the loud-failure guard for
+* Tamagui version bumps.
+*/
+const tamaguiPatchAnchors = [
+	sheetPatch,
+	portalPatch,
+	...corePatches,
+	initEsmVendorSignature
+];
+const tamaguiPlugin = {
+	name: "rgn-tamagui-noop-fix",
+	enforce: "post",
+	transform(code, id) {
+		if (id.includes(sheetPatch.module) && code.includes(sheetPatch.precondition)) {
+			const out = code.replace(sheetPatch.find, sheetPatch.replace);
+			if (out !== code) return out;
+		}
+		if (id.includes(portalPatch.module) && code.includes(portalPatch.precondition)) {
+			const out = code.replace(portalPatch.find, portalPatch.replace);
+			if (out !== code) return out;
+		}
+		if (!id.includes("@tamagui/core") && !id.includes("@tamagui/web")) return;
+		if (!code.includes(corePrecondition)) return;
+		let out = code;
+		for (const patch of corePatches) out = out.replace(patch.find, patch.replace);
+		return out;
+	},
+	generateBundle(_opts, bundle) {
+		for (const fileName of Object.keys(bundle)) {
+			const c = bundle[fileName];
+			if (c.type !== "chunk") continue;
+			let src = c.code;
+			const m = src.match(initEsmVendorSignature.find);
+			if (!m || m.index === void 0) continue;
+			const firstDeclIdx = m.index;
+			const bodyStart = src.indexOf("{", firstDeclIdx + 29);
+			let depth = 1;
+			let i = bodyStart + 1;
+			for (; i < src.length && depth > 0; i++) if (src[i] === "{") depth++;
+			else if (src[i] === "}") depth--;
+			const firstEnd = src.indexOf("));", i) + 3;
+			const renamed = src.slice(firstDeclIdx, firstEnd).replace("var init_esm$1 = __esmMin", "var init_esm$1_vendor = __esmMin");
+			const secondDeclStart = src.indexOf("var init_esm$1 = __esmMin", firstEnd);
+			if (secondDeclStart < 0) continue;
+			const between = src.slice(firstEnd, secondDeclStart).replace(/init_esm\$1\(\)/g, "init_esm$1_vendor()");
+			const sBody = src.indexOf("{", secondDeclStart + 29);
+			let d2 = 1;
+			let j = sBody + 1;
+			for (; j < src.length && d2 > 0; j++) if (src[j] === "{") d2++;
+			else if (src[j] === "}") d2--;
+			const secondDeclEnd = src.indexOf("));", j) + 3;
+			const secondPatched = src.slice(secondDeclStart, secondDeclEnd).replace("init_esm$1();", "init_esm$1_vendor();");
+			src = src.slice(0, firstDeclIdx) + renamed + between + secondPatched + src.slice(secondDeclEnd);
+			c.code = src;
+		}
+	}
+};
+/**
+* Tamagui-specific resolver aliases for consumers whose @tamagui/*
+* packages resolve by bare name (string finds keep @rollup/plugin-alias
+* prefix semantics). Funnels `@tamagui/core` / `@tamagui/web` both into
+* the single `@tamagui/core/native` module so the TamaguiProvider's
+* config registry and high-level component lookups land in one place.
+*/
+function tamaguiAliases(options) {
+	return [
+		...options.lucideIcons ? [{
+			find: "@tamagui/lucide-icons-2",
+			replacement: options.lucideIcons
+		}] : [],
+		{
+			find: "@tamagui/core",
+			replacement: "@tamagui/core/native"
+		},
+		{
+			find: "@tamagui/web",
+			replacement: "@tamagui/core/native"
+		},
+		{
+			find: "tamagui",
+			replacement: options.tamaguiBarrel
+		}
+	];
+}
+/**
+* Same aliases with exact-match regexes — for consumers whose alias
+* list mixes in absolute-path replacements (e.g. apps pulling
+* @react-gnome in over pnpm `link:`), where a plain string prefix
+* alias could re-mangle other entries' replacements.
+*/
+function tamaguiLinkedAliases(options) {
+	return [
+		...options.lucideIcons ? [{
+			find: /^@tamagui\/lucide-icons-2$/,
+			replacement: options.lucideIcons
+		}] : [],
+		{
+			find: /^@tamagui\/core$/,
+			replacement: "@tamagui/core/native"
+		},
+		{
+			find: /^@tamagui\/web$/,
+			replacement: "@tamagui/core/native"
+		},
+		{
+			find: /^tamagui$/,
+			replacement: options.tamaguiBarrel
+		}
+	];
+}
+
+//#endregion
+export { tamaguiAliases, tamaguiLinkedAliases, tamaguiPatchAnchors, tamaguiPlugin };

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@multiplatform.one/vite-plugin-gnome",
+  "version": "6.2.0",
+  "description": "Vite plugin that makes Tamagui render under react-gnome (GTK4/GJS) — bundle patches for @tamagui/core's native lazy-init chains, the sheet/portal native builds, the hover/animation gates, plus the Tamagui-specific resolver aliases. Pairs with @react-gnome/vite-plugin (generic GJS aliases/conditions/define).",
+  "keywords": [
+    "gjs",
+    "gnome",
+    "gtk4",
+    "multiplatform.one",
+    "react-gnome",
+    "tamagui",
+    "vite-plugin"
+  ],
+  "homepage": "https://multiplatform.one",
+  "bugs": {
+    "url": "https://gitlab.com/bitspur/multiplatform.one/multiplatform.one/issues",
+    "email": "support@risserlabs.com"
+  },
+  "license": "Apache-2.0",
+  "author": "BitSpur <support@risserlabs.com> (https://risserlabs.com)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/bitspur/frappe/multiplatform.one.git",
+    "directory": "public/vite-plugin-gnome"
+  },
+  "source": "src/index.ts",
+  "files": [
+    "lib",
+    "types",
+    "src",
+    "!types/.tsbuildinfo"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "lib/index.cjs",
+  "module": "lib/index.mjs",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./types/index.d.ts",
+      "import": "./lib/index.mjs",
+      "require": "./lib/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@tamagui/core": "2.0.0-rc.41",
+    "@tamagui/portal": "2.0.0-rc.41",
+    "@tamagui/sheet": "2.0.0-rc.41",
+    "@types/node": "^25.6.0",
+    "typescript": "~5.9.3",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.5"
+  },
+  "peerDependencies": {
+    "vite": ">=5"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf lib types 2>/dev/null && tsc -b --emitDeclarationOnly && tsdown",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,440 @@
+// Tamagui-under-react-gnome patch set for the GNOME (GTK4/GJS) target.
+//
+// Real Tamagui (`@tamagui/core/native`) assumes a react-native-web-lite
+// runtime: Platform / StyleSheet / NativeAnimatedHelper / forwardedProps
+// initialized in a specific order under a real React Native env. Under
+// GJS none of that holds, so the upstream packages fail at module init
+// or first render. Rather than reimplement Tamagui's components we
+// patch the bundler's view of them.
+//
+// Exported pieces:
+//   - tamaguiPlugin: per-source `transform` (no-op stub fix, Platform
+//     and StyleSheet shims) + post-bundle `generateBundle` (resolves
+//     the duplicate-`init_esm$1` collision between Tamagui's vendored
+//     RN-Web-Lite init chain and real RN's index init chain).
+//   - tamaguiAliases(options) / tamaguiLinkedAliases(options): the
+//     Tamagui-specific resolver aliases — funnel `@tamagui/core` /
+//     `@tamagui/web` into the single `@tamagui/core/native` module and
+//     map the `tamagui` meta-package onto a consumer-provided lean
+//     barrel. The generic react-gnome aliases (react-native →
+//     @react-gnome/react-native, conditions, define, …) live in
+//     @react-gnome/vite-plugin and compose with these.
+//   - tamaguiPatchAnchors: every regex the transform/generateBundle
+//     anchors on, exported so the package's anchor-verification test
+//     fails LOUDLY when a Tamagui version bump reshapes the dist files
+//     and a patch would silently stop firing.
+//
+// IMPORTANT version note: every anchor below is verified against the
+// pinned @tamagui/* devDependencies by tests/anchors.test.ts. If
+// Tamagui is bumped, that test is the tripwire — a patch whose anchor
+// no longer matches no-ops silently in the build and only manifests as
+// runtime breakage under GJS.
+
+import type { Plugin } from "vite";
+
+/** One Vite `resolve.alias` entry (the array form Vite accepts). */
+export interface TamaguiAliasEntry {
+  find: string | RegExp;
+  replacement: string;
+}
+
+/**
+ * A source pattern one of the bundle patches anchors on. `find` must
+ * keep matching the dist files of `module` for the patch to fire;
+ * `replace` is the rewrite (absent for the bundle-level dedupe
+ * signature, whose rewrite is procedural).
+ */
+export interface TamaguiPatchAnchor {
+  name: string;
+  module: "@tamagui/core" | "@tamagui/sheet" | "@tamagui/portal";
+  /** transform only runs on files containing this substring */
+  precondition: string;
+  find: RegExp;
+  replace?: string;
+}
+
+interface TamaguiPatch extends TamaguiPatchAnchor {
+  replace: string;
+}
+
+// @tamagui/sheet: rewrite the AnimatedView's `position: 'absolute'`
+// to `position: 'relative'`. Yoga treats abs-positioned children as
+// out-of-flow → parent reports 0 height → GTK's allocation-based
+// hit-test can't reach the Cancel/Submit buttons even though
+// they paint at non-zero positions. Relative lets the sheet flow
+// in-place with real height; visually it sits at the bottom of
+// the parent stack (where un-animated translateY would leave it
+// anyway), and the drag/animation logic still runs at the JS
+// layer above. Anchored on the AnimatedView style block's
+// distinctive shape (zIndex + width + forcedContentHeight) so
+// we don't touch other position:absolute usage.
+const sheetPatch: TamaguiPatch = {
+  name: "sheet-animated-view-relative-position",
+  module: "@tamagui/sheet",
+  precondition: "forcedContentHeight",
+  find: /(style:\s*\[\s*\{\s*\n?\s*)position:\s*['"]absolute['"](,\s*\n?\s*zIndex,\s*\n?\s*width:\s*['"]100%['"],\s*\n?\s*height:\s*forcedContentHeight)/g,
+  replace: '$1position: "relative"$2',
+};
+
+// @tamagui/portal: make `needsPortalRepropagation()` return true on GNOME.
+// Tamagui's native portal is the Gorhom state-based portal, which lifts
+// children into PortalProvider's React subtree — so portaled content (e.g.
+// Popover.Content) loses every ancestor context, including Popper's scoped
+// `refs` context. Tamagui restores it via RepropagateParentContexts ONLY
+// when needsPortalRepropagation() is true, but the gate reads
+// `return isAndroid || isIos` — react-gnome's Platform.OS is "gnome", so it
+// returns false and the portaled Popover.Content reads an empty Popper
+// context → `refs` undefined → hard render crash. After the isWeb +
+// isTeleportEnabled checks above it, the remaining case is "native,
+// non-teleport" which ALWAYS loses context with the Gorhom portal, so the
+// correct answer is unconditional true (ios/android already returned true).
+const portalPatch: TamaguiPatch = {
+  name: "portal-needs-repropagation-on-gnome",
+  module: "@tamagui/portal",
+  precondition: "needsPortalRepropagation",
+  find: /return isAndroid \|\| isIos;/,
+  replace: "return true; /* react-gnome: Gorhom portal loses context on every native platform */",
+};
+
+// Every @tamagui/core (and @tamagui/web, which consumers alias into
+// core/native) patch is gated on this marker — it only exists in the
+// native build where the broken no-op stubs live.
+const corePrecondition = 'console.warn("no-op native")';
+
+const corePatches: TamaguiPatch[] = [
+  // The native build stubs several helpers as warn-only no-ops; the
+  // first caller is Object.entries-shaped, so give it that behavior.
+  {
+    name: "core-noop-native-stub",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /function\s*\(\s*\)\s*\{\s*console\.warn\("no-op native"\);?\s*\}/g,
+    replace:
+      "function(input) { return input && typeof input === 'object' ? Object.entries(input) : []; }",
+  },
+  // getSplitStyles' passDownProp (the HOC pass-down path, e.g. TextArea =
+  // styled(Input)) assigns `viewProps[key] = val` — which KEEPS the key's
+  // ORIGINAL insertion position when the key was already passed down once.
+  // TextArea's `unstyled:false` default variant expands `height:"auto"`
+  // BEFORE the user's props are reached, pinning `height` ahead of `size`
+  // in the pass-down object; the inner Input pass then merges in iteration
+  // order at equal importance, so the `size` variant's computed height
+  // (rows × lineHeight, e.g. 69) overrides an EXPLICIT `height={180}` that
+  // came later in source order (web resolves the same control to 180).
+  // Delete-then-assign moves a re-passed prop to the END, mirroring
+  // source-prop order — the same move-to-end the media/pseudo branch of
+  // passDownProp already does.
+  {
+    name: "core-pass-down-prop-reorder",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /\} else viewProps\[key\] = val;/,
+    replace: "} else { delete viewProps[key]; viewProps[key] = val; }",
+  },
+  // Tamagui's vendored react-native-web exports `TextAncestorContext`
+  // (no unstable_ prefix). Tamagui's own getBaseViews reads it as
+  // `native.unstable_TextAncestorContext` → undefined → optimized
+  // native view path skipped → fallback emits `<div>` everywhere.
+  // Patch the read to use the unprefixed name.
+  {
+    name: "core-text-ancestor-context",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /native\.unstable_TextAncestorContext/g,
+    replace: "(native.unstable_TextAncestorContext || native.TextAncestorContext)",
+  },
+  // @tamagui/core/native.cjs bakes in two copies of Platform from
+  // its vendored react-native-web-internals: `Platform` (initialized
+  // by `init_Platform` — which only calls init_esm$1() and DOESN'T
+  // assign the global) and `Platform$1` (initialized by
+  // `init_Platform$1` which DOES assign Platform = { OS: "web", ...
+  // }). When NativeAnimatedHelper inits, it calls init_Platform()
+  // and then reads Platform.OS → undefined → throws. Patch the
+  // broken init_Platform so it also calls init_Platform$1().
+  {
+    name: "core-init-platform-chain",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /var\s+init_Platform\s*=\s*__esmMin\(\(\(\)\s*=>\s*\{\s*init_esm\$1\(\);\s*\}\)\);/,
+    replace: "var init_Platform = __esmMin((() => { init_esm$1(); init_Platform$1(); }));",
+  },
+  // The vendored RN-Web bundle declares StyleSheet as a bare function
+  // and only attaches `.create / .compose / .flatten / ...` inside its
+  // `init_StyleSheet` __esmMin. Tamagui's `init_VirtualizedList*` chain
+  // calls StyleSheet.create at module-init time before init_StyleSheet
+  // is reachable through the (now-conflated) init_esm$1 — because two
+  // init_esm$1 functions land in the same JS scope and the second one
+  // wins, so the StyleSheet init never fires. Attach the minimum
+  // shims directly on the declaration so the create-call works
+  // regardless of init order.
+  {
+    name: "core-stylesheet-declaration-shims",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /function StyleSheet\(styles, options\) \{\}/g,
+    replace:
+      "function StyleSheet(styles, options) {} " +
+      "StyleSheet.create = (s) => s; " +
+      "StyleSheet.compose = (a, b) => [a, b]; " +
+      "StyleSheet.flatten = (s) => Array.isArray(s) ? Object.assign({}, ...s.filter(Boolean)) : (s || {}); " +
+      "StyleSheet.hairlineWidth = 1; " +
+      "StyleSheet.absoluteFill = { position: 'absolute', left: 0, right: 0, top: 0, bottom: 0 }; " +
+      "StyleSheet.absoluteFillObject = StyleSheet.absoluteFill;",
+  },
+  // Tamagui v2's animation gate at @tamagui/core/native:hasAnimationProp
+  // only fires when EITHER a compile-time `transition` prop is emitted
+  // OR a style value carries an `_animation` sentinel. The runtime
+  // `animation="bouncy"` prop is ignored entirely — that translation
+  // lives in `@tamagui/babel-plugin` (Metro) / `@tamagui/vite-plugin`
+  // (Vite/web), neither of which targets our GJS env. Open the gate at
+  // the source: rewrite the assignment so it ALSO fires whenever
+  // `"animation" in props`. With that, useAnimations gets invoked with
+  // each prop change and the @react-gnome/tamagui driver's per-key
+  // AnimatedValue / forceUpdate loop drives the component layer.
+  {
+    name: "core-runtime-animation-prop-gate",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /var hasAnimationProp = Boolean\(!isHOC && "transition" in props \|\| props\.style && hasAnimatedStyleValue\(props\.style\)\);/,
+    replace:
+      'var hasAnimationProp = Boolean(!isHOC && ("transition" in props || "animation" in props) || props.style && hasAnimatedStyleValue(props.style));',
+  },
+  // The NATIVE build hard-codes `attachHover = false` (touch platforms have
+  // no hover), so the events object never includes the onMouseEnter/
+  // onMouseLeave handlers that drive the hoverStyle state machine and call
+  // user onHoverIn/onHoverOut. GNOME is a pointer desktop — compute it the
+  // way the WEB build does (hover style present, or any hover/mouse handler
+  // passed). `needsHoverState` is declared on the preceding line of the
+  // same function, and the emitted onMouseEnter/onMouseLeave land on the
+  // host element where the renderer's maybeWireHoverHandler maps them to a
+  // Gtk.EventControllerMotion.
+  {
+    name: "core-attach-hover-on-desktop",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /var attachHover = false;/g,
+    replace:
+      "var attachHover = Boolean(needsHoverState || onHoverIn || onHoverOut || onMouseEnter || onMouseLeave);",
+  },
+  // …and useEvents (native) forwards ONLY focus/blur + the press family to
+  // the host — the hover handlers above would dead-end there. Forward them
+  // the same way focus/blur go through; the renderer's maybeWireHoverHandler
+  // turns them into a Gtk.EventControllerMotion on the widget.
+  {
+    name: "core-forward-hover-handlers",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /if \(events\.onBlur\) viewProps\["onBlur"\] = events\.onBlur;/,
+    replace:
+      'if (events.onBlur) viewProps["onBlur"] = events.onBlur;' +
+      ' if (events.onMouseEnter) viewProps["onMouseEnter"] = events.onMouseEnter;' +
+      ' if (events.onMouseLeave) viewProps["onMouseLeave"] = events.onMouseLeave;',
+  },
+  // Tamagui's vendored useDidFinishSSR (multiple copies across the
+  // bundle from the meta-package + nested @tamagui/* deps) calls
+  // `react.useContext(ClientOnlyContext)` and then returns true
+  // unconditionally. The useContext is a leftover from a code path
+  // that branched on the value, but the lazy init pattern leaves
+  // ClientOnlyContext declared-but-undefined when an early caller
+  // (any styled component during initial render) hits it before
+  // init_ClientOnly_native runs. The useContext throws "Context is
+  // undefined". Since the return value is hard-coded `true`, the
+  // useContext call has no behavioral purpose — strip it.
+  {
+    name: "core-use-did-finish-ssr",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /function useDidFinishSSR\(\)\s*\{\s*react\.useContext\(ClientOnlyContext\);\s*return true;\s*\}/g,
+    replace: "function useDidFinishSSR() { return true; }",
+  },
+  // Same family — useIsClientOnly is `var`-declared and only
+  // assigned inside an __esmMin init. Stub it at declaration so
+  // callers hitting it before init runs get a real function.
+  {
+    name: "core-use-is-client-only",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /var useIsClientOnly;\s*var (init_index_native\$\d+)/g,
+    replace: "var useIsClientOnly = () => false; var $1",
+  },
+  // useIsomorphicInsertionEffect: same lazy-init bug. Pre-assign at
+  // declaration time. `react` is already in scope by the time any
+  // module body runs since the runtime imports it eagerly at the
+  // bundle top.
+  {
+    name: "core-use-isomorphic-insertion-effect",
+    module: "@tamagui/core",
+    precondition: corePrecondition,
+    find: /var useIsomorphicInsertionEffect;/g,
+    replace:
+      "var useIsomorphicInsertionEffect = (react.useInsertionEffect || react.useLayoutEffect);",
+  },
+];
+
+// generateBundle's entry anchor: the first `var init_esm$1 = __esmMin`
+// declaration whose body starts with init_AssetRegistry() — the
+// distinctive signature of Tamagui's vendored RN-Web-Lite index init
+// (vs real RN's index init). The rewrite is procedural (rename + caller
+// re-pointing below), so this anchor carries no `replace`.
+const initEsmVendorSignature: TamaguiPatchAnchor = {
+  name: "core-init-esm-vendor-signature",
+  module: "@tamagui/core",
+  precondition: "init_AssetRegistry();",
+  find: /var\s+init_esm\$1\s*=\s*__esmMin\(\(\(\)\s*=>\s*\{\s*init_AssetRegistry\(\);/,
+};
+
+/**
+ * Every source pattern the patch set anchors on, in apply order. The
+ * package's anchor-verification test asserts each one still matches
+ * the pinned @tamagui/* dist files — the loud-failure guard for
+ * Tamagui version bumps.
+ */
+export const tamaguiPatchAnchors: readonly TamaguiPatchAnchor[] = [
+  sheetPatch,
+  portalPatch,
+  ...corePatches,
+  initEsmVendorSignature,
+];
+
+export const tamaguiPlugin: Plugin = {
+  name: "rgn-tamagui-noop-fix",
+  enforce: "post",
+  transform(code, id) {
+    if (id.includes(sheetPatch.module) && code.includes(sheetPatch.precondition)) {
+      const out = code.replace(sheetPatch.find, sheetPatch.replace);
+      if (out !== code) return out;
+    }
+    if (id.includes(portalPatch.module) && code.includes(portalPatch.precondition)) {
+      const out = code.replace(portalPatch.find, portalPatch.replace);
+      if (out !== code) return out;
+    }
+    if (!id.includes("@tamagui/core") && !id.includes("@tamagui/web")) return;
+    if (!code.includes(corePrecondition)) return;
+    let out = code;
+    for (const patch of corePatches) {
+      out = out.replace(patch.find, patch.replace);
+    }
+    return out;
+  },
+  // The final bundle ends up with TWO `var init_esm$1 = __esmMin(...)`
+  // declarations in the SAME scope — one from tamagui's vendored
+  // react-native-web-lite index (runs init_StyleSheet, init_TextInput,
+  // init_forwardedProps, etc.) and one from real RN's index.js (runs
+  // init_Animated, init_NativeModules, etc.). They come from
+  // different source files so a per-file transform can't see both;
+  // the conflict only manifests in the bundled output. Rewrite the
+  // bundle here in generateBundle so both inits actually fire.
+  generateBundle(_opts, bundle) {
+    for (const fileName of Object.keys(bundle)) {
+      const c = bundle[fileName];
+      if (c.type !== "chunk") continue;
+      let src = c.code;
+      // Find the first `var init_esm$1 = __esmMin` declaration. The
+      // RN-Web vendor's chain starts with init_AssetRegistry +
+      // init_forwardedProps (distinctive signature). Match that to be
+      // sure we're renaming the vendor one, not the real-RN one.
+      const m = src.match(initEsmVendorSignature.find);
+      if (!m || m.index === undefined) continue;
+      const firstDeclIdx = m.index;
+      // Bracket-balance scan from the lambda body's opening `{` to
+      // find the matching `}));`.
+      const bodyStart = src.indexOf("{", firstDeclIdx + "var init_esm$1 = __esmMin((()".length);
+      let depth = 1;
+      let i = bodyStart + 1;
+      for (; i < src.length && depth > 0; i++) {
+        if (src[i] === "{") depth++;
+        else if (src[i] === "}") depth--;
+      }
+      const firstEnd = src.indexOf("));", i) + 3;
+      const renamed = src
+        .slice(firstDeclIdx, firstEnd)
+        .replace("var init_esm$1 = __esmMin", "var init_esm$1_vendor = __esmMin");
+      const secondDeclStart = src.indexOf("var init_esm$1 = __esmMin", firstEnd);
+      if (secondDeclStart < 0) continue;
+      // Rewrite every `init_esm$1()` call between firstEnd and
+      // secondDeclStart to call the renamed vendor init.
+      const between = src
+        .slice(firstEnd, secondDeclStart)
+        .replace(/init_esm\$1\(\)/g, "init_esm$1_vendor()");
+      // Inside the second decl's body, the first `init_esm$1();` call
+      // was meant to recurse into the vendor — point it at the rename.
+      const sBody = src.indexOf("{", secondDeclStart + "var init_esm$1 = __esmMin((()".length);
+      let d2 = 1;
+      let j = sBody + 1;
+      for (; j < src.length && d2 > 0; j++) {
+        if (src[j] === "{") d2++;
+        else if (src[j] === "}") d2--;
+      }
+      const secondDeclEnd = src.indexOf("));", j) + 3;
+      const secondPatched = src
+        .slice(secondDeclStart, secondDeclEnd)
+        .replace("init_esm$1();", "init_esm$1_vendor();");
+      src =
+        src.slice(0, firstDeclIdx) + renamed + between + secondPatched + src.slice(secondDeclEnd);
+      c.code = src;
+    }
+  },
+};
+
+/** Consumer-provided targets for the Tamagui-specific aliases. */
+export interface TamaguiAliasOptions {
+  /**
+   * Absolute path to the consumer's lean `tamagui` meta-package barrel
+   * — a module re-exporting only the granular @tamagui/* packages its
+   * graph needs. The full meta-barrel drags web-only components (and
+   * real-RN Flow sources the bundler can't parse) into the GJS bundle.
+   */
+  tamaguiBarrel: string;
+  /**
+   * Optional absolute path to a lean `@tamagui/lucide-icons-2` shim
+   * re-exporting only the used icons from per-icon deep paths (the
+   * full barrel pulls ~1500 icons → ~6MB → overflows the GJS parser).
+   * The shim's deep-path icons resolve onward to react-native-svg →
+   * the @react-gnome GTK SVG impl.
+   */
+  lucideIcons?: string;
+}
+
+// NOTE deliberately NO alias for @tamagui/tooltip: its NATIVE build is an
+// intentional null stub (touch platforms have no hover — Content renders
+// nothing, TooltipGroup renders nothing). We match React Native exactly
+// rather than pulling the WEB build into this native runtime (tried: it
+// works visually but drags DOM assumptions — document-level dismiss
+// listeners on a stubbed documentElement — into the bundle). A future
+// GNOME-native tooltip belongs in a shim built on the hover controllers +
+// GnomeFloatingProvider, not on borrowed web code.
+
+/**
+ * Tamagui-specific resolver aliases for consumers whose @tamagui/*
+ * packages resolve by bare name (string finds keep @rollup/plugin-alias
+ * prefix semantics). Funnels `@tamagui/core` / `@tamagui/web` both into
+ * the single `@tamagui/core/native` module so the TamaguiProvider's
+ * config registry and high-level component lookups land in one place.
+ */
+export function tamaguiAliases(options: TamaguiAliasOptions): TamaguiAliasEntry[] {
+  return [
+    ...(options.lucideIcons
+      ? [{ find: "@tamagui/lucide-icons-2", replacement: options.lucideIcons }]
+      : []),
+    { find: "@tamagui/core", replacement: "@tamagui/core/native" },
+    { find: "@tamagui/web", replacement: "@tamagui/core/native" },
+    { find: "tamagui", replacement: options.tamaguiBarrel },
+  ];
+}
+
+/**
+ * Same aliases with exact-match regexes — for consumers whose alias
+ * list mixes in absolute-path replacements (e.g. apps pulling
+ * @react-gnome in over pnpm `link:`), where a plain string prefix
+ * alias could re-mangle other entries' replacements.
+ */
+export function tamaguiLinkedAliases(options: TamaguiAliasOptions): TamaguiAliasEntry[] {
+  return [
+    ...(options.lucideIcons
+      ? [{ find: /^@tamagui\/lucide-icons-2$/, replacement: options.lucideIcons }]
+      : []),
+    { find: /^@tamagui\/core$/, replacement: "@tamagui/core/native" },
+    { find: /^@tamagui\/web$/, replacement: "@tamagui/core/native" },
+    { find: /^tamagui$/, replacement: options.tamaguiBarrel },
+  ];
+}

package/types/index.d.ts

@@ -0,0 +1,62 @@
+import type { Plugin } from "vite";
+/** One Vite `resolve.alias` entry (the array form Vite accepts). */
+export interface TamaguiAliasEntry {
+    find: string | RegExp;
+    replacement: string;
+}
+/**
+ * A source pattern one of the bundle patches anchors on. `find` must
+ * keep matching the dist files of `module` for the patch to fire;
+ * `replace` is the rewrite (absent for the bundle-level dedupe
+ * signature, whose rewrite is procedural).
+ */
+export interface TamaguiPatchAnchor {
+    name: string;
+    module: "@tamagui/core" | "@tamagui/sheet" | "@tamagui/portal";
+    /** transform only runs on files containing this substring */
+    precondition: string;
+    find: RegExp;
+    replace?: string;
+}
+/**
+ * Every source pattern the patch set anchors on, in apply order. The
+ * package's anchor-verification test asserts each one still matches
+ * the pinned @tamagui/* dist files — the loud-failure guard for
+ * Tamagui version bumps.
+ */
+export declare const tamaguiPatchAnchors: readonly TamaguiPatchAnchor[];
+export declare const tamaguiPlugin: Plugin;
+/** Consumer-provided targets for the Tamagui-specific aliases. */
+export interface TamaguiAliasOptions {
+    /**
+     * Absolute path to the consumer's lean `tamagui` meta-package barrel
+     * — a module re-exporting only the granular @tamagui/* packages its
+     * graph needs. The full meta-barrel drags web-only components (and
+     * real-RN Flow sources the bundler can't parse) into the GJS bundle.
+     */
+    tamaguiBarrel: string;
+    /**
+     * Optional absolute path to a lean `@tamagui/lucide-icons-2` shim
+     * re-exporting only the used icons from per-icon deep paths (the
+     * full barrel pulls ~1500 icons → ~6MB → overflows the GJS parser).
+     * The shim's deep-path icons resolve onward to react-native-svg →
+     * the @react-gnome GTK SVG impl.
+     */
+    lucideIcons?: string;
+}
+/**
+ * Tamagui-specific resolver aliases for consumers whose @tamagui/*
+ * packages resolve by bare name (string finds keep @rollup/plugin-alias
+ * prefix semantics). Funnels `@tamagui/core` / `@tamagui/web` both into
+ * the single `@tamagui/core/native` module so the TamaguiProvider's
+ * config registry and high-level component lookups land in one place.
+ */
+export declare function tamaguiAliases(options: TamaguiAliasOptions): TamaguiAliasEntry[];
+/**
+ * Same aliases with exact-match regexes — for consumers whose alias
+ * list mixes in absolute-path replacements (e.g. apps pulling
+ * @react-gnome in over pnpm `link:`), where a plain string prefix
+ * alias could re-mangle other entries' replacements.
+ */
+export declare function tamaguiLinkedAliases(options: TamaguiAliasOptions): TamaguiAliasEntry[];
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,oEAAoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;IAC/D,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAwOD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,kBAAkB,EAK5D,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MA8E3B,CAAC;AAEF,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,EAAE,CAShF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,EAAE,CAStF"}