rainbowindex 0.5.1 → 0.7.0

package/dist/{chunk-4UKFK2GE.mjs → chunk-XQGSG2HK.mjs}

@@ -1,611 +1,3 @@
-// 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 DEFAULT_TEXT = {
-  "2xs": { fontSize: "0.625rem", lineHeight: "1.2" },
-  xs: { fontSize: "0.75rem", lineHeight: "1.3" },
-  sm: { fontSize: "0.875rem", lineHeight: "1.4" },
-  md: { fontSize: "1rem", lineHeight: "1.5" },
-  lg: { fontSize: "1.25rem", lineHeight: "1.4" },
-  xl: { fontSize: "1.5rem", lineHeight: "1.3" },
-  "2xl": { fontSize: "1.875rem", lineHeight: "1.2" },
-  "3xl": { fontSize: "2.25rem", lineHeight: "1.15" },
-  "4xl": { fontSize: "2.813rem", lineHeight: "1.1" },
-  "5xl": { fontSize: "3.5rem", lineHeight: "1.05" },
-  "6xl": { fontSize: "4.375rem", lineHeight: "1.05" },
-  "7xl": { fontSize: "5.5rem", lineHeight: "1" },
-  "8xl": { fontSize: "6.875rem", lineHeight: "1" },
-  "9xl": { fontSize: "8.5rem", lineHeight: "1" }
-};
-var DEFAULT_BREAKPOINTS = {
-  sm: "40rem",
-  md: "48rem",
-  lg: "64rem",
-  xl: "80rem"
-};
-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 DEFAULT_SHADOWS = {
-  // Building blocks: colors
-  line: "light-dark(oklch(0 0 0 / 0.06), oklch(1 0 0 / 0.02))",
-  drop: "light-dark(oklch(0 0 0 / 0.06), oklch(0 0 0 / 0.18))",
-  "hi-1": "light-dark(transparent, oklch(1 0 0 / 0.01))",
-  "hi-2": "light-dark(transparent, oklch(1 0 0 / 0.02))",
-  "hi-3": "light-dark(transparent, oklch(1 0 0 / 0.04))",
-  "hi-4": "light-dark(transparent, oklch(1 0 0 / 0.06))",
-  "dark-line": "light-dark(transparent, oklch(0 0 0 / 0.14))",
-  // Building blocks: composed shadow layers
-  ring: "0 0 0 1px var(--shadow-line)",
-  "layer-1": "0 1px 1px -0.5px var(--shadow-drop)",
-  "layer-2": "0 3px 3px -1.5px var(--shadow-drop)",
-  "layer-3": "0 6px 6px -3px var(--shadow-drop)",
-  "layer-4": "0 12px 12px -6px var(--shadow-drop)",
-  "layer-5": "0 24px 24px -12px var(--shadow-drop)",
-  "layer-6": "0 48px 48px -24px var(--shadow-drop)",
-  "layer-7": "0 96px 96px -48px var(--shadow-drop)",
-  // Class-facing
-  px: "var(--shadow-ring)",
-  "2xs": "inset 0 1px 0 0 var(--shadow-hi-1), var(--shadow-ring), var(--shadow-layer-1)",
-  xs: "inset 0 1px 0 0 var(--shadow-hi-2), var(--shadow-ring), 0 0 0 1px var(--shadow-dark-line), var(--shadow-layer-1), var(--shadow-layer-2)",
-  sm: "inset 0 1px 0 0 var(--shadow-hi-2), var(--shadow-ring), 0 0 0 1px var(--shadow-dark-line), var(--shadow-layer-1), var(--shadow-layer-2), var(--shadow-layer-3)",
-  md: "inset 0 1px 0 0 var(--shadow-hi-3), var(--shadow-ring), 0 0 0 1px var(--shadow-dark-line), var(--shadow-layer-1), var(--shadow-layer-2), var(--shadow-layer-3), var(--shadow-layer-4)",
-  lg: "inset 0 1px 0 0 var(--shadow-hi-3), var(--shadow-ring), 0 0 0 1px var(--shadow-dark-line), var(--shadow-layer-1), var(--shadow-layer-2), var(--shadow-layer-3), var(--shadow-layer-4), var(--shadow-layer-5)",
-  xl: "inset 0 1px 0 0 var(--shadow-hi-4), var(--shadow-ring), 0 0 0 1px var(--shadow-dark-line), var(--shadow-layer-1), var(--shadow-layer-2), var(--shadow-layer-3), var(--shadow-layer-4), var(--shadow-layer-5), var(--shadow-layer-6)",
-  "2xl": "inset 0 1px 0 0 var(--shadow-hi-4), var(--shadow-ring), 0 0 0 1px var(--shadow-dark-line), var(--shadow-layer-1), var(--shadow-layer-2), var(--shadow-layer-3), var(--shadow-layer-4), var(--shadow-layer-5), var(--shadow-layer-6), var(--shadow-layer-7)",
-  none: "0 0 #0000"
-};
-var DEFAULT_WEIGHTS = {
-  thin: 100,
-  extralight: 200,
-  light: 300,
-  normal: 400,
-  medium: 500,
-  semibold: 600,
-  bold: 700,
-  extrabold: 800,
-  black: 900
-};
-var DEFAULT_EASING = {
-  in: "cubic-bezier(0.4, 0, 1, 1)",
-  out: "cubic-bezier(0, 0, 0.2, 1)",
-  "in-out": "cubic-bezier(0.4, 0, 0.2, 1)",
-  linear: "linear"
-};
-var DEFAULT_BLUR = {
-  xs: "2px",
-  sm: "4px",
-  DEFAULT: "8px",
-  md: "12px",
-  lg: "16px",
-  xl: "24px",
-  "2xl": "40px",
-  "3xl": "64px",
-  none: "0"
-};
-var DEFAULT_ANIMATIONS = {
-  spin: {
-    shorthand: "spin 1s linear infinite",
-    keyframes: `from { transform: rotate(0deg); }
-  to { transform: rotate(360deg); }`
-  },
-  pulse: {
-    shorthand: "pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite",
-    keyframes: `0%, 100% { opacity: 1; }
-  50% { opacity: 0.5; }`
-  },
-  bounce: {
-    shorthand: "bounce 1s infinite",
-    keyframes: `0%, 100% { transform: translateY(-25%); animation-timing-function: cubic-bezier(0.8, 0, 1, 1); }
-  50% { transform: translateY(0); animation-timing-function: cubic-bezier(0, 0, 0.2, 1); }`
-  },
-  ping: {
-    shorthand: "ping 1s cubic-bezier(0, 0, 0.2, 1) infinite",
-    keyframes: "75%, 100% { transform: scale(2); opacity: 0; }"
-  },
-  // Disclosure animations for the @rainbowindex/ui Accordion + Collapsible
-  // primitives. Both expand from 0 → the natural content size published by
-  // the package's `useCollapseSize` hook as `--ri-collapsible-content-height`
-  // (a single shared variable — the primitives do not emit separate accordion
-  // vs collapsible vars). The `auto` fallback keeps the keyframe valid on the
-  // first frame before the hook measures.
-  "accordion-down": {
-    shorthand: "accordion-down 0.2s ease-out",
-    keyframes: `from { height: 0; }
-  to { height: var(--ri-collapsible-content-height, auto); }`
-  },
-  "accordion-up": {
-    shorthand: "accordion-up 0.2s ease-out",
-    keyframes: `from { height: var(--ri-collapsible-content-height, auto); }
-  to { height: 0; }`
-  },
-  "collapsible-down": {
-    shorthand: "collapsible-down 0.2s ease-out",
-    keyframes: `from { height: 0; }
-  to { height: var(--ri-collapsible-content-height, auto); }`
-  },
-  "collapsible-up": {
-    shorthand: "collapsible-up 0.2s ease-out",
-    keyframes: `from { height: var(--ri-collapsible-content-height, auto); }
-  to { height: 0; }`
-  },
-  "caret-blink": {
-    shorthand: "caret-blink 1.25s ease-out infinite",
-    keyframes: `0%, 70%, 100% { opacity: 1; }
-  20%, 50% { opacity: 0; }`
-  }
-};
-var DEFAULT_FLUID = {
-  min: "20rem",
-  max: "80rem"
-};
-var DEFAULT_TRACKING = {
-  tighter: "-0.05em",
-  tight: "-0.025em",
-  normal: "0em",
-  wide: "0.025em",
-  wider: "0.05em",
-  widest: "0.1em"
-};
-var DEFAULT_LEADING = {
-  "3": "0.75rem",
-  "4": "1rem",
-  "5": "1.25rem",
-  "6": "1.5rem",
-  "7": "1.75rem",
-  "8": "2rem",
-  "9": "2.25rem",
-  "10": "2.5rem",
-  none: "1",
-  tight: "1.25",
-  snug: "1.375",
-  normal: "1.5",
-  relaxed: "1.625",
-  loose: "2"
-};
-var defaultTheme = Object.freeze({
-  spacing: {
-    base: "0.25rem"
-  },
-  colors: DEFAULT_COLORS,
-  text: DEFAULT_TEXT,
-  breakpoints: DEFAULT_BREAKPOINTS,
-  shadows: DEFAULT_SHADOWS,
-  weights: DEFAULT_WEIGHTS,
-  easing: DEFAULT_EASING,
-  fluid: DEFAULT_FLUID,
-  animations: DEFAULT_ANIMATIONS,
-  blur: DEFAULT_BLUR
-});
-
 // src/runtime.ts
 var IS_PROD = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
 var IS_DEV = !IS_PROD;
