rainbowindex 0.6.0 → 0.7.0

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

@@ -37,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`. */
@@ -73,119 +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;
-
 /**
- * Generative color system — color domain model, OKLCH ramp generation,
- * and light-dark() pairing.
+ * A CompilationSnapshot with its Sets flattened to sorted arrays.
  *
- * 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()
+ * 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.
  */
-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;
+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[];
 }
-
 /**
- * Default theme values — the static data that ships if the user writes no
- * directives. Only the colour palette and the spacing base ship a value; every
- * named scale starts empty and is filled by its directive.
+ * 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.
  */
-
-interface TextSize {
-    fontSize: string;
-    lineHeight: string;
-}
-/** Viewport units, and the container-query units that track a container
- *  instead. Keep in step with `FLUID_UNITS` in directives/resolver.ts, which
- *  validates the `unit` a `@fluid` block asks for. */
-type FluidUnit = "vw" | "vi" | "vmin" | "vmax" | "cqw" | "cqi" | "cqmin" | "cqmax";
-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>;
-}
+declare const SNAPSHOT_FORMAT = 1;
+declare function serializeSnapshot(snapshot: CompilationSnapshot): SerializedSnapshot;
 /**
- * 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).
+ * 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 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;
+declare function hydrateSnapshot(data: SerializedSnapshot): CompilationSnapshot;
 
-export { type AnimationDefinition as A, type ColorDefinition as C, type DarkModeConfig 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 CornerShape as j, 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 };