rnwind 0.0.1 → 0.0.2

package/lib/esm/metro/state.d.ts

@@ -0,0 +1,72 @@
+import { UnionBuilder } from '../core/style-builder';
+import { TailwindParser } from '../core/parser';
+/**
+ * Worker-local state. Lazy-initialised on first access so files that
+ * bypass the transform don't pay for construction.
+ */
+export interface RnwindState {
+    parser: TailwindParser;
+    builder: UnionBuilder;
+    themeCss: string;
+    themeHash: string;
+    projectRoot: string;
+}
+/**
+ * Publish the theme CSS path + cache dir to the environment so worker
+ * subprocesses (spawned by Metro once `babelTransformerPath` is set)
+ * 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.
+ */
+export declare function configureRnwindState(cssEntryFile: string, cacheDir: string, watchFolders?: readonly string[], classNamePrefixes?: readonly string[]): void;
+/**
+ * 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.
+ */
+export declare function getClassNamePrefixes(): readonly string[];
+/**
+ * Fetch (or build) the worker-local rnwind state. Re-reads the theme
+ * CSS hash on every call: if the user edited `global.css` while Metro
+ * is running, the cached state is dropped and a fresh parser + ledger
+ * is built. Combined with the `getCacheKey()` export on the
+ * transformer (which folds the same hash into Metro's per-file cache
+ * key) every CSS edit produces a full, correct re-bundle.
+ * @param projectRoot
+ * @returns The live rnwind state.
+ */
+export declare function getRnwindState(projectRoot: string): RnwindState;
+/**
+ * Compute the rnwind cache-key suffix Metro mixes into every per-file
+ * transform cache entry via the transformer's `getCacheKey()` export.
+ * Includes the CSS path + its current content hash + the rnwind
+ * library fingerprint, so any edit to `global.css` OR a library
+ * upgrade flips the cache key and forces Metro to re-run the
+ * transformer.
+ * @returns Deterministic string suitable for appending to Metro's cache key.
+ */
+export declare function getRnwindCacheKey(): string;
+/** Drop the cached state — call after editing the theme CSS. */
+export declare function resetRnwindState(): void;
+/**
+ * Drop cached state, rebuild parser/builder with the fresh CSS, rescan
+ * the project, and rewrite every scheme file on disk. This is what
+ * `withRnwindConfig`'s CSS file-watcher invokes so `global.css` edits
+ * propagate to the app via Metro's HMR — without this, the CSS-as-JS
+ * module would re-emit `export {}` whose bytes never change, so Metro
+ * would never invalidate downstream modules.
+ * @param projectRoot Absolute project root (from `metroConfig.projectRoot`).
+ */
+export declare function onThemeChange(projectRoot: string): Promise<void>;
+/**
+ * Resolve the on-disk path of the scheme manifest module for the
+ * resolver. The manifest eager-imports `common.style.js` and
+ * lazy-requires each variant scheme; SchemeProvider calls its
+ * `ensureSchemeLoaded` export to trigger per-scheme requires.
+ * @returns Absolute path to `<cacheDir>/schemes.js`.
+ */
+export declare function manifestPathFor(): string;

package/lib/esm/metro/state.mjs

