rnwind 0.0.3 → 0.0.4

package/lib/cjs/metro/css-imports.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var node_module = require('node:module');
+var node_fs = require('node:fs');
+
+/**
+ * Inline `@import` resolution for the theme entry CSS.
+ *
+ * rnwind's scheme extractors (`extractThemeVars`, `extractSchemeAliases`,
+ * `extractCustomVariantSchemes`) are plain text passes over the entry
+ * CSS — they don't follow `@import`. Tailwind's own compiler DOES follow
+ * imports, so utilities still compile, but a user who keeps their theme
+ * in a separate file and points the entry at it:
+ *
+ * ```css
+ * @import "@acme/ui/theme.css";  // global.css — the cssEntryFile
+ * ```
+ *
+ * would hand the extractors a file with no `@theme` / `@variant` /
+ * `@custom-variant` in sight → every scheme collapses to base and theme
+ * switching dies. This module flattens those user imports first so the
+ * extractors (and the compiler) see the real declarations.
+ */
+/** Matches a bare `@import "spec";` / `@import 'spec';` (no media/layer suffix). */
+const CSS_IMPORT = /@import\s+(["'])([^"']+)\1\s*;/g;
+/**
+ * Specs left untouched for the Tailwind compiler to resolve itself.
+ * `tailwindcss` resolves to JS (not inlinable) and `rnwind/css` is the
+ * framework preset — both are the compiler's job, not user theme files.
+ */
+const FRAMEWORK_SPECS = new Set(['tailwindcss', 'rnwind/css', 'rnwind']);
+/**
+ * Read `filePath` and replace each user `@import "<spec>";` whose spec
+ * resolves (Node resolution, honouring `exports` maps and workspace
+ * symlinks) to a readable `.css` file with that file's inlined +
+ * recursively-resolved contents. Unresolvable specs, non-CSS targets,
+ * and {@link FRAMEWORK_SPECS} are left as-is for the compiler.
+ * @param filePath Absolute path of the CSS file being inlined.
+ * @param seen Visited set guarding against import cycles.
+ * @returns CSS text with user imports flattened in place.
+ */
+function inlineImports(filePath, seen) {
+    if (seen.has(filePath))
+        return '';
+    seen.add(filePath);
+    let css;
+    try {
+        css = node_fs.readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return '';
+    }
+    const request = node_module.createRequire(filePath);
+    return css.replaceAll(CSS_IMPORT, (full, _quote, spec) => {
+        if (FRAMEWORK_SPECS.has(spec))
+            return full;
+        let resolved;
+        try {
+            resolved = request.resolve(spec);
+        }
+        catch {
+            return full;
+        }
+        if (!resolved.endsWith('.css') || !node_fs.existsSync(resolved))
+            return full;
+        return inlineImports(resolved, seen);
+    });
+}
+/**
+ * Flatten user `@import`s in a theme entry CSS file so rnwind's text-based
+ * scheme extractors see the real `@theme` / `@variant` / `@custom-variant`
+ * declarations even when the entry only re-exports them via `@import`.
+ * @param entryFilePath Absolute path to the theme entry CSS (the cssEntryFile).
+ * @returns Inlined CSS, or `''` when the entry can't be read.
+ */
+function resolveThemeCss(entryFilePath) {
+    return inlineImports(entryFilePath, new Set());
+}
+
+exports.resolveThemeCss = resolveThemeCss;
+//# sourceMappingURL=css-imports.cjs.map

package/lib/cjs/metro/css-imports.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-imports.cjs","sources":["../../../../src/metro/css-imports.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport { existsSync, readFileSync } from 'node:fs'\n\n/**\n * Inline `@import` resolution for the theme entry CSS.\n *\n * rnwind's scheme extractors (`extractThemeVars`, `extractSchemeAliases`,\n * `extractCustomVariantSchemes`) are plain text passes over the entry\n * CSS — they don't follow `@import`. Tailwind's own compiler DOES follow\n * imports, so utilities still compile, but a user who keeps their theme\n * in a separate file and points the entry at it:\n *\n * ```css\n * @import \"@acme/ui/theme.css\";  // global.css — the cssEntryFile\n * ```\n *\n * would hand the extractors a file with no `@theme` / `@variant` /\n * `@custom-variant` in sight → every scheme collapses to base and theme\n * switching dies. This module flattens those user imports first so the\n * extractors (and the compiler) see the real declarations.\n */\n\n/** Matches a bare `@import \"spec\";` / `@import 'spec';` (no media/layer suffix). */\nconst CSS_IMPORT = /@import\\s+([\"'])([^\"']+)\\1\\s*;/g\n\n/**\n * Specs left untouched for the Tailwind compiler to resolve itself.\n * `tailwindcss` resolves to JS (not inlinable) and `rnwind/css` is the\n * framework preset — both are the compiler's job, not user theme files.\n */\nconst FRAMEWORK_SPECS = new Set(['tailwindcss', 'rnwind/css', 'rnwind'])\n\n/**\n * Read `filePath` and replace each user `@import \"<spec>\";` whose spec\n * resolves (Node resolution, honouring `exports` maps and workspace\n * symlinks) to a readable `.css` file with that file's inlined +\n * recursively-resolved contents. Unresolvable specs, non-CSS targets,\n * and {@link FRAMEWORK_SPECS} are left as-is for the compiler.\n * @param filePath Absolute path of the CSS file being inlined.\n * @param seen Visited set guarding against import cycles.\n * @returns CSS text with user imports flattened in place.\n */\nfunction inlineImports(filePath: string, seen: Set<string>): string {\n  if (seen.has(filePath)) return ''\n  seen.add(filePath)\n  let css: string\n  try {\n    css = readFileSync(filePath, 'utf8')\n  } catch {\n    return ''\n  }\n  const request = createRequire(filePath)\n  return css.replaceAll(CSS_IMPORT, (full: string, _quote: string, spec: string): string => {\n    if (FRAMEWORK_SPECS.has(spec)) return full\n    let resolved: string\n    try {\n      resolved = request.resolve(spec)\n    } catch {\n      return full\n    }\n    if (!resolved.endsWith('.css') || !existsSync(resolved)) return full\n    return inlineImports(resolved, seen)\n  })\n}\n\n/**\n * Flatten user `@import`s in a theme entry CSS file so rnwind's text-based\n * scheme extractors see the real `@theme` / `@variant` / `@custom-variant`\n * declarations even when the entry only re-exports them via `@import`.\n * @param entryFilePath Absolute path to the theme entry CSS (the cssEntryFile).\n * @returns Inlined CSS, or `''` when the entry can't be read.\n */\nexport function resolveThemeCss(entryFilePath: string): string {\n  return inlineImports(entryFilePath, new Set<string>())\n}\n"],"names":["readFileSync","createRequire","existsSync"],"mappings":";;;;;AAGA;;;;;;;;;;;;;;;;;AAiBG;AAEH;AACA,MAAM,UAAU,GAAG,iCAAiC;AAEpD;;;;AAIG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAExE;;;;;;;;;AASG;AACH,SAAS,aAAa,CAAC,QAAgB,EAAE,IAAiB,EAAA;AACxD,IAAA,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;AAAE,QAAA,OAAO,EAAE;AACjC,IAAA,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;AAClB,IAAA,IAAI,GAAW;AACf,IAAA,IAAI;AACF,QAAA,GAAG,GAAGA,oBAAY,CAAC,QAAQ,EAAE,MAAM,CAAC;IACtC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACA,IAAA,MAAM,OAAO,GAAGC,yBAAa,CAAC,QAAQ,CAAC;AACvC,IAAA,OAAO,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY,KAAY;AACvF,QAAA,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;AAAE,YAAA,OAAO,IAAI;AAC1C,QAAA,IAAI,QAAgB;AACpB,QAAA,IAAI;AACF,YAAA,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAClC;AAAE,QAAA,MAAM;AACN,YAAA,OAAO,IAAI;QACb;AACA,QAAA,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAACC,kBAAU,CAAC,QAAQ,CAAC;AAAE,YAAA,OAAO,IAAI;AACpE,QAAA,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC;AACtC,IAAA,CAAC,CAAC;AACJ;AAEA;;;;;;AAMG;AACG,SAAU,eAAe,CAAC,aAAqB,EAAA;IACnD,OAAO,aAAa,CAAC,aAAa,EAAE,IAAI,GAAG,EAAU,CAAC;AACxD;;;;"}

package/lib/cjs/metro/css-imports.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Flatten user `@import`s in a theme entry CSS file so rnwind's text-based
+ * scheme extractors see the real `@theme` / `@variant` / `@custom-variant`
+ * declarations even when the entry only re-exports them via `@import`.
+ * @param entryFilePath Absolute path to the theme entry CSS (the cssEntryFile).
+ * @returns Inlined CSS, or `''` when the entry can't be read.
+ */
+export declare function resolveThemeCss(entryFilePath: string): string;

package/lib/cjs/metro/state.cjs

@@ -5,6 +5,7 @@ var path = require('node:path');
 var node_crypto = require('node:crypto');
 var unionBuilder = require('../core/style-builder/union-builder.cjs');
 var twParser = require('../core/parser/tw-parser.cjs');
+var cssImports = require('./css-imports.cjs');
 
 /**
  * Default oxide Scanner globs — walk every JS/TS source under the
@@ -60,10 +61,11 @@ let libraryFingerprint;
 /** Live state shared across one Metro transform worker. */
 let cached = null;
 /**
- * Cheap content-hash readout. SHA-256 prefix of the CSS bytes plus the
- * file's mtime nanoseconds (so identical content with different mtime
- * — atomic rewrites — still picks up the change). Returns `'missing'`
- * when the file can't be read so the cache key is still deterministic.
+ * Cheap content-hash readout. SHA-256 prefix of the FULLY-RESOLVED theme
+ * CSS — `@import`s flattened — so an edit to a theme file the entry only
+ * re-exports (`@import "@acme/ui/theme.css"`) still rotates the hash and
+ * invalidates Metro's cache. Returns `'missing'` when the entry can't be
+ * read so the cache key stays deterministic.
  * @param cssPath Absolute CSS path.
  * @returns 16-char hex content hash.
  */
@@ -71,9 +73,7 @@ function readThemeHashFor(cssPath) {
     if (!node_fs.existsSync(cssPath))
         return 'missing';
     try {
-        const bytes = node_fs.readFileSync(cssPath);
-        const mtime = node_fs.statSync(cssPath).mtimeMs.toString();
-        return node_crypto.createHash('sha256').update(bytes).update(mtime).digest('hex').slice(0, 16);
+        return node_crypto.createHash('sha256').update(cssImports.resolveThemeCss(cssPath)).digest('hex').slice(0, 16);
     }
     catch {
         return 'missing';
@@ -228,7 +228,7 @@ function getRnwindState(projectRoot) {
     const currentHash = readThemeHashFor(cssEntry);
     if (cached?.themeHash === currentHash && cached.projectRoot === projectRoot)
         return cached;
-    const themeCss = node_fs.readFileSync(cssEntry, 'utf8');
+    const themeCss = cssImports.resolveThemeCss(cssEntry);
     const parser = new twParser.TailwindParser({
         themeCss,
         sources: defaultSources(projectRoot, cacheDir, readWatchFolders()),

package/lib/cjs/metro/state.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"state.cjs","sources":["../../../../src/metro/state.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } 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'\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 CSS bytes plus the\n * file's mtime nanoseconds (so identical content with different mtime\n * — atomic rewrites — still picks up the change). Returns `'missing'`\n * when the file can't be read so the cache key is still 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    const bytes = readFileSync(cssPath)\n    const mtime = statSync(cssPath).mtimeMs.toString()\n    return createHash('sha256').update(bytes).update(mtime).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 = readFileSync(cssEntry, 'utf8')\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":["existsSync","readFileSync","statSync","createHash","TailwindParser","UnionBuilder"],"mappings":"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"}
+{"version":3,"file":"state.cjs","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":["existsSync","createHash","resolveThemeCss","readFileSync","TailwindParser","UnionBuilder"],"mappings":"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"}

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

@@ -0,0 +1,8 @@
+/**
+ * Flatten user `@import`s in a theme entry CSS file so rnwind's text-based
+ * scheme extractors see the real `@theme` / `@variant` / `@custom-variant`
+ * declarations even when the entry only re-exports them via `@import`.
+ * @param entryFilePath Absolute path to the theme entry CSS (the cssEntryFile).
+ * @returns Inlined CSS, or `''` when the entry can't be read.
+ */
+export declare function resolveThemeCss(entryFilePath: string): string;

package/lib/esm/metro/css-imports.mjs

@@ -0,0 +1,79 @@
+import { createRequire } from 'node:module';
+import { readFileSync, existsSync } from 'node:fs';
+
+/**
+ * Inline `@import` resolution for the theme entry CSS.
+ *
+ * rnwind's scheme extractors (`extractThemeVars`, `extractSchemeAliases`,
+ * `extractCustomVariantSchemes`) are plain text passes over the entry
+ * CSS — they don't follow `@import`. Tailwind's own compiler DOES follow
+ * imports, so utilities still compile, but a user who keeps their theme
+ * in a separate file and points the entry at it:
+ *
+ * ```css
+ * @import "@acme/ui/theme.css";  // global.css — the cssEntryFile
+ * ```
+ *
+ * would hand the extractors a file with no `@theme` / `@variant` /
+ * `@custom-variant` in sight → every scheme collapses to base and theme
+ * switching dies. This module flattens those user imports first so the
+ * extractors (and the compiler) see the real declarations.
+ */
+/** Matches a bare `@import "spec";` / `@import 'spec';` (no media/layer suffix). */
+const CSS_IMPORT = /@import\s+(["'])([^"']+)\1\s*;/g;
+/**
+ * Specs left untouched for the Tailwind compiler to resolve itself.
+ * `tailwindcss` resolves to JS (not inlinable) and `rnwind/css` is the
+ * framework preset — both are the compiler's job, not user theme files.
+ */
+const FRAMEWORK_SPECS = new Set(['tailwindcss', 'rnwind/css', 'rnwind']);
+/**
+ * Read `filePath` and replace each user `@import "<spec>";` whose spec
+ * resolves (Node resolution, honouring `exports` maps and workspace
+ * symlinks) to a readable `.css` file with that file's inlined +
+ * recursively-resolved contents. Unresolvable specs, non-CSS targets,
+ * and {@link FRAMEWORK_SPECS} are left as-is for the compiler.
+ * @param filePath Absolute path of the CSS file being inlined.
+ * @param seen Visited set guarding against import cycles.
+ * @returns CSS text with user imports flattened in place.
+ */
+function inlineImports(filePath, seen) {
+    if (seen.has(filePath))
+        return '';
+    seen.add(filePath);
+    let css;
+    try {
+        css = readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return '';
+    }
+    const request = createRequire(filePath);
+    return css.replaceAll(CSS_IMPORT, (full, _quote, spec) => {
+        if (FRAMEWORK_SPECS.has(spec))
+            return full;
+        let resolved;
+        try {
+            resolved = request.resolve(spec);
+        }
+        catch {
+            return full;
+        }
+        if (!resolved.endsWith('.css') || !existsSync(resolved))
+            return full;
+        return inlineImports(resolved, seen);
+    });
+}
+/**
+ * Flatten user `@import`s in a theme entry CSS file so rnwind's text-based
+ * scheme extractors see the real `@theme` / `@variant` / `@custom-variant`
+ * declarations even when the entry only re-exports them via `@import`.
+ * @param entryFilePath Absolute path to the theme entry CSS (the cssEntryFile).
+ * @returns Inlined CSS, or `''` when the entry can't be read.
+ */
+function resolveThemeCss(entryFilePath) {
+    return inlineImports(entryFilePath, new Set());
+}
+
+export { resolveThemeCss };
+//# sourceMappingURL=css-imports.mjs.map

package/lib/esm/metro/css-imports.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-imports.mjs","sources":["../../../../src/metro/css-imports.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport { existsSync, readFileSync } from 'node:fs'\n\n/**\n * Inline `@import` resolution for the theme entry CSS.\n *\n * rnwind's scheme extractors (`extractThemeVars`, `extractSchemeAliases`,\n * `extractCustomVariantSchemes`) are plain text passes over the entry\n * CSS — they don't follow `@import`. Tailwind's own compiler DOES follow\n * imports, so utilities still compile, but a user who keeps their theme\n * in a separate file and points the entry at it:\n *\n * ```css\n * @import \"@acme/ui/theme.css\";  // global.css — the cssEntryFile\n * ```\n *\n * would hand the extractors a file with no `@theme` / `@variant` /\n * `@custom-variant` in sight → every scheme collapses to base and theme\n * switching dies. This module flattens those user imports first so the\n * extractors (and the compiler) see the real declarations.\n */\n\n/** Matches a bare `@import \"spec\";` / `@import 'spec';` (no media/layer suffix). */\nconst CSS_IMPORT = /@import\\s+([\"'])([^\"']+)\\1\\s*;/g\n\n/**\n * Specs left untouched for the Tailwind compiler to resolve itself.\n * `tailwindcss` resolves to JS (not inlinable) and `rnwind/css` is the\n * framework preset — both are the compiler's job, not user theme files.\n */\nconst FRAMEWORK_SPECS = new Set(['tailwindcss', 'rnwind/css', 'rnwind'])\n\n/**\n * Read `filePath` and replace each user `@import \"<spec>\";` whose spec\n * resolves (Node resolution, honouring `exports` maps and workspace\n * symlinks) to a readable `.css` file with that file's inlined +\n * recursively-resolved contents. Unresolvable specs, non-CSS targets,\n * and {@link FRAMEWORK_SPECS} are left as-is for the compiler.\n * @param filePath Absolute path of the CSS file being inlined.\n * @param seen Visited set guarding against import cycles.\n * @returns CSS text with user imports flattened in place.\n */\nfunction inlineImports(filePath: string, seen: Set<string>): string {\n  if (seen.has(filePath)) return ''\n  seen.add(filePath)\n  let css: string\n  try {\n    css = readFileSync(filePath, 'utf8')\n  } catch {\n    return ''\n  }\n  const request = createRequire(filePath)\n  return css.replaceAll(CSS_IMPORT, (full: string, _quote: string, spec: string): string => {\n    if (FRAMEWORK_SPECS.has(spec)) return full\n    let resolved: string\n    try {\n      resolved = request.resolve(spec)\n    } catch {\n      return full\n    }\n    if (!resolved.endsWith('.css') || !existsSync(resolved)) return full\n    return inlineImports(resolved, seen)\n  })\n}\n\n/**\n * Flatten user `@import`s in a theme entry CSS file so rnwind's text-based\n * scheme extractors see the real `@theme` / `@variant` / `@custom-variant`\n * declarations even when the entry only re-exports them via `@import`.\n * @param entryFilePath Absolute path to the theme entry CSS (the cssEntryFile).\n * @returns Inlined CSS, or `''` when the entry can't be read.\n */\nexport function resolveThemeCss(entryFilePath: string): string {\n  return inlineImports(entryFilePath, new Set<string>())\n}\n"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;AAiBG;AAEH;AACA,MAAM,UAAU,GAAG,iCAAiC;AAEpD;;;;AAIG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AAExE;;;;;;;;;AASG;AACH,SAAS,aAAa,CAAC,QAAgB,EAAE,IAAiB,EAAA;AACxD,IAAA,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;AAAE,QAAA,OAAO,EAAE;AACjC,IAAA,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;AAClB,IAAA,IAAI,GAAW;AACf,IAAA,IAAI;AACF,QAAA,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC;IACtC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,EAAE;IACX;AACA,IAAA,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC;AACvC,IAAA,OAAO,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY,KAAY;AACvF,QAAA,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;AAAE,YAAA,OAAO,IAAI;AAC1C,QAAA,IAAI,QAAgB;AACpB,QAAA,IAAI;AACF,YAAA,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAClC;AAAE,QAAA,MAAM;AACN,YAAA,OAAO,IAAI;QACb;AACA,QAAA,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;AAAE,YAAA,OAAO,IAAI;AACpE,QAAA,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC;AACtC,IAAA,CAAC,CAAC;AACJ;AAEA;;;;;;AAMG;AACG,SAAU,eAAe,CAAC,aAAqB,EAAA;IACnD,OAAO,aAAa,CAAC,aAAa,EAAE,IAAI,GAAG,EAAU,CAAC;AACxD;;;;"}

package/lib/esm/metro/state.mjs

@@ -1,8 +1,9 @@
-import { readFileSync, existsSync, statSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 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';
 
 /**
  * Default oxide Scanner globs — walk every JS/TS source under the
@@ -58,10 +59,11 @@ let libraryFingerprint;
 /** Live state shared across one Metro transform worker. */
 let cached = null;
 /**
- * Cheap content-hash readout. SHA-256 prefix of the CSS bytes plus the
- * file's mtime nanoseconds (so identical content with different mtime
- * — atomic rewrites — still picks up the change). Returns `'missing'`
- * when the file can't be read so the cache key is still deterministic.
+ * Cheap content-hash readout. SHA-256 prefix of the FULLY-RESOLVED theme
+ * CSS — `@import`s flattened — so an edit to a theme file the entry only
+ * re-exports (`@import "@acme/ui/theme.css"`) still rotates the hash and
+ * invalidates Metro's cache. Returns `'missing'` when the entry can't be
+ * read so the cache key stays deterministic.
  * @param cssPath Absolute CSS path.
  * @returns 16-char hex content hash.
  */
@@ -69,9 +71,7 @@ function readThemeHashFor(cssPath) {
     if (!existsSync(cssPath))
         return 'missing';
     try {
-        const bytes = readFileSync(cssPath);
-        const mtime = statSync(cssPath).mtimeMs.toString();
-        return createHash('sha256').update(bytes).update(mtime).digest('hex').slice(0, 16);
+        return createHash('sha256').update(resolveThemeCss(cssPath)).digest('hex').slice(0, 16);
     }
     catch {
         return 'missing';
@@ -226,7 +226,7 @@ function getRnwindState(projectRoot) {
     const currentHash = readThemeHashFor(cssEntry);
     if (cached?.themeHash === currentHash && cached.projectRoot === projectRoot)
         return cached;
-    const themeCss = readFileSync(cssEntry, 'utf8');
+    const themeCss = resolveThemeCss(cssEntry);
     const parser = new TailwindParser({
         themeCss,
         sources: defaultSources(projectRoot, cacheDir, readWatchFolders()),

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

@@ -1 +1 @@
-{"version":3,"file":"state.mjs","sources":["../../../../src/metro/state.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } 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'\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 CSS bytes plus the\n * file's mtime nanoseconds (so identical content with different mtime\n * — atomic rewrites — still picks up the change). Returns `'missing'`\n * when the file can't be read so the cache key is still 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    const bytes = readFileSync(cssPath)\n    const mtime = statSync(cssPath).mtimeMs.toString()\n    return createHash('sha256').update(bytes).update(mtime).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 = readFileSync(cssEntry, 'utf8')\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":";;;;;;AAMA;;;;;;;;;;;;;;;;AAgBG;AACH,SAAS,cAAc,CAAC,WAAmB,EAAE,QAAgB,EAAE,YAA+B,EAAA;IAC5F,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;AAC7C,IAAA,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAkB,EAAE;AACjC,IAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACxB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA,GAAA,EAAM,aAAa,CAAA,GAAA,CAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC/M;AACA,IAAA,OAAO,OAAO;AAChB;AAEA;;;;AAIG;AACH,SAAS,gBAAgB,GAAA;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAC1C,IAAA,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;IACvC,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5D;AAEA;AACA,MAAM,aAAa,GAAG,uBAAuB;AAC7C;AACA,MAAM,aAAa,GAAG,kBAAkB;AACxC;AACA,MAAM,iBAAiB,GAAG,sBAAsB;AAChD;AACA,MAAM,sBAAsB,GAAG,2BAA2B;AAC1D;AACA,MAAM,gBAAgB,GAAG,qBAAqB;AAC9C;AACA,MAAM,mBAAmB,GAAG,wBAAwB;AAEpD;AACA,IAAI,kBAAsC;AAE1C;AACA,IAAI,MAAM,GAAuB,IAAI;AAErC;;;;;;;AAOG;AACH,SAAS,gBAAgB,CAAC,OAAe,EAAA;AACvC,IAAA,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;AAAE,QAAA,OAAO,SAAS;AAC1C,IAAA,IAAI;AACF,QAAA,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;QAClD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IACpF;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AACF;AAEA;;;;;;;;;;;;;;;;AAgBG;AACH,SAAS,qBAAqB,GAAA;IAC5B,IAAI,kBAAkB,KAAK,SAAS;AAAE,QAAA,OAAO,kBAAkB;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;AACrC,IAAA,MAAM,UAAU,GAAG;AACjB,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,CAAC;AACpE,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,CAAC;AACpE,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC;AAC3D,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC;AAC3D,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC;AACvC,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC;AACvC,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC;AACrC,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC;;AAErC,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,gBAAgB,CAAC;AAChF,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC;AACvE,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,CAAC;AAClE,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC;KACjE;AACD,IAAA,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;IACjC,IAAI,QAAQ,GAAG,CAAC;AAChB,IAAA,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;AAC7B,QAAA,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE;AACvB,QAAA,IAAI;YACF,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,QAAQ,IAAI,CAAC;QACf;AAAE,QAAA,MAAM;;QAER;IACF;AACA,IAAA,kBAAkB,GAAG,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;AACpF,IAAA,OAAO,kBAAkB;AAC3B;AAcA;;;;;;;;;;AAUG;AACG,SAAU,oBAAoB,CAClC,YAAoB,EACpB,QAAgB,EAChB,YAAA,GAAkC,EAAE,EACpC,iBAAqC,EACrC,WAA+B,EAC/B,cAAkC,EAAA;AAElC,IAAA,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,YAAY;AACzC,IAAA,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,QAAQ;AACrC,IAAA,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7B,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACvC;SAAO;AACL,QAAA,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1D;IACA,IAAI,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE;AACxD,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC5C;SAAO;AACL,QAAA,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;IACnE;IACA,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;AAC5C,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACtC;SAAO;AACL,QAAA,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;IACvD;IACA,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE;AAClD,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACzC;SAAO;AACL,QAAA,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7D;IACA,MAAM,GAAG,IAAI;AACf;AAEA;;;;;;AAMG;SACa,oBAAoB,GAAA;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;AAC/C,IAAA,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;IACvC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3D;AAEA;;;;;AAKG;SACa,cAAc,GAAA;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AACzC,IAAA,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;IACvC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3D;AAEA;;;;;AAKG;SACa,iBAAiB,GAAA;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAC5C,IAAA,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;IACvC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3D;AAEA;;;;;;;;;AASG;AACG,SAAU,cAAc,CAAC,WAAmB,EAAA;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AAC3C,IAAA,IAAI,CAAC,QAAQ;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC;AACxG,IAAA,IAAI,CAAC,QAAQ;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC;AACnG,IAAA,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAC9C,IAAI,MAAM,EAAE,SAAS,KAAK,WAAW,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW;AAAE,QAAA,OAAO,MAAM;IAC1F,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC;AAC/C,IAAA,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,QAAQ;QACR,OAAO,EAAE,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;AACnE,KAAA,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC;AAClD,IAAA,MAAM,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE;AAC3E,IAAA,OAAO,MAAM;AACf;AAEA;;;;;;;;AAQG;SACa,iBAAiB,GAAA;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE;;;;;IAK1D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE;AAC7D,IAAA,OAAO,UAAU,QAAQ,CAAA,CAAA,EAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAA,KAAA,EAAQ,qBAAqB,EAAE,QAAQ,QAAQ,CAAA,IAAA,EAAO,WAAW,CAAA,IAAA,EAAO,cAAc,EAAE;AACjJ;AAEA;SACgB,gBAAgB,GAAA;IAC9B,MAAM,GAAG,IAAI;AACf;AAEA;;;;;;;;AAQG;AACI,eAAe,aAAa,CAAC,WAAmB,EAAA;AACrD,IAAA,gBAAgB,EAAE;AAClB,IAAA,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,CAAC;AACzC,IAAA,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE;AACpC;AAEA;;;;;;AAMG;SACa,eAAe,GAAA;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AAC3C,IAAA,IAAI,CAAC,QAAQ;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC;AAC1C;;;;"}
+{"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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnwind",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Tailwind for React Native",
   "author": "https://github.com/sagltd",
   "license": "MIT",

package/src/metro/css-imports.ts

@@ -0,0 +1,75 @@
+import { createRequire } from 'node:module'
+import { existsSync, readFileSync } from 'node:fs'
+
+/**
+ * Inline `@import` resolution for the theme entry CSS.
+ *
+ * rnwind's scheme extractors (`extractThemeVars`, `extractSchemeAliases`,
+ * `extractCustomVariantSchemes`) are plain text passes over the entry
+ * CSS — they don't follow `@import`. Tailwind's own compiler DOES follow
+ * imports, so utilities still compile, but a user who keeps their theme
+ * in a separate file and points the entry at it:
+ *
+ * ```css
+ * @import "@acme/ui/theme.css";  // global.css — the cssEntryFile
+ * ```
+ *
+ * would hand the extractors a file with no `@theme` / `@variant` /
+ * `@custom-variant` in sight → every scheme collapses to base and theme
+ * switching dies. This module flattens those user imports first so the
+ * extractors (and the compiler) see the real declarations.
+ */
+
+/** Matches a bare `@import "spec";` / `@import 'spec';` (no media/layer suffix). */
+const CSS_IMPORT = /@import\s+(["'])([^"']+)\1\s*;/g
+
+/**
+ * Specs left untouched for the Tailwind compiler to resolve itself.
+ * `tailwindcss` resolves to JS (not inlinable) and `rnwind/css` is the
+ * framework preset — both are the compiler's job, not user theme files.
+ */
+const FRAMEWORK_SPECS = new Set(['tailwindcss', 'rnwind/css', 'rnwind'])
+
+/**
+ * Read `filePath` and replace each user `@import "<spec>";` whose spec
+ * resolves (Node resolution, honouring `exports` maps and workspace
+ * symlinks) to a readable `.css` file with that file's inlined +
+ * recursively-resolved contents. Unresolvable specs, non-CSS targets,
+ * and {@link FRAMEWORK_SPECS} are left as-is for the compiler.
+ * @param filePath Absolute path of the CSS file being inlined.
+ * @param seen Visited set guarding against import cycles.
+ * @returns CSS text with user imports flattened in place.
+ */
+function inlineImports(filePath: string, seen: Set<string>): string {
+  if (seen.has(filePath)) return ''
+  seen.add(filePath)
+  let css: string
+  try {
+    css = readFileSync(filePath, 'utf8')
+  } catch {
+    return ''
+  }
+  const request = createRequire(filePath)
+  return css.replaceAll(CSS_IMPORT, (full: string, _quote: string, spec: string): string => {
+    if (FRAMEWORK_SPECS.has(spec)) return full
+    let resolved: string
+    try {
+      resolved = request.resolve(spec)
+    } catch {
+      return full
+    }
+    if (!resolved.endsWith('.css') || !existsSync(resolved)) return full
+    return inlineImports(resolved, seen)
+  })
+}
+
+/**
+ * Flatten user `@import`s in a theme entry CSS file so rnwind's text-based
+ * scheme extractors see the real `@theme` / `@variant` / `@custom-variant`
+ * declarations even when the entry only re-exports them via `@import`.
+ * @param entryFilePath Absolute path to the theme entry CSS (the cssEntryFile).
+ * @returns Inlined CSS, or `''` when the entry can't be read.
+ */
+export function resolveThemeCss(entryFilePath: string): string {
+  return inlineImports(entryFilePath, new Set<string>())
+}

package/src/metro/state.ts

@@ -1,8 +1,9 @@
-import { existsSync, readFileSync, statSync } from 'node:fs'
+import { existsSync, readFileSync } from 'node:fs'
 import path from 'node:path'
 import { createHash } from 'node:crypto'
 import { UnionBuilder } from '../core/style-builder'
 import { TailwindParser, type SourceEntry } from '../core/parser'
+import { resolveThemeCss } from './css-imports'
 
 /**
  * Default oxide Scanner globs — walk every JS/TS source under the
@@ -62,19 +63,18 @@ let libraryFingerprint: string | undefined
 let cached: RnwindState | null = null
 
 /**
- * Cheap content-hash readout. SHA-256 prefix of the CSS bytes plus the
- * file's mtime nanoseconds (so identical content with different mtime
- * — atomic rewrites — still picks up the change). Returns `'missing'`
- * when the file can't be read so the cache key is still deterministic.
+ * Cheap content-hash readout. SHA-256 prefix of the FULLY-RESOLVED theme
+ * CSS — `@import`s flattened — so an edit to a theme file the entry only
+ * re-exports (`@import "@acme/ui/theme.css"`) still rotates the hash and
+ * invalidates Metro's cache. Returns `'missing'` when the entry can't be
+ * read so the cache key stays deterministic.
  * @param cssPath Absolute CSS path.
  * @returns 16-char hex content hash.
  */
 function readThemeHashFor(cssPath: string): string {
   if (!existsSync(cssPath)) return 'missing'
   try {
-    const bytes = readFileSync(cssPath)
-    const mtime = statSync(cssPath).mtimeMs.toString()
-    return createHash('sha256').update(bytes).update(mtime).digest('hex').slice(0, 16)
+    return createHash('sha256').update(resolveThemeCss(cssPath)).digest('hex').slice(0, 16)
   } catch {
     return 'missing'
   }
@@ -240,7 +240,7 @@ export function getRnwindState(projectRoot: string): RnwindState {
   if (!cacheDir) throw new Error('rnwind: RNWIND_CACHE_DIR is not set — did `withRnwindConfig` run?')
   const currentHash = readThemeHashFor(cssEntry)
   if (cached?.themeHash === currentHash && cached.projectRoot === projectRoot) return cached
-  const themeCss = readFileSync(cssEntry, 'utf8')
+  const themeCss = resolveThemeCss(cssEntry)
   const parser = new TailwindParser({
     themeCss,
     sources: defaultSources(projectRoot, cacheDir, readWatchFolders()),