@svelte-vitals/core 0.37.0 → 0.39.0

package/dist/index.d.ts

@@ -971,7 +971,7 @@ interface Rule {
     category: Category;
     /** Default severity (overridable by config in later slices). */
     severity: Severity;
-    /** 'route' = evaluated per route, 'project' = site-wide (design §10, §12). */
+    /** 'route' = evaluated per route, 'project' = site-wide, 'component' = evaluated per source file (design §10, §12). */
     scope: Scope;
     /** Why this rule matters — one or two sentences, surfaced by `svelte-vitals explain` (issue #24). */
     rationale: string;
@@ -1268,11 +1268,19 @@ declare const architectureDirectoryNaming: Rule;
 
 /**
  * architecture/reserved-directory-names — a directory's immediate subdirectories may only take names
- * the project declared for that position (design 2026-07-29). L3: inert until a scope is declared.
+ * the project declared for that position (design 2026-07-29, extended 2026-08-08 for lowercase units —
+ * issue #386).
  *
- * Two option maps, differing in what their key names. A `scopes` key names the parent directly. A
+ * The option maps differ in what their keys name. A `scopes` key names the parent directly. A
  * `unitScopes` key names a root, and the rule governs the children of whichever directories beneath
- * it are units — the shape a glob cannot reach, because units nest to arbitrary depth.
+ * it are units whose name begins A–Z — the shape a glob cannot reach, because units nest to arbitrary
+ * depth. An `anyCaseUnitScopes` key names a root the same way, but governs units of *either* case:
+ * `isUnitDir`'s letter test — A–Z plus a same-stemmed entry file, whatever its extension — excludes a
+ * lowercase unit, so without this map no generic unit-map declaration governed one's children (a
+ * `scopes` key naming the parent directly could still reach one) — measured at 129 of 299 units (43%)
+ * on a real tree. Neither map is named with the bare word "unit": the
+ * sibling rule `architecture/reserved-name-placement` records why that word alone is ambiguous between
+ * the two predicates once both exist.
  *
  * There are no pass results. `computeScore` seeds every distinct `route` at 100 and averages, and the
  * subject here is a directory with no pre-existing score key, so a pass per directory would add
@@ -1643,13 +1651,11 @@ declare const APP_SCRIPT: string;
 declare function renderAppShell(snapshot: AppSnapshot): string;
 /**
  * Static (non-live) document over a prebuilt JsonReport — kept as the public name the
- * html reporter has always exported. `routeBadges` preserves the old opts shape.
+ * html reporter has always exported.
  */
 declare function buildHtmlDocument(report: JsonReport, meta: {
     version: string;
     coreVersion?: string;
-}, opts?: {
-    routeBadges?: Record<string, RouteBadge>;
 }): string;
 /** Render results as the self-contained HTML report (the CLI's `--reporter html`). */
 declare function formatHtmlReport(results: Result[], config: Config, meta: {

package/dist/index.js

@@ -167,17 +167,9 @@ function collectEachBlocks(node, source, acc) {
   }
 }
 var WALK_IGNORED_KEYS = /* @__PURE__ */ new Set(["type", "start", "end", "loc", "range"]);
+var NO_BOUNDARIES = /* @__PURE__ */ new Set();
 function walkEstree(node, visit) {
-  if (Array.isArray(node)) {
-    for (const child of node) walkEstree(child, visit);
-    return;
-  }
-  if (!node || typeof node !== "object" || typeof node.type !== "string") return;
-  visit(node);
-  for (const key of Object.keys(node)) {
-    if (WALK_IGNORED_KEYS.has(key)) continue;
-    walkEstree(node[key], visit);
-  }
+  walkEvalScope(node, (n) => void visit(n), /* @__PURE__ */ new Set(), NO_BOUNDARIES);
 }
 function isEffectCall(node) {
   const c = node?.callee;
@@ -280,18 +272,7 @@ function scopeIntroducedNames(node) {
   return introduced;
 }
 function walkScoped(node, visit, shadowed = /* @__PURE__ */ new Set()) {
-  if (Array.isArray(node)) {
-    for (const child of node) walkScoped(child, visit, shadowed);
-    return;
-  }
-  if (!node || typeof node !== "object" || typeof node.type !== "string") return;
-  const introduced = scopeIntroducedNames(node);
-  const scope = introduced.size > 0 ? /* @__PURE__ */ new Set([...shadowed, ...introduced]) : shadowed;
-  visit(node, scope);
-  for (const key of Object.keys(node)) {
-    if (WALK_IGNORED_KEYS.has(key)) continue;
-    walkScoped(node[key], visit, scope);
-  }
+  walkEvalScope(node, (n, scope) => void visit(n, scope), shadowed, NO_BOUNDARIES);
 }
 function collectStateWrites(root, stateNames, acc, kinds) {
   const record = (name, kind) => {
@@ -769,7 +750,7 @@ function collectPropNames(program, includeBindable) {
   let seen = 0;
   let ambiguous = false;
   walkEstree(program, (n) => {
-    if (n.type !== "VariableDeclarator" || !n.init || !isPropsCall(n.init)) return;
+    if (n.type !== "VariableDeclarator" || !n.init || !isPropsCall(unwrapTs(n.init))) return;
     seen++;
     if (n.id?.type === "Identifier") {
       names.add(n.id.name);
@@ -842,10 +823,10 @@ function countProps(program) {
   let seen = 0;
   let uncountable = false;
   walkEstree(program, (n) => {
-    if (n.type !== "VariableDeclarator" || !n.init || !isPropsCall(n.init)) return;
+    if (n.type !== "VariableDeclarator" || !n.init || !isPropsCall(unwrapTs(n.init))) return;
     seen++;
     const props = n.id?.type === "ObjectPattern" ? n.id.properties : void 0;
-    if (!Array.isArray(props) || props.some((p) => p?.type === "RestElement")) {
+    if (!Array.isArray(props)) {
       uncountable = true;
       return;
     }
@@ -958,19 +939,19 @@ var EVAL_SCOPE_BOUNDARIES = /* @__PURE__ */ new Set([
   "ClassDeclaration",
   "ClassExpression"
 ]);
-function walkEvalScope(node, visit, shadowed = /* @__PURE__ */ new Set()) {
+function walkEvalScope(node, visit, shadowed = /* @__PURE__ */ new Set(), boundaries = EVAL_SCOPE_BOUNDARIES) {
   if (Array.isArray(node)) {
-    for (const child of node) walkEvalScope(child, visit, shadowed);
+    for (const child of node) walkEvalScope(child, visit, shadowed, boundaries);
     return;
   }
   if (!node || typeof node !== "object" || typeof node.type !== "string") return;
   const introduced = scopeIntroducedNames(node);
   const scope = introduced.size > 0 ? /* @__PURE__ */ new Set([...shadowed, ...introduced]) : shadowed;
   if (visit(node, scope)) return;
-  if (EVAL_SCOPE_BOUNDARIES.has(node.type)) return;
+  if (boundaries.has(node.type)) return;
   for (const key of Object.keys(node)) {
     if (WALK_IGNORED_KEYS.has(key)) continue;
-    walkEvalScope(node[key], visit, scope);
+    walkEvalScope(node[key], visit, scope, boundaries);
   }
 }
 function collectEvalScopeCalls(root, source, matcher, skipSubtree, initialShadowed) {
@@ -1261,13 +1242,13 @@ function collectModuleStateDecls(program, source) {
     const decl = unwrapExport(stmt);
     if (decl?.type === "VariableDeclaration") {
       for (const d of decl.declarations ?? []) {
-        if (d?.id?.type === "Identifier" && d.init && isStateDeclaration(d.init)) {
+        if (d?.id?.type === "Identifier" && d.init && isStateDeclaration(unwrapTs(d.init))) {
           out.push({ name: d.id.name, line: lineOf(source, d.start) });
         }
       }
     } else if (decl?.type === "ClassDeclaration" && decl.id?.type === "Identifier") {
       const hasStateField = (decl.body?.body ?? []).some(
-        (m) => m?.type === "PropertyDefinition" && m.value && isStateDeclaration(m.value)
+        (m) => m?.type === "PropertyDefinition" && m.value && isStateDeclaration(unwrapTs(m.value))
       );
       if (hasStateField) statefulClasses.add(decl.id.name);
     }
@@ -1303,6 +1284,17 @@ function parseModuleFacts(source, filename) {
     for (const l of raw) basePathLinks.push({ ...l, line: shift(l.line) });
     basePathLinks.sort((a, b) => a.line - b.line);
   }
+  const importSpans = [];
+  const namespaceImports = [];
+  if (program) {
+    const rawImportSpans = [];
+    collectImportSources(program, wrapped, rawImportSpans);
+    for (const s of rawImportSpans) importSpans.push({ ...s, line: shift(s.line) });
+    const rawNamespaceImports = [];
+    collectNamespaceImports(program, wrapped, rawNamespaceImports);
+    for (const n of rawNamespaceImports) namespaceImports.push({ ...n, line: shift(n.line) });
+  }
+  const imports = importSpans.map((s) => s.source);
   return {
     eachBlocks: [],
     effects: [],
@@ -1310,9 +1302,9 @@ function parseModuleFacts(source, filename) {
     javascriptUrls: [],
     loc: 0,
     propCount: 0,
-    imports: [],
-    importSpans: [],
-    namespaceImports: [],
+    imports,
+    importSpans,
+    namespaceImports,
     constableStates: [],
     mutatedProps: [],
     stalePropDerivations: [],
@@ -1409,11 +1401,12 @@ function parseComponentFacts(source, filename) {
     const stateDecls = [];
     walkEstree(program, (n) => {
       if (n.type !== "VariableDeclarator" || !n.init) return;
-      if (isStateDeclaration(n.init) && n.id?.type === "Identifier") {
+      const init = unwrapTs(n.init);
+      if (isStateDeclaration(init) && n.id?.type === "Identifier") {
         stateNames.add(n.id.name);
         stateDecls.push({ name: n.id.name, line: lineOf(source, n.start) });
       }
-      if (isStateDeclaration(n.init) || isDerivedDeclaration(n.init) || isPropsCall(n.init))
+      if (isStateDeclaration(init) || isDerivedDeclaration(init) || isPropsCall(init))
         addBoundNames(n.id, reactiveNames);
     });
     walkEstree(program, (n) => {
@@ -1440,8 +1433,10 @@ function parseComponentFacts(source, filename) {
     for (const stmt of program.body ?? []) {
       if (stmt?.type !== "VariableDeclaration") continue;
       for (const d of stmt.declarations ?? []) {
-        if (d?.id?.type !== "Identifier" || !d.init || !isPlainStateCall(d.init)) continue;
-        const arg = unwrapTs(d.init.arguments?.[0]);
+        if (d?.id?.type !== "Identifier" || !d.init) continue;
+        const init = unwrapTs(d.init);
+        if (!isPlainStateCall(init)) continue;
+        const arg = unwrapTs(init.arguments?.[0]);
         if (arg?.type === "ObjectExpression" || arg?.type === "ArrayExpression") {
           rawableCandidates.push({ name: d.id.name, line: lineOf(source, d.start) });
         }
@@ -1475,8 +1470,10 @@ function parseComponentFacts(source, filename) {
     for (const stmt of program.body ?? []) {
       if (stmt?.type !== "VariableDeclaration") continue;
       for (const d of stmt.declarations ?? []) {
-        if (d?.id?.type !== "Identifier" || !d.init || !isPlainStateCall(d.init)) continue;
-        const arg = unwrapTs(d.init.arguments?.[0]);
+        if (d?.id?.type !== "Identifier" || !d.init) continue;
+        const init = unwrapTs(d.init);
+        if (!isPlainStateCall(init)) continue;
+        const arg = unwrapTs(init.arguments?.[0]);
         if (arg?.type === "NewExpression" && arg.callee?.type === "Identifier" && BUILTIN_STATE_TYPES.has(arg.callee.name)) {
           builtinCandidates.set(d.id.name, { type: arg.callee.name, line: lineOf(source, d.start) });
         }
@@ -2740,6 +2737,13 @@ function imageRule(opts) {
             severity: opts.severity,
             detection: { presence: "own", value: "static" },
             route: route.route,
+            // No single route-level file exists here (unlike ResolvedHead.file) — the
+            // route's first image stands in as its attributed file (design
+            // 2026-08-08-pass-result-location-design.md; this uncaught inline PASS literal
+            // was missed by the design spike's grep and added to its blast-radius table
+            // afterward, maintainer ruling, same date). `route.images.length === 0` already
+            // continued above, so `[0]` is always defined here.
+            location: route.images[0].file,
             message: opts.label,
             recommendation: opts.recommendation,
             docsUrl: docsUrl12
@@ -2839,6 +2843,13 @@ function linkRule(opts) {
             severity: opts.severity,
             detection: { presence: "own", value: "static" },
             route: head.route,
+            // The route's own attributed file (design 2026-08-08-pass-result-location-design.md)
+            // — this uncaught inline PASS literal was missed by the design spike's grep and
+            // added to its blast-radius table afterward (maintainer ruling, same date). No
+            // single per-tag location applies here (many links can back one pass), so the
+            // route's own head file is the uniform attribution; per-tag penalized locations
+            // above remain per-tag.
+            location: head.file,
             message: opts.label,
             recommendation: opts.recommendation,
             docsUrl: docsUrl12
@@ -2941,6 +2952,11 @@ var performanceLcpImage = {
           severity: "warning",
           detection: { presence: "own", value: "static" },
           route: route.route,
+          // Same `location` the penalized branch above uses (design
+          // 2026-08-08-pass-result-location-design.md) — this uncaught inline PASS literal
+          // was missed by the design spike's grep and added to its blast-radius table
+          // afterward (maintainer ruling, same date).
+          location: first.file,
           message: "LCP image eager loading",
           recommendation,
           docsUrl
@@ -2995,6 +3011,10 @@ var performanceRenderBlockingScript = {
           severity: "warning",
           detection: { presence: "own", value: "static" },
           route: head.route,
+          // The route's own attributed file (design 2026-08-08-pass-result-location-design.md)
+          // — this uncaught inline PASS literal was missed by the design spike's grep and
+          // added to its blast-radius table afterward (maintainer ruling, same date).
+          location: head.file,
           message: "No render-blocking scripts",
           recommendation: recommendation2,
           docsUrl: docsUrl2
@@ -3250,6 +3270,10 @@ var performancePreconnect = {
           severity: "info",
           detection: { presence: "own", value: "static" },
           route: head.route,
+          // head.file — the same target used to resolve options above (design
+          // 2026-08-08-pass-result-location-design.md) — so a `files:`-scoped override can
+          // also match this passing seed via `severity: 'off'`.
+          location: head.file,
           message: "Third-party origins are preconnected",
           recommendation: recommendation3,
           docsUrl: docsUrl3
@@ -3514,7 +3538,6 @@ var PLACEHOLDER_RES = [
   /yourcompany/i,
   /your name here/i
 ];
-var PLACEHOLDERS = PLACEHOLDER_RES.map((r) => r.source);
 function hasPlaceholder(s) {
   return PLACEHOLDER_RES.some((re) => re.test(s));
 }
@@ -3592,6 +3615,9 @@ function jsonldRule(opts) {
               severity: opts.severity,
               detection: PASS,
               route: head.route,
+              // Same `location` the penalized branch above uses (design
+              // 2026-08-08-pass-result-location-design.md).
+              location: head.file,
               message: opts.label,
               recommendation: opts.recommendation,
               docsUrl: docsUrl12
@@ -3645,6 +3671,9 @@ var seoJsonLdValidity = {
             severity: "warning",
             detection: PASS,
             route: head.route,
+            // Same `location` the penalized branch above uses (design
+            // 2026-08-08-pass-result-location-design.md).
+            location: head.file,
             message: "JSON-LD validity",
             recommendation: "Make the JSON-LD valid JSON with both @context and @type.",
             docsUrl: docsUrl12
@@ -3746,14 +3775,12 @@ var seoJsonLdRequiredProps = jsonldRule({
 });
 
 // src/rules/seo/text-metrics.ts
-var segmenter = typeof Intl !== "undefined" && typeof Intl.Segmenter === "function" ? new Intl.Segmenter() : void 0;
+var segmenter = new Intl.Segmenter();
 function collapseWhitespace(s) {
   return s.trim().replace(/\s+/g, " ");
 }
 function visibleLength(s) {
-  const collapsed = collapseWhitespace(s);
-  if (!segmenter) return [...collapsed].length;
-  return [...segmenter.segment(collapsed)].length;
+  return [...segmenter.segment(collapseWhitespace(s))].length;
 }
 
 // src/rules/seo/length-rule.ts
@@ -3803,6 +3830,11 @@ function lengthRule(opts) {
             severity: "info",
             detection: PASS,
             route: head.route,
+            // Same `location` the penalized branch above uses (design
+            // 2026-08-08-pass-result-location-design.md) — without it, a `files:`-scoped
+            // override can flip this result to PASS via its `options` but can never match
+            // it to also apply `severity: 'off'`.
+            location,
             message: opts.label,
             recommendation: recommendation12,
             docsUrl: docsUrl12
@@ -3926,6 +3958,9 @@ var seoHreflang = {
           severity: "warning",
           detection: PASS,
           route: head.route,
+          // Same `location` the penalized branch above uses (design
+          // 2026-08-08-pass-result-location-design.md).
+          location,
           message: "hreflang",
           recommendation: recommendation4,
           docsUrl: docsUrl4
@@ -3978,6 +4013,10 @@ var seoSingleH1 = {
           severity: "warning",
           detection: PASS,
           route: route.route,
+          // No single route-level file exists here (unlike ResolvedHead.file) — the
+          // passing route's own <h1> stands in as its attributed file (design
+          // 2026-08-08-pass-result-location-design.md). Only reached when h1.length === 1.
+          location: h1[0].file,
           message: "Heading hierarchy",
           recommendation: recommendation5,
           docsUrl: docsUrl5
@@ -4027,6 +4066,9 @@ function uniquenessRule(opts) {
           severity: "warning",
           detection: PASS,
           route: e.route,
+          // Same `location` the penalized branch above uses (design
+          // 2026-08-08-pass-result-location-design.md).
+          location: e.file,
           message: opts.label,
           recommendation: opts.recommendation,
           docsUrl: docsUrl12
@@ -4100,6 +4142,11 @@ var seoHeadingLevelSkip = {
           severity: "info",
           detection: PASS,
           route: route.route,
+          // No single route-level file exists here (unlike ResolvedHead.file) — the
+          // route's first heading stands in as its attributed file (design
+          // 2026-08-08-pass-result-location-design.md). `route.headings.length === 0`
+          // already continued above, so `[0]` is always defined here.
+          location: route.headings[0].file,
           message: "Heading order",
           recommendation: recommendation6,
           docsUrl: docsUrl6
@@ -4139,6 +4186,9 @@ function kitModuleRule(opts) {
             severity,
             detection: PASS2,
             route: m.file,
+            // Uniform PASS-result attribution (design 2026-08-08-pass-result-location-design.md):
+            // same location a penalized result for this file would carry.
+            location: m.file,
             message: opts.label,
             recommendation: opts.recommendation,
             docsUrl: docsUrl12
@@ -4218,6 +4268,9 @@ function componentRule(opts) {
             severity,
             detection: PASS3,
             route: c.file,
+            // Uniform PASS-result attribution (design 2026-08-08-pass-result-location-design.md):
+            // same location a penalized result for this file would carry.
+            location: c.file,
             message: opts.label,
             recommendation: recommendation12,
             docsUrl: docsUrl12
@@ -4423,6 +4476,9 @@ function emitFile(out, file, issues, suppressions) {
       severity: "critical",
       detection: PASS4,
       route: file,
+      // Uniform PASS-result attribution (design 2026-08-08-pass-result-location-design.md):
+      // same location a penalized result for this file would carry.
+      location: file,
       message: LABEL,
       recommendation: RECOMMENDATION,
       docsUrl: DOCS_URL
@@ -4514,6 +4570,9 @@ function emitFile2(out, file, links, suppressions) {
       severity: "warning",
       detection: PASS5,
       route: file,
+      // Uniform PASS-result attribution (design 2026-08-08-pass-result-location-design.md):
+      // same location a penalized result for this file would carry.
+      location: file,
       message: LABEL2,
       recommendation: RECOMMENDATION2,
       docsUrl: DOCS_URL2
@@ -4581,6 +4640,9 @@ function emitFile3(out, file, issues, suppressions) {
       severity: "critical",
       detection: PASS6,
       route: file,
+      // Uniform PASS-result attribution (design 2026-08-08-pass-result-location-design.md):
+      // same location a penalized result for this file would carry.
+      location: file,
       message: LABEL3,
       recommendation: RECOMMENDATION3,
       docsUrl: DOCS_URL3
@@ -4859,6 +4921,11 @@ var architecturePrivateScopeImport = {
           severity: "info",
           detection: { presence: "own", value: "static" },
           route: c.file,
+          // Same location the penalized branch below uses (design
+          // 2026-08-08-pass-result-location-design.md) — this uncaught inline PASS literal
+          // was missed by the design spike's grep and added to its blast-radius table
+          // afterward (maintainer ruling, same date).
+          location: c.file,
           message: "No private-scope imports",
           recommendation: recommendation7,
           docsUrl: docsUrl7
@@ -5037,6 +5104,8 @@ var architectureUnitEntryFile = {
       ...Object.keys(mapOption(globalOptions, "pascalCaseUnits"))
     ]);
     const usedKeys = /* @__PURE__ */ new Set();
+    const examinedCounts = {};
+    for (const key of globalKeys) examinedCounts[key] = 0;
     const excludedDirs = [];
     const matchedSurviving = /* @__PURE__ */ new Set();
     for (const dir of [...dirs].sort()) {
@@ -5064,6 +5133,10 @@ var architectureUnitEntryFile = {
         ext = byCasing.best === void 0 ? void 0 : pascalUnits[byCasing.best];
       }
       if (ext === void 0) continue;
+      const winningKey = viaUnits ? byPath.best : byCasing.best;
+      if (winningKey !== void 0 && globalKeys.has(winningKey)) {
+        examinedCounts[winningKey] = (examinedCounts[winningKey] ?? 0) + 1;
+      }
       const expected = `${dir}/${baseName(dir)}${ext}`;
       if (fileSet.has(expected)) {
         out.push({
@@ -5113,6 +5186,7 @@ var architectureUnitEntryFile = {
         docsUrl: docsUrl8
       });
     }
+    ctx.recordExamined?.(examinedCounts);
     return out;
   }
 };
@@ -5186,6 +5260,8 @@ var architectureDirectoryNaming = {
     const globalOptions = resolveRuleOptions(ID5, OPTIONS4, ctx.config);
     const globalMap = mapOption(globalOptions, "directories");
     const globalKeys = new Set(Object.keys(globalMap));
+    const examinedCounts = {};
+    for (const key of globalKeys) examinedCounts[key] = 0;
     const usedKeys = /* @__PURE__ */ new Set();
     const excludedDirs = [];
     for (const dir of [...dirs].sort()) {
@@ -5203,6 +5279,7 @@ var architectureDirectoryNaming = {
       if (m.best === void 0) continue;
       const decoded = decodeSegment(baseName(dir));
       if (decoded === void 0) continue;
+      if (globalKeys.has(m.best)) examinedCounts[m.best] = (examinedCounts[m.best] ?? 0) + 1;
       const allowed = casingsOf(declared[m.best]).known;
       if (satisfiesCasing(decoded, allowed)) continue;
       const at = reportAt(dir, files);
@@ -5250,6 +5327,7 @@ var architectureDirectoryNaming = {
         docsUrl: docsUrl9
       });
     }
+    ctx.recordExamined?.(examinedCounts);
     return out;
   }
 };
@@ -5261,6 +5339,7 @@ var recommendation10 = "Use one of the names this location declares, or add the
 var OPTIONS5 = {
   scopes: { kind: "string-map", default: {} },
   unitScopes: { kind: "string-map", default: {} },
+  anyCaseUnitScopes: { kind: "string-map", default: {} },
   exclude: { kind: "string-list", default: [] }
 };
 function stem(file) {
@@ -5276,6 +5355,7 @@ function isAnyCaseUnitDir(dir, filesIn) {
   const own = filesIn.get(dir);
   return own !== void 0 && own.some((f) => stem(f) === name);
 }
+var PRIORITY = { scopes: 0, unitScopes: 1, anyCaseUnitScopes: 2 };
 var architectureReservedDirectoryNames = {
   id: ID6,
   title: "Reserved directory names",
@@ -5307,26 +5387,45 @@ var architectureReservedDirectoryNames = {
     const globalOptions = resolveRuleOptions(ID6, OPTIONS5, ctx.config);
     const globalScopes = mapOption(globalOptions, "scopes");
     const globalUnits = mapOption(globalOptions, "unitScopes");
-    const globalKeys = /* @__PURE__ */ new Set([...Object.keys(globalScopes), ...Object.keys(globalUnits)]);
+    const globalAnyUnits = mapOption(globalOptions, "anyCaseUnitScopes");
+    const globalKeys = /* @__PURE__ */ new Set([
+      ...Object.keys(globalScopes),
+      ...Object.keys(globalUnits),
+      ...Object.keys(globalAnyUnits)
+    ]);
     const usedKeys = /* @__PURE__ */ new Set();
     const excludedDirs = [];
     const nonUnitDirs = [];
-    const collisions = /* @__PURE__ */ new Set();
-    const noteCollisions = (scopesMap, unitMap) => {
+    const nonAnyUnitDirs = [];
+    const collisions = /* @__PURE__ */ new Map();
+    const collisionMessage = (losers) => {
+      const maps = ["scopes", ...losers];
+      const list = maps.length === 2 ? `both ${maps[0]} and ${maps[1]}` : maps.join(", ");
+      return `declared in ${list}, so the scopes entry wins wherever ${losers.length > 1 ? "they" : "both"} apply`;
+    };
+    const examinedCounts = {};
+    for (const key of globalKeys) examinedCounts[key] = 0;
+    const noteCollisions = (scopesMap, unitMap, anyUnitMap) => {
       for (const key of Object.keys(scopesMap)) {
-        if (!Object.hasOwn(unitMap, key)) continue;
         if (namesOf(scopesMap[key]).length === 0) continue;
-        if (namesOf(unitMap[key]).length === 0) continue;
-        collisions.add(key);
+        const losers = [];
+        if (Object.hasOwn(unitMap, key) && namesOf(unitMap[key]).length > 0) losers.push("unitScopes");
+        if (Object.hasOwn(anyUnitMap, key) && namesOf(anyUnitMap[key]).length > 0) {
+          losers.push("anyCaseUnitScopes");
+        }
+        if (losers.length > 0) collisions.set(key, collisionMessage(losers));
       }
     };
-    noteCollisions(globalScopes, globalUnits);
+    noteCollisions(globalScopes, globalUnits, globalAnyUnits);
     for (const dir of [...dirs].sort()) {
       const o = resolveRuleOptions(ID6, OPTIONS5, ctx.config, { route: dir, file: dir }, compiledOverrides);
       const scopes = mapOption(o, "scopes");
       const unitScopes = mapOption(o, "unitScopes");
-      if (Object.keys(scopes).length === 0 && Object.keys(unitScopes).length === 0) continue;
-      noteCollisions(scopes, unitScopes);
+      const anyCaseUnitScopes = mapOption(o, "anyCaseUnitScopes");
+      if (Object.keys(scopes).length === 0 && Object.keys(unitScopes).length === 0 && Object.keys(anyCaseUnitScopes).length === 0) {
+        continue;
+      }
+      noteCollisions(scopes, unitScopes, anyCaseUnitScopes);
       const excluded = compile(listOption(o, "exclude"));
       if (isExcluded(dir, ancestorDirs2(dir), excluded)) {
         excludedDirs.push(dir);
@@ -5334,22 +5433,46 @@ var architectureReservedDirectoryNames = {
       }
       const liveScopes = Object.keys(scopes).filter((k) => namesOf(scopes[k]).length > 0);
       const isUnit = isUnitDir(dir, filesIn);
+      const isAnyUnit = isAnyCaseUnitDir(dir, filesIn);
       const liveUnits = isUnit ? Object.keys(unitScopes).filter((k) => namesOf(unitScopes[k]).length > 0) : [];
+      const liveAnyUnits = isAnyUnit ? Object.keys(anyCaseUnitScopes).filter((k) => namesOf(anyCaseUnitScopes[k]).length > 0) : [];
       if (!isUnit) nonUnitDirs.push(dir);
+      if (!isAnyUnit) nonAnyUnitDirs.push(dir);
       const byPosition = matchKeys(dir, compile(liveScopes, true));
       const byUnit = matchKeys(dir, compile(liveUnits, true));
+      const byAnyUnit = matchKeys(dir, compile(liveAnyUnits, true));
       for (const k of byPosition.matched) if (globalKeys.has(k)) usedKeys.add(k);
       for (const k of byUnit.matched) if (globalKeys.has(k)) usedKeys.add(k);
-      let governing;
-      if (byPosition.best !== void 0 && byUnit.best !== void 0) {
-        governing = moreSpecificGlob(byUnit.best, byPosition.best) ? namesOf(unitScopes[byUnit.best]) : namesOf(scopes[byPosition.best]);
-      } else if (byPosition.best !== void 0) {
-        governing = namesOf(scopes[byPosition.best]);
-      } else if (byUnit.best !== void 0) {
-        governing = namesOf(unitScopes[byUnit.best]);
+      for (const k of byAnyUnit.matched) if (globalKeys.has(k)) usedKeys.add(k);
+      const candidates = [];
+      if (byPosition.best !== void 0) {
+        candidates.push({ kind: "scopes", best: byPosition.best, names: namesOf(scopes[byPosition.best]) });
+      }
+      if (byUnit.best !== void 0) {
+        candidates.push({
+          kind: "unitScopes",
+          best: byUnit.best,
+          names: namesOf(unitScopes[byUnit.best])
+        });
+      }
+      if (byAnyUnit.best !== void 0) {
+        candidates.push({
+          kind: "anyCaseUnitScopes",
+          best: byAnyUnit.best,
+          names: namesOf(anyCaseUnitScopes[byAnyUnit.best])
+        });
+      }
+      let winner;
+      for (const c of candidates) {
+        if (winner === void 0 || moreSpecificGlob(c.best, winner.best)) {
+          winner = c;
+        } else if (!moreSpecificGlob(winner.best, c.best) && PRIORITY[c.kind] < PRIORITY[winner.kind]) {
+          winner = c;
+        }
       }
-      if (governing === void 0) continue;
-      const allowed = new Set(governing);
+      if (winner === void 0) continue;
+      if (globalKeys.has(winner.best)) examinedCounts[winner.best] = (examinedCounts[winner.best] ?? 0) + 1;
+      const allowed = new Set(winner.names);
       for (const child of kids.get(dir) ?? []) {
         if (allowed.has(baseName(child))) continue;
         if (isExcluded(child, ancestorDirs2(child), excluded)) continue;
@@ -5370,7 +5493,7 @@ var architectureReservedDirectoryNames = {
           detection: { presence: "none", value: "absent" },
           route: child,
           location: at,
-          message: `${child} is not one of the names declared here: ${governing.join(", ")}.`,
+          message: `${child} is not one of the names declared here: ${winner.names.join(", ")}.`,
           recommendation: recommendation10,
           docsUrl: docsUrl10,
           fix: {
@@ -5380,19 +5503,24 @@ var architectureReservedDirectoryNames = {
       }
     }
     const notes = /* @__PURE__ */ new Map();
-    for (const key of collisions) {
-      notes.set(key, "declared in both scopes and unitScopes, so the scopes entry wins wherever both apply");
-    }
+    for (const [key, message] of collisions) notes.set(key, message);
     for (const key of globalKeys) {
       if (notes.has(key)) continue;
       const scopesEmpty = Object.hasOwn(globalScopes, key) && namesOf(globalScopes[key]).length === 0;
       const unitsEmpty = Object.hasOwn(globalUnits, key) && namesOf(globalUnits[key]).length === 0;
-      if (scopesEmpty || unitsEmpty) {
+      const anyUnitsEmpty = Object.hasOwn(globalAnyUnits, key) && namesOf(globalAnyUnits[key]).length === 0;
+      if (scopesEmpty || unitsEmpty || anyUnitsEmpty) {
         notes.set(key, "names no directory name at all");
       }
     }
     const unused = [...globalKeys].filter((k) => !notes.has(k) && !usedKeys.has(k));
-    const unitOnly = unused.filter((k) => Object.hasOwn(globalUnits, k) && !Object.hasOwn(globalScopes, k));
+    const anyUnitOnly = unused.filter((k) => Object.hasOwn(globalAnyUnits, k) && !Object.hasOwn(globalScopes, k));
+    for (const key of keysMatchingAny(anyUnitOnly, nonAnyUnitDirs, compile)) {
+      notes.set(key, "matched directories but never a unit of either case");
+    }
+    const unitOnly = unused.filter(
+      (k) => Object.hasOwn(globalUnits, k) && !Object.hasOwn(globalScopes, k) && !notes.has(k)
+    );
     for (const key of keysMatchingAny(unitOnly, nonUnitDirs, compile)) {
       notes.set(key, "matched directories but never a unit");
     }
@@ -5416,6 +5544,7 @@ var architectureReservedDirectoryNames = {
         docsUrl: docsUrl10
       });
     }
+    ctx.recordExamined?.(examinedCounts);
     return out;
   }
 };
@@ -6618,6 +6747,7 @@ body{background:var(--ground);color:var(--ink);font-family:var(--sans);line-heig
 .dv-cat-top{display:flex;justify-content:space-between;font-size:13px;margin-bottom:6px}
 .dv-bar{height:7px;border-radius:999px;background:var(--line);overflow:hidden}
 .dv-bar>i{display:block;height:100%;border-radius:999px}
+.dv-cat-reach{font-size:11.5px;color:var(--muted);margin-top:5px}
 .dv-filters{display:flex;gap:8px;flex-wrap:wrap;margin:16px 0}
 .dv-chip{font:inherit;font-size:12.5px;font-weight:600;cursor:pointer;background:var(--panel);border:1px solid var(--line-strong);color:var(--muted);padding:5px 12px;border-radius:999px}
 .dv-chip[aria-pressed="true"]{background:var(--active-bg);border-color:var(--active-bg);color:var(--active-ink)}
@@ -7090,12 +7220,21 @@ var APP_SCRIPT = `
       var band = scoreBand(c.score);
       var weight = s.report.weights[cat];
       var name = cat === 'seo' ? 'SEO' : cat.charAt(0).toUpperCase() + cat.slice(1);
+      // keys/affectedKeys are absent on hand-built snapshots (older fixtures, tests) \u2014
+      // render nothing rather than "undefined of undefined". 0 affected of N keys is still
+      // rendered: on a real project that's the signal a thin score can't give, that the
+      // category is clean project-wide and not just on the one key it happened to look at
+      // (design: 2026-08-05-score-floor-and-reach-design.md).
+      var reach = typeof c.keys === 'number' && c.keys > 0
+        ? h('div', { class: 'dv-cat-reach', text: c.affectedKeys + ' of ' + c.keys + ' keys affected' }, [])
+        : null;
       return h('div', { class: 'dv-cat' }, [
         h('div', { class: 'dv-cat-top' }, [
           h('span', { text: name + (weight !== undefined ? ' (weight ' + weight + ')' : '') }, []),
           h('span', { style: 'color:' + BAND_COLOR[band], text: String(c.score) }, [])
         ]),
-        h('div', { class: 'dv-bar' }, [h('i', { style: 'width:' + c.score + '%;background:' + BAND_COLOR[band] }, [])])
+        h('div', { class: 'dv-bar' }, [h('i', { style: 'width:' + c.score + '%;background:' + BAND_COLOR[band] }, [])]),
+        reach
       ]);
     });
     var chips = renderFilterChips(s.report.categories);
@@ -7202,13 +7341,10 @@ function renderAppShell(snapshot) {
   const title = snapshot.live ? "svelte-vitals dashboard" : "svelte-vitals report";
   return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>${title}</title><style>${APP_STYLE}</style></head><body><div class="dv-app" id="dv-app"><header class="dv-topbar" id="dv-topbar"></header><nav class="dv-sidebar" id="dv-sidebar"></nav><main class="dv-detail" id="dv-detail"></main></div><script type="application/json" id="svelte-vitals-data">${embedJson(safe)}</script><script>${APP_SCRIPT}</script></body></html>`;
 }
-function buildHtmlDocument(report, meta, opts) {
-  const badges = Object.fromEntries(
-    Object.entries(opts?.routeBadges ?? {}).filter(([, b]) => b === "measured" || b === "static")
-  );
+function buildHtmlDocument(report, meta) {
   return renderAppShell({
     report,
-    badges,
+    badges: {},
     analyzing: false,
     sequence: 0,
     live: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svelte-vitals/core",
-  "version": "0.37.0",
+  "version": "0.39.0",
   "description": "Shared, runtime-agnostic core for svelte-vitals (types, rule engine, scorer, reporter).",
   "type": "module",
   "license": "MIT",