rnwind 0.0.1 → 0.0.2

package/lib/cjs/core/parser/typography.cjs

@@ -0,0 +1,97 @@
+'use strict';
+
+var length = require('./length.cjs');
+
+/**
+ * Expand lightningcss's `Display` typed value to an RN `{display}` entry.
+ *  - `keyword` variant (`none`, `flex`, `grid`, `inline`, …) passes through.
+ *  - `pair` variant (the modern CSS model — `{inside: {type}, outside,
+ *    isListItem}`) collapses to RN's `'flex'` / `'grid'` when the inside
+ *    type matches, otherwise skips.
+ * @param value Typed display value.
+ * @returns RN entries (zero or one).
+ */
+function displayToEntries(value) {
+    if (value.type === 'keyword')
+        return [['display', value.value]];
+    if (value.type === 'pair') {
+        const inside = value.inside.type;
+        // `flow` is the default inside mode — maps to `block` / `inline` /
+        // `inline-block` based on the outer; RN only distinguishes `block`-ish
+        // from `flex`, so collapse the `flow` family to the `outside` keyword.
+        if (inside === 'flow')
+            return [['display', value.outside]];
+        if (inside === 'flex')
+            return [['display', 'flex']];
+        if (inside === 'grid')
+            return [['display', 'grid']];
+    }
+    return [];
+}
+/**
+ * Convert `FontSize` to a pixel number. The `length` variant carries a
+ * `DimensionPercentage`; `absolute` / `relative` keyword variants have no
+ * RN numeric equivalent and get dropped.
+ * @param value Typed font-size value.
+ * @returns Pixel size, or `null` when not a pure length.
+ */
+function fontSizeToPx(value) {
+    if (value.type !== 'length')
+        return null;
+    const length$1 = length.dimensionPercentageToNumber(value.value);
+    if (typeof length$1 !== 'number')
+        return null;
+    return length$1;
+}
+/**
+ * Convert `FontWeight` to the form RN accepts — numbers for absolute
+ * weights, `'bolder'` / `'lighter'` keywords pass through as strings.
+ * @param value Typed font-weight value.
+ * @returns RN font weight.
+ */
+function fontWeightToValue(value) {
+    if (value.type === 'absolute') {
+        if (value.value.type === 'weight')
+            return value.value.value;
+        return value.value.type;
+    }
+    return value.type;
+}
+/**
+ * Coerce `z-index` to a number. `{type: 'auto'}` has no RN equivalent so
+ * it collapses to 0.
+ * @param value Typed z-index value.
+ * @returns Integer z-index.
+ */
+function zIndexToNumber(value) {
+    if (value.type === 'auto')
+        return 0;
+    return value.value;
+}
+/**
+ * Convert lightningcss `LineHeight` into RN's `lineHeight` entry. RN
+ * accepts a single number (pixel value). For unitless multipliers we
+ * multiply by the default 16-px font size (RN's base); for px values we
+ * pass through; percentages are approximated the same way.
+ * @param value Typed line-height.
+ * @returns RN entry.
+ */
+function lineHeightToEntries(value) {
+    if (value.type === 'normal')
+        return [['lineHeight', 20]];
+    if (value.type === 'number')
+        return [['lineHeight', Math.round(value.value * 16 * 10_000) / 10_000]];
+    if (value.type === 'length') {
+        const px = length.dimensionPercentageToNumber(value.value);
+        if (typeof px === 'number')
+            return [['lineHeight', Math.round(px * 10_000) / 10_000]];
+    }
+    return [];
+}
+
+exports.displayToEntries = displayToEntries;
+exports.fontSizeToPx = fontSizeToPx;
+exports.fontWeightToValue = fontWeightToValue;
+exports.lineHeightToEntries = lineHeightToEntries;
+exports.zIndexToNumber = zIndexToNumber;
+//# sourceMappingURL=typography.cjs.map

