svelte-vitals 0.23.0 → 0.24.0

package/README.md

@@ -9,7 +9,7 @@
 > **ESM-only** (Node 18+). Ships ES modules only; `require()` is unsupported by design.
 
 ```bash
-npx svelte-vitals
+npx svelte-vitals@latest
 ```
 
 > [!NOTE]
@@ -20,8 +20,8 @@ npx svelte-vitals
 Run inside any SvelteKit project:
 
 ```bash
-npx svelte-vitals          # analyze the current directory
-npx svelte-vitals ./apps/web   # or a specific path
+npx svelte-vitals@latest              # analyze the current directory
+npx svelte-vitals@latest ./apps/web   # or a specific path
 ```
 
 ```
@@ -40,6 +40,8 @@ Passed (3)
 
 By default, console output groups failures by rule (top 5 per severity, each with one example location and an "…and N more" count) and collapses the Passed section to a bare count, so large projects don't flood the terminal. Pass `--verbose` to see every finding uncapped and ungrouped, with each passed item listed individually. On an interactive, color-capable terminal the Health score plays a short reveal animation; pass `--no-animation` to disable it.
 
+On an interactive terminal wide enough for the mascot (20+ columns), a small line-art face appears alongside both the analysis spinner and the Health-score reveal, reacting to the score (a perfect 100 gets a confetti flourish). On a wider terminal still (55+ columns) it also greets you with a short line in a speech bubble at startup, and again with a matching reaction line at the score reveal. `--no-animation` disables all of it, falling back to the plain spinner and plain score animation.
+
 ### Exit codes
 
 | Code | Meaning                                                         |

package/dist/bin.js

@@ -7,7 +7,7 @@ import {
   readCoreVersion,
   readPackageVersion,
   run
-} from "./chunk-HYTPZVSU.js";
+} from "./chunk-TCZ6OF6J.js";
 
 // src/bin.ts
 import mri3 from "mri";
@@ -109,9 +109,7 @@ function resolveArgs(argv) {
     errors.push(`Known rule ids: ${knownRuleIds().join(", ")}`);
   }
   let reporter;
-  if (argv.json) {
-    reporter = "json";
-  } else if (typeof argv.reporter === "string") {
+  if (typeof argv.reporter === "string") {
     if (!isReporterName(argv.reporter)) {
       errors.push(
         `svelte-vitals: unknown reporter '${argv.reporter}'. Valid values: console, json, agent, sarif, github, html, md.`
@@ -127,14 +125,16 @@ function resolveArgs(argv) {
       `svelte-vitals: unknown --fail-on '${failOnRaw}'; expected critical|warning|info. No threshold applied.`
     );
   }
-  const failOn = argv["fail-on-warning"] ? "warning" : failOnValid ? failOnRaw : void 0;
+  const failOn = failOnValid ? failOnRaw : void 0;
   const weights = parseWeights(argv.weights, errors);
   const categories = parseCategories(argv.category, errors);
   const score = Boolean(argv.score);
-  if (score && (argv.json || typeof argv.reporter === "string")) {
+  if (score && typeof argv.reporter === "string") {
     warnings.push("svelte-vitals: --score overrides --reporter; reporter output suppressed.");
   }
   const verbose = Boolean(argv["verbose"]);
+  const noColor = argv.color === false;
+  const noAnimation = argv.animation === false;
   const rulesConfig = buildRulesConfig(allow, ignore);
   const rules = Object.keys(rulesConfig).length > 0 ? rulesConfig : void 0;
   if (errors.length > 0) return { options: null, warnings, errors };
@@ -156,6 +156,8 @@ function resolveArgs(argv) {
       ...categories !== void 0 ? { categories } : {},
       ...score ? { score } : {},
       ...verbose ? { verbose } : {},
+      ...noColor ? { noColor } : {},
+      ...noAnimation ? { noAnimation } : {},
       ...diffBase !== void 0 ? { diffBase } : {},
       ...staged ? { staged } : {},
       ...baselineRef !== void 0 ? { baseline: baselineRef } : {}
@@ -267,9 +269,9 @@ var VITE_TARGETS = [
     hint: "Fails `vite build` when prerendered pages cross the SEO/Performance threshold"
   },
   {
-    id: "vite-dev-overlay",
-    label: "Dev overlay",
-    hint: "Live warnings in `vite dev` only \u2014 never fails a build or CI"
+    id: "vite-hooks",
+    label: "Live dashboard accuracy",
+    hint: "Feeds real rendered results into the live dashboard as you browse \u2014 improves per-route accuracy, never fails a build"
   }
 ];
 function viteTargetById(id) {
@@ -529,10 +531,10 @@ function planForVitePlugin(io) {
   const result = codemodViteConfig(content);
   return { id: "vite-plugin", label: viteTargetById("vite-plugin").label, path, ...result };
 }
-function planForDevOverlay(io) {
+function planForViteHooks(io) {
   const { path, content } = resolveCandidate(io, ["src/hooks.server.ts", "src/hooks.server.js"]);
   const result = codemodHooksServer(content);
-  return { id: "vite-dev-overlay", label: viteTargetById("vite-dev-overlay").label, path, ...result };
+  return { id: "vite-hooks", label: viteTargetById("vite-hooks").label, path, ...result };
 }
 function planForAgentTarget(target, io, force, version) {
   const path = join3(io.cwd, target.relPath);
@@ -591,7 +593,7 @@ async function runInstall(flags, io, prompts, version = "0.0.0") {
     ids = picked;
   } else {
     io.errorLog(
-      "svelte-vitals: no TTY; pass --client <claude-code,cursor,codex,vite-plugin,vite-dev-overlay,claude-skill,cursor-rules> to install non-interactively."
+      "svelte-vitals: no TTY; pass --client <claude-code,cursor,codex,vite-plugin,vite-hooks,claude-skill,cursor-rules> to install non-interactively."
     );
     return 2;
   }
@@ -630,7 +632,7 @@ async function runInstall(flags, io, prompts, version = "0.0.0") {
     }
   }
   for (const viteId of viteIds) {
-    rows.push(viteId === "vite-plugin" ? planForVitePlugin(io) : planForDevOverlay(io));
+    rows.push(viteId === "vite-plugin" ? planForVitePlugin(io) : planForViteHooks(io));
   }
   for (const agentId of agentIds) {
     const target = agentTargetById(agentId);
@@ -745,10 +747,11 @@ Usage:
   svelte-vitals install [options]
 
 Options:
-  --client <ids>    Comma-separated: claude-code,cursor,codex,vite-plugin,vite-dev-overlay,claude-skill,cursor-rules
+  --client <ids>    Comma-separated: claude-code,cursor,codex,vite-plugin,vite-hooks,claude-skill,cursor-rules
                     (skips the interactive picker)
-                    vite-plugin registers the build-mode plugin in vite.config.{ts,js,mjs}; vite-dev-overlay
-                    wires up the dev-overlay hook in src/hooks.server.{ts,js}. --force does not apply
+                    vite-plugin registers the build-mode plugin in vite.config.{ts,js,mjs}; vite-hooks
+                    wires up the svelteVitalsHandle hook in src/hooks.server.{ts,js}, which improves the
+                    live dashboard's per-route accuracy as you browse. --force does not apply
                     to either of these two \u2014 an existing registration is always left as-is.
                     claude-skill writes a Claude Code skill (.claude/skills/svelte-vitals/SKILL.md); cursor-rules
                     writes a Cursor rules file (.cursor/rules/svelte-vitals.mdc). Both are generated from the
@@ -882,8 +885,8 @@ function buildWorkflowYaml(opts) {
 }
 
 // src/ci/action-pin.generated.ts
-var ACTION_SHA = "caf278cf4030801b017d31b108fa46abc15e8105";
-var ACTION_VERSION = "0.2.2";
+var ACTION_SHA = "c9257b68ce2c4006f3631345f66c05342c715fdd";
+var ACTION_VERSION = "0.2.3";
 
 // src/ci/cli.ts
 var CI_HELP = `svelte-vitals ci \u2014 scaffold CI integration
