@svelte-vitals/vite 0.55.2 → 0.55.4

package/README.md

@@ -30,13 +30,15 @@ export default {
 - `outFile`: write the JSON report to a path.
 - `rules` / `metaComponents` / `treatDynamicAs`: same as the CLI/core config.
 - `weights`: per-category weight overrides for the combined Health score.
-- `prerenderDir`: override the prerendered-pages directory.
+- `overrides`: route- and file-scoped rule overrides, same as the config file's `overrides`.
+- `seo`: `{ indexable?: boolean }`; `indexable: false` turns off the search-result rules.
+- `prerenderDir`: override the prerendered-pages directory (default: `output/prerendered/pages` under `kit.outDir`).
 - `cwd`: project root (defaults to the Vite config root).
 - `ui`: serve the live dev dashboard (default `true`); pass `false` to keep only the build-time gate.
 
 A `svelte-vitals.config.*` and a `svelte-vitals-suppressions.json` in the project root are read automatically (explicit options win over the config file). Only source-scan suppression entries apply; route-level entries are skipped on every plugin surface (rendered route findings anchor to the built HTML) and the plugin says how many.
 
-At build time the HTML check covers prerendered routes only; the source scan applies project-wide. Routes that are not prerendered (server-rendered, or dynamic routes without prerendered entries) have no build output, so nothing checks their rendered HTML here. A prerendered route with `ssr = false` has build output, but only the empty app shell, so the HTML check skips it too (a `+layout` with `ssr = false` skips its subtree) and prints one warning listing the skipped routes. The `svelte-vitals` CLI covers them by source analysis, and browsing them during `vite dev` gets the live dashboard a rendered reading. When the build prerenders nothing at all (an SPA served from a fallback page, say), the plugin prints one warning that route analysis was skipped and still runs and gates the source scan; `seo/html-lang`, which reads the rendered `<html>`, is skipped with it.
+At build time the HTML check covers prerendered routes only; the source scan applies project-wide. Routes that are not prerendered (server-rendered, or dynamic routes without prerendered entries) have no build output, so nothing checks their rendered HTML here. A prerendered route with `ssr = false` has build output, but only the empty app shell, so the HTML check skips it too (a `+layout` with `ssr = false` skips its subtree, and `kit.router.type: 'hash'` every route) and prints one warning listing the skipped routes. The `svelte-vitals` CLI covers them by source analysis, and browsing them during `vite dev` gets the live dashboard a rendered reading. When the build prerenders nothing at all (an SPA served from a fallback page, say), the plugin prints one warning that route analysis was skipped and still runs and gates the source scan; `seo/html-lang`, which reads the rendered `<html>`, is skipped with it.
 
 See [Live dashboard](https://oekazuma.github.io/svelte-vitals/guides/dev-dashboard/) and [Plugin mode](https://oekazuma.github.io/svelte-vitals/guides/plugin-mode/) for the full picture.
 

package/dist/hooks/index.d.ts

@@ -1,6 +1,5 @@
 import { Config, RuleSetting } from "@svelte-vitals/core";
 import { Handle } from "@sveltejs/kit";
-//#region src/hooks/handle.d.ts
 /** Options for the dev-time SvelteKit handle. A focused subset of the plugin options. */
 interface SvelteVitalsHookOptions {
   /** Component names treated as meta sources (design §11 layer 4). Mirrors the plugin option. */
@@ -15,5 +14,4 @@ interface SvelteVitalsHookOptions {
  * HTML). Add it to `src/hooks.server.ts`, e.g. `sequence(svelteVitalsHandle())`.
  */
 export declare function svelteVitalsHandle(options?: SvelteVitalsHookOptions): Handle;
-//#endregion
 export type { SvelteVitalsHookOptions };

package/dist/hooks/index.js

@@ -1,8 +1,8 @@
-import { i as toOccurrenceMap, r as parseHtmlHead, t as isLoopbackOrigin } from "../loopback-CAFo1WZs.js";
+import { i as toOccurrenceMap, r as parseHtmlHead, t as isLoopbackOrigin } from "../loopback-D_07LGfE.js";
 import { defineConfig } from "@svelte-vitals/core";
 import { allRules, defaultProject, effectiveSeverity, formatFailedRuleWarning, isPenalized, runAnalysis, selectRules, terminalSafe } from "@svelte-vitals/core/internal";
 import { DEV } from "esm-env";
-//#region src/hooks/handle.ts
+// src/hooks/handle.ts
 /** Stable signature of a route's penalized findings, so ingest is skipped when a repeat visit finds nothing new. */
 function findingSignature(results, config) {
 	return results.filter((r) => isPenalized(r.detection, config.treatDynamicAs)).map((r) => `${r.id}:${effectiveSeverity(r, config)}:${r.detection.presence}:${r.detection.value}`).sort().join("|");
@@ -49,8 +49,8 @@ async function analyzeAndIngest(html, route, origin, rules, config, queued, infl
 		};
 		const headings = [{
 			route,
-			headings: levels.map((level) => ({
-				level,
+			headings: levels.map((h) => ({
+				...h,
 				line: 0,
 				file: route
 			}))
@@ -130,5 +130,4 @@ function svelteVitalsHandle(options = {}) {
 		} });
 	};
 }
-//#endregion
 export { svelteVitalsHandle };

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { Category, Config, RuleOverride, RuleSetting, Severity, TreatDynamicAs } from "@svelte-vitals/core";
 import { Plugin } from "vite";
-//#region src/plugin.d.ts
 interface SvelteVitalsOptions {
   /** Project root (defaults to the Vite config root / cwd). */
   cwd?: string;
@@ -19,7 +18,7 @@ interface SvelteVitalsOptions {
   report?: 'console' | 'json' | false;
   /** Write the JSON report to this path. */
   outFile?: string;
-  /** Override the prerendered-pages directory (default: .svelte-kit/output/prerendered/pages). */
+  /** Override the prerendered-pages directory (default: `output/prerendered/pages` under SvelteKit's `kit.outDir`). */
   prerenderDir?: string;
   /**
    * Serve a live dashboard at /__svelte-vitals/ during `vite dev` (add
@@ -31,5 +30,4 @@ interface SvelteVitalsOptions {
 }
 /** svelte-vitals Vite/SvelteKit plugin. */
 export declare function svelteVitals(options?: SvelteVitalsOptions): Plugin | Plugin[];
-//#endregion
 export type { SvelteVitalsOptions };

package/dist/index.js

@@ -1,11 +1,12 @@
-import { i as toOccurrenceMap, n as isSameOrigin, r as parseHtmlHead, t as isLoopbackOrigin } from "./loopback-CAFo1WZs.js";
+import { i as toOccurrenceMap, n as isSameOrigin, r as parseHtmlHead, t as isLoopbackOrigin } from "./loopback-D_07LGfE.js";
+import { once } from "node:events";
 import { existsSync, readFileSync } from "node:fs";
 import { access, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
-import { basename, dirname, isAbsolute, join, relative, sep } from "node:path";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { CATEGORIES, defineConfig } from "@svelte-vitals/core";
-import { ROBOTS_SOURCE_PATHS, SITEMAP_SOURCE_PATHS, SVELTE_CONFIG_FILES, VITE_CONFIG_FILES, addFactsDirectives, allRules, buildJsonReport, collectComponentFacts, collectKitModuleFacts, collectSourceFiles, collectSuppressions, computeScore, defaultConfig, findMinifyDisabled, formatConsoleReport, formatFailedRuleWarning, formatJsonReport, hasFailureAtOrAbove, isPlainObject, renderAppShell, resolveKitAliases, resolveKitPathsBase, resolveRuleOptions, runAnalysis, safeHref, selectRules, servesRootFile, shouldSkipRangeCheck, skippedFileWarnings, summarize, terminalSafe, unknownDirectiveIds, validateRuleSetting, withFailedRulesOff, withIndexableOff, withPackageImports, withWorkspacePackages } from "@svelte-vitals/core/internal";
+import { ROBOTS_SOURCE_PATHS, SITEMAP_SOURCE_PATHS, SVELTE_CONFIG_FILES, VITE_CONFIG_FILES, addFactsDirectives, allRules, buildJsonReport, collectComponentFacts, collectKitModuleFacts, collectSourceFiles, collectSuppressions, computeScore, defaultConfig, findKitHashRouterInSvelteConfig, findMinifyDisabled, formatConsoleReport, formatFailedRuleWarning, formatJsonReportChunks, hasFailureAtOrAbove, isPlainObject, renderAppShell, resolveKitAliases, resolveKitPathsBase, resolveRuleOptions, routeNeverSsr, runAnalysis, safeHref, selectRules, servesRootFile, shouldSkipRangeCheck, skippedFileWarnings, summarize, terminalSafe, unknownDirectiveIds, validateRuleSetting, withFailedRulesOff, withIndexableOff, withPackageImports, withWorkspacePackages } from "@svelte-vitals/core/internal";
 import { CONFIG_FILENAMES, SUPPRESSIONS_FILE, analyzeProject, applySuppressions, createNodeRuntime, dropConstantListEachBlocks, findUnknownRuleIds, findWorkspacePackages, knownRuleIds, loadConfigFile, loadSuppressions, registryTag, ruleOptionsSpec } from "svelte-vitals";
-//#region src/providers/rendered/collect.ts
+// src/providers/rendered/collect.ts
 /** Map a prerendered HTML path (relative to pages/, POSIX) to its route. */
 function deriveRouteFromHtmlPath(relPath) {
 	let p = relPath.replace(/\\/g, "/").replace(/\.html$/, "");
@@ -46,8 +47,8 @@ async function collectRenderedHeads(prerenderPagesDir) {
 		});
 		headings.push({
 			route,
-			headings: parsed.headings.map((level) => ({
-				level,
+			headings: parsed.headings.map((h) => ({
+				...h,
 				line: 0,
 				file: rel
 			}))
@@ -88,8 +89,7 @@ async function collectRenderedHeads(prerenderPagesDir) {
 		htmlLang
 	};
 }
-//#endregion
-//#region src/providers/rendered/project.ts
+// src/providers/rendered/project.ts
 async function exists(path) {
 	try {
 		await access(path);
@@ -150,12 +150,12 @@ async function collectRenderedProject(cwd, htmlLang) {
 		htmlLang,
 		...robotsReferencesSitemap !== void 0 ? { robotsReferencesSitemap } : {},
 		...kitPathsBase ? { kitPathsBase } : {},
+		...svelteConfig && findKitHashRouterInSvelteConfig(svelteConfig.source) ? { kitHashRouter: true } : {},
 		...kitAliases ? { kitAliases } : {},
 		...componentAliases !== kitAliases ? { componentAliases } : {}
 	};
 }
-//#endregion
-//#region src/providers/source/components.ts
+// src/providers/source/components.ts
 const nodeRuntime = createNodeRuntime();
 /**
 * Scan every `.svelte` component under `src/` for Correctness/Security/Architecture/
@@ -182,8 +182,7 @@ function collectKitModuleFacts$1(root, aliases) {
 function collectSourceFiles$1(root) {
 	return collectSourceFiles(nodeRuntime, root);
 }
-//#endregion
-//#region src/suppressions.ts
+// src/suppressions.ts
 /**
 * Apply `svelte-vitals-suppressions.json` the way every plugin surface must: source-scan entries
 * only. A route-level entry (route starting with `/`) is written by the CLI against
@@ -205,8 +204,7 @@ function applySourceSuppressions(results, entries, config) {
 		notices
 	};
 }
-//#endregion
-//#region src/version.ts
+// src/version.ts
 /** Read this package's version from its own package.json so the report never drifts. */
 function readPackageVersion() {
 	try {
@@ -235,8 +233,7 @@ function readCoreVersion() {
 		return "0.0.0";
 	}
 }
-//#endregion
-//#region src/analyze.ts
+// src/analyze.ts
 /**
 * Merge plugin options over an optional loaded config file, per-field precedence (an
 * explicit `options` value wins, otherwise the file, otherwise the built-in default).
@@ -272,11 +269,6 @@ async function resolveConfig(cwd, options) {
 		warnings: loaded?.warnings ?? []
 	};
 }
-/**
-* `ssr` is a page option: only `+page`/`+layout` modules (universal or server) can set it. Same
-* file set as `PAGE_OPTION_FILE_RE` in core's `rules/seo/ssr-disabled.ts`, which reports the fact.
-*/
-const PAGE_OPTION_FILE_RE = /^src\/routes\/(.*?)\/?\+(page|layout)(?:\.server)?\.[jt]s$/;
 function escapeRegExp(s) {
 	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -286,27 +278,54 @@ function segmentPattern(segment) {
 	if (/^\[\[[^\]]+\]\]$/.test(segment)) return "(?:/[^/]+)?";
 	return "/" + segment.split(/\[[^\]]+\]/).map(escapeRegExp).join("[^/]+");
 }
+/** A route's page component, with an optional `@segment` layout reset. */
+const PAGE_FILE_RE = /^src\/routes\/(.*?)\/?\+page(?:@[^/]*)?\.svelte$/;
+/** A module that can set the `ssr` page option (same file set as core's `seo/ssr-disabled`). */
+const PAGE_OPTION_FILE_RE = /^src\/routes\/(.*?)\/?\+(page|layout)(?:\.server)?\.[jt]s$/;
+/** A route directory as a pattern over rendered paths: `(group)` directories are not URL segments. */
+function routePattern(dir, subtree) {
+	const path = dir.split("/").filter((s) => s !== "" && !/^\(.+\)$/.test(s)).map(segmentPattern).join("");
+	return new RegExp(subtree ? `^${path}(?:/.*)?$` : `^${path}$`);
+}
 /**
 * Routes whose prerendered HTML is the app shell rather than the page: SvelteKit still writes a
 * file for an `ssr = false` route, but its `<head>` and body only exist once the client renders,
-* so every rendered head/heading/landmark check would report the page as empty. A `+layout`
-* covers its whole subtree, a `+page` only its own route; `(group)` directories are not URL
-* segments. Two ceilings: a child route re-enabling `ssr = true` under a disabled layout is not
-* tracked, and Kit's route precedence is not modelled, so a `[param]` route also claims a literal
-* sibling (`/docs/[slug]` matches a prerendered `/docs/intro`) — the warning lists the skipped
-* routes so a wrong skip is visible.
+* so every rendered head/heading/landmark check would report the page as empty. Each page takes the
+* nearest `ssr` export along its own files and its layout chain, resets followed, as the CLI reads it
+* (`routeNeverSsr`), so a page that sets `ssr = true` under a disabled layout is read. Only a literal
+* `true` turns SSR back on here: an option file that did not parse, or an `ssr` export the analyzer
+* cannot read (an imported value), inherits instead, since analyzing a shell would report it empty,
+* and a route no page in `sourceFiles` can match is a shell when any `ssr = false` module's
+* route covers it. Kit's route precedence is not modelled: a route is a shell when any page whose
+* path can match it is, so `/docs/[slug]` with `ssr = false` also claims a prerendered `/docs/intro`
+* — the warning lists the skipped routes so a wrong skip is visible.
 */
-function ssrDisabledRouteMatcher(kitModules) {
-	const patterns = [];
+function ssrDisabledRouteMatcher(kitModules, sourceFiles) {
+	const scope = {
+		kitModules: kitModules.map((m) => m.parseFailed || m.ssrEnabled && !m.ssrTrue ? {
+			...m,
+			parseFailed: void 0,
+			ssrEnabled: void 0
+		} : m),
+		sourceFiles: [...sourceFiles]
+	};
+	const pages = [];
+	for (const file of sourceFiles) {
+		const match = PAGE_FILE_RE.exec(file);
+		if (match) pages.push({
+			pattern: routePattern(match[1], false),
+			shell: routeNeverSsr(file, scope)
+		});
+	}
+	const disabled = [];
 	for (const m of kitModules) {
 		const match = m.ssrDisabled ? PAGE_OPTION_FILE_RE.exec(m.file) : null;
-		if (!match) continue;
-		const path = match[1].split("/").filter((s) => s !== "" && !/^\(.+\)$/.test(s)).map(segmentPattern).join("");
-		patterns.push(new RegExp(match[2] === "layout" ? `^${path}(?:/.*)?$` : `^${path}$`));
+		if (match) disabled.push(routePattern(match[1], match[2] === "layout"));
 	}
 	return (route) => {
 		const r = route === "/" ? "" : route;
-		return patterns.some((p) => p.test(r));
+		const matched = pages.filter((p) => p.pattern.test(r));
+		return matched.length > 0 ? matched.some((p) => p.shell) : disabled.some((p) => p.test(r));
 	};
 }
 /**
@@ -329,7 +348,8 @@ async function analyze(prerenderPagesDir, cwd, options, extraProjectFacts, resol
 		...extraProjectFacts
 	};
 	const [kitModules, components] = await Promise.all([collectKitModuleFacts$1(cwd, project.kitAliases), dropConstantListEachBlocks$1(cwd, componentFacts, project.componentAliases ?? project.kitAliases)]);
-	const isShell = ssrDisabledRouteMatcher(kitModules);
+	const isShell = project.kitHashRouter ? () => true : ssrDisabledRouteMatcher(kitModules, sourceFiles);
+	const shellCause = project.kitHashRouter ? "the hash router" : "ssr = false";
 	const keep = (items) => items.filter((i) => !isShell(i.route));
 	const heads = keep(rendered.heads);
 	const headings = keep(rendered.headings);
@@ -340,7 +360,7 @@ async function analyze(prerenderPagesDir, cwd, options, extraProjectFacts, resol
 	if (shells.length > 0) {
 		const shown = shells.slice(0, 10);
 		const list = shells.length > shown.length ? `${shown.join(", ")}, … and ${shells.length - shown.length} more` : shown.join(", ");
-		warnings.push(`skipped ${shells.length} prerendered route(s) with ssr = false — their HTML is the app shell, not the page; run \`npx svelte-vitals\` to check them from source: ${list}`);
+		warnings.push(`skipped ${shells.length} prerendered route(s) with ${shellCause} — their HTML is the app shell, not the page; run \`npx svelte-vitals\` to check them from source: ${list}`);
 	}
 	if (selected.some((r) => r.id === "a11y/unverified-id-ref")) warnings.push("a11y/unverified-id-ref has no effect in rendered mode — the prerendered document is always fully resolved.");
 	const directives = /* @__PURE__ */ new Map();
@@ -373,24 +393,26 @@ async function analyze(prerenderPagesDir, cwd, options, extraProjectFacts, resol
 	const { score } = computeScore(results, scoringConfig);
 	const summary = summarize(results, scoringConfig);
 	const failed = hasFailureAtOrAbove(summary, scoringConfig.failOn);
-	const coverageNote = `Analyzed ${heads.length} prerendered route(s)${shells.length > 0 ? ` (skipped ${shells.length} with ssr = false)` : ""}. SSR/dynamic routes are not covered — run \`npx svelte-vitals\` for those.
+	const coverageNote = `Analyzed ${heads.length} prerendered route(s)${shells.length > 0 ? ` (skipped ${shells.length} with ${shellCause})` : ""}. SSR/dynamic routes are not covered — run \`npx svelte-vitals\` for those.
 Scanned ${components.length} component(s) under src/ for Correctness/Security/Architecture/Accessibility/Bundle findings.`;
 	const consoleReport = formatConsoleReport(results, scoringConfig, { mode: "rendered / plugin" }) + "\n" + coverageNote + "\n";
-	const jsonReport = formatJsonReport(results, scoringConfig, { version: readPackageVersion() }, selected.map((r) => r.id), examined);
+	const jsonReportChunks = () => formatJsonReportChunks(results, scoringConfig, { version: readPackageVersion() }, selected.map((r) => r.id), examined);
 	return {
 		score,
 		summary,
 		results,
 		consoleReport,
-		jsonReport,
+		get jsonReport() {
+			return [...jsonReportChunks()].join("");
+		},
+		jsonReportChunks,
 		routeCount: rendered.heads.length,
 		failed,
 		failOn: scoringConfig.failOn,
 		warnings
 	};
 }
-//#endregion
-//#region src/minify-flag.ts
+// src/minify-flag.ts
 /**
 * performance/minify-disabled fact from the evaluated Vite user config (the value the plugin's
 * `config` hook sees) — exact, so it also catches function-form/conditional configs the CLI's
@@ -421,8 +443,7 @@ async function resolveMinifyDisabled(minify, configFile, root) {
 		...suppressions !== void 0 ? { suppressions } : {}
 	};
 }
-//#endregion
-//#region src/ui/snapshot.ts
+// src/ui/snapshot.ts
 /**
 * `docsUrl` on an ingested (live) result flows into `/data.json` responses, which the
 * client script renders into an <a href> without going through `renderAppShell`'s own
@@ -467,8 +488,7 @@ function buildSnapshot(store, config, meta, staticFailedRuleIds) {
 		meta
 	};
 }
-//#endregion
-//#region src/ui/middleware.ts
+// src/ui/middleware.ts
 const SEVERITIES = /* @__PURE__ */ new Set([
 	"critical",
 	"warning",
@@ -593,8 +613,7 @@ function installUiMiddleware(server, config, version, store, coreVersion, getSta
 		}
 	});
 }
-//#endregion
-//#region src/ui/store.ts
+// src/ui/store.ts
 /**
 * Merge rule (design doc §2): for a route with a live result set, static results whose
 * rule id appears in the live payload are replaced by the live ones — the handle reports
@@ -694,8 +713,7 @@ function createStore() {
 		}
 	};
 }
-//#endregion
-//#region src/ui/analysis.ts
+// src/ui/analysis.ts
 /**
 * Apply `svelte-vitals-suppressions.json` to the whole-project layer, same entries as the build
 * gate (see `applySourceSuppressions`). A malformed file is a warning here, not an error: dev
@@ -794,8 +812,7 @@ function createAnalysisRunner(opts) {
 		}
 	};
 }
-//#endregion
-//#region src/plugin.ts
+// src/plugin.ts
 const CONFIG_BASENAMES = /* @__PURE__ */ new Set([
 	"svelte.config.js",
 	"svelte.config.ts",
@@ -925,6 +942,7 @@ function svelteVitals(options = {}) {
 	let minify;
 	let configFile;
 	let ssrBuild = false;
+	let prerenderDir = DEFAULT_PRERENDER_DIR;
 	const buildPlugin = {
 		name: "svelte-vitals",
 		apply: "build",
@@ -936,9 +954,11 @@ function svelteVitals(options = {}) {
 			if (!options.cwd) root = config.root;
 			configFile = config.configFile;
 			ssrBuild = Boolean(config.build?.ssr);
+			const out = config.build?.outDir ? resolve(config.root ?? root, config.build.outDir) : "";
+			if (/[\\/]output[\\/](?:server|client)$/.test(out)) prerenderDir = join(dirname(out), "prerendered/pages");
 		},
 		async closeBundle() {
-			const pagesDir = options.prerenderDir ? options.prerenderDir : join(root, DEFAULT_PRERENDER_DIR);
+			const pagesDir = options.prerenderDir ? options.prerenderDir : prerenderDir;
 			const resolved = isAbsolute(pagesDir) ? pagesDir : join(root, pagesDir);
 			if (!ssrBuild && !existsSync(resolved)) return;
 			const resolvedConfig = {
@@ -956,16 +976,21 @@ function svelteVitals(options = {}) {
 			for (const w of result.warnings) warn(`svelte-vitals: ${w}`);
 			if (result.routeCount === 0) {
 				if (!ssrBuild) return;
-				warn(`svelte-vitals: no prerendered pages found in ${options.prerenderDir ?? DEFAULT_PRERENDER_DIR} — route analysis skipped; the source scan still ran. Prerender routes to check their HTML, or run \`npx svelte-vitals\` to check every route from source.`);
+				warn(`svelte-vitals: no prerendered pages found in ${relative(root, resolved) || "."} — route analysis skipped; the source scan still ran. Prerender routes to check their HTML, or run \`npx svelte-vitals\` to check every route from source.`);
 			}
 			if (options.report !== false) {
-				const out = options.report === "json" ? result.jsonReport : result.consoleReport;
-				console.log(out);
+				if (options.report === "json") {
+					for (const chunk of result.jsonReportChunks()) {
+						if (process.stdout.destroyed) break;
+						if (!process.stdout.write(chunk)) await once(process.stdout, "drain");
+					}
+					process.stdout.write("\n");
+				} else console.log(result.consoleReport);
 			}
 			if (options.outFile) {
 				const outPath = isAbsolute(options.outFile) ? options.outFile : join(root, options.outFile);
 				await mkdir(dirname(outPath), { recursive: true });
-				await writeFile(outPath, result.jsonReport);
+				await writeFile(outPath, result.jsonReportChunks());
 			}
 			if (result.failed) throw new Error(`svelte-vitals: build failed — findings at or above "${result.failOn}".`);
 		}
@@ -1042,5 +1067,4 @@ function svelteVitals(options = {}) {
 		}
 	}];
 }
-//#endregion
 export { svelteVitals };

package/dist/{loopback-CAFo1WZs.js → loopback-D_07LGfE.js}

@@ -1,6 +1,6 @@
 import { ASIDE_DEMOTING_TAGS, IDREF_ATTRS, NAMING_ATTRS, SECTIONING_TAGS, decodeFragmentId, isClassicScriptType, isSvgSrc, isTopFragment, resolveLandmark, splitTokens, stripTextDirective } from "@svelte-vitals/core/internal";
 import { parse } from "node-html-parser";
-//#region src/providers/rendered/parse-html.ts
+// src/providers/rendered/parse-html.ts
 /** The <img> is its `<picture>`'s fallback and a sibling `<source>` carries the srcset. */
 function pictureOffersSrcset(img) {
 	const parent = img.parentNode;
@@ -171,7 +171,15 @@ function parseHtmlHead(html) {
 			presence: "own",
 			value: attrValue(lang)
 		},
-		headings: (root.querySelector("body") ?? root).querySelectorAll("h1,h2,h3,h4,h5,h6").map((el) => Number(el.rawTagName[1])),
+		headings: (root.querySelector("body") ?? root).querySelectorAll("h1,h2,h3,h4,h5,h6,[role]").flatMap((el) => {
+			if (/^h[1-6]$/i.test(el.rawTagName)) return [{ level: Number(el.rawTagName[1]) }];
+			if (el.getAttribute("role")?.trim().toLowerCase() !== "heading") return [];
+			const level = Number(el.getAttribute("aria-level") ?? 2);
+			return [{
+				level: Number.isInteger(level) && level >= 1 ? level : 0,
+				aria: true
+			}];
+		}),
 		images: (root.querySelector("body") ?? root).querySelectorAll("img").map((img) => ({
 			hasWidth: img.hasAttribute("width"),
 			hasHeight: img.hasAttribute("height"),
@@ -194,8 +202,7 @@ function toOccurrenceMap(keys, file) {
 	});
 	return out;
 }
-//#endregion
-//#region src/loopback.ts
+// src/loopback.ts
 /** Only the local dev server hosts the ingest endpoint, so never POST off-box. */
 function isLoopbackOrigin(origin) {
 	try {
@@ -226,5 +233,4 @@ function isSameOrigin(origin, host, secure = false) {
 function effectivePort(url) {
 	return url.port || (url.protocol === "https:" ? "443" : "80");
 }
-//#endregion
 export { toOccurrenceMap as i, isSameOrigin as n, parseHtmlHead as r, isLoopbackOrigin as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svelte-vitals/vite",
-  "version": "0.55.2",
+  "version": "0.55.4",
   "description": "Vite/SvelteKit plugin for svelte-vitals — analyzes prerendered HTML during vite build, plus a live dev dashboard.",
   "type": "module",
   "license": "MIT",
@@ -40,12 +40,12 @@
   ],
   "dependencies": {
     "esm-env": "^1.2.2",
-    "node-html-parser": "^9.0.4"
+    "node-html-parser": "^9.0.7"
   },
   "peerDependencies": {
-    "@svelte-vitals/core": "^0.55.2",
+    "@svelte-vitals/core": "^0.55.4",
     "@sveltejs/kit": "^2.0.0",
-    "svelte-vitals": "^0.55.2",
+    "svelte-vitals": "^0.55.4",
     "vite": "^5.0.3 || ^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -54,13 +54,13 @@
     }
   },
   "devDependencies": {
-    "@svelte-vitals/core": "0.55.2",
-    "@sveltejs/kit": "^2.70.3",
-    "@types/node": "^24.13.6",
-    "happy-dom": "^20.14.5",
-    "svelte": "^5.57.1",
-    "svelte-vitals": "0.55.2",
-    "vite": "^8.3.1"
+    "@svelte-vitals/core": "0.55.4",
+    "@sveltejs/kit": "^2.70.4",
+    "@types/node": "^24.19.2",
+    "happy-dom": "^21.0.4",
+    "svelte": "^5.57.3",
+    "svelte-vitals": "0.55.4",
+    "vite": "^8.3.6"
   },
   "scripts": {
     "build": "tsdown",