@@ -0,0 +1,243 @@
+import { readFileSync, existsSync, statSync } 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';
+
+/**
+ * Default oxide Scanner globs — walk every JS/TS source under the
+ * project root AND every monorepo watch folder, excluding
+ * `node_modules` and rnwind's own cache dir so we don't rescan
+ * generated scheme files.
+ *
+ * Monorepo layouts (Yarn workspaces, pnpm workspaces, Nx) surface
+ * sibling package roots as `metroConfig.watchFolders`. Every folder
+ * Metro watches must also be scanned so atoms declared in shared UI
+ * packages make it into the union — without this, only the app's
+ * own files would be scanned and every UI-package atom would resolve
+ * to `undefined` at runtime.
+ * @param projectRoot Absolute project root.
+ * @param cacheDir Absolute rnwind cache dir (to exclude).
+ * @param watchFolders Extra monorepo roots Metro is watching.
+ * @returns Scanner sources suitable for `parser.parseProject()`.
+ */
+function defaultSources(projectRoot, cacheDir, watchFolders) {
+    const cacheBaseName = path.basename(cacheDir);
+    const roots = new Set([projectRoot, ...watchFolders]);
+    const sources = [];
+    for (const root of roots) {
+        sources.push({ base: root, pattern: '**/*.{ts,tsx,js,jsx}', negated: false }, { base: root, pattern: '**/node_modules/**', negated: true }, { base: root, pattern: `**/${cacheBaseName}/**`, negated: true });
+    }
+    return sources;
+}
+/**
+ * Read monorepo watch-folder paths out of the worker environment.
+ * Empty array when the host isn't a monorepo.
+ * @returns Absolute paths Metro also watches (sibling packages).
+ */
+function readWatchFolders() {
+    const raw = process.env[WATCH_FOLDERS_ENV];
+    if (!raw || raw.length === 0)
+        return [];
+    return raw.split('\0').filter((entry) => entry.length > 0);
+}
+/** Env var Metro workers read to locate the theme CSS on disk. */
+const CSS_ENTRY_ENV = 'RNWIND_CSS_ENTRY_FILE';
+/** Env var Metro workers read to locate the cache directory (`.rnwind`). */
+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';
+/** Memoised library fingerprint — read once per worker process. */
+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.
+ * @param cssPath Absolute CSS path.
+ * @returns 16-char hex content hash.
+ */
+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);
+    }
+    catch {
+        return 'missing';
+    }
+}
+/**
+ * Hash a small set of rnwind library files whose changes affect the
+ * generated transform output. When the library is rebuilt (workspace
+ * 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
+ * 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"
+ * runtime errors.
+ * Memoised — read once per worker process.
+ * @returns 16-char hex fingerprint.
+ */
+function getLibraryFingerprint() {
+    if (libraryFingerprint !== undefined)
+        return libraryFingerprint;
+    const here = path.dirname(__filename);
+    const candidates = [
+        path.resolve(here, '..', 'core', 'style-builder', 'build-style.mjs'),
+        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, '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', 'transformer.ts'),
+    ];
+    const hash = createHash('sha256');
+    let included = 0;
+    for (const file of candidates) {
+        if (!existsSync(file))
+            continue;
+        try {
+            hash.update(readFileSync(file));
+            included += 1;
+        }
+        catch {
+            // Unreadable file — skip; fingerprint still derives from whatever WE could read.
+        }
+    }
+    libraryFingerprint = included > 0 ? hash.digest('hex').slice(0, 16) : '0'.repeat(16);
+    return libraryFingerprint;
+}
+/**
+ * Publish the theme CSS path + cache dir to the environment so worker
+ * subprocesses (spawned by Metro once `babelTransformerPath` is set)
+ * 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.
+ */
+function configureRnwindState(cssEntryFile, cacheDir, watchFolders = [], classNamePrefixes) {
+    process.env[CSS_ENTRY_ENV] = cssEntryFile;
+    process.env[CACHE_DIR_ENV] = cacheDir;
+    if (watchFolders.length === 0) {
+        delete process.env[WATCH_FOLDERS_ENV];
+    }
+    else {
+        process.env[WATCH_FOLDERS_ENV] = watchFolders.join('\0');
+    }
+    if (!classNamePrefixes || classNamePrefixes.length === 0) {
+        delete process.env[CLASSNAME_PREFIXES_ENV];
+    }
+    else {
+        process.env[CLASSNAME_PREFIXES_ENV] = classNamePrefixes.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);
+}
+/**
+ * Fetch (or build) the worker-local rnwind state. Re-reads the theme
+ * CSS hash on every call: if the user edited `global.css` while Metro
+ * is running, the cached state is dropped and a fresh parser + ledger
+ * is built. Combined with the `getCacheKey()` export on the
+ * transformer (which folds the same hash into Metro's per-file cache
+ * key) every CSS edit produces a full, correct re-bundle.
+ * @param projectRoot
+ * @returns The live rnwind state.
+ */
+function getRnwindState(projectRoot) {
+    const cssEntry = process.env[CSS_ENTRY_ENV];
+    const cacheDir = process.env[CACHE_DIR_ENV];
+    if (!cssEntry)
+        throw new Error('rnwind: RNWIND_CSS_ENTRY_FILE is not set — did `withRnwindConfig` run?');
+    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 parser = new TailwindParser({
+        themeCss,
+        sources: defaultSources(projectRoot, cacheDir, readWatchFolders()),
+    });
+    const builder = new UnionBuilder(cacheDir, parser);
+    cached = { parser, builder, themeCss, themeHash: currentHash, projectRoot };
+    return cached;
+}
+/**
+ * Compute the rnwind cache-key suffix Metro mixes into every per-file
+ * transform cache entry via the transformer's `getCacheKey()` export.
+ * Includes the CSS path + its current content hash + the rnwind
+ * library fingerprint, so any edit to `global.css` OR a library
+ * upgrade flips the cache key and forces Metro to re-run the
+ * transformer.
+ * @returns Deterministic string suitable for appending to Metro's cache key.
+ */
+function getRnwindCacheKey() {
+    const cssEntry = process.env[CSS_ENTRY_ENV] ?? '';
+    const prefixes = process.env[CLASSNAME_PREFIXES_ENV] ?? '';
+    return `rnwind:${cssEntry}:${readThemeHashFor(cssEntry)}|lib:${getLibraryFingerprint()}|pfx:${prefixes}`;
+}
+/** Drop the cached state — call after editing the theme CSS. */
+function resetRnwindState() {
+    cached = null;
+}
+/**
+ * Drop cached state, rebuild parser/builder with the fresh CSS, rescan
+ * the project, and rewrite every scheme file on disk. This is what
+ * `withRnwindConfig`'s CSS file-watcher invokes so `global.css` edits
+ * propagate to the app via Metro's HMR — without this, the CSS-as-JS
+ * module would re-emit `export {}` whose bytes never change, so Metro
+ * would never invalidate downstream modules.
+ * @param projectRoot Absolute project root (from `metroConfig.projectRoot`).
+ */
+async function onThemeChange(projectRoot) {
+    resetRnwindState();
+    const state = getRnwindState(projectRoot);
+    await state.builder.writeSchemes();
+}
+/**
+ * Resolve the on-disk path of the scheme manifest module for the
+ * resolver. The manifest eager-imports `common.style.js` and
+ * lazy-requires each variant scheme; SchemeProvider calls its
+ * `ensureSchemeLoaded` export to trigger per-scheme requires.
+ * @returns Absolute path to `<cacheDir>/schemes.js`.
+ */
+function manifestPathFor() {
+    const cacheDir = process.env[CACHE_DIR_ENV];
+    if (!cacheDir)
+        throw new Error('rnwind: RNWIND_CACHE_DIR is not set');
+    return path.join(cacheDir, 'schemes.js');
+}
+
+export { configureRnwindState, getClassNamePrefixes, getRnwindCacheKey, getRnwindState, manifestPathFor, onThemeChange, resetRnwindState };
+//# sourceMappingURL=state.mjs.map

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

