@svelte-vitals/vite 0.55.4 → 0.56.0

package/README.md

@@ -38,7 +38,7 @@ export default {
 
 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,5 +1,4 @@
-import { Config, RuleSetting } from "@svelte-vitals/core";
-import { Handle } from "@sveltejs/kit";
+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. */
@@ -7,11 +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;
+export declare function svelteVitalsHandle(options?: SvelteVitalsHookOptions): SvelteVitalsHandle;
 export type { SvelteVitalsHookOptions };

package/dist/index.js

@@ -4,7 +4,7 @@ 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";
 // src/providers/rendered/collect.ts
 /** Map a prerendered HTML path (relative to pages/, POSIX) to its route. */
@@ -150,7 +150,7 @@ 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 } : {}
 	};
@@ -942,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",
@@ -954,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svelte-vitals/vite",
-  "version": "0.55.4",
+  "version": "0.56.0",
   "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.7"
   },
   "peerDependencies": {
-    "@svelte-vitals/core": "^0.55.4",
-    "@sveltejs/kit": "^2.0.0",
-    "svelte-vitals": "^0.55.4",
+    "@svelte-vitals/core": "^0.56.0",
+    "@sveltejs/kit": "^2.0.0 || ^3.0.0",
+    "svelte-vitals": "^0.56.0",
     "vite": "^5.0.3 || ^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -54,13 +54,13 @@
     }
   },
   "devDependencies": {
-    "@svelte-vitals/core": "0.55.4",
+    "@svelte-vitals/core": "0.56.0",
     "@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"
+    "svelte-vitals": "0.56.0",
+    "vite": "^8.3.7"
   },
   "scripts": {
     "build": "tsdown",