rnwind 0.0.4 → 0.0.5

package/lib/cjs/core/style-builder/build-style.d.ts

@@ -47,8 +47,13 @@ export type AtomSerializedCache = Map<string, AtomSerializedEntry>;
  *   manifest emits `registerBreakpoints({...})` so the runtime can gate
  *   `md:*` / `lg:*` atoms on `windowWidth`. Optional — empty when the
  *   theme declares no breakpoints (legacy/test callers).
+ * @param gradients Gradient feature map (atom → role/colour) for the manifest + molecule eligibility.
+ * @param haptics Haptic feature map (atom → request) for the manifest + molecule eligibility.
+ * @param literals Distinct literal className strings — pre-merged into
+ *   per-scheme molecules so the runtime resolver's O(1) molecule-first
+ *   path is populated. Empty for legacy/test callers (atom path only).
  * @returns Per-scheme sources, manifest source, variant list.
  */
-export declare function buildSchemeSources(atomNames: readonly string[], resolved: ReadonlyMap<string, SchemedStyle>, keyframes: ReadonlyMap<string, KeyframeBlock>, cache?: AtomSerializedCache, breakpoints?: ReadonlyMap<string, number>): BuildSchemeSourcesOutput;
+export declare function buildSchemeSources(atomNames: readonly string[], resolved: ReadonlyMap<string, SchemedStyle>, keyframes: ReadonlyMap<string, KeyframeBlock>, cache?: AtomSerializedCache, breakpoints?: ReadonlyMap<string, number>, gradients?: ReadonlyMap<string, unknown>, haptics?: ReadonlyMap<string, unknown>, literals?: readonly string[]): BuildSchemeSourcesOutput;
 /** Registry key the runtime uses for the always-loaded fallback. */
 export declare const COMMON_SCHEME_NAME: string;

package/lib/cjs/core/style-builder/union-builder.cjs

