rnwind 0.0.1 → 0.0.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-style.cjs","sources":["../../../../../src/core/style-builder/build-style.ts"],"sourcesContent":["import type { KeyframeBlock, RNStyle, SchemedStyle } from '../parser'\n\n/** Match atom names like `border-hairline`, `h-hairline`, `border-t-hairline`, etc. */\nconst HAIRLINE_ATOM = /-hairline$/\n\n/** Parser's synthetic \"no variant\" scheme — provides the canonical fallback. */\nconst BASE_SCHEME = 'base'\n\n/** Runtime registry key for the always-loaded fallback scheme. */\nconst COMMON_SCHEME = 'common'\n\n/** Sentinel key the parser sets on interactive (`active:`/`focus:`) atoms. */\nconst STATE_KEY = '__state'\n\n/**\n * Whether an atom is a `*-hairline` utility — its numeric value must be\n * rewritten as `StyleSheet.hairlineWidth` at runtime.\n * @param atomName Class name.\n * @returns True when the atom is a hairline utility.\n */\nfunction isHairlineAtom(atomName: string): boolean {\n  return HAIRLINE_ATOM.test(atomName)\n}\n\n/**\n * Whether an RN style object carries any own key. The parser emits\n * empty `{}` for schemes an atom doesn't apply to; we treat those as\n * \"inherit canonical\" and don't emit an entry for that scheme.\n * @param style RN style object.\n * @returns Whether the style has content.\n */\nfunction isNonEmptyStyle(style: RNStyle | undefined): style is RNStyle {\n  if (!style) return false\n  return Object.keys(style).length > 0\n}\n\n/**\n * Iterate per-scheme entries from a parser-produced schemed bucket,\n * skipping the reserved `__state` metadata key.\n * @param schemed Parser output for one atom.\n * @yields `[scheme, style]` pairs in object-key order.\n */\nfunction* iterScheme(schemed: SchemedStyle): IterableIterator<[string, RNStyle]> {\n  const raw = schemed as Readonly<Record<string, RNStyle | string>>\n  for (const key in raw) {\n    if (key === STATE_KEY) continue\n    yield [key, raw[key] as RNStyle]\n  }\n}\n\n/**\n * Pick the canonical style for an atom — the value that goes into\n * `common.style.js`. Prefers the parser's `base` entry (the \"default\n * when no variant matches\"); falls back to the first non-empty per-\n * scheme entry when the atom has no explicit base.\n * @param schemed Parser-produced per-scheme bucket.\n * @returns Canonical style, or undefined when every scheme is empty.\n */\nfunction canonicalValue(schemed: SchemedStyle): RNStyle | undefined {\n  const baseEntry = (schemed as Readonly<Record<string, RNStyle>>)[BASE_SCHEME]\n  if (isNonEmptyStyle(baseEntry)) return baseEntry\n  for (const [, style] of iterScheme(schemed)) {\n    if (isNonEmptyStyle(style)) return style\n  }\n  return undefined\n}\n\n/**\n * Collect every variant scheme name across the project's atoms. The\n * synthetic `base` scheme is excluded — it's folded into the `common`\n * output. Returns variants in sorted order for deterministic output.\n * @param resolved Parser-produced atom map.\n * @returns Variant scheme names (no `base`, no `common`).\n */\nfunction collectVariantSchemes(resolved: ReadonlyMap<string, SchemedStyle>): readonly string[] {\n  const set = new Set<string>()\n  for (const schemed of resolved.values()) {\n    for (const [scheme] of iterScheme(schemed)) {\n      if (scheme !== BASE_SCHEME) set.add(scheme)\n    }\n  }\n  return [...set].toSorted((a, b) => a.localeCompare(b))\n}\n\n/**\n * Normalize a CSS keyframe selector to the percentage form Reanimated\n * v4 keyframes objects use.\n * @param offset Selector text (`'from'`, `'to'`, `'50%'`).\n * @returns Percentage string.\n */\nfunction offsetToPercent(offset: string): string {\n  if (offset === 'from') return '0%'\n  if (offset === 'to') return '100%'\n  return offset\n}\n\n/**\n * Replace a string `animationName` with the inline keyframes object\n * Reanimated v4's CSS engine expects. Atoms whose `animationName`\n * doesn't match any registered keyframe keep the original string.\n * @param style RN style object (possibly carrying `animationName`).\n * @param keyframes Keyframes available to this build.\n * @returns Style with `animationName` inlined when matched.\n */\nfunction inlineAnimationName(style: RNStyle, keyframes: ReadonlyMap<string, KeyframeBlock>): RNStyle {\n  const name = style.animationName\n  if (typeof name !== 'string') return style\n  const block = keyframes.get(name)\n  if (!block) return style\n  const out: RNStyle = { ...style }\n  const inline: Record<string, Record<string, string | number>> = {}\n  for (const step of block.steps) inline[offsetToPercent(step.offset)] = step.style as Record<string, string | number>\n  out.animationName = inline as unknown as RNStyle[string]\n  return out\n}\n\n/**\n * Convert any safe-area markers in the style into a precomputed spec\n * envelope. Atoms with `__safe` markers become\n * `{__safeStyle: [[cssKey, sideTag, or, offset], ...]}` — the runtime\n * resolver reads `value.__safeStyle` as a single property access and\n * resolves against live insets without walking the value's keys.\n * @param style RN style as resolved by the parser.\n * @returns Original style OR the safe-style envelope.\n */\nfunction envelopeSafeMarkers(\n  style: RNStyle,\n): RNStyle | { __safeStyle: readonly (readonly [string, string, number | undefined, number | undefined])[] } {\n  let specs: [string, string, number | undefined, number | undefined][] | null = null\n  for (const key of Object.keys(style)) {\n    const value = style[key]\n    if (typeof value !== 'object' || !value) continue\n    const marker = value as { __safe?: string; or?: number; offset?: number }\n    if (typeof marker.__safe !== 'string') continue\n    if (!specs) specs = []\n    specs.push([key, marker.__safe, marker.or, marker.offset])\n  }\n  if (!specs) return style\n  return { __safeStyle: specs }\n}\n\n/**\n * Serialise a single atom's RN style to a JS object literal. Honors\n * the `*-hairline` sentinel: numeric values get rewritten to\n * `StyleSheet.hairlineWidth` so device-density differences land in the\n * rendered border.\n * @param atomName The atom's class name (used to detect hairline).\n * @param style The atom's RN style object.\n * @returns JS object-literal source.\n */\nfunction serializeStyle(atomName: string, style: RNStyle): string {\n  const json = JSON.stringify(style)\n  if (!isHairlineAtom(atomName)) return json\n  return json.replaceAll(/:(-?\\d+(?:\\.\\d+)?)/g, ': StyleSheet.hairlineWidth')\n}\n\n/**\n * Serialise an atom's resolved value — bare RN style object or an\n * already-enveloped safe-style value.\n * @param atomName Atom name (controls hairline rewrite).\n * @param value Atom value (bare style or `{__safeStyle: spec[]}`).\n * @returns JS source for the value.\n */\nfunction serializeAtomValue(atomName: string, value: unknown): string {\n  if (typeof value === 'object' && value !== null && '__safeStyle' in value) return JSON.stringify(value)\n  return serializeStyle(atomName, value as RNStyle)\n}\n\n/**\n * Resolve + envelope + serialize an atom's value under one scheme.\n * @param atomName Atom name.\n * @param style Raw RN style for this scheme.\n * @param keyframes Keyframes available to this build.\n * @returns Serialized text ready to emit.\n */\nfunction prepareAtomValue(atomName: string, style: RNStyle, keyframes: ReadonlyMap<string, KeyframeBlock>): string {\n  const enveloped = envelopeSafeMarkers(inlineAnimationName(style, keyframes))\n  return serializeAtomValue(atomName, enveloped)\n}\n\n/**\n * Per-file value deduplicator — interns each unique serialized atom\n * value once and emits `const _s<N> = <value>` at module scope. Scheme\n * entries reference the const instead of inlining the literal.\n *\n * Wins: (1) smaller bundle bytes for themes with many atoms sharing a\n * style shape; (2) stable `===` inside one scheme so two atoms\n * resolving to the same value yield the same object reference.\n */\nclass ValueDeduper {\n  private readonly byText = new Map<string, string>()\n  private readonly decls: string[] = []\n\n  intern(serialized: string): string {\n    const existing = this.byText.get(serialized)\n    if (existing) return existing\n    const name = `_s${this.decls.length}`\n    this.decls.push(`const ${name} = ${serialized}`)\n    this.byText.set(serialized, name)\n    return name\n  }\n\n  get declarations(): readonly string[] {\n    return this.decls\n  }\n}\n\n/**\n * Render one scheme file's source. `entries` is the list of atoms this\n * scheme contributes — for `common` every atom's canonical value; for\n * a variant only atoms whose value differs from canonical. Hairline\n * atoms in this file trigger the `StyleSheet` import.\n * @param schemeName Registry key (`'common'` or the variant name).\n * @param entries `[atomName, serializedValue]` pairs to emit.\n * @returns JS source text.\n */\nfunction renderSchemeFile(schemeName: string, entries: readonly (readonly [string, string])[]): string {\n  const needsStyleSheet = entries.some(([atom]) => isHairlineAtom(atom))\n  const deduper = new ValueDeduper()\n  const recordLines: string[] = []\n  for (const [atom, value] of entries) {\n    const ref = deduper.intern(value)\n    recordLines.push(`  ${JSON.stringify(atom)}: ${ref},`)\n  }\n\n  const lines: string[] = []\n  if (needsStyleSheet) lines.push(`import { StyleSheet } from 'react-native'`)\n  lines.push(`import { registerAtoms } from 'rnwind'`, ``)\n  if (deduper.declarations.length > 0) {\n    for (const decl of deduper.declarations) lines.push(decl)\n    lines.push(``)\n  }\n  lines.push(`registerAtoms(${JSON.stringify(schemeName)}, {`, ...recordLines, `})`, ``)\n  return lines.join('\\n')\n}\n\n/**\n * Render the JS-object literal for the responsive-breakpoint table the\n * runtime registers at manifest-load time. Sorted by ascending px\n * threshold so the runtime can build a deterministic \"tier index\" for\n * its style cache.\n * @param breakpoints Breakpoint name → px-threshold map.\n * @returns Object-literal source (`{}` when empty).\n */\nfunction serializeBreakpoints(breakpoints: ReadonlyMap<string, number>): string {\n  if (breakpoints.size === 0) return '{}'\n  const entries = [...breakpoints].toSorted((a, b) => a[1] - b[1] || a[0].localeCompare(b[0]))\n  const inner = entries.map(([name, px]) => `${JSON.stringify(name)}: ${px}`).join(', ')\n  return `{ ${inner} }`\n}\n\n/**\n * Render the manifest module. Eager-imports `common.style.js` (every\n * rewritten source file pulls this via a transitive side-effect\n * import), registers the responsive-breakpoint table once, and lazy-\n * requires every variant scheme's file through an inline require —\n * first call in `ensureSchemeLoaded(name)` triggers the scheme\n * module's evaluation; Metro's module cache makes subsequent calls\n * no-ops.\n * @param variants Variant scheme names (no `base`, no `common`).\n * @param breakpoints Responsive breakpoint name → px-threshold map.\n * @returns JS source text.\n */\nfunction renderManifest(variants: readonly string[], breakpoints: ReadonlyMap<string, number>): string {\n  const lines: string[] = [\n    `import { registerSchemeLoader, registerBreakpoints } from 'rnwind'`,\n    `import './common.style'`,\n    ``,\n    `registerBreakpoints(${serializeBreakpoints(breakpoints)})`,\n    ``,\n  ]\n  if (variants.length === 0) {\n    lines.push(`function ensureSchemeLoaded(_name) {}`, ``, `registerSchemeLoader(ensureSchemeLoaded)`, ``, `export { ensureSchemeLoaded }`, ``)\n    return lines.join('\\n')\n  }\n  lines.push(`const LOADERS = {`)\n  for (const variant of variants) {\n    lines.push(`  ${JSON.stringify(variant)}: () => require(${JSON.stringify(`./${variant}.style`)}),`)\n  }\n  lines.push(`}`, ``, `function ensureSchemeLoaded(name) {`, `  const loader = LOADERS[name]`, `  if (loader) loader()`, `}`, ``, `registerSchemeLoader(ensureSchemeLoaded)`, ``, `export { ensureSchemeLoaded }`, ``)\n  return lines.join('\\n')\n}\n\n/** Output of one build pass — one source per scheme plus the manifest. */\nexport interface BuildSchemeSourcesOutput {\n  /** `<schemeName>.style.js` source per scheme. Always contains `common`. */\n  readonly schemeSources: Readonly<Record<string, string>>\n  /** Manifest module source (`schemes.js`). */\n  readonly manifestSource: string\n  /** Variant scheme names this build covers (sorted; excludes `common`). */\n  readonly variants: readonly string[]\n  /** Number of `prepareAtomValue` / JSON.stringify passes (cache MISSES) this call did — test telemetry. */\n  readonly serializedMisses: number\n}\n\n/**\n * Per-atom cached serialized value. Canonical (common) string plus a\n * map of variant → own-serialized-string. `styleRef` is an identity\n * guard against the resolved SchemedStyle — when callers replace an\n * atom's value the ref diverges and the cache rebuilds that entry.\n */\nexport interface AtomSerializedEntry {\n  styleRef: SchemedStyle\n  canonical: string\n  variants: Map<string, string>\n}\n\n/** Cache UnionBuilder owns across repeated writeSchemes calls. */\nexport type AtomSerializedCache = Map<string, AtomSerializedEntry>\n\n/**\n * Pre-serialize every non-empty variant value, reusing the per-atom\n * cache where present. Result drives both the scheme-uniform check\n * AND the per-variant emission loop downstream.\n * @param atom Atom name.\n * @param schemed Parser-produced schemed bucket.\n * @param variants Variant scheme names in deterministic order.\n * @param keyframes Keyframes available to inline.\n * @param cached Cached entry for this atom (when ref-stable).\n * @returns variantName → serialized text.\n */\nfunction buildVariantTexts(\n  atom: string,\n  schemed: SchemedStyle,\n  variants: readonly string[],\n  keyframes: ReadonlyMap<string, KeyframeBlock>,\n  cached: AtomSerializedEntry | undefined,\n): Map<string, string> {\n  const out = new Map<string, string>()\n  for (const variant of variants) {\n    const own = (schemed as Readonly<Record<string, RNStyle>>)[variant]\n    if (!isNonEmptyStyle(own)) continue\n    const text = cached?.variants.get(variant) ?? prepareAtomValue(atom, own, keyframes)\n    out.set(variant, text)\n  }\n  return out\n}\n\n/**\n * Decide whether a (no-base) atom should be promoted to common because\n * every declared variant resolves to the same value. This is the\n * scheme-uniform case: `flex`, `p-4`, `absolute` all carry no theme\n * variables, so Phase-1 fills every variant bucket identically and\n * leaves `base` empty — without this collapse they'd be duplicated\n * across every scheme file.\n *\n * The variant-prefix check is what keeps a real scheme-gated atom\n * (`dark:bg-indigo-800`) out of common in a single-variant project\n * (where its 1 bucket would otherwise look \"uniform\" by definition).\n * @param atom Atom name (checked for `<variant>:` prefix).\n * @param variants Declared variant scheme names.\n * @param variantTexts Serialized variant values.\n * @param canonicalText Serialized canonical (common) value.\n * @returns Whether the atom is uniform across every declared variant.\n */\nfunction isSchemeUniform(\n  atom: string,\n  variants: readonly string[],\n  variantTexts: ReadonlyMap<string, string>,\n  canonicalText: string,\n): boolean {\n  if (variants.length === 0 || variantTexts.size !== variants.length) return false\n  if (variants.some((variant) => atom.startsWith(`${variant}:`))) return false\n  for (const text of variantTexts.values()) {\n    if (text !== canonicalText) return false\n  }\n  return true\n}\n\n/**\n * Serialize one atom's canonical + variant-diff entries, honouring the\n * per-atom cache. Returns the number of cache MISSES this atom incurred\n * (0 when canonical was cached AND every needed variant was cached;\n * 1 when anything had to be re-stringified).\n *\n * Three paths gated on whether the parser produced a non-empty `base`\n * bucket and whether the variants converge:\n *  - **Themed atom (base present)**: canonical goes to `common`, each\n *    variant whose own value diverges from canonical writes the diff\n *    into its own scheme file. `lookupAtom` finds the variant's\n *    override or falls through to common.\n *  - **Scheme-uniform atom (base empty, every variant identical)**:\n *    promoted to `common` once — the parser's Phase-1 fills every\n *    variant bucket with the same value for utilities like `flex` /\n *    `p-4` / `absolute` that don't reference theme variables.\n *  - **Scheme-gated atom (base empty, prefixed name like `dark:foo`,\n *    or variants diverge)**: each populated variant writes the value\n *    into its own scheme file directly; common stays empty so the\n *    runtime fallback can't leak the variant style into other schemes.\n * @param atom Atom name.\n * @param schemed Parser-produced schemed bucket for the atom.\n * @param canonical Canonical RN style for `common`.\n * @param variants Variant scheme names in deterministic order.\n * @param keyframes Keyframes available to inline.\n * @param commonEntries Mutable collector for `common`'s `[atom, text]` pairs.\n * @param variantEntries Mutable collector keyed by variant name.\n * @param cache Optional shared serialized-value cache.\n * @returns Number of JSON.stringify passes triggered for this atom.\n */\nfunction collectAtomEntries(\n  atom: string,\n  schemed: SchemedStyle,\n  canonical: RNStyle,\n  variants: readonly string[],\n  keyframes: ReadonlyMap<string, KeyframeBlock>,\n  commonEntries: (readonly [string, string])[],\n  variantEntries: Record<string, (readonly [string, string])[]>,\n  cache?: AtomSerializedCache,\n): number {\n  const cached = cache?.get(atom)\n  const hit = cached?.styleRef === schemed\n  const baseEntry = (schemed as Readonly<Record<string, RNStyle>>)[BASE_SCHEME]\n  const hasBase = isNonEmptyStyle(baseEntry)\n  const canonicalText = hit ? cached.canonical : prepareAtomValue(atom, canonical, keyframes)\n  const variantTexts = buildVariantTexts(atom, schemed, variants, keyframes, hit ? cached : undefined)\n  const goesToCommon = hasBase || isSchemeUniform(atom, variants, variantTexts, canonicalText)\n\n  if (goesToCommon) commonEntries.push([atom, canonicalText])\n\n  const entry: AtomSerializedEntry = hit\n    ? cached\n    : { styleRef: schemed, canonical: canonicalText, variants: new Map(variantTexts) }\n  if (!hit) cache?.set(atom, entry)\n\n  for (const variant of variants) {\n    const ownText = variantTexts.get(variant)\n    if (ownText === undefined) continue\n    if (goesToCommon && ownText === canonicalText) continue\n    variantEntries[variant].push([atom, ownText])\n  }\n  return hit ? 0 : 1\n}\n\n/** Empty fallback when the caller didn't supply breakpoints (legacy callers, tests). */\nconst EMPTY_BREAKPOINTS: ReadonlyMap<string, number> = new Map()\n\n/**\n * Build the per-scheme style files + manifest source.\n *\n * Dedup rule (the thing that shrinks scheme files to their diff):\n *  - Every atom's canonical value goes into `common.style.js`.\n *  - Each variant's file emits an entry for an atom ONLY when the\n *    variant's own resolved value differs from canonical. When the\n *    variant inherits (parser emits an empty `{}` for that scheme) or\n *    the variant's resolved value serializes identically to canonical,\n *    the atom is omitted — at runtime the lookup falls through via\n *    `cache.atoms[scheme]?.[atom] ?? cache.atoms.common[atom]`.\n *\n * Keyframes are inlined directly into atom values via `animationName`\n * ({@link inlineAnimationName}). Safe-area markers get pre-enveloped\n * via {@link envelopeSafeMarkers}. Hairline utilities stay bound to\n * `StyleSheet.hairlineWidth` at runtime.\n * @param atomNames All atom names (sorted).\n * @param resolved Per-atom schemed styles from the parser.\n * @param keyframes Keyframe blocks referenced by any atom.\n * @param cache Optional shared serialized-value cache.\n * @param breakpoints Responsive breakpoint name → px-threshold map. The\n *   manifest emits `registerBreakpoints({...})` so the runtime can gate\n *   `md:*` / `lg:*` atoms on `windowWidth`. Optional — empty when the\n *   theme declares no breakpoints (legacy/test callers).\n * @returns Per-scheme sources, manifest source, variant list.\n */\nexport function buildSchemeSources(\n  atomNames: readonly string[],\n  resolved: ReadonlyMap<string, SchemedStyle>,\n  keyframes: ReadonlyMap<string, KeyframeBlock>,\n  cache?: AtomSerializedCache,\n  breakpoints: ReadonlyMap<string, number> = EMPTY_BREAKPOINTS,\n): BuildSchemeSourcesOutput {\n  const variants = collectVariantSchemes(resolved)\n  const commonEntries: (readonly [string, string])[] = []\n  const variantEntries: Record<string, (readonly [string, string])[]> = {}\n  for (const variant of variants) variantEntries[variant] = []\n  let misses = 0\n\n  for (const atom of atomNames) {\n    const schemed = resolved.get(atom)\n    if (!schemed) continue\n    const canonical = canonicalValue(schemed)\n    if (!canonical) continue\n    misses += collectAtomEntries(atom, schemed, canonical, variants, keyframes, commonEntries, variantEntries, cache)\n  }\n\n  const schemeSources: Record<string, string> = {\n    [COMMON_SCHEME]: renderSchemeFile(COMMON_SCHEME, commonEntries),\n  }\n  for (const variant of variants) {\n    schemeSources[variant] = renderSchemeFile(variant, variantEntries[variant])\n  }\n\n  return {\n    schemeSources,\n    manifestSource: renderManifest(variants, breakpoints),\n    variants,\n    serializedMisses: misses,\n  }\n}\n\n/** Registry key the runtime uses for the always-loaded fallback. */\nexport const COMMON_SCHEME_NAME: string = COMMON_SCHEME\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,54 @@
+import type { KeyframeBlock, SchemedStyle } from '../parser';
+/** Output of one build pass — one source per scheme plus the manifest. */
+export interface BuildSchemeSourcesOutput {
+    /** `<schemeName>.style.js` source per scheme. Always contains `common`. */
+    readonly schemeSources: Readonly<Record<string, string>>;
+    /** Manifest module source (`schemes.js`). */
+    readonly manifestSource: string;
+    /** Variant scheme names this build covers (sorted; excludes `common`). */
+    readonly variants: readonly string[];
+    /** Number of `prepareAtomValue` / JSON.stringify passes (cache MISSES) this call did — test telemetry. */
+    readonly serializedMisses: number;
+}
+/**
+ * Per-atom cached serialized value. Canonical (common) string plus a
+ * map of variant → own-serialized-string. `styleRef` is an identity
+ * guard against the resolved SchemedStyle — when callers replace an
+ * atom's value the ref diverges and the cache rebuilds that entry.
+ */
+export interface AtomSerializedEntry {
+    styleRef: SchemedStyle;
+    canonical: string;
+    variants: Map<string, string>;
+}
+/** Cache UnionBuilder owns across repeated writeSchemes calls. */
+export type AtomSerializedCache = Map<string, AtomSerializedEntry>;
+/**
+ * Build the per-scheme style files + manifest source.
+ *
+ * Dedup rule (the thing that shrinks scheme files to their diff):
+ *  - Every atom's canonical value goes into `common.style.js`.
+ *  - Each variant's file emits an entry for an atom ONLY when the
+ *    variant's own resolved value differs from canonical. When the
+ *    variant inherits (parser emits an empty `{}` for that scheme) or
+ *    the variant's resolved value serializes identically to canonical,
+ *    the atom is omitted — at runtime the lookup falls through via
+ *    `cache.atoms[scheme]?.[atom] ?? cache.atoms.common[atom]`.
+ *
+ * Keyframes are inlined directly into atom values via `animationName`
+ * ({@link inlineAnimationName}). Safe-area markers get pre-enveloped
+ * via {@link envelopeSafeMarkers}. Hairline utilities stay bound to
+ * `StyleSheet.hairlineWidth` at runtime.
+ * @param atomNames All atom names (sorted).
+ * @param resolved Per-atom schemed styles from the parser.
+ * @param keyframes Keyframe blocks referenced by any atom.
+ * @param cache Optional shared serialized-value cache.
+ * @param breakpoints Responsive breakpoint name → px-threshold map. The
+ *   manifest emits `registerBreakpoints({...})` so the runtime can gate
+ *   `md:*` / `lg:*` atoms on `windowWidth`. Optional — empty when the
+ *   theme declares no breakpoints (legacy/test callers).
+ * @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;
+/** Registry key the runtime uses for the always-loaded fallback. */
+export declare const COMMON_SCHEME_NAME: string;

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

