@svelte-vitals/vite 0.55.2 → 0.55.3

package/README.md

@@ -30,13 +30,13 @@ 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.
+- `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.js

@@ -1,4 +1,4 @@
-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-DxxU70UA.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";
@@ -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
 			}))

package/dist/index.d.ts

@@ -19,7 +19,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

package/dist/index.js

@@ -1,9 +1,10 @@
-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-DxxU70UA.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
 /** Map a prerendered HTML path (relative to pages/, POSIX) to its route. */
@@ -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
 			}))
@@ -150,6 +151,7 @@ async function collectRenderedProject(cwd, htmlLang) {
 		htmlLang,
 		...robotsReferencesSitemap !== void 0 ? { robotsReferencesSitemap } : {},
 		...kitPathsBase ? { kitPathsBase } : {},
+		...svelteConfig && findKitHashRouterInSvelteConfig(svelteConfig.source) ? { kitHashRouter: true } : {},
 		...kitAliases ? { kitAliases } : {},
 		...componentAliases !== kitAliases ? { componentAliases } : {}
 	};
@@ -272,11 +274,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 +283,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 +353,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 +365,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,16 +398,19 @@ 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,
@@ -925,6 +953,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 +965,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 +987,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}".`);
 		}

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

@@ -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"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svelte-vitals/vite",
-  "version": "0.55.2",
+  "version": "0.55.3",
   "description": "Vite/SvelteKit plugin for svelte-vitals — analyzes prerendered HTML during vite build, plus a live dev dashboard.",
   "type": "module",
   "license": "MIT",
@@ -43,9 +43,9 @@
     "node-html-parser": "^9.0.4"
   },
   "peerDependencies": {
-    "@svelte-vitals/core": "^0.55.2",
+    "@svelte-vitals/core": "^0.55.3",
     "@sveltejs/kit": "^2.0.0",
-    "svelte-vitals": "^0.55.2",
+    "svelte-vitals": "^0.55.3",
     "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",
+    "@svelte-vitals/core": "0.55.3",
     "@sveltejs/kit": "^2.70.3",
-    "@types/node": "^24.13.6",
+    "@types/node": "^24.19.1",
     "happy-dom": "^20.14.5",
-    "svelte": "^5.57.1",
-    "svelte-vitals": "0.55.2",
-    "vite": "^8.3.1"
+    "svelte": "^5.57.2",
+    "svelte-vitals": "0.55.3",
+    "vite": "^8.3.4"
   },
   "scripts": {
     "build": "tsdown",