@@ -0,0 +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\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 */\nexport function configureRnwindState(\n  cssEntryFile: string,\n  cacheDir: string,\n  watchFolders: readonly string[] = [],\n  classNamePrefixes?: 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  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 * 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  return `rnwind:${cssEntry}:${readThemeHashFor(cssEntry)}|lib:${getLibraryFingerprint()}|pfx:${prefixes}`\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/transform-ast.d.ts

@@ -0,0 +1,73 @@
+import type { File } from '@babel/types';
+import type { GradientAtomInfo, HapticRequest } from '../core/parser';
+/** Name of the runtime atom-registration entry point imported by the union style file. */
+export declare const REGISTER_ATOMS = "registerAtoms";
+/** Per-file state returned by the transformer, for the caller to integrate with the atom ledger. */
+export interface TransformAstResult {
+    /** `true` when the AST was mutated (any `className=` rewrite landed). */
+    touched: boolean;
+    /** Atom-name arrays the transformer hoisted — one entry per unique atom set. */
+    hoistedArrays: ReadonlyMap<string, readonly string[]>;
+    /** Candidate literal texts collected from every rewritten `className`. */
+    literals: readonly string[];
+}
+/** Inputs to {@link transformAst}. */
+export interface TransformAstOptions {
+    /**
+     * Module specifiers the transformer side-effect-imports at the top
+     * of each rewritten file. Today: the union `style.js` and
+     * `keyframes.js` (always two entries — see `STYLE_SPECIFIERS` in
+     * resolver.ts). Empty when the file has no atoms to register.
+     */
+    styleSpecifiers: readonly string[];
+    /**
+     * Parser-surfaced gradient metadata per atom. The transformer reads
+     * this map when rewriting literal `className="..."` sites so it can
+     * strip gradient atoms out of the atom array fed to `lookupCss` and
+     * emit `colors={...} start={...} end={...}` JSX attributes consumed
+     * by `<LinearGradient>` (or any component with the expo prop shape).
+     */
+    gradientAtoms?: ReadonlyMap<string, GradientAtomInfo>;
+    /**
+     * Parser-surfaced haptic metadata per atom. Keys are the full class
+     * name (including any variant prefix — `haptic-light`,
+     * `active:haptic-medium`). Values are the structured
+     * {@link HapticRequest}. The transformer strips matched atoms from
+     * the className, aggregates mount requests per enclosing component,
+     * and wires press-in chains directly on the element.
+     */
+    hapticAtoms?: ReadonlyMap<string, HapticRequest>;
+    /**
+     * Extra prop-name prefixes that turn `<prefix>ClassName="…"` into
+     * `<prefix>Style={lookupCss(…)}` with the same plumbing as the plain
+     * `className` path. The built-in `'contentContainer'` prefix is always
+     * enabled (covers ScrollView / FlatList / SectionList) — entries here
+     * are additive, not a replacement. A user-supplied `['myFunny']` yields
+     * the effective set `['contentContainer', 'myFunny']`.
+     *
+     * Prefixed rewrites never go through `<InteractiveBox>`: the targeted
+     * sub-surfaces (scroll content containers, column wrappers, etc.)
+     * can't fire press / focus events, so we always emit the inline
+     * `lookupCss(…)` call regardless of whether the expression is static
+     * or dynamic.
+     */
+    classNamePrefixes?: readonly string[];
+}
+/**
+ * Mutate an already-parsed Babel AST in place:
+ *  - Rewrite every JSX `className="…"` / `className={expr}` attribute to
+ *    `style={lookupCss(<ref|expr>, _s, <existingStyle>)}`. Static string
+ *    literals get a module-scope `const _c_<hash> = Object.freeze(['a',
+ *    'b'])` hoist so React sees an identity-stable array across renders.
+ *  - Preserve any adjacent `style={…}` prop — it becomes the third
+ *    argument so user inline styles keep working (and trump atoms).
+ *  - Inject `const _s = useScheme()` at the top of the enclosing
+ *    function component (idempotent — one injection per component).
+ *  - Prepend `import { lookupCss, useScheme } from 'rnwind'`.
+ *  - Prepend a side-effect `import 'rnwind/__generated/style'` so the
+ *    union registry is loaded before any hoist runs.
+ * @param ast Babel File AST (usually handed to us by Metro).
+ * @param options Extra inputs — side-effect import specifiers + parser metadata.
+ * @returns Transform outcome flags + the hoist table.
+ */
+export declare function transformAst(ast: File, options: TransformAstOptions): TransformAstResult;