@@ -0,0 +1,3 @@
+export { UnionBuilder } from './union-builder';
+export { buildSchemeSources, COMMON_SCHEME_NAME } from './build-style';
+export type { BuildSchemeSourcesOutput } from './build-style';

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

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

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,128 @@
+import type { KeyframeBlock, SchemedStyle, TailwindParser } from '../parser';
+/**
+ * In-memory atom union + per-scheme style-file emitter.
+ *
+ * Correctness under multi-worker Metro relies on `ensureProjectScanned`:
+ * the FIRST `recordFile` / `writeSchemes` call in every worker drives
+ * the oxide Scanner across ALL project sources and hydrates the union
+ * with the complete set of candidates. Subsequent per-file
+ * `recordFile` calls only layer in atoms the scan already knew about,
+ * so writes are idempotent — different workers can't clobber each
+ * other's scheme files with partial views.
+ *
+ * Per-file deltas (atom set unchanged → early return) skip
+ * serialization entirely. On a theme-CSS change, `getRnwindState`
+ * builds a fresh parser + builder; the next call re-runs
+ * `ensureProjectScanned` against the new parser, producing scheme
+ * files with the new theme values.
+ */
+declare class UnionBuilder {
+    private readonly cacheDir;
+    private readonly parser;
+    private readonly unionAtoms;
+    private readonly unionKeyframes;
+    /**
+     * Responsive breakpoints captured from the parser. Refreshed on every
+     * `recordFile` / `ensureProjectScanned` so user-defined
+     * `--breakpoint-*` overrides land in the manifest the next time it's
+     * written. Identical for every parser call within one parser instance
+     * (theme is fixed for the parser's lifetime), so storing the latest
+     * snapshot is sufficient.
+     */
+    private breakpoints;
+    /** file → set of atom names this file currently contributes. */
+    private readonly fileAtomSets;
+    /** atom name → how many files currently contribute it (refcount). */
+    private readonly atomRefCount;
+    /** scheme → last-written source SHA. Skips re-writing unchanged schemes. */
+    private readonly schemeSignatures;
+    /**
+     * Per-atom serialized-value cache — identity-keyed on each atom's
+     * SchemedStyle reference. Carried across `writeSchemes` calls so the
+     * typical "user added one className" FR case re-stringifies ONE atom
+     * instead of all 175+. Cleared on `ensureProjectScanned` (full
+     * rescan replaces every reference) and individually invalidated for
+     * any atom `applyDiff` mutates.
+     */
+    private readonly serializedCache;
+    /** Running count of stringify passes (cache misses). Test telemetry. */
+    private serializedMissesCount;
+    /** Set after `ensureProjectScanned` completes. */
+    private projectScanned;
+    /** Promise guard so concurrent first-calls await ONE scan. */
+    private pendingScan;
+    constructor(cacheDir: string, parser: TailwindParser);
+    /** Absolute path of the manifest module (`rnwind/__generated/schemes`). */
+    get manifestPath(): string;
+    /**
+     * Snapshot of every source file the builder has recorded atoms for
+     * this worker session. Used by `withRnwindConfig`'s CSS watcher to
+     * touch `mtime` on each and nudge Metro into re-transforming them
+     * with the new theme values.
+     * @returns Absolute source paths.
+     */
+    recordedFiles(): readonly string[];
+    /** Cumulative cache-miss count — exposed for tests to assert cache behaviour. */
+    get serializedMisses(): number;
+    /**
+     * Absolute path of one scheme's style file.
+     * @param scheme Registry key.
+     * @returns Absolute path.
+     */
+    schemePath(scheme: string): string;
+    /**
+     * One-shot oxide scan + compile across every source the parser was
+     * configured with. Idempotent — safe to call from any entry point.
+     * Concurrent callers share the same in-flight promise.
+     */
+    ensureProjectScanned(): Promise<void>;
+    /**
+     * Record one source file's resolved atoms + keyframes. Short-circuits
+     * when the file's atom name set hasn't changed — the common case on
+     * every Fast Refresh save of a file whose className literals are
+     * unchanged.
+     * @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.
+     * @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<{
+        changed: boolean;
+    }>;
+    /**
+     * Forget one source file's contribution. Idempotent — repeated calls
+     * for a file that's already dropped are no-ops. Does NOT remove the
+     * atom from the union when another file (or the project scan) still
+     * references it.
+     * @param file Absolute source file path.
+     */
+    dropFile(file: string): void;
+    /**
+     * Serialize the union into per-scheme files + manifest, writing only
+     * files whose source bytes changed. Called after every `recordFile`
+     * from the transformer — and once at Metro startup via
+     * `ensureFilesExist` to seed disk from the project scan alone.
+     * @returns List of scheme keys whose files were rewritten (empty
+     *   when the union is byte-identical to the last flush).
+     */
+    writeSchemes(): Promise<{
+        changedSchemes: readonly string[];
+    }>;
+    /**
+     * Ensure the manifest + common scheme files exist on disk so Metro's
+     * resolver can SHA1 them at boot before the first transform runs.
+     */
+    ensureFilesExist(): Promise<void>;
+    /**
+     * Apply one file's atom-name diff to the in-memory refcount + union.
+     * @param file Source file path.
+     * @param newAtoms New atom-name set for the file.
+     * @param resolvedAtoms Fresh parser output — carries the resolved
+     *   styles for every entry in `newAtoms`.
+     * @param newKeyframes Keyframes this file's atoms reference.
+     */
+    private applyDiff;
+}
+export { UnionBuilder };

package/lib/cjs/core/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolved values for every CSS custom property in one theme scheme.
+ * Keys are the raw custom-property names (e.g. `--color-primary`) as they
+ * appear in the theme CSS. Values are the string / number primitives the
+ * parser emits after Tailwind compile + lightningcss walk.
+ */
+export type ThemeTable = Record<string, string | number>;
+/**
+ * Map from scheme name to its resolved {@link ThemeTable}. The scheme name
+ * matches the identifier the user declared in `@variant <name> { ... }` —
+ * `'light'`, `'dark'`, `'brand'`, etc. A synthetic `'base'` key carries
+ * tokens declared outside any variant block.
+ */
+export type ThemeTables = Record<string, ThemeTable>;