@@ -92,6 +92,17 @@ class UnionBuilder {
     parser;
     unionAtoms = new Map();
     unionKeyframes = new Map();
+    /** atom name → gradient role/colour, surfaced into the manifest's `registerGradients`. */
+    unionGradients = new Map();
+    /** atom name → haptic request, surfaced into the manifest's `registerHaptics`. */
+    unionHaptics = new Map();
+    /**
+     * Distinct literal className strings seen across all files, pre-merged
+     * into per-scheme molecules at write time. Accumulate-only (like
+     * `unionAtoms`): orphaned literals just yield unused molecules and get
+     * reaped on the next cold start, so no refcount is needed.
+     */
+    unionLiterals = new Set();
     /**
      * Responsive breakpoints captured from the parser. Refreshed on every
      * `recordFile` / `ensureProjectScanned` so user-defined
@@ -169,6 +180,10 @@ class UnionBuilder {
                 this.unionAtoms.set(name, style);
             for (const [name, kf] of parsed.keyframes)
                 this.unionKeyframes.set(name, kf);
+            for (const [name, gradient] of parsed.gradientAtoms)
+                this.unionGradients.set(name, gradient);
+            for (const [name, haptic] of parsed.hapticAtoms)
+                this.unionHaptics.set(name, haptic);
             this.breakpoints = parsed.breakpoints;
             this.projectScanned = true;
         })();
@@ -187,12 +202,14 @@ class UnionBuilder {
      * @param file Absolute source file path.
      * @param atoms Per-atom resolved schemed styles from this transform.
      * @param keyframes Keyframe blocks referenced by this file's atoms.
+     * @param literals
      * @returns `{ changed: true }` when the union shifted (new atom name,
      *   removed atom name, or new keyframe) — the transformer uses this
      *   to skip the serializer + `writeSchemes` when nothing changed.
      */
-    async recordFile(file, atoms, keyframes) {
+    async recordFile(file, atoms, keyframes, literals = []) {
         await this.ensureProjectScanned();
+        const literalAdded = this.recordLiterals(literals);
         const newAtomNames = new Set(atoms.keys());
         const previous = this.fileAtomSets.get(file);
         if (previous && setsEqual(previous, newAtomNames)) {
@@ -208,11 +225,28 @@ class UnionBuilder {
                     keyframeAdded = true;
                 this.unionKeyframes.set(name, kf);
             }
-            return { changed: keyframeAdded };
+            return { changed: keyframeAdded || literalAdded };
         }
         this.applyDiff(file, newAtomNames, atoms, keyframes);
         return { changed: true };
     }
+    /**
+     * Merge a file's literal classNames into the union. A literal the
+     * union hasn't seen flips `changed` so `writeSchemes` re-emits the
+     * scheme files with the new molecule.
+     * @param literals Distinct literal className strings.
+     * @returns Whether any literal was new to the union.
+     */
+    recordLiterals(literals) {
+        let added = false;
+        for (const literal of literals) {
+            if (this.unionLiterals.has(literal))
+                continue;
+            this.unionLiterals.add(literal);
+            added = true;
+        }
+        return added;
+    }
     /**
      * Forget one source file's contribution. Idempotent — repeated calls
      * for a file that's already dropped are no-ops. Does NOT remove the
@@ -244,7 +278,7 @@ class UnionBuilder {
     async writeSchemes() {
         await this.ensureProjectScanned();
         const sortedAtomNames = [...this.unionAtoms.keys()].toSorted((a, b) => a.localeCompare(b));
-        const result = buildStyle.buildSchemeSources(sortedAtomNames, this.unionAtoms, this.unionKeyframes, this.serializedCache, this.breakpoints);
+        const result = buildStyle.buildSchemeSources(sortedAtomNames, this.unionAtoms, this.unionKeyframes, this.serializedCache, this.breakpoints, this.unionGradients, this.unionHaptics, [...this.unionLiterals]);
         this.serializedMissesCount += result.serializedMisses;
         const { schemeSources, manifestSource } = result;
         const changed = [];

package/lib/cjs/core/style-builder/union-builder.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"union-builder.cjs","sources":["../../../../../src/core/style-builder/union-builder.ts"],"sourcesContent":["import { createHash, randomBytes } from 'node:crypto'\nimport { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'\nimport path from 'node:path'\nimport type { KeyframeBlock, SchemedStyle, TailwindParser } from '../parser'\nimport { buildSchemeSources, type AtomSerializedCache } from './build-style'\n\n/** Manifest module basename — the file SchemeProvider imports via the resolver. */\nconst MANIFEST_BASENAME = 'schemes.js'\n\n/**\n * Atomic file write — stage to a `.tmp.<pid>.<nonce>` sibling, then\n * `rename()` into place. Skips the write entirely when the existing\n * content matches.\n * @param target Final destination path.\n * @param content Bytes to write.\n * @returns Whether the file was actually rewritten.\n */\nfunction writeIfChanged(target: string, content: string): boolean {\n  if (existsSync(target)) {\n    try {\n      if (readFileSync(target, 'utf8') === content) return false\n    } catch {\n      // Unreadable — fall through to rewrite.\n    }\n  }\n  mkdirSync(path.dirname(target), { recursive: true })\n  const temporary = `${target}.${process.pid}.${randomBytes(4).toString('hex')}.tmp`\n  try {\n    writeFileSync(temporary, content, 'utf8')\n    renameSync(temporary, target)\n    return true\n  } catch (error) {\n    rmSync(temporary, { force: true })\n    throw error\n  }\n}\n\n/**\n * SHA-256 prefix of a string — cheap signature used to detect whether a\n * per-scheme file's source has changed since the last write.\n * @param text Input text.\n * @returns 16-char hex digest.\n */\nfunction signatureOf(text: string): string {\n  return createHash('sha256').update(text).digest('hex').slice(0, 16)\n}\n\n/**\n * Compare two `Set<string>`s for equality — same size + every element\n * of `a` present in `b`.\n * @param a First set.\n * @param b Second set.\n * @returns Whether the two sets contain identical values.\n */\nfunction setsEqual(a: ReadonlySet<string>, b: ReadonlySet<string>): boolean {\n  if (a.size !== b.size) return false\n  for (const v of a) if (!b.has(v)) return false\n  return true\n}\n\n/**\n * Compute the absolute path of a per-scheme style file under the cache dir.\n * @param cacheDir Absolute cache directory.\n * @param scheme Registry key (`'common'` or a variant name).\n * @returns Absolute path, e.g. `<cacheDir>/dark.style.js`.\n */\nfunction schemeFilePath(cacheDir: string, scheme: string): string {\n  return path.join(cacheDir, `${scheme}.style.js`)\n}\n\n/**\n * In-memory atom union + per-scheme style-file emitter.\n *\n * Correctness under multi-worker Metro relies on `ensureProjectScanned`:\n * the FIRST `recordFile` / `writeSchemes` call in every worker drives\n * the oxide Scanner across ALL project sources and hydrates the union\n * with the complete set of candidates. Subsequent per-file\n * `recordFile` calls only layer in atoms the scan already knew about,\n * so writes are idempotent — different workers can't clobber each\n * other's scheme files with partial views.\n *\n * Per-file deltas (atom set unchanged → early return) skip\n * serialization entirely. On a theme-CSS change, `getRnwindState`\n * builds a fresh parser + builder; the next call re-runs\n * `ensureProjectScanned` against the new parser, producing scheme\n * files with the new theme values.\n */\nclass UnionBuilder {\n  private readonly cacheDir: string\n  private readonly parser: TailwindParser\n  private readonly unionAtoms = new Map<string, SchemedStyle>()\n  private readonly unionKeyframes = new Map<string, KeyframeBlock>()\n  /**\n   * Responsive breakpoints captured from the parser. Refreshed on every\n   * `recordFile` / `ensureProjectScanned` so user-defined\n   * `--breakpoint-*` overrides land in the manifest the next time it's\n   * written. Identical for every parser call within one parser instance\n   * (theme is fixed for the parser's lifetime), so storing the latest\n   * snapshot is sufficient.\n   */\n  private breakpoints: ReadonlyMap<string, number> = new Map()\n  /** file → set of atom names this file currently contributes. */\n  private readonly fileAtomSets = new Map<string, Set<string>>()\n  /** atom name → how many files currently contribute it (refcount). */\n  private readonly atomRefCount = new Map<string, number>()\n  /** scheme → last-written source SHA. Skips re-writing unchanged schemes. */\n  private readonly schemeSignatures = new Map<string, string>()\n  /**\n   * Per-atom serialized-value cache — identity-keyed on each atom's\n   * SchemedStyle reference. Carried across `writeSchemes` calls so the\n   * typical \"user added one className\" FR case re-stringifies ONE atom\n   * instead of all 175+. Cleared on `ensureProjectScanned` (full\n   * rescan replaces every reference) and individually invalidated for\n   * any atom `applyDiff` mutates.\n   */\n  private readonly serializedCache: AtomSerializedCache = new Map()\n  /** Running count of stringify passes (cache misses). Test telemetry. */\n  private serializedMissesCount = 0\n  /** Set after `ensureProjectScanned` completes. */\n  private projectScanned = false\n  /** Promise guard so concurrent first-calls await ONE scan. */\n  private pendingScan: Promise<void> | null = null\n\n  constructor(cacheDir: string, parser: TailwindParser) {\n    this.cacheDir = cacheDir\n    this.parser = parser\n    mkdirSync(this.cacheDir, { recursive: true })\n  }\n\n  /** Absolute path of the manifest module (`rnwind/__generated/schemes`). */\n  public get manifestPath(): string {\n    return path.join(this.cacheDir, MANIFEST_BASENAME)\n  }\n\n  /**\n   * Snapshot of every source file the builder has recorded atoms for\n   * this worker session. Used by `withRnwindConfig`'s CSS watcher to\n   * touch `mtime` on each and nudge Metro into re-transforming them\n   * with the new theme values.\n   * @returns Absolute source paths.\n   */\n  public recordedFiles(): readonly string[] {\n    return [...this.fileAtomSets.keys()]\n  }\n\n  /** Cumulative cache-miss count — exposed for tests to assert cache behaviour. */\n  public get serializedMisses(): number {\n    return this.serializedMissesCount\n  }\n\n  /**\n   * Absolute path of one scheme's style file.\n   * @param scheme Registry key.\n   * @returns Absolute path.\n   */\n  public schemePath(scheme: string): string {\n    return schemeFilePath(this.cacheDir, scheme)\n  }\n\n  /**\n   * One-shot oxide scan + compile across every source the parser was\n   * configured with. Idempotent — safe to call from any entry point.\n   * Concurrent callers share the same in-flight promise.\n   */\n  public async ensureProjectScanned(): Promise<void> {\n    if (this.projectScanned) return\n    if (this.pendingScan) return this.pendingScan\n    this.pendingScan = (async () => {\n      const parsed = await this.parser.parseProject()\n      for (const [name, style] of parsed.atoms) this.unionAtoms.set(name, style)\n      for (const [name, kf] of parsed.keyframes) this.unionKeyframes.set(name, kf)\n      this.breakpoints = parsed.breakpoints\n      this.projectScanned = true\n    })()\n    try {\n      await this.pendingScan\n    } finally {\n      this.pendingScan = null\n    }\n  }\n\n  /**\n   * Record one source file's resolved atoms + keyframes. Short-circuits\n   * when the file's atom name set hasn't changed — the common case on\n   * every Fast Refresh save of a file whose className literals are\n   * unchanged.\n   * @param file Absolute source file path.\n   * @param atoms Per-atom resolved schemed styles from this transform.\n   * @param keyframes Keyframe blocks referenced by this file's atoms.\n   * @returns `{ changed: true }` when the union shifted (new atom name,\n   *   removed atom name, or new keyframe) — the transformer uses this\n   *   to skip the serializer + `writeSchemes` when nothing changed.\n   */\n  public async recordFile(\n    file: string,\n    atoms: ReadonlyMap<string, SchemedStyle>,\n    keyframes: ReadonlyMap<string, KeyframeBlock>,\n  ): Promise<{ changed: boolean }> {\n    await this.ensureProjectScanned()\n    const newAtomNames = new Set(atoms.keys())\n    const previous = this.fileAtomSets.get(file)\n    if (previous && setsEqual(previous, newAtomNames)) {\n      // Atom set unchanged — skip the unionAtoms update entirely. The\n      // project scan already populated them, and re-setting a fresh\n      // object ref here would invalidate the per-atom serialization\n      // cache on every FR save for no gain (values are identical).\n      // Theme edits go through `getRnwindState` → new builder → fresh\n      // scan, so stale cache is impossible.\n      let keyframeAdded = false\n      for (const [name, kf] of keyframes) {\n        if (!this.unionKeyframes.has(name)) keyframeAdded = true\n        this.unionKeyframes.set(name, kf)\n      }\n      return { changed: keyframeAdded }\n    }\n    this.applyDiff(file, newAtomNames, atoms, keyframes)\n    return { changed: true }\n  }\n\n  /**\n   * Forget one source file's contribution. Idempotent — repeated calls\n   * for a file that's already dropped are no-ops. Does NOT remove the\n   * atom from the union when another file (or the project scan) still\n   * references it.\n   * @param file Absolute source file path.\n   */\n  public dropFile(file: string): void {\n    const previous = this.fileAtomSets.get(file)\n    if (!previous) return\n    for (const name of previous) {\n      const count = (this.atomRefCount.get(name) ?? 0) - 1\n      if (count <= 0) this.atomRefCount.delete(name)\n      else this.atomRefCount.set(name, count)\n    }\n    this.fileAtomSets.delete(file)\n  }\n\n  /**\n   * Serialize the union into per-scheme files + manifest, writing only\n   * files whose source bytes changed. Called after every `recordFile`\n   * from the transformer — and once at Metro startup via\n   * `ensureFilesExist` to seed disk from the project scan alone.\n   * @returns List of scheme keys whose files were rewritten (empty\n   *   when the union is byte-identical to the last flush).\n   */\n  public async writeSchemes(): Promise<{ changedSchemes: readonly string[] }> {\n    await this.ensureProjectScanned()\n    const sortedAtomNames = [...this.unionAtoms.keys()].toSorted((a, b) => a.localeCompare(b))\n    const result = buildSchemeSources(sortedAtomNames, this.unionAtoms, this.unionKeyframes, this.serializedCache, this.breakpoints)\n    this.serializedMissesCount += result.serializedMisses\n    const { schemeSources, manifestSource } = result\n\n    const changed: string[] = []\n    for (const [scheme, source] of Object.entries(schemeSources)) {\n      const signature = signatureOf(source)\n      const target = schemeFilePath(this.cacheDir, scheme)\n      if (this.schemeSignatures.get(scheme) === signature && existsSync(target)) continue\n      if (writeIfChanged(target, source)) changed.push(scheme)\n      this.schemeSignatures.set(scheme, signature)\n    }\n\n    const manifestSignature = signatureOf(manifestSource)\n    const manifestTarget = path.join(this.cacheDir, MANIFEST_BASENAME)\n    if (this.schemeSignatures.get('__manifest') !== manifestSignature || !existsSync(manifestTarget)) {\n      if (writeIfChanged(manifestTarget, manifestSource)) changed.push('__manifest')\n      this.schemeSignatures.set('__manifest', manifestSignature)\n    }\n\n    return { changedSchemes: changed }\n  }\n\n  /**\n   * Ensure the manifest + common scheme files exist on disk so Metro's\n   * resolver can SHA1 them at boot before the first transform runs.\n   */\n  public async ensureFilesExist(): Promise<void> {\n    if (existsSync(this.manifestPath) && existsSync(schemeFilePath(this.cacheDir, 'common'))) {\n      // Still trigger the scan so the in-memory union is complete; file\n      // bytes may already be authoritative from a prior Metro run.\n      await this.ensureProjectScanned()\n      return\n    }\n    await this.writeSchemes()\n  }\n\n  /**\n   * Apply one file's atom-name diff to the in-memory refcount + union.\n   * @param file Source file path.\n   * @param newAtoms New atom-name set for the file.\n   * @param resolvedAtoms Fresh parser output — carries the resolved\n   *   styles for every entry in `newAtoms`.\n   * @param newKeyframes Keyframes this file's atoms reference.\n   */\n  private applyDiff(\n    file: string,\n    newAtoms: ReadonlySet<string>,\n    resolvedAtoms: ReadonlyMap<string, SchemedStyle>,\n    newKeyframes: ReadonlyMap<string, KeyframeBlock>,\n  ): void {\n    const previous = this.fileAtomSets.get(file) ?? new Set<string>()\n    for (const name of previous) {\n      if (newAtoms.has(name)) continue\n      const count = (this.atomRefCount.get(name) ?? 0) - 1\n      if (count <= 0) this.atomRefCount.delete(name)\n      else this.atomRefCount.set(name, count)\n      // Do NOT remove `name` from `unionAtoms` — the project scan still\n      // references it (orphaned atoms get reaped on the next Metro\n      // cold start when the scanner re-walks disk).\n    }\n    for (const name of newAtoms) {\n      if (!previous.has(name)) this.atomRefCount.set(name, (this.atomRefCount.get(name) ?? 0) + 1)\n      // Only install the resolved style when the atom is new to the\n      // union. Replacing an existing entry with a fresh parser-\n      // produced object would swap the identity guard the per-atom\n      // serialization cache uses and force a re-stringify for every\n      // atom on every FR save. CSS edits rebuild the whole builder\n      // (via `getRnwindState`) so stale values aren't possible.\n      if (!this.unionAtoms.has(name)) {\n        const style = resolvedAtoms.get(name)\n        if (style) this.unionAtoms.set(name, style)\n      }\n    }\n    this.fileAtomSets.set(file, new Set(newAtoms))\n    for (const [name, kf] of newKeyframes) this.unionKeyframes.set(name, kf)\n  }\n}\n\nexport { UnionBuilder }\n"],"names":["existsSync","readFileSync","mkdirSync","randomBytes","writeFileSync","renameSync","rmSync","createHash","buildSchemeSources"],"mappings":"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"}
+{"version":3,"file":"union-builder.cjs","sources":["../../../../../src/core/style-builder/union-builder.ts"],"sourcesContent":["import { createHash, randomBytes } from 'node:crypto'\nimport { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'\nimport path from 'node:path'\nimport type { GradientAtomInfo, HapticRequest, KeyframeBlock, SchemedStyle, TailwindParser } from '../parser'\nimport { buildSchemeSources, type AtomSerializedCache } from './build-style'\n\n/** Manifest module basename — the file SchemeProvider imports via the resolver. */\nconst MANIFEST_BASENAME = 'schemes.js'\n\n/**\n * Atomic file write — stage to a `.tmp.<pid>.<nonce>` sibling, then\n * `rename()` into place. Skips the write entirely when the existing\n * content matches.\n * @param target Final destination path.\n * @param content Bytes to write.\n * @returns Whether the file was actually rewritten.\n */\nfunction writeIfChanged(target: string, content: string): boolean {\n  if (existsSync(target)) {\n    try {\n      if (readFileSync(target, 'utf8') === content) return false\n    } catch {\n      // Unreadable — fall through to rewrite.\n    }\n  }\n  mkdirSync(path.dirname(target), { recursive: true })\n  const temporary = `${target}.${process.pid}.${randomBytes(4).toString('hex')}.tmp`\n  try {\n    writeFileSync(temporary, content, 'utf8')\n    renameSync(temporary, target)\n    return true\n  } catch (error) {\n    rmSync(temporary, { force: true })\n    throw error\n  }\n}\n\n/**\n * SHA-256 prefix of a string — cheap signature used to detect whether a\n * per-scheme file's source has changed since the last write.\n * @param text Input text.\n * @returns 16-char hex digest.\n */\nfunction signatureOf(text: string): string {\n  return createHash('sha256').update(text).digest('hex').slice(0, 16)\n}\n\n/**\n * Compare two `Set<string>`s for equality — same size + every element\n * of `a` present in `b`.\n * @param a First set.\n * @param b Second set.\n * @returns Whether the two sets contain identical values.\n */\nfunction setsEqual(a: ReadonlySet<string>, b: ReadonlySet<string>): boolean {\n  if (a.size !== b.size) return false\n  for (const v of a) if (!b.has(v)) return false\n  return true\n}\n\n/**\n * Compute the absolute path of a per-scheme style file under the cache dir.\n * @param cacheDir Absolute cache directory.\n * @param scheme Registry key (`'common'` or a variant name).\n * @returns Absolute path, e.g. `<cacheDir>/dark.style.js`.\n */\nfunction schemeFilePath(cacheDir: string, scheme: string): string {\n  return path.join(cacheDir, `${scheme}.style.js`)\n}\n\n/**\n * In-memory atom union + per-scheme style-file emitter.\n *\n * Correctness under multi-worker Metro relies on `ensureProjectScanned`:\n * the FIRST `recordFile` / `writeSchemes` call in every worker drives\n * the oxide Scanner across ALL project sources and hydrates the union\n * with the complete set of candidates. Subsequent per-file\n * `recordFile` calls only layer in atoms the scan already knew about,\n * so writes are idempotent — different workers can't clobber each\n * other's scheme files with partial views.\n *\n * Per-file deltas (atom set unchanged → early return) skip\n * serialization entirely. On a theme-CSS change, `getRnwindState`\n * builds a fresh parser + builder; the next call re-runs\n * `ensureProjectScanned` against the new parser, producing scheme\n * files with the new theme values.\n */\nclass UnionBuilder {\n  private readonly cacheDir: string\n  private readonly parser: TailwindParser\n  private readonly unionAtoms = new Map<string, SchemedStyle>()\n  private readonly unionKeyframes = new Map<string, KeyframeBlock>()\n  /** atom name → gradient role/colour, surfaced into the manifest's `registerGradients`. */\n  private readonly unionGradients = new Map<string, GradientAtomInfo>()\n  /** atom name → haptic request, surfaced into the manifest's `registerHaptics`. */\n  private readonly unionHaptics = new Map<string, HapticRequest>()\n  /**\n   * Distinct literal className strings seen across all files, pre-merged\n   * into per-scheme molecules at write time. Accumulate-only (like\n   * `unionAtoms`): orphaned literals just yield unused molecules and get\n   * reaped on the next cold start, so no refcount is needed.\n   */\n  private readonly unionLiterals = new Set<string>()\n  /**\n   * Responsive breakpoints captured from the parser. Refreshed on every\n   * `recordFile` / `ensureProjectScanned` so user-defined\n   * `--breakpoint-*` overrides land in the manifest the next time it's\n   * written. Identical for every parser call within one parser instance\n   * (theme is fixed for the parser's lifetime), so storing the latest\n   * snapshot is sufficient.\n   */\n  private breakpoints: ReadonlyMap<string, number> = new Map()\n  /** file → set of atom names this file currently contributes. */\n  private readonly fileAtomSets = new Map<string, Set<string>>()\n  /** atom name → how many files currently contribute it (refcount). */\n  private readonly atomRefCount = new Map<string, number>()\n  /** scheme → last-written source SHA. Skips re-writing unchanged schemes. */\n  private readonly schemeSignatures = new Map<string, string>()\n  /**\n   * Per-atom serialized-value cache — identity-keyed on each atom's\n   * SchemedStyle reference. Carried across `writeSchemes` calls so the\n   * typical \"user added one className\" FR case re-stringifies ONE atom\n   * instead of all 175+. Cleared on `ensureProjectScanned` (full\n   * rescan replaces every reference) and individually invalidated for\n   * any atom `applyDiff` mutates.\n   */\n  private readonly serializedCache: AtomSerializedCache = new Map()\n  /** Running count of stringify passes (cache misses). Test telemetry. */\n  private serializedMissesCount = 0\n  /** Set after `ensureProjectScanned` completes. */\n  private projectScanned = false\n  /** Promise guard so concurrent first-calls await ONE scan. */\n  private pendingScan: Promise<void> | null = null\n\n  constructor(cacheDir: string, parser: TailwindParser) {\n    this.cacheDir = cacheDir\n    this.parser = parser\n    mkdirSync(this.cacheDir, { recursive: true })\n  }\n\n  /** Absolute path of the manifest module (`rnwind/__generated/schemes`). */\n  public get manifestPath(): string {\n    return path.join(this.cacheDir, MANIFEST_BASENAME)\n  }\n\n  /**\n   * Snapshot of every source file the builder has recorded atoms for\n   * this worker session. Used by `withRnwindConfig`'s CSS watcher to\n   * touch `mtime` on each and nudge Metro into re-transforming them\n   * with the new theme values.\n   * @returns Absolute source paths.\n   */\n  public recordedFiles(): readonly string[] {\n    return [...this.fileAtomSets.keys()]\n  }\n\n  /** Cumulative cache-miss count — exposed for tests to assert cache behaviour. */\n  public get serializedMisses(): number {\n    return this.serializedMissesCount\n  }\n\n  /**\n   * Absolute path of one scheme's style file.\n   * @param scheme Registry key.\n   * @returns Absolute path.\n   */\n  public schemePath(scheme: string): string {\n    return schemeFilePath(this.cacheDir, scheme)\n  }\n\n  /**\n   * One-shot oxide scan + compile across every source the parser was\n   * configured with. Idempotent — safe to call from any entry point.\n   * Concurrent callers share the same in-flight promise.\n   */\n  public async ensureProjectScanned(): Promise<void> {\n    if (this.projectScanned) return\n    if (this.pendingScan) return this.pendingScan\n    this.pendingScan = (async () => {\n      const parsed = await this.parser.parseProject()\n      for (const [name, style] of parsed.atoms) this.unionAtoms.set(name, style)\n      for (const [name, kf] of parsed.keyframes) this.unionKeyframes.set(name, kf)\n      for (const [name, gradient] of parsed.gradientAtoms) this.unionGradients.set(name, gradient)\n      for (const [name, haptic] of parsed.hapticAtoms) this.unionHaptics.set(name, haptic)\n      this.breakpoints = parsed.breakpoints\n      this.projectScanned = true\n    })()\n    try {\n      await this.pendingScan\n    } finally {\n      this.pendingScan = null\n    }\n  }\n\n  /**\n   * Record one source file's resolved atoms + keyframes. Short-circuits\n   * when the file's atom name set hasn't changed — the common case on\n   * every Fast Refresh save of a file whose className literals are\n   * unchanged.\n   * @param file Absolute source file path.\n   * @param atoms Per-atom resolved schemed styles from this transform.\n   * @param keyframes Keyframe blocks referenced by this file's atoms.\n   * @param literals\n   * @returns `{ changed: true }` when the union shifted (new atom name,\n   *   removed atom name, or new keyframe) — the transformer uses this\n   *   to skip the serializer + `writeSchemes` when nothing changed.\n   */\n  public async recordFile(\n    file: string,\n    atoms: ReadonlyMap<string, SchemedStyle>,\n    keyframes: ReadonlyMap<string, KeyframeBlock>,\n    literals: readonly string[] = [],\n  ): Promise<{ changed: boolean }> {\n    await this.ensureProjectScanned()\n    const literalAdded = this.recordLiterals(literals)\n    const newAtomNames = new Set(atoms.keys())\n    const previous = this.fileAtomSets.get(file)\n    if (previous && setsEqual(previous, newAtomNames)) {\n      // Atom set unchanged — skip the unionAtoms update entirely. The\n      // project scan already populated them, and re-setting a fresh\n      // object ref here would invalidate the per-atom serialization\n      // cache on every FR save for no gain (values are identical).\n      // Theme edits go through `getRnwindState` → new builder → fresh\n      // scan, so stale cache is impossible.\n      let keyframeAdded = false\n      for (const [name, kf] of keyframes) {\n        if (!this.unionKeyframes.has(name)) keyframeAdded = true\n        this.unionKeyframes.set(name, kf)\n      }\n      return { changed: keyframeAdded || literalAdded }\n    }\n    this.applyDiff(file, newAtomNames, atoms, keyframes)\n    return { changed: true }\n  }\n\n  /**\n   * Merge a file's literal classNames into the union. A literal the\n   * union hasn't seen flips `changed` so `writeSchemes` re-emits the\n   * scheme files with the new molecule.\n   * @param literals Distinct literal className strings.\n   * @returns Whether any literal was new to the union.\n   */\n  private recordLiterals(literals: readonly string[]): boolean {\n    let added = false\n    for (const literal of literals) {\n      if (this.unionLiterals.has(literal)) continue\n      this.unionLiterals.add(literal)\n      added = true\n    }\n    return added\n  }\n\n  /**\n   * Forget one source file's contribution. Idempotent — repeated calls\n   * for a file that's already dropped are no-ops. Does NOT remove the\n   * atom from the union when another file (or the project scan) still\n   * references it.\n   * @param file Absolute source file path.\n   */\n  public dropFile(file: string): void {\n    const previous = this.fileAtomSets.get(file)\n    if (!previous) return\n    for (const name of previous) {\n      const count = (this.atomRefCount.get(name) ?? 0) - 1\n      if (count <= 0) this.atomRefCount.delete(name)\n      else this.atomRefCount.set(name, count)\n    }\n    this.fileAtomSets.delete(file)\n  }\n\n  /**\n   * Serialize the union into per-scheme files + manifest, writing only\n   * files whose source bytes changed. Called after every `recordFile`\n   * from the transformer — and once at Metro startup via\n   * `ensureFilesExist` to seed disk from the project scan alone.\n   * @returns List of scheme keys whose files were rewritten (empty\n   *   when the union is byte-identical to the last flush).\n   */\n  public async writeSchemes(): Promise<{ changedSchemes: readonly string[] }> {\n    await this.ensureProjectScanned()\n    const sortedAtomNames = [...this.unionAtoms.keys()].toSorted((a, b) => a.localeCompare(b))\n    const result = buildSchemeSources(sortedAtomNames, this.unionAtoms, this.unionKeyframes, this.serializedCache, this.breakpoints, this.unionGradients, this.unionHaptics, [...this.unionLiterals])\n    this.serializedMissesCount += result.serializedMisses\n    const { schemeSources, manifestSource } = result\n\n    const changed: string[] = []\n    for (const [scheme, source] of Object.entries(schemeSources)) {\n      const signature = signatureOf(source)\n      const target = schemeFilePath(this.cacheDir, scheme)\n      if (this.schemeSignatures.get(scheme) === signature && existsSync(target)) continue\n      if (writeIfChanged(target, source)) changed.push(scheme)\n      this.schemeSignatures.set(scheme, signature)\n    }\n\n    const manifestSignature = signatureOf(manifestSource)\n    const manifestTarget = path.join(this.cacheDir, MANIFEST_BASENAME)\n    if (this.schemeSignatures.get('__manifest') !== manifestSignature || !existsSync(manifestTarget)) {\n      if (writeIfChanged(manifestTarget, manifestSource)) changed.push('__manifest')\n      this.schemeSignatures.set('__manifest', manifestSignature)\n    }\n\n    return { changedSchemes: changed }\n  }\n\n  /**\n   * Ensure the manifest + common scheme files exist on disk so Metro's\n   * resolver can SHA1 them at boot before the first transform runs.\n   */\n  public async ensureFilesExist(): Promise<void> {\n    if (existsSync(this.manifestPath) && existsSync(schemeFilePath(this.cacheDir, 'common'))) {\n      // Still trigger the scan so the in-memory union is complete; file\n      // bytes may already be authoritative from a prior Metro run.\n      await this.ensureProjectScanned()\n      return\n    }\n    await this.writeSchemes()\n  }\n\n  /**\n   * Apply one file's atom-name diff to the in-memory refcount + union.\n   * @param file Source file path.\n   * @param newAtoms New atom-name set for the file.\n   * @param resolvedAtoms Fresh parser output — carries the resolved\n   *   styles for every entry in `newAtoms`.\n   * @param newKeyframes Keyframes this file's atoms reference.\n   */\n  private applyDiff(\n    file: string,\n    newAtoms: ReadonlySet<string>,\n    resolvedAtoms: ReadonlyMap<string, SchemedStyle>,\n    newKeyframes: ReadonlyMap<string, KeyframeBlock>,\n  ): void {\n    const previous = this.fileAtomSets.get(file) ?? new Set<string>()\n    for (const name of previous) {\n      if (newAtoms.has(name)) continue\n      const count = (this.atomRefCount.get(name) ?? 0) - 1\n      if (count <= 0) this.atomRefCount.delete(name)\n      else this.atomRefCount.set(name, count)\n      // Do NOT remove `name` from `unionAtoms` — the project scan still\n      // references it (orphaned atoms get reaped on the next Metro\n      // cold start when the scanner re-walks disk).\n    }\n    for (const name of newAtoms) {\n      if (!previous.has(name)) this.atomRefCount.set(name, (this.atomRefCount.get(name) ?? 0) + 1)\n      // Only install the resolved style when the atom is new to the\n      // union. Replacing an existing entry with a fresh parser-\n      // produced object would swap the identity guard the per-atom\n      // serialization cache uses and force a re-stringify for every\n      // atom on every FR save. CSS edits rebuild the whole builder\n      // (via `getRnwindState`) so stale values aren't possible.\n      if (!this.unionAtoms.has(name)) {\n        const style = resolvedAtoms.get(name)\n        if (style) this.unionAtoms.set(name, style)\n      }\n    }\n    this.fileAtomSets.set(file, new Set(newAtoms))\n    for (const [name, kf] of newKeyframes) this.unionKeyframes.set(name, kf)\n  }\n}\n\nexport { UnionBuilder }\n"],"names":["existsSync","readFileSync","mkdirSync","randomBytes","writeFileSync","renameSync","rmSync","createHash","buildSchemeSources"],"mappings":"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"}

package/lib/cjs/core/style-builder/union-builder.d.ts

@@ -21,6 +21,17 @@ declare class UnionBuilder {
     private readonly parser;
     private readonly unionAtoms;
     private readonly unionKeyframes;
+    /** atom name → gradient role/colour, surfaced into the manifest's `registerGradients`. */
+    private readonly unionGradients;
+    /** atom name → haptic request, surfaced into the manifest's `registerHaptics`. */
+    private readonly unionHaptics;
+    /**
+     * Distinct literal className strings seen across all files, pre-merged
+     * into per-scheme molecules at write time. Accumulate-only (like
+     * `unionAtoms`): orphaned literals just yield unused molecules and get
+     * reaped on the next cold start, so no refcount is needed.
+     */
+    private readonly unionLiterals;
     /**
      * Responsive breakpoints captured from the parser. Refreshed on every
      * `recordFile` / `ensureProjectScanned` so user-defined
@@ -84,13 +95,22 @@ declare class UnionBuilder {
      * @param file Absolute source file path.
      * @param atoms Per-atom resolved schemed styles from this transform.
      * @param keyframes Keyframe blocks referenced by this file's atoms.
+     * @param literals
      * @returns `{ changed: true }` when the union shifted (new atom name,
      *   removed atom name, or new keyframe) — the transformer uses this
      *   to skip the serializer + `writeSchemes` when nothing changed.
      */
-    recordFile(file: string, atoms: ReadonlyMap<string, SchemedStyle>, keyframes: ReadonlyMap<string, KeyframeBlock>): Promise<{
+    recordFile(file: string, atoms: ReadonlyMap<string, SchemedStyle>, keyframes: ReadonlyMap<string, KeyframeBlock>, literals?: readonly string[]): Promise<{
         changed: boolean;
     }>;
+    /**
+     * Merge a file's literal classNames into the union. A literal the
+     * union hasn't seen flips `changed` so `writeSchemes` re-emits the
+     * scheme files with the new molecule.
+     * @param literals Distinct literal className strings.
+     * @returns Whether any literal was new to the union.
+     */
+    private recordLiterals;
     /**
      * Forget one source file's contribution. Idempotent — repeated calls
      * for a file that's already dropped are no-ops. Does NOT remove the

package/lib/cjs/metro/dts.cjs

@@ -55,23 +55,16 @@ const CONTENT_CONTAINER_INTERFACES = new Set([
 ]);
 /**
  * Build the body of one interface augmentation: `className?: string`
- * plus `<prefix>ClassName?: string` for every prefix that applies to
- * THIS interface. Emits a single-line body so the file stays easy to
- * scan and diff.
+ * plus `contentContainerClassName?: string` for the scroll interfaces
+ * that natively expose `contentContainerStyle`. Emits a single-line
+ * body so the file stays easy to scan and diff.
  * @param interfaceName Bare interface name (generic parameters stripped).
- * @param userPrefixes Extra prefixes from the Metro config — applied to
- *   every interface the same way `className` is.
  * @returns Space-separated property declarations.
  */
-function buildInterfaceBody(interfaceName, userPrefixes) {
+function buildInterfaceBody(interfaceName) {
     const props = ['className?: string'];
     if (CONTENT_CONTAINER_INTERFACES.has(interfaceName))
         props.push(`${BUILTIN_PREFIX}ClassName?: string`);
-    for (const prefix of userPrefixes) {
-        if (prefix === BUILTIN_PREFIX)
-            continue;
-        props.push(`${prefix}ClassName?: string`);
-    }
     return props.join('; ');
 }
 /**
@@ -83,13 +76,11 @@ function buildInterfaceBody(interfaceName, userPrefixes) {
  * `Scheme` union so `useScheme()` returns the actual names.
  *
  * Called once at Metro-config time — overwrite-on-rewrite so the file
- * stays in sync with the user's current theme CSS + prefix config.
+ * stays in sync with the user's current theme CSS.
  * @param targetPath Absolute path to write (typically `rnwind-types.d.ts` at project root).
  * @param schemes Scheme names from the user's `@variant` blocks (empty when none declared).
- * @param classNamePrefixes Extra prefixes from the Metro config — merged
- *   on top of the built-in `'contentContainer'`. Defaults to empty.
  */
-function writeDtsFile(targetPath, schemes, classNamePrefixes = []) {
+function writeDtsFile(targetPath, schemes) {
     const lines = [
         '// Auto-generated by rnwind — do not edit by hand.',
         '// Overwritten on Metro start / theme CSS change.',
@@ -98,7 +89,7 @@ function writeDtsFile(targetPath, schemes, classNamePrefixes = []) {
     ];
     for (const entry of INTERFACES) {
         const name = typeof entry === 'string' ? entry : entry.name;
-        const body = buildInterfaceBody(name, classNamePrefixes);
+        const body = buildInterfaceBody(name);
         if (typeof entry === 'string') {
             lines.push(`  interface ${entry} { ${body} }`);
             continue;

package/lib/cjs/metro/dts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dts.cjs","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":["mkdirSync","writeFileSync"],"mappings":"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"}
+{"version":3,"file":"dts.cjs","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 `contentContainerClassName?: string` for the scroll interfaces\n * that natively expose `contentContainerStyle`. Emits a single-line\n * body so the file stays easy to scan and diff.\n * @param interfaceName Bare interface name (generic parameters stripped).\n * @returns Space-separated property declarations.\n */\nfunction buildInterfaceBody(interfaceName: string): string {\n  const props = ['className?: string']\n  if (CONTENT_CONTAINER_INTERFACES.has(interfaceName)) props.push(`${BUILTIN_PREFIX}ClassName?: string`)\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.\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 */\nexport function writeDtsFile(targetPath: string, schemes: readonly string[]): 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)\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":["mkdirSync","writeFileSync"],"mappings":"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"}

package/lib/cjs/metro/dts.d.ts

@@ -7,10 +7,8 @@
  * `Scheme` union so `useScheme()` returns the actual names.
  *
  * Called once at Metro-config time — overwrite-on-rewrite so the file
- * stays in sync with the user's current theme CSS + prefix config.
+ * stays in sync with the user's current theme CSS.
  * @param targetPath Absolute path to write (typically `rnwind-types.d.ts` at project root).
  * @param schemes Scheme names from the user's `@variant` blocks (empty when none declared).
- * @param classNamePrefixes Extra prefixes from the Metro config — merged
- *   on top of the built-in `'contentContainer'`. Defaults to empty.
  */
-export declare function writeDtsFile(targetPath: string, schemes: readonly string[], classNamePrefixes?: readonly string[]): void;
+export declare function writeDtsFile(targetPath: string, schemes: readonly string[]): void;

package/lib/cjs/metro/state.cjs

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