rnwind 0.0.1 → 0.0.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"dts.mjs","sources":["../../../../src/metro/dts.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs'\nimport path from 'node:path'\n\n/**\n * React Native component-props interfaces rnwind augments. Adding an\n * optional `className?: string` to each lets TypeScript accept\n * `<View className=\"…\" />` without the user touching types by hand.\n * The generic ones are written with a placeholder so the output type\n * stays parameterised.\n */\nconst INTERFACES: ReadonlyArray<string | { name: string; generic: string }> = [\n  'ViewProps',\n  'TextProps',\n  'ImageProps',\n  'ImageBackgroundProps',\n  'ScrollViewProps',\n  'PressableProps',\n  'ModalProps',\n  'TextInputProps',\n  'TouchableOpacityProps',\n  'TouchableHighlightProps',\n  'TouchableNativeFeedbackProps',\n  'TouchableWithoutFeedbackProps',\n  'SafeAreaViewProps',\n  'KeyboardAvoidingViewProps',\n  'RefreshControlProps',\n  'StatusBarProps',\n  'SwitchProps',\n  'ActivityIndicatorProps',\n  'SectionListProps',\n  { name: 'FlatListProps', generic: 'ItemT' },\n  { name: 'VirtualizedListProps', generic: 'ItemT' },\n]\n\n/**\n * Built-in prefix wired into every install. Restricted to the interfaces\n * that natively expose `contentContainerStyle` so TypeScript doesn't\n * start accepting `<View contentContainerClassName=\"…\" />` — RN would\n * silently ignore it at runtime and a typed lint is more useful than a\n * permissive one. User prefixes don't come with this restriction; rnwind\n * can't know which component props they target.\n */\nconst BUILTIN_PREFIX = 'contentContainer'\n\n/**\n * Interfaces that expose `contentContainerStyle` in React Native's own\n * types — the set the built-in prefix's `.d.ts` augmentation targets.\n * Everything else stays `className`-only by default.\n */\nconst CONTENT_CONTAINER_INTERFACES: ReadonlySet<string> = new Set([\n  'ScrollViewProps',\n  'FlatListProps',\n  'SectionListProps',\n  'VirtualizedListProps',\n])\n\n/**\n * Build the body of one interface augmentation: `className?: string`\n * plus `<prefix>ClassName?: string` for every prefix that applies to\n * THIS interface. Emits a single-line body so the file stays easy to\n * scan and diff.\n * @param interfaceName Bare interface name (generic parameters stripped).\n * @param userPrefixes Extra prefixes from the Metro config — applied to\n *   every interface the same way `className` is.\n * @returns Space-separated property declarations.\n */\nfunction buildInterfaceBody(interfaceName: string, userPrefixes: readonly string[]): string {\n  const props = ['className?: string']\n  if (CONTENT_CONTAINER_INTERFACES.has(interfaceName)) props.push(`${BUILTIN_PREFIX}ClassName?: string`)\n  for (const prefix of userPrefixes) {\n    if (prefix === BUILTIN_PREFIX) continue\n    props.push(`${prefix}ClassName?: string`)\n  }\n  return props.join('; ')\n}\n\n/**\n * Write the rnwind TypeScript declaration file. The generated `.d.ts`\n * declares a `rnwind` module augmentation for `react-native`'s\n * component props — every interface gets an optional `className?:\n * string` plus `<prefix>ClassName?: string` for each active prefix.\n * Runtime-rendered schemes (`@variant` blocks) are reflected in the\n * `Scheme` union so `useScheme()` returns the actual names.\n *\n * Called once at Metro-config time — overwrite-on-rewrite so the file\n * stays in sync with the user's current theme CSS + prefix config.\n * @param targetPath Absolute path to write (typically `rnwind-types.d.ts` at project root).\n * @param schemes Scheme names from the user's `@variant` blocks (empty when none declared).\n * @param classNamePrefixes Extra prefixes from the Metro config — merged\n *   on top of the built-in `'contentContainer'`. Defaults to empty.\n */\nexport function writeDtsFile(\n  targetPath: string,\n  schemes: readonly string[],\n  classNamePrefixes: readonly string[] = [],\n): void {\n  const lines: string[] = [\n    '// Auto-generated by rnwind — do not edit by hand.',\n    '// Overwritten on Metro start / theme CSS change.',\n    '',\n    `declare module 'react-native' {`,\n  ]\n  for (const entry of INTERFACES) {\n    const name = typeof entry === 'string' ? entry : entry.name\n    const body = buildInterfaceBody(name, classNamePrefixes)\n    if (typeof entry === 'string') {\n      lines.push(`  interface ${entry} { ${body} }`)\n      continue\n    }\n    lines.push(`  interface ${entry.name}<${entry.generic}> { ${body} }`)\n  }\n  lines.push('}', '')\n  if (schemes.length > 0) {\n    lines.push(`declare module 'rnwind' {`, `  export interface RnwindConfig {`)\n    const schemeLiterals = schemes.map((s) => `'${s}'`).join(', ')\n    lines.push(`    themes: readonly [${schemeLiterals}]`, `  }`, '}', '')\n  }\n  // The `export {}` is mandatory — without at least one top-level\n  // import/export, TypeScript treats this file as a SCRIPT and the\n  // `declare module 'react-native'` block above becomes a complete\n  // *replacement* declaration (hiding the real RN exports like\n  // `Pressable`, `useColorScheme`, etc.). With `export {}` the file\n  // becomes a module and the `declare module` blocks are interpreted as\n  // *augmentations* — which is what we want.\n  lines.push('export {}', '')\n  mkdirSync(path.dirname(targetPath), { recursive: true })\n  writeFileSync(targetPath, lines.join('\\n'), 'utf8')\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+export { withRnwindConfig } from './with-config';
+export type { RnwindMetroOptions, MetroConfigLike } from './with-config';
+export { createRnwindResolver } from './resolver';
+export type { ResolveRequestFn } from './resolver';
+export { writeDtsFile } from './dts';
+export { transform } from './transformer';
+export type { BabelTransformerArgs, BabelTransformerResult } from './transformer';
+export { getRnwindState, configureRnwindState, resetRnwindState, manifestPathFor } from './state';
+export type { RnwindState } from './state';

package/lib/esm/metro/index.mjs

@@ -0,0 +1,6 @@
+export { withRnwindConfig } from './with-config.mjs';
+export { createRnwindResolver } from './resolver.mjs';
+export { writeDtsFile } from './dts.mjs';
+export { transform } from './transformer.mjs';
+export { configureRnwindState, getRnwindState, manifestPathFor, resetRnwindState } from './state.mjs';
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

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

@@ -0,0 +1,22 @@
+/** Metro `resolveRequest` callable shape. Loose so we don't bind to Metro's internal types. */
+export type ResolveRequestFn = (context: unknown, moduleName: string, platform: string | null) => unknown;
+/**
+ * Sentinel module specifier the transformer prepends to every rewritten
+ * file. The resolver maps it to the user's theme CSS so Metro watches
+ * that file as a real node in the dependency graph — when the user
+ * edits `global.css`, the CSS file's SHA1 changes, and Metro
+ * invalidates every JS file that imports the sentinel. The transformer
+ * recognises `.css` filenames and returns an empty `export {}` AST so
+ * Metro can still bundle it.
+ */
+export declare const THEME_SIGNATURE_MODULE = "rnwind/__generated/theme-signature";
+/**
+ * Build a Metro `resolveRequest` hook that maps the scheme manifest
+ * specifier (and the theme-signature sentinel) to its on-disk path.
+ * Delegates every other request to the upstream resolver.
+ * @param upstream Previously-registered `resolveRequest` (kept in the chain).
+ * @returns Metro-compatible resolver.
+ */
+export declare function createRnwindResolver(upstream: ResolveRequestFn | null | undefined): ResolveRequestFn;
+/** Side-effect import specifier(s) the transformer injects on every rewritten file. */
+export declare const STYLE_SPECIFIERS: readonly ["rnwind/__generated/schemes"];

package/lib/esm/metro/resolver.mjs

@@ -0,0 +1,43 @@
+import { manifestPathFor } from './state.mjs';
+
+/** Specifier the transformer prepends — resolves to the scheme manifest. */
+const SCHEMES_MODULE = 'rnwind/__generated/schemes';
+/**
+ * Sentinel module specifier the transformer prepends to every rewritten
+ * file. The resolver maps it to the user's theme CSS so Metro watches
+ * that file as a real node in the dependency graph — when the user
+ * edits `global.css`, the CSS file's SHA1 changes, and Metro
+ * invalidates every JS file that imports the sentinel. The transformer
+ * recognises `.css` filenames and returns an empty `export {}` AST so
+ * Metro can still bundle it.
+ */
+const THEME_SIGNATURE_MODULE = 'rnwind/__generated/theme-signature';
+/**
+ * Build a Metro `resolveRequest` hook that maps the scheme manifest
+ * specifier (and the theme-signature sentinel) to its on-disk path.
+ * Delegates every other request to the upstream resolver.
+ * @param upstream Previously-registered `resolveRequest` (kept in the chain).
+ * @returns Metro-compatible resolver.
+ */
+function createRnwindResolver(upstream) {
+    return (context, moduleName, platform) => {
+        if (moduleName === SCHEMES_MODULE)
+            return { type: 'sourceFile', filePath: manifestPathFor() };
+        if (moduleName === THEME_SIGNATURE_MODULE) {
+            const cssPath = process.env.RNWIND_CSS_ENTRY_FILE;
+            if (cssPath)
+                return { type: 'sourceFile', filePath: cssPath };
+        }
+        if (upstream)
+            return upstream(context, moduleName, platform);
+        const { resolveRequest } = context;
+        if (resolveRequest)
+            return resolveRequest(context, moduleName, platform);
+        return null;
+    };
+}
+/** Side-effect import specifier(s) the transformer injects on every rewritten file. */
+const STYLE_SPECIFIERS = [SCHEMES_MODULE];
+
+export { STYLE_SPECIFIERS, THEME_SIGNATURE_MODULE, createRnwindResolver };
+//# sourceMappingURL=resolver.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.mjs","sources":["../../../../src/metro/resolver.ts"],"sourcesContent":["import { manifestPathFor } from './state'\n\n/** Specifier the transformer prepends — resolves to the scheme manifest. */\nconst SCHEMES_MODULE = 'rnwind/__generated/schemes'\n\n/** Metro `resolveRequest` callable shape. Loose so we don't bind to Metro's internal types. */\nexport type ResolveRequestFn = (context: unknown, moduleName: string, platform: string | null) => unknown\n\n/**\n * Sentinel module specifier the transformer prepends to every rewritten\n * file. The resolver maps it to the user's theme CSS so Metro watches\n * that file as a real node in the dependency graph — when the user\n * edits `global.css`, the CSS file's SHA1 changes, and Metro\n * invalidates every JS file that imports the sentinel. The transformer\n * recognises `.css` filenames and returns an empty `export {}` AST so\n * Metro can still bundle it.\n */\nexport const THEME_SIGNATURE_MODULE = 'rnwind/__generated/theme-signature'\n\n/**\n * Build a Metro `resolveRequest` hook that maps the scheme manifest\n * specifier (and the theme-signature sentinel) to its on-disk path.\n * Delegates every other request to the upstream resolver.\n * @param upstream Previously-registered `resolveRequest` (kept in the chain).\n * @returns Metro-compatible resolver.\n */\nexport function createRnwindResolver(upstream: ResolveRequestFn | null | undefined): ResolveRequestFn {\n  return (context, moduleName, platform) => {\n    if (moduleName === SCHEMES_MODULE) return { type: 'sourceFile', filePath: manifestPathFor() }\n    if (moduleName === THEME_SIGNATURE_MODULE) {\n      const cssPath = process.env.RNWIND_CSS_ENTRY_FILE\n      if (cssPath) return { type: 'sourceFile', filePath: cssPath }\n    }\n    if (upstream) return upstream(context, moduleName, platform)\n    const { resolveRequest } = context as { resolveRequest?: ResolveRequestFn }\n    if (resolveRequest) return resolveRequest(context, moduleName, platform)\n    return null as unknown\n  }\n}\n\n/** Side-effect import specifier(s) the transformer injects on every rewritten file. */\nexport const STYLE_SPECIFIERS = [SCHEMES_MODULE] as const\n"],"names":[],"mappings":";;AAEA;AACA,MAAM,cAAc,GAAG,4BAA4B;AAKnD;;;;;;;;AAQG;AACI,MAAM,sBAAsB,GAAG;AAEtC;;;;;;AAMG;AACG,SAAU,oBAAoB,CAAC,QAA6C,EAAA;AAChF,IAAA,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,KAAI;QACvC,IAAI,UAAU,KAAK,cAAc;YAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE;AAC7F,QAAA,IAAI,UAAU,KAAK,sBAAsB,EAAE;AACzC,YAAA,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB;AACjD,YAAA,IAAI,OAAO;gBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE;QAC/D;AACA,QAAA,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC;AAC5D,QAAA,MAAM,EAAE,cAAc,EAAE,GAAG,OAAgD;AAC3E,QAAA,IAAI,cAAc;YAAE,OAAO,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC;AACxE,QAAA,OAAO,IAAe;AACxB,IAAA,CAAC;AACH;AAEA;AACO,MAAM,gBAAgB,GAAG,CAAC,cAAc;;;;"}

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

@@ -0,0 +1,88 @@
+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.
+ * @param hostSources
+ * @param hostComponents
+ */
+export declare function configureRnwindState(cssEntryFile: string, cacheDir: string, watchFolders?: readonly string[], classNamePrefixes?: readonly string[], hostSources?: readonly string[], hostComponents?: 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[];
+/**
+ * Read the caller-configured extra host module sources out of the
+ * worker environment. Empty array when unset — the transformer applies
+ * its built-in default list on top either way.
+ * @returns User-supplied extra host sources.
+ */
+export declare function getHostSources(): readonly string[];
+/**
+ * Read the caller-configured extra host JSX tag names out of the worker
+ * environment. Verbatim names — may include `.` for member expressions
+ * like `'Animated.View'`.
+ * @returns User-supplied extra host component names.
+ */
+export declare function getHostComponents(): 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,291 @@
+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';
+/** Env var carrying extra import sources whose JSX exports get className→style rewrites. Comma-separated. */
+const HOST_SOURCES_ENV = 'RNWIND_HOST_SOURCES';
+/** Env var carrying extra JSX tag names (verbatim, may contain `.`) treated as hosts. Comma-separated. */
+const HOST_COMPONENTS_ENV = 'RNWIND_HOST_COMPONENTS';
+/** 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.
+ * @param hostSources
+ * @param hostComponents
+ */
+function configureRnwindState(cssEntryFile, cacheDir, watchFolders = [], classNamePrefixes, hostSources, hostComponents) {
+    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(',');
+    }
+    if (!hostSources || hostSources.length === 0) {
+        delete process.env[HOST_SOURCES_ENV];
+    }
+    else {
+        process.env[HOST_SOURCES_ENV] = hostSources.join(',');
+    }
+    if (!hostComponents || hostComponents.length === 0) {
+        delete process.env[HOST_COMPONENTS_ENV];
+    }
+    else {
+        process.env[HOST_COMPONENTS_ENV] = hostComponents.join(',');
+    }
+    cached = null;
+}
+/**
+ * Read the caller-configured extra className prefixes out of the
+ * worker environment. Returns an empty array when unset — the
+ * transformer applies the built-in `contentContainer` default on top
+ * either way.
+ * @returns User-supplied extra prefixes.
+ */
+function getClassNamePrefixes() {
+    const raw = process.env[CLASSNAME_PREFIXES_ENV];
+    if (!raw || raw.length === 0)
+        return [];
+    return raw.split(',').filter((entry) => entry.length > 0);
+}
+/**
+ * Read the caller-configured extra host module sources out of the
+ * worker environment. Empty array when unset — the transformer applies
+ * its built-in default list on top either way.
+ * @returns User-supplied extra host sources.
+ */
+function getHostSources() {
+    const raw = process.env[HOST_SOURCES_ENV];
+    if (!raw || raw.length === 0)
+        return [];
+    return raw.split(',').filter((entry) => entry.length > 0);
+}
+/**
+ * Read the caller-configured extra host JSX tag names out of the worker
+ * environment. Verbatim names — may include `.` for member expressions
+ * like `'Animated.View'`.
+ * @returns User-supplied extra host component names.
+ */
+function getHostComponents() {
+    const raw = process.env[HOST_COMPONENTS_ENV];
+    if (!raw || raw.length === 0)
+        return [];
+    return raw.split(',').filter((entry) => entry.length > 0);
+}
+/**
+ * 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] ?? '';
+    // Host source / component config changes which JSX tags get rewritten,
+    // so it MUST flip the cache key — otherwise Metro replays stale
+    // transforms (a newly-opted-in host keeps its raw className, a removed
+    // one keeps the rewrite).
+    const hostSources = process.env[HOST_SOURCES_ENV] ?? '';
+    const hostComponents = process.env[HOST_COMPONENTS_ENV] ?? '';
+    return `rnwind:${cssEntry}:${readThemeHashFor(cssEntry)}|lib:${getLibraryFingerprint()}|pfx:${prefixes}|hs:${hostSources}|hc:${hostComponents}`;
+}
+/** 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, getHostComponents, getHostSources, 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/** 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":"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"}

package/lib/esm/metro/transform-ast.d.ts

@@ -0,0 +1,88 @@
+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[];
+    /**
+     * Extra module specifiers whose JSX exports the transformer should
+     * treat as hosts (rewrite `className` → `style` at compile time).
+     * Merged with the built-in {@link DEFAULT_HOST_SOURCES} list. Use
+     * this for design-system packages whose primitives wrap RN hosts and
+     * accept `style` directly.
+     */
+    hostSources?: readonly string[];
+    /**
+     * Extra component names (verbatim, including dotted member access
+     * like `'Animated.View'`) the transformer should treat as hosts. Use
+     * this for one-off escape-hatches that aren't matchable by source —
+     * e.g. you alias `View as MyBox` and want the compile-time path.
+     */
+    hostComponents?: 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;