rnwind 0.0.4 → 0.0.6

package/lib/esm/metro/state.mjs

@@ -4,6 +4,7 @@ import { createHash } from 'node:crypto';
 import { UnionBuilder } from '../core/style-builder/union-builder.mjs';
 import { TailwindParser } from '../core/parser/tw-parser.mjs';
 import { resolveThemeCss } from './css-imports.mjs';
+import { buildWrapModules } from './wrap-imports.mjs';
 
 /**
  * Default oxide Scanner globs — walk every JS/TS source under the
@@ -48,12 +49,8 @@ const CSS_ENTRY_ENV = 'RNWIND_CSS_ENTRY_FILE';
 const CACHE_DIR_ENV = 'RNWIND_CACHE_DIR';
 /** Env var carrying `watchFolders` from Metro config (NUL-separated). */
 const WATCH_FOLDERS_ENV = 'RNWIND_WATCH_FOLDERS';
-/** Env var carrying extra className prefixes the Metro config supplied. */
-const CLASSNAME_PREFIXES_ENV = 'RNWIND_CLASSNAME_PREFIXES';
-/** Env var carrying extra import sources whose JSX exports get className→style rewrites. Comma-separated. */
-const HOST_SOURCES_ENV = 'RNWIND_HOST_SOURCES';
-/** Env var carrying extra JSX tag names (verbatim, may contain `.`) treated as hosts. Comma-separated. */
-const HOST_COMPONENTS_ENV = 'RNWIND_HOST_COMPONENTS';
+/** Env var carrying extra modules whose component exports get `wrap()`-ed. Comma-separated. */
+const WRAP_MODULES_ENV = 'RNWIND_WRAP_MODULES';
 /** Memoised library fingerprint — read once per worker process. */
 let libraryFingerprint;
 /** Live state shared across one Metro transform worker. */
@@ -83,10 +80,10 @@ function readThemeHashFor(cssPath) {
  * dev OR npm install of a new version) the file bytes change, the
  * fingerprint rotates, and Metro's transform cache invalidates.
  *
- * Includes the JSX rewriter (`transform-ast`) alongside the parser /
- * style-builder so a change to the transformer — e.g. renaming the
- * injected context hook — invalidates every stale per-file cache entry
- * on the next dev run. Without this, a user upgrading rnwind in-place
+ * Includes the import-rewriter (`wrap-imports`) and runtime resolver
+ * alongside the parser / style-builder so a change to the transformer —
+ * e.g. renaming the injected wrap helper — invalidates every stale
+ * per-file cache entry on the next dev run. Without this, a user upgrading rnwind in-place
  * would keep loading the old transformed bytes; React-refresh would
  * then preserve fiber state across the version bump and the rendered
  * hook list could shift, surfacing as "change in the order of Hooks"
@@ -103,14 +100,14 @@ function getLibraryFingerprint() {
         path.resolve(here, '..', 'core', 'style-builder', 'build-style.cjs'),
         path.resolve(here, '..', 'core', 'parser', 'tw-parser.mjs'),
         path.resolve(here, '..', 'core', 'parser', 'tw-parser.cjs'),
-        path.resolve(here, 'transform-ast.mjs'),
-        path.resolve(here, 'transform-ast.cjs'),
+        path.resolve(here, 'wrap-imports.mjs'),
+        path.resolve(here, 'wrap-imports.cjs'),
         path.resolve(here, 'transformer.mjs'),
         path.resolve(here, 'transformer.cjs'),
         // Source-tree fallback for tests + workspace dev (no built lib yet).
         path.resolve(here, '..', '..', 'src', 'core', 'style-builder', 'build-style.ts'),
         path.resolve(here, '..', '..', 'src', 'core', 'parser', 'tw-parser.ts'),
-        path.resolve(here, '..', '..', 'src', 'metro', 'transform-ast.ts'),
+        path.resolve(here, '..', '..', 'src', 'metro', 'wrap-imports.ts'),
         path.resolve(here, '..', '..', 'src', 'metro', 'transformer.ts'),
     ];
     const hash = createHash('sha256');
