rainbowindex 0.6.0 → 0.7.0

package/dist/{chunk-6U4IOFOS.mjs → chunk-XQGSG2HK.mjs}

@@ -5,7 +5,7 @@ function devWarn(message) {
   if (!IS_PROD) console.warn(message);
 }
 
-// src/merge/props.ts
+// src/utilities/property-maps.ts
 var PADDING_MAP = Object.freeze({
   p: ["padding"],
   px: ["padding-inline"],
@@ -90,6 +90,34 @@ var BORDER_DIR_PROPS = Object.freeze({
   "border-x": ["border-inline-width"],
   "border-y": ["border-block-width"]
 });
+var FILTER_SLOTS = Object.freeze([
+  "--ri-blur",
+  "--ri-brightness",
+  "--ri-contrast",
+  "--ri-grayscale",
+  "--ri-hue-rotate",
+  "--ri-invert",
+  "--ri-saturate",
+  "--ri-sepia",
+  "--ri-drop-shadow"
+]);
+var BACKDROP_FILTER_SLOTS = Object.freeze([
+  "--ri-backdrop-blur",
+  "--ri-backdrop-brightness",
+  "--ri-backdrop-contrast",
+  "--ri-backdrop-grayscale",
+  "--ri-backdrop-hue-rotate",
+  "--ri-backdrop-invert",
+  "--ri-backdrop-saturate",
+  "--ri-backdrop-sepia",
+  "--ri-backdrop-opacity"
+]);
+var FILTER_COMPOSED = FILTER_SLOTS.map((slot) => `var(${slot}, )`).join(" ");
+var BACKDROP_FILTER_COMPOSED = BACKDROP_FILTER_SLOTS.map((slot) => `var(${slot}, )`).join(
+  " "
+);
+
+// src/merge/static-props.ts
 var BUILTIN_STATIC_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   // Grow/shrink
   grow: ["flex-grow"],
@@ -141,6 +169,9 @@ var BUILTIN_STATIC_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   "transform-3d": ["transform-style"],
   // Translate/rotate/scale none
   "translate-none": ["translate"],
+  // `translate-3d` only opts into the Z axis; it claims the same property, so
+  // a later `translate-none` still wins and two of them dedupe.
+  "translate-3d": ["translate"],
   "rotate-none": ["rotate"],
   "scale-none": ["scale"],
   // Perspective
@@ -187,14 +218,22 @@ var BUILTIN_STATIC_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   // Divide-between reverse flags (scoped so they compose with divide-x/divide-y)
   "divide-x-reverse": ["~divide:--ri-divide-x-reverse"],
   "divide-y-reverse": ["~divide:--ri-divide-y-reverse"],
-  // Backdrop filter (static) — backdrop-blur-none resets all backdrop filters
-  "backdrop-blur-none": ["backdrop-filter"],
+  // Backdrop filter (static). `backdrop-blur-none` clears the blur slot and
+  // nothing else, so it claims what every other backdrop-blur spelling claims
+  // — that is what lets it dedupe against `backdrop-blur-lg` while leaving a
+  // `backdrop-invert` beside it alone.
+  "backdrop-blur-none": ["--ri-backdrop-blur", "backdrop-filter"],
+  // Bare `backdrop-filter` enables the chain without contributing to it, so it
+  // claims the shorthand alone and composes with every function to its left.
+  "backdrop-filter": ["backdrop-filter"],
   "backdrop-grayscale": ["--ri-backdrop-grayscale", "backdrop-filter"],
   "backdrop-invert": ["--ri-backdrop-invert", "backdrop-filter"],
   "backdrop-sepia": ["--ri-backdrop-sepia", "backdrop-filter"],
   // Filter (static) — filter-none resets all filters
-  "filter-none": ["filter"],
-  "backdrop-filter-none": ["backdrop-filter"],
+  "filter-none": ["filter", ...FILTER_SLOTS],
+  "backdrop-filter-none": ["backdrop-filter", ...BACKDROP_FILTER_SLOTS],
+  // Bare `filter`, as above: enables, does not reset.
+  filter: ["filter"],
   grayscale: ["--ri-grayscale", "filter"],
   invert: ["--ri-invert", "filter"],
   sepia: ["--ri-sepia", "filter"],
@@ -890,6 +929,9 @@ addAll(
   ],
   ["mix-blend-mode"]
 );
+Object.freeze(BUILTIN_STATIC_PROPS);
+
+// src/merge/prefix-props.ts
 var FLUID_EXCLUDED_PREFIXES = /* @__PURE__ */ new Set(["inset-s", "inset-e", "inset-bs", "inset-be"]);
 var FLUID_SPACING_PROPS = (() => {
   const rows = {};
@@ -986,6 +1028,14 @@ var PREFIX_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   "inset-shadow": ["box-shadow", "--ri-inset-shadow"],
   ring: ["box-shadow", "--ri-ring-shadow"],
   "inset-ring": ["box-shadow", "--ri-inset-ring-shadow"],
+  // `ring-offset-*` claims its own slots and NOT `box-shadow`, which is the
+  // whole reason it composes: the offset layer joins a chain some other class
+  // already emits the shorthand for. A claim on `box-shadow` here would let
+  // `ring-offset-2` dominate the `ring-2` doing the visible work — which is
+  // what happened before this row existed, when the family fell into the
+  // `ring` prefix and `ri("ring-2 ring-offset-2 ring-offset-white")` returned
+  // just `"ring-offset-white"`.
+  "ring-offset": ["--ri-ring-offset-width", "--ri-ring-offset-shadow"],
   // text-shadow is its own property (not part of the box-shadow composition)
   "text-shadow": ["text-shadow"],
   opacity: ["opacity"],
@@ -1004,7 +1054,9 @@ var PREFIX_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   "skew-y": ["transform", "--ri-skew-y"],
   transform: ["transform"],
   zoom: ["zoom"],
-  filter: ["filter"],
+  // `filter-[v]` replaces the chain outright, so it claims every slot. The
+  // bare `filter` static above is matched first and claims only the shorthand.
+  filter: ["filter", ...FILTER_SLOTS],
   brightness: ["--ri-brightness", "filter"],
   contrast: ["--ri-contrast", "filter"],
   saturate: ["--ri-saturate", "filter"],
@@ -1088,7 +1140,7 @@ var PREFIX_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   ...SCROLL_MARGIN_MAP,
   ...SCROLL_PADDING_MAP,
   // Backdrop filter — each function gets a unique CSS variable so they coexist
-  "backdrop-filter": ["backdrop-filter"],
+  "backdrop-filter": ["backdrop-filter", ...BACKDROP_FILTER_SLOTS],
   "backdrop-blur": ["--ri-backdrop-blur", "backdrop-filter"],
   "backdrop-brightness": ["--ri-backdrop-brightness", "backdrop-filter"],
   "backdrop-contrast": ["--ri-backdrop-contrast", "backdrop-filter"],
@@ -1137,6 +1189,11 @@ var PREFIX_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   decoration: ["text-decoration-thickness"],
   accent: ["accent-color"],
   caret: ["caret-color"],
+  // Scoped, like `divide`: the declaration is `color`, but it lands inside
+  // `&::placeholder`, so it never conflicts with `text-*`. Without the
+  // `~placeholder:` scope both would claim `color` and the merger would drop
+  // one of `text-red-500 placeholder-gray-400`.
+  placeholder: ["~placeholder:color"],
   // Composable scrollbar-color (shared scrollbar-color + per-part slot var).
   "scrollbar-thumb": ["scrollbar-color", "--ri-scrollbar-thumb"],
   "scrollbar-track": ["scrollbar-color", "--ri-scrollbar-track"],
@@ -1156,6 +1213,9 @@ var PREFIX_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   "position-area": ["position-area"],
   "anchor-scope": ["anchor-scope"]
 });
+Object.freeze(PREFIX_PROPS);
+
+// src/merge/props.ts
 var DIRECT_OVERRIDES = Object.assign(/* @__PURE__ */ Object.create(null), {
   padding: ["padding-inline", "padding-block"],
   "padding-inline": ["padding-inline-start", "padding-inline-end"],
@@ -1238,30 +1298,15 @@ var DIRECT_OVERRIDES = Object.assign(/* @__PURE__ */ Object.create(null), {
   ],
   "place-items": ["align-items", "justify-items"],
   "place-content": ["align-content", "justify-content"],
-  "place-self": ["align-self", "justify-self"],
-  // filter-none / backdrop-blur-none reset all individual filter functions
-  filter: [
-    "--ri-blur",
-    "--ri-brightness",
-    "--ri-contrast",
-    "--ri-saturate",
-    "--ri-hue-rotate",
-    "--ri-drop-shadow",
-    "--ri-grayscale",
-    "--ri-invert",
-    "--ri-sepia"
-  ],
-  "backdrop-filter": [
-    "--ri-backdrop-blur",
-    "--ri-backdrop-brightness",
-    "--ri-backdrop-contrast",
-    "--ri-backdrop-saturate",
-    "--ri-backdrop-grayscale",
-    "--ri-backdrop-invert",
-    "--ri-backdrop-sepia",
-    "--ri-backdrop-opacity",
-    "--ri-backdrop-hue-rotate"
-  ]
+  "place-self": ["align-self", "justify-self"]
+  // NOTE: `filter` and `backdrop-filter` deliberately have NO row here.
+  // This table is keyed on the CSS property, and every composable member of
+  // those families emits the shared shorthand as its second declaration — so
+  // a row here made `grayscale` claim `--ri-blur`, and `ri("blur-sm
+  // grayscale")` returned `"grayscale"`. The whole family annihilated itself,
+  // which is the opposite of the composition the slot variables exist for.
+  // The spellings that really do replace the chain claim the slots directly
+  // instead; see FILTER_SLOTS.
 });
 var OVERRIDES = (() => {
   const closed = /* @__PURE__ */ Object.create(null);
@@ -1279,9 +1324,31 @@ var OVERRIDES = (() => {
   }
   return closed;
 })();
-Object.freeze(BUILTIN_STATIC_PROPS);
-Object.freeze(PREFIX_PROPS);
 Object.freeze(OVERRIDES);
+var BUILTIN_STATIC_KEYS = new Set(Object.keys(BUILTIN_STATIC_PROPS));
+var PREFIX_PROP_KEYS = new Set(Object.keys(PREFIX_PROPS));
+var SORTED_PREFIXES = Object.keys(PREFIX_PROPS).sort((a, b) => b.length - a.length);
+function buildFirstSegmentMap(prefixes) {
+  const map = /* @__PURE__ */ new Map();
+  for (const prefix of prefixes) {
+    const dashIdx = prefix.indexOf("-");
+    const firstSeg = dashIdx === -1 ? prefix : prefix.slice(0, dashIdx);
+    const existing = map.get(firstSeg);
+    if (existing) {
+      existing.push(prefix);
+    } else {
+      map.set(firstSeg, [prefix]);
+    }
+  }
+  const frozen = /* @__PURE__ */ new Map();
+  for (const [key, arr] of map) {
+    frozen.set(key, Object.freeze(arr));
+  }
+  return frozen;
+}
+var PREFIX_FIRST_SEGMENT_MAP = buildFirstSegmentMap(SORTED_PREFIXES);
+
+// src/merge/value-kinds.ts
 var RE_COLOR_SHADE = /^[a-z]+(?:-[a-z]+)*-\d{2,3}$/;
 var COLOR_FUNCTION_ALTERNATION = "oklch|oklab|rgb|rgba|hsl|hsla|hwb|lab|lch|color|light-dark";
 var RE_ARBITRARY_COLOR = new RegExp(`[#]|(?:${COLOR_FUNCTION_ALTERNATION})\\s*\\(`);
@@ -1357,28 +1424,6 @@ function isFontFamilyValue(value) {
   }
   return false;
 }
-var BUILTIN_STATIC_KEYS = new Set(Object.keys(BUILTIN_STATIC_PROPS));
-var PREFIX_PROP_KEYS = new Set(Object.keys(PREFIX_PROPS));
-var SORTED_PREFIXES = Object.keys(PREFIX_PROPS).sort((a, b) => b.length - a.length);
-function buildFirstSegmentMap(prefixes) {
-  const map = /* @__PURE__ */ new Map();
-  for (const prefix of prefixes) {
-    const dashIdx = prefix.indexOf("-");
-    const firstSeg = dashIdx === -1 ? prefix : prefix.slice(0, dashIdx);
-    const existing = map.get(firstSeg);
-    if (existing) {
-      existing.push(prefix);
-    } else {
-      map.set(firstSeg, [prefix]);
-    }
-  }
-  const frozen = /* @__PURE__ */ new Map();
-  for (const [key, arr] of map) {
-    frozen.set(key, Object.freeze(arr));
-  }
-  return frozen;
-}
-var PREFIX_FIRST_SEGMENT_MAP = buildFirstSegmentMap(SORTED_PREFIXES);
 
 // src/brackets.ts
 function scanBracketAware(input, onChar, options) {
@@ -1471,10 +1516,18 @@ var DECORATION_COLOR_PROPS = Object.freeze(["text-decoration-color"]);
 var RE_SIGNED_INT = /^-?\d+$/;
 var RE_UNSIGNED_INT = /^\d+$/;
 var RE_DECIMAL = /^\d+(?:[._]\d+)?$/;
-function colorOrDefault(prefix, colorProps) {
+function colorOrDefault(prefix, colorProps, hasInitial = false) {
   const defaultProps = PREFIX_PROPS[prefix];
-  return (value, _textSizes2, _fontFamilies2, colorNames) => isColorValue(value, void 0, colorNames) ? colorProps : defaultProps;
+  return (value, _textSizes2, _fontFamilies2, colorNames) => hasInitial && value === "initial" || isColorValue(value, void 0, colorNames) ? colorProps : defaultProps;
 }
+var RING_INSET_PROPS = Object.freeze(["--ri-ring-inset"]);
+var RING_COLOR_PROPS = Object.freeze(["--ri-ring-color"]);
+var RING_DEFAULT_PROPS = PREFIX_PROPS.ring;
+var RING_DUAL_MODE = (value, _textSizes2, _fontFamilies2, colorNames) => {
+  if (isColorValue(value, void 0, colorNames)) return RING_COLOR_PROPS;
+  if (value === "inset") return RING_INSET_PROPS;
+  return RING_DEFAULT_PROPS;
+};
 var DUAL_MODE_PREFIXES = {
   ...MASK_STOP_DUAL_MODES,
   // mask-radial-[<size>] sets the size var; mask-radial-[<value>] is a full image.
@@ -1519,11 +1572,12 @@ var DUAL_MODE_PREFIXES = {
   // so a color-first check would misclassify it) and background-color
   // for everything else — never the full `background` shorthand.
   bg: (value) => isImageValue(value) ? BG_IMAGE_PROPS : PREFIX_PROPS.bg,
-  shadow: colorOrDefault("shadow", Object.freeze(["--ri-shadow-color"])),
-  "inset-shadow": colorOrDefault("inset-shadow", Object.freeze(["--ri-inset-shadow-color"])),
-  ring: colorOrDefault("ring", Object.freeze(["--ri-ring-color"])),
+  shadow: colorOrDefault("shadow", Object.freeze(["--ri-shadow-color"]), true),
+  "ring-offset": colorOrDefault("ring-offset", Object.freeze(["--ri-ring-offset-color"])),
+  "inset-shadow": colorOrDefault("inset-shadow", Object.freeze(["--ri-inset-shadow-color"]), true),
+  ring: RING_DUAL_MODE,
   "inset-ring": colorOrDefault("inset-ring", Object.freeze(["--ri-inset-ring-color"])),
-  "text-shadow": colorOrDefault("text-shadow", Object.freeze(["--ri-text-shadow-color"])),
+  "text-shadow": colorOrDefault("text-shadow", Object.freeze(["--ri-text-shadow-color"]), true),
   "drop-shadow": colorOrDefault("drop-shadow", Object.freeze(["--ri-drop-shadow-color"])),
   from: (value) => isGradientPositionValue(value) ? PREFIX_PROPS["from-position"] : PREFIX_PROPS.from,
   via: (value) => isGradientPositionValue(value) ? PREFIX_PROPS["via-position"] : PREFIX_PROPS.via,
@@ -1701,8 +1755,7 @@ function snapshotCompilationContext(ctx) {
     colorNames: new Set(ctx.colorNames)
   };
 }
-function finalizeCompilationContext(ctx) {
-  const snapshot = snapshotCompilationContext(ctx);
+function publishSnapshot(snapshot) {
   _customStaticProps = snapshot.customStaticProps;
   _customFunctionalProps = snapshot.customFunctionalProps;
   _textSizes = snapshot.textSizes;
@@ -1710,8 +1763,52 @@ function finalizeCompilationContext(ctx) {
   _colorNames = snapshot.colorNames;
   defaultRiCache.clear();
   _latestSnapshot = snapshot;
+}
+function finalizeCompilationContext(ctx) {
+  const snapshot = snapshotCompilationContext(ctx);
+  publishSnapshot(snapshot);
   return snapshot;
 }
+var SNAPSHOT_FORMAT = 1;
+function serializeSnapshot(snapshot) {
+  return {
+    format: SNAPSHOT_FORMAT,
+    customStaticProps: Object.fromEntries(
+      Object.entries(snapshot.customStaticProps).map(([k, v]) => [k, [...v]]).sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)
+    ),
+    // Already tuples, and already ordered longest-root-first — an order the
+    // resolver depends on, so it is preserved rather than sorted.
+    customFunctionalProps: snapshot.customFunctionalProps.map(
+      ([root, props]) => [root, [...props]]
+    ),
+    textSizes: [...snapshot.textSizes].sort(),
+    fontFamilies: [...snapshot.fontFamilies].sort(),
+    colorNames: [...snapshot.colorNames].sort()
+  };
+}
+function hydrateSnapshot(data) {
+  if (data?.format !== SNAPSHOT_FORMAT) {
+    devWarn(
+      `[RI-2007] The generated theme snapshot was written for format ${String(data?.format)}, but this version of rainbowindex reads format ${SNAPSHOT_FORMAT}. Its theme was ignored, so \`ri()\` will guess at project-defined sizes and colours. Re-run \`rainbowindex generate-snapshot\`, or update the plugin that generates it.`
+    );
+    return {
+      customStaticProps: {},
+      customFunctionalProps: [],
+      textSizes: /* @__PURE__ */ new Set(),
+      // The three built-in slots are always live: an absent list means "no
+      // snapshot said otherwise", not "no font slots exist".
+      fontFamilies: new Set(DEFAULT_FONT_FAMILIES),
+      colorNames: /* @__PURE__ */ new Set()
+    };
+  }
+  return {
+    customStaticProps: data.customStaticProps,
+    customFunctionalProps: data.customFunctionalProps,
+    textSizes: new Set(data.textSizes),
+    fontFamilies: new Set(data.fontFamilies),
+    colorNames: new Set(data.colorNames)
+  };
+}
 
 // src/merge/index.ts
 var RI_CACHE_KEY_MAX_LEN = 2048;
@@ -1808,7 +1905,7 @@ function mergeClasses(classes, resolve, cache) {
   if (useCache) cache.put(cacheKey, output);
   return output;
 }
-function mergeFrom(inputs, resolve, cache) {
+function mergeFrom(inputs, resolve, cache, warnUnthemed = false) {
   let fastPath = true;
   let rawKey = "";
   for (let i = 0; i < inputs.length; i++) {
@@ -1826,6 +1923,7 @@ function mergeFrom(inputs, resolve, cache) {
       const cached = cache.get(rawKey);
       if (cached !== void 0) return cached;
       const classes2 = flattenInputs(inputs);
+      if (warnUnthemed && classes2.length > 1) warnUnpublishedTheme(classes2, resolve);
       const output = classes2.length === 0 ? "" : classes2.length === 1 ? classes2[0] : mergeUncached(classes2, resolve);
       cache.put(rawKey, output);
       return output;
@@ -1834,14 +1932,9 @@ function mergeFrom(inputs, resolve, cache) {
   const classes = flattenInputs(inputs);
   if (classes.length === 0) return "";
   if (classes.length === 1) return classes[0];
+  if (warnUnthemed) warnUnpublishedTheme(classes, resolve);
   return mergeClasses(classes, resolve, cache);
 }
-var _isSSR = null;
-function detectSSR() {
-  if (_isSSR !== null) return _isSSR;
-  _isSSR = typeof window === "undefined" && typeof process !== "undefined" && !!process.versions?.node;
-  return _isSSR;
-}
 var WARNING_THROTTLE_MS = 6e4;
 function throttledWarn(message, emit = console.warn) {
   let last = Number.NEGATIVE_INFINITY;
@@ -1853,15 +1946,32 @@ function throttledWarn(message, emit = console.warn) {
     }
   };
 }
-var warnSSRUsage = throttledWarn(
-  () => !hasFinalizedSnapshot() ? (
-    // No compilation has ever finalized — module-level state is uninitialized
-    // defaults. In SSR this almost certainly means ri() is being called without
-    // a preceding compile pass, which will produce incorrect merge results
-    // for custom utilities, text sizes, and font families.
-    "[RI-2004] ri() called in an SSR environment before any compilation has finalized. The default ri() export reads module-level state that has not been initialized. Custom utilities, text sizes, and font families will not be recognized. Use createRi(snapshot) for concurrent-safe class merging. See: https://rainbowindex.dev/docs/ssr"
-  ) : "[RI-2004] The default ri() export uses module-level state and is not safe for concurrent SSR requests. Use createRi(snapshot) for isolation. See: https://rainbowindex.dev/docs/ssr\nThis warning repeats every 60 s until resolved. In production SSR, switch to createRi(snapshot) to prevent silent data corruption between concurrent requests."
-);
+var _warnedNoSnapshot = false;
+function shouldCheckSnapshot() {
+  return !_warnedNoSnapshot && !hasFinalizedSnapshot();
+}
+function isThemeDependent(cls, resolve) {
+  const splitIdx = findVariantSplit(cls);
+  let utility = splitIdx === -1 ? cls : cls.slice(splitIdx + 1);
+  if (utility.charCodeAt(utility.length - 1) === 33) utility = utility.slice(0, -1);
+  if (utility.charCodeAt(0) === 45) utility = utility.slice(1);
+  return utility.startsWith("text-") || utility.startsWith("font-") || resolve(utility) === null;
+}
+function warnUnpublishedTheme(classes, resolve) {
+  if (_warnedNoSnapshot || hasFinalizedSnapshot()) return;
+  let offender;
+  for (const cls of classes) {
+    if (isThemeDependent(cls, resolve)) {
+      offender = cls;
+      break;
+    }
+  }
+  if (offender === void 0) return;
+  _warnedNoSnapshot = true;
+  console.warn(
+    `[RI-2004] ri() merged "${offender}" with no theme published, so its meaning was guessed. Since 0.6.0 text sizes, weights, font slots, and color names are all project-defined, and without them a size can be read as a color and dropped. With Vite this is automatic \u2014 check the plugin is installed. Otherwise run \`rainbowindex generate-snapshot\` and import the generated module once at startup, or pass a snapshot to createRi(snapshot). This warns once per process. See: https://rainbowindex.dev/docs/ssr`
+  );
+}
 var warnFlattenDepth = throttledWarn(
   () => `[RI-2011] ri() input nesting exceeds maximum depth of ${MAX_FLATTEN_DEPTH}. Deeply nested inputs are silently dropped. Flatten your class arrays to avoid this limit.`
 );
@@ -1876,10 +1986,7 @@ var warnNonStringInput = throttledWarn(
   devWarn
 );
 function ri(...inputs) {
-  if (detectSSR()) {
-    warnSSRUsage();
-  }
-  return mergeFrom(inputs, resolveProps, defaultRiCache);
+  return mergeFrom(inputs, resolveProps, defaultRiCache, shouldCheckSnapshot());
 }
 function createRi(snapshot) {
   const resolve = resolverFor(snapshot);
@@ -1966,458 +2073,6 @@ function splitBracketAware(input) {
   return result;
 }
 
-// src/theme/colors.ts
-function isValidColorSuffix(n) {
-  return Number.isInteger(n) && n >= 1 && n <= 999;
-}
-var STOP_LO = 50;
-var STOP_STEP = 50;
-var L_PROFILE = [
-  0.9668,
-  // 50
-  0.936756,
-  // 100
-  0.905984,
-  // 150
-  0.87442,
-  // 200
-  0.841988,
-  // 250
-  0.808602,
-  // 300
-  0.774158,
-  // 350
-  0.73853,
-  // 400
-  0.701568,
-  // 450
-  0.663082,
-  // 500
-  0.622832,
-  // 550
-  0.580504,
-  // 600
-  0.535677,
-  // 650
-  0.487755,
-  // 700
-  0.435847,
-  // 750
-  0.378506,
-  // 800
-  0.313034,
-  // 850
-  0.232988,
-  // 900
-  0.045
-  // 950
-];
-var REF_CHROMA = 0.05;
-var C_REF = [
-  0.006863863034589374,
-  // 50
-  0.01319862716849036,
-  // 100
-  0.019388384668336325,
-  // 150
-  0.025429811853816625,
-  // 200
-  0.03131716290796655,
-  // 250
-  0.03704281264548738,
-  // 300
-  0.04259815284255128,
-  // 350
-  0.04797259847240491,
-  // 400
-  0.053139652622711774,
-  // 450
-  0.05807254410984486,
-  // 500
-  0.057890440330825195,
-  // 550
-  0.05222950205066024,
-  // 600
-  0.04663166172903349,
-  // 650
-  0.04108661482545571,
-  // 700
-  0.035584106512529856,
-  // 750
-  0.030108630901677546,
-  // 800
-  0.02463007273923548,
-  // 850
-  0.01911062262055484,
-  // 900
-  0.013470720217073236
-  // 950
-];
-var H_DRIFT = [
-  -0.93815866691077,
-  // 50
-  -0.88308454198904,
-  // 100
-  -0.82986570023714,
-  // 150
-  -0.77925524218887,
-  // 200
-  -0.73231968077941,
-  // 250
-  -0.69055370894147,
-  // 300
-  -0.65608113228225,
-  // 350
-  -0.6319804472577,
-  // 400
-  -0.62282301825498,
-  // 450
-  -0.63542113918918,
-  // 500
-  -0.65047025648765,
-  // 550
-  -0.64293938410323,
-  // 600
-  -0.63626978185344,
-  // 650
-  -0.63057786221076,
-  // 700
-  -0.62611168444876,
-  // 750
-  -0.62332854799372,
-  // 800
-  -0.62317507759171,
-  // 850
-  -0.62789446720379,
-  // 900
-  -0.64378251527182
-  // 950
-];
-function sampleProfile(values, suffix, monotone) {
-  const last = values.length - 1;
-  const fx = (suffix - STOP_LO) / STOP_STEP;
-  if (fx <= 0) return values[0] + (values[1] - values[0]) * fx;
-  if (fx >= last) return values[last] + (values[last] - values[last - 1]) * (fx - last);
-  const i = Math.floor(fx);
-  const t = fx - i;
-  if (t === 0) return values[i];
-  const seg = values[i + 1] - values[i];
-  const tangent = (k) => {
-    if (k <= 0) return values[1] - values[0];
-    if (k >= last) return values[last] - values[last - 1];
-    return (values[k + 1] - values[k - 1]) / 2;
-  };
-  let m0 = tangent(i);
-  let m1 = tangent(i + 1);
-  if (monotone) {
-    if (seg === 0) {
-      m0 = 0;
-      m1 = 0;
-    } else {
-      const a = m0 / seg;
-      const b = m1 / seg;
-      const s = a * a + b * b;
-      if (s > 9) {
-        const tau = 3 / Math.sqrt(s);
-        m0 = tau * a * seg;
-        m1 = tau * b * seg;
-      }
-    }
-  }
-  const t2 = t * t;
-  const t3 = t2 * t;
-  return (2 * t3 - 3 * t2 + 1) * values[i] + (t3 - 2 * t2 + t) * m0 + (-2 * t3 + 3 * t2) * values[i + 1] + (t3 - t2) * m1;
-}
-function lightnessFromSuffix(suffix) {
-  return Math.min(0.98, Math.max(0.02, sampleProfile(L_PROFILE, suffix, true)));
-}
-var DEFAULT_COLORS = Object.freeze({
-  theme: {
-    type: "generative",
-    chroma: 0,
-    hue: 0,
-    parabolic: false,
-    chromaBoost: false
-  }
-});
-var DEFAULT_DARK_CONFIG = {
-  mode: "auto",
-  // 0 → dark keeps the light stop's chroma exactly (same tone in both modes).
-  // Raise it via `@color dark { chroma-boost }` for punchier dark-mode colors.
-  chromaBoost: 0,
-  hueShift: 0
-};
-var GAMUT_CLAMP_ITERATIONS = 20;
-function oklchToOklab(l, c, h) {
-  const hRad = h * Math.PI / 180;
-  return [l, c * Math.cos(hRad), c * Math.sin(hRad)];
-}
-function oklabToLinearSrgb(l, a, b) {
-  const l_ = l + 0.3963377774 * a + 0.2158037573 * b;
-  const m_ = l - 0.1055613458 * a - 0.0638541728 * b;
-  const s_ = l - 0.0894841775 * a - 1.291485548 * b;
-  const lc = l_ * l_ * l_;
-  const mc = m_ * m_ * m_;
-  const sc = s_ * s_ * s_;
-  const r = 4.0767416621 * lc - 3.3077115913 * mc + 0.2309699292 * sc;
-  const g = -1.2684380046 * lc + 2.6097574011 * mc - 0.3413193965 * sc;
-  const bv = -0.0041960863 * lc - 0.7034186147 * mc + 1.707614701 * sc;
-  return [r, g, bv];
-}
-function isInSrgbGamut(l, c, h) {
-  const [la, a, b] = oklchToOklab(l, c, h);
-  const [r, g, bv] = oklabToLinearSrgb(la, a, b);
-  const eps = 1e-3;
-  return r >= -eps && r <= 1 + eps && g >= -eps && g <= 1 + eps && bv >= -eps && bv <= 1 + eps;
-}
-function gamutSafeChroma(l, requestedChroma, h) {
-  if (requestedChroma <= 0) return 0;
-  if (isInSrgbGamut(l, requestedChroma, h)) return requestedChroma;
-  let lo = 0;
-  let hi = requestedChroma;
-  for (let i = 0; i < GAMUT_CLAMP_ITERATIONS; i++) {
-    const mid = (lo + hi) / 2;
-    if (isInSrgbGamut(l, mid, h)) {
-      lo = mid;
-    } else {
-      hi = mid;
-    }
-    if (hi - lo < 5e-4) break;
-  }
-  return lo;
-}
-var APCA_MAIN_TRC = 2.4;
-var APCA_NORM_BG = 0.56;
-var APCA_NORM_TXT = 0.57;
-var APCA_REV_TXT = 0.62;
-var APCA_REV_BG = 0.65;
-var APCA_BLK_THRS = 0.022;
-var APCA_BLK_CLMP = Math.SQRT2;
-var APCA_SCALE = 1.14;
-var APCA_LO_BOW_OFFSET = 0.027;
-var APCA_LO_WOB_OFFSET = 0.027;
-var APCA_DELTA_Y_MIN = 5e-4;
-var APCA_LO_CLIP = 0.1;
-function linearToSrgb(c) {
-  const x = Math.max(0, Math.min(1, c));
-  return x <= 31308e-7 ? 12.92 * x : 1.055 * x ** (1 / 2.4) - 0.055;
-}
-function oklchToApcaY(l, c, h) {
-  const [la, a, b] = oklchToOklab(l, c, h);
-  const [lr, lg, lb] = oklabToLinearSrgb(la, a, b);
-  const r = linearToSrgb(lr);
-  const g = linearToSrgb(lg);
-  const bv = linearToSrgb(lb);
-  return 0.2126 * r ** APCA_MAIN_TRC + 0.7152 * g ** APCA_MAIN_TRC + 0.0722 * bv ** APCA_MAIN_TRC;
-}
-function apcaContrast(yText, yBg) {
-  if (yText < 0 || yBg < 0) return 0;
-  if (Math.max(yText, yBg) < APCA_BLK_THRS) return 0;
-  const txtY = yText < APCA_BLK_THRS ? yText + (APCA_BLK_THRS - yText) ** APCA_BLK_CLMP : yText;
-  const bgY = yBg < APCA_BLK_THRS ? yBg + (APCA_BLK_THRS - yBg) ** APCA_BLK_CLMP : yBg;
-  if (Math.abs(bgY - txtY) < APCA_DELTA_Y_MIN) return 0;
-  if (bgY > txtY) {
-    const sapc2 = (bgY ** APCA_NORM_BG - txtY ** APCA_NORM_TXT) * APCA_SCALE;
-    return sapc2 < APCA_LO_CLIP ? 0 : (sapc2 - APCA_LO_BOW_OFFSET) * 100;
-  }
-  const sapc = (bgY ** APCA_REV_BG - txtY ** APCA_REV_TXT) * APCA_SCALE;
-  return sapc > -APCA_LO_CLIP ? 0 : (sapc + APCA_LO_WOB_OFFSET) * 100;
-}
-var _stopMemo = /* @__PURE__ */ new WeakMap();
-function generateStop(def, suffix) {
-  let bySuffix = _stopMemo.get(def);
-  if (!bySuffix) {
-    bySuffix = /* @__PURE__ */ new Map();
-    _stopMemo.set(def, bySuffix);
-  }
-  const cached = bySuffix.get(suffix);
-  if (cached) return cached;
-  const stop = computeStop(def, suffix);
-  bySuffix.set(suffix, stop);
-  return stop;
-}
-function computeStop(def, suffix) {
-  const roundedL = Math.round(lightnessFromSuffix(suffix) * 1e3) / 1e3;
-  const h = def.chroma > 0 ? def.hue + sampleProfile(H_DRIFT, suffix, false) : def.hue;
-  const roundedH = Math.round(h * 1e3) / 1e3;
-  const shapedChroma = def.parabolic === false ? def.chroma : def.chroma * sampleProfile(C_REF, suffix, false) / REF_CHROMA;
-  const safeC = gamutSafeChroma(roundedL, shapedChroma, roundedH);
-  const roundedC = Math.floor(safeC * 1e4) / 1e4;
-  return {
-    stop: suffix,
-    l: roundedL,
-    c: roundedC,
-    h: roundedH
-  };
-}
-function computeDarkStop(def, suffix, darkConfig, darkOverride) {
-  const lightStop = generateStop(def, suffix);
-  const darkL = generateStop(def, 1e3 - suffix).l;
-  let extraChroma = 0;
-  let extraHue = 0;
-  if (darkOverride?.strategy === "shift") {
-    extraChroma = darkOverride.chromaDelta;
-    extraHue = darkOverride.hueDelta;
-  }
-  const darkH = lightStop.h + darkConfig.hueShift + extraHue;
-  const globalChromaBoost = def.chromaBoost !== false ? darkConfig.chromaBoost : 0;
-  const requestedChroma = lightStop.c + globalChromaBoost + extraChroma;
-  const darkC = Math.floor(gamutSafeChroma(darkL, requestedChroma, darkH) * 1e4) / 1e4;
-  return { stop: suffix, l: darkL, c: darkC, h: darkH };
-}
-function formatOklch(l, c, h) {
-  return `oklch(${l} ${c} ${h})`;
-}
-function generateColorVariables(name, def, suffixes, darkConfig = DEFAULT_DARK_CONFIG, darkOverride) {
-  const vars = [];
-  const strategy = darkOverride?.strategy ?? "mirror";
-  for (const suffix of suffixes) {
-    const lightStop = generateStop(def, suffix);
-    const lightValue = formatOklch(lightStop.l, lightStop.c, lightStop.h);
-    if (darkConfig.mode === "off" || strategy === "fixed") {
-      if (darkConfig.mode === "off") {
-        vars.push(`--color-${name}-${suffix}: ${lightValue};`);
-      } else {
-        vars.push(`--color-${name}-${suffix}: light-dark(${lightValue}, ${lightValue});`);
-      }
-    } else {
-      const darkStop = computeDarkStop(def, suffix, darkConfig, darkOverride);
-      const darkValue = formatOklch(darkStop.l, darkStop.c, darkStop.h);
-      vars.push(`--color-${name}-${suffix}: light-dark(${lightValue}, ${darkValue});`);
-    }
-  }
-  return vars;
-}
-var SEMANTIC_COLORS = Object.freeze([
-  "--color-paper: light-dark(oklch(1 0 0), oklch(0 0 0));",
-  "--color-ink: light-dark(oklch(0 0 0), oklch(1 0 0));"
-]);
-var DEFAULT_PALETTE_CONTRAST_LC = 60;
-function checkPaletteContrast(colors, usedColorStops, options = {}) {
-  const minLc = options.minLc ?? DEFAULT_PALETTE_CONTRAST_LC;
-  const warnings = [];
-  const paperY = oklchToApcaY(1, 0, 0);
-  const inkY = oklchToApcaY(0, 0, 0);
-  for (const [name, def] of Object.entries(colors)) {
-    if (def.type !== "generative") continue;
-    const stops = usedColorStops.get(name);
-    if (!stops || stops.size === 0) continue;
-    const sorted = [...stops].sort((a, b) => a - b);
-    for (const suffix of sorted) {
-      const stop = generateStop(def, suffix);
-      const fgY = oklchToApcaY(stop.l, stop.c, stop.h);
-      const lcPaper = Math.abs(apcaContrast(fgY, paperY));
-      const lcInk = Math.abs(apcaContrast(fgY, inkY));
-      const best = Math.max(lcPaper, lcInk);
-      if (best < minLc) {
-        warnings.push(
-          `[RI-1106] @color "${name}-${suffix}" has low APCA contrast (best |Lc| ${best.toFixed(0)} < ${minLc}; paper ${lcPaper.toFixed(0)}, ink ${lcInk.toFixed(0)}). Stop is unsuitable as text on either --color-paper or --color-ink \u2014 use a darker (lower suffix) or lighter (higher suffix) variant for text roles.`
-        );
-      }
-    }
-  }
-  return warnings;
-}
-function generateAllColorVariables(colors = DEFAULT_COLORS, darkConfig = DEFAULT_DARK_CONFIG, usedColorStops) {
-  const allVars = [];
-  allVars.push(...SEMANTIC_COLORS);
-  for (const [name, def] of Object.entries(colors)) {
-    switch (def.type) {
-      case "generative": {
-        const suffixes = usedColorStops?.get(name);
-        if (!suffixes || suffixes.size === 0) break;
-        const sorted = [...suffixes].sort((a, b) => a - b);
-        allVars.push(...generateColorVariables(name, def, sorted, darkConfig, def.dark));
-        break;
-      }
-      case "explicit": {
-        allVars.push(`--color-${name}: ${def.value};`);
-        break;
-      }
-      case "pair": {
-        if (darkConfig.mode === "off") {
-          allVars.push(`--color-${name}: ${def.light};`);
-        } else {
-          allVars.push(`--color-${name}: light-dark(${def.light}, ${def.dark});`);
-        }
-        break;
-      }
-      case "alias": {
-        const source = colors[def.source];
-        if (source && source.type === "generative") {
-          const suffixes = usedColorStops?.get(name);
-          if (!suffixes || suffixes.size === 0) break;
-          const sorted = [...suffixes].sort((a, b) => a - b);
-          for (const suffix of sorted) {
-            allVars.push(`--color-${name}-${suffix}: var(--color-${def.source}-${suffix});`);
-          }
-        } else if (source) {
-          allVars.push(`--color-${name}: var(--color-${def.source});`);
-        }
-        break;
-      }
-    }
-  }
-  return allVars;
-}
-function generateThemeOverrides(colors, usedThemeSuffixes) {
-  if (!Object.hasOwn(colors, "theme")) return [];
-  if (!usedThemeSuffixes || usedThemeSuffixes.size === 0) return [];
-  const sorted = [...usedThemeSuffixes].sort((a, b) => a - b);
-  const blocks = [];
-  for (const [name, def] of Object.entries(colors)) {
-    if (name === "theme") continue;
-    if (def.type !== "generative") continue;
-    if (!def.inline) continue;
-    const vars = [];
-    for (const suffix of sorted) {
-      vars.push(`  --color-theme-${suffix}: var(--color-${name}-${suffix});`);
-    }
-    const safeName = name.replace(/[\\"'\]]/g, "");
-    if (!safeName) continue;
-    blocks.push(`[data-theme="${safeName}"] {
-${vars.join("\n")}
-}`);
-  }
-  return blocks;
-}
-
-// src/theme/index.ts
-var CORNER_SHAPE_KEYWORDS = [
-  "round",
-  "scoop",
-  "bevel",
-  "notch",
-  "square",
-  "squircle"
-];
-var DEFAULT_CORNER_SCALE = {
-  round: 1,
-  square: 1,
-  notch: 1,
-  bevel: 0.8,
-  scoop: 1.2,
-  squircle: 1.6
-};
-var DEFAULT_SUPERELLIPSE_SCALE = 1.6;
-var defaultTheme = Object.freeze({
-  spacing: {
-    base: "0.25rem"
-  },
-  colors: DEFAULT_COLORS,
-  // Every named scale below ships empty: the tokens come from @text,
-  // @breakpoint, @shadow, @weight, @ease, @animate and @blur. @fluid carries
-  // no viewport range until one is declared, so fluid utilities stay inert.
-  text: {},
-  breakpoints: {},
-  shadows: {},
-  weights: {},
-  easing: {},
-  fluid: {},
-  animations: {},
-  blur: {}
-});
-
 export {
   IS_DEV,
   devWarn,
@@ -2428,14 +2083,16 @@ export {
   SCROLL_MARGIN_MAP,
   SCROLL_PADDING_MAP,
   BORDER_DIR_PROPS,
+  FILTER_COMPOSED,
+  BACKDROP_FILTER_COMPOSED,
+  BUILTIN_STATIC_KEYS,
+  PREFIX_PROP_KEYS,
+  buildFirstSegmentMap,
   COLOR_FUNCTION_ALTERNATION,
   SPECIAL_COLORS,
   isMaskRadialSizeValue,
   RE_IMAGE_VALUE,
   isFontFamilyValue,
-  BUILTIN_STATIC_KEYS,
-  PREFIX_PROP_KEYS,
-  buildFirstSegmentMap,
   resolverFor,
   createCompilationContext,
   registerCustomUtility,
@@ -2443,24 +2100,11 @@ export {
   registerCustomFontFamilies,
   registerColorNames,
   snapshotCompilationContext,
+  publishSnapshot,
   finalizeCompilationContext,
+  serializeSnapshot,
+  hydrateSnapshot,
   mergeUncached,
   ri,
-  createRi,
-  isValidColorSuffix,
-  DEFAULT_COLORS,
-  DEFAULT_DARK_CONFIG,
-  oklchToOklab,
-  oklabToLinearSrgb,
-  linearToSrgb,
-  generateStop,
-  computeDarkStop,
-  formatOklch,
-  checkPaletteContrast,
-  generateAllColorVariables,
-  generateThemeOverrides,
-  CORNER_SHAPE_KEYWORDS,
-  DEFAULT_CORNER_SCALE,
-  DEFAULT_SUPERELLIPSE_SCALE,
-  defaultTheme
+  createRi
 };