@multiplatform.one/test-utils 9.2.0 → 9.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/test-utils",
-  "version": "9.2.0",
+  "version": "9.4.0",
   "description": "Shared testing utilities for multiplatform.one packages",
   "keywords": [
     "multiplatform.one",
@@ -68,6 +68,13 @@
       "import": "./dist/esm/mocks.mjs",
       "require": "./dist/cjs/mocks.cjs",
       "default": "./dist/esm/mocks.mjs"
+    },
+    "./native-tamagui": {
+      "source": "./src/nativeTamagui.ts",
+      "types": "./types/nativeTamagui.d.ts",
+      "import": "./dist/esm/nativeTamagui.mjs",
+      "require": "./dist/cjs/nativeTamagui.cjs",
+      "default": "./dist/esm/nativeTamagui.mjs"
     }
   },
   "publishConfig": {

package/src/nativeTamagui.ts

@@ -0,0 +1,165 @@
+/**
+ * Loads tamagui's NATIVE build (the `dist/cjs/*.native.js` files Metro ships)
+ * into a vitest worker, with `react-native` replaced by recording host
+ * components. The web build that vitest normally resolves compiles the
+ * native-only prop filtering out, so a native prop-forwarding bug cannot be
+ * reproduced against it (MPO-368).
+ *
+ * Only requires issued while loading, or BY a `.native.js` file, are
+ * redirected, so the rest of the worker keeps its normal module graph.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import Module, { createRequire } from "node:module";
+import { createElement, forwardRef, Fragment, useImperativeHandle, type ReactNode } from "react";
+
+type HostProps = Record<string, unknown> & { children?: ReactNode };
+
+export interface HostInstance {
+  host: string;
+  getNativeScrollRef(): HostInstance;
+}
+
+export interface NativeTamaguiRuntime {
+  core: typeof import("tamagui");
+  RawScrollView: typeof import("tamagui").ScrollView;
+  reactNative: Record<string, unknown>;
+  skipProps: Record<string, unknown>;
+  lastHostProps(name: string): HostProps | undefined;
+  allHostProps(name: string): HostProps[];
+  hostInstance(name: string): HostInstance;
+  resetHosts(): void;
+}
+
+const reactNativeId = "\0mpo-native-tamagui:react-native";
+const nativeCjs = /[\\/]dist[\\/]cjs[\\/].*\.native\.js$/;
+const tamaguiPackage = /[\\/]node_modules[\\/](?:@tamagui[\\/][^\\/]+|tamagui)[\\/]/;
+
+type ModuleInternals = typeof Module & {
+  _resolveFilename(
+    request: string,
+    parent: { filename?: string } | undefined,
+    ...rest: unknown[]
+  ): string;
+  _extensions: Record<string, (module: NodeModule, filename: string) => void>;
+};
+
+export function loadNativeTamagui(): NativeTamaguiRuntime {
+  const seen = new Map<string, HostProps[]>();
+  const instances = new Map<string, HostInstance>();
+
+  const hostInstance = (name: string): HostInstance => {
+    let instance = instances.get(name);
+    if (!instance) {
+      instance = { host: name, getNativeScrollRef: () => instance! };
+      instances.set(name, instance);
+    }
+    return instance;
+  };
+
+  const host = (name: string) => {
+    const Host = forwardRef<HostInstance, HostProps>(function Host(props, ref) {
+      useImperativeHandle(ref, () => hostInstance(name), []);
+      const calls = seen.get(name) ?? [];
+      calls.push(props);
+      seen.set(name, calls);
+      return createElement(Fragment, null, props.children as ReactNode);
+    });
+    Host.displayName = name;
+    return Host;
+  };
+
+  const window = { width: 390, height: 844, scale: 3, fontScale: 1 };
+  const subscription = { remove() {} };
+  const reactNative: Record<string, unknown> = new Proxy(
+    {
+      __esModule: true,
+      Platform: {
+        OS: "ios",
+        select: (spec: Record<string, unknown>) => spec.ios ?? spec.native ?? spec.default,
+      },
+      StyleSheet: {
+        create: <T>(styles: T) => styles,
+        flatten: <T>(style: T) => style,
+        hairlineWidth: 1,
+        absoluteFillObject: {},
+      },
+      Dimensions: { get: () => window, addEventListener: () => subscription },
+      Appearance: { getColorScheme: () => "light", addChangeListener: () => subscription },
+      useColorScheme: () => "light",
+      useWindowDimensions: () => window,
+      PixelRatio: { get: () => 3 },
+      I18nManager: { isRTL: false },
+      Keyboard: { addListener: () => subscription, dismiss() {}, isVisible: () => false },
+      AccessibilityInfo: {
+        addEventListener: () => subscription,
+        isReduceMotionEnabled: async () => false,
+      },
+    } as Record<string | symbol, unknown>,
+    {
+      get(target, key) {
+        if (key in target) return target[key];
+        if (typeof key !== "string" || !/^[A-Z]/.test(key)) return;
+        return (target[key] = host(key));
+      },
+    },
+  );
+
+  let loading = true;
+  const internals = Module as ModuleInternals;
+  const resolve = internals._resolveFilename;
+  internals._resolveFilename = function (request, parent, ...rest) {
+    const fromNative = Boolean(parent?.filename && nativeCjs.test(parent.filename));
+    if (fromNative && (request === "react-native" || request.startsWith("react-native/"))) {
+      return reactNativeId;
+    }
+    const resolved = resolve.call(this, request, parent, ...rest);
+    if ((loading || fromNative) && tamaguiPackage.test(resolved) && resolved.endsWith(".cjs")) {
+      const native = resolved.replace(/\.cjs$/, ".native.js");
+      if (existsSync(native)) return native;
+    }
+    return resolved;
+  };
+
+  // `dist/cjs/*.native.js` is CommonJS inside `"type": "module"` packages;
+  // Node would otherwise load it as ESM and fail on `module.exports`.
+  const loadJs = internals._extensions[".js"]!;
+  internals._extensions[".js"] = function (module, filename) {
+    if (nativeCjs.test(filename)) {
+      (
+        module as NodeModule & { _compile(code: string, file: string, format?: string): void }
+      )._compile(readFileSync(filename, "utf8"), filename, "commonjs");
+      return;
+    }
+    loadJs.call(this, module, filename);
+  };
+
+  const require = createRequire(import.meta.url);
+  require.cache[reactNativeId] = {
+    id: reactNativeId,
+    filename: reactNativeId,
+    loaded: true,
+    exports: reactNative,
+  } as NodeModule;
+
+  const tamaguiRequire = createRequire(require.resolve("tamagui"));
+  const core = tamaguiRequire("@tamagui/core") as NativeTamaguiRuntime["core"];
+  const { ScrollView: RawScrollView } = tamaguiRequire("@tamagui/scroll-view") as {
+    ScrollView: NativeTamaguiRuntime["RawScrollView"];
+  };
+  const webRequire = createRequire(tamaguiRequire.resolve("@tamagui/core"));
+  const { skipProps } = webRequire(
+    webRequire.resolve("@tamagui/web").replace(/index\.native\.js$/, "helpers/skipProps.native.js"),
+  ) as { skipProps: Record<string, unknown> };
+  loading = false;
+
+  return {
+    core,
+    RawScrollView,
+    reactNative,
+    skipProps,
+    lastHostProps: (name) => seen.get(name)?.at(-1),
+    allHostProps: (name) => seen.get(name) ?? [],
+    hostInstance,
+    resetHosts: () => seen.clear(),
+  };
+}

package/types/nativeTamagui.d.ts

@@ -0,0 +1,21 @@
+import { type ReactNode } from "react";
+type HostProps = Record<string, unknown> & {
+    children?: ReactNode;
+};
+export interface HostInstance {
+    host: string;
+    getNativeScrollRef(): HostInstance;
+}
+export interface NativeTamaguiRuntime {
+    core: typeof import("tamagui");
+    RawScrollView: typeof import("tamagui").ScrollView;
+    reactNative: Record<string, unknown>;
+    skipProps: Record<string, unknown>;
+    lastHostProps(name: string): HostProps | undefined;
+    allHostProps(name: string): HostProps[];
+    hostInstance(name: string): HostInstance;
+    resetHosts(): void;
+}
+export declare function loadNativeTamagui(): NativeTamaguiRuntime;
+export {};
+//# sourceMappingURL=nativeTamagui.d.ts.map

package/types/nativeTamagui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeTamagui.d.ts","sourceRoot":"","sources":["../src/nativeTamagui.ts"],"names":[],"mappings":"AAYA,OAAO,EAA4D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjG,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,IAAI,YAAY,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,SAAS,CAAC,CAAC;IAC/B,aAAa,EAAE,cAAc,SAAS,EAAE,UAAU,CAAC;IACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACnD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACxC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IACzC,UAAU,IAAI,IAAI,CAAC;CACpB;AAeD,wBAAgB,iBAAiB,IAAI,oBAAoB,CAuHxD"}