rainbowindex 0.5.1 → 0.7.0

package/dist/{context-B9yhJxd5.d.ts → context-DcBtnnan.d.ts}

@@ -1,108 +1,3 @@
-/**
- * Generative color system — color domain model, OKLCH ramp generation,
- * and light-dark() pairing.
- *
- * 2 numbers (chroma + hue) → 19-stop palette with automatic dark mode.
- *
- * The ramp is sampled from a fixed reference profile (`L_PROFILE` / `C_SHAPE` /
- * `H_DRIFT`, captured from the reference palette): lightness is a curved,
- * compressed scale (low suffix → light, high → dark), chroma is an asymmetric
- * bell peaking at stop 500, and hue is near-flat. Dark mode is a simple ramp
- * reversal — the dark value is the stop the ramp reaches at the mirror position
- * (`1000 - suffix`), so stop 500 pivots to itself.
- */
-/** Per-color dark mode override strategy. */
-type ColorDarkOverride = {
-    strategy: "mirror";
-} | {
-    strategy: "fixed";
-} | {
-    strategy: "shift";
-    chromaDelta: number;
-    hueDelta: number;
-};
-/**
- * Color definition — discriminated union supporting:
- * - Generative: `brand: 0.18 330;` → 19-stop palette with auto dark mode
- * - Explicit: `accent: oklch(0.72 0.21 330);` → single color value
- * - Pair: `surface: oklch(0.98 0.01 260) / oklch(0.15 0.01 260);` → light/dark pair
- * - Alias: `theme: brand;` → references another color's palette via var()
- */
-type ColorDefinition = {
-    type: "generative";
-    chroma: number;
-    hue: number;
-    dark?: ColorDarkOverride;
-    inline?: boolean;
-    parabolic?: boolean;
-    chromaBoost?: boolean;
-} | {
-    type: "explicit";
-    value: string;
-} | {
-    type: "keyword";
-    value: string;
-} | {
-    type: "pair";
-    light: string;
-    dark: string;
-} | {
-    type: "alias";
-    source: string;
-};
-interface DarkModeConfig {
-    mode: "auto" | "off";
-    chromaBoost: number;
-    hueShift: number;
-}
-
-/**
- * Default theme values — the static data that ships if the user writes no directives.
- * `directives.ts` (Phase 5) parses user overrides and merges them with these defaults.
- */
-
-interface TextSize {
-    fontSize: string;
-    lineHeight: string;
-}
-type FluidUnit = "vw" | "vi" | "vmin" | "vmax";
-interface FluidConfig {
-    min: string;
-    max: string;
-    unit?: FluidUnit;
-    multiplier?: number;
-}
-interface AnimationDefinition {
-    shorthand: string;
-    keyframes: string;
-}
-interface Theme {
-    spacing: {
-        base: string;
-    };
-    colors: Record<string, ColorDefinition>;
-    text: Record<string, TextSize>;
-    breakpoints: Record<string, string>;
-    shadows: Record<string, string>;
-    weights: Record<string, number>;
-    easing: Record<string, string>;
-    fluid: FluidConfig;
-    animations: Record<string, AnimationDefinition>;
-    blur: Record<string, string>;
-}
-/**
- * Keyword corner-shape values. `superellipse(N)` is represented separately
- * as `{ superellipse: N }` since the numeric parameter isn't a keyword.
- * Single source for the type, the scale table below, and the @rounded
- * modifier parser (directives/parsers.ts).
- */
-declare const CORNER_SHAPE_KEYWORDS: readonly ["round", "scoop", "bevel", "notch", "square", "squircle"];
-type CornerShapeKeyword = (typeof CORNER_SHAPE_KEYWORDS)[number];
-type CornerShape = CornerShapeKeyword | {
-    superellipse: number;
-};
-declare const defaultTheme: Theme;
-
 /**
  * Claim resolution for ri() — utility name → CSS properties it sets.
  *
@@ -118,7 +13,6 @@ declare const defaultTheme: Theme;
  *  here rather than in context.ts so this layer keeps taking its state as
  *  parameters instead of importing the context module. */
 type CustomFunctionalEntry = readonly [root: string, properties: readonly string[]];
