rainbowindex 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -5,6 +5,169 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-08-27
+
+### Added
+
+- **`rainbowindex scan <file|glob…>`** — prints every class candidate the
+  scanner extracts from each file, with scanner warnings on stderr. Answers
+  "why doesn't my class generate?" directly: a class missing from the list
+  was never seen by the scanner (check the markup), while a class listed
+  there that still produces no rule fails later (check the build warnings).
+- **RI-1411 — skipped over-long lines are now reported.** The scanner drops
+  lines above the minified-input guard, previously in silence. It now warns
+  once per file with the path and line count. Suppressed for `node_modules`
+  paths, where minified dists are the guard's intended target.
+- **RI-1038 — uppercase `@utility` names warn.** The markup scanner only
+  matches lowercase tokens, so `@utility cardHeader` could never trigger
+  from `class="cardHeader"`. The utility still works through `@a`/`@apply`
+  and inline `@source`, so it is kept — but no longer silently unreachable.
+
+### Changed
+
+- **Fallback stacks moved from preflight into `@font`.** The
+  `--sans-fallback` / `--serif-fallback` / `--mono-fallback` variables were
+  emitted into every project and referenced by nothing. A manual `@font`
+  slot that declares no fallbacks now gets the default system stack appended
+  to its `--font-<slot>` value instead (`sans: "Chartwell";` →
+  `"Chartwell", ui-sans-serif, system-ui, …`); a slot that declares its own
+  fallbacks is untouched. Font tokens no longer depend on a preflight
+  category that users can switch off.
+- **Focus ring uses literal lengths.** `:focus-visible` drew its outline at
+  `var(--spacing)` (4px by default) and offset at half that, so changing the
+  spacing scale silently resized every focus ring. Now a flat 2px width and
+  2px offset.
+- **Placeholder color follows the text color** —
+  `color-mix(in oklab, currentColor 48%, transparent)` instead of a
+  hardcoded gray that ignored the theme in dark mode.
+- **Scanner line-length guard raised from 2,000 to 10,000 characters.** Real
+  minified files run far above this, while hand-written long lines (inline
+  SVG path data, long attribute stacks) sit below it. `MAX_LINE_LENGTH` is
+  exported so tooling and tests derive from it instead of hardcoding.
+- **Default source patterns scan every root HTML file** (`*.html`, not just
+  `index.html`), so Vite multi-page apps are covered without an explicit
+  `@source`. `dist`, `build`, and `public` remain excluded.
+
+### Removed
+
+- **Preflight `select-reset`.** It styled rather than reset, and shipped
+  three defects: its chevron was a `currentColor` SVG in a `background-image`,
+  which resolves to black and disappears on dark backgrounds; the bare
+  `select` selector also hit `<select multiple>`, giving listboxes a floating
+  chevron and 2.5rem of padding; and `appearance: none` stripped the native
+  control on every platform. Style selects in your own CSS.
+- **Preflight `:focus:not(:focus-visible) { outline: none }`** — no current
+  browser draws an outline for plain `:focus`, so the rule was dead.
+
+### Fixed
+
+- **Quoted class attributes on over-long lines are no longer lost.** A
+  `className="…"` sharing a line with multi-KB inline SVG path data
+  generated nothing: the whole-file scan skipped the line for length, and
+  the attribute collector stripped the quotes and then searched only for
+  string literals *nested inside* the value, of which a plain quoted
+  attribute has none. Quoted attribute values are now tokenized directly, in
+  the one shared collector — so JSX, HTML, Vue, Svelte, and object-literal
+  (`{ className: "…" }`) syntax are all fixed together. Non-quoted
+  expression values keep their existing semantics.
+- **List margins are reset.** `list-reset` removed bullets and padding while
+  `ol`, `ul`, and `menu` kept the browser's `margin-block: 1em`, leaving
+  unexplained gaps around navigation and menus.
+- **`fieldset` and `legend` are reset** — their default margin and padding
+  survived while every other form control was flush.
+
+## [0.4.1] - 2026-08-25
+
+### Added
+
+- **Automatic zero-CLS font fallbacks.** Any `@font` slot whose family is in
+  the built-in metrics table (~100 common Google + system families, generated
+  from `@capsizecss/metrics` at development time — no new runtime dependency)
+  now gets a metrics-adjusted local fallback `@font-face` automatically. The
+  fallback font is picked from the slot's stack, or by the web font's
+  category (Arial / Times New Roman / Courier New). Opt out with
+  `metrics: none;`, pick the matched local font with `metrics: "Segoe UI";`,
+  or keep full manual control with
+  `metrics: "Arial" <size-adjust> <ascent> <descent> <line-gap>;`.
+- **`face:` entries** — local font files are now declared as repeatable
+  `face: <src> [{ overrides }]` entries, one grammar for every face:
+  `display: "Satoshi" { face: /Satoshi.woff2; face: /Satoshi-Italic.woff2 { style: italic; } }`.
+- **Fallback stacks work with `from google`** —
+  `sans: "Inter", ui-sans-serif, sans-serif from google;` now parses as a
+  google slot with fallbacks (previously it silently became a manual stack).
+- **@font now warns instead of ignoring silently**: unknown option keys
+  (RI-1217), `preload` on non-local slots where it can have no effect
+  (RI-1219), and partial or invalid `metrics` values (RI-1220).
+
+### Changed
+
+- The `@font` parser was rebuilt on the shared entry scanner: one pass, no
+  regex preambles, no re-serialization. Public API (`parseFontBody`,
+  `parseNestedFontBlock`) is unchanged.
+- **Incremental rebuilds only re-do changed work** — the scanner keeps a
+  per-file cache keyed on mtime + size, so a CLI watch or Vite HMR rebuild
+  re-reads and re-extracts only the files that actually changed instead of
+  the whole project. The CSS entry analysis is memoized on the entry text
+  (stable theme identity across rebuilds), Google-font resolution keeps its
+  identity when metadata is unchanged, and per-class compilation results
+  (rule, warnings, token usage) are replayed across rebuilds from a
+  theme-keyed cache. A one-file edit in a large project now costs
+  O(changed files) instead of O(project).
+- **`ri()` conditional args hit the cache fast path** — falsy arguments
+  (`ri("flex", isActive && "bg-blue-500")`) no longer force re-tokenization
+  on every call: the raw-key cache skips falsy primitives, making cached
+  conditional-pattern calls ~4x faster.
+- **Cheaper compile passes** — duplicate class names across `@apply` rules
+  resolve once per pass, the `@slot`/`@apply` walks no longer traverse the
+  generated utility CSS, custom `@utility` bodies parse once per body text
+  instead of once per variant form, and the editor candidate collector's
+  context assignment went from quadratic to a sorted sweep. As part of the
+  compile-result replay, engine-level compilation warnings are now
+  deduplicated (final project output already was).
+- **Internal restructuring (behavior-preserving)** — the directive body
+  parsers were split by grammar family: `@color` and `@font` now own their
+  own modules, and the generic key-value/entry grammars sit together in the
+  directives foundation. The `parsers` import surface is unchanged.
+
+### Deprecated
+
+- The older `@font` forms still parse and desugar into the new model, but
+  warn (RI-1218) and will be removed in a future release: `@face { src: …; }`
+  blocks and the `italic:` shorthand (use `face:`), `from "<path>"` (use
+  `face:`), `from system` (use bare `system`), the `fallback:` key (list
+  fallbacks in the slot preamble), the five-key metrics cluster
+  `metricsFallback`/`sizeAdjust`/`ascent`/`descent`/`lineGap` (use
+  `metrics:`), and the `unicodeRange` spelling (use `unicode-range`).
+
+### Removed
+
+- **`@font` `subset:`** — the Google css2 API takes no subset hint, so the
+  key never affected the emitted URL. It now warns (RI-1218) and is ignored.
+- **`FontSlot` / `FontFace` fields** — the five slot-level metrics fields
+  (`metricsFallback`, `sizeAdjust`, `ascent`, `descent`, `lineGap`) are
+  replaced by a single `metrics?: FontMetricsConfig | null`; slot-level
+  `preload` moved onto the faces; `FontFace.subset` is gone. Stylesheets are
+  unaffected — this only touches code importing those types directly.
+
+### Fixed
+
+- **`ri()` stroke-width vs stroke-color conflict — for real this time.** The
+  v0.4.0 changelog described this fix, but the implementation did not ship in
+  that release: `ri("stroke-2 stroke-red-500")` still dropped `stroke-2`. The
+  `stroke` prefix is now actually width-vs-color dual-mode (mirroring
+  `border`/`outline`): decimal and non-color arbitrary values claim
+  `stroke-width`, color values claim `stroke`. Same-property conflicts
+  (`stroke-2` vs `stroke-4`, `stroke-red-500` vs `stroke-blue-500`) still
+  merge as before. The emission↔claim parity suite no longer carries a
+  stroke exception, and regression tests pin the merged output.
+- **Directive rewriter no longer duplicates unclosed blocks** — an
+  unterminated `{` inside a `@color` body made the Vite-plugin pre-pass
+  re-emit the text before it (`@color { accent: 0.18 330 { inline` came out
+  with the entry doubled). The rewriter's two hand-rolled brace walks were
+  replaced by one shared walker built on the same brace matcher the directive
+  scan already uses, which also makes quotes and comments inside blocks
+  behave consistently across the rewrite passes.
+
 ## [0.4.0] - 2026-08-20
 
 ### Added

