@multiplatform.one/config 7.6.3 → 7.7.0

package/lib/index.js

@@ -1,4 +1,4 @@
-import { t as createViteConfig } from "./vite-W9hIeg2_.js";
+import { t as createViteConfig } from "./vite-Rv5b8Wxp.js";
 import { t as createStorybookViteConfig } from "./storybook-BnfZmzIL.js";
 import { n as tamaguiWorkspacePathsFile, t as ensureTamaguiWorkspacePaths } from "./tamaguiWorkspacePaths-ZIcqybtn.js";
 import { createVitestConfig } from "./vitest.js";

package/lib/{vite-W9hIeg2_.js → vite-Rv5b8Wxp.js}

@@ -92,6 +92,7 @@ function createViteConfig(options = {}) {
 		vitePlugins.push(ssrReactNativeAliasPlugin());
 		vitePlugins.push(clientBrokenEsmPlugin());
 		registerNativeEngineIoBrowserTransports();
+		registerNativeSinglePackageInstances();
 		registerNativeWorkspaceEntries();
 		registerNativePhosphorIcons();
 		if (nativeFixes?.protoShadow !== false) registerNativeProtoShadowFix();
@@ -276,6 +277,107 @@ function clientBrokenEsmPlugin() {
 * This re-asserts the browser redirect with no node_modules patch. Web is
 * unaffected (engine.io is SSR-externalized and the web client already maps `browser`).
 */
+/**
+* Collapse duplicate PHYSICAL copies of the same package@version to one path
+* in the NATIVE graph, so React (and every other stateful singleton) exists
+* exactly once in the Hermes bundle.
+*
+* The workspace's node_modules is a MIXED install. `.npmrc` says
+* `node-linker=hoisted`, so the root `node_modules/<pkg>` entries are real
+* directories; but an earlier isolated install left a `node_modules/.pnpm`
+* virtual store plus per-package symlink farms behind — e.g. each package's
+* own `node_modules/react` still points at
+* `../../../node_modules/.pnpm/react@19.2.5/node_modules/react`.
+* Both trees are fully populated with byte-identical copies, and which one an
+* importer reaches depends only on where that importer sits on disk:
+*
+*   apps/one/app      -> node_modules/.pnpm/react@19.2.5/node_modules/react
+*   public/forms/src  -> node_modules/react            (no local symlink)
+*
+* Rolldown resolves symlinks, so the two land as two DIFFERENT absolute paths
+* and it bundles both. React 19's `useContext` is
+* `ReactSharedInternals.H.useContext(Context)` — `H` is the dispatcher the
+* renderer installs during render, and it is only ever set on the copy the
+* renderer imported. A component from the other copy therefore reads `H` as
+* null and the app dies with "Cannot read property 'useContext' of null".
+* That is the whole bug; the same split had also duplicated react-native (427
+* modules each), @tamagui/web, @react-navigation/core, one, scheduler and 58
+* more packages.
+*
+* The rule: an id that resolves inside the virtual store is rewritten to the
+* hoisted root copy when the root copy exists, carries the SAME version, and
+* actually has the file. Version equality is the safety guard — genuine
+* multi-version installs (two @babel/runtime, two viem) keep both copies.
+*
+* On a correctly installed tree this is a no-op by construction: `hoisted`
+* leaves no `.pnpm` store to match, and `isolated` makes the root entry a
+* symlink INTO the store, which realpaths back to the same directory (checked
+* explicitly). It only fires on the mixed tree, and it is cheap because only
+* BARE specifiers are inspected — once a package's entry is canonical, its own
+* relative imports resolve inside the canonical copy for free.
+*/
+function registerNativeSinglePackageInstances() {
+	const g = globalThis;
+	const name = "vxrn-single-package-instances";
+	g.__vxrnAddNativePlugins = g.__vxrnAddNativePlugins ?? [];
+	if (g.__vxrnAddNativePlugins.some((p) => p?.name === name)) return;
+	const rootModules = path.join(findProjectRoot(), "node_modules");
+	const storePath = /[\\/]node_modules[\\/]\.pnpm[\\/][^\\/]+[\\/]node_modules[\\/]((?:@[^\\/]+[\\/])?[^\\/]+)(?:[\\/](.*))?$/;
+	function versionOf(dir) {
+		try {
+			const raw = fs.readFileSync(path.join(dir, "package.json"), "utf8");
+			return JSON.parse(raw).version ?? null;
+		} catch {
+			return null;
+		}
+	}
+	const hoisted = /* @__PURE__ */ new Map();
+	function hoistedTwin(pkg, storeDir) {
+		if (!hoisted.has(pkg)) {
+			const rootDir = path.join(rootModules, pkg);
+			let twin = null;
+			if (fs.existsSync(rootDir)) {
+				const rootVersion = versionOf(rootDir);
+				const storeVersion = versionOf(storeDir);
+				if (rootVersion && rootVersion === storeVersion) try {
+					if (fs.realpathSync(rootDir) !== fs.realpathSync(storeDir)) twin = rootDir;
+				} catch {
+					twin = null;
+				}
+			}
+			hoisted.set(pkg, twin);
+		}
+		return hoisted.get(pkg) ?? null;
+	}
+	const seen = /* @__PURE__ */ new Map();
+	g.__vxrnAddNativePlugins.push({
+		name,
+		async resolveId(id, importer) {
+			if (!id || id.startsWith(".") || id.startsWith("/") || id.startsWith("\0")) return null;
+			const key = `${id} ${importer ?? ""}`;
+			const cached = seen.get(key);
+			if (cached !== void 0) return cached;
+			let out = null;
+			try {
+				const resolved = await this.resolve(id, importer, { skipSelf: true });
+				const match = resolved?.external ? null : resolved?.id?.match(storePath);
+				if (resolved && match) {
+					const pkg = match[1].split(path.sep).join("/");
+					const rest = match[2] ?? "";
+					const twin = hoistedTwin(pkg, resolved.id.slice(0, resolved.id.length - (rest ? rest.length + 1 : 0)));
+					if (twin) {
+						const candidate = rest ? path.join(twin, rest) : twin;
+						if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) out = candidate;
+					}
+				}
+			} catch {
+				out = null;
+			}
+			seen.set(key, out);
+			return out;
+		}
+	});
+}
 function registerNativeEngineIoBrowserTransports() {
 	const g = globalThis;
 	const name = "vxrn-engineio-browser-transports";
@@ -322,7 +424,12 @@ function registerNativeWorkspaceEntries() {
 			const root = roots.get(id);
 			if (root) {
 				const nativeEntry = path.join(root, "dist/esm/index.native.js");
-				return fs.existsSync(nativeEntry) ? nativeEntry : null;
+				if (fs.existsSync(nativeEntry)) return nativeEntry;
+				const srcTs = path.join(root, "src/index.ts");
+				if (fs.existsSync(srcTs)) return srcTs;
+				const srcTsx = path.join(root, "src/index.tsx");
+				if (fs.existsSync(srcTsx)) return srcTsx;
+				return null;
 			}
 			if (id.endsWith("/dist/esm/index.mjs")) {
 				const nativeEntry = `${id.slice(0, -4)}.native.js`;

package/lib/vite.js

@@ -1,4 +1,4 @@
-import { t as createViteConfig } from "./vite-W9hIeg2_.js";
+import { t as createViteConfig } from "./vite-Rv5b8Wxp.js";
 import { n as publicPackageViteSourceAliases, t as discoverPublicPackageRoots } from "./workspacePublicPackages-COicQSj4.js";
 
 export { createViteConfig, discoverPublicPackageRoots, publicPackageViteSourceAliases };

package/lint.mjs

@@ -778,6 +778,65 @@ function checkUndeclaredDrawings() {
   return { violations, ok: true };
 }
 
+/**
+ * MPO-109 WORKSPACE PATHS SHADOW — `compilerOptions.paths` REPLACES the
+ * inherited map, it never merges with it. `tsconfig.base.json` extends the
+ * generated `tamagui-workspace-paths.generated.json`, so one local entry in a
+ * package tsconfig hides every `@multiplatform.one/*` mapping from that
+ * program and the whole package fails to resolve its own workspace. That is
+ * where apps/one's 578 typecheck errors came from, and features, apps/storybook,
+ * apps/storybook-expo, apps/uxpin and public/keycloak each carried the same
+ * override.
+ *
+ * The fix for a deep-import alias is the package's own `exports` map, which the
+ * generator reads. Escape (rare, for a program that deliberately does not
+ * extend the base): `// workspace-paths-escape:` with a reason on the line
+ * above `"paths"`.
+ */
+function checkTsconfigWorkspacePaths() {
+  /** @type {string[]} */
+  const violations = [];
+  /** @type {string[]} */
+  const files = [];
+  const featuresTsconfig = join(FEATURES_DIR, "tsconfig.json");
+  if (existsSync(featuresTsconfig)) files.push(featuresTsconfig);
+  for (const dir of [APPS_DIR, PACKAGES_DIR, PUBLIC_DIR]) {
+    if (!existsSync(dir)) continue;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const candidate = join(dir, entry.name, "tsconfig.json");
+      if (existsSync(candidate)) files.push(candidate);
+    }
+  }
+  for (const file of files) {
+    const src = readFileSync(file, "utf8");
+    // Whole-line comments only: a `//` inside a string (the $schema URL) must
+    // survive, and these files are JSONC, not JSON5.
+    const stripped = src.replace(/^[ \t]*\/\/.*$/gm, "");
+    let doc;
+    try {
+      doc = JSON.parse(stripped);
+    } catch {
+      continue;
+    }
+    const paths = doc?.compilerOptions?.paths;
+    if (!paths || typeof paths !== "object") continue;
+    const extendsField = doc.extends;
+    const extendsBase = Array.isArray(extendsField)
+      ? extendsField.some((e) => typeof e === "string" && e.includes("tsconfig.base"))
+      : typeof extendsField === "string" && extendsField.includes("tsconfig.base");
+    if (!extendsBase) continue;
+    const decl = src.match(/^[ \t]*"paths"\s*:/m);
+    const index = decl?.index ?? 0;
+    const before = src.slice(0, index);
+    if (/workspace-paths-escape:/.test(before.split("\n").slice(-3).join("\n"))) continue;
+    violations.push(
+      `${relative(ROOT, file)}:${lineAt(src, index)} — declares \`compilerOptions.paths\` (${Object.keys(paths).join(", ")}) while extending tsconfig.base`,
+    );
+  }
+  return violations;
+}
+
 /**
  * Run structural convention checks over a consumer tree.
  *
@@ -791,6 +850,7 @@ export function runConventionChecks(options = {}) {
   const sizeRecipeEscape = checkSizeRecipeEscape();
   const storyShape = checkStoryFileShape();
   const undeclaredDrawings = checkUndeclaredDrawings();
+  const tsconfigPaths = checkTsconfigWorkspacePaths();
   const tokens = checkTransitionTokens();
   const styleTokens = checkStyleTokens();
   const themeNames = checkThemeNames();
@@ -857,6 +917,15 @@ export function runConventionChecks(options = {}) {
     console.error("");
   }
 
+  if (tsconfigPaths.length) {
+    failed = true;
+    console.error(
+      "Convention (MPO-109 WORKSPACE PATHS SHADOW): `compilerOptions.paths` REPLACES the map tsconfig.base.json inherits from tamagui-workspace-paths.generated.json, so one local entry hides every `@multiplatform.one/*` mapping from that program. Declare the alias in the target package's `exports` (the generator reads it) instead. Escape with `// workspace-paths-escape: <reason>` above the key.\n",
+    );
+    for (const msg of tsconfigPaths) console.error(`  ${msg}`);
+    console.error("");
+  }
+
   if (tokens.violations.length) {
     failed = true;
     console.error(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/config",
-  "version": "7.6.3",
+  "version": "7.7.0",
   "description": "Shared build and test configuration presets for multiplatform.one",
   "keywords": [
     "config",
@@ -102,7 +102,7 @@
     "vite-plugin-external": "^6.2.2",
     "vite-plugin-i18next-loader": "^3.1.3",
     "vitest": "^4.1.5",
-    "@multiplatform.one/utils": "7.6.3"
+    "@multiplatform.one/utils": "7.7.0"
   },
   "devDependencies": {
     "tsdown": "^0.21.10",

package/src/baseTsconfigTypes.spec.ts

@@ -0,0 +1,42 @@
+/**
+ * The shared `types` array is load-bearing — MPO-109.
+ *
+ * `public/config/tsconfig/base.json` sets `compilerOptions.types`, which turns
+ * OFF automatic @types inclusion for every program in the workspace. Anything
+ * missing from that list is simply absent, with no error at the point of loss.
+ *
+ * `chai` is the one that bit. @vitest/expect declares
+ *
+ *   interface Assertion<T> extends VitestAssertion<Chai.Assertion, T>, ...
+ *
+ * so with no global `Chai` namespace the base interface collapses and takes
+ * `.not` and the jest-dom matchers with it. Measured on 2026-09-04 against
+ * origin/main cb157dd0f: public/components 421 -> 26, public/forms 343 -> 4,
+ * features 168 -> 138, public/utils 4 -> 0, and no package got worse.
+ *
+ * Same shape as the workspace `paths` map: a config key that REPLACES rather
+ * than merges, quietly dropping what it did not enumerate.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+
+const baseTsconfig = path.resolve(__dirname, "../tsconfig/base.json");
+
+/** JSONC: whole-line `//` comments only, plus trailing commas. */
+function readJsonc(file: string): any {
+  const src = fs.readFileSync(file, "utf8");
+  return JSON.parse(src.replace(/^[ \t]*\/\/.*$/gm, "").replace(/,(\s*[}\]])/g, "$1"));
+}
+
+describe("base tsconfig types (MPO-109)", () => {
+  it("keeps chai in the explicit types array", () => {
+    const types = readJsonc(baseTsconfig)?.compilerOptions?.types;
+    expect(types).toContain("chai");
+  });
+
+  it("keeps the jest-dom vitest matchers alongside it", () => {
+    const types = readJsonc(baseTsconfig)?.compilerOptions?.types;
+    expect(types).toContain("@testing-library/jest-dom/vitest");
+  });
+});

package/src/emittingTsconfigPaths.spec.ts

@@ -0,0 +1,85 @@
+/**
+ * Emitting programs must not inherit the workspace `paths` map — MPO-109.
+ *
+ * `tsconfig.base.json` extends `tamagui-workspace-paths.generated.json`, which
+ * points every `@multiplatform.one/*` specifier at a sibling's repo-relative
+ * `src/`. That is right for a typecheck program and wrong for one that emits
+ * declarations under a `rootDir`: a `paths` hit makes the sibling source a file
+ * OF THAT PROGRAM, so `rootDir` rejects it —
+ *
+ *   TS6059 File 'public/utils/src/dev.ts' is not under rootDir '.../src'
+ *   TS6307 ... is not listed within the file list of project ...
+ *
+ * Every emitting package clears the map and resolves siblings through their
+ * exports `source` condition instead (node_modules-external under
+ * preserveSymlinks, so `rootDir` never sees them). The three vite plugins had
+ * no build config at all and compiled straight off the base, which is how
+ * `@multiplatform.one/utils/dev` broke `build-gnome`. The bare-name form was
+ * already reachable on main, so this guard exists to stop the next one.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+
+const root = path.resolve(__dirname, "../../..");
+const publicDir = path.join(root, "public");
+
+/** JSONC: whole-line `//` comments only, plus trailing commas. */
+function readJsonc(file: string): any {
+  const src = fs.readFileSync(file, "utf8");
+  return JSON.parse(src.replace(/^[ \t]*\/\/.*$/gm, "").replace(/,(\s*[}\]])/g, "$1"));
+}
+
+function extendsBase(doc: any): boolean {
+  const value = doc?.extends;
+  const list = Array.isArray(value) ? value : [value];
+  return list.some((entry) => typeof entry === "string" && entry.includes("tsconfig.base"));
+}
+
+/** The config each package's `build` script actually hands to tsc. */
+function buildConfigs(): { pkg: string; file: string; doc: any }[] {
+  const found: { pkg: string; file: string; doc: any }[] = [];
+  for (const entry of fs.readdirSync(publicDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const pkgJson = path.join(publicDir, entry.name, "package.json");
+    if (!fs.existsSync(pkgJson)) continue;
+    const build = JSON.parse(fs.readFileSync(pkgJson, "utf8"))?.scripts?.build;
+    if (typeof build !== "string") continue;
+    const named = build.match(/tsc\s+(?:-p|--project)\s+(\S+)/)?.[1];
+    const file = path.join(publicDir, entry.name, named ?? "tsconfig.json");
+    if (!/\btsc\b/.test(build) || !fs.existsSync(file)) continue;
+    found.push({ pkg: entry.name, file, doc: readJsonc(file) });
+  }
+  return found;
+}
+
+describe("emitting tsconfigs (MPO-109)", () => {
+  it("finds the build configs", () => {
+    expect(buildConfigs().length).toBeGreaterThan(10);
+  });
+
+  it("never lets a rootDir-constrained emitting program inherit the workspace paths map", () => {
+    const offenders = buildConfigs()
+      .filter(({ doc }) => {
+        const co = doc?.compilerOptions ?? {};
+        if (co.noEmit === true || co.rootDir === undefined) return false;
+        if (!extendsBase(doc)) return false;
+        // Clearing the inherited map is the fix; `{}` counts.
+        return co.paths === undefined;
+      })
+      .map(({ pkg, file }) => `${pkg} (${path.relative(root, file)})`);
+    expect(offenders).toEqual([]);
+  });
+
+  it("gives every such program the exports `source` condition to resolve siblings with", () => {
+    const missing = buildConfigs()
+      .filter(({ doc }) => {
+        const co = doc?.compilerOptions ?? {};
+        if (co.noEmit === true || co.rootDir === undefined) return false;
+        if (!extendsBase(doc)) return false;
+        return !(co.customConditions ?? []).includes("source");
+      })
+      .map(({ pkg }) => pkg);
+    expect(missing).toEqual([]);
+  });
+});

package/src/lint.spec.ts

@@ -51,6 +51,73 @@ describe("runConventionChecks", () => {
   });
 });
 