-declare const DEFAULT_TEXT_SIZES: readonly ["xs", "sm", "base", "lg", "xl", "2xl", "3xl", "4xl", "5xl"];
 
 /**
  * Compilation-context lifecycle — all mutable state behind ri().
@@ -143,7 +37,10 @@ interface CompilationContext {
     fontFamilies: Set<string>;
     colorNames: Set<string>;
 }
-
+/**
+ * Frozen snapshot of compilation state for SSR-safe ri() instances.
+ * Created by finalizeCompilationContext() and consumed by createRi().
+ */
 interface CompilationSnapshot {
     readonly customStaticProps: Readonly<Record<string, string[]>>;
     /** Longest root first, so `glow-outer-*` wins over `glow-*` for `glow-outer-4`. */
@@ -179,10 +76,60 @@ declare function registerCustomFontFamilies(ctx: CompilationContext, families: s
  * match the shade pattern and need no registration.
  */
 declare function registerColorNames(ctx: CompilationContext, names: string[]): void;
+/**
+ * Publish a snapshot as the module-level state the default ri() reads.
+ *
+ * Split out of finalizeCompilationContext so a client bundle — which never runs
+ * a compile — can reach the same state through hydrateSnapshot(). Everything
+ * assigned here is already frozen-by-convention: the snapshot's arrays and Sets
+ * are the compile's own copies, never the mutable context's.
+ */
+declare function publishSnapshot(snapshot: CompilationSnapshot): void;
 /**
  * Snapshot compilation context into module-level state that ri() reads from.
  * Called at the end of compile() to atomically publish the new state.
  */
 declare function finalizeCompilationContext(ctx: CompilationContext): CompilationSnapshot;
+/**
+ * A CompilationSnapshot with its Sets flattened to sorted arrays.
+ *
+ * A snapshot is built on the server and read on the client, so it has to cross
+ * a boundary that only carries JSON. `JSON.stringify` turns a Set into `{}`,
+ * silently — the class merge would then run against an empty theme and drop
+ * every project-defined size, weight, font slot, and color. Sorting is for
+ * build determinism: the same theme must produce byte-identical output, or the
+ * emitted module churns on every build.
+ */
+interface SerializedSnapshot {
+    /** See {@link SNAPSHOT_FORMAT}. */
+    format: typeof SNAPSHOT_FORMAT;
+    customStaticProps: Readonly<Record<string, string[]>>;
+    customFunctionalProps: readonly CustomFunctionalEntry[];
+    textSizes: readonly string[];
+    fontFamilies: readonly string[];
+    colorNames: readonly string[];
+}
+/**
+ * The wire shape's version. Bump it when a change would make a module written
+ * by an older version unreadable.
+ *
+ * This is the whole of the runtime validation. Producer and consumer are two
+ * functions in this file, joined by one `JSON.stringify`, so the only way the
+ * shapes can disagree is a *stale generated module* — one committed or cached
+ * from an older release. That is one failure with one fix, and checking a
+ * number catches it; checking every field of every array, as this used to,
+ * caught nothing else and left the declared type unenforced.
+ */
+declare const SNAPSHOT_FORMAT = 1;
+declare function serializeSnapshot(snapshot: CompilationSnapshot): SerializedSnapshot;
+/**
+ * Rebuild a snapshot from its wire form.
+ *
+ * A wrong or missing {@link SNAPSHOT_FORMAT} means a generated module written
+ * by another release. That warns and yields the built-in defaults rather than
+ * throwing, because throwing here happens at import time inside someone's
+ * client bundle; the warning says which command puts it right.
+ */
+declare function hydrateSnapshot(data: SerializedSnapshot): CompilationSnapshot;
 
-export { type AnimationDefinition as A, type ColorDefinition as C, DEFAULT_TEXT_SIZES as D, type FluidConfig as F, type TextSize as T, type CompilationContext as a, type CompilationSnapshot as b, type Theme as c, createCompilationContext as d, defaultTheme as e, finalizeCompilationContext as f, registerCustomFontFamilies as g, registerCustomTextSizes as h, registerCustomUtility as i, type DarkModeConfig as j, type CornerShape as k, registerColorNames as r };
+export { type CompilationContext as C, type SerializedSnapshot as S, type CompilationSnapshot as a, registerCustomFontFamilies as b, createCompilationContext as c, registerCustomTextSizes as d, registerCustomUtility as e, finalizeCompilationContext as f, hydrateSnapshot as h, publishSnapshot as p, registerColorNames as r, serializeSnapshot as s };