@svelte-vitals/vite 0.55.3 → 0.55.5

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.
+- `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 `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.
+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 the hash router 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,4 @@
-import { Config, RuleSetting } from "@svelte-vitals/core";
-import { Handle } from "@sveltejs/kit";
-//#region src/hooks/handle.d.ts
+import { RuleSetting } from "@svelte-vitals/core";
 /** 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. */
@@ -8,12 +6,33 @@ interface SvelteVitalsHookOptions {
   /** Per-rule overrides keyed by rule id, e.g. `{ 'seo/json-ld': 'off' }`. Mirrors the plugin option. */
   rules?: Record<string, RuleSetting>;
 }
+type MaybePromise<T> = T | Promise<T>;
+/** The part of a SvelteKit 2 or 3 `RequestEvent` this handle reads. */
+interface HandleEvent {
+  route: {
+    id: string | null;
+  };
+  url: URL;
+}
+/**
+ * Structural, so the package imports no SvelteKit type: `Handle` lives in a different module in
+ * each major. Generic in the event, because `resolve`'s parameter is checked contravariantly
+ * against SvelteKit's `RequestEvent`.
+ */
+type SvelteVitalsHandle = <E extends HandleEvent>(input: {
+  event: E;
+  resolve: (event: E, opts?: {
+    transformPageChunk?: (input: {
+      html: string;
+      done: boolean;
+    }) => MaybePromise<string | undefined>;
+  }) => MaybePromise<Response>;
+}) => MaybePromise<Response>;
 /**
  * SvelteKit `handle` that analyzes each visited page's rendered HTML, in dev only,
  * and (when the live dashboard is enabled) feeds the results in — upgrading that
  * route's dashboard findings from static (source-only) to `measured` (real rendered
  * HTML). Add it to `src/hooks.server.ts`, e.g. `sequence(svelteVitalsHandle())`.
  */
-export declare function svelteVitalsHandle(options?: SvelteVitalsHookOptions): Handle;
-//#endregion
+export declare function svelteVitalsHandle(options?: SvelteVitalsHookOptions): SvelteVitalsHandle;
 export type { SvelteVitalsHookOptions };

package/dist/hooks/index.js

