svelte-vitals 0.48.1 → 0.50.0

package/dist/bin.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   runAnalyzeCliGunshi
-} from "./chunk-4LSRQXJ6.js";
+} from "./chunk-QKULNWQ5.js";
 import "./chunk-DZVXCUHG.js";
 import {
   realIO
 } from "./chunk-RSSMIHIM.js";
-import "./chunk-LJPABOWU.js";
+import "./chunk-PNHWRKRD.js";
 import "./chunk-WGFXFKBB.js";
 import {
   consoleIO
@@ -21,7 +21,7 @@ async function runCli(argv, io = consoleIO, env = process.env) {
   try {
     const locale = resolveLocale(env);
     if (argv[0] === "complete") {
-      const { runCompleteCliGunshi } = await import("./complete-IOAMJRBY.js");
+      const { runCompleteCliGunshi } = await import("./complete-5VANQTDN.js");
       return { code: await runCompleteCliGunshi(argv, io), exit: "natural" };
     }
     if (argv[0] === "docs") {
@@ -29,7 +29,7 @@ async function runCli(argv, io = consoleIO, env = process.env) {
       return { code: await runDocsCliGunshi(argv.slice(1), io, locale), exit: "natural" };
     }
     if (argv[0] === "explain") {
-      const { runExplainCliGunshi } = await import("./explain-WOKUZJVY.js");
+      const { runExplainCliGunshi } = await import("./explain-PRCEATL4.js");
       return { code: await runExplainCliGunshi(argv.slice(1), io, locale), exit: "natural" };
     }
     if (argv[0] === "install") {

package/dist/{chunk-ZAHTKEJ5.js → chunk-K363W33X.js}

@@ -26,7 +26,11 @@ function describeOptions(id, options) {
     "string-map": "merged over the default entries \u2014 a new key is added, a built-in key has its value overridden"
   };
   const lines = options.map((o) => {
-    const bounds = [o.min !== void 0 ? `>= ${o.min}` : "", o.max !== void 0 ? `<= ${o.max}` : ""].filter(Boolean).join(", ");
+    const bounds = [
+      o.min !== void 0 ? `>= ${o.min}` : "",
+      o.max !== void 0 ? `<= ${o.max}` : "",
+      o.pattern ? `each entry ${o.pattern}` : ""
+    ].filter(Boolean).join(", ");
     return `- ${o.name} (${o.kind}, default ${JSON.stringify(o.default)}${bounds ? `, ${bounds}` : ""}) \u2014 ${MERGE[o.kind]}`;
   });
   return `set in svelte-vitals.config.* as \`rules: { '${id}': { options: { \u2026 } } }\`, or per path in \`overrides\`:

package/dist/{chunk-LJPABOWU.js → chunk-PNHWRKRD.js}

@@ -34,12 +34,34 @@ import {
   selectRules,
   applyRuleSeverities,
   applyOverrides,
+  applyInlineDirectives,
+  unknownDirectiveIds,
   settingSeverity,
   withFailedRulesOff,
   formatFailedRuleWarning,
   terminalSafe
 } from "@svelte-vitals/core/internal";
 
+// src/a11y-skips.ts
+var ID_REF_RULE = "a11y/no-missing-id-ref";
+function buildIdRefSkips(a11y) {
+  return a11y.filter((r) => !r.fullyResolved).map((r) => ({ route: r.route, refs: r.idRefs.length, causes: r.unresolvedCauses ?? [] })).sort((a, b) => a.route.localeCompare(b.route));
+}
+var KIND_LABELS = [
+  ["component", "unresolved component"],
+  ["spread", "spread"],
+  ["html", "{@html}"],
+  ["dynamic-id", "dynamic id"]
+];
+function idRefSkipWarning(entries, analyzedRoutes) {
+  const parts = [];
+  for (const [kind, label] of KIND_LABELS) {
+    const n = entries.filter((e) => e.causes.some((c) => c.kind === kind)).length;
+    if (n > 0) parts.push(`${label} ${n}`);
+  }
+  return `${ID_REF_RULE} skipped ${entries.length} of ${analyzedRoutes} analyzed route(s) (${parts.join(", ")} \u2014 per-route detail in the JSON report's "skipped").`;
+}
+
 // src/runtime/node.ts
 import { readFile, access } from "fs/promises";
 import { join } from "path";
@@ -75,7 +97,9 @@ import {
   SITEMAP_SOURCE_PATHS,
   SVELTE_CONFIG_FILES,
   VITE_CONFIG_FILES,
+  collectSuppressions,
   findMinifyDisabled,
+  lineOf,
   resolveKitAliases,
   resolveKitPathsBase
 } from "@svelte-vitals/core/internal";
@@ -152,10 +176,28 @@ function detectHtmlLang(html) {
   const value = match[1] ?? match[2] ?? match[3] ?? "";
   return { presence: "own", value: value.trim().length > 0 ? "static" : "absent" };
 }
+function detectAppHtmlBodyTags(html) {
+  let markup = html.replace(/<!--[\s\S]*?-->/g, "").replace(/<script[\s\S]*?<\/script\s*>/gi, "").replace(/<style[\s\S]*?<\/style\s*>/gi, "");
+  const innermost = /<template\b[^>]*>(?:(?!<template\b)[\s\S])*?<\/template\s*>/gi;
+  for (let prev = ""; prev !== markup; ) {
+    prev = markup;
+    markup = markup.replace(innermost, "\0");
+  }
+  markup = markup.replaceAll("\0", "<template></template>");
+  const body = /<body\b[^>]*>([\s\S]*?)(?:<\/body\s*>|$)/i.exec(markup)?.[1];
+  if (body === void 0) return [];
+  return [...new Set([...body.matchAll(/<([a-zA-Z][a-zA-Z0-9-]*)\b/g)].map((m) => m[1].toLowerCase()))];
+}
 function detectAppHtmlIds(html) {
-  const markup = html.replace(/<!--[\s\S]*?-->/g, "").replace(/<script[\s\S]*?<\/script\s*>/gi, "").replace(/<style[\s\S]*?<\/style\s*>/gi, "");
+  const keepNewlines = (m) => m.replace(/[^\n]/g, "");
+  const markup = html.replace(/<!--[\s\S]*?-->/g, keepNewlines).replace(/<script[\s\S]*?<\/script\s*>/gi, keepNewlines).replace(/<style[\s\S]*?<\/style\s*>/gi, keepNewlines);
   const found = markup.matchAll(/(?<![\w-])id\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>{][^\s"'>]*))/gi);
-  return [...new Set([...found].map((m) => m[1] ?? m[2] ?? m[3] ?? "").filter(Boolean))];
+  const out = /* @__PURE__ */ new Map();
+  for (const m of found) {
+    const id = m[1] ?? m[2] ?? m[3] ?? "";
+    if (id && !out.has(id)) out.set(id, lineOf(markup, m.index));
+  }
+  return [...out].map(([id, line]) => ({ id, line }));
 }
 async function detectAppHtmlFacts(rt, cwd) {
   const appHtmlPath = rt.join(cwd, "src/app.html");
@@ -172,7 +214,8 @@ async function detectAppHtmlFacts(rt, cwd) {
     // [\s\S]*? is ambiguous across iterations and backtracks exponentially on a comment run
     // with no doctype (measured: ~45 leading comments hang the process).
     appHtmlDoctype: /^\s*<!doctype\s+html/i.test(content.replace(/<!--[\s\S]*?-->/g, "")),
-    appHtmlIds: detectAppHtmlIds(content)
+    appHtmlIds: detectAppHtmlIds(content),
+    appHtmlBodyTags: detectAppHtmlBodyTags(content)
   };
 }
 async function robotsRefsSitemap(rt, cwd) {
@@ -189,8 +232,9 @@ async function detectViteMinifyDisabled(rt, cwd) {
   const file = VITE_CONFIG_FILES[exists.indexOf(true)];
   if (!file) return void 0;
   try {
-    const hit = findMinifyDisabled(await rt.readFile(rt.join(cwd, file)));
-    return hit ? { file, line: hit.line } : void 0;
+    const source = await rt.readFile(rt.join(cwd, file));
+    const hit = findMinifyDisabled(source);
+    return hit ? { file, line: hit.line, suppressions: collectSuppressions(source) } : void 0;
   } catch {
     return void 0;
   }
@@ -243,7 +287,12 @@ import "@svelte-vitals/core";
 import {
   collectComponentFacts,
   collectKitModuleFacts,
-  collectSourceFiles
+  collectSourceFiles,
+  compileOverrides,
+  ROBOTS_SOURCE_PATHS as ROBOTS_SOURCE_PATHS2,
+  SITEMAP_SOURCE_PATHS as SITEMAP_SOURCE_PATHS2,
+  SVELTE_CONFIG_FILES as SVELTE_CONFIG_FILES2,
+  VITE_CONFIG_FILES as VITE_CONFIG_FILES2
 } from "@svelte-vitals/core/internal";
 
 // src/providers/source/routes.ts
@@ -387,10 +436,11 @@ function findAdapter(info) {
 
 // src/providers/source/parse.ts
 import {
+  collectSuppressions as collectSuppressions2,
   stripTextDirective,
   parseSvelte,
   CHILD_NODE_KEYS,
-  lineOf,
+  lineOf as lineOf2,
   findAttr as findAttr3,
   valueFromNodes,
   textFromNodes,
@@ -568,7 +618,7 @@ function collectImages(node, source, acc) {
       // A literal loading="lazy" only — a spread or dynamic loading={…} must not be flagged.
       lazy: attrText(attrs, "loading") === "lazy",
       hasSrcset: hasSpread || Boolean(findAttr3(attrs, "srcset")),
-      line: lineOf(source, node.start)
+      line: lineOf2(source, node.start)
     });
   }
   for (const key of CHILD_NODE_KEYS) {
@@ -583,7 +633,7 @@ function collectHeadings(node, source, acc) {
   if (!node || typeof node !== "object") return;
   if (node.type === "SvelteHead") return;
   if (node.type === "RegularElement" && /^h[1-6]$/.test(node.name)) {
-    acc.push({ level: Number(node.name[1]), line: lineOf(source, node.start) });
+    acc.push({ level: Number(node.name[1]), line: lineOf2(source, node.start) });
   }
   for (const key of CHILD_NODE_KEYS) {
     if (key in node) collectHeadings(childOf(node, key), source, acc);
@@ -604,16 +654,18 @@ function collectA11y(fragment, source) {
   const nodes = [];
   let groups = 0;
   let slotInLandmark;
-  let unknowableContent = false;
+  const unknowable = [];
+  const elementTags = /* @__PURE__ */ new Set();
+  let elementsUnknowable = false;
   const emit = (ctx, node) => {
     const inLandmark = ctx.landmarks.at(-1);
     nodes.push({ ...node, repeatable: ctx.repeatable, path: ctx.path, ...inLandmark ? { inLandmark } : {} });
   };
   const noteSpread = (node) => {
     const attributes = node.attributes;
-    if (Array.isArray(attributes) && attributes.some((a) => a.type === "SpreadAttribute")) {
-      unknowableContent = true;
-    }
+    if (!Array.isArray(attributes)) return;
+    const spread = attributes.find((a) => a.type === "SpreadAttribute");
+    if (spread) unknowable.push({ kind: "spread", line: lineOf2(source, spread.start) });
   };
   const walk = (node, ctx) => {
     if (Array.isArray(node)) {
@@ -626,7 +678,8 @@ function collectA11y(fragment, source) {
         return;
       // head content never renders into the body
       case "HtmlTag":
-        unknowableContent = true;
+        unknowable.push({ kind: "html", line: lineOf2(source, node.start) });
+        elementsUnknowable = true;
         return;
       case "IfBlock":
         walkIfChain(node, ctx, groups++, 0);
@@ -649,13 +702,15 @@ function collectA11y(fragment, source) {
       // attributes are real — dropping them would make no-missing-id-ref report phantom misses.
       case "RegularElement":
       case "SvelteElement":
+        if (node.type === "SvelteElement") elementsUnknowable = true;
+        else elementTags.add(node.name.toLowerCase());
         walkElement(node, ctx);
         return;
       case "Component":
       case "SvelteComponent":
       case "SvelteSelf":
         noteSpread(node);
-        emit(ctx, { kind: "component", key: node.name, line: lineOf(source, node.start) });
+        emit(ctx, { kind: "component", key: node.name, line: lineOf2(source, node.start) });
         walk(node.fragment, { ...ctx, elementDepth: ctx.elementDepth + 1 });
         return;
       case "SlotElement":
@@ -683,7 +738,7 @@ function collectA11y(fragment, source) {
   };
   const walkElement = (node, ctx) => {
     noteSpread(node);
-    const line = lineOf(source, node.start);
+    const line = lineOf2(source, node.start);
     const attrs = node.attributes;
     const roleAttr = findAttr3(attrs, "role");
     const role = roleAttr ? splitTokens(attrTextOf3(roleAttr))[0] : void 0;
@@ -728,7 +783,13 @@ function collectA11y(fragment, source) {
     });
   };
   walk(fragment, { path: [], repeatable: false, landmarks: [], elementDepth: 0, asideDemoting: 0 });
-  return { nodes, ...slotInLandmark ? { slotInLandmark } : {}, unknowableContent };
+  return {
+    nodes,
+    ...slotInLandmark ? { slotInLandmark } : {},
+    unknowable,
+    elementTags: [...elementTags],
+    elementsUnknowable
+  };
 }
 function isChildrenRender(node) {
   const call = node.expression.type === "ChainExpression" ? node.expression.expression : node.expression;
@@ -750,7 +811,8 @@ function parseFile(source, filename) {
     imports: collectImports(ast),
     images,
     headings,
-    a11y: collectA11y(ast.fragment, source)
+    a11y: collectA11y(ast.fragment, source),
+    suppressions: collectSuppressions2(source)
   };
 }
 
@@ -915,12 +977,25 @@ function groupSpan(nodes) {
   }
   return max + 1;
 }
+function dedupeCauses(causes) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const c of causes) {
+    const key = `${c.kind}::${c.file}::${c.detail ?? ""}`;
+    if (!seen.has(key)) seen.set(key, c);
+  }
+  return [...seen.values()];
+}
 function offsetPath(path, base) {
   return base === 0 ? path : path.map((step) => ({ group: step.group + base, branch: step.branch }));
 }
 async function composeA11y(ctx, fileRel, parsed, depth, visited, chain) {
   const { rt, cwd, state } = ctx;
-  if (parsed.a11y.unknowableContent) state.fullyResolved = false;
+  if (parsed.a11y.unknowable.length > 0) {
+    state.fullyResolved = false;
+    for (const u of parsed.a11y.unknowable) state.causes.push({ ...u, file: fileRel });
+  }
+  for (const t of parsed.a11y.elementTags) state.elementTags.add(t);
+  if (parsed.a11y.elementsUnknowable) state.elementsClosed = false;
   const base = state.nextGroup;
   state.nextGroup += groupSpan(parsed.a11y.nodes);
   const composed = [];
@@ -934,6 +1009,8 @@ async function composeA11y(ctx, fileRel, parsed, depth, visited, chain) {
     const childRel = info ? resolveComponentPath(info.source, fileRel, ctx.aliases) : void 0;
     if (!childRel || depth <= 0 || visited.has(childRel) || !await rt.exists(rt.join(cwd, childRel))) {
       state.fullyResolved = false;
+      state.causes.push({ kind: "component", detail: node.key, file: fileRel, line: node.line });
+      state.elementsClosed = false;
       continue;
     }
     const childParsed = await readAndParse(rt, cwd, childRel, ctx.cache);
@@ -963,7 +1040,7 @@ function representatives(nodes, chainOrder) {
     [...folded].map(([key, list]) => [key, list.sort(order).map(({ file, line }) => ({ file, line }))])
   );
 }
-async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases, appHtmlIds) {
+async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases, appHtmlIds, appHtmlBodyTags) {
   const files = chainFiles(pageRel, layouts);
   const chainOrder = new Map(files.map((f, i) => [f.rel, i]));
   const composed = /* @__PURE__ */ new Map();
@@ -973,7 +1050,20 @@ async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases, a
   const images = [];
   const headings = [];
   const componentHeadings = [];
-  const a11yCtx = { rt, cwd, config, cache, aliases, state: { nextGroup: 0, fullyResolved: true } };
+  const a11yCtx = {
+    rt,
+    cwd,
+    config,
+    cache,
+    aliases,
+    state: {
+      nextGroup: 0,
+      fullyResolved: true,
+      causes: [],
+      elementTags: new Set(appHtmlBodyTags ?? []),
+      elementsClosed: true
+    }
+  };
   const a11yNodes = [];
   const nestedLandmarks = [];
   let slotLandmark;
@@ -1014,8 +1104,20 @@ async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases, a
     }
   }
   const idNodes = a11yNodes.filter((n) => n.kind === "id");
-  if (idNodes.some((n) => n.key === "")) a11yCtx.state.fullyResolved = false;
+  for (const n of idNodes) {
+    if (n.key !== "") continue;
+    a11yCtx.state.fullyResolved = false;
+    a11yCtx.state.causes.push({ kind: "dynamic-id", file: n.file, line: n.line });
+  }
   const literalIds = idNodes.filter((n) => n.key !== "");
+  const ids = representatives(literalIds, chainOrder);
+  if (appHtmlIds) {
+    const shell = new Map(appHtmlIds.map((s) => [s.id, s.line]));
+    for (const key of Object.keys(ids)) {
+      const line = shell.get(key);
+      if (line !== void 0) ids[key] = [{ file: "src/app.html", line }, ...ids[key]];
+    }
+  }
   const route = deriveRoute(pageRel);
   return {
     head: { route, source: "static", tags: [...composed.values(), ...additiveTags], file: pageRel },
@@ -1028,19 +1130,23 @@ async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases, a
         chainOrder
       ),
       nestedLandmarks,
-      ids: representatives(literalIds, chainOrder),
+      ids,
       // `href="#top"` scrolls to the document top with no element of that id, so it is
       // never a missing reference (HTML's "top of the document" fragment).
       idRefs: a11yNodes.filter((n) => n.kind === "idref" && !(n.attr === "href" && isTopFragment(n.key))).map((n) => ({ id: n.key, attr: n.attr ?? "", file: n.file, line: n.line })),
-      idCandidates: [.../* @__PURE__ */ new Set([...literalIds.map((n) => n.key), ...appHtmlIds ?? []])],
-      fullyResolved: a11yCtx.state.fullyResolved
+      idCandidates: [.../* @__PURE__ */ new Set([...literalIds.map((n) => n.key), ...(appHtmlIds ?? []).map((s) => s.id)])],
+      fullyResolved: a11yCtx.state.fullyResolved,
+      ...a11yCtx.state.causes.length > 0 ? { unresolvedCauses: dedupeCauses(a11yCtx.state.causes) } : {},
+      elementTags: [...a11yCtx.state.elementTags],
+      elementsClosed: a11yCtx.state.elementsClosed,
+      file: pageRel
     }
   };
 }
-async function collectRoutes(rt, cwd, config = defaultConfig, cache = /* @__PURE__ */ new Map(), aliases, appHtmlIds) {
+async function collectRoutes(rt, cwd, config = defaultConfig, cache = /* @__PURE__ */ new Map(), aliases, appHtmlIds, appHtmlBodyTags) {
   const [pages, layouts] = await Promise.all([enumerateRoutePages(rt, cwd), collectLayouts(rt, cwd)]);
   const facts = await Promise.all(
-    pages.map((page) => resolveRoute(rt, cwd, page, config, layouts, cache, aliases, appHtmlIds))
+    pages.map((page) => resolveRoute(rt, cwd, page, config, layouts, cache, aliases, appHtmlIds, appHtmlBodyTags))
   );
   return {
     heads: facts.map((f) => f.head),
@@ -1059,11 +1165,15 @@ function routeMatcher(glob) {
 }
 
 // src/collect-all.ts
+function globList(globs) {
+  return globs === void 0 ? [] : Array.isArray(globs) ? globs : [globs];
+}
 async function collectAll(rt, cwd, config, opts = {}) {
   const matches = routeMatcher(opts.route);
+  const parseCache = opts.parseCache ?? /* @__PURE__ */ new Map();
   const project = await collectProjectFacts(rt, cwd);
   const [collected, components, kitModules, sourceFiles] = await Promise.all([
-    collectRoutes(rt, cwd, config, opts.parseCache, project.kitAliases, project.appHtmlIds),
+    collectRoutes(rt, cwd, config, parseCache, project.kitAliases, project.appHtmlIds, project.appHtmlBodyTags),
     // Component (Correctness) facts are file-scoped with no route attribution yet, so a
     // route-filtered run skips them rather than reporting unrelated components (#68 review);
     // kitModules is skipped for the same reason.
@@ -1079,7 +1189,45 @@ async function collectAll(rt, cwd, config, opts = {}) {
   const images = collected.images.filter((i) => matches(i.route));
   const headings = collected.headings.filter((h) => matches(h.route));
   const a11y = collected.a11y.filter((a) => matches(a.route));
-  return { heads, images, headings, a11y, project, components, kitModules, sourceFiles };
+  const directives = /* @__PURE__ */ new Map();
+  for (const [file, parsed] of parseCache) {
+    const suppressions = await parsed.then(
+      (parsedFile) => parsedFile.suppressions,
+      () => void 0
+    );
+    if (suppressions) directives.set(file, suppressions);
+  }
+  for (const c of components) directives.set(c.file, c.suppressions ?? []);
+  for (const m of kitModules) directives.set(m.file, m.suppressions ?? []);
+  const viteConfig = project.viteMinifyDisabled;
+  if (viteConfig?.file) directives.set(viteConfig.file, viteConfig.suppressions ?? []);
+  const routes = collected.heads.map((h) => h.route);
+  const emptySelections = [];
+  if (opts.route !== void 0 && routes.length > 0 && !routes.some(matches))
+    emptySelections.push(`--route '${opts.route}' matched none of the ${routes.length} route(s) found.`);
+  if (opts.route === void 0 && routes.length > 0) {
+    const attributable = [
+      ...directives.keys(),
+      ...ROBOTS_SOURCE_PATHS2,
+      ...SITEMAP_SOURCE_PATHS2,
+      ...VITE_CONFIG_FILES2,
+      ...SVELTE_CONFIG_FILES2
+    ];
+    const entries = config.overrides ?? [];
+    const compiled = compileOverrides(config);
+    entries.forEach((entry, i) => {
+      globList(entry.route).forEach((glob) => {
+        if (!routes.some(routeMatcher(glob)))
+          emptySelections.push(`overrides entry for route '${glob}' matched no route.`);
+      });
+      globList(entry.files).forEach((glob, j) => {
+        const pattern = compiled[i]?.files[j];
+        if (pattern && !attributable.some((f) => pattern.test(f)))
+          emptySelections.push(`overrides entry for files '${glob}' matched no file.`);
+      });
+    });
+  }
+  return { heads, images, headings, a11y, project, components, kitModules, sourceFiles, directives, emptySelections };
 }
 
 // src/changed-files.ts
@@ -1520,6 +1668,11 @@ function resolveRuleSelection(input) {
         else out[id] = rest;
       }
     }
+    for (const id of allowed) {
+      if (out[id] !== void 0) continue;
+      const rule = allRules.find((r) => r.id === id);
+      if (rule?.defaultOff) out[id] = rule.severity;
+    }
   }
   for (const id of input.ignoreRules ?? []) out[id] = "off";
   return out;
@@ -1580,17 +1733,23 @@ async function analyzeProject(opts = {}) {
     ...await checkVersionFloor(rt, cwd),
     ...overridesOffWarnings(opts.allowRules, config.overrides)
   ];
-  const { heads, images, headings, a11y, project, components, kitModules, sourceFiles } = await collectAll(
-    rt,
-    cwd,
-    config,
-    {
-      route: opts.route,
-      parseCache: opts.parseCache
-    }
-  );
+  const { heads, images, headings, a11y, project, components, kitModules, sourceFiles, directives, emptySelections } = await collectAll(rt, cwd, config, {
+    route: opts.route,
+    parseCache: opts.parseCache
+  });
+  warnings.push(...emptySelections);
+  if (opts.route === void 0) warnings.push(...unknownDirectiveIds(directives, allRules2));
   const selected = selectRules(allRules2, config);
   const rules = opts.categories ? selected.filter((r) => opts.categories.includes(r.category)) : selected;
+  const idRefSkips = rules.some((r) => r.id === ID_REF_RULE) ? buildIdRefSkips(a11y) : [];
+  if (idRefSkips.length > 0) warnings.push(idRefSkipWarning(idRefSkips, a11y.length));
+  if (opts.route !== void 0 && opts.allowRules?.length) {
+    const starved = rules.filter((r) => opts.allowRules.includes(r.id) && r.scope !== "route").map((r) => r.id);
+    if (starved.length > 0)
+      warnings.push(
+        `--rules ${starved.map((id) => `'${id}'`).join(", ")} examined nothing: --route collects route facts only.`
+      );
+  }
   const {
     results: rawResults,
     examined,
@@ -1606,7 +1765,12 @@ async function analyzeProject(opts = {}) {
     kitModules,
     sourceFiles
   });
-  const results = applyOverrides(applyRuleSeverities(rawResults, config), config);
+  const results = applyInlineDirectives(
+    applyOverrides(applyRuleSeverities(rawResults, config), config),
+    directives,
+    rules,
+    config
+  );
   const failedRuleIds = failedRules.map((f) => f.id);
   const scoringConfig = withFailedRulesOff(config, failedRuleIds);
   return {
@@ -1615,6 +1779,7 @@ async function analyzeProject(opts = {}) {
     version: readPackageVersion(),
     ruleIds: rules.map((r) => r.id),
     examined,
+    ...idRefSkips.length > 0 ? { skipped: { [ID_REF_RULE]: idRefSkips } } : {},
     failedRuleIds,
     warnings: [...warnings, ...skippedFileWarnings([...components, ...kitModules]), ...failedRuleWarnings(failedRules)],
     loadedConfig: loaded
@@ -1805,7 +1970,7 @@ async function run(opts = {}) {
         );
       }
       if (reporter === "json") {
-        log(formatJsonReport(results, config, { version }, analysis.ruleIds, analysis.examined));
+        log(formatJsonReport(results, config, { version }, analysis.ruleIds, analysis.examined, analysis.skipped));
       } else if (reporter === "agent") {
         log(formatAgentReport(results, config));
       } else if (reporter === "sarif") {

package/dist/{chunk-4LSRQXJ6.js → chunk-QKULNWQ5.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-RSSMIHIM.js";
 import {
   run
-} from "./chunk-LJPABOWU.js";
+} from "./chunk-PNHWRKRD.js";
 import {
   readCoreVersion,
   readPackageVersion

package/dist/{complete-IOAMJRBY.js → complete-5VANQTDN.js}

@@ -8,14 +8,14 @@ import {
 import "./chunk-CTMKTFST.js";
 import {
   ROOT_ARGS
-} from "./chunk-4LSRQXJ6.js";
+} from "./chunk-QKULNWQ5.js";
 import {
   CATEGORIES,
   FAIL_ON_VALUES,
   TREAT_DYNAMIC_AS_VALUES
 } from "./chunk-DZVXCUHG.js";
 import "./chunk-RSSMIHIM.js";
-import "./chunk-LJPABOWU.js";
+import "./chunk-PNHWRKRD.js";
 import {
   REPORTER_NAMES
 } from "./chunk-WGFXFKBB.js";
@@ -27,7 +27,7 @@ import {
 } from "./chunk-72ZLERW3.js";
 import {
   EXPLAIN_ARGS
-} from "./chunk-ZAHTKEJ5.js";
+} from "./chunk-K363W33X.js";
 import {
   consoleIO
 } from "./chunk-SLUMRYUD.js";

package/dist/{explain-WOKUZJVY.js → explain-PRCEATL4.js}

@@ -1,7 +1,7 @@
 import {
   EXPLAIN_ARGS,
   runExplainCliGunshi
-} from "./chunk-ZAHTKEJ5.js";
+} from "./chunk-K363W33X.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-NMVBVKLX.js";
 import "./chunk-AI24FJ5Q.js";

package/dist/gunshi-registry.js

@@ -4,10 +4,10 @@ import {
 import "./chunk-CTMKTFST.js";
 import {
   ROOT_ARGS
-} from "./chunk-4LSRQXJ6.js";
+} from "./chunk-QKULNWQ5.js";
 import "./chunk-DZVXCUHG.js";
 import "./chunk-RSSMIHIM.js";
-import "./chunk-LJPABOWU.js";
+import "./chunk-PNHWRKRD.js";
 import "./chunk-WGFXFKBB.js";
 import "./chunk-MLIODPHZ.js";
 import {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { Config, Severity, RuleSetting, Category, Result } from '@svelte-vitals/core';
+import { Config, Severity, RuleSetting, Category, Result, JsonReport } from '@svelte-vitals/core';
 export { defineConfig } from '@svelte-vitals/core';
 import { AST } from 'svelte/compiler';
-import { HeadTag, BranchStep, RuleOptionsSpec } from '@svelte-vitals/core/internal';
+import { HeadTag, BranchStep, SuppressionDirective, RuleOptionsSpec } from '@svelte-vitals/core/internal';
 
 /** A resolved import binding: which module, and which export ('default' for default imports). */
 interface ImportInfo {
@@ -56,8 +56,15 @@ interface ParsedA11y {
     nodes: A11yNode[];
     /** landmark ancestor of this file's <slot>/{@render children()} position, if any */
     slotInLandmark?: string;
-    /** file contains {@html} or a spread attribute — poisons the closed world for no-missing-id-ref */
-    unknowableContent: boolean;
+    /** {@html} tags and spread attributes, located — each poisons the closed world for no-missing-id-ref */
+    unknowable: {
+        kind: 'spread' | 'html';
+        line: number;
+    }[];
+    /** Distinct lowercased tag names of the body's `RegularElement`s (a11y/required-element's presence set). */
+    elementTags: string[];
+    /** file contains `{@html}` or a `<svelte:element>` — either can render an element the walk cannot see */
+    elementsUnknowable: boolean;
 }
 interface ParsedFile {
     headTags: ParsedTag[];
@@ -66,6 +73,10 @@ interface ParsedFile {
     images: ParsedImage[];
     headings: ParsedHeading[];
     a11y: ParsedA11y;
+    /** Inline `svelte-vitals-disable-next-line` directives in this file, for the central
+     *  suppression pass. Collected here because a route-scoped finding can be located in any file
+     *  the composition reads, including ones no component-fact collection visited (`--route`). */
+    suppressions: SuppressionDirective[];
 }
 
 /**
@@ -268,9 +279,11 @@ interface AnalyzeResult {
     ruleIds: string[];
     /** Per-rule, per-declaration counts of places examined, unfiltered by `--diff`/`--baseline`/suppressions. */
     examined: Record<string, Record<string, number>>;
+    /** Routes a closed-world rule skipped, keyed by rule id — the analysis-side companion to `examined`; unfiltered by `--diff`/`--baseline`/suppressions. Absent when no analyzed route was skipped or the rule was not selected. */
+    skipped?: JsonReport['skipped'];
     /** Ids of rules `runRules` caught throwing — already folded into `config` via `withFailedRulesOff`; exposed separately so a caller with its own base config (the vite dev dashboard) can apply the same correction without adopting this call's `config`. */
     failedRuleIds: string[];
-    /** Non-fatal issues surfaced during analysis: config-file problems (unknown top-level keys, invalid enum values), version-floor notices, `--rules`/overrides conflicts, and skipped-file notices. Empty when none apply. */
+    /** Non-fatal issues surfaced during analysis: config-file problems (unknown top-level keys, invalid enum values), version-floor notices, `--rules`/overrides conflicts, closed-world skip notices (`a11y/no-missing-id-ref`), and skipped-file notices. Empty when none apply. */
     warnings: string[];
     /**
      * This analysis's config-file load result (`undefined` when no config file exists at its

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   routeMatcher,
   run,
   spinnerEnabled
-} from "./chunk-LJPABOWU.js";
+} from "./chunk-PNHWRKRD.js";
 import {
   CONFIG_FILENAMES,
   loadConfigFile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-vitals",
-  "version": "0.48.1",
+  "version": "0.50.0",
   "description": "A deterministic SvelteKit code-health scanner (SEO, performance, correctness, security, architecture, accessibility).",
   "type": "module",
   "license": "MIT",
@@ -52,7 +52,7 @@
     "magicast": "^0.5.4",
     "svelte": "^5.56.9",
     "tinyglobby": "^0.2.17",
-    "@svelte-vitals/core": "0.45.0"
+    "@svelte-vitals/core": "0.47.0"
   },
   "devDependencies": {
     "@gunshi/docs": "0.37.1",