@@ -135,12 +132,10 @@ function getLibraryFingerprint() {
  * can rebuild the same state without re-reading the Metro config.
  * @param cssEntryFile Absolute path to the user's theme CSS.
  * @param cacheDir Absolute path to the cache dir (`.rnwind`).
- * @param watchFolders
- * @param classNamePrefixes Extra JSX prop-name prefixes to rewrite.
- * @param hostSources
- * @param hostComponents
+ * @param watchFolders Monorepo watch folders to scan for atoms.
+ * @param wrapModules Extra modules whose component exports get `wrap()`-ed.
  */
-function configureRnwindState(cssEntryFile, cacheDir, watchFolders = [], classNamePrefixes, hostSources, hostComponents) {
+function configureRnwindState(cssEntryFile, cacheDir, watchFolders = [], wrapModules) {
     process.env[CSS_ENTRY_ENV] = cssEntryFile;
     process.env[CACHE_DIR_ENV] = cacheDir;
     if (watchFolders.length === 0) {
@@ -149,62 +144,23 @@ function configureRnwindState(cssEntryFile, cacheDir, watchFolders = [], classNa
     else {
         process.env[WATCH_FOLDERS_ENV] = watchFolders.join('\0');
     }
-    if (!classNamePrefixes || classNamePrefixes.length === 0) {
-        delete process.env[CLASSNAME_PREFIXES_ENV];
+    if (!wrapModules || wrapModules.length === 0) {
+        delete process.env[WRAP_MODULES_ENV];
     }
     else {
-        process.env[CLASSNAME_PREFIXES_ENV] = classNamePrefixes.join(',');
-    }
-    if (!hostSources || hostSources.length === 0) {
-        delete process.env[HOST_SOURCES_ENV];
-    }
-    else {
-        process.env[HOST_SOURCES_ENV] = hostSources.join(',');
-    }
-    if (!hostComponents || hostComponents.length === 0) {
-        delete process.env[HOST_COMPONENTS_ENV];
-    }
-    else {
-        process.env[HOST_COMPONENTS_ENV] = hostComponents.join(',');
+        process.env[WRAP_MODULES_ENV] = wrapModules.join(',');
     }
     cached = null;
 }
 /**
- * Read the caller-configured extra className prefixes out of the
- * worker environment. Returns an empty array when unset — the
- * transformer applies the built-in `contentContainer` default on top
- * either way.
- * @returns User-supplied extra prefixes.
- */
-function getClassNamePrefixes() {
-    const raw = process.env[CLASSNAME_PREFIXES_ENV];
-    if (!raw || raw.length === 0)
-        return [];
-    return raw.split(',').filter((entry) => entry.length > 0);
-}
-/**
- * Read the caller-configured extra host module sources out of the
- * worker environment. Empty array when unset — the transformer applies
- * its built-in default list on top either way.
- * @returns User-supplied extra host sources.
+ * Effective module → wrap-policy map: the built-in defaults merged with
+ * any extra modules the Metro config supplied.
+ * @returns Module → policy map the import-rewrite consults.
  */
-function getHostSources() {
-    const raw = process.env[HOST_SOURCES_ENV];
-    if (!raw || raw.length === 0)
-        return [];
-    return raw.split(',').filter((entry) => entry.length > 0);
-}
-/**
- * Read the caller-configured extra host JSX tag names out of the worker
- * environment. Verbatim names — may include `.` for member expressions
- * like `'Animated.View'`.
- * @returns User-supplied extra host component names.
- */
-function getHostComponents() {
-    const raw = process.env[HOST_COMPONENTS_ENV];
-    if (!raw || raw.length === 0)
-        return [];
-    return raw.split(',').filter((entry) => entry.length > 0);
+function getWrapModules() {
+    const raw = process.env[WRAP_MODULES_ENV];
+    const extra = raw && raw.length > 0 ? raw.split(',').filter((entry) => entry.length > 0) : undefined;
+    return buildWrapModules(extra);
 }
 /**
  * Fetch (or build) the worker-local rnwind state. Re-reads the theme
@@ -246,14 +202,12 @@ function getRnwindState(projectRoot) {
  */
 function getRnwindCacheKey() {
     const cssEntry = process.env[CSS_ENTRY_ENV] ?? '';
-    const prefixes = process.env[CLASSNAME_PREFIXES_ENV] ?? '';
-    // Host source / component config changes which JSX tags get rewritten,
-    // so it MUST flip the cache key — otherwise Metro replays stale
-    // transforms (a newly-opted-in host keeps its raw className, a removed
-    // one keeps the rewrite).
-    const hostSources = process.env[HOST_SOURCES_ENV] ?? '';
-    const hostComponents = process.env[HOST_COMPONENTS_ENV] ?? '';
-    return `rnwind:${cssEntry}:${readThemeHashFor(cssEntry)}|lib:${getLibraryFingerprint()}|pfx:${prefixes}|hs:${hostSources}|hc:${hostComponents}`;
+    // Wrap-module config changes which import sites get `wrap()`-ed, so it
+    // MUST flip the cache key — otherwise Metro replays stale transforms
+    // (a newly-opted-in module keeps its raw import, a removed one keeps
+    // the wrap).
+    const wrapModules = process.env[WRAP_MODULES_ENV] ?? '';
+    return `rnwind:${cssEntry}:${readThemeHashFor(cssEntry)}|lib:${getLibraryFingerprint()}|wm:${wrapModules}`;
 }
 /** Drop the cached state — call after editing the theme CSS. */
 function resetRnwindState() {
@@ -287,5 +241,5 @@ function manifestPathFor() {
     return path.join(cacheDir, 'schemes.js');
 }
 
-export { configureRnwindState, getClassNamePrefixes, getHostComponents, getHostSources, getRnwindCacheKey, getRnwindState, manifestPathFor, onThemeChange, resetRnwindState };
+export { configureRnwindState, getRnwindCacheKey, getRnwindState, getWrapModules, manifestPathFor, onThemeChange, resetRnwindState };
 //# sourceMappingURL=state.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"state.mjs","sources":["../../../../src/metro/state.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport path from 'node:path'\nimport { createHash } from 'node:crypto'\nimport { UnionBuilder } from '../core/style-builder'\nimport { TailwindParser, type SourceEntry } from '../core/parser'\nimport { resolveThemeCss } from './css-imports'\n\n/**\n * Default oxide Scanner globs — walk every JS/TS source under the\n * project root AND every monorepo watch folder, excluding\n * `node_modules` and rnwind's own cache dir so we don't rescan\n * generated scheme files.\n *\n * Monorepo layouts (Yarn workspaces, pnpm workspaces, Nx) surface\n * sibling package roots as `metroConfig.watchFolders`. Every folder\n * Metro watches must also be scanned so atoms declared in shared UI\n * packages make it into the union — without this, only the app's\n * own files would be scanned and every UI-package atom would resolve\n * to `undefined` at runtime.\n * @param projectRoot Absolute project root.\n * @param cacheDir Absolute rnwind cache dir (to exclude).\n * @param watchFolders Extra monorepo roots Metro is watching.\n * @returns Scanner sources suitable for `parser.parseProject()`.\n */\nfunction defaultSources(projectRoot: string, cacheDir: string, watchFolders: readonly string[]): readonly SourceEntry[] {\n  const cacheBaseName = path.basename(cacheDir)\n  const roots = new Set<string>([projectRoot, ...watchFolders])\n  const sources: SourceEntry[] = []\n  for (const root of roots) {\n    sources.push({ base: root, pattern: '**/*.{ts,tsx,js,jsx}', negated: false }, { base: root, pattern: '**/node_modules/**', negated: true }, { base: root, pattern: `**/${cacheBaseName}/**`, negated: true })\n  }\n  return sources\n}\n\n/**\n * Read monorepo watch-folder paths out of the worker environment.\n * Empty array when the host isn't a monorepo.\n * @returns Absolute paths Metro also watches (sibling packages).\n */\nfunction readWatchFolders(): readonly string[] {\n  const raw = process.env[WATCH_FOLDERS_ENV]\n  if (!raw || raw.length === 0) return []\n  return raw.split('\\0').filter((entry) => entry.length > 0)\n}\n\n/** Env var Metro workers read to locate the theme CSS on disk. */\nconst CSS_ENTRY_ENV = 'RNWIND_CSS_ENTRY_FILE'\n/** Env var Metro workers read to locate the cache directory (`.rnwind`). */\nconst CACHE_DIR_ENV = 'RNWIND_CACHE_DIR'\n/** Env var carrying `watchFolders` from Metro config (NUL-separated). */\nconst WATCH_FOLDERS_ENV = 'RNWIND_WATCH_FOLDERS'\n/** Env var carrying extra className prefixes the Metro config supplied. */\nconst CLASSNAME_PREFIXES_ENV = 'RNWIND_CLASSNAME_PREFIXES'\n/** Env var carrying extra import sources whose JSX exports get className→style rewrites. Comma-separated. */\nconst HOST_SOURCES_ENV = 'RNWIND_HOST_SOURCES'\n/** Env var carrying extra JSX tag names (verbatim, may contain `.`) treated as hosts. Comma-separated. */\nconst HOST_COMPONENTS_ENV = 'RNWIND_HOST_COMPONENTS'\n\n/** Memoised library fingerprint — read once per worker process. */\nlet libraryFingerprint: string | undefined\n\n/** Live state shared across one Metro transform worker. */\nlet cached: RnwindState | null = null\n\n/**\n * Cheap content-hash readout. SHA-256 prefix of the FULLY-RESOLVED theme\n * CSS — `@import`s flattened — so an edit to a theme file the entry only\n * re-exports (`@import \"@acme/ui/theme.css\"`) still rotates the hash and\n * invalidates Metro's cache. Returns `'missing'` when the entry can't be\n * read so the cache key stays deterministic.\n * @param cssPath Absolute CSS path.\n * @returns 16-char hex content hash.\n */\nfunction readThemeHashFor(cssPath: string): string {\n  if (!existsSync(cssPath)) return 'missing'\n  try {\n    return createHash('sha256').update(resolveThemeCss(cssPath)).digest('hex').slice(0, 16)\n  } catch {\n    return 'missing'\n  }\n}\n\n/**\n * Hash a small set of rnwind library files whose changes affect the\n * generated transform output. When the library is rebuilt (workspace\n * dev OR npm install of a new version) the file bytes change, the\n * fingerprint rotates, and Metro's transform cache invalidates.\n *\n * Includes the JSX rewriter (`transform-ast`) alongside the parser /\n * style-builder so a change to the transformer — e.g. renaming the\n * injected context hook — invalidates every stale per-file cache entry\n * on the next dev run. Without this, a user upgrading rnwind in-place\n * would keep loading the old transformed bytes; React-refresh would\n * then preserve fiber state across the version bump and the rendered\n * hook list could shift, surfacing as \"change in the order of Hooks\"\n * runtime errors.\n * Memoised — read once per worker process.\n * @returns 16-char hex fingerprint.\n */\nfunction getLibraryFingerprint(): string {\n  if (libraryFingerprint !== undefined) return libraryFingerprint\n  const here = path.dirname(__filename)\n  const candidates = [\n    path.resolve(here, '..', 'core', 'style-builder', 'build-style.mjs'),\n    path.resolve(here, '..', 'core', 'style-builder', 'build-style.cjs'),\n    path.resolve(here, '..', 'core', 'parser', 'tw-parser.mjs'),\n    path.resolve(here, '..', 'core', 'parser', 'tw-parser.cjs'),\n    path.resolve(here, 'transform-ast.mjs'),\n    path.resolve(here, 'transform-ast.cjs'),\n    path.resolve(here, 'transformer.mjs'),\n    path.resolve(here, 'transformer.cjs'),\n    // Source-tree fallback for tests + workspace dev (no built lib yet).\n    path.resolve(here, '..', '..', 'src', 'core', 'style-builder', 'build-style.ts'),\n    path.resolve(here, '..', '..', 'src', 'core', 'parser', 'tw-parser.ts'),\n    path.resolve(here, '..', '..', 'src', 'metro', 'transform-ast.ts'),\n    path.resolve(here, '..', '..', 'src', 'metro', 'transformer.ts'),\n  ]\n  const hash = createHash('sha256')\n  let included = 0\n  for (const file of candidates) {\n    if (!existsSync(file)) continue\n    try {\n      hash.update(readFileSync(file))\n      included += 1\n    } catch {\n      // Unreadable file — skip; fingerprint still derives from whatever WE could read.\n    }\n  }\n  libraryFingerprint = included > 0 ? hash.digest('hex').slice(0, 16) : '0'.repeat(16)\n  return libraryFingerprint\n}\n\n/**\n * Worker-local state. Lazy-initialised on first access so files that\n * bypass the transform don't pay for construction.\n */\nexport interface RnwindState {\n  parser: TailwindParser\n  builder: UnionBuilder\n  themeCss: string\n  themeHash: string\n  projectRoot: string\n}\n\n/**\n * Publish the theme CSS path + cache dir to the environment so worker\n * subprocesses (spawned by Metro once `babelTransformerPath` is set)\n * can rebuild the same state without re-reading the Metro config.\n * @param cssEntryFile Absolute path to the user's theme CSS.\n * @param cacheDir Absolute path to the cache dir (`.rnwind`).\n * @param watchFolders\n * @param classNamePrefixes Extra JSX prop-name prefixes to rewrite.\n * @param hostSources\n * @param hostComponents\n */\nexport function configureRnwindState(\n  cssEntryFile: string,\n  cacheDir: string,\n  watchFolders: readonly string[] = [],\n  classNamePrefixes?: readonly string[],\n  hostSources?: readonly string[],\n  hostComponents?: readonly string[],\n): void {\n  process.env[CSS_ENTRY_ENV] = cssEntryFile\n  process.env[CACHE_DIR_ENV] = cacheDir\n  if (watchFolders.length === 0) {\n    delete process.env[WATCH_FOLDERS_ENV]\n  } else {\n    process.env[WATCH_FOLDERS_ENV] = watchFolders.join('\\0')\n  }\n  if (!classNamePrefixes || classNamePrefixes.length === 0) {\n    delete process.env[CLASSNAME_PREFIXES_ENV]\n  } else {\n    process.env[CLASSNAME_PREFIXES_ENV] = classNamePrefixes.join(',')\n  }\n  if (!hostSources || hostSources.length === 0) {\n    delete process.env[HOST_SOURCES_ENV]\n  } else {\n    process.env[HOST_SOURCES_ENV] = hostSources.join(',')\n  }\n  if (!hostComponents || hostComponents.length === 0) {\n    delete process.env[HOST_COMPONENTS_ENV]\n  } else {\n    process.env[HOST_COMPONENTS_ENV] = hostComponents.join(',')\n  }\n  cached = null\n}\n\n/**\n * Read the caller-configured extra className prefixes out of the\n * worker environment. Returns an empty array when unset — the\n * transformer applies the built-in `contentContainer` default on top\n * either way.\n * @returns User-supplied extra prefixes.\n */\nexport function getClassNamePrefixes(): readonly string[] {\n  const raw = process.env[CLASSNAME_PREFIXES_ENV]\n  if (!raw || raw.length === 0) return []\n  return raw.split(',').filter((entry) => entry.length > 0)\n}\n\n/**\n * Read the caller-configured extra host module sources out of the\n * worker environment. Empty array when unset — the transformer applies\n * its built-in default list on top either way.\n * @returns User-supplied extra host sources.\n */\nexport function getHostSources(): readonly string[] {\n  const raw = process.env[HOST_SOURCES_ENV]\n  if (!raw || raw.length === 0) return []\n  return raw.split(',').filter((entry) => entry.length > 0)\n}\n\n/**\n * Read the caller-configured extra host JSX tag names out of the worker\n * environment. Verbatim names — may include `.` for member expressions\n * like `'Animated.View'`.\n * @returns User-supplied extra host component names.\n */\nexport function getHostComponents(): readonly string[] {\n  const raw = process.env[HOST_COMPONENTS_ENV]\n  if (!raw || raw.length === 0) return []\n  return raw.split(',').filter((entry) => entry.length > 0)\n}\n\n/**\n * Fetch (or build) the worker-local rnwind state. Re-reads the theme\n * CSS hash on every call: if the user edited `global.css` while Metro\n * is running, the cached state is dropped and a fresh parser + ledger\n * is built. Combined with the `getCacheKey()` export on the\n * transformer (which folds the same hash into Metro's per-file cache\n * key) every CSS edit produces a full, correct re-bundle.\n * @param projectRoot\n * @returns The live rnwind state.\n */\nexport function getRnwindState(projectRoot: string): RnwindState {\n  const cssEntry = process.env[CSS_ENTRY_ENV]\n  const cacheDir = process.env[CACHE_DIR_ENV]\n  if (!cssEntry) throw new Error('rnwind: RNWIND_CSS_ENTRY_FILE is not set — did `withRnwindConfig` run?')\n  if (!cacheDir) throw new Error('rnwind: RNWIND_CACHE_DIR is not set — did `withRnwindConfig` run?')\n  const currentHash = readThemeHashFor(cssEntry)\n  if (cached?.themeHash === currentHash && cached.projectRoot === projectRoot) return cached\n  const themeCss = resolveThemeCss(cssEntry)\n  const parser = new TailwindParser({\n    themeCss,\n    sources: defaultSources(projectRoot, cacheDir, readWatchFolders()),\n  })\n  const builder = new UnionBuilder(cacheDir, parser)\n  cached = { parser, builder, themeCss, themeHash: currentHash, projectRoot }\n  return cached\n}\n\n/**\n * Compute the rnwind cache-key suffix Metro mixes into every per-file\n * transform cache entry via the transformer's `getCacheKey()` export.\n * Includes the CSS path + its current content hash + the rnwind\n * library fingerprint, so any edit to `global.css` OR a library\n * upgrade flips the cache key and forces Metro to re-run the\n * transformer.\n * @returns Deterministic string suitable for appending to Metro's cache key.\n */\nexport function getRnwindCacheKey(): string {\n  const cssEntry = process.env[CSS_ENTRY_ENV] ?? ''\n  const prefixes = process.env[CLASSNAME_PREFIXES_ENV] ?? ''\n  // Host source / component config changes which JSX tags get rewritten,\n  // so it MUST flip the cache key — otherwise Metro replays stale\n  // transforms (a newly-opted-in host keeps its raw className, a removed\n  // one keeps the rewrite).\n  const hostSources = process.env[HOST_SOURCES_ENV] ?? ''\n  const hostComponents = process.env[HOST_COMPONENTS_ENV] ?? ''\n  return `rnwind:${cssEntry}:${readThemeHashFor(cssEntry)}|lib:${getLibraryFingerprint()}|pfx:${prefixes}|hs:${hostSources}|hc:${hostComponents}`\n}\n\n/** Drop the cached state — call after editing the theme CSS. */\nexport function resetRnwindState(): void {\n  cached = null\n}\n\n/**\n * Drop cached state, rebuild parser/builder with the fresh CSS, rescan\n * the project, and rewrite every scheme file on disk. This is what\n * `withRnwindConfig`'s CSS file-watcher invokes so `global.css` edits\n * propagate to the app via Metro's HMR — without this, the CSS-as-JS\n * module would re-emit `export {}` whose bytes never change, so Metro\n * would never invalidate downstream modules.\n * @param projectRoot Absolute project root (from `metroConfig.projectRoot`).\n */\nexport async function onThemeChange(projectRoot: string): Promise<void> {\n  resetRnwindState()\n  const state = getRnwindState(projectRoot)\n  await state.builder.writeSchemes()\n}\n\n/**\n * Resolve the on-disk path of the scheme manifest module for the\n * resolver. The manifest eager-imports `common.style.js` and\n * lazy-requires each variant scheme; SchemeProvider calls its\n * `ensureSchemeLoaded` export to trigger per-scheme requires.\n * @returns Absolute path to `<cacheDir>/schemes.js`.\n */\nexport function manifestPathFor(): string {\n  const cacheDir = process.env[CACHE_DIR_ENV]\n  if (!cacheDir) throw new Error('rnwind: RNWIND_CACHE_DIR is not set')\n  return path.join(cacheDir, 'schemes.js')\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"state.mjs","sources":["../../../../src/metro/state.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport path from 'node:path'\nimport { createHash } from 'node:crypto'\nimport { UnionBuilder } from '../core/style-builder'\nimport { TailwindParser, type SourceEntry } from '../core/parser'\nimport { resolveThemeCss } from './css-imports'\nimport { buildWrapModules } from './wrap-imports'\n\n/**\n * Default oxide Scanner globs — walk every JS/TS source under the\n * project root AND every monorepo watch folder, excluding\n * `node_modules` and rnwind's own cache dir so we don't rescan\n * generated scheme files.\n *\n * Monorepo layouts (Yarn workspaces, pnpm workspaces, Nx) surface\n * sibling package roots as `metroConfig.watchFolders`. Every folder\n * Metro watches must also be scanned so atoms declared in shared UI\n * packages make it into the union — without this, only the app's\n * own files would be scanned and every UI-package atom would resolve\n * to `undefined` at runtime.\n * @param projectRoot Absolute project root.\n * @param cacheDir Absolute rnwind cache dir (to exclude).\n * @param watchFolders Extra monorepo roots Metro is watching.\n * @returns Scanner sources suitable for `parser.parseProject()`.\n */\nfunction defaultSources(projectRoot: string, cacheDir: string, watchFolders: readonly string[]): readonly SourceEntry[] {\n  const cacheBaseName = path.basename(cacheDir)\n  const roots = new Set<string>([projectRoot, ...watchFolders])\n  const sources: SourceEntry[] = []\n  for (const root of roots) {\n    sources.push({ base: root, pattern: '**/*.{ts,tsx,js,jsx}', negated: false }, { base: root, pattern: '**/node_modules/**', negated: true }, { base: root, pattern: `**/${cacheBaseName}/**`, negated: true })\n  }\n  return sources\n}\n\n/**\n * Read monorepo watch-folder paths out of the worker environment.\n * Empty array when the host isn't a monorepo.\n * @returns Absolute paths Metro also watches (sibling packages).\n */\nfunction readWatchFolders(): readonly string[] {\n  const raw = process.env[WATCH_FOLDERS_ENV]\n  if (!raw || raw.length === 0) return []\n  return raw.split('\\0').filter((entry) => entry.length > 0)\n}\n\n/** Env var Metro workers read to locate the theme CSS on disk. */\nconst CSS_ENTRY_ENV = 'RNWIND_CSS_ENTRY_FILE'\n/** Env var Metro workers read to locate the cache directory (`.rnwind`). */\nconst CACHE_DIR_ENV = 'RNWIND_CACHE_DIR'\n/** Env var carrying `watchFolders` from Metro config (NUL-separated). */\nconst WATCH_FOLDERS_ENV = 'RNWIND_WATCH_FOLDERS'\n/** Env var carrying extra modules whose component exports get `wrap()`-ed. Comma-separated. */\nconst WRAP_MODULES_ENV = 'RNWIND_WRAP_MODULES'\n\n/** Memoised library fingerprint — read once per worker process. */\nlet libraryFingerprint: string | undefined\n\n/** Live state shared across one Metro transform worker. */\nlet cached: RnwindState | null = null\n\n/**\n * Cheap content-hash readout. SHA-256 prefix of the FULLY-RESOLVED theme\n * CSS — `@import`s flattened — so an edit to a theme file the entry only\n * re-exports (`@import \"@acme/ui/theme.css\"`) still rotates the hash and\n * invalidates Metro's cache. Returns `'missing'` when the entry can't be\n * read so the cache key stays deterministic.\n * @param cssPath Absolute CSS path.\n * @returns 16-char hex content hash.\n */\nfunction readThemeHashFor(cssPath: string): string {\n  if (!existsSync(cssPath)) return 'missing'\n  try {\n    return createHash('sha256').update(resolveThemeCss(cssPath)).digest('hex').slice(0, 16)\n  } catch {\n    return 'missing'\n  }\n}\n\n/**\n * Hash a small set of rnwind library files whose changes affect the\n * generated transform output. When the library is rebuilt (workspace\n * dev OR npm install of a new version) the file bytes change, the\n * fingerprint rotates, and Metro's transform cache invalidates.\n *\n * Includes the import-rewriter (`wrap-imports`) and runtime resolver\n * alongside the parser / style-builder so a change to the transformer —\n * e.g. renaming the injected wrap helper — invalidates every stale\n * per-file cache entry on the next dev run. Without this, a user upgrading rnwind in-place\n * would keep loading the old transformed bytes; React-refresh would\n * then preserve fiber state across the version bump and the rendered\n * hook list could shift, surfacing as \"change in the order of Hooks\"\n * runtime errors.\n * Memoised — read once per worker process.\n * @returns 16-char hex fingerprint.\n */\nfunction getLibraryFingerprint(): string {\n  if (libraryFingerprint !== undefined) return libraryFingerprint\n  const here = path.dirname(__filename)\n  const candidates = [\n    path.resolve(here, '..', 'core', 'style-builder', 'build-style.mjs'),\n    path.resolve(here, '..', 'core', 'style-builder', 'build-style.cjs'),\n    path.resolve(here, '..', 'core', 'parser', 'tw-parser.mjs'),\n    path.resolve(here, '..', 'core', 'parser', 'tw-parser.cjs'),\n    path.resolve(here, 'wrap-imports.mjs'),\n    path.resolve(here, 'wrap-imports.cjs'),\n    path.resolve(here, 'transformer.mjs'),\n    path.resolve(here, 'transformer.cjs'),\n    // Source-tree fallback for tests + workspace dev (no built lib yet).\n    path.resolve(here, '..', '..', 'src', 'core', 'style-builder', 'build-style.ts'),\n    path.resolve(here, '..', '..', 'src', 'core', 'parser', 'tw-parser.ts'),\n    path.resolve(here, '..', '..', 'src', 'metro', 'wrap-imports.ts'),\n    path.resolve(here, '..', '..', 'src', 'metro', 'transformer.ts'),\n  ]\n  const hash = createHash('sha256')\n  let included = 0\n  for (const file of candidates) {\n    if (!existsSync(file)) continue\n    try {\n      hash.update(readFileSync(file))\n      included += 1\n    } catch {\n      // Unreadable file — skip; fingerprint still derives from whatever WE could read.\n    }\n  }\n  libraryFingerprint = included > 0 ? hash.digest('hex').slice(0, 16) : '0'.repeat(16)\n  return libraryFingerprint\n}\n\n/**\n * Worker-local state. Lazy-initialised on first access so files that\n * bypass the transform don't pay for construction.\n */\nexport interface RnwindState {\n  parser: TailwindParser\n  builder: UnionBuilder\n  themeCss: string\n  themeHash: string\n  projectRoot: string\n}\n\n/**\n * Publish the theme CSS path + cache dir to the environment so worker\n * subprocesses (spawned by Metro once `babelTransformerPath` is set)\n * can rebuild the same state without re-reading the Metro config.\n * @param cssEntryFile Absolute path to the user's theme CSS.\n * @param cacheDir Absolute path to the cache dir (`.rnwind`).\n * @param watchFolders Monorepo watch folders to scan for atoms.\n * @param wrapModules Extra modules whose component exports get `wrap()`-ed.\n */\nexport function configureRnwindState(\n  cssEntryFile: string,\n  cacheDir: string,\n  watchFolders: readonly string[] = [],\n  wrapModules?: readonly string[],\n): void {\n  process.env[CSS_ENTRY_ENV] = cssEntryFile\n  process.env[CACHE_DIR_ENV] = cacheDir\n  if (watchFolders.length === 0) {\n    delete process.env[WATCH_FOLDERS_ENV]\n  } else {\n    process.env[WATCH_FOLDERS_ENV] = watchFolders.join('\\0')\n  }\n  if (!wrapModules || wrapModules.length === 0) {\n    delete process.env[WRAP_MODULES_ENV]\n  } else {\n    process.env[WRAP_MODULES_ENV] = wrapModules.join(',')\n  }\n  cached = null\n}\n\n/**\n * Effective module → wrap-policy map: the built-in defaults merged with\n * any extra modules the Metro config supplied.\n * @returns Module → policy map the import-rewrite consults.\n */\nexport function getWrapModules(): ReturnType<typeof buildWrapModules> {\n  const raw = process.env[WRAP_MODULES_ENV]\n  const extra = raw && raw.length > 0 ? raw.split(',').filter((entry) => entry.length > 0) : undefined\n  return buildWrapModules(extra)\n}\n\n/**\n * Fetch (or build) the worker-local rnwind state. Re-reads the theme\n * CSS hash on every call: if the user edited `global.css` while Metro\n * is running, the cached state is dropped and a fresh parser + ledger\n * is built. Combined with the `getCacheKey()` export on the\n * transformer (which folds the same hash into Metro's per-file cache\n * key) every CSS edit produces a full, correct re-bundle.\n * @param projectRoot\n * @returns The live rnwind state.\n */\nexport function getRnwindState(projectRoot: string): RnwindState {\n  const cssEntry = process.env[CSS_ENTRY_ENV]\n  const cacheDir = process.env[CACHE_DIR_ENV]\n  if (!cssEntry) throw new Error('rnwind: RNWIND_CSS_ENTRY_FILE is not set — did `withRnwindConfig` run?')\n  if (!cacheDir) throw new Error('rnwind: RNWIND_CACHE_DIR is not set — did `withRnwindConfig` run?')\n  const currentHash = readThemeHashFor(cssEntry)\n  if (cached?.themeHash === currentHash && cached.projectRoot === projectRoot) return cached\n  const themeCss = resolveThemeCss(cssEntry)\n  const parser = new TailwindParser({\n    themeCss,\n    sources: defaultSources(projectRoot, cacheDir, readWatchFolders()),\n  })\n  const builder = new UnionBuilder(cacheDir, parser)\n  cached = { parser, builder, themeCss, themeHash: currentHash, projectRoot }\n  return cached\n}\n\n/**\n * Compute the rnwind cache-key suffix Metro mixes into every per-file\n * transform cache entry via the transformer's `getCacheKey()` export.\n * Includes the CSS path + its current content hash + the rnwind\n * library fingerprint, so any edit to `global.css` OR a library\n * upgrade flips the cache key and forces Metro to re-run the\n * transformer.\n * @returns Deterministic string suitable for appending to Metro's cache key.\n */\nexport function getRnwindCacheKey(): string {\n  const cssEntry = process.env[CSS_ENTRY_ENV] ?? ''\n  // Wrap-module config changes which import sites get `wrap()`-ed, so it\n  // MUST flip the cache key — otherwise Metro replays stale transforms\n  // (a newly-opted-in module keeps its raw import, a removed one keeps\n  // the wrap).\n  const wrapModules = process.env[WRAP_MODULES_ENV] ?? ''\n  return `rnwind:${cssEntry}:${readThemeHashFor(cssEntry)}|lib:${getLibraryFingerprint()}|wm:${wrapModules}`\n}\n\n/** Drop the cached state — call after editing the theme CSS. */\nexport function resetRnwindState(): void {\n  cached = null\n}\n\n/**\n * Drop cached state, rebuild parser/builder with the fresh CSS, rescan\n * the project, and rewrite every scheme file on disk. This is what\n * `withRnwindConfig`'s CSS file-watcher invokes so `global.css` edits\n * propagate to the app via Metro's HMR — without this, the CSS-as-JS\n * module would re-emit `export {}` whose bytes never change, so Metro\n * would never invalidate downstream modules.\n * @param projectRoot Absolute project root (from `metroConfig.projectRoot`).\n */\nexport async function onThemeChange(projectRoot: string): Promise<void> {\n  resetRnwindState()\n  const state = getRnwindState(projectRoot)\n  await state.builder.writeSchemes()\n}\n\n/**\n * Resolve the on-disk path of the scheme manifest module for the\n * resolver. The manifest eager-imports `common.style.js` and\n * lazy-requires each variant scheme; SchemeProvider calls its\n * `ensureSchemeLoaded` export to trigger per-scheme requires.\n * @returns Absolute path to `<cacheDir>/schemes.js`.\n */\nexport function manifestPathFor(): string {\n  const cacheDir = process.env[CACHE_DIR_ENV]\n  if (!cacheDir) throw new Error('rnwind: RNWIND_CACHE_DIR is not set')\n  return path.join(cacheDir, 'schemes.js')\n}\n"],"names":[],"mappings":"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"}

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.