svelte-vitals 0.45.1 → 0.46.0

package/dist/bin.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   runAnalyzeCliGunshi
-} from "./chunk-P4YNVJUO.js";
-import "./chunk-VNVRHWO3.js";
+} from "./chunk-Z2DBOC5X.js";
+import "./chunk-FVN7R2YK.js";
 import "./chunk-MUIOPL5F.js";
 import "./chunk-M5KM5SV7.js";
 import {
@@ -18,29 +18,34 @@ import {
 
 // src/cli.ts
 async function runCli(argv, io = consoleIO, env = process.env) {
-  const locale = resolveLocale(env);
-  if (argv[0] === "complete") {
-    const { runCompleteCliGunshi } = await import("./complete-HGLO72TI.js");
-    return { code: await runCompleteCliGunshi(argv, io), exit: "natural" };
+  try {
+    const locale = resolveLocale(env);
+    if (argv[0] === "complete") {
+      const { runCompleteCliGunshi } = await import("./complete-7TW5PTE6.js");
+      return { code: await runCompleteCliGunshi(argv, io), exit: "natural" };
+    }
+    if (argv[0] === "docs") {
+      const { runDocsCliGunshi } = await import("./docs-WRZT4ZJN.js");
+      return { code: await runDocsCliGunshi(argv.slice(1), io, locale), exit: "natural" };
+    }
+    if (argv[0] === "explain") {
+      const { runExplainCliGunshi } = await import("./explain-W3BU3CYJ.js");
+      return { code: await runExplainCliGunshi(argv.slice(1), io, locale), exit: "natural" };
+    }
+    if (argv[0] === "install") {
+      const { runInstallCliGunshi } = await import("./install-EP364SRT.js");
+      return { code: await runInstallCliGunshi(argv.slice(1), io, locale), exit: "immediate" };
+    }
+    if (argv[0] === "ci") {
+      const { runCiCliGunshi } = await import("./ci-TFTS5QAU.js");
+      const code = await runCiCliGunshi(argv.slice(1), { ...realIO(), log: io.log, errorLog: io.errorLog }, locale);
+      return { code, exit: "immediate" };
+    }
+    return await runAnalyzeCliGunshi(argv, io, locale);
+  } catch (err) {
+    io.errorLog(`svelte-vitals: ${err instanceof Error ? err.message : String(err)}`);
+    return { code: 2, exit: "natural" };
   }
-  if (argv[0] === "docs") {
-    const { runDocsCliGunshi } = await import("./docs-CRZC47P7.js");
-    return { code: await runDocsCliGunshi(argv.slice(1), io, locale), exit: "natural" };
-  }
-  if (argv[0] === "explain") {
-    const { runExplainCliGunshi } = await import("./explain-52QDQUOY.js");
-    return { code: await runExplainCliGunshi(argv.slice(1), io, locale), exit: "natural" };
-  }
-  if (argv[0] === "install") {
-    const { runInstallCliGunshi } = await import("./install-3FI7M5BM.js");
-    return { code: await runInstallCliGunshi(argv.slice(1), io, locale), exit: "immediate" };
-  }
-  if (argv[0] === "ci") {
-    const { runCiCliGunshi } = await import("./ci-CLKU3TR6.js");
-    const code = await runCiCliGunshi(argv.slice(1), { ...realIO(), log: io.log, errorLog: io.errorLog }, locale);
-    return { code, exit: "immediate" };
-  }
-  return runAnalyzeCliGunshi(argv, io, locale);
 }
 
 // src/bin.ts
@@ -52,4 +57,7 @@ async function main() {
     process.exitCode = code;
   }
 }
-void main();
+main().catch((err) => {
+  console.error(`svelte-vitals: ${err instanceof Error ? err.message : String(err)}`);
+  process.exit(2);
+});

package/dist/{chunk-4O5F7EUJ.js → chunk-2RQRPUCR.js}

@@ -17,7 +17,7 @@ import {
   WORKFLOW_PATH,
   buildWorkflowYaml,
   planWorkflowWrite
-} from "./chunk-F5P3REI7.js";
+} from "./chunk-CTMKTFST.js";
 import {
   clackPrompts,
   realIO

package/dist/{chunk-O2CQPUSP.js → chunk-4ZE7NBVE.js}

@@ -17,10 +17,7 @@ import {
 import { cli } from "gunshi/bone";
 import { define } from "gunshi/definition";
 import "gunshi/generator";
-import { explainRule as explainRule2, allRules as allRules2 } from "@svelte-vitals/core";
-
-// src/explain.ts
-import { allRules, CATEGORIES } from "@svelte-vitals/core";
+import { explainRule, allRules, CATEGORIES } from "@svelte-vitals/core";
 function describeOptions(id, options) {
   const MERGE = {
     integer: "replaces the default",
@@ -56,8 +53,6 @@ function renderRuleList() {
     "\n\n"
   );
 }
-
-// src/gunshi/explain.ts
 var BOOLEAN_FLAGS = ["json", "list", "help"];
 var KNOWN_LONG_FLAGS = new Set(BOOLEAN_FLAGS);
 var KNOWN_SHORT_FLAGS = /* @__PURE__ */ new Set(["h"]);
@@ -113,7 +108,7 @@ async function runExplainCliGunshi(args, io = consoleIO, locale = "en") {
         }
         io.log(
           ctx.values.json ? JSON.stringify(
-            allRules2.map((r) => ({ id: r.id, category: r.category, severity: r.severity, title: r.title })),
+            allRules.map((r) => ({ id: r.id, category: r.category, severity: r.severity, title: r.title })),
             null,
             2
           ) : renderRuleList()
@@ -130,7 +125,7 @@ async function runExplainCliGunshi(args, io = consoleIO, locale = "en") {
         exitCode = 2;
         return;
       }
-      const info = explainRule2(id);
+      const info = explainRule(id);
       if (!info) {
         io.errorLog(`svelte-vitals: unknown rule id '${id}'.`);
         const hint = suggestClosest(id, knownRuleIds());

package/dist/{chunk-ACQ5HB32.js → chunk-6BUOZU6F.js}

@@ -4,7 +4,7 @@ import {
   WORKFLOW_PATH,
   buildWorkflowYaml,
   planWorkflowWrite
-} from "./chunk-F5P3REI7.js";
+} from "./chunk-CTMKTFST.js";
 import {
   realIO
 } from "./chunk-GE7TKVTX.js";

package/dist/{chunk-F5P3REI7.js → chunk-CTMKTFST.js}

@@ -1,7 +1,7 @@
 // src/ci/workflow.ts
 var WORKFLOW_PATH = ".github/workflows/svelte-vitals.yml";
-var CHECKOUT_SHA = "9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0";
-var CHECKOUT_VERSION = "v7.0.0";
+var CHECKOUT_SHA = "3d3c42e5aac5ba805825da76410c181273ba90b1";
+var CHECKOUT_VERSION = "v7.0.1";
 function planWorkflowWrite(existing, force) {
   if (existing === void 0) return { status: "created" };
   if (!force) return { status: "exists" };
@@ -28,6 +28,7 @@ function buildWorkflowYaml(opts) {
     `      - uses: actions/checkout@${CHECKOUT_SHA} # ${CHECKOUT_VERSION}`,
     "        with:",
     "          fetch-depth: 0",
+    "          persist-credentials: false",
     `      - uses: oekazuma/svelte-vitals-action@${actionSha} # v${actionVersion}`,
     "        with:",
     "          diff: origin/${{ github.base_ref }}",

package/dist/{chunk-VNVRHWO3.js → chunk-FVN7R2YK.js}

@@ -32,7 +32,9 @@ import {
   applyRuleSeverities,
   applyOverrides,
   settingSeverity,
-  withFailedRulesOff
+  withFailedRulesOff,
+  formatFailedRuleWarning,
+  terminalSafe
 } from "@svelte-vitals/core";
 
 // src/runtime/node.ts
@@ -1002,15 +1004,16 @@ function applySuppressions(results, entries, config, allResults) {
 }
 
 // src/color.ts
+import { styleText } from "util";
 import { noColorPalette } from "@svelte-vitals/core";
-var wrap = (open, close = 0) => (s) => `\x1B[${open}m${s}\x1B[${close}m`;
+var wrap = (format) => (s) => styleText(format, s, { validateStream: false });
 var ansiPalette = {
-  bold: wrap(1, 22),
-  dim: wrap(2, 22),
-  red: wrap(31, 39),
-  yellow: wrap(33, 39),
-  green: wrap(32, 39),
-  cyan: wrap(36, 39)
+  bold: wrap("bold"),
+  dim: wrap("dim"),
+  red: wrap("red"),
+  yellow: wrap("yellow"),
+  green: wrap("green"),
+  cyan: wrap("cyan")
 };
 function colorEnabled(opts) {
   if (opts.noColorFlag) return false;
@@ -1021,28 +1024,6 @@ function colorEnabled(opts) {
 }
 var paletteFor = (enabled) => enabled ? ansiPalette : noColorPalette;
 
-// src/spinner.ts
-var FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
-function startSpinner(text, opts) {
-  const stream = opts.stream ?? process.stderr;
-  if (!opts.enabled) return { stop() {
-  } };
-  let i = 0;
-  const tick = () => {
-    stream.write(`\r${FRAMES[i % FRAMES.length]} ${text}`);
-    i++;
-  };
-  tick();
-  const timer = setInterval(tick, 80);
-  if (typeof timer.unref === "function") timer.unref();
-  return {
-    stop() {
-      clearInterval(timer);
-      stream.write("\r\x1B[K");
-    }
-  };
-}
-
 // src/mascot.ts
 import { createLogUpdate } from "log-update";
 function mascotStateFor(score) {
@@ -1119,24 +1100,28 @@ function renderConfettiFrame(offset, mascotBlock) {
   return [confettiRow(offset), mascotBlock, confettiRow(offset + 2)].join("\n");
 }
 var IDLE_TICK_MS = 160;
+var PLAIN_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var PLAIN_TICK_MS = 80;
 function startMascotSpinner(text, opts) {
   if (!opts.enabled) return { stop() {
   } };
   const stream = opts.stream ?? process.stderr;
+  const mascot = opts.mascot ?? true;
   const render = createLogUpdate(stream);
   let i = 0;
   const tick = () => {
-    render(`${renderMascotIdleFrame(i)}
-${text}`);
+    render(mascot ? `${renderMascotIdleFrame(i)}
+${text}` : `${PLAIN_FRAMES[i % PLAIN_FRAMES.length]} ${text}`);
     i++;
   };
   tick();
-  const timer = setInterval(tick, IDLE_TICK_MS);
+  const timer = setInterval(tick, mascot ? IDLE_TICK_MS : PLAIN_TICK_MS);
   if (typeof timer.unref === "function") timer.unref();
   return {
     stop() {
       clearInterval(timer);
       render.clear();
+      render.done();
     }
   };
 }
@@ -1307,7 +1292,7 @@ function skippedFileWarnings(facts) {
   ];
 }
 function failedRuleWarnings(failedRules) {
-  return failedRules.map((f) => `rule ${f.id} failed and was skipped: ${f.message.split("\n")[0]}`);
+  return failedRules.map(formatFailedRuleWarning);
 }
 async function analyzeProject(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
@@ -1355,22 +1340,22 @@ async function analyzeProject(opts = {}) {
     sourceFiles
   });
   const results = applyOverrides(applyRuleSeverities(rawResults, config), config);
-  const scoringConfig = withFailedRulesOff(
-    config,
-    failedRules.map((f) => f.id)
-  );
+  const failedRuleIds = failedRules.map((f) => f.id);
+  const scoringConfig = withFailedRulesOff(config, failedRuleIds);
   return {
     results,
     config: scoringConfig,
     version: readPackageVersion(),
     ruleIds: rules.map((r) => r.id),
     examined,
+    failedRuleIds,
     warnings: [...warnings, ...skippedFileWarnings([...components, ...kitModules]), ...failedRuleWarnings(failedRules)],
     loadedConfig: loaded
   };
 }
 async function applyScope(results, opts) {
-  const errorLog = opts.errorLog ?? ((line) => console.error(line));
+  const rawErrorLog = opts.errorLog ?? ((line) => console.error(line));
+  const errorLog = (line) => rawErrorLog(terminalSafe(line));
   let scoped = results;
   if (opts.staged || opts.diffBase !== void 0) {
     const changed = opts.staged ? getChangedFiles(opts.cwd, { staged: true }) : getChangedFiles(opts.cwd, { base: opts.diffBase });
@@ -1433,7 +1418,8 @@ function runAnalyzeOptions(opts) {
 }
 async function run(opts = {}) {
   const log = opts.log ?? ((line) => console.log(line));
-  const errorLog = opts.errorLog ?? ((line) => console.error(line));
+  const rawErrorLog = opts.errorLog ?? ((line) => console.error(line));
+  const errorLog = (line) => rawErrorLog(terminalSafe(line));
   if (opts.minHealth != null && (!Number.isFinite(opts.minHealth) || opts.minHealth < 0 || opts.minHealth > 100)) {
     errorLog(`svelte-vitals: invalid minHealth '${opts.minHealth}'; expected a number 0-100.`);
     return 2;
@@ -1452,7 +1438,11 @@ async function run(opts = {}) {
   if (useMascotSpinner && bubbleFitsWidth(stderrStream.columns)) {
     await playMascotGreeting({ enabled: true, stream: stderrStream, holdMs: opts.animationFrameDelayMs });
   }
-  const spinner = useMascotSpinner ? startMascotSpinner("Analyzing\u2026", { enabled: true, stream: stderrStream }) : startSpinner("Analyzing\u2026", { enabled: spinnerBaseEnabled, stream: stderrStream });
+  const spinner = startMascotSpinner("Analyzing\u2026", {
+    enabled: spinnerBaseEnabled,
+    stream: stderrStream,
+    mascot: useMascotSpinner
+  });
   let cwd = opts.cwd ?? process.cwd();
   let analysis;
   try {

package/dist/{chunk-MBOONBC4.js → chunk-X7BU4DLG.js}

@@ -53,7 +53,7 @@ var EMBEDDED_DOCS = [
   }
 ];
 
-// src/docs/cli.ts
+// src/gunshi/docs.ts
 var DOCS_HELP = `svelte-vitals docs \u2014 read the bundled guides without leaving the terminal
 
 Usage:
@@ -83,8 +83,6 @@ function renderList() {
     "Rule-level detail is a separate command: `svelte-vitals explain --list`."
   ].join("\n");
 }
-
-// src/gunshi/docs.ts
 var BOOLEAN_FLAGS = ["json", "help"];
 var HELP_ARG = { help: { type: "boolean", short: "h", description: "Show this help" } };
 var JSON_ARG = { json: { type: "boolean", description: "Machine-readable output (list only)" } };

package/dist/{chunk-P4YNVJUO.js → chunk-Z2DBOC5X.js}

@@ -1,6 +1,6 @@
 import {
   run
-} from "./chunk-VNVRHWO3.js";
+} from "./chunk-FVN7R2YK.js";
 import {
   VALUE_FLAGS,
   parseRunArgs,

package/dist/{ci-CLKU3TR6.js → ci-TFTS5QAU.js}

@@ -2,8 +2,8 @@ import {
   CI_ARGS,
   CI_UPGRADE_ARGS,
   runCiCliGunshi
-} from "./chunk-ACQ5HB32.js";
-import "./chunk-F5P3REI7.js";
+} from "./chunk-6BUOZU6F.js";
+import "./chunk-CTMKTFST.js";
 import "./chunk-GE7TKVTX.js";
 import "./chunk-NMVBVKLX.js";
 export {

package/dist/{complete-HGLO72TI.js → complete-7TW5PTE6.js}

@@ -1,18 +1,18 @@
 import {
   ROOT_ARGS
-} from "./chunk-P4YNVJUO.js";
-import "./chunk-VNVRHWO3.js";
+} from "./chunk-Z2DBOC5X.js";
+import "./chunk-FVN7R2YK.js";
 import {
   DOCS_LIST_ARGS,
   DOCS_ROOT_ARGS,
   DOCS_SHOW_ARGS
-} from "./chunk-MBOONBC4.js";
+} from "./chunk-X7BU4DLG.js";
 import {
   EXPLAIN_ARGS
-} from "./chunk-O2CQPUSP.js";
+} from "./chunk-4ZE7NBVE.js";
 import {
   INSTALL_ARGS
-} from "./chunk-4O5F7EUJ.js";
+} from "./chunk-2RQRPUCR.js";
 import {
   CATEGORIES,
   FAIL_ON_VALUES,
@@ -28,8 +28,8 @@ import "./chunk-TFBLQUAC.js";
 import {
   CI_ARGS,
   CI_UPGRADE_ARGS
-} from "./chunk-ACQ5HB32.js";
-import "./chunk-F5P3REI7.js";
+} from "./chunk-6BUOZU6F.js";
+import "./chunk-CTMKTFST.js";
 import "./chunk-GE7TKVTX.js";
 import "./chunk-NMVBVKLX.js";
 
@@ -43,7 +43,15 @@ function forCompletion(args) {
   const out = {};
   for (const [key, schema] of Object.entries(args)) {
     if (schema.hidden) continue;
-    out[schema.type === "positional" || !schema.toKebab ? key : kebabnize(key)] = schema;
+    const outKey = schema.type === "positional" || !schema.toKebab ? key : kebabnize(key);
+    const description = schema.description?.replace(/\s*\n\s*/g, " ");
+    out[outKey] = description === schema.description ? schema : { ...schema, description };
+  }
+  for (const [key, schema] of Object.entries(out)) {
+    const stripped = key.startsWith("no-") ? key.slice(3) : void 0;
+    if (stripped && !(stripped in out)) {
+      out[stripped] = { type: "positional", required: false, description: schema.description };
+    }
   }
   return out;
 }

package/dist/{docs-CRZC47P7.js → docs-WRZT4ZJN.js}

@@ -3,7 +3,7 @@ import {
   DOCS_ROOT_ARGS,
   DOCS_SHOW_ARGS,
   runDocsCliGunshi
-} from "./chunk-MBOONBC4.js";
+} from "./chunk-X7BU4DLG.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-TFBLQUAC.js";
 import "./chunk-NMVBVKLX.js";

package/dist/{explain-52QDQUOY.js → explain-W3BU3CYJ.js}

@@ -1,7 +1,7 @@
 import {
   EXPLAIN_ARGS,
   runExplainCliGunshi
-} from "./chunk-O2CQPUSP.js";
+} from "./chunk-4ZE7NBVE.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-TFBLQUAC.js";
 import "./chunk-NMVBVKLX.js";

package/dist/gunshi-registry.js

@@ -1,18 +1,18 @@
 import {
   ROOT_ARGS
-} from "./chunk-P4YNVJUO.js";
-import "./chunk-VNVRHWO3.js";
+} from "./chunk-Z2DBOC5X.js";
+import "./chunk-FVN7R2YK.js";
 import {
   JA_ARG_DESCRIPTIONS
 } from "./chunk-MHRO4GU7.js";
 import {
   INSTALL_ARGS
-} from "./chunk-4O5F7EUJ.js";
+} from "./chunk-2RQRPUCR.js";
 import "./chunk-MUIOPL5F.js";
 import "./chunk-M5KM5SV7.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-TFBLQUAC.js";
-import "./chunk-F5P3REI7.js";
+import "./chunk-CTMKTFST.js";
 import "./chunk-GE7TKVTX.js";
 import "./chunk-NMVBVKLX.js";
 export {

package/dist/index.d.ts

@@ -231,6 +231,8 @@ interface AnalyzeResult {
     ruleIds: string[];
     /** Per-rule, per-declaration counts of places examined, unfiltered by `--diff`/`--baseline`/suppressions. */
     examined: Record<string, Record<string, number>>;
+    /** Ids of rules `runRules` caught throwing — already folded into `config` via `withFailedRulesOff`; exposed separately so a caller with its own base config (the vite dev dashboard) can apply the same correction without adopting this call's `config`. */
+    failedRuleIds: string[];
     /** Non-fatal issues surfaced during analysis: config-file problems (unknown top-level keys, invalid enum values), version-floor notices, `--rules`/overrides conflicts, and skipped-file notices. Empty when none apply. */
     warnings: string[];
     /**

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   routeMatcher,
   run,
   spinnerEnabled
-} from "./chunk-VNVRHWO3.js";
+} from "./chunk-FVN7R2YK.js";
 import {
   loadConfigFile
 } from "./chunk-M5KM5SV7.js";

package/dist/{install-3FI7M5BM.js → install-EP364SRT.js}

@@ -1,12 +1,12 @@
 import {
   INSTALL_ARGS,
   runInstallCliGunshi
-} from "./chunk-4O5F7EUJ.js";
+} from "./chunk-2RQRPUCR.js";
 import "./chunk-MUIOPL5F.js";
 import "./chunk-M5KM5SV7.js";
 import "./chunk-SLUMRYUD.js";
 import "./chunk-TFBLQUAC.js";
-import "./chunk-F5P3REI7.js";
+import "./chunk-CTMKTFST.js";
 import "./chunk-GE7TKVTX.js";
 import "./chunk-NMVBVKLX.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-vitals",
-  "version": "0.45.1",
+  "version": "0.46.0",
   "description": "A deterministic SvelteKit code-health scanner (SEO, performance, correctness, security, architecture) — not a runtime Web Vitals reporter.",
   "type": "module",
   "license": "MIT",
@@ -52,7 +52,7 @@
     "magicast": "^0.5.4",
     "svelte": "^5.56.8",
     "tinyglobby": "^0.2.17",
-    "@svelte-vitals/core": "0.41.1"
+    "@svelte-vitals/core": "0.42.0"
   },
   "devDependencies": {
     "@gunshi/docs": "0.37.1",