rainbowindex 0.5.0 → 0.6.0

package/dist/{chunk-NXJZX6KI.mjs → chunk-ZR7XJMUN.mjs}

@@ -15,10 +15,10 @@ import {
   codepointCompare,
   parseUtility,
   resolveUtilityDeclarations
-} from "./chunk-ZI5ZYNSU.mjs";
+} from "./chunk-KSNYSR3C.mjs";
 import {
   SPECIAL_COLORS
-} from "./chunk-KRZL4IDK.mjs";
+} from "./chunk-6U4IOFOS.mjs";
 
 // src/project/css-entry.ts
 var CSS_ENTRY_CANDIDATES = Object.freeze([
@@ -70,6 +70,8 @@ var FRACTION_SAMPLES = Object.freeze([
   "5/6"
 ]);
 var INT_SAMPLES = Object.freeze(["0", "1", "2", "3", "4", "6", "8", "10", "12"]);
+var INT_RE = /^\d+$/;
+var WEIGHT_STEPS = Object.freeze(["100", "200", "300", "400", "500", "600", "700", "800", "900"]);
 var PERCENT_SAMPLES = Object.freeze([
   "0",
   "5",
@@ -94,6 +96,7 @@ var ROUNDED_SIDES = Object.freeze([
   ...ROUNDED_SIDE_NAMES,
   ...ROUNDED_CORNER_NAMES
 ]);
+var RADIUS_SAMPLES = Object.freeze([...SPACING_SAMPLES, "none", "full"]);
 function buildValueSpaces() {
   const table = /* @__PURE__ */ new Map();
   for (const { roots, spec } of ROOT_GROUPS) {
@@ -136,18 +139,22 @@ function candidateValues(kind, theme) {
       return Object.keys(theme.text);
     case "fluid-text-size":
       return Object.keys(theme.text).map((size) => `fluid-${size}`);
+    case "fluid-range":
+      return Object.keys(theme.fluidRanges);
     case "font-slot":
       return [.../* @__PURE__ */ new Set([...BUILTIN_FONT_SLOTS, ...theme.fonts.map((slot) => slot.slot)])];
     case "weight":
-      return Object.keys(theme.weights);
+      return [...Object.keys(theme.weights), ...WEIGHT_STEPS];
+    // Named @rounded radii plus the spacing multiples, the way @weight pairs
+    // its tokens with the numeric steps. Without the names, `rounded-roof`
+    // compiles but is offered by neither completions nor generated types.
     case "rounded":
-      return Object.keys(theme.rounded);
+      return [...Object.keys(theme.radii), ...RADIUS_SAMPLES];
     case "rounded-side": {
-      const tokens = Object.keys(theme.rounded);
       const out = [];
+      const sizes = [...Object.keys(theme.radii), ...RADIUS_SAMPLES];
       for (const side of ROUNDED_SIDES) {
-        out.push(side);
-        for (const token of tokens) out.push(`${side}-${token}`);
+        for (const size of sizes) out.push(`${side}-${size}`);
       }
       return out;
     }
@@ -223,7 +230,7 @@ function enumerateClassNames(theme) {
         seen.add(name);
         classes.push({ name, kind, root });
         if (kind === "spacing") spacingHit = true;
-        if (kind === "int") intHit = true;
+        if (kind === "int" || kind === "weight" && INT_RE.test(value)) intHit = true;
       }
     }
     for (const keyword of spec.keywords ?? []) {

package/dist/cli.mjs

@@ -2,13 +2,18 @@
 import {
   CSS_ENTRY_CANDIDATES,
   enumerateClassNames
-} from "./chunk-NXJZX6KI.mjs";
+} from "./chunk-ZR7XJMUN.mjs";
 import {
   DEFAULT_EXCLUDES,
   DEFAULT_PATTERNS,
   compileScannedProject,
-  getFontPreloadLinks
-} from "./chunk-DT5HYIM3.mjs";
+  disableScanChangeTracking,
+  enableScanChangeTracking,
+  enableSourceFileListCache,
+  getFontPreloadLinks,
+  invalidateSourceFileListCache,
+  markSourceFileChanged
+} from "./chunk-WK6S4HTC.mjs";
 import {
   MAX_DIRECTIVE_INPUT_SIZE,
   codepointCompare,
@@ -18,10 +23,10 @@ import {
   hasRIActivation,
   listVariants,
   resolveDirectives
-} from "./chunk-ZI5ZYNSU.mjs";
+} from "./chunk-KSNYSR3C.mjs";
 import {
   devWarn
-} from "./chunk-KRZL4IDK.mjs";
+} from "./chunk-6U4IOFOS.mjs";
 
 // src/entries/cli.ts
 import { realpathSync } from "fs";
@@ -177,8 +182,9 @@ Examples:
     flags: [CSS_INPUT_FONTS],
     positionals: "none",
     body: `Output:
-  Prints <link rel="preload"> tags to stdout for fonts declared in the @font
-  block (faces marked preload), or via @font-face.
+  Prints <link rel="preload"> tags to stdout, one per @font face marked
+  preload. Only local-file and raw-URL faces qualify \u2014 Google serves CSS, not
+  the font binary, so a Google or system slot never produces a tag.
 
 Examples:
   rainbowindex preload-fonts --css src/styles.css > preload.html`
@@ -433,6 +439,7 @@ async function buildCSS(opts, cwd) {
   const { css: cssSource, cssFile } = await loadProjectCSS(opts, cwd);
   const { compiled } = await compileScannedProject({
     css: cssSource,
+    cssPath: cssFile ?? void 0,
     cwd,
     surfacePatterns: opts.globs,
     onInvalidPattern: (err) => {
@@ -764,9 +771,23 @@ async function watchMode(opts, cwd) {
       currentBuild = runBuild();
     }, delay);
   };
-  watcher.on("change", scheduleRebuild);
-  watcher.on("add", scheduleRebuild);
-  watcher.on("unlink", scheduleRebuild);
+  enableSourceFileListCache();
+  enableScanChangeTracking();
+  watcher.on("change", (file) => {
+    markSourceFileChanged(file, cwd);
+    scheduleRebuild();
+  });
+  watcher.on("add", (file) => {
+    invalidateSourceFileListCache();
+    markSourceFileChanged(file, cwd);
+    scheduleRebuild();
+  });
+  watcher.on("unlink", (file) => {
+    invalidateSourceFileListCache();
+    markSourceFileChanged(file, cwd);
+    scheduleRebuild();
+  });
+  watcher.on("unlinkDir", invalidateSourceFileListCache);
   watcher.on("error", (err) => {
     console.error("[rainbowindex] Watcher error:", err);
   });
@@ -776,6 +797,8 @@ async function watchMode(opts, cwd) {
     cleanupCalled = true;
     if (debounceTimer) clearTimeout(debounceTimer);
     dirty = false;
+    invalidateSourceFileListCache();
+    disableScanChangeTracking();
     const doExit = () => {
       watcher.close().then(() => {
         console.log("\n[rainbowindex] Watcher stopped.");
@@ -1288,7 +1311,7 @@ function readPackageJSONSync(cwd) {
 
 // src/entries/cli.ts
 function getVersion() {
-  return true ? "0.5.0" : "unknown";
+  return true ? "0.6.0" : "unknown";
 }
 async function main() {
   const args = process.argv.slice(2);

package/dist/editor.d.ts

@@ -1,9 +1,13 @@
-import { P as ParsedDirective, R as ResolvedTheme } from './index-Dp6i5TSv.js';
-export { b as createThemeSnapshot } from './index-Dp6i5TSv.js';
-import { b as CompilationSnapshot, C as ColorDefinition } from './context-ruu2x_jR.js';
-export { e as defaultTheme } from './context-ruu2x_jR.js';
+import { P as ParsedDirective, R as ResolvedTheme } from './index-4Kyaq3IZ.js';
+export { b as createThemeSnapshot, d as describeLoadedWeights, w as weightIsLoaded } from './index-4Kyaq3IZ.js';
+import { b as CompilationSnapshot, C as ColorDefinition } from './index-DSgpB6bS.js';
+export { e as defaultTheme } from './index-DSgpB6bS.js';
 
-type CandidateOrigin = "attribute" | "helper" | "safelist" | "plain";
+/** Where a candidate was found. "expression" marks a string literal sitting
+ *  in a JS expression position that cannot be a class list — today, an
+ *  operand of `==`/`!=` (`mode === "default"`). It is NOT a certain origin:
+ *  editors should treat it like "plain" and never report it as a bad class. */
+type CandidateOrigin = "attribute" | "helper" | "safelist" | "plain" | "expression";
 interface ClassCandidate {
     /** The class string in expanded form — for variant-group members this
      *  includes the group prefix (`hover:bg-red-500`) even though the span
@@ -40,7 +44,7 @@ declare const CLASS_HELPER_NAMES: readonly string[];
 declare const VARIANT_HELPER_NAMES: readonly string[];
 declare function extractClasses(source: string, warnings?: string[]): Set<string>;
 
-declare function expandVariantGroups(input: string, warnings?: string[]): string;
+declare function expandVariantGroups(input: string, warnings?: string[], path?: string): string;
 
 interface SourceExtractionInput {
     path?: string;
@@ -140,9 +144,23 @@ interface ProjectAnalysis {
      * at-rule, resolver problems at the directive whose body produced them.
      */
     diagnostics: Diagnostic[];
+    /**
+     * Codes silenced for the whole entry by `/* ri-disable … *\/`. Later stages
+     * push through this so a code the author hid never reaches the caller —
+     * scanner and compile warnings included, which no stylesheet comment could
+     * reach by position.
+     */
+    suppressed: ReadonlySet<string>;
 }
 declare function analyzeProjectCSS(css: string): ProjectAnalysis;
 
+/**
+ * Fatal bootstrap (RI-00xx) and runtime (RI-20xx) codes are never silenceable.
+ * They report a broken build or a broken call, not a style choice, and a
+ * stylesheet that could hide them would hide the reason the build failed.
+ */
+declare function isSuppressible(code: string): boolean;
+
 /**
  * Parses utility class strings into structured tokens.
  *
@@ -305,7 +323,7 @@ declare function findClosest(input: string, candidates: string[], maxDistance?:
  * per-root resolver order fixes which generator wins a contested root.
  */
 
-type ValueSpaceKind = "color" | "special-color" | "spacing" | "fraction" | "text-size" | "fluid-text-size" | "font-slot" | "weight" | "rounded" | "rounded-side" | "shadow" | "z" | "ease" | "blur" | "animation" | "leading" | "tracking" | "opacity" | "duration" | "breakpoint" | "int" | "percent" | "keywords";
+type ValueSpaceKind = "color" | "special-color" | "spacing" | "fraction" | "text-size" | "fluid-text-size" | "font-slot" | "weight" | "rounded" | "rounded-side" | "shadow" | "z" | "ease" | "blur" | "animation" | "leading" | "fluid-range" | "tracking" | "opacity" | "duration" | "breakpoint" | "int" | "percent" | "keywords";
 interface ValueSpaceSpec {
     kinds: readonly ValueSpaceKind[];
     /** Extra value parts to try verbatim (for "keywords" and beyond). */
@@ -455,7 +473,6 @@ interface ThemeTokens {
         lineHeight: string;
     }>;
     breakpoints: Record<string, string>;
-    rounded: Record<string, string>;
     shadows: Record<string, string>;
     weights: Record<string, number>;
     easing: Record<string, string>;
@@ -465,6 +482,15 @@ interface ThemeTokens {
     tracking: Record<string, string>;
     opacity: Record<string, string>;
     duration: Record<string, string>;
+    /** Named radii from `@rounded { roof: 24px; }` — the class is `rounded-roof`.
+     *  Unnamed radii are spacing multiples and carry no token. */
+    radii: Record<string, string>;
+    /** Named ranges from `@fluid <name> { min; max; }` — each one makes the scope
+     *  class `fluid-<name>`. A bound absent from the block is absent here. */
+    fluidRanges: Record<string, {
+        min?: string;
+        max?: string;
+    }>;
     fonts: Array<{
         slot: string;
         family: string;
@@ -539,4 +565,4 @@ declare const EDITOR_API_VERSION = 1;
 /** Feature-detection roster for this entry. */
 declare const editorCapabilities: readonly string[];
 
-export { CANONICAL_COLOR_STOPS, CLASS_HELPER_NAMES, CSS_ENTRY_CANDIDATES, type CandidateOrigin, type ClassCandidate, type ClassEnumeration, type ClassExplanation, type ClassInspector, type ClassTemplate, type ClassValidation, ColorDefinition, type ColorSwatch, CompilationSnapshot, type Diagnostic, type DiagnosticSeverity, EDITOR_API_VERSION, type EditorSession, type EnumeratedClass, type MergeAnalysis, type MergeDrop, ParsedDirective, type ParsedUtility, type ProjectAnalysis, RI_IMPORT_SPECIFIERS, ResolvedTheme, type SourceExtractionInput, type SwatchColor, type ThemeTokens, UTILITY_VALUE_SPACES, VARIANT_HELPER_NAMES, type ValueSpaceKind, type ValueSpaceSpec, type VariantInfo, type VariantKind, analyzeMerge, analyzeProjectCSS, createClassInspector, createEditorSession, cssColorToHex, diagnosticFromWarning, editorCapabilities, enumerateClassNames, expandVariantGroups, extractClassCandidates, extractClasses, extractClassesFromSource, findClosest, hasRIActivation, isSourceFile, listThemeTokens, listVariants, oklchToHex, parseUtility, resolveColorSwatch, severityForCode, version, warningCode };
+export { CANONICAL_COLOR_STOPS, CLASS_HELPER_NAMES, CSS_ENTRY_CANDIDATES, type CandidateOrigin, type ClassCandidate, type ClassEnumeration, type ClassExplanation, type ClassInspector, type ClassTemplate, type ClassValidation, ColorDefinition, type ColorSwatch, CompilationSnapshot, type Diagnostic, type DiagnosticSeverity, EDITOR_API_VERSION, type EditorSession, type EnumeratedClass, type MergeAnalysis, type MergeDrop, ParsedDirective, type ParsedUtility, type ProjectAnalysis, RI_IMPORT_SPECIFIERS, ResolvedTheme, type SourceExtractionInput, type SwatchColor, type ThemeTokens, UTILITY_VALUE_SPACES, VARIANT_HELPER_NAMES, type ValueSpaceKind, type ValueSpaceSpec, type VariantInfo, type VariantKind, analyzeMerge, analyzeProjectCSS, createClassInspector, createEditorSession, cssColorToHex, diagnosticFromWarning, editorCapabilities, enumerateClassNames, expandVariantGroups, extractClassCandidates, extractClasses, extractClassesFromSource, findClosest, hasRIActivation, isSourceFile, isSuppressible, listThemeTokens, listVariants, oklchToHex, parseUtility, resolveColorSwatch, severityForCode, version, warningCode };

package/dist/editor.mjs

@@ -2,7 +2,7 @@ import {
   CSS_ENTRY_CANDIDATES,
   UTILITY_VALUE_SPACES,
   enumerateClassNames
-} from "./chunk-NXJZX6KI.mjs";
+} from "./chunk-ZR7XJMUN.mjs";
 import {
   isSourceFile
 } from "./chunk-3HRMFZGE.mjs";
@@ -16,6 +16,7 @@ import {
   compileUtility,
   createEmptyCompilationResult,
   createThemeSnapshot,
+  describeLoadedWeights,
   diagnosticFromWarning,
   expandVariantGroups,
   extractClassCandidates,
@@ -23,11 +24,13 @@ import {
   extractClassesFromSource,
   findClosest,
   hasRIActivation,
+  isSuppressible,
   listVariants,
   parseUtility,
   severityForCode,
-  warningCode
-} from "./chunk-ZI5ZYNSU.mjs";
+  warningCode,
+  weightIsLoaded
+} from "./chunk-KSNYSR3C.mjs";
 import {
   computeDarkStop,
   defaultTheme,
@@ -38,7 +41,7 @@ import {
   oklabToLinearSrgb,
   oklchToOklab,
   resolverFor
-} from "./chunk-KRZL4IDK.mjs";
+} from "./chunk-6U4IOFOS.mjs";
 
 // src/engine/inspector.ts
 var RESOLUTION_CACHE_CAP = 1e4;
@@ -307,7 +310,6 @@ function listThemeTokens(theme) {
       lineHeight: def.lineHeight
     })),
     breakpoints: { ...theme.breakpoints },
-    rounded: { ...theme.rounded },
     shadows: { ...theme.shadows },
     weights: { ...theme.weights },
     easing: { ...theme.easing },
@@ -317,6 +319,13 @@ function listThemeTokens(theme) {
     tracking: { ...theme.tracking },
     opacity: { ...theme.opacity },
     duration: { ...theme.duration },
+    radii: { ...theme.radii },
+    fluidRanges: Object.fromEntries(
+      Object.entries(theme.fluidRanges).map(([name, range]) => [
+        name,
+        { min: range.min, max: range.max }
+      ])
+    ),
     fonts: theme.fonts.map((slot) => ({ slot: slot.slot, family: slot.family })),
     animations: Object.keys(theme.animations)
   };
@@ -383,11 +392,16 @@ function createEditorSession(options = {}) {
 }
 
 // src/entries/editor.ts
-var version = true ? "0.5.0" : "0.0.0-dev";
+var version = true ? "0.6.0" : "0.0.0-dev";
 var EDITOR_API_VERSION = 1;
 var editorCapabilities = Object.freeze([
   "class-candidates",
   "candidate-call-ids",
+  // A candidate carries a certain origin only when a context-aware collector
+  // tokenized it, so bare JS identifiers stay "plain"; equality operands
+  // report the "expression" origin. Without this, position alone decided,
+  // and `ri(mode === "x" ? …)` reported `mode` as a helper-origin class.
+  "candidate-origin-provenance",
   "css-entry-detection",
   "theme-analysis",
   "class-inspection",
@@ -396,7 +410,16 @@ var editorCapabilities = Object.freeze([
   "merge-analysis",
   "structured-diagnostics",
   "color-swatches",
-  "editor-session"
+  "editor-session",
+  // `isSuppressible` — which diagnostic codes a `ri-disable` comment may name,
+  // so an editor can offer the comment only where it would work.
+  "diagnostic-suppression",
+  // `ThemeTokens.radii` and `ThemeTokens.fluidRanges`, for the named radii and
+  // named `@fluid` ranges that carry no token before this release.
+  "named-radii-and-fluid-ranges",
+  // `weightIsLoaded` / `describeLoadedWeights` — the RI-1504 coverage check,
+  // so an editor can answer "does any loaded font have this weight?".
+  "font-weight-coverage"
 ]);
 export {
   CANONICAL_COLOR_STOPS,
@@ -413,6 +436,7 @@ export {
   createThemeSnapshot,
   cssColorToHex,
   defaultTheme,
+  describeLoadedWeights,
   diagnosticFromWarning,
   editorCapabilities,
   enumerateClassNames,
@@ -423,6 +447,7 @@ export {
   findClosest,
   hasRIActivation,
   isSourceFile,
+  isSuppressible,
   listThemeTokens,
   listVariants,
   oklchToHex,
@@ -430,5 +455,6 @@ export {
   resolveColorSwatch,
   severityForCode,
   version,
-  warningCode
+  warningCode,
+  weightIsLoaded
 };

package/dist/{index-Dp6i5TSv.d.ts → index-4Kyaq3IZ.d.ts}

@@ -1,4 +1,4 @@
-import { C as ColorDefinition, D as DarkModeConfig, j as CornerShape, A as AnimationDefinition, F as FluidConfig, b as CompilationSnapshot } from './context-ruu2x_jR.js';
+import { C as ColorDefinition, D as DarkModeConfig, j as CornerShape, A as AnimationDefinition, F as FluidConfig, b as CompilationSnapshot } from './index-DSgpB6bS.js';
 
 /** Provider discriminant for a slot, derived from its faces. */
 type FontProviderKind = "google" | "system" | "local" | "manual";
@@ -57,6 +57,21 @@ interface FontMetricsConfig {
     descent?: number;
     lineGap?: number;
 }
+/**
+ * Whether any loaded font can render `weight` — the check behind RI-1504.
+ *
+ * A slot's faces are the authority: their `weight` descriptor is exactly what
+ * the emitted @font-face (or the Google URL) asks for, so a weight outside it
+ * is a weight the browser has to synthesize.
+ *
+ * Deliberately fails open, since `font-<n>` names no family and a page can
+ * load several: no faces to check, a system/manual slot (the OS font carries
+ * every weight), or a single covering slot all count as available.
+ */
+declare function weightIsLoaded(weight: number, fonts: readonly FontSlot[]): boolean;
+/** Human-readable weight inventory for the RI-1504 message:
+ *  `Inter 300–900; Fira Code 400, 700`. */
+declare function describeLoadedWeights(fonts: readonly FontSlot[]): string;
 
 /**
  * Font loading system — @font directive processing, @font-face generation,
@@ -149,8 +164,6 @@ interface ResolvedTheme {
         base: string;
     }>;
     readonly breakpoints: Readonly<Record<string, string>>;
-    readonly rounded: Readonly<Record<string, string>>;
-    readonly roundedRoof: string;
     /**
      * Corner shape set via `@rounded <shape>`. `null` means no shape was configured —
      * the compiler emits neither a `corner-shape` rule nor the fallback `@supports not`
@@ -167,6 +180,10 @@ interface ResolvedTheme {
      * `roundedShape` is null.
      */
     readonly roundedShapeScale: number;
+    /** Named radii from `@rounded { roof: 24px; }` — each one makes the class
+     *  `rounded-<name>` and the token `--rounded-<name>`. A name that matches a
+     *  built-in radius keyword replaces it; RI-1124 warns at definition. */
+    readonly radii: Readonly<Record<string, string>>;
     readonly shadows: Readonly<Record<string, string>>;
     readonly weights: Readonly<Record<string, number>>;
     readonly easing: Readonly<Record<string, string>>;
@@ -176,6 +193,10 @@ interface ResolvedTheme {
     readonly fluid: Readonly<FluidConfig>;
     readonly textFluid?: Readonly<FluidConfig>;
     readonly spacingFluid?: Readonly<FluidConfig>;
+    /** Named viewport ranges from `@fluid <name> { min; max; }` — each one makes
+     *  the scope class `fluid-<name>` and the tokens `--fluid-<name>-{min,max}`.
+     *  Ranges carry no unit: the ramp unit is baked per family. */
+    readonly fluidRanges: Readonly<Record<string, Readonly<FluidConfig>>>;
     readonly fonts: readonly FontSlot[];
     readonly preflight: Readonly<PreflightConfig>;
     readonly customUtilities: readonly CustomUtility[];
@@ -213,7 +234,6 @@ interface CompilationResult {
     /** Set of used font slot names (for token pruning). */
     usedFonts: Set<string>;
     /** Set of used rounded value names (for token pruning). */
-    usedRounded: Set<string>;
     /** Set of used shadow names (for token pruning). */
     usedShadows: Set<string>;
     /** Set of used animation shorthand names (for token pruning). */
@@ -254,11 +274,14 @@ declare function createThemeSnapshot(theme: ResolvedTheme): CompilationSnapshot;
  * ```
  */
 declare function createCompiler(): {
-    compile: (classNames: Iterable<string>, theme: ResolvedTheme) => CompilationResult;
+    /** `authored` names the classes the user wrote by hand (`@source inline`,
+     *  `@apply`, a caller-supplied list). Omit it to treat every class as
+     *  authored — correct for callers who assembled the list themselves. */
+    compile: (classNames: Iterable<string>, theme: ResolvedTheme, authored?: ReadonlySet<string>) => CompilationResult;
     createRi: () => (...inputs: (string | false | null | undefined)[]) => string;
     /** Isolated font output cache for this compiler instance. Pass to
      *  `assembleSections()` to avoid sharing module-level font state. */
     fontOutputCache: Map<string, FontOutput>;
 };
 
-export { type CompilationResult as C, type ParsedDirective as P, type ResolvedTheme as R, type CompiledRule as a, createThemeSnapshot as b, createCompiler as c };
+export { type CompilationResult as C, type ParsedDirective as P, type ResolvedTheme as R, type CompiledRule as a, createThemeSnapshot as b, createCompiler as c, describeLoadedWeights as d, weightIsLoaded as w };

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

@@ -1,3 +1,84 @@
+/**
+ * Claim resolution for ri() — utility name → CSS properties it sets.
+ *
+ * Split from merge/index.ts so each merge file is one concept: this file owns
+ * the dual-mode dispatch tables and resolvePropsWith(); index.ts owns the
+ * merge algorithm; context.ts owns the compilation-context lifecycle.
+ *
+ * Everything here is immutable module-init data plus pure closures over it —
+ * the mutable published compilation state lives in context.ts, and callers
+ * thread it in through resolvePropsWith()'s parameters.
+ */
+/** One functional `@utility name-*` root and the properties it claims. Declared
+ *  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[]];
+
+/**
+ * Compilation-context lifecycle — all mutable state behind ri().
+ *
+ * The engine creates a CompilationContext via createCompilationContext(),
+ * mutates it during compilation (register* functions), then finalizes it so
+ * ri() can read the published snapshot without interference from concurrent
+ * compilations. Split from merge/index.ts so the merge algorithm stays pure
+ * runtime and every piece of mutable state lives in one file.
+ *
+ * The default ri() cache lives here rather than next to the merge loop
+ * because finalizeCompilationContext() must clear it: conflict resolution
+ * rules may change between compilations, and stale entries from a previous
+ * compilation (with different custom utilities) must never be returned.
+ */
+
+interface CompilationContext {
+    customStaticProps: Record<string, string[]>;
+    /** Roots of functional `@utility name-*` entries → the properties they set. */
+    customFunctionalProps: Record<string, string[]>;
+    textSizes: Set<string>;
+    fontFamilies: Set<string>;
+    colorNames: Set<string>;
+}
+
+interface CompilationSnapshot {
+    readonly customStaticProps: Readonly<Record<string, string[]>>;
+    /** Longest root first, so `glow-outer-*` wins over `glow-*` for `glow-outer-4`. */
+    readonly customFunctionalProps: readonly CustomFunctionalEntry[];
+    readonly textSizes: ReadonlySet<string>;
+    readonly fontFamilies: ReadonlySet<string>;
+    readonly colorNames: ReadonlySet<string>;
+}
+/**
+ * Create a fresh compilation context.
+ * Called at the start of each compile() pass.
+ */
+declare function createCompilationContext(): CompilationContext;
+/**
+ * Register a custom utility's CSS properties in the compilation context.
+ * Called by the engine when processing @utility directives.
+ */
+declare function registerCustomUtility(ctx: CompilationContext, name: string, properties: string[], functional?: boolean): void;
+/**
+ * Register custom text sizes so the merge function correctly classifies
+ * text-{custom} as a font-size utility rather than a color utility.
+ */
+declare function registerCustomTextSizes(ctx: CompilationContext, sizes: string[]): void;
+/**
+ * Register custom font family names so the merge function correctly classifies
+ * font-{custom} as a font-family utility rather than a font-weight utility.
+ */
+declare function registerCustomFontFamilies(ctx: CompilationContext, families: string[]): void;
+/**
+ * Register the resolved theme's color names so the merge function classifies
+ * bare flat colors (border-accent for `@color { accent: … }`) as color
+ * utilities rather than width/weight ones. Shaded forms (accent-500) already
+ * match the shade pattern and need no registration.
+ */
+declare function registerColorNames(ctx: CompilationContext, names: string[]): 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.
@@ -57,18 +138,22 @@ interface DarkModeConfig {
 }
 
 /**
- * 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.
+ * 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.
  */
 
 interface TextSize {
     fontSize: string;
     lineHeight: string;
 }
-type FluidUnit = "vw" | "vi" | "vmin" | "vmax";
+/** 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;
+    min?: string;
+    max?: string;
     unit?: FluidUnit;
     multiplier?: number;
 }
@@ -83,7 +168,6 @@ interface Theme {
     colors: Record<string, ColorDefinition>;
     text: Record<string, TextSize>;
     breakpoints: Record<string, string>;
-    rounded: Record<string, string>;
     shadows: Record<string, string>;
     weights: Record<string, number>;
     easing: Record<string, string>;
@@ -104,67 +188,4 @@ type CornerShape = CornerShapeKeyword | {
 };
 declare const defaultTheme: Theme;
 
-/**
- * Compilation-context lifecycle — all mutable state behind ri().
- *
- * The engine creates a CompilationContext via createCompilationContext(),
- * mutates it during compilation (register* functions), then finalizes it so
- * ri() can read the published snapshot without interference from concurrent
- * compilations. Split from merge/index.ts so the merge algorithm stays pure
- * runtime and every piece of mutable state lives in one file.
- *
- * The default ri() LRU cache lives here rather than next to the merge loop
- * because finalizeCompilationContext() must clear it: conflict resolution
- * rules may change between compilations, and stale entries from a previous
- * compilation (with different custom utilities) must never be returned.
- */
-interface CompilationContext {
-    customStaticProps: Record<string, string[]>;
-    textSizes: Set<string>;
-    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[]>>;
-    readonly textSizes: ReadonlySet<string>;
-    readonly fontFamilies: ReadonlySet<string>;
-    readonly colorNames: ReadonlySet<string>;
-}
-/**
- * Create a fresh compilation context.
- * Called at the start of each compile() pass.
- */
-declare function createCompilationContext(): CompilationContext;
-/**
- * Register a custom utility's CSS properties in the compilation context.
- * Called by the engine when processing @utility directives.
- */
-declare function registerCustomUtility(ctx: CompilationContext, name: string, properties: string[]): void;
-/**
- * Register custom text sizes so the merge function correctly classifies
- * text-{custom} as a font-size utility rather than a color utility.
- */
-declare function registerCustomTextSizes(ctx: CompilationContext, sizes: string[]): void;
-/**
- * Register custom font family names so the merge function correctly classifies
- * font-{custom} as a font-family utility rather than a font-weight utility.
- */
-declare function registerCustomFontFamilies(ctx: CompilationContext, families: string[]): void;
-/**
- * Register the resolved theme's color names so the merge function classifies
- * bare flat colors (border-accent for `@color { accent: … }`) as color
- * utilities rather than width/weight ones. Shaded forms (accent-500) already
- * match the shade pattern and need no registration.
- */
-declare function registerColorNames(ctx: CompilationContext, names: string[]): 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;
-
 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 };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
+import { R as ResolvedTheme, P as ParsedDirective } from './index-4Kyaq3IZ.js';
+export { C as CompilationResult, a as CompiledRule, c as createCompiler } from './index-4Kyaq3IZ.js';
 import { PluginCreator } from 'postcss';
-export { C as ColorDefinition, a as CompilationContext, b as CompilationSnapshot, F as FluidConfig, T as TextSize, c as Theme, d as createCompilationContext, e as defaultTheme, f as finalizeCompilationContext, r as registerColorNames, g as registerCustomFontFamilies, h as registerCustomTextSizes, i as registerCustomUtility } from './context-ruu2x_jR.js';
-export { D as DEFAULT_TEXT_SIZES, c as createRi, r as ri, s as safelist } from './safelist-D9-Plqta.js';
-import { R as ResolvedTheme, P as ParsedDirective } from './index-Dp6i5TSv.js';
-export { C as CompilationResult, a as CompiledRule, c as createCompiler } from './index-Dp6i5TSv.js';
+export { C as ColorDefinition, a as CompilationContext, b as CompilationSnapshot, F as FluidConfig, T as TextSize, c as Theme, d as createCompilationContext, e as defaultTheme, f as finalizeCompilationContext, r as registerColorNames, g as registerCustomFontFamilies, h as registerCustomTextSizes, i as registerCustomUtility } from './index-DSgpB6bS.js';
+export { c as createRi, r as ri, s as safelist } from './safelist-CGCtF-Fr.js';
 
 interface RainbowIndexOptions {
     sources?: string[];
@@ -21,6 +21,9 @@ interface FinalizeProjectResult {
     theme: ResolvedTheme;
     directives: ParsedDirective[];
     warnings: string[];
+    /** Codes silenced for this entry by `/* ri-disable … *\/`. A consumer that
+     *  pushes further warnings into `warnings` must push through this too. */
+    suppressed: ReadonlySet<string>;
 }
 
 interface SourceEntry {