package/README.md

@@ -211,7 +211,7 @@ Customization happens in your CSS input, not a JS config. The engine recognizes:
 | `@color` | Define color tokens. Supports generative (`chroma hue`), explicit (`oklch(...)`, `#rrggbb`), light/dark pairs, and aliases. |
 | `@spacing` | Set the spacing base unit. |
 | `@text` | Define text size tokens (`size, line-height`). |
-| `@font`, `@font-face` | Register font families inside a single `@font { … }` block. One slot can own multiple `@face` faces (e.g. upright + italic) or use the `italic:` shorthand. |
+| `@font`, `@font-face` | Register font families inside a single `@font { … }` block. Local files are repeatable `face:` entries (e.g. upright + italic). Known families get an automatic zero-CLS metrics fallback (`metrics: none` opts out). |
 | `@rounded` | Border-radius tokens; modifier sets corner shape (`round`, `squircle`, `superellipse(N)`, etc). |
 | `@fluid` | Configure fluid type/spacing range. |
 | `@animate` | Register named animations with inline `@keyframes`. |
@@ -242,10 +242,11 @@ Example:
 }
 
 @font {
-	sans: "Inter" from google { weight: 400 700; }
-	display: "Satoshi" from "/fonts/Satoshi.woff2" {
+	sans: "Inter", ui-sans-serif, sans-serif from google { weight: 400 700; }
+	display: "Satoshi" {
 		weight: 300 900;
-		italic: "/fonts/Satoshi-Italic.woff2";   /* second face, font-style: italic */
+		face: /fonts/Satoshi.woff2;
+		face: /fonts/Satoshi-Italic.woff2 { style: italic; }
 	}
 }
 

package/dist/browser.mjs

@@ -13,7 +13,7 @@ import {
   registerCustomTextSizes,
   registerCustomUtility,
   ri
-} from "./chunk-5Y7EXXLS.mjs";
+} from "./chunk-KRZL4IDK.mjs";
 
 // src/entries/browser.ts
 function browserEntryUnavailable() {

package/dist/{chunk-TLR6RP5L.mjs → chunk-CMB6BHVE.mjs}

@@ -1,6 +1,6 @@
 import {
   compileScannedProject
-} from "./chunk-4SVFFDS2.mjs";
+} from "./chunk-DT5HYIM3.mjs";
 import {
   APPLY_ALIASES,
   DIRECTIVE_NAMES_SET,
@@ -20,7 +20,7 @@ import {
   resolveUtilityDeclarations,
   resolveVariant,
   splitSelectorList
-} from "./chunk-6DAHUFNU.mjs";
+} from "./chunk-ZI5ZYNSU.mjs";
 
 // src/integrations/postcss/index.ts
 import postcss2 from "postcss";