@@ -613,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"],
@@ -698,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"],
@@ -749,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
@@ -763,10 +186,11 @@ var BUILTIN_STATIC_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   // outline shorthand + offset (claiming all sub-properties); outline-none just sets style.
   outline: ["outline-width"],
   "outline-hidden": ["outline-style", "outline-width", "outline-color", "outline-offset"],
-  // Shadow / ring (static bare + reset forms; valued forms via PREFIX_PROPS).
+  // Shadow / ring (static reset + bare ring forms; valued forms via PREFIX_PROPS).
   // Each composable family claims box-shadow (shared) + its own slot var, so
   // shadow/inset-shadow/ring/inset-ring coexist while same-family repeats dedupe.
-  shadow: ["box-shadow", "--ri-shadow"],
+  // Bare `shadow` is not static: with no default shadow scale it only resolves
+  // when the theme defines a `DEFAULT` (or `md`) token via @shadow.
   "shadow-none": ["box-shadow", "--ri-shadow"],
   ring: ["box-shadow", "--ri-ring-shadow"],
   "inset-ring": ["box-shadow", "--ri-inset-ring-shadow"],
@@ -794,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"],
@@ -1311,23 +743,7 @@ addAll(
   ],
   ["~divide:border-style"]
 );
-addAll(
-  [
-    "animate-spin",
-    "animate-pulse",
-    "animate-bounce",
-    "animate-ping",
-    "animate-in",
-    "animate-out",
-    "animate-none",
-    "animate-accordion-down",
-    "animate-accordion-up",
-    "animate-collapsible-down",
-    "animate-collapsible-up",
-    "animate-caret-blink"
-  ],
-  ["animation"]
-);
+addAll(["animate-in", "animate-out", "animate-none"], ["animation"]);
 addAll(["animate-infinite", "animate-once", "animate-twice"], ["animation-iteration-count"]);
 addAll(
   ["animate-fill-none", "animate-fill-forwards", "animate-fill-both", "animate-fill-backwards"],
@@ -1513,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 = {};
@@ -1530,6 +949,9 @@ var PREFIX_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   ...MARGIN_MAP,
   ...GAP_MAP,
   ...FLUID_SPACING_PROPS,
+  // fluid-<name> scope classes all claim the same scope-var pair, so a later
+  // range wins over an earlier one.
+  fluid: ["--fluid-scope-min", "--fluid-scope-max"],
   "space-x": ["~space:margin-inline-start", "~space:margin-inline-end"],
   "space-y": ["~space:margin-block-start", "~space:margin-block-end"],
   ...INSET_MAP,
@@ -1606,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"],
@@ -1624,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"],
@@ -1677,10 +1109,13 @@ var PREFIX_PROPS = Object.assign(/* @__PURE__ */ Object.create(null), {
   "from-position": ["--ri-gradient-from-position"],
   "via-position": ["--ri-gradient-via-position"],
   "to-position": ["--ri-gradient-to-position"],
-  // Animations
+  // Animations. `animate` is last of the four by length, so the three
+  // specific prefixes match first and `animate-{name}` catches every
+  // @animate token and arbitrary shorthand.
   "animate-duration": ["animation-duration"],
   "animate-delay": ["animation-delay"],
   "animate-ease": ["animation-timing-function"],
+  animate: ["animation"],
   "break-before": ["break-before"],
   "break-after": ["break-after"],
   "break-inside": ["break-inside"],
@@ -1705,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"],
@@ -1754,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"],
@@ -1773,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"],
@@ -1855,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);
@@ -1896,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*\\(`);
@@ -1974,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) {
@@ -2031,17 +1459,6 @@ function scanBracketAware(input, onChar, options) {
 }
 
 // src/merge/resolve.ts
-var DEFAULT_TEXT_SIZES = [
-  "xs",
-  "sm",
-  "base",
-  "lg",
-  "xl",
-  "2xl",
-  "3xl",
-  "4xl",
-  "5xl"
-];
 var DEFAULT_FONT_FAMILIES = ["sans", "serif", "mono"];
 function stripTextModifier(value) {
   if (value.indexOf("/") === -1) return value;
@@ -2099,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.
@@ -2147,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,
@@ -2217,7 +1643,7 @@ function resolvePropsWith(utility, customStaticProps, customFunctionalProps, tex
 // src/merge/context.ts
 var _customStaticProps = {};
 var _customFunctionalProps = [];
-var _textSizes = new Set(DEFAULT_TEXT_SIZES);
+var _textSizes = /* @__PURE__ */ new Set();
 var _fontFamilies = new Set(DEFAULT_FONT_FAMILIES);
 var _colorNames = /* @__PURE__ */ new Set();
 var _latestSnapshot = null;
@@ -2289,7 +1715,7 @@ function createCompilationContext() {
   return {
     customStaticProps: {},
     customFunctionalProps: {},
-    textSizes: new Set(DEFAULT_TEXT_SIZES),
+    textSizes: /* @__PURE__ */ new Set(),
     fontFamilies: new Set(DEFAULT_FONT_FAMILIES),
     colorNames: /* @__PURE__ */ new Set()
   };
@@ -2329,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;
@@ -2338,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;
@@ -2436,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++) {
@@ -2454,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;
@@ -2462,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;
@@ -2481,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.`
 );
@@ -2504,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);
@@ -2595,32 +2074,8 @@ function splitBracketAware(input) {
 }
 
 export {
-  isValidColorSuffix,
-  DEFAULT_COLORS,
-  DEFAULT_DARK_CONFIG,
-  oklchToOklab,
-  oklabToLinearSrgb,
-  linearToSrgb,
-  generateStop,
-  computeDarkStop,
-  formatOklch,
-  checkPaletteContrast,
-  generateAllColorVariables,
-  generateThemeOverrides,
-  DEFAULT_TEXT,
-  DEFAULT_BREAKPOINTS,
-  CORNER_SHAPE_KEYWORDS,
-  DEFAULT_CORNER_SCALE,
-  DEFAULT_SUPERELLIPSE_SCALE,
-  DEFAULT_SHADOWS,
-  DEFAULT_WEIGHTS,
-  DEFAULT_EASING,
-  DEFAULT_BLUR,
-  DEFAULT_ANIMATIONS,
-  DEFAULT_FLUID,
-  DEFAULT_TRACKING,
-  DEFAULT_LEADING,
-  defaultTheme,
+  IS_DEV,
+  devWarn,
   PADDING_MAP,
   MARGIN_MAP,
   GAP_MAP,
@@ -2628,17 +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,
-  IS_DEV,
-  devWarn,
-  DEFAULT_TEXT_SIZES,
   resolverFor,
   createCompilationContext,
   registerCustomUtility,
@@ -2646,7 +2100,10 @@ export {
   registerCustomFontFamilies,
   registerColorNames,
   snapshotCompilationContext,
+  publishSnapshot,
   finalizeCompilationContext,
+  serializeSnapshot,
+  hydrateSnapshot,
   mergeUncached,
   ri,
   createRi