svelte-vitals 0.9.0 → 0.10.0

package/dist/bin.js

@@ -6,7 +6,7 @@ import {
   knownRuleIds,
   readPackageVersion,
   run
-} from "./chunk-Y56I4RGY.js";
+} from "./chunk-U7HHKAJX.js";
 
 // src/bin.ts
 import mri from "mri";
@@ -39,7 +39,7 @@ function resolveArgs(argv) {
   } else if (typeof argv.reporter === "string") {
     if (!isReporterName(argv.reporter)) {
       errors.push(
-        `svelte-vitals: unknown reporter '${argv.reporter}'. Valid values: console, json, agent, sarif, github.`
+        `svelte-vitals: unknown reporter '${argv.reporter}'. Valid values: console, json, agent, sarif, github, html.`
       );
     } else {
       reporter = argv.reporter;
@@ -61,6 +61,7 @@ function resolveArgs(argv) {
       treatDynamicAs,
       route,
       reporter,
+      outFile: typeof argv["out-file"] === "string" ? argv["out-file"] : void 0,
       byRoute: Boolean(argv["by-route"]),
       failOn,
       rules: buildRulesConfig(allow, ignore)
@@ -81,7 +82,8 @@ Options:
   --treat-dynamic-as <mode>   pass | warn | fail (default: pass)
   --route <glob>              Only analyze routes matching this glob
   --by-route                  Show per-route score breakdown in console output
-  --reporter <fmt>            console | json | agent | sarif | github (auto: agent under AI-agent envs, github under GitHub Actions)
+  --reporter <fmt>            console | json | agent | sarif | github | html (auto: agent under AI-agent envs, github under GitHub Actions)
+  --out-file <path>           Output path for --reporter html (default: svelte-vitals-report.html; '-' for stdout)
   --json                      Alias for --reporter=json
   --fail-on <severity>        Fail (exit 1) when any finding reaches this severity: critical | warning | info
   --fail-on-warning           Alias for --fail-on=warning
@@ -100,7 +102,17 @@ async function main() {
   const argv = mri(process.argv.slice(2), {
     alias: { h: "help", v: "version" },
     boolean: ["by-route", "json", "fail-on-warning"],
-    string: ["meta-components", "treat-dynamic-as", "route", "fail-on", "reporter", "rules", "ignore", "min-health"]
+    string: [
+      "meta-components",
+      "treat-dynamic-as",
+      "route",
+      "fail-on",
+      "reporter",
+      "rules",
+      "ignore",
+      "min-health",
+      "out-file"
+    ]
   });
   if (argv.help) {
     console.log(HELP);

package/dist/{chunk-Y56I4RGY.js → chunk-U7HHKAJX.js}

@@ -1,4 +1,6 @@
 // src/index.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { dirname } from "path";
 import {
   allRules as allRules2,
   runRules,
@@ -7,6 +9,7 @@ import {
   formatAgentReport,
   formatSarifReport,
   formatGithubReport,
+  formatHtmlReport,
   summarize,
   hasFailureAtOrAbove,
   computeHealth,
@@ -486,7 +489,7 @@ function readPackageVersion() {
 // src/reporter-resolve.ts
 var AGENT_ENV_VARS = ["CLAUDECODE", "SVELTE_VITALS_AGENT"];
 function isReporterName(value) {
-  return value === "console" || value === "json" || value === "agent" || value === "sarif" || value === "github";
+  return value === "console" || value === "json" || value === "agent" || value === "sarif" || value === "github" || value === "html";
 }
 function isAgentEnv(env = process.env) {
   return AGENT_ENV_VARS.some((key) => {
@@ -604,6 +607,19 @@ async function run(opts = {}) {
     } else if (reporter === "github") {
       const output = formatGithubReport(results, config);
       if (output) log(output);
+    } else if (reporter === "html") {
+      const html = formatHtmlReport(results, config, { version });
+      if (opts.outFile === "-") {
+        log(html);
+      } else {
+        const path = opts.outFile || "svelte-vitals-report.html";
+        const write = opts.writeFile ?? ((p, c) => {
+          mkdirSync(dirname(p), { recursive: true });
+          writeFileSync(p, c);
+        });
+        write(path, html);
+        errorLog(`svelte-vitals: wrote report to ${path}`);
+      }
     } else {
       log(formatConsoleReport(results, config, { byRoute: opts.byRoute ?? false }));
     }

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { RuleSetting, Severity, Result, Config } from '@svelte-vitals/core';
 
-type ReporterName = 'console' | 'json' | 'agent' | 'sarif' | 'github';
+type ReporterName = 'console' | 'json' | 'agent' | 'sarif' | 'github' | 'html';
 
 /** Thrown when the target directory is not a SvelteKit project (CLI maps to exit 2). */
 declare class ProjectError extends Error {
@@ -35,6 +35,10 @@ interface RunOptions {
     env?: NodeJS.ProcessEnv;
     /** Fail (exit 1) when the combined Health score is below this value (0–100). */
     minHealth?: number;
+    /** Output path for --reporter html (default 'svelte-vitals-report.html'; '-' = stdout). */
+    outFile?: string;
+    /** Injected file writer for --reporter html (defaults to node:fs writeFileSync). Mainly for tests. */
+    writeFile?: (path: string, content: string) => void;
 }
 declare function routeMatcher(glob: string | undefined): (route: string) => boolean;
 interface AnalyzeOptions {

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   knownRuleIds,
   routeMatcher,
   run
-} from "./chunk-Y56I4RGY.js";
+} from "./chunk-U7HHKAJX.js";
 export {
   ProjectError,
   analyzeProject,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-vitals",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "A SvelteKit SEO checker — not a runtime Web Vitals reporter. Static analysis of your routes' head metadata.",
   "type": "module",
   "license": "MIT",
@@ -42,7 +42,7 @@
     "mri": "^1.2.0",
     "svelte": "^5.56.3",
     "tinyglobby": "^0.2.17",
-    "@svelte-vitals/core": "0.10.0"
+    "@svelte-vitals/core": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^24.7.0"