svelte-vitals 0.45.1 → 0.47.0

package/README.md

@@ -4,7 +4,7 @@
 [![MIT](https://img.shields.io/npm/l/svelte-vitals)](https://opensource.org/licenses/MIT)
 
 > **A static SvelteKit code-health scanner — not a runtime Web Vitals reporter.**
-> Diagnose your project's SEO, Performance, Correctness, Security, and Architecture health by statically analyzing your source code, before it ships. No browser, no build server, no headless Chrome.
+> Diagnose your project's SEO, Performance, Correctness, Security, Architecture, and Accessibility health by statically analyzing your source code, before it ships. No browser, no build server, no headless Chrome.
 >
 > **ESM-only** (Node 22.13+). Ships ES modules only; `require()` is unsupported by design.
 

package/dist/bin.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   runAnalyzeCliGunshi
-} from "./chunk-P4YNVJUO.js";
-import "./chunk-VNVRHWO3.js";
-import "./chunk-MUIOPL5F.js";
+} from "./chunk-MZO3HVTN.js";
+import "./chunk-5UQ6P2M2.js";
+import "./chunk-43FGGQQZ.js";
 import "./chunk-M5KM5SV7.js";
 import {
   consoleIO
@@ -18,29 +18,34 @@ import {
 
 // src/cli.ts
 async function runCli(argv, io = consoleIO, env = process.env) {
-  const locale = resolveLocale(env);
-  if (argv[0] === "complete") {
-    const { runCompleteCliGunshi } = await import("./complete-HGLO72TI.js");
-    return { code: await runCompleteCliGunshi(argv, io), exit: "natural" };
+  try {
+    const locale = resolveLocale(env);
+    if (argv[0] === "complete") {
+      const { runCompleteCliGunshi } = await import("./complete-BDKGAUQX.js");
+      return { code: await runCompleteCliGunshi(argv, io), exit: "natural" };
+    }
+    if (argv[0] === "docs") {
+      const { runDocsCliGunshi } = await import("./docs-XNKZQBBZ.js");
+      return { code: await runDocsCliGunshi(argv.slice(1), io, locale), exit: "natural" };
+    }
+    if (argv[0] === "explain") {
+      const { runExplainCliGunshi } = await import("./explain-YPWGQE5N.js");
+      return { code: await runExplainCliGunshi(argv.slice(1), io, locale), exit: "natural" };
+    }
+    if (argv[0] === "install") {
+      const { runInstallCliGunshi } = await import("./install-HE76S4ID.js");
+      return { code: await runInstallCliGunshi(argv.slice(1), io, locale), exit: "immediate" };
+    }
+    if (argv[0] === "ci") {
+      const { runCiCliGunshi } = await import("./ci-J7PGFHK3.js");
+      const code = await runCiCliGunshi(argv.slice(1), { ...realIO(), log: io.log, errorLog: io.errorLog }, locale);
+      return { code, exit: "immediate" };
+    }
+    return await runAnalyzeCliGunshi(argv, io, locale);
+  } catch (err) {
+    io.errorLog(`svelte-vitals: ${err instanceof Error ? err.message : String(err)}`);
+    return { code: 2, exit: "natural" };
   }
-  if (argv[0] === "docs") {
-    const { runDocsCliGunshi } = await import("./docs-CRZC47P7.js");
-    return { code: await runDocsCliGunshi(argv.slice(1), io, locale), exit: "natural" };
-  }
-  if (argv[0] === "explain") {
-    const { runExplainCliGunshi } = await import("./explain-52QDQUOY.js");
-    return { code: await runExplainCliGunshi(argv.slice(1), io, locale), exit: "natural" };
-  }
-  if (argv[0] === "install") {
-    const { runInstallCliGunshi } = await import("./install-3FI7M5BM.js");
-    return { code: await runInstallCliGunshi(argv.slice(1), io, locale), exit: "immediate" };
-  }
-  if (argv[0] === "ci") {
-    const { runCiCliGunshi } = await import("./ci-CLKU3TR6.js");
-    const code = await runCiCliGunshi(argv.slice(1), { ...realIO(), log: io.log, errorLog: io.errorLog }, locale);
-    return { code, exit: "immediate" };
-  }
-  return runAnalyzeCliGunshi(argv, io, locale);
 }
 
 // src/bin.ts
@@ -52,4 +57,7 @@ async function main() {
     process.exitCode = code;
   }
 }
-void main();
+main().catch((err) => {
+  console.error(`svelte-vitals: ${err instanceof Error ? err.message : String(err)}`);
+  process.exit(2);
+});

package/dist/{chunk-MUIOPL5F.js → chunk-43FGGQQZ.js}

@@ -8,7 +8,7 @@ import {
 
 // src/resolve-args.ts
 import { parseArgs } from "util";
-var CATEGORIES = ["seo", "performance", "correctness", "security", "architecture"];
+var CATEGORIES = ["seo", "performance", "correctness", "security", "architecture", "a11y"];
 var FAIL_ON_VALUES = ["critical", "warning", "info"];
 function isFailOnValue(value) {
   return typeof value === "string" && FAIL_ON_VALUES.includes(value);

package/dist/{chunk-VNVRHWO3.js → chunk-5UQ6P2M2.js}

@@ -32,7 +32,9 @@ import {
   applyRuleSeverities,
   applyOverrides,
   settingSeverity,
-  withFailedRulesOff
+  withFailedRulesOff,
+  formatFailedRuleWarning,
+  terminalSafe
 } from "@svelte-vitals/core";
 
 // src/runtime/node.ts
@@ -144,10 +146,28 @@ function detectHtmlLang(html) {
   const value = match[1] ?? match[2] ?? match[3] ?? "";
   return { presence: "own", value: value.trim().length > 0 ? "static" : "absent" };
 }
-async function detectAppHtmlLang(rt, cwd) {
+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 found = markup.matchAll(/(?<![\w-])id\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>{][^\s"'>]*))/gi);
+  return [...new Set([...found].map((m) => m[1] ?? m[2] ?? m[3] ?? "").filter(Boolean))];
+}
+async function detectAppHtmlFacts(rt, cwd) {
   const appHtmlPath = rt.join(cwd, "src/app.html");
-  if (!await rt.exists(appHtmlPath)) return { presence: "none", value: "absent" };
-  return detectHtmlLang(await rt.readFile(appHtmlPath));
+  if (!await rt.exists(appHtmlPath)) return { htmlLang: { presence: "none", value: "absent" } };
+  let content;
+  try {
+    content = await rt.readFile(appHtmlPath);
+  } catch {
+    return { htmlLang: { presence: "none", value: "absent" } };
+  }
+  return {
+    htmlLang: detectHtmlLang(content),
+    // Comments are stripped first, then a simple anchored match — a starred group over a lazy
+    // [\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)
+  };
 }
 async function robotsRefsSitemap(rt, cwd) {
   const p = rt.join(cwd, "static/robots.txt");
@@ -194,10 +214,10 @@ async function detectKitConfigFacts(rt, cwd) {
   };
 }
 async function collectProjectFacts(rt, cwd) {
-  const [hasRobotsTxt, hasSitemap, htmlLang, viteMinifyDisabled, kitConfig] = await Promise.all([
+  const [hasRobotsTxt, hasSitemap, appHtmlFacts, viteMinifyDisabled, kitConfig] = await Promise.all([
     existsAny(rt, cwd, ROBOTS_SOURCE_PATHS),
     existsAny(rt, cwd, SITEMAP_SOURCE_PATHS),
-    detectAppHtmlLang(rt, cwd),
+    detectAppHtmlFacts(rt, cwd),
     detectViteMinifyDisabled(rt, cwd),
     detectKitConfigFacts(rt, cwd)
   ]);
@@ -205,7 +225,7 @@ async function collectProjectFacts(rt, cwd) {
   return {
     hasRobotsTxt,
     hasSitemap,
-    htmlLang,
+    ...appHtmlFacts,
     ...robotsReferencesSitemap !== void 0 ? { robotsReferencesSitemap } : {},
     ...viteMinifyDisabled ? { viteMinifyDisabled } : {},
     ...kitConfig
@@ -220,7 +240,7 @@ import {
 } from "@svelte-vitals/core";
 
 // src/providers/source/routes.ts
-import { defaultConfig } from "@svelte-vitals/core";
+import { defaultConfig, foldOccurrences, isTopFragment } from "@svelte-vitals/core";
 
 // src/providers/source/resolve.ts
 import { resolveRepoLocalPath } from "@svelte-vitals/core";
@@ -367,7 +387,13 @@ import {
   valueFromNodes,
   textFromNodes,
   attrText,
-  attrValue
+  attrTextOf as attrTextOf3,
+  attrValue,
+  attrValueOf as attrValueOf3,
+  decodeFragmentId,
+  splitTokens,
+  LANDMARK_ROLES,
+  IDREF_ATTRS
 } from "@svelte-vitals/core";
 
 // src/providers/source/imports.ts
@@ -555,6 +581,137 @@ function collectHeadings(node, source, acc) {
     if (key in node) collectHeadings(childOf(node, key), source, acc);
   }
 }
+var LANDMARK_TAGS = { main: "main", header: "banner", footer: "contentinfo" };
+var IDREF_ATTR_SET = new Set(IDREF_ATTRS);
+function collectA11y(fragment, source) {
+  const nodes = [];
+  let groups = 0;
+  let slotInLandmark;
+  let unknowableContent = 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;
+    }
+  };
+  const walk = (node, ctx) => {
+    if (Array.isArray(node)) {
+      for (const child of node) walk(child, ctx);
+      return;
+    }
+    if (!node || typeof node !== "object") return;
+    switch (node.type) {
+      case "SvelteHead":
+        return;
+      // head content never renders into the body
+      case "HtmlTag":
+        unknowableContent = true;
+        return;
+      case "IfBlock":
+        walkIfChain(node, ctx, groups++, 0);
+        return;
+      case "AwaitBlock": {
+        const group = groups++;
+        walk(node.pending, { ...ctx, path: [...ctx.path, { group, branch: 0 }] });
+        walk(node.then, { ...ctx, path: [...ctx.path, { group, branch: 1 }] });
+        walk(node.catch, { ...ctx, path: [...ctx.path, { group, branch: 2 }] });
+        return;
+      }
+      case "EachBlock":
+        walk(node.body, { ...ctx, repeatable: true });
+        walk(node.fallback, ctx);
+        return;
+      case "SnippetBlock":
+        walk(node.body, { ...ctx, repeatable: true });
+        return;
+      // <svelte:element> has a dynamic tag (so no tag-derived landmark) but its literal id/idref
+      // attributes are real — dropping them would make no-missing-id-ref report phantom misses.
+      case "RegularElement":
+      case "SvelteElement":
+        walkElement(node, ctx);
+        return;
+      case "Component":
+      case "SvelteComponent":
+      case "SvelteSelf":
+        noteSpread(node);
+        emit(ctx, { kind: "component", key: node.name, line: lineOf(source, node.start) });
+        walk(node.fragment, { ...ctx, elementDepth: ctx.elementDepth + 1 });
+        return;
+      case "SlotElement":
+        noteSpread(node);
+        slotInLandmark ??= ctx.landmarks.at(-1);
+        walk(node.fragment, ctx);
+        return;
+      case "RenderTag":
+        if (isChildrenRender(node)) slotInLandmark ??= ctx.landmarks.at(-1);
+        return;
+      default:
+        noteSpread(node);
+        for (const key of CHILD_NODE_KEYS) {
+          if (key in node) walk(childOf(node, key), ctx);
+        }
+    }
+  };
+  const walkIfChain = (node, ctx, group, branch) => {
+    walk(node.consequent, { ...ctx, path: [...ctx.path, { group, branch }] });
+    if (!node.alternate) return;
+    const rest = node.alternate.nodes.filter((n) => n.type !== "Text" || n.data.trim() !== "");
+    const chained = rest.length === 1 && rest[0].type === "IfBlock" && rest[0].elseif ? rest[0] : void 0;
+    if (chained) walkIfChain(chained, ctx, group, branch + 1);
+    else walk(node.alternate, { ...ctx, path: [...ctx.path, { group, branch: branch + 1 }] });
+  };
+  const walkElement = (node, ctx) => {
+    noteSpread(node);
+    const line = lineOf(source, node.start);
+    const attrs = node.attributes;
+    const roleAttr = findAttr3(attrs, "role");
+    const role = roleAttr ? splitTokens(attrTextOf3(roleAttr))[0] : void 0;
+    const landmark = roleAttr ? role && LANDMARK_ROLES.has(role) ? role : void 0 : LANDMARK_TAGS[node.name];
+    if (landmark) {
+      const headerFooter = !roleAttr && node.name !== "main";
+      emit(ctx, {
+        kind: "landmark",
+        key: landmark,
+        line,
+        ...headerFooter ? { topLevel: ctx.elementDepth === 0 } : {}
+      });
+    }
+    for (const attr of node.attributes) {
+      if (attr.type !== "Attribute") continue;
+      if (attr.name === "id") {
+        const v = attrValueOf3(attr);
+        if (v === "dynamic") emit(ctx, { kind: "id", key: "", line });
+        else if (v === "static") emit(ctx, { kind: "id", key: attrTextOf3(attr), line });
+      } else if (attr.name === "href") {
+        const href = attrTextOf3(attr);
+        if (href?.startsWith("#") && href.length > 1) {
+          emit(ctx, { kind: "idref", key: decodeFragmentId(href.slice(1)), line, attr: "href" });
+        }
+      } else if (IDREF_ATTR_SET.has(attr.name)) {
+        for (const token of splitTokens(attrTextOf3(attr))) {
+          emit(ctx, { kind: "idref", key: token, line, attr: attr.name });
+        }
+      }
+    }
+    const literalTag = node.type === "SvelteElement" ? node.tag.type === "Literal" && typeof node.tag.value === "string" ? node.tag.value : void 0 : node.name;
+    if (literalTag === "template") return;
+    walk(node.fragment, {
+      ...ctx,
+      elementDepth: ctx.elementDepth + 1,
+      landmarks: landmark ? [...ctx.landmarks, landmark] : ctx.landmarks
+    });
+  };
+  walk(fragment, { path: [], repeatable: false, landmarks: [], elementDepth: 0 });
+  return { nodes, ...slotInLandmark ? { slotInLandmark } : {}, unknowableContent };
+}
+function isChildrenRender(node) {
+  const call = node.expression.type === "ChainExpression" ? node.expression.expression : node.expression;
+  return call.callee.type === "Identifier" && call.callee.name === "children";
+}
 function parseFile(source, filename) {
   const ast = parse(source, { modern: true, filename });
   const heads = [];
@@ -570,7 +727,8 @@ function parseFile(source, filename) {
     components,
     imports: collectImports(ast),
     images,
-    headings
+    headings,
+    a11y: collectA11y(ast.fragment, source)
   };
 }
 
@@ -728,8 +886,64 @@ function chainFiles(pageRel, layouts) {
   }
   return [...chain.map((rel) => ({ rel, isPage: false })), { rel: pageRel, isPage: true }];
 }
-async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases) {
+function groupSpan(nodes) {
+  let max = -1;
+  for (const node of nodes) {
+    for (const step of node.path) if (step.group > max) max = step.group;
+  }
+  return max + 1;
+}
+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;
+  const base = state.nextGroup;
+  state.nextGroup += groupSpan(parsed.a11y.nodes);
+  const composed = [];
+  for (const node of parsed.a11y.nodes) {
+    const path = offsetPath(node.path, base);
+    if (node.kind !== "component") {
+      composed.push({ ...node, path, file: fileRel, chain });
+      continue;
+    }
+    const info = ctx.config.metaComponents.includes(node.key) ? void 0 : parsed.imports.get(node.key);
+    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;
+      continue;
+    }
+    const childParsed = await readAndParse(rt, cwd, childRel, ctx.cache);
+    const child = await composeA11y(ctx, childRel, childParsed, depth - 1, new Set(visited).add(childRel), false);
+    for (const inner of child) {
+      composed.push({ ...inner, path: [...path, ...inner.path], repeatable: node.repeatable || inner.repeatable });
+    }
+  }
+  return composed;
+}
+function countsAsLandmark(node) {
+  return node.topLevel === void 0 || node.chain && node.topLevel === true;
+}
+function representativeOrder(chainOrder) {
+  return (a, b) => {
+    const rankA = a.chain ? chainOrder.get(a.file) ?? 0 : chainOrder.size;
+    const rankB = b.chain ? chainOrder.get(b.file) ?? 0 : chainOrder.size;
+    if (rankA !== rankB) return rankA - rankB;
+    if (a.file !== b.file) return a.file < b.file ? -1 : 1;
+    return a.line - b.line;
+  };
+}
+function representatives(nodes, chainOrder) {
+  const folded = foldOccurrences(nodes);
+  const order = representativeOrder(chainOrder);
+  return Object.fromEntries(
+    [...folded].map(([key, list]) => [key, list.sort(order).map(({ file, line }) => ({ file, line }))])
+  );
+}
+async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases, appHtmlIds) {
   const files = chainFiles(pageRel, layouts);
+  const chainOrder = new Map(files.map((f, i) => [f.rel, i]));
   const composed = /* @__PURE__ */ new Map();
   const jsonldTags = [];
   let broadOwn = false;
@@ -737,8 +951,20 @@ async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases) {
   const images = [];
   const headings = [];
   const componentHeadings = [];
+  const a11yCtx = { rt, cwd, config, cache, aliases, state: { nextGroup: 0, fullyResolved: true } };
+  const a11yNodes = [];
+  const nestedLandmarks = [];
+  let slotLandmark;
   for (const { rel, isPage } of files) {
     const parsed = await readAndParse(rt, cwd, rel, cache);
+    const contributed = await composeA11y(a11yCtx, rel, parsed, MAX_DEPTH, /* @__PURE__ */ new Set([rel]), true);
+    for (const node of contributed) {
+      if (!node.chain || node.kind !== "landmark" || !countsAsLandmark(node) || node.repeatable) continue;
+      const within = node.inLandmark ?? slotLandmark;
+      if (within) nestedLandmarks.push({ kind: node.key, within, file: node.file, line: node.line });
+    }
+    slotLandmark = parsed.a11y.slotInLandmark ?? slotLandmark;
+    a11yNodes.push(...contributed);
     for (const img of parsed.images) {
       images.push({ ...img, file: rel });
     }
@@ -764,20 +990,40 @@ async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases) {
       if (!composed.has(key)) composed.set(key, { ...tag, presence });
     }
   }
+  const idNodes = a11yNodes.filter((n) => n.kind === "id");
+  if (idNodes.some((n) => n.key === "")) a11yCtx.state.fullyResolved = false;
+  const literalIds = idNodes.filter((n) => n.key !== "");
   const route = deriveRoute(pageRel);
   return {
     head: { route, source: "static", tags: [...composed.values(), ...jsonldTags], file: pageRel },
     images: { route, images },
-    headings: { route, headings, componentHeadings }
+    headings: { route, headings, componentHeadings },
+    a11y: {
+      route,
+      landmarks: representatives(
+        a11yNodes.filter((n) => n.kind === "landmark" && countsAsLandmark(n)),
+        chainOrder
+      ),
+      nestedLandmarks,
+      ids: representatives(literalIds, chainOrder),
+      // `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
+    }
   };
 }
-async function collectRoutes(rt, cwd, config = defaultConfig, cache = /* @__PURE__ */ new Map(), aliases) {
+async function collectRoutes(rt, cwd, config = defaultConfig, cache = /* @__PURE__ */ new Map(), aliases, appHtmlIds) {
   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)));
+  const facts = await Promise.all(
+    pages.map((page) => resolveRoute(rt, cwd, page, config, layouts, cache, aliases, appHtmlIds))
+  );
   return {
     heads: facts.map((f) => f.head),
     images: facts.map((f) => f.images),
-    headings: facts.map((f) => f.headings)
+    headings: facts.map((f) => f.headings),
+    a11y: facts.map((f) => f.a11y)
   };
 }
 
@@ -794,7 +1040,7 @@ async function collectAll(rt, cwd, config, opts = {}) {
   const matches = routeMatcher(opts.route);
   const project = await collectProjectFacts(rt, cwd);
   const [collected, components, kitModules, sourceFiles] = await Promise.all([
-    collectRoutes(rt, cwd, config, opts.parseCache, project.kitAliases),
+    collectRoutes(rt, cwd, config, opts.parseCache, project.kitAliases, project.appHtmlIds),
     // 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.
@@ -809,7 +1055,8 @@ async function collectAll(rt, cwd, config, opts = {}) {
   const heads = collected.heads.filter((h) => matches(h.route));
   const images = collected.images.filter((i) => matches(i.route));
   const headings = collected.headings.filter((h) => matches(h.route));
-  return { heads, images, headings, project, components, kitModules, sourceFiles };
+  const a11y = collected.a11y.filter((a) => matches(a.route));
+  return { heads, images, headings, a11y, project, components, kitModules, sourceFiles };
 }
 
 // src/changed-files.ts
@@ -1002,15 +1249,16 @@ function applySuppressions(results, entries, config, allResults) {
 }
 
 // src/color.ts
+import { styleText } from "util";
 import { noColorPalette } from "@svelte-vitals/core";
-var wrap = (open, close = 0) => (s) => `\x1B[${open}m${s}\x1B[${close}m`;
+var wrap = (format) => (s) => styleText(format, s, { validateStream: false });
 var ansiPalette = {
-  bold: wrap(1, 22),
-  dim: wrap(2, 22),
-  red: wrap(31, 39),
-  yellow: wrap(33, 39),
-  green: wrap(32, 39),
-  cyan: wrap(36, 39)
+  bold: wrap("bold"),
+  dim: wrap("dim"),
+  red: wrap("red"),
+  yellow: wrap("yellow"),
+  green: wrap("green"),
+  cyan: wrap("cyan")
 };
 function colorEnabled(opts) {
   if (opts.noColorFlag) return false;
@@ -1021,28 +1269,6 @@ function colorEnabled(opts) {
 }
 var paletteFor = (enabled) => enabled ? ansiPalette : noColorPalette;
 
-// src/spinner.ts
-var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
-function startSpinner(text, opts) {
-  const stream = opts.stream ?? process.stderr;
-  if (!opts.enabled) return { stop() {
-  } };
-  let i = 0;
-  const tick = () => {
-    stream.write(`\r${FRAMES[i % FRAMES.length]} ${text}`);
-    i++;
-  };
-  tick();
-  const timer = setInterval(tick, 80);
-  if (typeof timer.unref === "function") timer.unref();
-  return {
-    stop() {
-      clearInterval(timer);
-      stream.write("\r\x1B[K");
-    }
-  };
-}
-
 // src/mascot.ts
 import { createLogUpdate } from "log-update";
 function mascotStateFor(score) {
@@ -1119,24 +1345,28 @@ function renderConfettiFrame(offset, mascotBlock) {
   return [confettiRow(offset), mascotBlock, confettiRow(offset + 2)].join("\n");
 }
 var IDLE_TICK_MS = 160;
+var PLAIN_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var PLAIN_TICK_MS = 80;
 function startMascotSpinner(text, opts) {
   if (!opts.enabled) return { stop() {
   } };
   const stream = opts.stream ?? process.stderr;
+  const mascot = opts.mascot ?? true;
   const render = createLogUpdate(stream);
   let i = 0;
   const tick = () => {
-    render(`${renderMascotIdleFrame(i)}
-${text}`);
+    render(mascot ? `${renderMascotIdleFrame(i)}
+${text}` : `${PLAIN_FRAMES[i % PLAIN_FRAMES.length]} ${text}`);
     i++;
   };
   tick();
-  const timer = setInterval(tick, IDLE_TICK_MS);
+  const timer = setInterval(tick, mascot ? IDLE_TICK_MS : PLAIN_TICK_MS);
   if (typeof timer.unref === "function") timer.unref();
   return {
     stop() {
       clearInterval(timer);
       render.clear();
+      render.done();
     }
   };
 }
@@ -1307,7 +1537,7 @@ function skippedFileWarnings(facts) {
   ];
 }
 function failedRuleWarnings(failedRules) {
-  return failedRules.map((f) => `rule ${f.id} failed and was skipped: ${f.message.split("\n")[0]}`);
+  return failedRules.map(formatFailedRuleWarning);
 }
 async function analyzeProject(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
@@ -1334,10 +1564,15 @@ async function analyzeProject(opts = {}) {
     ...await checkVersionFloor(rt, cwd),
     ...overridesOffWarnings(opts.allowRules, config.overrides)
   ];
-  const { heads, images, headings, project, components, kitModules, sourceFiles } = await collectAll(rt, cwd, config, {
-    route: opts.route,
-    parseCache: opts.parseCache
-  });
+  const { heads, images, headings, a11y, project, components, kitModules, sourceFiles } = await collectAll(
+    rt,
+    cwd,
+    config,
+    {
+      route: opts.route,
+      parseCache: opts.parseCache
+    }
+  );
   const selected = selectRules(allRules2, config);
   const rules = opts.categories ? selected.filter((r) => opts.categories.includes(r.category)) : selected;
   const {
@@ -1348,6 +1583,7 @@ async function analyzeProject(opts = {}) {
     heads,
     images,
     headings,
+    a11y,
     components,
     project,
     config,
@@ -1355,22 +1591,22 @@ async function analyzeProject(opts = {}) {
     sourceFiles
   });
   const results = applyOverrides(applyRuleSeverities(rawResults, config), config);
-  const scoringConfig = withFailedRulesOff(
-    config,
-    failedRules.map((f) => f.id)
-  );
+  const failedRuleIds = failedRules.map((f) => f.id);
+  const scoringConfig = withFailedRulesOff(config, failedRuleIds);
   return {
     results,
     config: scoringConfig,
     version: readPackageVersion(),
     ruleIds: rules.map((r) => r.id),
     examined,
+    failedRuleIds,
     warnings: [...warnings, ...skippedFileWarnings([...components, ...kitModules]), ...failedRuleWarnings(failedRules)],
     loadedConfig: loaded
   };
 }
 async function applyScope(results, opts) {
-  const errorLog = opts.errorLog ?? ((line) => console.error(line));
+  const rawErrorLog = opts.errorLog ?? ((line) => console.error(line));
+  const errorLog = (line) => rawErrorLog(terminalSafe(line));
   let scoped = results;
   if (opts.staged || opts.diffBase !== void 0) {
     const changed = opts.staged ? getChangedFiles(opts.cwd, { staged: true }) : getChangedFiles(opts.cwd, { base: opts.diffBase });
@@ -1433,7 +1669,8 @@ function runAnalyzeOptions(opts) {
 }
 async function run(opts = {}) {
   const log = opts.log ?? ((line) => console.log(line));
-  const errorLog = opts.errorLog ?? ((line) => console.error(line));
+  const rawErrorLog = opts.errorLog ?? ((line) => console.error(line));
+  const errorLog = (line) => rawErrorLog(terminalSafe(line));
   if (opts.minHealth != null && (!Number.isFinite(opts.minHealth) || opts.minHealth < 0 || opts.minHealth > 100)) {
     errorLog(`svelte-vitals: invalid minHealth '${opts.minHealth}'; expected a number 0-100.`);
     return 2;
@@ -1452,7 +1689,11 @@ async function run(opts = {}) {
   if (useMascotSpinner && bubbleFitsWidth(stderrStream.columns)) {
     await playMascotGreeting({ enabled: true, stream: stderrStream, holdMs: opts.animationFrameDelayMs });
   }
-  const spinner = useMascotSpinner ? startMascotSpinner("Analyzing\u2026", { enabled: true, stream: stderrStream }) : startSpinner("Analyzing\u2026", { enabled: spinnerBaseEnabled, stream: stderrStream });
+  const spinner = startMascotSpinner("Analyzing\u2026", {
+    enabled: spinnerBaseEnabled,
+    stream: stderrStream,
+    mascot: useMascotSpinner
+  });
   let cwd = opts.cwd ?? process.cwd();
   let analysis;
   try {

package/dist/{chunk-4O5F7EUJ.js → chunk-77MMJCFK.js}

@@ -1,6 +1,6 @@
 import {
   toList
-} from "./chunk-MUIOPL5F.js";
+} from "./chunk-43FGGQQZ.js";
 import {
   CONFIG_FILENAMES,
   discoverApps,
@@ -17,7 +17,7 @@ import {
   WORKFLOW_PATH,
   buildWorkflowYaml,
   planWorkflowWrite
-} from "./chunk-F5P3REI7.js";
+} from "./chunk-CTMKTFST.js";
 import {
   clackPrompts,
   realIO
@@ -110,13 +110,14 @@ function isKind(id, kind) {
 
 // src/install/skill-content.ts
 import { allRules, docsUrlFor } from "@svelte-vitals/core";
-var CATEGORY_ORDER = ["seo", "performance", "correctness", "security", "architecture"];
+var CATEGORY_ORDER = ["seo", "performance", "correctness", "security", "architecture", "a11y"];
 var CATEGORY_LABELS = {
   seo: "SEO",
   performance: "Performance",
   correctness: "Correctness",
   security: "Security",
-  architecture: "Architecture"
+  architecture: "Architecture",
+  a11y: "Accessibility"
 };
 function oneLine(text) {
   return text.replace(/\r?\n+/g, " ").trim();
@@ -151,7 +152,7 @@ function sharedBody(version) {
 
 ## When to use
 
-Use this whenever you are writing or reviewing SvelteKit route files (\`+page.svelte\`, \`+layout.svelte\`) or components in this project \u2014 svelte-vitals statically checks SEO, performance, correctness, security, and architecture patterns.
+Use this whenever you are writing or reviewing SvelteKit route files (\`+page.svelte\`, \`+layout.svelte\`) or components in this project \u2014 svelte-vitals statically checks SEO, performance, correctness, security, architecture, and accessibility patterns.
 
 ## Playbook
 
@@ -168,7 +169,7 @@ ${ruleDigest()}
 function buildSkillMarkdown(version) {
   const frontmatter = `---
 name: svelte-vitals
-description: Use when writing or reviewing SvelteKit routes/components \u2014 svelte-vitals rule knowledge (SEO, performance, correctness, security, architecture) and how to run the scanner.
+description: Use when writing or reviewing SvelteKit routes/components \u2014 svelte-vitals rule knowledge (SEO, performance, correctness, security, architecture, accessibility) and how to run the scanner.
 ---`;
   return `${frontmatter}
 
@@ -176,7 +177,7 @@ ${sharedBody(version)}`;
 }
 function buildCursorRules(version) {
   const frontmatter = `---
-description: svelte-vitals code-health rules for SvelteKit (SEO, performance, correctness, security, architecture)
+description: svelte-vitals code-health rules for SvelteKit (SEO, performance, correctness, security, architecture, accessibility)
 globs: ["**/*.svelte", "src/routes/**"]
 alwaysApply: false
 ---`;
@@ -281,7 +282,8 @@ Get the machine map before applying judgment:
   \`<title>\`/meta (SEO), image-heavy routes (Performance), forms and
   \`{@html}\` usage (Security), large or unkeyed list-rendering routes
   (Correctness), route/component files that have grown large or deeply
-  nested (Architecture).
+  nested (Architecture), interactive controls and forms with unclear
+  labeling or ARIA usage (Accessibility).
 - **Leverage map** (the judgment the scan lacks): which routes are
   high-traffic/public/indexed (a marketing page, a product listing) versus
   low-traffic or gated (an internal admin tool, a rarely visited settings
@@ -290,10 +292,10 @@ Get the machine map before applying judgment:
 
 ### Phase 2 \u2014 Audit (parallel)
 
-Audit against svelte-vitals' five categories: SEO, Performance, Correctness,
-Security, Architecture (see the rule catalog below for the full "hunt for"
-list per category, generated from svelte-vitals' own rule metadata \u2014 always
-in sync, never invented).
+Audit against svelte-vitals' six categories: SEO, Performance, Correctness,
+Security, Architecture, Accessibility (see the rule catalog below for the
+full "hunt for" list per category, generated from svelte-vitals' own rule
+metadata \u2014 always in sync, never invented).
 
 For anything beyond a small project, fan out read-only subagents \u2014 one per
 category. Each subagent prompt must include: the recon facts (stack,
@@ -311,8 +313,8 @@ Depth follows effort level (default \`standard\`):
 | Effort     | Coverage                              | Subagents | Findings                     |
 | ---------- | -------------------------------------- | --------- | ----------------------------- |
 | \`quick\`    | Highest-traffic/public routes only     | 0\u20131       | ~5, HIGH severity only        |
-| \`standard\` | All routes and components              | \u22645        | Full table                    |
-| \`deep\`     | Whole project incl. rarely-hit routes  | 5         | Full table + LOW polish items |
+| \`standard\` | All routes and components              | \u22646        | Full table                    |
+| \`deep\`     | Whole project incl. rarely-hit routes  | 6         | Full table + LOW polish items |
 
 ### Phase 3 \u2014 Vet, prioritize, confirm
 
@@ -408,6 +410,11 @@ category the rule catalog above can't cover:
   complex, well-organized page (leave it \u2014 don't split just to satisfy a
   metric). Look for duplicated \`<svelte:head>\` boilerplate that a shared
   layout or meta component would remove.
+- **Accessibility** \u2014 svelte-vitals checks static markup (ARIA validity,
+  landmarks, ids, labels); it can't drive a keyboard or screen reader. Hunt
+  for illogical tab order, missing visible focus styles, color contrast
+  below WCAG thresholds, and modal/menu components that don't trap or
+  restore focus \u2014 all invisible to a static scan.
 
 ## Plan template
 
@@ -421,7 +428,7 @@ target state.
 - **Status**: TODO
 - **Commit**: <output of \`git rev-parse --short HEAD\` when written>
 - **Severity**: HIGH | MEDIUM | LOW
-- **Category**: SEO | Performance | Correctness | Security | Architecture
+- **Category**: SEO | Performance | Correctness | Security | Architecture | Accessibility
 - **Rule**: <RULEID> | Beyond the scan
 - **Estimated scope**: <n files, rough size>
 
@@ -491,7 +498,7 @@ adapted to this file \u2014 never approximated from memory.
 | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
 | bare                                                                                  | Full workflow: recon \u2192 audit all categories \u2192 vet \u2192 confirm \u2192 plans                                                                        |
 | \`quick\` / \`deep\`                                                                      | Adjust audit effort (see table); composes with a category focus                                                                             |
-| a category focus (\`seo\`, \`performance\`, \`correctness\`, \`security\`, \`architecture\`)    | Recon + audit that category only                                                                                                             |
+| a category focus (\`seo\`, \`performance\`, \`correctness\`, \`security\`, \`architecture\`, \`accessibility\`) | Recon + audit that category only                                                                                                             |
 | \`plan <description>\`                                                                  | Skip the audit; recon just enough to specify, then write a single plan for the described improvement                                        |
 | \`execute <plan>\`                                                                      | Dispatch an executor subagent to implement the plan in an isolated worktree, then review its diff against svelte-vitals (\`--diff --reporter agent\`) and render a verdict |
 | \`reconcile\`                                                                           | Re-check \`plans/\` against the current code: mark done plans DONE, refresh stale \`file:line\`/route references, retire fixed findings          |
@@ -1143,7 +1150,7 @@ var INSTALL_ARGS = {
   help: { type: "boolean", short: "h", description: "Show this help" }
 };
 async function buildInstallHelpText(installCommand2, locale) {
-  const ja = locale === "ja" ? await import("./ja-BCE5T3H2.js") : void 0;
+  const ja = locale === "ja" ? await import("./ja-GAQSBSXF.js") : void 0;
   const optionsSection = stripAutoVersionLine(
     await localizedOptionsSection(
       installCommand2,

package/dist/{chunk-MHRO4GU7.js → chunk-A5DVJX5O.js}

@@ -16,7 +16,7 @@ var JA_ARG_DESCRIPTIONS = {
     "min-health": "\u7D44\u307F\u5408\u308F\u305B\u305F Health \u30B9\u30B3\u30A2\u304C\u3053\u306E\u5024\u3092\u4E0B\u56DE\u308C\u3070\u5931\u6557\uFF08\u7D42\u4E86\u30B3\u30FC\u30C9 1\u30010\u301C100\uFF09",
     rules: "\u6709\u52B9\u306B\u3059\u308B\u30EB\u30FC\u30EB ID\uFF08\u30AB\u30F3\u30DE\u533A\u5207\u308A\u3001\u4ED6\u306F\u3059\u3079\u3066\u7121\u52B9\uFF09",
     ignore: "\u7121\u52B9\u306B\u3059\u308B\u30EB\u30FC\u30EB ID\uFF08\u30AB\u30F3\u30DE\u533A\u5207\u308A\uFF09",
-    category: "\u89E3\u6790\u5BFE\u8C61\u30AB\u30C6\u30B4\u30EA\uFF08\u30AB\u30F3\u30DE\u533A\u5207\u308A\uFF09: seo | performance | correctness | security | architecture",
+    category: "\u89E3\u6790\u5BFE\u8C61\u30AB\u30C6\u30B4\u30EA\uFF08\u30AB\u30F3\u30DE\u533A\u5207\u308A\uFF09: seo | performance | correctness | security | architecture | a11y",
     weights: "\u30AB\u30C6\u30B4\u30EA\u3054\u3068\u306E Health \u91CD\u307F\u4E0A\u66F8\u304D\u3002\u4F8B: seo=2,performance=1\uFF08\u6307\u5B9A\u306E\u306A\u3044\u30AB\u30C6\u30B4\u30EA\u306F\u30C7\u30D5\u30A9\u30EB\u30C8\u5024 1\uFF09",
     score: "\u7D44\u307F\u5408\u308F\u305B\u305F Health \u30B9\u30B3\u30A2\u306E\u307F\u3092\u51FA\u529B\uFF08--min-health \u3068\u4F75\u7528\u3057\u3066\u30B2\u30FC\u30C8\u306B\u5229\u7528\u53EF\u80FD\uFF09",
     noColor: "\u30B3\u30F3\u30BD\u30FC\u30EB\u51FA\u529B\u306E ANSI \u30AB\u30E9\u30FC\u3092\u7121\u52B9\u5316",
@@ -50,7 +50,7 @@ var JA_ARG_DESCRIPTIONS = {
   }
 };
 function rootHelpJa(optionsSection) {
-  return `svelte-vitals \u2014 \u6C7A\u5B9A\u8AD6\u7684\u306A SvelteKit \u30B3\u30FC\u30C9\u30D8\u30EB\u30B9\u30C1\u30A7\u30C3\u30AB\u30FC\uFF08SEO\u30FB\u30D1\u30D5\u30A9\u30FC\u30DE\u30F3\u30B9\u30FB\u6B63\u78BA\u6027\u30FB\u30BB\u30AD\u30E5\u30EA\u30C6\u30A3\u30FB\u30A2\u30FC\u30AD\u30C6\u30AF\u30C1\u30E3\uFF09
+  return `svelte-vitals \u2014 \u6C7A\u5B9A\u8AD6\u7684\u306A SvelteKit \u30B3\u30FC\u30C9\u30D8\u30EB\u30B9\u30C1\u30A7\u30C3\u30AB\u30FC\uFF08SEO\u30FB\u30D1\u30D5\u30A9\u30FC\u30DE\u30F3\u30B9\u30FB\u6B63\u78BA\u6027\u30FB\u30BB\u30AD\u30E5\u30EA\u30C6\u30A3\u30FB\u30A2\u30FC\u30AD\u30C6\u30AF\u30C1\u30E3\u30FB\u30A2\u30AF\u30BB\u30B7\u30D3\u30EA\u30C6\u30A3\uFF09
 
 \u4F7F\u7528\u65B9\u6CD5:
   svelte-vitals [path] [options]

package/dist/{chunk-F5P3REI7.js → chunk-CTMKTFST.js}

@@ -1,7 +1,7 @@
 // src/ci/workflow.ts
 var WORKFLOW_PATH = ".github/workflows/svelte-vitals.yml";
-var CHECKOUT_SHA = "9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0";
-var CHECKOUT_VERSION = "v7.0.0";
+var CHECKOUT_SHA = "3d3c42e5aac5ba805825da76410c181273ba90b1";
+var CHECKOUT_VERSION = "v7.0.1";
 function planWorkflowWrite(existing, force) {
   if (existing === void 0) return { status: "created" };
   if (!force) return { status: "exists" };
@@ -28,6 +28,7 @@ function buildWorkflowYaml(opts) {
     `      - uses: actions/checkout@${CHECKOUT_SHA} # ${CHECKOUT_VERSION}`,
     "        with:",
     "          fetch-depth: 0",
+    "          persist-credentials: false",
     `      - uses: oekazuma/svelte-vitals-action@${actionSha} # v${actionVersion}`,
     "        with:",
     "          diff: origin/${{ github.base_ref }}",

package/dist/{chunk-ACQ5HB32.js → chunk-ICEJJDDA.js}

@@ -4,7 +4,7 @@ import {
   WORKFLOW_PATH,
   buildWorkflowYaml,
   planWorkflowWrite
-} from "./chunk-F5P3REI7.js";
+} from "./chunk-CTMKTFST.js";
 import {
   realIO
 } from "./chunk-GE7TKVTX.js";
@@ -86,7 +86,7 @@ var CI_UPGRADE_ARGS = { "dry-run": CI_ARGS["dry-run"], help: CI_ARGS.help };
 var KNOWN_LONG_FLAGS = /* @__PURE__ */ new Set(["force", "dry-run", "help"]);
 var KNOWN_SHORT_FLAGS = /* @__PURE__ */ new Set(["h"]);
 async function buildCiHelpText(ciArgsCommand, locale) {
-  const ja = locale === "ja" ? await import("./ja-BCE5T3H2.js") : void 0;
+  const ja = locale === "ja" ? await import("./ja-GAQSBSXF.js") : void 0;
   const optionsSection = stripAutoVersionLine(
     await localizedOptionsSection(ciArgsCommand, "svelte-vitals ci", locale, ja?.JA_ARG_DESCRIPTIONS.ci ?? {})
   );

package/dist/{chunk-O2CQPUSP.js → chunk-JFLNGYPX.js}

@@ -17,10 +17,7 @@ import {
 import { cli } from "gunshi/bone";
 import { define } from "gunshi/definition";
 import "gunshi/generator";
-import { explainRule as explainRule2, allRules as allRules2 } from "@svelte-vitals/core";
-
-// src/explain.ts
-import { allRules, CATEGORIES } from "@svelte-vitals/core";
+import { explainRule, allRules, CATEGORIES } from "@svelte-vitals/core";
 function describeOptions(id, options) {
   const MERGE = {
     integer: "replaces the default",
@@ -56,8 +53,6 @@ function renderRuleList() {
     "\n\n"
   );
 }
-
-// src/gunshi/explain.ts
 var BOOLEAN_FLAGS = ["json", "list", "help"];
 var KNOWN_LONG_FLAGS = new Set(BOOLEAN_FLAGS);
 var KNOWN_SHORT_FLAGS = /* @__PURE__ */ new Set(["h"]);
@@ -67,7 +62,7 @@ var EXPLAIN_ARGS = {
   help: { type: "boolean", short: "h", description: "Show this help" }
 };
 async function buildExplainHelpText(explainCommand, locale) {
-  const ja = locale === "ja" ? await import("./ja-BCE5T3H2.js") : void 0;
+  const ja = locale === "ja" ? await import("./ja-GAQSBSXF.js") : void 0;
   const optionsSection = stripAutoVersionLine(
     await localizedOptionsSection(
       explainCommand,
@@ -113,7 +108,7 @@ async function runExplainCliGunshi(args, io = consoleIO, locale = "en") {
         }
         io.log(
           ctx.values.json ? JSON.stringify(
-            allRules2.map((r) => ({ id: r.id, category: r.category, severity: r.severity, title: r.title })),
+            allRules.map((r) => ({ id: r.id, category: r.category, severity: r.severity, title: r.title })),
             null,
             2
           ) : renderRuleList()
@@ -130,7 +125,7 @@ async function runExplainCliGunshi(args, io = consoleIO, locale = "en") {
         exitCode = 2;
         return;
       }
-      const info = explainRule2(id);
+      const info = explainRule(id);
       if (!info) {
         io.errorLog(`svelte-vitals: unknown rule id '${id}'.`);
         const hint = suggestClosest(id, knownRuleIds());

package/dist/{chunk-P4YNVJUO.js → chunk-MZO3HVTN.js}

@@ -1,11 +1,11 @@
 import {
   run
-} from "./chunk-VNVRHWO3.js";
+} from "./chunk-5UQ6P2M2.js";
 import {
   VALUE_FLAGS,
   parseRunArgs,
   resolveArgs
-} from "./chunk-MUIOPL5F.js";
+} from "./chunk-43FGGQQZ.js";
 import {
   readCoreVersion,
   readPackageVersion
@@ -90,7 +90,7 @@ var ROOT_ARGS = {
   ignore: { type: "string", description: "Comma-separated rule ids to disable" },
   category: {
     type: "string",
-    description: "Comma-separated categories to analyze: seo | performance | correctness | security | architecture"
+    description: "Comma-separated categories to analyze: seo | performance | correctness | security | architecture | a11y"
   },
   weights: {
     type: "string",
@@ -127,7 +127,7 @@ function neutralizeBareDiffAndBaseline(argv) {
 }
 async function buildHelpText(rootCommand, locale) {
   if (locale === "ja") {
-    const { JA_ARG_DESCRIPTIONS, rootHelpJa } = await import("./ja-BCE5T3H2.js");
+    const { JA_ARG_DESCRIPTIONS, rootHelpJa } = await import("./ja-GAQSBSXF.js");
     const optionsSection2 = await localizedOptionsSection(
       rootCommand,
       "svelte-vitals",
@@ -137,7 +137,7 @@ async function buildHelpText(rootCommand, locale) {
     return rootHelpJa(optionsSection2);
   }
   const optionsSection = await localizedOptionsSection(rootCommand, "svelte-vitals", locale, {});
-  return `svelte-vitals \u2014 a deterministic SvelteKit code-health scanner (SEO \xB7 performance \xB7 correctness \xB7 security \xB7 architecture)
+  return `svelte-vitals \u2014 a deterministic SvelteKit code-health scanner (SEO \xB7 performance \xB7 correctness \xB7 security \xB7 architecture \xB7 accessibility)
 
 Usage:
   svelte-vitals [path] [options]

package/dist/{chunk-MBOONBC4.js → chunk-SLE22PPF.js}

@@ -31,7 +31,7 @@ var EMBEDDED_DOCS = [
     name: "config",
     title: "The config file",
     description: "Where svelte-vitals.config lives, every top-level option, how to disable or re-grade a rule, and how to scope rules to routes or files.",
-    body: "# The config file\n\n## Where it lives\n\nIn the **analyzed directory only** \u2014 no upward search. First match wins:\n\n1. `svelte-vitals.config.mjs`\n2. `svelte-vitals.config.js`\n3. `svelte-vitals.config.ts`\n\nNo file means built-in defaults. `svelte-vitals install --client config-file` scaffolds one with\nevery option commented out.\n\n```js\n// svelte-vitals.config.mjs\nexport default {\n  treatDynamicAs: 'warn',\n  metaComponents: ['Seo'],\n  rules: { 'seo/json-ld': 'off' },\n  failOn: 'warning',\n  weights: { seo: 2 }\n};\n```\n\nA `.ts` config can `import { defineConfig } from 'svelte-vitals'` for type-checking, but that is a\n**runtime** import: it needs svelte-vitals as a declared dependency and Node 22.18+ (or 23.6+).\nA plain `export default {}` in `.mjs` behaves identically and always works.\n\n## Options\n\n| Option           | Type                                                           | Default            |\n| ---------------- | -------------------------------------------------------------- | ------------------ |\n| `treatDynamicAs` | `'pass' \\| 'warn' \\| 'fail'`                                   | `'pass'`           |\n| `metaComponents` | `string[]`                                                     | `[]`               |\n| `rules`          | `Record<ruleId, 'off' \\| Severity \\| { severity?, options? }>` | `{}`               |\n| `failOn`         | `'critical' \\| 'warning' \\| 'info'`                            | `'critical'`       |\n| `weights`        | `Partial<Record<Category, number>>`                            | every category `1` |\n| `overrides`      | `RuleOverride[]`                                               | (none)             |\n\n`Severity` is `'critical' | 'warning' | 'info'`. `Category` is `'seo' | 'performance' |\n'correctness' | 'security' | 'architecture'`. A weight of `0` drops a category from the Health\naverage; setting every category to `0` is an error (exit `2`).\n\n## Turning a rule off or down\n\n```js\nexport default {\n  rules: {\n    'seo/json-ld': 'off', // remove its findings entirely\n    'architecture/prop-count': 'info' // keep it, stop it failing the build\n  }\n};\n```\n\nMany rules take options, so check whether the finding is a **threshold disagreement** rather than\na defect first. `svelte-vitals explain <rule-id>` prints each option's name, default, bounds, and\nmerge semantics (`integer` replaces, `string-list` appends, `string-map` is spread over).\n\n```js\nexport default {\n  rules: {\n    'architecture/prop-count': { options: { max: 12 } }\n  }\n};\n```\n\n## Scoping to routes or files (`overrides`)\n\n`rules` applies everywhere; `overrides` applies only where it matches \u2014 typically routes that\nare deliberately not public.\n\n```js\nexport default {\n  overrides: [\n    { files: 'src/routes/(app)/**', rules: { seo: 'off' } },\n    { route: '/admin/**', rules: { 'seo/title-presence': 'info' } }\n  ]\n};\n```\n\nEach entry needs `rules` (keys are rule ids **or** category names) plus at least one of:\n\n- **`route`** \u2014 glob(s) against the route id as reported (`/blog/[slug]`). SvelteKit `(group)`\n  segments are **not** in the route id, so use `files` to target a group.\n- **`files`** \u2014 glob(s) against the source path.\n\nGlobs are deliberately small: `*` within a segment, `**` across segments, a trailing `/**` also\nmatches the bare prefix. Everything else \u2014 including `(`, `)`, `[`, `]` \u2014 is literal. Later entries win.\n\n## Precedence\n\nPer field: **CLI flag > config file > built-in default**. One exception \u2014 `--rules` and `--ignore`\nare selection, not configuration: `--rules` narrows the run to the ids it names and overrides a\nconfig-file `off` for them, but keeps their declared severity and options; `--ignore` adds `off`\nentries for the ids it names, layered on top of whatever `rules` resolved to, and beats `--rules`\nwhen both name the same rule.\n\n`overrides` has no CLI flag; route policy belongs in a committed file.\n\n## Validation\n\nAn unknown rule id or category, a negative weight, a malformed `overrides` entry, or an invalid\nrule setting is a **hard error (exit `2`)** \u2014 a typo must not silently un-gate CI. An unrecognized\n`treatDynamicAs`/`failOn` value, or an unknown top-level key, only warns.\n\n## Related\n\n- `svelte-vitals explain --list` \u2014 every rule id\n- `svelte-vitals docs show scoping` \u2014 accepting an existing backlog instead of disabling rules"
+    body: "# The config file\n\n## Where it lives\n\nIn the **analyzed directory only** \u2014 no upward search. First match wins:\n\n1. `svelte-vitals.config.mjs`\n2. `svelte-vitals.config.js`\n3. `svelte-vitals.config.ts`\n\nNo file means built-in defaults. `svelte-vitals install --client config-file` scaffolds one with\nevery option commented out.\n\n```js\n// svelte-vitals.config.mjs\nexport default {\n  treatDynamicAs: 'warn',\n  metaComponents: ['Seo'],\n  rules: { 'seo/json-ld': 'off' },\n  failOn: 'warning',\n  weights: { seo: 2 }\n};\n```\n\nA `.ts` config can `import { defineConfig } from 'svelte-vitals'` for type-checking, but that is a\n**runtime** import: it needs svelte-vitals as a declared dependency and Node 22.18+ (or 23.6+).\nA plain `export default {}` in `.mjs` behaves identically and always works.\n\n## Options\n\n| Option           | Type                                                           | Default            |\n| ---------------- | -------------------------------------------------------------- | ------------------ |\n| `treatDynamicAs` | `'pass' \\| 'warn' \\| 'fail'`                                   | `'pass'`           |\n| `metaComponents` | `string[]`                                                     | `[]`               |\n| `rules`          | `Record<ruleId, 'off' \\| Severity \\| { severity?, options? }>` | `{}`               |\n| `failOn`         | `'critical' \\| 'warning' \\| 'info'`                            | `'critical'`       |\n| `weights`        | `Partial<Record<Category, number>>`                            | every category `1` |\n| `overrides`      | `RuleOverride[]`                                               | (none)             |\n\n`Severity` is `'critical' | 'warning' | 'info'`. `Category` is `'seo' | 'performance' |\n'correctness' | 'security' | 'architecture' | 'a11y'`. A weight of `0` drops a category from the Health\naverage; setting every category to `0` is an error (exit `2`).\n\n## Turning a rule off or down\n\n```js\nexport default {\n  rules: {\n    'seo/json-ld': 'off', // remove its findings entirely\n    'architecture/prop-count': 'info' // keep it, stop it failing the build\n  }\n};\n```\n\nMany rules take options, so check whether the finding is a **threshold disagreement** rather than\na defect first. `svelte-vitals explain <rule-id>` prints each option's name, default, bounds, and\nmerge semantics (`integer` replaces, `string-list` appends, `string-map` is spread over).\n\n```js\nexport default {\n  rules: {\n    'architecture/prop-count': { options: { max: 12 } }\n  }\n};\n```\n\n## Scoping to routes or files (`overrides`)\n\n`rules` applies everywhere; `overrides` applies only where it matches \u2014 typically routes that\nare deliberately not public.\n\n```js\nexport default {\n  overrides: [\n    { files: 'src/routes/(app)/**', rules: { seo: 'off' } },\n    { route: '/admin/**', rules: { 'seo/title-presence': 'info' } }\n  ]\n};\n```\n\nEach entry needs `rules` (keys are rule ids **or** category names) plus at least one of:\n\n- **`route`** \u2014 glob(s) against the route id as reported (`/blog/[slug]`). SvelteKit `(group)`\n  segments are **not** in the route id, so use `files` to target a group.\n- **`files`** \u2014 glob(s) against the source path.\n\nGlobs are deliberately small: `*` within a segment, `**` across segments, a trailing `/**` also\nmatches the bare prefix. Everything else \u2014 including `(`, `)`, `[`, `]` \u2014 is literal. Later entries win.\n\n## Precedence\n\nPer field: **CLI flag > config file > built-in default**. One exception \u2014 `--rules` and `--ignore`\nare selection, not configuration: `--rules` narrows the run to the ids it names and overrides a\nconfig-file `off` for them, but keeps their declared severity and options; `--ignore` adds `off`\nentries for the ids it names, layered on top of whatever `rules` resolved to, and beats `--rules`\nwhen both name the same rule.\n\n`overrides` has no CLI flag; route policy belongs in a committed file.\n\n## Validation\n\nAn unknown rule id or category, a negative weight, a malformed `overrides` entry, or an invalid\nrule setting is a **hard error (exit `2`)** \u2014 a typo must not silently un-gate CI. An unrecognized\n`treatDynamicAs`/`failOn` value, or an unknown top-level key, only warns.\n\n## Related\n\n- `svelte-vitals explain --list` \u2014 every rule id\n- `svelte-vitals docs show scoping` \u2014 accepting an existing backlog instead of disabling rules"
   },
   {
     name: "monorepo",
@@ -53,7 +53,7 @@ var EMBEDDED_DOCS = [
   }
 ];
 
-// src/docs/cli.ts
+// src/gunshi/docs.ts
 var DOCS_HELP = `svelte-vitals docs \u2014 read the bundled guides without leaving the terminal
 
 Usage:
@@ -83,8 +83,6 @@ function renderList() {
     "Rule-level detail is a separate command: `svelte-vitals explain --list`."
   ].join("\n");
 }
-
-// src/gunshi/docs.ts
 var BOOLEAN_FLAGS = ["json", "help"];
 var HELP_ARG = { help: { type: "boolean", short: "h", description: "Show this help" } };
 var JSON_ARG = { json: { type: "boolean", description: "Machine-readable output (list only)" } };
@@ -98,7 +96,7 @@ var DOCS_SHOW_ARGS = {
   ...HELP_ARG
 };
 async function buildDocsHelpText(rootCommand, locale) {
-  const ja = locale === "ja" ? await import("./ja-BCE5T3H2.js") : void 0;
+  const ja = locale === "ja" ? await import("./ja-GAQSBSXF.js") : void 0;
   const optionsSection = stripAutoVersionLine(
     await localizedOptionsSection(rootCommand, "svelte-vitals docs", locale, ja?.JA_ARG_DESCRIPTIONS.docs ?? {})
   );

package/dist/{ci-CLKU3TR6.js → ci-J7PGFHK3.js}

@@ -2,8 +2,8 @@ import {
   CI_ARGS,
   CI_UPGRADE_ARGS,
   runCiCliGunshi
-} from "./chunk-ACQ5HB32.js";
-import "./chunk-F5P3REI7.js";
+} from "./chunk-ICEJJDDA.js";
+import "./chunk-CTMKTFST.js";
 import "./chunk-GE7TKVTX.js";
 import "./chunk-NMVBVKLX.js";
 export {

package/dist/{complete-HGLO72TI.js → complete-BDKGAUQX.js}

@@ -1,23 +1,23 @@
 import {
   ROOT_ARGS
-} from "./chunk-P4YNVJUO.js";
-import "./chunk-VNVRHWO3.js";
+} from "./chunk-MZO3HVTN.js";
+import "./chunk-5UQ6P2M2.js";
 import {
   DOCS_LIST_ARGS,
   DOCS_ROOT_ARGS,
   DOCS_SHOW_ARGS
-} from "./chunk-MBOONBC4.js";
+} from "./chunk-SLE22PPF.js";
 import {
   EXPLAIN_ARGS
-} from "./chunk-O2CQPUSP.js";
+} from "./chunk-JFLNGYPX.js";
 import {
   INSTALL_ARGS
-} from "./chunk-4O5F7EUJ.js";
+} from "./chunk-77MMJCFK.js";
 import {
   CATEGORIES,
   FAIL_ON_VALUES,
   TREAT_DYNAMIC_AS_VALUES
-} from "./chunk-MUIOPL5F.js";
+} from "./chunk-43FGGQQZ.js";
 import {
   REPORTER_NAMES
 } from "./chunk-M5KM5SV7.js";
@@ -28,8 +28,8 @@ import "./chunk-TFBLQUAC.js";
 import {
   CI_ARGS,
   CI_UPGRADE_ARGS
-} from "./chunk-ACQ5HB32.js";
-import "./chunk-F5P3REI7.js";
+} from "./chunk-ICEJJDDA.js";
+import "./chunk-CTMKTFST.js";
 import "./chunk-GE7TKVTX.js";
 import "./chunk-NMVBVKLX.js";
 
@@ -43,7 +43,15 @@ function forCompletion(args) {
   const out = {};
   for (const [key, schema] of Object.entries(args)) {
     if (schema.hidden) continue;
-    out[schema.type === "positional" || !schema.toKebab ? key : kebabnize(key)] = schema;
+    const outKey = schema.type === "positional" || !schema.toKebab ? key : kebabnize(key);
+    const description = schema.description?.replace(/\s*\n\s*/g, " ");
+    out[outKey] = description === schema.description ? schema : { ...schema, description };
+  }
+  for (const [key, schema] of Object.entries(out)) {
+    const stripped = key.startsWith("no-") ? key.slice(3) : void 0;
+    if (stripped && !(stripped in out)) {
+      out[stripped] = { type: "positional", required: false, description: schema.description };
+    }
   }
   return out;
 }

package/dist/{docs-CRZC47P7.js → docs-XNKZQBBZ.js}

@@ -3,7 +3,7 @@ import {
   DOCS_ROOT_ARGS,
   DOCS_SHOW_ARGS,
   runDocsCliGunshi
-} from "./chunk-MBOONBC4.js";
+} from "./chunk-SLE22PPF.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-TFBLQUAC.js";
 import "./chunk-NMVBVKLX.js";

package/dist/{explain-52QDQUOY.js → explain-YPWGQE5N.js}

@@ -1,7 +1,7 @@
 import {
   EXPLAIN_ARGS,
   runExplainCliGunshi
-} from "./chunk-O2CQPUSP.js";
+} from "./chunk-JFLNGYPX.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-TFBLQUAC.js";
 import "./chunk-NMVBVKLX.js";

package/dist/gunshi-registry.js

@@ -1,18 +1,18 @@
 import {
   ROOT_ARGS
-} from "./chunk-P4YNVJUO.js";
-import "./chunk-VNVRHWO3.js";
+} from "./chunk-MZO3HVTN.js";
+import "./chunk-5UQ6P2M2.js";
 import {
   JA_ARG_DESCRIPTIONS
-} from "./chunk-MHRO4GU7.js";
+} from "./chunk-A5DVJX5O.js";
 import {
   INSTALL_ARGS
-} from "./chunk-4O5F7EUJ.js";
-import "./chunk-MUIOPL5F.js";
+} from "./chunk-77MMJCFK.js";
+import "./chunk-43FGGQQZ.js";
 import "./chunk-M5KM5SV7.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-TFBLQUAC.js";
-import "./chunk-F5P3REI7.js";
+import "./chunk-CTMKTFST.js";
 import "./chunk-GE7TKVTX.js";
 import "./chunk-NMVBVKLX.js";
 export {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { HeadTag, Config, RuleOptionsSpec, Severity, RuleSetting, Category, Result } from '@svelte-vitals/core';
+import { HeadTag, BranchStep, Config, RuleOptionsSpec, Severity, RuleSetting, Category, Result } from '@svelte-vitals/core';
 export { defineConfig } from '@svelte-vitals/core';
 import { AST } from 'svelte/compiler';
 
@@ -34,12 +34,37 @@ interface ParsedHeading {
     /** 1-based source line, or 0 if unknown. */
     line: number;
 }
+
+interface A11yNode {
+    kind: 'landmark' | 'id' | 'idref' | 'component';
+    /** landmark → 'main'|'banner'|'contentinfo'|'complementary'; id/idref → the literal id; component → component name */
+    key: string;
+    line: number;
+    /** inside {#each} body or {#snippet} definition at any depth (excluded from duplication counting) */
+    repeatable: boolean;
+    /** branch address from template root (empty = unconditional) */
+    path: BranchStep[];
+    /** for kind 'idref': the referencing attribute ('for', 'aria-labelledby', …, 'href') */
+    attr?: string;
+    /** the landmark ancestor element within this file, if any */
+    inLandmark?: string;
+    /** for kind 'landmark' from <header>/<footer>: at template top level in this file (which also implies "not inside sectioning content" — depth 0 has no ancestors at all) */
+    topLevel?: boolean;
+}
+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;
+}
 interface ParsedFile {
     headTags: ParsedTag[];
     components: ComponentUse[];
     imports: ImportMap;
     images: ParsedImage[];
     headings: ParsedHeading[];
+    a11y: ParsedA11y;
 }
 
 /**
@@ -231,6 +256,8 @@ interface AnalyzeResult {
     ruleIds: string[];
     /** Per-rule, per-declaration counts of places examined, unfiltered by `--diff`/`--baseline`/suppressions. */
     examined: Record<string, Record<string, number>>;
+    /** 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. */
     warnings: string[];
     /**

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   routeMatcher,
   run,
   spinnerEnabled
-} from "./chunk-VNVRHWO3.js";
+} from "./chunk-5UQ6P2M2.js";
 import {
   loadConfigFile
 } from "./chunk-M5KM5SV7.js";

package/dist/{install-3FI7M5BM.js → install-HE76S4ID.js}

@@ -1,12 +1,12 @@
 import {
   INSTALL_ARGS,
   runInstallCliGunshi
-} from "./chunk-4O5F7EUJ.js";
-import "./chunk-MUIOPL5F.js";
+} from "./chunk-77MMJCFK.js";
+import "./chunk-43FGGQQZ.js";
 import "./chunk-M5KM5SV7.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-TFBLQUAC.js";
-import "./chunk-F5P3REI7.js";
+import "./chunk-CTMKTFST.js";
 import "./chunk-GE7TKVTX.js";
 import "./chunk-NMVBVKLX.js";
 export {

package/dist/{ja-BCE5T3H2.js → ja-GAQSBSXF.js}

@@ -5,7 +5,7 @@ import {
   explainHelpJa,
   installHelpJa,
   rootHelpJa
-} from "./chunk-MHRO4GU7.js";
+} from "./chunk-A5DVJX5O.js";
 export {
   JA_ARG_DESCRIPTIONS,
   ciHelpJa,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "svelte-vitals",
-  "version": "0.45.1",
-  "description": "A deterministic SvelteKit code-health scanner (SEO, performance, correctness, security, architecture) — not a runtime Web Vitals reporter.",
+  "version": "0.47.0",
+  "description": "A deterministic SvelteKit code-health scanner (SEO, performance, correctness, security, architecture, accessibility) — not a runtime Web Vitals reporter.",
   "type": "module",
   "license": "MIT",
   "author": "Kazuma Oe (https://github.com/oekazuma)",
@@ -52,7 +52,7 @@
     "magicast": "^0.5.4",
     "svelte": "^5.56.8",
     "tinyglobby": "^0.2.17",
-    "@svelte-vitals/core": "0.41.1"
+    "@svelte-vitals/core": "0.43.0"
   },
   "devDependencies": {
     "@gunshi/docs": "0.37.1",