+describe("workspace paths shadow (MPO-109)", () => {
+  function run(root: string) {
+    const error = vi.spyOn(console, "error").mockImplementation(() => {});
+    const log = vi.spyOn(console, "log").mockImplementation(() => {});
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+    const code = runConventionChecks({ roots: { root } });
+    const messages = error.mock.calls.map((call) => String(call[0])).join("\n");
+    error.mockRestore();
+    log.mockRestore();
+    warn.mockRestore();
+    return { code, messages };
+  }
+
+  it("fails an app tsconfig that declares paths while extending tsconfig.base", () => {
+    const root = makeTree();
+    writeFileSync(
+      join(root, "apps", "demo", "tsconfig.json"),
+      `{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "paths": { "@/*": ["./*"] }
+  }
+}
+`,
+    );
+    const { code, messages } = run(root);
+    expect(code).toBe(1);
+    expect(messages).toContain("WORKSPACE PATHS SHADOW");
+    expect(messages).toContain("apps/demo/tsconfig.json");
+  });
+
+  it("passes with no paths, with an escape comment, and when the config does not extend the base", () => {
+    const root = makeTree();
+    writeFileSync(
+      join(root, "apps", "demo", "tsconfig.json"),
+      `{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "noEmit": true }
+}
+`,
+    );
+    mkdirSync(join(root, "features", "escaped"), { recursive: true });
+    mkdirSync(join(root, "public", "standalone"), { recursive: true });
+    writeFileSync(
+      join(root, "public", "standalone", "tsconfig.json"),
+      `{
+  "compilerOptions": { "paths": { "@/*": ["./*"] } }
+}
+`,
+    );
+    mkdirSync(join(root, "packages", "escaped"), { recursive: true });
+    writeFileSync(
+      join(root, "packages", "escaped", "tsconfig.json"),
+      `{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    // workspace-paths-escape: this program deliberately owns its own map
+    "paths": { "@/*": ["./*"] }
+  }
+}
+`,
+    );
+    expect(run(root).code).toBe(0);
+  });
+});
+
 describe("story file shape (MPO-93)", () => {
   function storyTree() {
     const root = makeTree();

package/src/tamaguiWorkspacePaths.spec.ts

@@ -70,6 +70,40 @@ describe("ensureTamaguiWorkspacePaths", () => {
     expect(notices[0]).toContain("was missing");
   });
 
+  it("emits the subpath exports a package declares (MPO-109)", () => {
+    const { root, configDir } = fakeRepo(fs.readFileSync(realGenerator, "utf8"));
+    fs.mkdirSync(path.join(root, "public/widget/src/desk"), { recursive: true });
+    fs.writeFileSync(path.join(root, "public/widget/src/dev.ts"), "export const dev = 1;\n");
+    fs.writeFileSync(
+      path.join(root, "public/widget/src/desk/Shell.tsx"),
+      "export const Shell = 1;\n",
+    );
+    fs.writeFileSync(
+      path.join(root, "public/widget/package.json"),
+      JSON.stringify({
+        name: "@fake/widget",
+        exports: {
+          ".": { source: "./src/index.ts" },
+          // condition object: the declared `source`, never the gitignored types/
+          "./dev": { source: "./src/dev.ts", types: "./types/dev.d.ts" },
+          // wildcard string target: an app deep-imports through this prefix
+          "./src/*": "./src/*",
+          // declared but absent on disk — must not reach the map
+          "./ghost": { source: "./src/ghost.ts" },
+        },
+      }),
+    );
+    const generatedPath = path.join(configDir, tamaguiWorkspacePathsFile);
+    const result = ensureTamaguiWorkspacePaths({ configPackageDir: configDir, log: () => {} });
+    expect(result.status).toBe("generated");
+    const { paths } = JSON.parse(fs.readFileSync(generatedPath, "utf8")).compilerOptions;
+    expect(paths["@fake/widget"]).toEqual(["../../widget/src/index.ts"]);
+    expect(paths["@fake/widget/dev"]).toEqual(["../../widget/src/dev.ts"]);
+    expect(paths["@fake/widget/src/*"]).toEqual(["../../widget/src/*"]);
+    expect(paths).not.toHaveProperty("@fake/widget/ghost");
+    expect(paths).not.toHaveProperty("@fake/widget/package.json");
+  });
+
   it("leaves an existing file alone and stays silent", () => {
     const { configDir } = fakeRepo(fs.readFileSync(realGenerator, "utf8"));
     const generatedPath = path.join(configDir, tamaguiWorkspacePathsFile);

package/src/vite.ts

@@ -224,6 +224,15 @@ export function createViteConfig(options: CreateViteConfigOptions = {}): UserCon
     // This re-asserts the package's own browser redirect (-> browser transports that
     // use RN's global WebSocket/XMLHttpRequest) with NO node_modules patch.
     registerNativeEngineIoBrowserTransports();
+    // A mixed pnpm install (hoisted root dirs + a leftover .pnpm store) puts
+    // two byte-identical copies of react, react-native and 62 other packages
+    // on disk, and which one an importer reaches depends only on where that
+    // importer sits. Two Reacts in one Hermes bundle means the renderer arms
+    // the dispatcher on one copy while components read it as null from the
+    // other — "Cannot read property 'useContext' of null" on first render.
+    // It delegates through `this.resolve`, so it canonicalizes whatever the
+    // rest of the chain produces, wherever it sits in the plugin order.
+    registerNativeSinglePackageInstances();
     // preferBuiltWorkspaceEntryPlugin (web-only) hard-resolves every workspace
     // package to its `dist/esm/index.mjs` (WEB build), and that resolution reaches
     // the native graph too — pinning the whole @multiplatform.one/* chain to web
@@ -562,6 +571,134 @@ function clientBrokenEsmPlugin(): Plugin {
  * This re-asserts the browser redirect with no node_modules patch. Web is
  * unaffected (engine.io is SSR-externalized and the web client already maps `browser`).
  */
+/**
+ * Collapse duplicate PHYSICAL copies of the same package@version to one path
+ * in the NATIVE graph, so React (and every other stateful singleton) exists
+ * exactly once in the Hermes bundle.
+ *
+ * The workspace's node_modules is a MIXED install. `.npmrc` says
+ * `node-linker=hoisted`, so the root `node_modules/<pkg>` entries are real
+ * directories; but an earlier isolated install left a `node_modules/.pnpm`
+ * virtual store plus per-package symlink farms behind — e.g. each package's
+ * own `node_modules/react` still points at
+ * `../../../node_modules/.pnpm/react@19.2.5/node_modules/react`.
+ * Both trees are fully populated with byte-identical copies, and which one an
+ * importer reaches depends only on where that importer sits on disk:
+ *
+ *   apps/one/app      -> node_modules/.pnpm/react@19.2.5/node_modules/react
+ *   public/forms/src  -> node_modules/react            (no local symlink)
+ *
+ * Rolldown resolves symlinks, so the two land as two DIFFERENT absolute paths
+ * and it bundles both. React 19's `useContext` is
+ * `ReactSharedInternals.H.useContext(Context)` — `H` is the dispatcher the
+ * renderer installs during render, and it is only ever set on the copy the
+ * renderer imported. A component from the other copy therefore reads `H` as
+ * null and the app dies with "Cannot read property 'useContext' of null".
+ * That is the whole bug; the same split had also duplicated react-native (427
+ * modules each), @tamagui/web, @react-navigation/core, one, scheduler and 58
+ * more packages.
+ *
+ * The rule: an id that resolves inside the virtual store is rewritten to the
+ * hoisted root copy when the root copy exists, carries the SAME version, and
+ * actually has the file. Version equality is the safety guard — genuine
+ * multi-version installs (two @babel/runtime, two viem) keep both copies.
+ *
+ * On a correctly installed tree this is a no-op by construction: `hoisted`
+ * leaves no `.pnpm` store to match, and `isolated` makes the root entry a
+ * symlink INTO the store, which realpaths back to the same directory (checked
+ * explicitly). It only fires on the mixed tree, and it is cheap because only
+ * BARE specifiers are inspected — once a package's entry is canonical, its own
+ * relative imports resolve inside the canonical copy for free.
+ */
+function registerNativeSinglePackageInstances(): void {
+  const g = globalThis as unknown as { __vxrnAddNativePlugins?: unknown[] };
+  const name = "vxrn-single-package-instances";
+  g.__vxrnAddNativePlugins = g.__vxrnAddNativePlugins ?? [];
+  if (g.__vxrnAddNativePlugins.some((p) => (p as { name?: string })?.name === name)) return;
+
+  const rootModules = path.join(findProjectRoot(), "node_modules");
+  // <...>/node_modules/.pnpm/<pkg>@<ver>_<peerhash>/node_modules/<name>[/<rest>]
+  const storePath =
+    /[\\/]node_modules[\\/]\.pnpm[\\/][^\\/]+[\\/]node_modules[\\/]((?:@[^\\/]+[\\/])?[^\\/]+)(?:[\\/](.*))?$/;
+
+  function versionOf(dir: string): string | null {
+    try {
+      const raw = fs.readFileSync(path.join(dir, "package.json"), "utf8");
+      return (JSON.parse(raw) as { version?: string }).version ?? null;
+    } catch {
+      return null;
+    }
+  }
+
+  // package name -> hoisted root dir that is a safe stand-in, or null
+  const hoisted = new Map<string, string | null>();
+  function hoistedTwin(pkg: string, storeDir: string): string | null {
+    if (!hoisted.has(pkg)) {
+      const rootDir = path.join(rootModules, pkg);
+      let twin: string | null = null;
+      if (fs.existsSync(rootDir)) {
+        const rootVersion = versionOf(rootDir);
+        const storeVersion = versionOf(storeDir);
+        // Same package, same version => identical library code, and the two
+        // dirs are genuinely distinct (not one symlinked onto the other).
+        if (rootVersion && rootVersion === storeVersion) {
+          try {
+            if (fs.realpathSync(rootDir) !== fs.realpathSync(storeDir)) twin = rootDir;
+          } catch {
+            twin = null;
+          }
+        }
+      }
+      hoisted.set(pkg, twin);
+    }
+    return hoisted.get(pkg) ?? null;
+  }
+
+  const seen = new Map<string, string | null>();
+
+  g.__vxrnAddNativePlugins.push({
+    name,
+    async resolveId(
+      this: {
+        resolve: (
+          id: string,
+          importer: string | undefined,
+          opts: { skipSelf: boolean },
+        ) => Promise<{ id: string; external?: boolean | string } | null>;
+      },
+      id: string,
+      importer?: string,
+    ): Promise<string | null> {
+      // Bare specifiers only: a package entry. Relative/absolute ids inside an
+      // already-canonical package resolve within that copy on their own.
+      if (!id || id.startsWith(".") || id.startsWith("/") || id.startsWith("\0")) return null;
+      const key = `${id} ${importer ?? ""}`;
+      const cached = seen.get(key);
+      if (cached !== undefined) return cached;
+
+      let out: string | null = null;
+      try {
+        const resolved = await this.resolve(id, importer, { skipSelf: true });
+        const match = resolved?.external ? null : resolved?.id?.match(storePath);
+        if (resolved && match) {
+          const pkg = match[1].split(path.sep).join("/");
+          const rest = match[2] ?? "";
+          const storeDir = resolved.id.slice(0, resolved.id.length - (rest ? rest.length + 1 : 0));
+          const twin = hoistedTwin(pkg, storeDir);
+          if (twin) {
+            const candidate = rest ? path.join(twin, rest) : twin;
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) out = candidate;
+          }
+        }
+      } catch {
+        out = null;
+      }
+      seen.set(key, out);
+      return out;
+    },
+  });
+}
+
 function registerNativeEngineIoBrowserTransports(): void {
   const g = globalThis as unknown as { __vxrnAddNativePlugins?: unknown[] };
   const name = "vxrn-engineio-browser-transports";
@@ -619,8 +756,21 @@ function registerNativeWorkspaceEntries(): void {
       // (a) bare workspace specifier (e.g. "@multiplatform.one/rich-text")
       const root = roots.get(id);
       if (root) {
+        // Prefer the built native entry when present (tamagui-build already
+        // rewrote intra-package imports to their `.native` siblings).
         const nativeEntry = path.join(root, "dist/esm/index.native.js");
-        return fs.existsSync(nativeEntry) ? nativeEntry : null;
+        if (fs.existsSync(nativeEntry)) return nativeEntry;
+        // Unbuilt workspace package: compile from source instead of letting
+        // rolldown leave the bare specifier external — Hermes has no module
+        // mode, so a surviving top-level `import` is unparseable. Mirrors
+        // preferBuiltWorkspaceEntryPlugin (web) and apps/storybook-expo's
+        // Metro resolveWorkspaceNativeMain. vxrn's native resolver already
+        // does platform-extension resolution (.native.tsx/.ios.tsx/…).
+        const srcTs = path.join(root, "src/index.ts");
+        if (fs.existsSync(srcTs)) return srcTs;
+        const srcTsx = path.join(root, "src/index.tsx");
+        if (fs.existsSync(srcTsx)) return srcTsx;
+        return null;
       }
       // (b) already-resolved web entry "<...>/dist/esm/index.mjs" -> ".native.js" sibling
       if (id.endsWith("/dist/esm/index.mjs")) {

package/tsconfig/base.json

@@ -28,7 +28,16 @@
     "skipLibCheck": true,
     "strictNullChecks": true,
     "target": "ES2020",
-    "types": ["node", "react", "vite/client", "@testing-library/jest-dom/vitest"],
+    // An explicit `types` array turns OFF automatic @types inclusion, so this
+    // list is the whole set of ambient packages every program in the workspace
+    // gets. `chai` is not decoration: @vitest/expect declares
+    //   interface Assertion<T> extends VitestAssertion<Chai.Assertion, T>, ...
+    // and without the global `Chai` namespace that base interface collapses,
+    // taking `.not` and the jest-dom matchers with it. That is where MPO-109's
+    // ~800 TS2339 came from (public/components 421 -> 26, public/forms
+    // 343 -> 4, features 168 -> 138, public/utils 4 -> 0). Do not trim this
+    // list without recounting.
+    "types": ["node", "react", "vite/client", "@testing-library/jest-dom/vitest", "chai"],
     "lib": ["DOM", "DOM.Iterable", "ESNext"]
   },
   "typeAcquisition": {

package/types/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAU,UAAU,EAAE,MAAM,MAAM,CAAC;AAI/C,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,EACJ,OAAO,GACP;QACE;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QAEtB;;;WAGG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEN;;OAEG;IACH,IAAI,CAAC,EACD,OAAO,GACP;QACE;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAEjB;;WAEG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IAEN;;;OAGG;IACH,GAAG,CAAC,EACA,OAAO,GACP;QACE,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3B,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,KAAK,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC/B,MAAM,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;IAEN;;OAEG;IACH,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAEhC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IAEF;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAElC;;;OAGG;IACH,WAAW,CAAC,EAAE;QACZ;;;;;;WAMG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB;;;;;;;WAOG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAmSlF;AAED,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAU,UAAU,EAAE,MAAM,MAAM,CAAC;AAI/C,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,EACJ,OAAO,GACP;QACE;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QAEtB;;;WAGG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEN;;OAEG;IACH,IAAI,CAAC,EACD,OAAO,GACP;QACE;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAEjB;;WAEG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IAEN;;;OAGG;IACH,GAAG,CAAC,EACA,OAAO,GACP;QACE,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3B,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,KAAK,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAC/B,MAAM,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;IAEN;;OAEG;IACH,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAEhC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IAEF;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAElC;;;OAGG;IACH,WAAW,CAAC,EAAE;QACZ;;;;;;WAMG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB;;;;;;;WAOG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CA4SlF;AAED,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC"}