@@ -1,8 +1,8 @@
-import { i as toOccurrenceMap, r as parseHtmlHead, t as isLoopbackOrigin } from "../loopback-DxxU70UA.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("|");
@@ -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;
@@ -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,12 +1,12 @@
-import { i as toOccurrenceMap, n as isSameOrigin, r as parseHtmlHead, t as isLoopbackOrigin } from "./loopback-DxxU70UA.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, 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, 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 { ROBOTS_SOURCE_PATHS, SITEMAP_SOURCE_PATHS, SVELTE_CONFIG_FILES, VITE_CONFIG_FILES, addFactsDirectives, allRules, buildJsonReport, collectComponentFacts, collectKitModuleFacts, collectSourceFiles, collectSuppressions, computeScore, defaultConfig, findMinifyDisabled, formatConsoleReport, formatFailedRuleWarning, formatJsonReportChunks, hasFailureAtOrAbove, isPlainObject, renderAppShell, resolveKitAliases, resolveKitHashRouter, 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$/, "");
@@ -89,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);
@@ -151,13 +150,12 @@ async function collectRenderedProject(cwd, htmlLang) {
 		htmlLang,
 		...robotsReferencesSitemap !== void 0 ? { robotsReferencesSitemap } : {},
 		...kitPathsBase ? { kitPathsBase } : {},
-		...svelteConfig && findKitHashRouterInSvelteConfig(svelteConfig.source) ? { kitHashRouter: true } : {},
+		...resolveKitHashRouter(viteConfig, svelteConfig) ? { 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/
@@ -184,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
@@ -207,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 {
@@ -237,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).
@@ -417,8 +412,7 @@ Scanned ${components.length} component(s) under src/ for Correctness/Security/Ar
 		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
@@ -449,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
@@ -495,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",
@@ -621,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
@@ -722,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
@@ -822,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",
@@ -953,7 +942,50 @@ function svelteVitals(options = {}) {
 	let minify;
 	let configFile;
 	let ssrBuild = false;
+	let appBuild = false;
 	let prerenderDir = DEFAULT_PRERENDER_DIR;
+	const readPrerenderDir = (base, outDir) => {
+		const out = outDir ? resolve(base, outDir) : "";
+		if (/[\\/]output[\\/](?:server|client)$/.test(out)) prerenderDir = join(dirname(out), "prerendered/pages");
+	};
+	/** `afterPrerender`: an absent pages dir means "nothing was prerendered" rather than "not yet". */
+	const analyzeAndGate = async (afterPrerender) => {
+		const pagesDir = options.prerenderDir ? options.prerenderDir : prerenderDir;
+		const resolved = isAbsolute(pagesDir) ? pagesDir : join(root, pagesDir);
+		if (!afterPrerender && !existsSync(resolved)) return;
+		const resolvedConfig = {
+			...await resolveConfig(root, options),
+			suppressions: loadSuppressions(root)
+		};
+		let result;
+		try {
+			const viteMinifyDisabled = await resolveMinifyDisabled(minify, configFile, root);
+			result = await analyze(resolved, root, options, viteMinifyDisabled ? { viteMinifyDisabled } : void 0, resolvedConfig);
+		} catch (err) {
+			warn(`svelte-vitals: skipped — analysis failed: ${err instanceof Error ? err.message : String(err)}`);
+			return;
+		}
+		for (const w of result.warnings) warn(`svelte-vitals: ${w}`);
+		if (result.routeCount === 0) {
+			if (!afterPrerender) return;
+			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) {
+			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.jsonReportChunks());
+		}
+		if (result.failed) throw new Error(`svelte-vitals: build failed — findings at or above "${result.failOn}".`);
+	};
 	const buildPlugin = {
 		name: "svelte-vitals",
 		apply: "build",
@@ -965,45 +997,21 @@ 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");
+			appBuild = Boolean(config.builder);
+			readPrerenderDir(config.root ?? root, config.build?.outDir);
 		},
 		async closeBundle() {
-			const pagesDir = options.prerenderDir ? options.prerenderDir : prerenderDir;
-			const resolved = isAbsolute(pagesDir) ? pagesDir : join(root, pagesDir);
-			if (!ssrBuild && !existsSync(resolved)) return;
-			const resolvedConfig = {
-				...await resolveConfig(root, options),
-				suppressions: loadSuppressions(root)
-			};
-			let result;
-			try {
-				const viteMinifyDisabled = await resolveMinifyDisabled(minify, configFile, root);
-				result = await analyze(resolved, root, options, viteMinifyDisabled ? { viteMinifyDisabled } : void 0, resolvedConfig);
-			} catch (err) {
-				warn(`svelte-vitals: skipped — analysis failed: ${err instanceof Error ? err.message : String(err)}`);
-				return;
-			}
-			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 ${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) {
-				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.jsonReportChunks());
+			if (appBuild) return;
+			await analyzeAndGate(ssrBuild);
+		},
+		buildApp: {
+			order: "post",
+			async handler(builder) {
+				if (!appBuild) return;
+				readPrerenderDir(root, builder.environments.ssr?.config.build.outDir);
+				minify = builder.environments.client?.config.build.minify ?? minify;
+				await analyzeAndGate(true);
 			}
-			if (result.failed) throw new Error(`svelte-vitals: build failed — findings at or above "${result.failOn}".`);
 		}
 	};
 	if (options.ui === false) return buildPlugin;
@@ -1078,5 +1086,4 @@ function svelteVitals(options = {}) {
 		}
 	}];
 }
-//#endregion
 export { svelteVitals };

package/dist/{loopback-DxxU70UA.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;
@@ -202,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 {
@@ -234,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.3",
+  "version": "0.55.5",
   "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.3",
-    "@sveltejs/kit": "^2.0.0",
-    "svelte-vitals": "^0.55.3",
+    "@svelte-vitals/core": "^0.55.5",
+    "@sveltejs/kit": "^2.0.0 || ^3.0.0",
+    "svelte-vitals": "^0.55.5",
     "vite": "^5.0.3 || ^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -54,13 +54,13 @@
     }
   },
   "devDependencies": {
-    "@svelte-vitals/core": "0.55.3",
-    "@sveltejs/kit": "^2.70.3",
-    "@types/node": "^24.19.1",
-    "happy-dom": "^20.14.5",
-    "svelte": "^5.57.2",
-    "svelte-vitals": "0.55.3",
-    "vite": "^8.3.4"
+    "@svelte-vitals/core": "0.55.5",
+    "@sveltejs/kit": "^2.70.4",
+    "@types/node": "^24.19.2",
+    "happy-dom": "^21.0.4",
+    "svelte": "^5.57.3",
+    "svelte-vitals": "0.55.5",
+    "vite": "^8.3.6"
   },
   "scripts": {
     "build": "tsdown",