rainbowindex 0.5.1 → 0.6.0

package/dist/{context-B9yhJxd5.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;
 }
@@ -103,86 +188,4 @@ type CornerShape = CornerShapeKeyword | {
 };
 declare const defaultTheme: Theme;
 
-/**
- * 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[]];
-declare const DEFAULT_TEXT_SIZES: readonly ["xs", "sm", "base", "lg", "xl", "2xl", "3xl", "4xl", "5xl"];
-
-/**
- * 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;
-
-export { type AnimationDefinition as A, type ColorDefinition as C, DEFAULT_TEXT_SIZES as D, type FluidConfig as F, type TextSize as T, type CompilationContext as a, type CompilationSnapshot as b, type Theme as c, createCompilationContext as d, defaultTheme as e, finalizeCompilationContext as f, registerCustomFontFamilies as g, registerCustomTextSizes as h, registerCustomUtility as i, type DarkModeConfig as j, type CornerShape as k, registerColorNames as r };
+export { type 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, D as DEFAULT_TEXT_SIZES, 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-B9yhJxd5.js';
-export { c as createRi, r as ri, s as safelist } from './safelist-DAkKuxCk.js';
-import { R as ResolvedTheme, P as ParsedDirective } from './index-Dx-NpFFx.js';
-export { C as CompilationResult, a as CompiledRule, c as createCompiler } from './index-Dx-NpFFx.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 {

package/dist/index.mjs

@@ -3,19 +3,18 @@ import {
 } from "./chunk-PD4ZXGJ6.mjs";
 import {
   postcss_default
-} from "./chunk-4CTJLMYM.mjs";
+} from "./chunk-3LWJTLOJ.mjs";
 import {
   finalizeProjectCompilation,
   resolveGoogleFonts
-} from "./chunk-F4VCBISU.mjs";
+} from "./chunk-WK6S4HTC.mjs";
 import {
-  analyzeProjectCSS,
+  analyzeProjectCSSMemo,
   createCompiler,
   extractClassesFromSource,
   pushWarningsDeduped
-} from "./chunk-PDORZSQX.mjs";
+} from "./chunk-KSNYSR3C.mjs";
 import {
-  DEFAULT_TEXT_SIZES,
   createCompilationContext,
   createRi,
   defaultTheme,
@@ -25,11 +24,11 @@ import {
   registerCustomTextSizes,
   registerCustomUtility,
   ri
-} from "./chunk-4UKFK2GE.mjs";
+} from "./chunk-6U4IOFOS.mjs";
 
 // src/project/index.ts
 async function compileProject(options) {
-  const analysis = analyzeProjectCSS(options.css);
+  const analysis = analyzeProjectCSSMemo(options.css);
   const classNames = /* @__PURE__ */ new Set();
   if (options.classNames) {
     for (const cls of options.classNames) {
@@ -44,7 +43,12 @@ async function compileProject(options) {
         classNames.add(cls);
       }
     }
-    pushWarningsDeduped(analysis.warnings, extractionWarnings, analysis.warningSeen);
+    pushWarningsDeduped(
+      analysis.warnings,
+      extractionWarnings,
+      analysis.warningSeen,
+      analysis.suppressed
+    );
   }
   return finalizeProjectCompilation({
     css: options.css,
@@ -58,7 +62,6 @@ async function compileProject(options) {
   });
 }
 export {
-  DEFAULT_TEXT_SIZES,
   compileProject,
   createCompilationContext,
   createCompiler,

package/dist/{safelist-DAkKuxCk.d.ts → safelist-CGCtF-Fr.d.ts}

@@ -1,4 +1,4 @@
-import { b as CompilationSnapshot } from './context-B9yhJxd5.js';
+import { b as CompilationSnapshot } from './index-DSgpB6bS.js';
 
 /**
  * ri() — class merge function.

package/dist/vite.mjs

@@ -1,10 +1,13 @@
 import {
   postcss_default
-} from "./chunk-4CTJLMYM.mjs";
+} from "./chunk-3LWJTLOJ.mjs";
 import {
+  disableScanChangeTracking,
+  enableScanChangeTracking,
   enableSourceFileListCache,
-  invalidateSourceFileListCache
-} from "./chunk-F4VCBISU.mjs";
+  invalidateSourceFileListCache,
+  markSourceFileChanged
+} from "./chunk-WK6S4HTC.mjs";
 import {
   isSourceFile
 } from "./chunk-3HRMFZGE.mjs";
@@ -16,11 +19,13 @@ import {
   findClosingBrace,
   hasRIActivation,
   isAtRuleBoundary,
-  isAtRuleNameChar
-} from "./chunk-PDORZSQX.mjs";
+  isAtRuleNameChar,
+  parseFileDisables,
+  warningCode
+} from "./chunk-KSNYSR3C.mjs";
 import {
   devWarn
-} from "./chunk-4UKFK2GE.mjs";
+} from "./chunk-6U4IOFOS.mjs";
 
 // src/integrations/vite.ts
 import { existsSync } from "fs";
@@ -196,6 +201,9 @@ function rainbowindexVite() {
       server.watcher?.on("unlink", invalidateSourceFileListCache);
       server.watcher?.on("unlinkDir", invalidateSourceFileListCache);
       server.httpServer?.once("close", invalidateSourceFileListCache);
+      enableScanChangeTracking();
+      server.watcher?.on("change", (file) => markSourceFileChanged(file));
+      server.httpServer?.once("close", disableScanChangeTracking);
       logger = {
         info: (msg) => server.config.logger?.info?.(msg, { timestamp: true }),
         warn: (msg) => server.config.logger?.warn?.(msg, { timestamp: true })
@@ -238,8 +246,11 @@ function rainbowindexVite() {
           riCSSFiles.add(file);
           let safe = rewriteDirectiveBodies(code);
           const expandWarnings = [];
-          safe = expandApplyGroups(safe, expandWarnings);
+          safe = expandApplyGroups(safe, expandWarnings, file);
+          const suppressed = parseFileDisables(code);
           for (const w of expandWarnings) {
+            const warned = warningCode(w);
+            if (warned !== null && suppressed.has(warned)) continue;
             (logger?.warn ?? console.warn)(`[rainbowindex] ${w}`);
           }
           return safe !== code ? safe : null;
@@ -258,6 +269,7 @@ function rainbowindexVite() {
         return;
       }
       if (!isSourceFile(file)) return;
+      markSourceFileChanged(file);
       const previous = candidateSignatures.get(file);
       let signature;
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rainbowindex",
-	"version": "0.5.1",
+	"version": "0.6.0",
 	"description": "CSS-first system for building and maintaining consistent user interfaces",
 	"keywords": [
 		"css",