rnwind 0.0.3 → 0.0.5

package/lib/esm/metro/transformer.mjs

@@ -3,8 +3,8 @@ import { parse } from '@babel/parser';
 import generate from '@babel/generator';
 import { createHash } from 'node:crypto';
 import { realpathSync } from 'node:fs';
-import { transformAst } from './transform-ast.mjs';
-import { onThemeChange, getRnwindState, getRnwindCacheKey, getClassNamePrefixes, getHostSources, getHostComponents } from './state.mjs';
+import { onThemeChange, getRnwindState, getRnwindCacheKey, getWrapModules } from './state.mjs';
+import { rewriteWrapImports } from './wrap-imports.mjs';
 import { THEME_SIGNATURE_MODULE, STYLE_SPECIFIERS } from './resolver.mjs';
 import { filterUnknownClassCandidates } from './warn-unknown-classes.mjs';
 
@@ -54,10 +54,19 @@ function parseUserSource(source) {
  * @param candidates Every candidate oxide surfaced from the source.
  * @param atoms Successfully resolved atoms (keys are class names).
  * @param filename Source path, prefixed onto the warning.
+ * @param features Feature-atom maps (gradient / haptic) — their names are
+ *   known classes even though they carry no RN style, so they're excluded
+ *   from the unknown-class warning.
  */
-function warnUnknownClasses(source, candidates, atoms, filename) {
-    const atomNames = new Set(atoms.keys());
-    const unknown = filterUnknownClassCandidates(source, candidates, atomNames);
+function warnUnknownClasses(source, candidates, atoms, filename, features = []) {
+    // Feature atoms (gradient / haptic) resolve to no RN style, so they're
+    // absent from `atoms` — but they're NOT unknown. Fold their names into
+    // the known set so `active:haptic-rigid` etc. don't warn at build time.
+    const known = new Set(atoms.keys());
+    for (const map of features)
+        for (const name of map.keys())
+            known.add(name);
+    const unknown = filterUnknownClassCandidates(source, candidates, known);
     if (unknown.length === 0)
         return;
     // eslint-disable-next-line no-console
@@ -100,52 +109,181 @@ function isThemeCssEntry(filename) {
     return typeof cssEntry === 'string' && cssEntry.length > 0 && cssEntry === filename;
 }
 /**
- * Parse + run rnwind's JSX rewrite + regenerate source code. When
- * parsing or transformation fails, fall back to the original source —
- * we don't want a transient parse error to crash Metro for a file the
- * upstream might handle fine.
+ * Wrap host imports + compile any className literals, then regenerate
+ * source. Two paths:
+ *  - **className present**: oxide-scan the file, record its atoms into
+ *    the union, and inject the generated-style + theme-signature
+ *    side-effect imports so the runtime registries populate.
+ *  - **import-only** (a `{...rest}` forwarder or a leaf with no literal
+ *    `className=`): just wrap the host imports so a forwarded className
+ *    still resolves at render — no oxide scan, no injected imports.
+ *
+ * On parse failure, fall back to the original source — a transient parse
+ * error shouldn't crash Metro for a file the upstream might handle fine.
  * @param args Metro args; `src` is the original source text.
- * @returns Rewritten source text (with `className=` rewrites applied).
+ * @returns Rewritten source text.
  */
 async function rewriteSource(args) {
     const ast = parseUserSource(args.src);
     if (!ast)
         return args.src;
+    // Wrap host component imports so `<View className=…>` resolves at render
+    // through the runtime `wrap` (works for literal, spread, and forwarded
+    // classNames alike). No JSX is rewritten here.
+    const wrapped = rewriteWrapImports(ast, getWrapModules());
+    if (!/classname=/i.test(args.src)) {
+        // Import-only file: nothing to compile. Drop any stale atom
+        // contribution (className may have just been removed) and emit the
+        // wrapped imports — or the untouched source when nothing wrapped.
+        dropFileSafely(args.filename, projectRootOf(args));
+        return wrapped ? generateModule(ast).code : args.src;
+    }
     const state = getRnwindState(projectRootOf(args));
     const extension = extensionOf(args.filename);
     const parsed = await state.parser.parseAtoms({ content: args.src, extension });
-    warnUnknownClasses(args.src, parsed.candidates, parsed.atoms, args.filename);
-    const classNamePrefixes = getClassNamePrefixes();
-    const hostSources = getHostSources();
-    const hostComponents = getHostComponents();
+    warnUnknownClasses(args.src, parsed.candidates, parsed.atoms, args.filename, [parsed.gradientAtoms, parsed.hapticAtoms]);
     if (parsed.atoms.size === 0) {
         state.builder.dropFile(args.filename);
         await state.builder.writeSchemes();
-        transformAst(ast, {
-            styleSpecifiers: [],
-            gradientAtoms: parsed.gradientAtoms,
-            hapticAtoms: parsed.hapticAtoms,
-            classNamePrefixes,
-            hostSources,
-            hostComponents,
-        });
         injectThemeSignatureImport(ast);
         return generateModule(ast).code;
     }
-    const { changed } = await state.builder.recordFile(args.filename, parsed.atoms, parsed.keyframes);
+    const literals = collectClassNameLiterals(ast);
+    const { changed } = await state.builder.recordFile(args.filename, parsed.atoms, parsed.keyframes, literals);
     if (changed)
         await state.builder.writeSchemes();
-    transformAst(ast, {
-        styleSpecifiers: STYLE_SPECIFIERS,
-        gradientAtoms: parsed.gradientAtoms,
-        hapticAtoms: parsed.hapticAtoms,
-        classNamePrefixes,
-        hostSources,
-        hostComponents,
-    });
+    injectSideEffectImports(ast, STYLE_SPECIFIERS);
     injectThemeSignatureImport(ast);
     return generateModule(ast).code;
 }
+/**
+ * Drop a file's union contribution, swallowing the "state not configured"
+ * error unit tests hit when they call the transformer without
+ * `configureRnwindState`.
+ * @param filename Absolute source path.
+ * @param projectRoot Project root for state lookup.
+ */
+function dropFileSafely(filename, projectRoot) {
+    try {
+        getRnwindState(projectRoot).builder.dropFile(filename);
+    }
+    catch {
+        // State not configured (standalone/unit test). Nothing to drop.
+    }
+}
+/**
+ * Whether a JSX attribute names a className-style prop (`className` or
+ * any `<prefix>ClassName`).
+ * @param node JSX attribute node.
+ * @returns True when the attribute is a className prop.
+ */
+function isClassNameAttribute(node) {
+    if (!t.isJSXIdentifier(node.name))
+        return false;
+    const { name } = node.name;
+    return name === 'className' || name.endsWith('ClassName');
+}
+/**
+ * Pull static string literals out of a className expression. Handles a
+ * bare string, a no-substitution template, and the branches of a
+ * ternary / `&&` (so `cond ? 'a' : 'b'` and `flag && 'x'` both register
+ * their literals). Dynamic interpolations are skipped — they resolve via
+ * the runtime atom path.
+ * @param expr Expression inside a `className={...}` container.
+ * @param out Accumulator for discovered literals.
+ */
+function collectLiteralsFromExpression(expr, out) {
+    if (!expr)
+        return;
+    if (t.isStringLiteral(expr)) {
+        out.push(expr.value);
+        return;
+    }
+    if (t.isTemplateLiteral(expr) && expr.expressions.length === 0 && expr.quasis.length === 1) {
+        const cooked = expr.quasis[0]?.value.cooked;
+        if (typeof cooked === 'string')
+            out.push(cooked);
+        return;
+    }
+    if (t.isConditionalExpression(expr)) {
+        collectLiteralsFromExpression(expr.consequent, out);
+        collectLiteralsFromExpression(expr.alternate, out);
+        return;
+    }
+    if (t.isLogicalExpression(expr)) {
+        collectLiteralsFromExpression(expr.right, out);
+    }
+}
+/** AST node keys the literal walk skips — position / comment metadata. */
+const SKIP_WALK_KEYS = new Set(['type', 'loc', 'start', 'end', 'range', 'leadingComments', 'trailingComments', 'innerComments']);
+/**
+ * Collect the static literals from one className JSX attribute into the
+ * dedup accumulator.
+ * @param attribute The (already className-matched) JSX attribute.
+ * @param seen Dedup set of literals already collected.
+ * @param out Ordered accumulator.
+ */
+function collectAttributeLiterals(attribute, seen, out) {
+    const { value } = attribute;
+    const found = [];
+    if (t.isStringLiteral(value))
+        found.push(value.value);
+    else if (t.isJSXExpressionContainer(value))
+        collectLiteralsFromExpression(value.expression, found);
+    for (const literal of found) {
+        if (seen.has(literal))
+            continue;
+        seen.add(literal);
+        out.push(literal);
+    }
+}
+/**
+ * Walk the AST for every `className=` / `<prefix>ClassName=` literal so
+ * the builder can pre-merge each into a per-scheme molecule. A generic
+ * node walk (no scope build) keeps it cheap; only JSX attribute nodes do
+ * any work.
+ * @param ast Parsed Babel file.
+ * @returns Distinct literal className strings, in first-seen order.
+ */
+function collectClassNameLiterals(ast) {
+    const out = [];
+    const seen = new Set();
+    const visit = (node) => {
+        if (!node || typeof node !== 'object')
+            return;
+        if (Array.isArray(node)) {
+            for (const child of node)
+                visit(child);
+            return;
+        }
+        const typed = node;
+        if (typeof typed.type !== 'string')
+            return;
+        if (typed.type === 'JSXAttribute' && isClassNameAttribute(node)) {
+            collectAttributeLiterals(node, seen, out);
+        }
+        for (const key in typed) {
+            if (SKIP_WALK_KEYS.has(key))
+                continue;
+            visit(typed[key]);
+        }
+    };
+    visit(ast.program);
+    return out;
+}
+/**
+ * Prepend side-effect imports (`import '<spec>'`) so the generated
+ * per-scheme style + manifest modules load — registering this file's
+ * atoms / molecules / features into the runtime registries the wrapper's
+ * `resolve` reads.
+ * @param ast Babel File AST to mutate in place.
+ * @param specifiers Module specifiers to side-effect-import.
+ */
+function injectSideEffectImports(ast, specifiers) {
+    for (const specifier of specifiers) {
+        ast.program.body.unshift(t.importDeclaration([], t.stringLiteral(specifier)));
+    }
+}
 /**
  * Prepend `import 'rnwind/__generated/theme-signature'` to every
  * rnwind-transformed file. The resolver maps that specifier to the
@@ -241,10 +379,16 @@ function loadUpstream() {
 function isRewriteCandidate(args) {
     if (!/\.(?:tsx|ts|jsx|js)$/i.test(args.filename))
         return false;
-    // Case-insensitive so `<prefix>ClassName=` (e.g. `contentContainerClassName=`)
-    // — which has a capital `C` and so doesn't contain the lowercase
-    // `className=` — still routes the file through the rewrite pass.
-    if (!/classname=/i.test(args.src))
+    // Process the file when it either:
+    //  - carries a `className=` / `<prefix>ClassName=` literal (case-
+    //    insensitive — `contentContainerClassName=` has a capital C), or
+    //  - spreads props (`{...rest}`) onto a host from a wrap-module, where a
+    //    forwarded className must still get its import wrapped (no literal
+    //    appears in this file). A style-less `<View/>` with neither is left
+    //    alone so it never pays for an unused wrapper.
+    const hasClassName = /classname=/i.test(args.src);
+    const isForwarder = /\{\s*\.\.\./.test(args.src) && mentionsWrapModule(args.src);
+    if (!hasClassName && !isForwarder)
         return false;
     if (!args.filename.includes('/node_modules/'))
         return true;
@@ -257,6 +401,21 @@ function isRewriteCandidate(args) {
         return false;
     }
 }
+/**
+ * Cheap pre-parse check: does the source import from any configured
+ * wrap-module? A quoted specifier match is enough — `rewriteWrapImports`
+ * re-verifies precisely on the AST, so a false positive only costs a
+ * no-op parse.
+ * @param source Source text.
+ * @returns True when a wrap-module specifier appears in the source.
+ */
+function mentionsWrapModule(source) {
+    for (const moduleName of getWrapModules().keys()) {
+        if (source.includes(`'${moduleName}'`) || source.includes(`"${moduleName}"`))
+            return true;
+    }
+    return false;
+}
 /**
  * Fallback parse when no upstream is configured AND Metro didn't hand
  * us an AST. Used by unit tests and standalone setups.

package/lib/esm/metro/transformer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transformer.mjs","sources":["../../../../src/metro/transformer.ts"],"sourcesContent":["import type { File } from '@babel/types'\nimport * as t from '@babel/types'\nimport { parse } from '@babel/parser'\nimport generate from '@babel/generator'\nimport { createHash } from 'node:crypto'\nimport { realpathSync } from 'node:fs'\nimport { transformAst } from './transform-ast'\nimport { getClassNamePrefixes, getHostComponents, getHostSources, getRnwindCacheKey, getRnwindState, onThemeChange } from './state'\nimport { STYLE_SPECIFIERS, THEME_SIGNATURE_MODULE } from './resolver'\nimport { filterUnknownClassCandidates } from './warn-unknown-classes'\n\n/** The shape of the upstream module we delegate parsing/babel work to. */\ninterface UpstreamTransformer {\n  transform: (args: BabelTransformerArgs) => Promise<BabelTransformerResult> | BabelTransformerResult\n}\n\n/** Env var that points at the upstream `babelTransformerPath` we override. */\nconst UPSTREAM_ENV = 'RNWIND_UPSTREAM_TRANSFORMER'\n\n/** Cached upstream module — required once, reused across every transform call. */\nlet cachedUpstream: UpstreamTransformer | null = null\n\nconst generateModule = (generate as unknown as { default?: typeof generate }).default ?? generate\n\n/**\n * Parse user source with the broad plugin set (Flow + JSX + TypeScript\n * + class properties). Permissive on purpose so we don't reject any\n * file the upstream could have handled. Returns `null` when parse\n * fails — caller falls back to the raw source string.\n * @param source Source text.\n * @returns Parsed AST, or null on parse failure.\n */\nfunction parseUserSource(source: string): File | null {\n  try {\n    return parse(source, {\n      sourceType: 'unambiguous',\n      allowReturnOutsideFunction: true,\n      allowImportExportEverywhere: true,\n      plugins: ['typescript', 'jsx'],\n    }) as unknown as File\n  } catch {\n    try {\n      return parse(source, {\n        sourceType: 'unambiguous',\n        allowReturnOutsideFunction: true,\n        allowImportExportEverywhere: true,\n        plugins: ['flow', 'jsx'],\n      }) as unknown as File\n    } catch {\n      return null\n    }\n  }\n}\n\n/**\n * Print Tailwind-shaped candidates oxide picked up but the parser\n * could NOT compile — typo, missing custom utility, or class not in\n * the user's theme. Filtering by candidates that ALSO appear inside a\n * `className=\"…\"` literal eliminates false positives from imports,\n * comments, and JSX prop values.\n * @param source Original source text — searched for className literals.\n * @param candidates Every candidate oxide surfaced from the source.\n * @param atoms Successfully resolved atoms (keys are class names).\n * @param filename Source path, prefixed onto the warning.\n */\nfunction warnUnknownClasses(\n  source: string,\n  candidates: readonly string[],\n  atoms: ReadonlyMap<string, unknown>,\n  filename: string,\n): void {\n  const atomNames = new Set(atoms.keys())\n  const unknown = filterUnknownClassCandidates(source, candidates, atomNames)\n  if (unknown.length === 0) return\n  // eslint-disable-next-line no-console\n  console.warn(`rnwind: unknown class${unknown.length > 1 ? 'es' : ''} in ${filename}: ${unknown.join(', ')}`)\n}\n\n/**\n * Extract the bare extension for oxide / internal switches.\n * @param filename Absolute path.\n * @returns Extension without the leading dot (`tsx` / `ts` / `js` / `jsx`).\n */\nfunction extensionOf(filename: string): string {\n  const index = filename.lastIndexOf('.')\n  if (index === -1) return 'tsx'\n  return filename.slice(index + 1)\n}\n\n/**\n * Read the project root Metro hands us per-transform. Falls back to\n * `process.cwd()` only when the upstream harness doesn't set it (unit\n * tests, standalone). Metro's production pipeline always sets it.\n * @param args Metro transformer args.\n * @returns Absolute project root.\n */\nfunction projectRootOf(args: BabelTransformerArgs): string {\n  const fromOptions = args.options?.projectRoot\n  if (typeof fromOptions === 'string' && fromOptions.length > 0) return fromOptions\n  return process.cwd()\n}\n\n/**\n * Whether a `.css` filename is the user's theme entry (the file\n * `withRnwindConfig` pointed us at via `RNWIND_CSS_ENTRY_FILE`).\n * Only the theme CSS should trigger a scheme rebuild — unrelated CSS\n * files in the project stay invisible to rnwind.\n * @param filename Absolute CSS path.\n * @returns Whether the file is the configured theme entry.\n */\nfunction isThemeCssEntry(filename: string): boolean {\n  const cssEntry = process.env.RNWIND_CSS_ENTRY_FILE\n  return typeof cssEntry === 'string' && cssEntry.length > 0 && cssEntry === filename\n}\n\n/**\n * Parse + run rnwind's JSX rewrite + regenerate source code. When\n * parsing or transformation fails, fall back to the original source —\n * we don't want a transient parse error to crash Metro for a file the\n * upstream might handle fine.\n * @param args Metro args; `src` is the original source text.\n * @returns Rewritten source text (with `className=` rewrites applied).\n */\nasync function rewriteSource(args: BabelTransformerArgs): Promise<string> {\n  const ast = parseUserSource(args.src)\n  if (!ast) return args.src\n\n  const state = getRnwindState(projectRootOf(args))\n  const extension = extensionOf(args.filename)\n  const parsed = await state.parser.parseAtoms({ content: args.src, extension })\n\n  warnUnknownClasses(args.src, parsed.candidates, parsed.atoms, args.filename)\n\n  const classNamePrefixes = getClassNamePrefixes()\n  const hostSources = getHostSources()\n  const hostComponents = getHostComponents()\n  if (parsed.atoms.size === 0) {\n    state.builder.dropFile(args.filename)\n    await state.builder.writeSchemes()\n    transformAst(ast, {\n      styleSpecifiers: [],\n      gradientAtoms: parsed.gradientAtoms,\n      hapticAtoms: parsed.hapticAtoms,\n      classNamePrefixes,\n      hostSources,\n      hostComponents,\n    })\n    injectThemeSignatureImport(ast)\n    return generateModule(ast).code\n  }\n\n  const { changed } = await state.builder.recordFile(args.filename, parsed.atoms, parsed.keyframes)\n  if (changed) await state.builder.writeSchemes()\n\n  transformAst(ast, {\n    styleSpecifiers: STYLE_SPECIFIERS as unknown as readonly string[],\n    gradientAtoms: parsed.gradientAtoms,\n    hapticAtoms: parsed.hapticAtoms,\n    classNamePrefixes,\n    hostSources,\n    hostComponents,\n  })\n  injectThemeSignatureImport(ast)\n  return generateModule(ast).code\n}\n\n/**\n * Prepend `import 'rnwind/__generated/theme-signature'` to every\n * rnwind-transformed file. The resolver maps that specifier to the\n * user's theme CSS so Metro's dependency graph carries a real edge\n * from this JS file to the CSS. When the user edits `global.css`,\n * the CSS module's SHA1 changes, and Metro invalidates every JS file\n * holding this import — forcing them to re-transform with the new\n * theme. The `.css` branch in {@link transform} returns an empty\n * `export {}` module so the runtime cost is one extra `require()`.\n * @param ast Babel File AST to mutate in place.\n */\nfunction injectThemeSignatureImport(ast: File): void {\n  const declaration = t.importDeclaration([], t.stringLiteral(THEME_SIGNATURE_MODULE))\n  ast.program.body.unshift(declaration)\n}\n\n/**\n * Read the upstream transformer's `getCacheKey()` so our cache-key\n * contribution composes with — rather than replaces — whatever the\n * host framework wants to mix in.\n * @returns Upstream cache key, or `null` when no upstream exposes one.\n */\nfunction loadUpstreamCacheKey(): string | null {\n  const upstream = loadUpstream() as (UpstreamTransformer & { getCacheKey?: () => string }) | null\n  if (!upstream) return null\n  try {\n    return typeof upstream.getCacheKey === 'function' ? upstream.getCacheKey() : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Invoke the upstream `babelTransformerPath` Metro originally had\n * configured. The path is read from `RNWIND_UPSTREAM_TRANSFORMER`,\n * which `withRnwindConfig` sets at Metro startup. When the env var is\n * unset (unit tests, standalone use), fall back to a typescript+jsx\n * parse.\n * @param args Metro's per-file args.\n * @returns Upstream transform result containing the post-babel AST.\n */\nasync function runUpstream(args: BabelTransformerArgs): Promise<BabelTransformerResult> {\n  if (args.ast && !process.env[UPSTREAM_ENV]) return { ast: args.ast }\n  const upstream = loadUpstream()\n  if (upstream) return await Promise.resolve(upstream.transform(args))\n  if (args.ast) return { ast: args.ast }\n  return { ast: parseSource(args.src) }\n}\n\n/**\n * Lazily require the upstream transformer module. Cached after first\n * load so per-file overhead is one cache lookup.\n * @returns Upstream module, or null when env is unset.\n */\nfunction loadUpstream(): UpstreamTransformer | null {\n  if (cachedUpstream) return cachedUpstream\n  const upstreamPath = process.env[UPSTREAM_ENV]\n  if (!upstreamPath || upstreamPath.length === 0) return null\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n    const required = require(upstreamPath) as UpstreamTransformer | { default?: UpstreamTransformer }\n    const upstream = (required as { default?: UpstreamTransformer }).default ?? (required as UpstreamTransformer)\n    if (typeof upstream.transform !== 'function') return null\n    cachedUpstream = upstream\n    return upstream\n  } catch (error) {\n    // eslint-disable-next-line no-console\n    if (process.env.RNWIND_DEBUG) console.error('rnwind: failed to load upstream transformer:', error)\n    return null\n  }\n}\n\n/**\n * Cheap guard — the file has to look JS/TS, live outside `node_modules`,\n * and mention `className=` before we spend AST cycles on it.\n *\n * Symlink awareness: monorepo workspaces (yarn / pnpm / bun workspaces)\n * symlink each package into the consumer's `node_modules/<name>`, so a\n * file from `packages/ui/src/Foo.tsx` ends up reaching the transformer\n * as `<root>/node_modules/ui/src/Foo.tsx`. The naïve `/node_modules/`\n * check would skip every workspace UI file. We `realpath` the filename\n * once and only bail when the resolved real path is ALSO under\n * node_modules — true third-party installs.\n * @param args Metro args.\n * @returns Whether the file might need the rnwind pass.\n */\nfunction isRewriteCandidate(args: BabelTransformerArgs): boolean {\n  if (!/\\.(?:tsx|ts|jsx|js)$/i.test(args.filename)) return false\n  // Case-insensitive so `<prefix>ClassName=` (e.g. `contentContainerClassName=`)\n  // — which has a capital `C` and so doesn't contain the lowercase\n  // `className=` — still routes the file through the rewrite pass.\n  if (!/classname=/i.test(args.src)) return false\n  if (!args.filename.includes('/node_modules/')) return true\n  // node_modules in path → could be a workspace symlink; resolve it.\n  try {\n    return !realpathSync(args.filename).includes('/node_modules/')\n  } catch {\n    // realpath failed (broken symlink, missing file). Fall back to skipping.\n    return false\n  }\n}\n\n/**\n * Fallback parse when no upstream is configured AND Metro didn't hand\n * us an AST. Used by unit tests and standalone setups.\n * @param source Source text.\n * @returns Parsed Babel File.\n */\nfunction parseSource(source: string): File {\n  return parse(source, { sourceType: 'module', plugins: ['typescript', 'jsx'] }) as unknown as File\n}\n\n/** Metro's babel transformer signature. */\nexport interface BabelTransformerArgs {\n  filename: string\n  src: string\n  options: { projectRoot?: string; [key: string]: unknown }\n  ast?: File\n  plugins?: readonly unknown[]\n}\n\n/** Return shape Metro expects from a babel transformer. */\nexport interface BabelTransformerResult {\n  ast: File\n  metadata?: unknown\n}\n\n/**\n * rnwind's Metro babel transformer. Two phases per source file:\n *\n *  1. **Pre-process the source string before handing it to the upstream\n *     babel pipeline.** babel-preset-expo / React's JSX transform run\n *     inside the upstream and convert `<View className=\"...\"/>` into\n *     `React.createElement(View, {className})`. If we walked the AST\n *     AFTER the upstream, there'd be no JSX attributes left to\n *     rewrite. So we parse, run our pass, regenerate code, and feed\n *     THAT to the upstream as `src`.\n *  2. **Delegate to the upstream `babelTransformerPath`** (Expo's\n *     default handles Flow stripping, expo-router macros, etc.).\n *\n * Skip both phases when the file isn't a JS/TS source under user\n * code, or doesn't mention `className=` — hand straight to upstream.\n * @param args Metro's per-file args.\n * @returns Mutated AST + metadata.\n */\nexport async function transform(args: BabelTransformerArgs): Promise<BabelTransformerResult> {\n  // Short-circuit `.css` inputs: the theme CSS is pulled into the dep\n  // graph as a sentinel (see `THEME_SIGNATURE_MODULE` in resolver.ts)\n  // so Metro watches it and invalidates importers on edit, but the\n  // file's CSS syntax can't go through a JS babel transformer.\n  //\n  // When the CSS being transformed IS the user's theme entry, we\n  // piggyback on Metro's own file-watcher: Metro calls us here on\n  // every CSS save; we trigger `onThemeChange` to rebuild parser +\n  // rewrite scheme files with the new values. Metro's dep graph then\n  // HMRs the regenerated `common.style.js` to the running app.\n  //\n  // Emitting the CSS content hash in the fake JS output is what makes\n  // Metro propagate invalidation to downstream importers — constant\n  // `export {}` bytes would never look changed and Metro would skip\n  // the chain.\n  if (args.filename.endsWith('.css')) {\n    if (isThemeCssEntry(args.filename)) {\n      try {\n        await onThemeChange(projectRootOf(args))\n      } catch {\n        // CSS edit happened outside a configured project (e.g. tests).\n      }\n    }\n    const themeHash = createHash('sha256').update(args.src).digest('hex').slice(0, 16)\n    const stub = `export const __rnwindThemeHash = ${JSON.stringify(themeHash)};\\n`\n    return { ast: parse(stub, { sourceType: 'module' }) as unknown as File }\n  }\n  if (!isRewriteCandidate(args)) {\n    if (/\\.(?:tsx|ts|jsx|js)$/i.test(args.filename) && !args.filename.includes('/node_modules/')) {\n      try {\n        getRnwindState(projectRootOf(args)).builder.dropFile(args.filename)\n      } catch {\n        // State not configured (e.g. test). Nothing to drop.\n      }\n    }\n    return runUpstream(args)\n  }\n\n  const rewrittenSource = await rewriteSource(args)\n  return runUpstream({ ...args, src: rewrittenSource, ast: undefined })\n}\n\n/**\n * Metro's babel-transformer contract: a `getCacheKey()` export is\n * sampled per-file and mixed into the transform cache key. Returning\n * a string that includes the theme CSS content hash invalidates every\n * cached transform on every CSS edit — so the bundle rebuilds with\n * the new theme automatically on the next request.\n * @returns Cache-key segment that includes rnwind's current theme hash.\n */\nexport function getCacheKey(): string {\n  const upstreamKey = loadUpstreamCacheKey()\n  const ownKey = getRnwindCacheKey()\n  return upstreamKey ? `${upstreamKey}|${ownKey}` : ownKey\n}\n\n/** Test-only — drop the cached upstream so a new env var picks up next call. */\nexport function __resetUpstreamCache(): void {\n  cachedUpstream = null\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"transformer.mjs","sources":["../../../../src/metro/transformer.ts"],"sourcesContent":["import type { File } from '@babel/types'\nimport * as t from '@babel/types'\nimport { parse } from '@babel/parser'\nimport generate from '@babel/generator'\nimport { createHash } from 'node:crypto'\nimport { realpathSync } from 'node:fs'\nimport { getRnwindCacheKey, getRnwindState, getWrapModules, onThemeChange } from './state'\nimport { rewriteWrapImports } from './wrap-imports'\nimport { STYLE_SPECIFIERS, THEME_SIGNATURE_MODULE } from './resolver'\nimport { filterUnknownClassCandidates } from './warn-unknown-classes'\n\n/** The shape of the upstream module we delegate parsing/babel work to. */\ninterface UpstreamTransformer {\n  transform: (args: BabelTransformerArgs) => Promise<BabelTransformerResult> | BabelTransformerResult\n}\n\n/** Env var that points at the upstream `babelTransformerPath` we override. */\nconst UPSTREAM_ENV = 'RNWIND_UPSTREAM_TRANSFORMER'\n\n/** Cached upstream module — required once, reused across every transform call. */\nlet cachedUpstream: UpstreamTransformer | null = null\n\nconst generateModule = (generate as unknown as { default?: typeof generate }).default ?? generate\n\n/**\n * Parse user source with the broad plugin set (Flow + JSX + TypeScript\n * + class properties). Permissive on purpose so we don't reject any\n * file the upstream could have handled. Returns `null` when parse\n * fails — caller falls back to the raw source string.\n * @param source Source text.\n * @returns Parsed AST, or null on parse failure.\n */\nfunction parseUserSource(source: string): File | null {\n  try {\n    return parse(source, {\n      sourceType: 'unambiguous',\n      allowReturnOutsideFunction: true,\n      allowImportExportEverywhere: true,\n      plugins: ['typescript', 'jsx'],\n    }) as unknown as File\n  } catch {\n    try {\n      return parse(source, {\n        sourceType: 'unambiguous',\n        allowReturnOutsideFunction: true,\n        allowImportExportEverywhere: true,\n        plugins: ['flow', 'jsx'],\n      }) as unknown as File\n    } catch {\n      return null\n    }\n  }\n}\n\n/**\n * Print Tailwind-shaped candidates oxide picked up but the parser\n * could NOT compile — typo, missing custom utility, or class not in\n * the user's theme. Filtering by candidates that ALSO appear inside a\n * `className=\"…\"` literal eliminates false positives from imports,\n * comments, and JSX prop values.\n * @param source Original source text — searched for className literals.\n * @param candidates Every candidate oxide surfaced from the source.\n * @param atoms Successfully resolved atoms (keys are class names).\n * @param filename Source path, prefixed onto the warning.\n * @param features Feature-atom maps (gradient / haptic) — their names are\n *   known classes even though they carry no RN style, so they're excluded\n *   from the unknown-class warning.\n */\nfunction warnUnknownClasses(\n  source: string,\n  candidates: readonly string[],\n  atoms: ReadonlyMap<string, unknown>,\n  filename: string,\n  features: ReadonlyArray<ReadonlyMap<string, unknown>> = [],\n): void {\n  // Feature atoms (gradient / haptic) resolve to no RN style, so they're\n  // absent from `atoms` — but they're NOT unknown. Fold their names into\n  // the known set so `active:haptic-rigid` etc. don't warn at build time.\n  const known = new Set(atoms.keys())\n  for (const map of features) for (const name of map.keys()) known.add(name)\n  const unknown = filterUnknownClassCandidates(source, candidates, known)\n  if (unknown.length === 0) return\n  // eslint-disable-next-line no-console\n  console.warn(`rnwind: unknown class${unknown.length > 1 ? 'es' : ''} in ${filename}: ${unknown.join(', ')}`)\n}\n\n/**\n * Extract the bare extension for oxide / internal switches.\n * @param filename Absolute path.\n * @returns Extension without the leading dot (`tsx` / `ts` / `js` / `jsx`).\n */\nfunction extensionOf(filename: string): string {\n  const index = filename.lastIndexOf('.')\n  if (index === -1) return 'tsx'\n  return filename.slice(index + 1)\n}\n\n/**\n * Read the project root Metro hands us per-transform. Falls back to\n * `process.cwd()` only when the upstream harness doesn't set it (unit\n * tests, standalone). Metro's production pipeline always sets it.\n * @param args Metro transformer args.\n * @returns Absolute project root.\n */\nfunction projectRootOf(args: BabelTransformerArgs): string {\n  const fromOptions = args.options?.projectRoot\n  if (typeof fromOptions === 'string' && fromOptions.length > 0) return fromOptions\n  return process.cwd()\n}\n\n/**\n * Whether a `.css` filename is the user's theme entry (the file\n * `withRnwindConfig` pointed us at via `RNWIND_CSS_ENTRY_FILE`).\n * Only the theme CSS should trigger a scheme rebuild — unrelated CSS\n * files in the project stay invisible to rnwind.\n * @param filename Absolute CSS path.\n * @returns Whether the file is the configured theme entry.\n */\nfunction isThemeCssEntry(filename: string): boolean {\n  const cssEntry = process.env.RNWIND_CSS_ENTRY_FILE\n  return typeof cssEntry === 'string' && cssEntry.length > 0 && cssEntry === filename\n}\n\n/**\n * Wrap host imports + compile any className literals, then regenerate\n * source. Two paths:\n *  - **className present**: oxide-scan the file, record its atoms into\n *    the union, and inject the generated-style + theme-signature\n *    side-effect imports so the runtime registries populate.\n *  - **import-only** (a `{...rest}` forwarder or a leaf with no literal\n *    `className=`): just wrap the host imports so a forwarded className\n *    still resolves at render — no oxide scan, no injected imports.\n *\n * On parse failure, fall back to the original source — a transient parse\n * error shouldn't crash Metro for a file the upstream might handle fine.\n * @param args Metro args; `src` is the original source text.\n * @returns Rewritten source text.\n */\nasync function rewriteSource(args: BabelTransformerArgs): Promise<string> {\n  const ast = parseUserSource(args.src)\n  if (!ast) return args.src\n\n  // Wrap host component imports so `<View className=…>` resolves at render\n  // through the runtime `wrap` (works for literal, spread, and forwarded\n  // classNames alike). No JSX is rewritten here.\n  const wrapped = rewriteWrapImports(ast, getWrapModules())\n\n  if (!/classname=/i.test(args.src)) {\n    // Import-only file: nothing to compile. Drop any stale atom\n    // contribution (className may have just been removed) and emit the\n    // wrapped imports — or the untouched source when nothing wrapped.\n    dropFileSafely(args.filename, projectRootOf(args))\n    return wrapped ? generateModule(ast).code : args.src\n  }\n\n  const state = getRnwindState(projectRootOf(args))\n  const extension = extensionOf(args.filename)\n  const parsed = await state.parser.parseAtoms({ content: args.src, extension })\n\n  warnUnknownClasses(args.src, parsed.candidates, parsed.atoms, args.filename, [parsed.gradientAtoms, parsed.hapticAtoms])\n\n  if (parsed.atoms.size === 0) {\n    state.builder.dropFile(args.filename)\n    await state.builder.writeSchemes()\n    injectThemeSignatureImport(ast)\n    return generateModule(ast).code\n  }\n\n  const literals = collectClassNameLiterals(ast)\n  const { changed } = await state.builder.recordFile(args.filename, parsed.atoms, parsed.keyframes, literals)\n  if (changed) await state.builder.writeSchemes()\n\n  injectSideEffectImports(ast, STYLE_SPECIFIERS)\n  injectThemeSignatureImport(ast)\n  return generateModule(ast).code\n}\n\n/**\n * Drop a file's union contribution, swallowing the \"state not configured\"\n * error unit tests hit when they call the transformer without\n * `configureRnwindState`.\n * @param filename Absolute source path.\n * @param projectRoot Project root for state lookup.\n */\nfunction dropFileSafely(filename: string, projectRoot: string): void {\n  try {\n    getRnwindState(projectRoot).builder.dropFile(filename)\n  } catch {\n    // State not configured (standalone/unit test). Nothing to drop.\n  }\n}\n\n/**\n * Whether a JSX attribute names a className-style prop (`className` or\n * any `<prefix>ClassName`).\n * @param node JSX attribute node.\n * @returns True when the attribute is a className prop.\n */\nfunction isClassNameAttribute(node: t.JSXAttribute): boolean {\n  if (!t.isJSXIdentifier(node.name)) return false\n  const {name} = node.name\n  return name === 'className' || name.endsWith('ClassName')\n}\n\n/**\n * Pull static string literals out of a className expression. Handles a\n * bare string, a no-substitution template, and the branches of a\n * ternary / `&&` (so `cond ? 'a' : 'b'` and `flag && 'x'` both register\n * their literals). Dynamic interpolations are skipped — they resolve via\n * the runtime atom path.\n * @param expr Expression inside a `className={...}` container.\n * @param out Accumulator for discovered literals.\n */\nfunction collectLiteralsFromExpression(expr: t.Expression | t.JSXEmptyExpression | null | undefined, out: string[]): void {\n  if (!expr) return\n  if (t.isStringLiteral(expr)) {\n    out.push(expr.value)\n    return\n  }\n  if (t.isTemplateLiteral(expr) && expr.expressions.length === 0 && expr.quasis.length === 1) {\n    const cooked = expr.quasis[0]?.value.cooked\n    if (typeof cooked === 'string') out.push(cooked)\n    return\n  }\n  if (t.isConditionalExpression(expr)) {\n    collectLiteralsFromExpression(expr.consequent, out)\n    collectLiteralsFromExpression(expr.alternate, out)\n    return\n  }\n  if (t.isLogicalExpression(expr)) {\n    collectLiteralsFromExpression(expr.right as t.Expression, out)\n  }\n}\n\n/** AST node keys the literal walk skips — position / comment metadata. */\nconst SKIP_WALK_KEYS = new Set(['type', 'loc', 'start', 'end', 'range', 'leadingComments', 'trailingComments', 'innerComments'])\n\n/**\n * Collect the static literals from one className JSX attribute into the\n * dedup accumulator.\n * @param attribute The (already className-matched) JSX attribute.\n * @param seen Dedup set of literals already collected.\n * @param out Ordered accumulator.\n */\nfunction collectAttributeLiterals(attribute: t.JSXAttribute, seen: Set<string>, out: string[]): void {\n  const { value } = attribute\n  const found: string[] = []\n  if (t.isStringLiteral(value)) found.push(value.value)\n  else if (t.isJSXExpressionContainer(value)) collectLiteralsFromExpression(value.expression, found)\n  for (const literal of found) {\n    if (seen.has(literal)) continue\n    seen.add(literal)\n    out.push(literal)\n  }\n}\n\n/**\n * Walk the AST for every `className=` / `<prefix>ClassName=` literal so\n * the builder can pre-merge each into a per-scheme molecule. A generic\n * node walk (no scope build) keeps it cheap; only JSX attribute nodes do\n * any work.\n * @param ast Parsed Babel file.\n * @returns Distinct literal className strings, in first-seen order.\n */\nfunction collectClassNameLiterals(ast: File): readonly string[] {\n  const out: string[] = []\n  const seen = new Set<string>()\n  const visit = (node: unknown): void => {\n    if (!node || typeof node !== 'object') return\n    if (Array.isArray(node)) {\n      for (const child of node) visit(child)\n      return\n    }\n    const typed = node as { type?: string; [key: string]: unknown }\n    if (typeof typed.type !== 'string') return\n    if (typed.type === 'JSXAttribute' && isClassNameAttribute(node as t.JSXAttribute)) {\n      collectAttributeLiterals(node as t.JSXAttribute, seen, out)\n    }\n    for (const key in typed) {\n      if (SKIP_WALK_KEYS.has(key)) continue\n      visit(typed[key])\n    }\n  }\n  visit(ast.program)\n  return out\n}\n\n/**\n * Prepend side-effect imports (`import '<spec>'`) so the generated\n * per-scheme style + manifest modules load — registering this file's\n * atoms / molecules / features into the runtime registries the wrapper's\n * `resolve` reads.\n * @param ast Babel File AST to mutate in place.\n * @param specifiers Module specifiers to side-effect-import.\n */\nfunction injectSideEffectImports(ast: File, specifiers: readonly string[]): void {\n  for (const specifier of specifiers) {\n    ast.program.body.unshift(t.importDeclaration([], t.stringLiteral(specifier)))\n  }\n}\n\n/**\n * Prepend `import 'rnwind/__generated/theme-signature'` to every\n * rnwind-transformed file. The resolver maps that specifier to the\n * user's theme CSS so Metro's dependency graph carries a real edge\n * from this JS file to the CSS. When the user edits `global.css`,\n * the CSS module's SHA1 changes, and Metro invalidates every JS file\n * holding this import — forcing them to re-transform with the new\n * theme. The `.css` branch in {@link transform} returns an empty\n * `export {}` module so the runtime cost is one extra `require()`.\n * @param ast Babel File AST to mutate in place.\n */\nfunction injectThemeSignatureImport(ast: File): void {\n  const declaration = t.importDeclaration([], t.stringLiteral(THEME_SIGNATURE_MODULE))\n  ast.program.body.unshift(declaration)\n}\n\n/**\n * Read the upstream transformer's `getCacheKey()` so our cache-key\n * contribution composes with — rather than replaces — whatever the\n * host framework wants to mix in.\n * @returns Upstream cache key, or `null` when no upstream exposes one.\n */\nfunction loadUpstreamCacheKey(): string | null {\n  const upstream = loadUpstream() as (UpstreamTransformer & { getCacheKey?: () => string }) | null\n  if (!upstream) return null\n  try {\n    return typeof upstream.getCacheKey === 'function' ? upstream.getCacheKey() : null\n  } catch {\n    return null\n  }\n}\n\n/**\n * Invoke the upstream `babelTransformerPath` Metro originally had\n * configured. The path is read from `RNWIND_UPSTREAM_TRANSFORMER`,\n * which `withRnwindConfig` sets at Metro startup. When the env var is\n * unset (unit tests, standalone use), fall back to a typescript+jsx\n * parse.\n * @param args Metro's per-file args.\n * @returns Upstream transform result containing the post-babel AST.\n */\nasync function runUpstream(args: BabelTransformerArgs): Promise<BabelTransformerResult> {\n  if (args.ast && !process.env[UPSTREAM_ENV]) return { ast: args.ast }\n  const upstream = loadUpstream()\n  if (upstream) return await Promise.resolve(upstream.transform(args))\n  if (args.ast) return { ast: args.ast }\n  return { ast: parseSource(args.src) }\n}\n\n/**\n * Lazily require the upstream transformer module. Cached after first\n * load so per-file overhead is one cache lookup.\n * @returns Upstream module, or null when env is unset.\n */\nfunction loadUpstream(): UpstreamTransformer | null {\n  if (cachedUpstream) return cachedUpstream\n  const upstreamPath = process.env[UPSTREAM_ENV]\n  if (!upstreamPath || upstreamPath.length === 0) return null\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n    const required = require(upstreamPath) as UpstreamTransformer | { default?: UpstreamTransformer }\n    const upstream = (required as { default?: UpstreamTransformer }).default ?? (required as UpstreamTransformer)\n    if (typeof upstream.transform !== 'function') return null\n    cachedUpstream = upstream\n    return upstream\n  } catch (error) {\n    // eslint-disable-next-line no-console\n    if (process.env.RNWIND_DEBUG) console.error('rnwind: failed to load upstream transformer:', error)\n    return null\n  }\n}\n\n/**\n * Cheap guard — the file has to look JS/TS, live outside `node_modules`,\n * and mention `className=` before we spend AST cycles on it.\n *\n * Symlink awareness: monorepo workspaces (yarn / pnpm / bun workspaces)\n * symlink each package into the consumer's `node_modules/<name>`, so a\n * file from `packages/ui/src/Foo.tsx` ends up reaching the transformer\n * as `<root>/node_modules/ui/src/Foo.tsx`. The naïve `/node_modules/`\n * check would skip every workspace UI file. We `realpath` the filename\n * once and only bail when the resolved real path is ALSO under\n * node_modules — true third-party installs.\n * @param args Metro args.\n * @returns Whether the file might need the rnwind pass.\n */\nfunction isRewriteCandidate(args: BabelTransformerArgs): boolean {\n  if (!/\\.(?:tsx|ts|jsx|js)$/i.test(args.filename)) return false\n  // Process the file when it either:\n  //  - carries a `className=` / `<prefix>ClassName=` literal (case-\n  //    insensitive — `contentContainerClassName=` has a capital C), or\n  //  - spreads props (`{...rest}`) onto a host from a wrap-module, where a\n  //    forwarded className must still get its import wrapped (no literal\n  //    appears in this file). A style-less `<View/>` with neither is left\n  //    alone so it never pays for an unused wrapper.\n  const hasClassName = /classname=/i.test(args.src)\n  const isForwarder = /\\{\\s*\\.\\.\\./.test(args.src) && mentionsWrapModule(args.src)\n  if (!hasClassName && !isForwarder) return false\n  if (!args.filename.includes('/node_modules/')) return true\n  // node_modules in path → could be a workspace symlink; resolve it.\n  try {\n    return !realpathSync(args.filename).includes('/node_modules/')\n  } catch {\n    // realpath failed (broken symlink, missing file). Fall back to skipping.\n    return false\n  }\n}\n\n/**\n * Cheap pre-parse check: does the source import from any configured\n * wrap-module? A quoted specifier match is enough — `rewriteWrapImports`\n * re-verifies precisely on the AST, so a false positive only costs a\n * no-op parse.\n * @param source Source text.\n * @returns True when a wrap-module specifier appears in the source.\n */\nfunction mentionsWrapModule(source: string): boolean {\n  for (const moduleName of getWrapModules().keys()) {\n    if (source.includes(`'${moduleName}'`) || source.includes(`\"${moduleName}\"`)) return true\n  }\n  return false\n}\n\n/**\n * Fallback parse when no upstream is configured AND Metro didn't hand\n * us an AST. Used by unit tests and standalone setups.\n * @param source Source text.\n * @returns Parsed Babel File.\n */\nfunction parseSource(source: string): File {\n  return parse(source, { sourceType: 'module', plugins: ['typescript', 'jsx'] }) as unknown as File\n}\n\n/** Metro's babel transformer signature. */\nexport interface BabelTransformerArgs {\n  filename: string\n  src: string\n  options: { projectRoot?: string; [key: string]: unknown }\n  ast?: File\n  plugins?: readonly unknown[]\n}\n\n/** Return shape Metro expects from a babel transformer. */\nexport interface BabelTransformerResult {\n  ast: File\n  metadata?: unknown\n}\n\n/**\n * rnwind's Metro babel transformer. Two phases per source file:\n *\n *  1. **Pre-process the source string before handing it to the upstream\n *     babel pipeline.** babel-preset-expo / React's JSX transform run\n *     inside the upstream and convert `<View className=\"...\"/>` into\n *     `React.createElement(View, {className})`. If we walked the AST\n *     AFTER the upstream, there'd be no JSX attributes left to\n *     rewrite. So we parse, run our pass, regenerate code, and feed\n *     THAT to the upstream as `src`.\n *  2. **Delegate to the upstream `babelTransformerPath`** (Expo's\n *     default handles Flow stripping, expo-router macros, etc.).\n *\n * Skip both phases when the file isn't a JS/TS source under user\n * code, or doesn't mention `className=` — hand straight to upstream.\n * @param args Metro's per-file args.\n * @returns Mutated AST + metadata.\n */\nexport async function transform(args: BabelTransformerArgs): Promise<BabelTransformerResult> {\n  // Short-circuit `.css` inputs: the theme CSS is pulled into the dep\n  // graph as a sentinel (see `THEME_SIGNATURE_MODULE` in resolver.ts)\n  // so Metro watches it and invalidates importers on edit, but the\n  // file's CSS syntax can't go through a JS babel transformer.\n  //\n  // When the CSS being transformed IS the user's theme entry, we\n  // piggyback on Metro's own file-watcher: Metro calls us here on\n  // every CSS save; we trigger `onThemeChange` to rebuild parser +\n  // rewrite scheme files with the new values. Metro's dep graph then\n  // HMRs the regenerated `common.style.js` to the running app.\n  //\n  // Emitting the CSS content hash in the fake JS output is what makes\n  // Metro propagate invalidation to downstream importers — constant\n  // `export {}` bytes would never look changed and Metro would skip\n  // the chain.\n  if (args.filename.endsWith('.css')) {\n    if (isThemeCssEntry(args.filename)) {\n      try {\n        await onThemeChange(projectRootOf(args))\n      } catch {\n        // CSS edit happened outside a configured project (e.g. tests).\n      }\n    }\n    const themeHash = createHash('sha256').update(args.src).digest('hex').slice(0, 16)\n    const stub = `export const __rnwindThemeHash = ${JSON.stringify(themeHash)};\\n`\n    return { ast: parse(stub, { sourceType: 'module' }) as unknown as File }\n  }\n  if (!isRewriteCandidate(args)) {\n    if (/\\.(?:tsx|ts|jsx|js)$/i.test(args.filename) && !args.filename.includes('/node_modules/')) {\n      try {\n        getRnwindState(projectRootOf(args)).builder.dropFile(args.filename)\n      } catch {\n        // State not configured (e.g. test). Nothing to drop.\n      }\n    }\n    return runUpstream(args)\n  }\n\n  const rewrittenSource = await rewriteSource(args)\n  return runUpstream({ ...args, src: rewrittenSource, ast: undefined })\n}\n\n/**\n * Metro's babel-transformer contract: a `getCacheKey()` export is\n * sampled per-file and mixed into the transform cache key. Returning\n * a string that includes the theme CSS content hash invalidates every\n * cached transform on every CSS edit — so the bundle rebuilds with\n * the new theme automatically on the next request.\n * @returns Cache-key segment that includes rnwind's current theme hash.\n */\nexport function getCacheKey(): string {\n  const upstreamKey = loadUpstreamCacheKey()\n  const ownKey = getRnwindCacheKey()\n  return upstreamKey ? `${upstreamKey}|${ownKey}` : ownKey\n}\n\n/** Test-only — drop the cached upstream so a new env var picks up next call. */\nexport function __resetUpstreamCache(): void {\n  cachedUpstream = null\n}\n"],"names":[],"mappings":"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"}

package/lib/esm/metro/with-config.d.ts

@@ -10,35 +10,20 @@ export interface RnwindMetroOptions {
     /** Cache directory. Absolute, or relative to `projectRoot`. Default: `.rnwind` at project root. */
     cacheDir?: string;
     /**
-     * Extra JSX prop-name prefixes that rnwind should rewrite. Each
-     * prefix `P` turns `<Tag PClassName="…">` into `<Tag
-     * PStyle={lookupCss(…)}>`. The built-in `'contentContainer'` prefix
-     * is always on (covers ScrollView / FlatList / SectionList); user
-     * entries merge on top.
-     */
-    classNamePrefixes?: readonly string[];
-    /**
-     * Extra module specifiers whose JSX exports rnwind should treat as
-     * "host components" — i.e. tags whose `className="…"` attribute is
-     * rewritten to `style={lookupCss(…)}` at build time (zero runtime
-     * cost). Merged with the built-in defaults: `react-native`,
+     * Extra module specifiers whose component exports rnwind should
+     * auto-wrap at import sites — `import { View } from 'react-native'`
+     * becomes `const View = wrap(_rnw0)` so `<View className="…">` resolves
+     * styles at runtime. Merged with the built-in defaults: `react-native`,
      * `react-native-reanimated`, `react-native-svg`,
-     * `react-native-gesture-handler`, `expo-linear-gradient`, `expo-image`.
+     * `react-native-gesture-handler`, `react-native-safe-area-context`,
+     * `expo-linear-gradient`, `expo-image`, and more.
      *
-     * Anything NOT marked as a host has its `className` left untouched —
-     * the importing component receives the raw string and decides what
-     * to do with it. Use this option to opt your design-system / UI
-     * primitive packages into the zero-runtime path.
-     */
-    hostSources?: readonly string[];
-    /**
-     * Extra JSX tag names (verbatim — may include `.` for member access
-     * like `'Animated.View'`) rnwind should treat as host components,
-     * regardless of where they're imported from. Useful for one-off
-     * escape-hatches: `import { View as MyBox } from 'react-native'`
-     * doesn't change the local name → `'MyBox'` here picks it up.
+     * A module NOT in this list keeps its raw imports — the importing
+     * component receives `className` as a plain prop and can resolve it
+     * via `useCss` / `wrap` itself. Use this to opt your design-system /
+     * UI primitive packages into the auto-wrap path.
      */
-    hostComponents?: readonly string[];
+    wrapModules?: readonly string[];
 }
 /** Shape we mutate on Metro's config. Loose so we don't pin Metro's internal types. */
 export interface MetroConfigLike {

package/lib/esm/metro/with-config.mjs

@@ -147,7 +147,7 @@ function withRnwindConfig(metroConfig, options) {
     const cssEntry = path.isAbsolute(options.cssEntryFile) ? options.cssEntryFile : path.resolve(projectRoot, options.cssEntryFile);
     mkdirSync(cacheDir, { recursive: true });
     const watchFolders = (metroConfig.watchFolders ?? []).filter((p) => typeof p === 'string' && p.length > 0);
-    configureRnwindState(cssEntry, cacheDir, watchFolders, options.classNamePrefixes, options.hostSources, options.hostComponents);
+    configureRnwindState(cssEntry, cacheDir, watchFolders, options.wrapModules);
     // Warm the state eagerly (in the Metro master process) so oxide's
     // Scanner walks every project source (and every monorepo
     // watch-folder) ONCE and the manifest + scheme files hold the
@@ -180,7 +180,7 @@ function withRnwindConfig(metroConfig, options) {
     if (options.dtsFile !== false) {
         const dtsPath = options.dtsFile ?? path.resolve(projectRoot, 'rnwind-types.d.ts');
         const schemes = discoverSchemes(cssEntry, projectRoot);
-        writeDtsFile(dtsPath, schemes, options.classNamePrefixes);
+        writeDtsFile(dtsPath, schemes);
     }
     // Watch the theme CSS. On edit, we rewrite scheme files AND touch
     // mtime on every transformed source file so Metro invalidates them

package/lib/esm/metro/with-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"with-config.mjs","sources":["../../../../src/metro/with-config.ts"],"sourcesContent":["import { existsSync, mkdirSync, utimesSync, watch as watchFile } from 'node:fs'\nimport path from 'node:path'\nimport { writeDtsFile } from './dts'\nimport { createRnwindResolver, type ResolveRequestFn } from './resolver'\nimport { configureRnwindState, getRnwindState, onThemeChange } from './state'\n\n/** Default cache directory at the project root. Visible for debugging. */\nconst DEFAULT_CACHE_DIR = '.rnwind'\n\n/**\n * Active CSS watcher — replaced (and the prior one closed) when\n * `withRnwindConfig` is called again (Metro restart, repeated init).\n * Only one watcher per process; no stacking.\n */\nlet activeCssWatcher: { cssPath: string; close: () => void } | null = null\n\n/**\n * Watch the theme CSS for edits. On change, rewrite the per-scheme\n * files with the fresh theme AND bump `mtime` on every source file\n * rnwind has transformed so far — Metro's own watcher sees those\n * mtime changes, invalidates the modules, and re-transforms them\n * against the new CSS on the next request. `getCacheKey()` alone is\n * NOT enough: Metro samples the cache key once per worker lifetime,\n * so edits during an already-running dev server don't propagate\n * without this explicit nudge.\n * @param cssPath Absolute path to the theme CSS to watch.\n * @param projectRoot Metro's project root (for `getRnwindState`).\n */\nfunction watchThemeCss(cssPath: string, projectRoot: string): void {\n  if (activeCssWatcher?.cssPath === cssPath) return\n  activeCssWatcher?.close()\n  if (!existsSync(cssPath)) return\n  let pending = false\n  const watcher = watchFile(cssPath, { persistent: false }, () => {\n    // Debounce: editors often emit 2-3 change events per save (atomic\n    // rename dance, tmp files). Coalesce to ONE rebuild per microtask.\n    if (pending) return\n    pending = true\n    queueMicrotask(async () => {\n      pending = false\n      try {\n        await onThemeChange(projectRoot)\n        touchRecordedFiles(projectRoot)\n      } catch {\n        // Invalidation is best-effort — never crash the dev server.\n      }\n    })\n  })\n  activeCssWatcher = { cssPath, close: () => watcher.close() }\n}\n\n/**\n * Bump the mtime on every file the builder has transformed. Metro's\n * file watcher keys on `mtime`, so this is what makes it invalidate\n * those modules and re-transform them.\n * @param projectRoot Metro's project root.\n */\nfunction touchRecordedFiles(projectRoot: string): void {\n  const state = getRnwindState(projectRoot)\n  const files = state.builder.recordedFiles()\n  const now = new Date()\n  for (const file of files) {\n    try {\n      if (existsSync(file)) utimesSync(file, now, now)\n    } catch {\n      // One file's stat failure shouldn't stop the others.\n    }\n  }\n}\n\n/**\n * Where the rnwind babel transformer lives — resolved relative to this\n * module so the path works from both the `src/` tree (tests) and the\n * built `lib/` output. Tries a few extensions because `require.resolve`\n * doesn't auto-find `.cjs` / `.mjs` from a bare specifier.\n * @returns Absolute path to the rnwind transformer module.\n */\nfunction transformerPath(): string {\n  for (const candidate of ['./transformer.cjs', './transformer.mjs', './transformer.js', './transformer.ts', './transformer']) {\n    try {\n      return require.resolve(candidate)\n    } catch {\n      // try the next extension\n    }\n  }\n  throw new Error('rnwind: could not resolve the metro transformer path')\n}\n\n/**\n * Resolve the effective cache directory, honoring a user override and\n * falling back to `<projectRoot>/.rnwind`.\n * @param projectRoot Anchor for relative paths.\n * @param override User-supplied option.\n * @returns Absolute cache directory.\n */\nfunction resolveCacheDir(projectRoot: string, override: string | undefined): string {\n  if (!override || override.length === 0) return path.resolve(projectRoot, DEFAULT_CACHE_DIR)\n  return path.isAbsolute(override) ? override : path.resolve(projectRoot, override)\n}\n\n/**\n * Read the theme CSS and extract `@variant <name>` blocks for the .d.ts\n * generator. Forces construction of `getRnwindState`, then reads\n * `parser.declaredSchemes` (populated synchronously at construction).\n * @param cssEntry Absolute path to theme CSS.\n * @param projectRoot\n * @returns Scheme names (empty when the theme has no variants; `'base'` is filtered).\n */\nfunction discoverSchemes(cssEntry: string, projectRoot: string): readonly string[] {\n  if (!existsSync(cssEntry)) return []\n  try {\n    const { parser } = getRnwindState(projectRoot)\n    return parser.declaredSchemes.filter((name) => name !== 'base')\n  } catch {\n    return []\n  }\n}\n\n/** User-facing options for `withRnwindConfig`. */\nexport interface RnwindMetroOptions {\n  /** Path to the theme CSS (absolute or relative to `projectRoot`). Required. */\n  cssEntryFile: string\n  /** Where rnwind writes the `.d.ts` file. Set `false` to disable. Defaults to `<projectRoot>/rnwind-types.d.ts`. */\n  dtsFile?: string | false\n  /** Optional project-root override — defaults to `metroConfig.projectRoot` then `process.cwd()`. */\n  projectRoot?: string\n  /** Cache directory. Absolute, or relative to `projectRoot`. Default: `.rnwind` at project root. */\n  cacheDir?: string\n  /**\n   * Extra JSX prop-name prefixes that rnwind should rewrite. Each\n   * prefix `P` turns `<Tag PClassName=\"…\">` into `<Tag\n   * PStyle={lookupCss(…)}>`. The built-in `'contentContainer'` prefix\n   * is always on (covers ScrollView / FlatList / SectionList); user\n   * entries merge on top.\n   */\n  classNamePrefixes?: readonly string[]\n  /**\n   * Extra module specifiers whose JSX exports rnwind should treat as\n   * \"host components\" — i.e. tags whose `className=\"…\"` attribute is\n   * rewritten to `style={lookupCss(…)}` at build time (zero runtime\n   * cost). Merged with the built-in defaults: `react-native`,\n   * `react-native-reanimated`, `react-native-svg`,\n   * `react-native-gesture-handler`, `expo-linear-gradient`, `expo-image`.\n   *\n   * Anything NOT marked as a host has its `className` left untouched —\n   * the importing component receives the raw string and decides what\n   * to do with it. Use this option to opt your design-system / UI\n   * primitive packages into the zero-runtime path.\n   */\n  hostSources?: readonly string[]\n  /**\n   * Extra JSX tag names (verbatim — may include `.` for member access\n   * like `'Animated.View'`) rnwind should treat as host components,\n   * regardless of where they're imported from. Useful for one-off\n   * escape-hatches: `import { View as MyBox } from 'react-native'`\n   * doesn't change the local name → `'MyBox'` here picks it up.\n   */\n  hostComponents?: readonly string[]\n}\n\n/** Shape we mutate on Metro's config. Loose so we don't pin Metro's internal types. */\nexport interface MetroConfigLike {\n  projectRoot?: string\n  watchFolders?: string[]\n  transformer?: {\n    babelTransformerPath?: string\n    [key: string]: unknown\n  }\n  resolver?: {\n    resolveRequest?: ResolveRequestFn | null\n    [key: string]: unknown\n  }\n  [key: string]: unknown\n}\n\n/**\n * Wrap a Metro config with rnwind's pipeline:\n *  - Install the rnwind babel transformer.\n *  - Chain a `resolveRequest` hook that serves\n *    `rnwind/__generated/schemes` from `<cacheDir>/schemes.js`.\n *  - Write the `.d.ts` so TypeScript accepts `className=` on RN components.\n *  - Publish the theme CSS path + cache dir via env so Metro workers\n *    can rebuild their local state.\n *  - Ensure the cache dir is a watched folder Metro's haste-map indexes.\n *\n * Theme-edit hot reload happens implicitly: every transformed file\n * imports `rnwind/__generated/schemes`, and that module eager-imports\n * `common.style.js`. When the theme changes, the per-scheme files\n * regenerate with new bytes; Metro's content SHA1 dedup detects the\n * change and invalidates every importer automatically.\n * `getCacheKey()` on the transformer covers the per-file transform\n * cache. No file watcher / source-padding hack needed — the dep graph\n * carries the signal.\n * @param metroConfig Config from `getDefaultConfig(__dirname)` or equivalent.\n * @param options rnwind options.\n * @returns The same config, mutated.\n */\nexport function withRnwindConfig<C extends MetroConfigLike>(metroConfig: C, options: RnwindMetroOptions): C {\n  const projectRoot = options.projectRoot ?? metroConfig.projectRoot ?? process.cwd()\n  const cacheDir = resolveCacheDir(projectRoot, options.cacheDir)\n  const cssEntry = path.isAbsolute(options.cssEntryFile) ? options.cssEntryFile : path.resolve(projectRoot, options.cssEntryFile)\n\n  mkdirSync(cacheDir, { recursive: true })\n  const watchFolders = (metroConfig.watchFolders ?? []).filter((p) => typeof p === 'string' && p.length > 0)\n  configureRnwindState(cssEntry, cacheDir, watchFolders, options.classNamePrefixes, options.hostSources, options.hostComponents)\n\n  // Warm the state eagerly (in the Metro master process) so oxide's\n  // Scanner walks every project source (and every monorepo\n  // watch-folder) ONCE and the manifest + scheme files hold the\n  // complete union before Metro's resolver tries to SHA1 them on the\n  // first transform. Each worker lazy-repeats this scan on its first\n  // transform to converge on identical state.\n  try {\n    void getRnwindState(projectRoot).builder.ensureFilesExist()\n  } catch {\n    // Any init error surfaces again at the first transform; don't crash Metro boot.\n  }\n\n  // Install transformer + resolver. Capture the existing\n  // babelTransformerPath BEFORE we override it — our worker chains to\n  // it (env-passed) so Flow / expo-router / babel-preset-expo etc. all\n  // continue to run.\n  const existingTransformerPath = metroConfig.transformer?.babelTransformerPath\n  if (typeof existingTransformerPath === 'string' && existingTransformerPath.length > 0) {\n    process.env.RNWIND_UPSTREAM_TRANSFORMER = existingTransformerPath\n  }\n  const upstream = metroConfig.resolver?.resolveRequest ?? null\n  metroConfig.transformer = { ...metroConfig.transformer, babelTransformerPath: transformerPath() }\n  metroConfig.resolver = { ...metroConfig.resolver, resolveRequest: createRnwindResolver(upstream) }\n\n  // Metro's haste-map indexes `watchFolders` at startup. Adding the\n  // cache dir guarantees scheme style files + manifest get SHA1'd\n  // without a \"Failed to get the SHA-1\" race when the first transform\n  // writes them.\n  const existingWatch = metroConfig.watchFolders ?? []\n  metroConfig.watchFolders = existingWatch.includes(cacheDir) ? existingWatch : [...existingWatch, cacheDir]\n\n  if (options.dtsFile !== false) {\n    const dtsPath = options.dtsFile ?? path.resolve(projectRoot, 'rnwind-types.d.ts')\n    const schemes = discoverSchemes(cssEntry, projectRoot)\n    writeDtsFile(dtsPath, schemes, options.classNamePrefixes)\n  }\n\n  // Watch the theme CSS. On edit, we rewrite scheme files AND touch\n  // mtime on every transformed source file so Metro invalidates them\n  // and re-transforms — the only reliable way to propagate theme\n  // changes to an already-running dev server.\n  watchThemeCss(cssEntry, projectRoot)\n\n  return metroConfig\n}\n"],"names":["watchFile"],"mappings":"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"}
+{"version":3,"file":"with-config.mjs","sources":["../../../../src/metro/with-config.ts"],"sourcesContent":["import { existsSync, mkdirSync, utimesSync, watch as watchFile } from 'node:fs'\nimport path from 'node:path'\nimport { writeDtsFile } from './dts'\nimport { createRnwindResolver, type ResolveRequestFn } from './resolver'\nimport { configureRnwindState, getRnwindState, onThemeChange } from './state'\n\n/** Default cache directory at the project root. Visible for debugging. */\nconst DEFAULT_CACHE_DIR = '.rnwind'\n\n/**\n * Active CSS watcher — replaced (and the prior one closed) when\n * `withRnwindConfig` is called again (Metro restart, repeated init).\n * Only one watcher per process; no stacking.\n */\nlet activeCssWatcher: { cssPath: string; close: () => void } | null = null\n\n/**\n * Watch the theme CSS for edits. On change, rewrite the per-scheme\n * files with the fresh theme AND bump `mtime` on every source file\n * rnwind has transformed so far — Metro's own watcher sees those\n * mtime changes, invalidates the modules, and re-transforms them\n * against the new CSS on the next request. `getCacheKey()` alone is\n * NOT enough: Metro samples the cache key once per worker lifetime,\n * so edits during an already-running dev server don't propagate\n * without this explicit nudge.\n * @param cssPath Absolute path to the theme CSS to watch.\n * @param projectRoot Metro's project root (for `getRnwindState`).\n */\nfunction watchThemeCss(cssPath: string, projectRoot: string): void {\n  if (activeCssWatcher?.cssPath === cssPath) return\n  activeCssWatcher?.close()\n  if (!existsSync(cssPath)) return\n  let pending = false\n  const watcher = watchFile(cssPath, { persistent: false }, () => {\n    // Debounce: editors often emit 2-3 change events per save (atomic\n    // rename dance, tmp files). Coalesce to ONE rebuild per microtask.\n    if (pending) return\n    pending = true\n    queueMicrotask(async () => {\n      pending = false\n      try {\n        await onThemeChange(projectRoot)\n        touchRecordedFiles(projectRoot)\n      } catch {\n        // Invalidation is best-effort — never crash the dev server.\n      }\n    })\n  })\n  activeCssWatcher = { cssPath, close: () => watcher.close() }\n}\n\n/**\n * Bump the mtime on every file the builder has transformed. Metro's\n * file watcher keys on `mtime`, so this is what makes it invalidate\n * those modules and re-transform them.\n * @param projectRoot Metro's project root.\n */\nfunction touchRecordedFiles(projectRoot: string): void {\n  const state = getRnwindState(projectRoot)\n  const files = state.builder.recordedFiles()\n  const now = new Date()\n  for (const file of files) {\n    try {\n      if (existsSync(file)) utimesSync(file, now, now)\n    } catch {\n      // One file's stat failure shouldn't stop the others.\n    }\n  }\n}\n\n/**\n * Where the rnwind babel transformer lives — resolved relative to this\n * module so the path works from both the `src/` tree (tests) and the\n * built `lib/` output. Tries a few extensions because `require.resolve`\n * doesn't auto-find `.cjs` / `.mjs` from a bare specifier.\n * @returns Absolute path to the rnwind transformer module.\n */\nfunction transformerPath(): string {\n  for (const candidate of ['./transformer.cjs', './transformer.mjs', './transformer.js', './transformer.ts', './transformer']) {\n    try {\n      return require.resolve(candidate)\n    } catch {\n      // try the next extension\n    }\n  }\n  throw new Error('rnwind: could not resolve the metro transformer path')\n}\n\n/**\n * Resolve the effective cache directory, honoring a user override and\n * falling back to `<projectRoot>/.rnwind`.\n * @param projectRoot Anchor for relative paths.\n * @param override User-supplied option.\n * @returns Absolute cache directory.\n */\nfunction resolveCacheDir(projectRoot: string, override: string | undefined): string {\n  if (!override || override.length === 0) return path.resolve(projectRoot, DEFAULT_CACHE_DIR)\n  return path.isAbsolute(override) ? override : path.resolve(projectRoot, override)\n}\n\n/**\n * Read the theme CSS and extract `@variant <name>` blocks for the .d.ts\n * generator. Forces construction of `getRnwindState`, then reads\n * `parser.declaredSchemes` (populated synchronously at construction).\n * @param cssEntry Absolute path to theme CSS.\n * @param projectRoot\n * @returns Scheme names (empty when the theme has no variants; `'base'` is filtered).\n */\nfunction discoverSchemes(cssEntry: string, projectRoot: string): readonly string[] {\n  if (!existsSync(cssEntry)) return []\n  try {\n    const { parser } = getRnwindState(projectRoot)\n    return parser.declaredSchemes.filter((name) => name !== 'base')\n  } catch {\n    return []\n  }\n}\n\n/** User-facing options for `withRnwindConfig`. */\nexport interface RnwindMetroOptions {\n  /** Path to the theme CSS (absolute or relative to `projectRoot`). Required. */\n  cssEntryFile: string\n  /** Where rnwind writes the `.d.ts` file. Set `false` to disable. Defaults to `<projectRoot>/rnwind-types.d.ts`. */\n  dtsFile?: string | false\n  /** Optional project-root override — defaults to `metroConfig.projectRoot` then `process.cwd()`. */\n  projectRoot?: string\n  /** Cache directory. Absolute, or relative to `projectRoot`. Default: `.rnwind` at project root. */\n  cacheDir?: string\n  /**\n   * Extra module specifiers whose component exports rnwind should\n   * auto-wrap at import sites — `import { View } from 'react-native'`\n   * becomes `const View = wrap(_rnw0)` so `<View className=\"…\">` resolves\n   * styles at runtime. Merged with the built-in defaults: `react-native`,\n   * `react-native-reanimated`, `react-native-svg`,\n   * `react-native-gesture-handler`, `react-native-safe-area-context`,\n   * `expo-linear-gradient`, `expo-image`, and more.\n   *\n   * A module NOT in this list keeps its raw imports — the importing\n   * component receives `className` as a plain prop and can resolve it\n   * via `useCss` / `wrap` itself. Use this to opt your design-system /\n   * UI primitive packages into the auto-wrap path.\n   */\n  wrapModules?: readonly string[]\n}\n\n/** Shape we mutate on Metro's config. Loose so we don't pin Metro's internal types. */\nexport interface MetroConfigLike {\n  projectRoot?: string\n  watchFolders?: string[]\n  transformer?: {\n    babelTransformerPath?: string\n    [key: string]: unknown\n  }\n  resolver?: {\n    resolveRequest?: ResolveRequestFn | null\n    [key: string]: unknown\n  }\n  [key: string]: unknown\n}\n\n/**\n * Wrap a Metro config with rnwind's pipeline:\n *  - Install the rnwind babel transformer.\n *  - Chain a `resolveRequest` hook that serves\n *    `rnwind/__generated/schemes` from `<cacheDir>/schemes.js`.\n *  - Write the `.d.ts` so TypeScript accepts `className=` on RN components.\n *  - Publish the theme CSS path + cache dir via env so Metro workers\n *    can rebuild their local state.\n *  - Ensure the cache dir is a watched folder Metro's haste-map indexes.\n *\n * Theme-edit hot reload happens implicitly: every transformed file\n * imports `rnwind/__generated/schemes`, and that module eager-imports\n * `common.style.js`. When the theme changes, the per-scheme files\n * regenerate with new bytes; Metro's content SHA1 dedup detects the\n * change and invalidates every importer automatically.\n * `getCacheKey()` on the transformer covers the per-file transform\n * cache. No file watcher / source-padding hack needed — the dep graph\n * carries the signal.\n * @param metroConfig Config from `getDefaultConfig(__dirname)` or equivalent.\n * @param options rnwind options.\n * @returns The same config, mutated.\n */\nexport function withRnwindConfig<C extends MetroConfigLike>(metroConfig: C, options: RnwindMetroOptions): C {\n  const projectRoot = options.projectRoot ?? metroConfig.projectRoot ?? process.cwd()\n  const cacheDir = resolveCacheDir(projectRoot, options.cacheDir)\n  const cssEntry = path.isAbsolute(options.cssEntryFile) ? options.cssEntryFile : path.resolve(projectRoot, options.cssEntryFile)\n\n  mkdirSync(cacheDir, { recursive: true })\n  const watchFolders = (metroConfig.watchFolders ?? []).filter((p) => typeof p === 'string' && p.length > 0)\n  configureRnwindState(cssEntry, cacheDir, watchFolders, options.wrapModules)\n\n  // Warm the state eagerly (in the Metro master process) so oxide's\n  // Scanner walks every project source (and every monorepo\n  // watch-folder) ONCE and the manifest + scheme files hold the\n  // complete union before Metro's resolver tries to SHA1 them on the\n  // first transform. Each worker lazy-repeats this scan on its first\n  // transform to converge on identical state.\n  try {\n    void getRnwindState(projectRoot).builder.ensureFilesExist()\n  } catch {\n    // Any init error surfaces again at the first transform; don't crash Metro boot.\n  }\n\n  // Install transformer + resolver. Capture the existing\n  // babelTransformerPath BEFORE we override it — our worker chains to\n  // it (env-passed) so Flow / expo-router / babel-preset-expo etc. all\n  // continue to run.\n  const existingTransformerPath = metroConfig.transformer?.babelTransformerPath\n  if (typeof existingTransformerPath === 'string' && existingTransformerPath.length > 0) {\n    process.env.RNWIND_UPSTREAM_TRANSFORMER = existingTransformerPath\n  }\n  const upstream = metroConfig.resolver?.resolveRequest ?? null\n  metroConfig.transformer = { ...metroConfig.transformer, babelTransformerPath: transformerPath() }\n  metroConfig.resolver = { ...metroConfig.resolver, resolveRequest: createRnwindResolver(upstream) }\n\n  // Metro's haste-map indexes `watchFolders` at startup. Adding the\n  // cache dir guarantees scheme style files + manifest get SHA1'd\n  // without a \"Failed to get the SHA-1\" race when the first transform\n  // writes them.\n  const existingWatch = metroConfig.watchFolders ?? []\n  metroConfig.watchFolders = existingWatch.includes(cacheDir) ? existingWatch : [...existingWatch, cacheDir]\n\n  if (options.dtsFile !== false) {\n    const dtsPath = options.dtsFile ?? path.resolve(projectRoot, 'rnwind-types.d.ts')\n    const schemes = discoverSchemes(cssEntry, projectRoot)\n    writeDtsFile(dtsPath, schemes)\n  }\n\n  // Watch the theme CSS. On edit, we rewrite scheme files AND touch\n  // mtime on every transformed source file so Metro invalidates them\n  // and re-transforms — the only reliable way to propagate theme\n  // changes to an already-running dev server.\n  watchThemeCss(cssEntry, projectRoot)\n\n  return metroConfig\n}\n"],"names":["watchFile"],"mappings":"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"}

package/lib/esm/metro/wrap-imports.d.ts

@@ -0,0 +1,26 @@
+import type { File } from '@babel/types';
+/** Per-module policy: an explicit allow-list, or `'all'` named exports. */
+export type WrapPolicy = 'all' | ReadonlySet<string>;
+/**
+ * Default module → wrap policy. react-native is allow-listed (mixed
+ * exports); the rest are component-only packages → `'all'`. Only modules
+ * the project has installed are ever hit (you can't import from a missing
+ * package), so listing optional peers is free.
+ */
+export declare const DEFAULT_WRAP_MODULES: ReadonlyMap<string, WrapPolicy>;
+/**
+ * Merge user-supplied wrap modules onto the defaults — a bare module name
+ * adopts the `'all'` policy.
+ * @param extra User module specifiers (or undefined).
+ * @returns Effective module → policy map.
+ */
+export declare function buildWrapModules(extra?: readonly string[]): ReadonlyMap<string, WrapPolicy>;
+/**
+ * Rewrite component imports from the configured wrap-modules into
+ * `wrap()`-ed bindings, in place. Injects the `wrap` import once when any
+ * binding was rewritten.
+ * @param ast Parsed Babel file (mutated).
+ * @param modules Effective module → policy map.
+ * @returns True when at least one import was wrapped.
+ */
+export declare function rewriteWrapImports(ast: File, modules: ReadonlyMap<string, WrapPolicy>): boolean;