@@ -102,6 +102,7 @@ function processApply(root, theme, warnings) {
   }
   const customVariantMap = new Map(theme.customVariants.map((cv) => [cv.name, cv]));
   const checkedApplyRoots = /* @__PURE__ */ new Set();
+  const resolveCache = /* @__PURE__ */ new Map();
   for (let depth = 0; depth < MAX_APPLY_DEPTH; depth++) {
     const applyNodes = [];
     const classListByNode = /* @__PURE__ */ new Map();
@@ -127,7 +128,8 @@ function processApply(root, theme, warnings) {
         warnings,
         customVariantMap,
         groupRoots,
-        checkedApplyRoots
+        checkedApplyRoots,
+        resolveCache
       );
     }
   }
@@ -144,7 +146,7 @@ function processApply(root, theme, warnings) {
     }
   }
 }
-function expandApply(atRule, classNames, theme, warnings, customVariantMap, groupRoots, checkedApplyRoots) {
+function expandApply(atRule, classNames, theme, warnings, customVariantMap, groupRoots, checkedApplyRoots, resolveCache) {
   const parentRule = atRule.parent;
   if (parentRule?.type !== "rule") {
     warnings.push("[RI-1006] @apply must be used inside a CSS rule, not at the top level.");
@@ -166,8 +168,23 @@ function expandApply(atRule, classNames, theme, warnings, customVariantMap, grou
   }
   const resolved = [];
   for (const className of classNames) {
-    const r = resolveClassName(className, theme, warnings, customVariantMap, checkedApplyRoots);
-    if (r) resolved.push(r);
+    let entry = resolveCache.get(className);
+    if (!entry) {
+      const entryWarnings = [];
+      entry = {
+        result: resolveClassName(
+          className,
+          theme,
+          entryWarnings,
+          customVariantMap,
+          checkedApplyRoots
+        ),
+        warnings: entryWarnings
+      };
+      resolveCache.set(className, entry);
+    }
+    warnings.push(...entry.warnings);
+    if (entry.result) resolved.push(entry.result);
   }
   const baseGroups = [];
   const baseNestedBlocks = [];
@@ -556,16 +573,16 @@ var rainbowindex = (options = {}) => {
         const compilationWarnings = compiled.warnings;
         const from = root.source?.input?.file ?? root.source?.input?.id ?? root.source?.input?.from ?? "<rainbowindex>";
         stripRIDirectiveNodes(root);
-        if (compiled.sections.length > 0) {
-          const generatedRoot = postcss2.parse(compiled.sections.join("\n\n"), { from });
-          root.prepend(generatedRoot.nodes);
-        }
         const slotWarnings = [];
         warnStandaloneSlots(root, slotWarnings);
         pushWarningsDeduped(compilationWarnings, slotWarnings, warningSeen);
         const applyWarnings = [];
         processApply(root, compiled.theme, applyWarnings);
         pushWarningsDeduped(compilationWarnings, applyWarnings, warningSeen);
+        if (compiled.sections.length > 0) {
+          const generatedRoot = postcss2.parse(compiled.sections.join("\n\n"), { from });
+          root.prepend(generatedRoot.nodes);
+        }
         const cssFnWarnings = [];
         processCSSFunctions(root, compiled.theme, cssFnWarnings);
         pushWarningsDeduped(compilationWarnings, cssFnWarnings, warningSeen);