package/lib/cjs/core/parser/typography.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.cjs","sources":["../../../../../src/core/parser/typography.ts"],"sourcesContent":["import type { Display, FontSize, FontWeight, LineHeight, ZIndex } from 'lightningcss'\nimport { dimensionPercentageToNumber } from './length'\nimport type { RNEntry } from './types'\n\n/**\n * Expand lightningcss's `Display` typed value to an RN `{display}` entry.\n *  - `keyword` variant (`none`, `flex`, `grid`, `inline`, …) passes through.\n *  - `pair` variant (the modern CSS model — `{inside: {type}, outside,\n *    isListItem}`) collapses to RN's `'flex'` / `'grid'` when the inside\n *    type matches, otherwise skips.\n * @param value Typed display value.\n * @returns RN entries (zero or one).\n */\nexport function displayToEntries(value: Display): readonly RNEntry[] {\n  if (value.type === 'keyword') return [['display', value.value]]\n  if (value.type === 'pair') {\n    const inside = value.inside.type\n    // `flow` is the default inside mode — maps to `block` / `inline` /\n    // `inline-block` based on the outer; RN only distinguishes `block`-ish\n    // from `flex`, so collapse the `flow` family to the `outside` keyword.\n    if (inside === 'flow') return [['display', value.outside]]\n    if (inside === 'flex') return [['display', 'flex']]\n    if (inside === 'grid') return [['display', 'grid']]\n  }\n  return []\n}\n\n/**\n * Convert `FontSize` to a pixel number. The `length` variant carries a\n * `DimensionPercentage`; `absolute` / `relative` keyword variants have no\n * RN numeric equivalent and get dropped.\n * @param value Typed font-size value.\n * @returns Pixel size, or `null` when not a pure length.\n */\nexport function fontSizeToPx(value: FontSize): number | null {\n  if (value.type !== 'length') return null\n  const length = dimensionPercentageToNumber(value.value)\n  if (typeof length !== 'number') return null\n  return length\n}\n\n/**\n * Convert `FontWeight` to the form RN accepts — numbers for absolute\n * weights, `'bolder'` / `'lighter'` keywords pass through as strings.\n * @param value Typed font-weight value.\n * @returns RN font weight.\n */\nexport function fontWeightToValue(value: FontWeight): number | string {\n  if (value.type === 'absolute') {\n    if (value.value.type === 'weight') return value.value.value\n    return value.value.type\n  }\n  return value.type\n}\n\n/**\n * Coerce `z-index` to a number. `{type: 'auto'}` has no RN equivalent so\n * it collapses to 0.\n * @param value Typed z-index value.\n * @returns Integer z-index.\n */\nexport function zIndexToNumber(value: ZIndex): number {\n  if (value.type === 'auto') return 0\n  return value.value\n}\n\n/**\n * Convert lightningcss `LineHeight` into RN's `lineHeight` entry. RN\n * accepts a single number (pixel value). For unitless multipliers we\n * multiply by the default 16-px font size (RN's base); for px values we\n * pass through; percentages are approximated the same way.\n * @param value Typed line-height.\n * @returns RN entry.\n */\nexport function lineHeightToEntries(value: LineHeight): readonly RNEntry[] {\n  if (value.type === 'normal') return [['lineHeight', 20]]\n  if (value.type === 'number') return [['lineHeight', Math.round(value.value * 16 * 10_000) / 10_000]]\n  if (value.type === 'length') {\n    const px = dimensionPercentageToNumber(value.value)\n    if (typeof px === 'number') return [['lineHeight', Math.round(px * 10_000) / 10_000]]\n  }\n  return []\n}\n"],"names":["length","dimensionPercentageToNumber"],"mappings":";;;;AAIA;;;;;;;;AAQG;AACG,SAAU,gBAAgB,CAAC,KAAc,EAAA;AAC7C,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/D,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE;AACzB,QAAA,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI;;;;QAIhC,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,MAAM,KAAK,MAAM;AAAE,YAAA,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,MAAM;AAAE,YAAA,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACrD;AACA,IAAA,OAAO,EAAE;AACX;AAEA;;;;;;AAMG;AACG,SAAU,YAAY,CAAC,KAAe,EAAA;AAC1C,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;AAAE,QAAA,OAAO,IAAI;IACxC,MAAMA,QAAM,GAAGC,kCAA2B,CAAC,KAAK,CAAC,KAAK,CAAC;IACvD,IAAI,OAAOD,QAAM,KAAK,QAAQ;AAAE,QAAA,OAAO,IAAI;AAC3C,IAAA,OAAOA,QAAM;AACf;AAEA;;;;;AAKG;AACG,SAAU,iBAAiB,CAAC,KAAiB,EAAA;AACjD,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE;AAC7B,QAAA,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;AAAE,YAAA,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK;AAC3D,QAAA,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI;IACzB;IACA,OAAO,KAAK,CAAC,IAAI;AACnB;AAEA;;;;;AAKG;AACG,SAAU,cAAc,CAAC,KAAa,EAAA;AAC1C,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;AAAE,QAAA,OAAO,CAAC;IACnC,OAAO,KAAK,CAAC,KAAK;AACpB;AAEA;;;;;;;AAOG;AACG,SAAU,mBAAmB,CAAC,KAAiB,EAAA;AACnD,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACxD,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AACpG,IAAA,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE;QAC3B,MAAM,EAAE,GAAGC,kCAA2B,CAAC,KAAK,CAAC,KAAK,CAAC;QACnD,IAAI,OAAO,EAAE,KAAK,QAAQ;AAAE,YAAA,OAAO,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;IACvF;AACA,IAAA,OAAO,EAAE;AACX;;;;;;;;"}

package/lib/cjs/core/parser/typography.d.ts

@@ -0,0 +1,43 @@
+import type { Display, FontSize, FontWeight, LineHeight, ZIndex } from 'lightningcss';
+import type { RNEntry } from './types';
+/**
+ * Expand lightningcss's `Display` typed value to an RN `{display}` entry.
+ *  - `keyword` variant (`none`, `flex`, `grid`, `inline`, …) passes through.
+ *  - `pair` variant (the modern CSS model — `{inside: {type}, outside,
+ *    isListItem}`) collapses to RN's `'flex'` / `'grid'` when the inside
+ *    type matches, otherwise skips.
+ * @param value Typed display value.
+ * @returns RN entries (zero or one).
+ */
+export declare function displayToEntries(value: Display): readonly RNEntry[];
+/**
+ * Convert `FontSize` to a pixel number. The `length` variant carries a
+ * `DimensionPercentage`; `absolute` / `relative` keyword variants have no
+ * RN numeric equivalent and get dropped.
+ * @param value Typed font-size value.
+ * @returns Pixel size, or `null` when not a pure length.
+ */
+export declare function fontSizeToPx(value: FontSize): number | null;
+/**
+ * Convert `FontWeight` to the form RN accepts — numbers for absolute
+ * weights, `'bolder'` / `'lighter'` keywords pass through as strings.
+ * @param value Typed font-weight value.
+ * @returns RN font weight.
+ */
+export declare function fontWeightToValue(value: FontWeight): number | string;
+/**
+ * Coerce `z-index` to a number. `{type: 'auto'}` has no RN equivalent so
+ * it collapses to 0.
+ * @param value Typed z-index value.
+ * @returns Integer z-index.
+ */
+export declare function zIndexToNumber(value: ZIndex): number;
+/**
+ * Convert lightningcss `LineHeight` into RN's `lineHeight` entry. RN
+ * accepts a single number (pixel value). For unitless multipliers we
+ * multiply by the default 16-px font size (RN's base); for px values we
+ * pass through; percentages are approximated the same way.
+ * @param value Typed line-height.
+ * @returns RN entry.
+ */
+export declare function lineHeightToEntries(value: LineHeight): readonly RNEntry[];

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

@@ -0,0 +1,397 @@
+'use strict';
+
+/** Match atom names like `border-hairline`, `h-hairline`, `border-t-hairline`, etc. */
+const HAIRLINE_ATOM = /-hairline$/;
+/** Parser's synthetic "no variant" scheme — provides the canonical fallback. */
+const BASE_SCHEME = 'base';
+/** Runtime registry key for the always-loaded fallback scheme. */
+const COMMON_SCHEME = 'common';
+/** Sentinel key the parser sets on interactive (`active:`/`focus:`) atoms. */
+const STATE_KEY = '__state';
+/**
+ * Whether an atom is a `*-hairline` utility — its numeric value must be
+ * rewritten as `StyleSheet.hairlineWidth` at runtime.
+ * @param atomName Class name.
+ * @returns True when the atom is a hairline utility.
+ */
+function isHairlineAtom(atomName) {
+    return HAIRLINE_ATOM.test(atomName);
+}
+/**
+ * Whether an RN style object carries any own key. The parser emits
+ * empty `{}` for schemes an atom doesn't apply to; we treat those as
+ * "inherit canonical" and don't emit an entry for that scheme.
+ * @param style RN style object.
+ * @returns Whether the style has content.
+ */
+function isNonEmptyStyle(style) {
+    if (!style)
+        return false;
+    return Object.keys(style).length > 0;
+}
+/**
+ * Iterate per-scheme entries from a parser-produced schemed bucket,
+ * skipping the reserved `__state` metadata key.
+ * @param schemed Parser output for one atom.
+ * @yields `[scheme, style]` pairs in object-key order.
+ */
+function* iterScheme(schemed) {
+    const raw = schemed;
+    for (const key in raw) {
+        if (key === STATE_KEY)
+            continue;
+        yield [key, raw[key]];
+    }
+}
+/**
+ * Pick the canonical style for an atom — the value that goes into
+ * `common.style.js`. Prefers the parser's `base` entry (the "default
+ * when no variant matches"); falls back to the first non-empty per-
+ * scheme entry when the atom has no explicit base.
+ * @param schemed Parser-produced per-scheme bucket.
+ * @returns Canonical style, or undefined when every scheme is empty.
+ */
+function canonicalValue(schemed) {
+    const baseEntry = schemed[BASE_SCHEME];
+    if (isNonEmptyStyle(baseEntry))
+        return baseEntry;
+    for (const [, style] of iterScheme(schemed)) {
+        if (isNonEmptyStyle(style))
+            return style;
+    }
+    return undefined;
+}
+/**
+ * Collect every variant scheme name across the project's atoms. The
+ * synthetic `base` scheme is excluded — it's folded into the `common`
+ * output. Returns variants in sorted order for deterministic output.
+ * @param resolved Parser-produced atom map.
+ * @returns Variant scheme names (no `base`, no `common`).
+ */
+function collectVariantSchemes(resolved) {
+    const set = new Set();
+    for (const schemed of resolved.values()) {
+        for (const [scheme] of iterScheme(schemed)) {
+            if (scheme !== BASE_SCHEME)
+                set.add(scheme);
+        }
+    }
+    return [...set].toSorted((a, b) => a.localeCompare(b));
+}
+/**
+ * Normalize a CSS keyframe selector to the percentage form Reanimated
+ * v4 keyframes objects use.
+ * @param offset Selector text (`'from'`, `'to'`, `'50%'`).
+ * @returns Percentage string.
+ */
+function offsetToPercent(offset) {
+    if (offset === 'from')
+        return '0%';
+    if (offset === 'to')
+        return '100%';
+    return offset;
+}
+/**
+ * Replace a string `animationName` with the inline keyframes object
+ * Reanimated v4's CSS engine expects. Atoms whose `animationName`
+ * doesn't match any registered keyframe keep the original string.
+ * @param style RN style object (possibly carrying `animationName`).
+ * @param keyframes Keyframes available to this build.
+ * @returns Style with `animationName` inlined when matched.
+ */
+function inlineAnimationName(style, keyframes) {
+    const name = style.animationName;
+    if (typeof name !== 'string')
+        return style;
+    const block = keyframes.get(name);
+    if (!block)
+        return style;
+    const out = { ...style };
+    const inline = {};
+    for (const step of block.steps)
+        inline[offsetToPercent(step.offset)] = step.style;
+    out.animationName = inline;
+    return out;
+}
+/**
+ * Convert any safe-area markers in the style into a precomputed spec
+ * envelope. Atoms with `__safe` markers become
+ * `{__safeStyle: [[cssKey, sideTag, or, offset], ...]}` — the runtime
+ * resolver reads `value.__safeStyle` as a single property access and
+ * resolves against live insets without walking the value's keys.
+ * @param style RN style as resolved by the parser.
+ * @returns Original style OR the safe-style envelope.
+ */
+function envelopeSafeMarkers(style) {
+    let specs = null;
+    for (const key of Object.keys(style)) {
+        const value = style[key];
+        if (typeof value !== 'object' || !value)
+            continue;
+        const marker = value;
+        if (typeof marker.__safe !== 'string')
+            continue;
+        if (!specs)
+            specs = [];
+        specs.push([key, marker.__safe, marker.or, marker.offset]);
+    }
+    if (!specs)
+        return style;
+    return { __safeStyle: specs };
+}
+/**
+ * Serialise a single atom's RN style to a JS object literal. Honors
+ * the `*-hairline` sentinel: numeric values get rewritten to
+ * `StyleSheet.hairlineWidth` so device-density differences land in the
+ * rendered border.
+ * @param atomName The atom's class name (used to detect hairline).
+ * @param style The atom's RN style object.
+ * @returns JS object-literal source.
+ */
+function serializeStyle(atomName, style) {
+    const json = JSON.stringify(style);
+    if (!isHairlineAtom(atomName))
+        return json;
+    return json.replaceAll(/:(-?\d+(?:\.\d+)?)/g, ': StyleSheet.hairlineWidth');
+}
+/**
+ * Serialise an atom's resolved value — bare RN style object or an
+ * already-enveloped safe-style value.
+ * @param atomName Atom name (controls hairline rewrite).
+ * @param value Atom value (bare style or `{__safeStyle: spec[]}`).
+ * @returns JS source for the value.
+ */
+function serializeAtomValue(atomName, value) {
+    if (typeof value === 'object' && value !== null && '__safeStyle' in value)
+        return JSON.stringify(value);
+    return serializeStyle(atomName, value);
+}
+/**
+ * Resolve + envelope + serialize an atom's value under one scheme.
+ * @param atomName Atom name.
+ * @param style Raw RN style for this scheme.
+ * @param keyframes Keyframes available to this build.
+ * @returns Serialized text ready to emit.
+ */
+function prepareAtomValue(atomName, style, keyframes) {
+    const enveloped = envelopeSafeMarkers(inlineAnimationName(style, keyframes));
+    return serializeAtomValue(atomName, enveloped);
+}
+/**
+ * Per-file value deduplicator — interns each unique serialized atom
+ * value once and emits `const _s<N> = <value>` at module scope. Scheme
+ * entries reference the const instead of inlining the literal.
+ *
+ * Wins: (1) smaller bundle bytes for themes with many atoms sharing a
+ * style shape; (2) stable `===` inside one scheme so two atoms
+ * resolving to the same value yield the same object reference.
+ */
+class ValueDeduper {
+    byText = new Map();
+    decls = [];
+    intern(serialized) {
+        const existing = this.byText.get(serialized);
+        if (existing)
+            return existing;
+        const name = `_s${this.decls.length}`;
+        this.decls.push(`const ${name} = ${serialized}`);
+        this.byText.set(serialized, name);
+        return name;
+    }
+    get declarations() {
+        return this.decls;
+    }
+}
+/**
+ * Render one scheme file's source. `entries` is the list of atoms this
+ * scheme contributes — for `common` every atom's canonical value; for
+ * a variant only atoms whose value differs from canonical. Hairline
+ * atoms in this file trigger the `StyleSheet` import.
+ * @param schemeName Registry key (`'common'` or the variant name).
+ * @param entries `[atomName, serializedValue]` pairs to emit.
+ * @returns JS source text.
+ */
+function renderSchemeFile(schemeName, entries) {
+    const needsStyleSheet = entries.some(([atom]) => isHairlineAtom(atom));
+    const deduper = new ValueDeduper();
+    const recordLines = [];
+    for (const [atom, value] of entries) {
+        const ref = deduper.intern(value);
+        recordLines.push(`  ${JSON.stringify(atom)}: ${ref},`);
+    }
+    const lines = [];
+    if (needsStyleSheet)
+        lines.push(`import { StyleSheet } from 'react-native'`);
+    lines.push(`import { registerAtoms } from 'rnwind'`, ``);
+    if (deduper.declarations.length > 0) {
+        for (const decl of deduper.declarations)
+            lines.push(decl);
+        lines.push(``);
+    }
+    lines.push(`registerAtoms(${JSON.stringify(schemeName)}, {`, ...recordLines, `})`, ``);
+    return lines.join('\n');
+}
+/**
+ * Render the JS-object literal for the responsive-breakpoint table the
+ * runtime registers at manifest-load time. Sorted by ascending px
+ * threshold so the runtime can build a deterministic "tier index" for
+ * its style cache.
+ * @param breakpoints Breakpoint name → px-threshold map.
+ * @returns Object-literal source (`{}` when empty).
+ */
+function serializeBreakpoints(breakpoints) {
+    if (breakpoints.size === 0)
+        return '{}';
+    const entries = [...breakpoints].toSorted((a, b) => a[1] - b[1] || a[0].localeCompare(b[0]));
+    const inner = entries.map(([name, px]) => `${JSON.stringify(name)}: ${px}`).join(', ');
+    return `{ ${inner} }`;
+}
+/**
+ * Render the manifest module. Eager-imports `common.style.js` (every
+ * rewritten source file pulls this via a transitive side-effect
+ * import), registers the responsive-breakpoint table once, and lazy-
+ * requires every variant scheme's file through an inline require —
+ * first call in `ensureSchemeLoaded(name)` triggers the scheme
+ * module's evaluation; Metro's module cache makes subsequent calls
+ * no-ops.
+ * @param variants Variant scheme names (no `base`, no `common`).
+ * @param breakpoints Responsive breakpoint name → px-threshold map.
+ * @returns JS source text.
+ */
+function renderManifest(variants, breakpoints) {
+    const lines = [
+        `import { registerSchemeLoader, registerBreakpoints } from 'rnwind'`,
+        `import './common.style'`,
+        ``,
+        `registerBreakpoints(${serializeBreakpoints(breakpoints)})`,
+        ``,
+    ];
+    if (variants.length === 0) {
+        lines.push(`function ensureSchemeLoaded(_name) {}`, ``, `registerSchemeLoader(ensureSchemeLoaded)`, ``, `export { ensureSchemeLoaded }`, ``);
+        return lines.join('\n');
+    }
+    lines.push(`const LOADERS = {`);
+    for (const variant of variants) {
+        lines.push(`  ${JSON.stringify(variant)}: () => require(${JSON.stringify(`./${variant}.style`)}),`);
+    }
+    lines.push(`}`, ``, `function ensureSchemeLoaded(name) {`, `  const loader = LOADERS[name]`, `  if (loader) loader()`, `}`, ``, `registerSchemeLoader(ensureSchemeLoaded)`, ``, `export { ensureSchemeLoaded }`, ``);
+    return lines.join('\n');
+}
+/**
+ * Serialize one atom's canonical + variant-diff entries, honouring
+ * the per-atom cache. Returns the number of cache MISSES this atom
+ * incurred (0 when canonical was cached AND every needed variant was
+ * cached; 1 when anything had to be re-stringified). Split out of
+ * `buildSchemeSources` to keep that function under the repo's cognitive
+ * complexity budget.
+ *
+ * Two paths gated on whether the parser produced a non-empty `base`
+ * bucket:
+ *  - **Themed atom (base present)**: canonical goes to `common`, each
+ *    variant whose own value diverges from canonical writes the diff
+ *    into its own scheme file. `lookupAtom` then finds the variant's
+ *    override or falls through to common.
+ *  - **Scheme-gated atom (base empty)**: the atom only matches when a
+ *    specific scheme is active (Tailwind `light:` / `dark:` / `brand:`
+ *    selectors). Skipping `common` here is essential — registering it
+ *    would let the lookup fall through under non-matching schemes and
+ *    leak the variant style into every scheme. Each populated variant
+ *    bucket writes the value into its own scheme file directly.
+ * @param atom Atom name.
+ * @param schemed Parser-produced schemed bucket for the atom.
+ * @param canonical Canonical RN style for `common`.
+ * @param variants Variant scheme names in deterministic order.
+ * @param keyframes Keyframes available to inline.
+ * @param commonEntries Mutable collector for `common`'s `[atom, text]` pairs.
+ * @param variantEntries Mutable collector keyed by variant name.
+ * @param cache Optional shared serialized-value cache.
+ * @returns Number of JSON.stringify passes triggered for this atom.
+ */
+function collectAtomEntries(atom, schemed, canonical, variants, keyframes, commonEntries, variantEntries, cache) {
+    const cached = cache?.get(atom);
+    const hit = cached?.styleRef === schemed;
+    const baseEntry = schemed[BASE_SCHEME];
+    const isSchemeGated = !isNonEmptyStyle(baseEntry);
+    const canonicalText = hit ? cached.canonical : prepareAtomValue(atom, canonical, keyframes);
+    if (!isSchemeGated)
+        commonEntries.push([atom, canonicalText]);
+    const entry = hit
+        ? cached
+        : { styleRef: schemed, canonical: canonicalText, variants: new Map() };
+    if (!hit)
+        cache?.set(atom, entry);
+    for (const variant of variants) {
+        const own = schemed[variant];
+        if (!isNonEmptyStyle(own))
+            continue;
+        let ownText = entry.variants.get(variant);
+        if (ownText === undefined) {
+            ownText = prepareAtomValue(atom, own, keyframes);
+            entry.variants.set(variant, ownText);
+        }
+        if (!isSchemeGated && ownText === canonicalText)
+            continue;
+        variantEntries[variant].push([atom, ownText]);
+    }
+    return hit ? 0 : 1;
+}
+/** Empty fallback when the caller didn't supply breakpoints (legacy callers, tests). */
+const EMPTY_BREAKPOINTS = new Map();
+/**
+ * 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.
+ */
+function buildSchemeSources(atomNames, resolved, keyframes, cache, breakpoints = EMPTY_BREAKPOINTS) {
+    const variants = collectVariantSchemes(resolved);
+    const commonEntries = [];
+    const variantEntries = {};
+    for (const variant of variants)
+        variantEntries[variant] = [];
+    let misses = 0;
+    for (const atom of atomNames) {
+        const schemed = resolved.get(atom);
+        if (!schemed)
+            continue;
+        const canonical = canonicalValue(schemed);
+        if (!canonical)
+            continue;
+        misses += collectAtomEntries(atom, schemed, canonical, variants, keyframes, commonEntries, variantEntries, cache);
+    }
+    const schemeSources = {
+        [COMMON_SCHEME]: renderSchemeFile(COMMON_SCHEME, commonEntries),
+    };
+    for (const variant of variants) {
+        schemeSources[variant] = renderSchemeFile(variant, variantEntries[variant]);
+    }
+    return {
+        schemeSources,
+        manifestSource: renderManifest(variants, breakpoints),
+        variants,
+        serializedMisses: misses,
+    };
+}
+
+exports.buildSchemeSources = buildSchemeSources;
+//# sourceMappingURL=build-style.cjs.map

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 * Serialize one atom's canonical + variant-diff entries, honouring\n * the per-atom cache. Returns the number of cache MISSES this atom\n * incurred (0 when canonical was cached AND every needed variant was\n * cached; 1 when anything had to be re-stringified). Split out of\n * `buildSchemeSources` to keep that function under the repo's cognitive\n * complexity budget.\n *\n * Two paths gated on whether the parser produced a non-empty `base`\n * bucket:\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` then finds the variant's\n *    override or falls through to common.\n *  - **Scheme-gated atom (base empty)**: the atom only matches when a\n *    specific scheme is active (Tailwind `light:` / `dark:` / `brand:`\n *    selectors). Skipping `common` here is essential — registering it\n *    would let the lookup fall through under non-matching schemes and\n *    leak the variant style into every scheme. Each populated variant\n *    bucket writes the value into its own scheme file directly.\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 isSchemeGated = !isNonEmptyStyle(baseEntry)\n  const canonicalText = hit ? cached.canonical : prepareAtomValue(atom, canonical, keyframes)\n  if (!isSchemeGated) commonEntries.push([atom, canonicalText])\n  const entry: AtomSerializedEntry = hit\n    ? cached\n    : { styleRef: schemed, canonical: canonicalText, variants: new Map<string, string>() }\n  if (!hit) cache?.set(atom, entry)\n\n  for (const variant of variants) {\n    const own = (schemed as Readonly<Record<string, RNStyle>>)[variant]\n    if (!isNonEmptyStyle(own)) continue\n    let ownText = entry.variants.get(variant)\n    if (ownText === undefined) {\n      ownText = prepareAtomValue(atom, own, keyframes)\n      entry.variants.set(variant, ownText)\n    }\n    if (!isSchemeGated && 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;