@@ -961,9 +964,7 @@ Options:
   --by-route                  Show per-route score breakdown in console output
   --reporter <fmt>            console | json | agent | sarif | github | html | md (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
   --min-health <0-100>        Fail (exit 1) when the combined Health score is below this value
   --rules <ids>               Comma-separated rule ids to enable (all others disabled)
   --ignore <ids>              Comma-separated rule ids to disable
@@ -971,7 +972,7 @@ Options:
   --weights <pairs>           Per-category Health weight overrides, e.g. seo=2,performance=1 (unlisted categories default to 1)
   --score                     Print only the combined Health score (works with --min-health for gating)
   --no-color                  Disable ANSI color in console output
-  --no-animation               Disable the Health-score reveal animation on an interactive terminal
+  --no-animation               Disable the Health-score reveal animation and mascot on an interactive terminal
   --verbose                    Show every finding uncapped and ungrouped (default: capped, grouped by rule)
   -h, --help                  Show this help
   -v, --version               Show version
@@ -1003,7 +1004,7 @@ async function main() {
   }
   const argv = mri3(process.argv.slice(2), {
     alias: { h: "help", v: "version" },
-    boolean: ["by-route", "json", "fail-on-warning", "staged", "no-color", "score", "verbose", "no-animation"],
+    boolean: ["by-route", "staged", "score", "verbose"],
     string: [
       "meta-components",
       "treat-dynamic-as",
@@ -1045,8 +1046,6 @@ async function main() {
   const code = await run({
     ...options,
     minHealth,
-    noColor: argv["no-color"],
-    noAnimation: argv["no-animation"],
     selectApp
   });
   process.exit(code);

package/dist/{chunk-HYTPZVSU.js → chunk-TCZ6OF6J.js}

@@ -835,6 +835,157 @@ function startSpinner(text, opts) {
   };
 }
 
+// src/mascot.ts
+import { createLogUpdate } from "log-update";
+function mascotStateFor(score) {
+  if (score === 100) return "ecstatic";
+  if (score >= 90) return "happy";
+  return "content";
+}
+var MIN_MASCOT_COLUMNS = 20;
+function mascotFitsWidth(columns) {
+  return (columns ?? 80) >= MIN_MASCOT_COLUMNS;
+}
+var ORANGE_FG = "\x1B[38;2;255;62;0m";
+var RESET = "\x1B[0m";
+function renderFace(lines) {
+  return lines.map((line) => `${ORANGE_FG}${line}${RESET}`).join("\n");
+}
+var FACE_OPEN_EYES_NEUTRAL_MOUTH = ["\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E", "\u2502  \u25CF    \u25CF  \u2502", "\u2502    \u2500\u2500    \u2502", "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"];
+var FACE_CLOSED_EYES_NEUTRAL_MOUTH = ["\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E", "\u2502  \u2500    \u2500  \u2502", "\u2502    \u2500\u2500    \u2502", "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"];
+var FACE_WINK_BOTH = ["\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E", "\u2502  >    <  \u2502", "\u2502    \u2500\u2500    \u2502", "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"];
+var FACE_WINK_ONE = ["\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E", "\u2502  \u25CF    <  \u2502", "\u2502    \u2500\u2500    \u2502", "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"];
+var FACE_CONTENT = ["\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E", "\u2502  \u25CF    \u25CF  \u2502", "\u2502    \u25E1\u25E1    \u2502", "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"];
+var FACE_HAPPY = ["\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E", "\u2502  \u25CF    \u25CF  \u2502", "\u2502   \u2570\u2500\u2500\u256F   \u2502", "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"];
+var FACE_ECSTATIC = ["\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E", "\u2502  ^    ^  \u2502", "\u2502  \u2570\u2500\u2500\u2500\u256F   \u2502", "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"];
+var REACTION_FACES = {
+  content: FACE_CONTENT,
+  happy: FACE_HAPPY,
+  ecstatic: FACE_ECSTATIC
+};
+function renderMascotReaction(state) {
+  return renderFace(REACTION_FACES[state]);
+}
+function renderMascotAnticipating() {
+  return renderFace(FACE_OPEN_EYES_NEUTRAL_MOUTH);
+}
+var IDLE_FRAME_SEQUENCE = [0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 2, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 3];
+var IDLE_FACES = {
+  0: FACE_OPEN_EYES_NEUTRAL_MOUTH,
+  1: FACE_CLOSED_EYES_NEUTRAL_MOUTH,
+  2: FACE_WINK_BOTH,
+  3: FACE_WINK_ONE
+};
+function renderMascotIdleFrame(frameIndex) {
+  const code = IDLE_FRAME_SEQUENCE[frameIndex % IDLE_FRAME_SEQUENCE.length];
+  return renderFace(IDLE_FACES[code]);
+}
+var CONFETTI_COLORS = [
+  [255, 62, 0],
+  // orange (identity accent)
+  [255, 145, 175],
+  // blush pink
+  [255, 214, 0],
+  // gold
+  [255, 255, 255]
+  // white
+];
+var CONFETTI_CHARS = ["*", ".", "\xB7", "+"];
+var CONFETTI_WIDTH = 24;
+function confettiFg(rgb) {
+  return `\x1B[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m`;
+}
+function confettiRow(offset) {
+  let out = "";
+  for (let col = 0; col < CONFETTI_WIDTH; col++) {
+    if ((col + offset) % 5 === 0) {
+      const glyph = CONFETTI_CHARS[(col + offset) % CONFETTI_CHARS.length];
+      out += confettiFg(CONFETTI_COLORS[(col + offset) % CONFETTI_COLORS.length]) + glyph + RESET;
+    } else {
+      out += " ";
+    }
+  }
+  return out;
+}
+function renderConfettiFrame(offset, mascotBlock) {
+  return [confettiRow(offset), mascotBlock, confettiRow(offset + 2)].join("\n");
+}
+var IDLE_TICK_MS = 160;
+function startMascotSpinner(text, opts) {
+  if (!opts.enabled) return { stop() {
+  } };
+  const stream = opts.stream ?? process.stderr;
+  const render = createLogUpdate(stream);
+  let i = 0;
+  const tick = () => {
+    render(`${renderMascotIdleFrame(i)}
+${text}`);
+    i++;
+  };
+  tick();
+  const timer = setInterval(tick, IDLE_TICK_MS);
+  if (typeof timer.unref === "function") timer.unref();
+  return {
+    stop() {
+      clearInterval(timer);
+      render.clear();
+    }
+  };
+}
+
+// src/speech-bubble.ts
+import { createLogUpdate as createLogUpdate2 } from "log-update";
+var MIN_BUBBLE_COLUMNS = 55;
+function bubbleFitsWidth(columns) {
+  return (columns ?? 80) >= MIN_BUBBLE_COLUMNS;
+}
+function renderSpeechBubble(text) {
+  const border = "\u2500".repeat(text.length + 2);
+  return [`\u256D${border}\u256E`, `\u2502 ${text} \u2502`, `\u2570${border}\u256F`];
+}
+function withSpeechBubble(mascotBlock, bubbleLines) {
+  const mascotLines = mascotBlock.split("\n");
+  const bubbleWidth = bubbleLines[0]?.length ?? 0;
+  const blankBubbleLine = " ".repeat(bubbleWidth);
+  const padTop = Math.floor((mascotLines.length - bubbleLines.length) / 2);
+  const padBottom = mascotLines.length - bubbleLines.length - padTop;
+  const paddedBubble = [
+    ...Array(Math.max(padTop, 0)).fill(blankBubbleLine),
+    ...bubbleLines,
+    ...Array(Math.max(padBottom, 0)).fill(blankBubbleLine)
+  ];
+  return mascotLines.map((line, i) => `${line} ${paddedBubble[i] ?? blankBubbleLine}`).join("\n");
+}
+var GREETING_MESSAGES = [
+  "Welcome to Svelte Vitals!",
+  "Let's check your project!",
+  "Ready when you are!",
+  "Hi there! Let's dig in."
+];
+var REACTION_MESSAGES = {
+  ecstatic: ["Perfect score!", "Flawless!", "You nailed it!"],
+  happy: ["Nice work!", "Looking great!", "Almost perfect!"],
+  content: ["Keep going!", "Room to grow!", "Let's improve this!"]
+};
+function pickMessage(pool, random = Math.random) {
+  return pool[Math.floor(random() * pool.length)];
+}
+function renderMascotWithSpeech(mascotBlock, message) {
+  return withSpeechBubble(mascotBlock, renderSpeechBubble(message));
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var GREETING_HOLD_MS = 800;
+async function playMascotGreeting(opts) {
+  if (!opts.enabled) return;
+  const holdMs = opts.holdMs ?? GREETING_HOLD_MS;
+  const render = createLogUpdate2(opts.stream);
+  render(renderMascotWithSpeech(renderMascotAnticipating(), pickMessage(GREETING_MESSAGES)));
+  if (holdMs > 0) await sleep(holdMs);
+  render.clear();
+}
+
 // src/config-file.ts
 import { existsSync as existsSync2 } from "fs";
 import { join as join4 } from "path";
@@ -958,6 +1109,7 @@ async function loadConfigFile(cwd) {
 
 // src/pulse-animation.ts
 import { scoreColor } from "@svelte-vitals/core";
+import { createLogUpdate as createLogUpdate3 } from "log-update";
 var FRAME_COUNT = 6;
 var FRAME_DELAY_MS = 200;
 var WAVE_FRAMES = [
@@ -965,26 +1117,46 @@ var WAVE_FRAMES = [
   "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2571\u2572\u2500\u2500\u2571\u2572\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
   "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2571\u2572\u2500\u2500\u2500\u2500\u2500\u2500\u2571\u2572\u2500\u2500\u2500\u2500\u2500\u2500",
   "\u2500\u2500\u2500\u2500\u2500\u2500\u2571\u2572\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2572\u2500\u2500\u2500\u2500\u2500",
-  "\u2500\u2500\u2500\u2500\u2571\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2572\u2500\u2500\u2500\u2500",
-  "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"
+  "\u2500\u2500\u2500\u2500\u2571\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2572\u2500\u2500\u2500\u2500"
 ];
-function sleep(ms) {
+var WAVE_ORANGE_DIM = "\x1B[38;2;153;37;0m";
+var WAVE_RESET = "\x1B[0m";
+function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+var REACTION_HOLD_MS = 500;
+var CONFETTI_FRAME_COUNT = 4;
+var CONFETTI_FRAME_DELAY_MS = 220;
 async function playScoreAnimation(opts) {
   const frameDelayMs = opts.frameDelayMs ?? FRAME_DELAY_MS;
+  const holdMs = opts.frameDelayMs ?? REACTION_HOLD_MS;
+  const confettiDelayMs = opts.frameDelayMs ?? CONFETTI_FRAME_DELAY_MS;
+  const render = createLogUpdate3(opts.stream);
+  const showMascot = mascotFitsWidth(opts.stream.columns);
+  const state = mascotStateFor(opts.score);
+  const reactionMessage = showMascot && bubbleFitsWidth(opts.stream.columns) ? pickMessage(REACTION_MESSAGES[state]) : void 0;
+  const finalMascotBlock = reactionMessage ? renderMascotWithSpeech(renderMascotReaction(state), reactionMessage) : renderMascotReaction(state);
   for (let frame = 0; frame < FRAME_COUNT; frame++) {
     const progress = frame / (FRAME_COUNT - 1);
     const displayScore = Math.round(opts.score * progress);
     const isFinalFrame = frame === FRAME_COUNT - 1;
-    const wave = WAVE_FRAMES[frame];
     const scoreText = isFinalFrame ? scoreColor(opts.palette, opts.score)(`${displayScore}/100`) : opts.palette.dim(`${displayScore}/100`);
-    const cursorUp = frame === 0 ? "" : "\x1B[2A";
-    opts.stream.write(`${cursorUp}\r  ${wave}\x1B[K
-\r  Health: ${scoreText}\x1B[K
-`);
-    if (!isFinalFrame) await sleep(frameDelayMs);
+    const waveBlock = isFinalFrame ? `Health: ${scoreText}` : `${WAVE_ORANGE_DIM}${WAVE_FRAMES[frame]}${WAVE_RESET}
+Health: ${scoreText}`;
+    const mascotBlock = showMascot ? (isFinalFrame ? finalMascotBlock : renderMascotAnticipating()) + "\n" : "";
+    render(`${mascotBlock}${waveBlock}`);
+    if (!isFinalFrame) await sleep2(frameDelayMs);
   }
+  if (holdMs > 0) await sleep2(holdMs);
+  if (showMascot && state === "ecstatic") {
+    for (let i = 0; i < CONFETTI_FRAME_COUNT; i++) {
+      const waveBlock = `Health: ${scoreColor(opts.palette, opts.score)("100/100")}`;
+      render(`${renderConfettiFrame(i, finalMascotBlock)}
+${waveBlock}`);
+      if (i < CONFETTI_FRAME_COUNT - 1 && confettiDelayMs > 0) await sleep2(confettiDelayMs);
+    }
+  }
+  render.done();
 }
 function scoreAnimationEnabled(opts) {
   return opts.reporter === "console" && opts.stdoutIsTTY && !opts.noAnimationFlag && !isAgentEnv(opts.env) && !isCiEnv(opts.env) && colorEnabled({ reporter: opts.reporter, isTTY: opts.stdoutIsTTY, env: opts.env, noColorFlag: opts.noColorFlag });
@@ -1072,15 +1244,19 @@ async function run(opts = {}) {
   }
   const env = opts.env ?? process.env;
   const reporter = resolveReporter(opts.reporter, env);
-  const spinner = startSpinner("Analyzing\u2026", {
-    enabled: !opts.score && spinnerEnabled({
-      reporter,
-      rawReporter: opts.reporter,
-      stderrIsTTY: opts.stderrIsTTY ?? !!process.stderr.isTTY,
-      env,
-      noColorFlag: opts.noColor
-    })
+  const stderrStream = opts.stderrStream ?? process.stderr;
+  const spinnerBaseEnabled = !opts.score && spinnerEnabled({
+    reporter,
+    rawReporter: opts.reporter,
+    stderrIsTTY: opts.stderrIsTTY ?? !!process.stderr.isTTY,
+    env,
+    noColorFlag: opts.noColor
   });
+  const useMascotSpinner = spinnerBaseEnabled && !opts.noAnimation && mascotFitsWidth(stderrStream.columns);
+  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 });
   let cwd = opts.cwd ?? process.cwd();
   let analysis;
   try {
@@ -1171,6 +1347,7 @@ async function run(opts = {}) {
         categories: opts.categories
       }
     });
+    const summary = summarize(results, config);
     if (opts.score) {
       log(String(computeHealth(results, config).health));
     } else {
@@ -1242,7 +1419,6 @@ async function run(opts = {}) {
         );
       }
     }
-    const summary = summarize(results, config);
     const failBySeverity = hasFailureAtOrAbove(summary, config.failOn);
     const failByHealth = opts.minHealth != null && computeHealth(results, config).health < opts.minHealth;
     return failBySeverity || failByHealth ? 1 : 0;

package/dist/index.d.ts

@@ -95,6 +95,8 @@ interface RunOptions {
     noAnimation?: boolean;
     /** Override the stream the score animation writes to (tests). Defaults to process.stdout. */
     stdoutStream?: NodeJS.WriteStream;
+    /** Override the stream the analysis-phase progress indicator writes to (tests). Defaults to process.stderr. */
+    stderrStream?: NodeJS.WriteStream;
     /** Override the animation's per-frame delay in ms (tests — 0 runs the real frame loop near-instantly). Defaults to the animation module's own constant. */
     animationFrameDelayMs?: number;
 }

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   routeMatcher,
   run,
   spinnerEnabled
-} from "./chunk-HYTPZVSU.js";
+} from "./chunk-TCZ6OF6J.js";
 export {
   ProjectError,
   analyzeProject,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-vitals",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "A SvelteKit SEO checker — not a runtime Web Vitals reporter. Static analysis of your routes' head metadata.",
   "type": "module",
   "license": "MIT",
@@ -40,6 +40,7 @@
   ],
   "dependencies": {
     "@clack/prompts": "^1.7.0",
+    "log-update": "^8.0.0",
     "magicast": "^0.5.3",
     "mri": "^1.2.0",
     "smol-toml": "^1.7.0",
@@ -48,7 +49,7 @@
     "@svelte-vitals/core": "0.23.0"
   },
   "devDependencies": {
-    "@types/node": "^24.13.2"
+    "@types/node": "^24.13.3"
   },
   "scripts": {
     "build": "node scripts/gen-action-pin.mjs && tsup",