vitest-auto-spy 5.49.0 → 5.50.0

package/CHANGELOG.md

@@ -10,6 +10,25 @@ The latest released version here must always match the one published on
 
 ## [Unreleased]
 
+## [5.50.0] - 2026-09-29
+
+### Changed
+
+- **`doctor` and `perf` color their findings by severity** — the `error` label red, `warn` yellow,
+  `info` plain — and the `perf --gate` verdict line turns red when something fails the run. The
+  same switch as the `perf` tables decides it (`NO_COLOR`, `FORCE_COLOR`, `TERM=dumb`, a terminal);
+  `--format json`, `--format markdown` and `--code-quality` stay free of escapes.
+- **Color in GitLab CI and GitHub Actions logs.** Both render ANSI color although the job's stdout
+  is a pipe, so the CLI now paints when `GITLAB_CI` or `GITHUB_ACTIONS` is set; `NO_COLOR`,
+  `FORCE_COLOR=0` and `TERM=dumb` still turn it off.
+
+### Documentation
+
+- **`returns` vs `overrides` has a page of its own**, with a landing card and a sidebar entry: one
+  table of what each seeds, whether the member stays a spy, how it behaves under `strict` and which
+  wins when a member is named in both. `agent-docs/configuration.md` gains the two rows its option
+  table was missing.
+
 ## [5.49.0] - 2026-09-28
 
 ### Added
@@ -6093,7 +6112,8 @@ moved under 1 %: `/angular` +192 B (+1.0 %) for the override queue and the HTTP
 This copy ships with the package and carries 5.x only. Releases before 5.0.0 are in the
 [full changelog](https://github.com/ASDAlexey/vitest-auto-spy/blob/master/CHANGELOG.md).
 
-[Unreleased]: https://github.com/ASDAlexey/vitest-auto-spy/compare/v5.49.0...HEAD
+[Unreleased]: https://github.com/ASDAlexey/vitest-auto-spy/compare/v5.50.0...HEAD
+[5.50.0]: https://github.com/ASDAlexey/vitest-auto-spy/compare/v5.49.0...v5.50.0
 [5.49.0]: https://github.com/ASDAlexey/vitest-auto-spy/compare/v5.48.0...v5.49.0
 [5.48.0]: https://github.com/ASDAlexey/vitest-auto-spy/compare/v5.47.0...v5.48.0
 [5.47.0]: https://github.com/ASDAlexey/vitest-auto-spy/compare/v5.46.0...v5.47.0

package/agent-docs/angular.md

@@ -92,7 +92,7 @@ provideAutoSpyForToken(PRODUCTS, undefined, { returns: { getProducts: of([]), ge
 ```
 
 A seeded `overrides` value is stored verbatim and is **no longer a spy**, so seed data there and
-name methods in `returns` when they must stay assertable. On `provideAutoSpy` a plain function
+name methods in `returns` when they must stay assertable (the two compared in §5, [`configuration.md`](./configuration.md)). On `provideAutoSpy` a plain function
 seeded on a method is the exception: it becomes that method's spy, running the function until the
 test configures it, so `toHaveBeenCalled` works on it; a `vi.fn()` is kept as it is
 (`provideAutoSpyForToken` still stores every seed verbatim). The reason to prefer this over a second

package/agent-docs/configuration.md

@@ -31,6 +31,8 @@ createSpyFromClass(MyService, {
 | `lazySpies` | Unset: `true` (accessor placeholders) below 8 methods, `'proxy'` (a `Proxy`, lighter once touched) from 8, counting the methods the double spies (after `onlyMethodsToSpyOn` / `methodsToSpyOn`). Explicit `true` / `false` / `'proxy'` apply at any width. Calls, `Object.keys`, spread and snapshots behave the same in every mode. |
 | `strict` | Throw on a method nobody configured, instead of answering `undefined` (below). |
 | `onUnstubbedCall` | The general form of `strict`; its return value becomes the call's return value. |
+| `returns` | What a spied **method** answers. The member stays a spy (`toHaveBeenCalled` works); a default that `calledWith` / `mockReturnValue` / `resolveWith` replace. A key that is not a spied method is reported. |
+| `overrides` | Replaces **any member** with the value as written — a field, a signal, an `Observable` property. The member is no longer a spy, except a plain function seeded on a method (class factories only), which becomes its spy. Named in both, `overrides` wins. |
 | `selfReturning` | The named methods answer the double itself — a default like `returns`; a name in both answers `returns`. |
 
 **`instanceMethodsToSpyOn` is not an edge case — it is a top-5 option** (103 of ~370 spec files in

package/dist/cli.js

@@ -607,11 +607,12 @@ var wrap = (open) => (text) => `${ESC}[${open}m${text}${ESC}[0m`;
 var TERMINAL = { red: wrap("31"), yellow: wrap("33"), cyan: wrap("36"), bold: wrap("1"), dim: wrap("2") };
 var same = (text) => text;
 var MONOCHROME = { red: same, yellow: same, cyan: same, bold: same, dim: same };
+var COLOR_LOGS = ["GITLAB_CI", "GITHUB_ACTIONS"];
 function colorWanted(env, isTTY = process.stdout.isTTY === true) {
   if (env["NO_COLOR"] !== void 0 || env["FORCE_COLOR"] === "0" || env["TERM"] === "dumb") {
     return false;
   }
-  return env["FORCE_COLOR"] !== void 0 || isTTY;
+  return env["FORCE_COLOR"] !== void 0 || COLOR_LOGS.some((name) => env[name] !== void 0) || isTTY;
 }
 function painterFor(colors) {
   return colors ?? colorWanted(process.env) ? TERMINAL : MONOCHROME;
@@ -658,7 +659,15 @@ function wrapLine(text, width, indent, firstIndent) {
 
 // src/cli/report.ts
 var SEVERITY_ORDER = { error: 0, warning: 1, info: 2 };
-var SEVERITY_LABEL = { error: "error", warning: "warn ", info: "info " };
+var SEVERITY_LABEL = { error: "error", warning: "warn", info: "info" };
+var SEVERITY_PAINT = {
+  error: (paint, text) => paint.red(text),
+  warning: (paint, text) => paint.yellow(text),
+  info: (_paint, text) => text
+};
+function severityLabel(severity, paint) {
+  return padEnd(SEVERITY_PAINT[severity](paint, SEVERITY_LABEL[severity]), 5);
+}
 var BODY = "       ";
 var ITEM = `${BODY}  `;
 var ITEM_BODY = `${ITEM}  `;
@@ -679,23 +688,23 @@ function fixLines(finding2, width) {
   const docs = docsFor(finding2.check);
   return [...wrapText(finding2.fix, width, `${BODY}  `, `${BODY}\u2192 `), ...docs === void 0 ? [] : [`${BODY}Docs: ${docs}`]];
 }
-function formatOne(finding2, width) {
+function formatOne(finding2, width, paint) {
   const where2 = finding2.file === void 0 ? "" : ` ${finding2.file}`;
   return [
-    `${SEVERITY_LABEL[finding2.severity]}  ${finding2.check}${where2}`,
+    `${severityLabel(finding2.severity, paint)}  ${finding2.check}${where2}`,
     ...wrapText(finding2.message, width, BODY),
     ...(finding2.details ?? []).map((line) => `${BODY}${line}`),
     ...fixLines(finding2, width)
   ].join("\n");
 }
-function formatGroup({ first, members: group3 }, width) {
+function formatGroup({ first, members: group3 }, width, paint) {
   const sameMessage = group3.every((finding2) => finding2.message === first.message);
   const places = group3.flatMap((finding2) => [
     `${ITEM}${String(finding2.file)}`,
     ...sameMessage ? [] : wrapText(finding2.message, width, ITEM_BODY)
   ]);
   return [
-    `${SEVERITY_LABEL[first.severity]}  ${first.check} \u2014 ${placesOf(group3)}`,
+    `${severityLabel(first.severity, paint)}  ${first.check} \u2014 ${placesOf(group3)}`,
     ...sameMessage ? wrapText(first.message, width, BODY) : [],
     ...places,
     ...fixLines(first, width)
@@ -723,8 +732,8 @@ function groupFindings(findings) {
 function filterBySeverity(findings, minSeverity = "info") {
   return findings.filter((finding2) => SEVERITY_ORDER[finding2.severity] <= SEVERITY_ORDER[minSeverity]);
 }
-function formatFindings(findings, minSeverity = "info", width = outputWidth()) {
-  return groupFindings(filterBySeverity(findings, minSeverity)).map((group3) => group3.members.length === 1 ? formatOne(group3.first, width) : formatGroup(group3, width)).join("\n\n");
+function formatFindings(findings, minSeverity = "info", width = outputWidth(), paint = MONOCHROME) {
+  return groupFindings(filterBySeverity(findings, minSeverity)).map((group3) => group3.members.length === 1 ? formatOne(group3.first, width, paint) : formatGroup(group3, width, paint)).join("\n\n");
 }
 function tallyOf(findings) {
   return {
@@ -3865,7 +3874,7 @@ function checkForeignPragma(graph) {
 }
 
 // src/cli/checks/export-map.generated.ts
-var EXPORT_MAP_VERSION = "5.48.0";
+var EXPORT_MAP_VERSION = "5.49.0";
 var ENTRY_SPECIFIERS = "vitest-auto-spy vitest-auto-spy/bun vitest-auto-spy/bun-angular vitest-auto-spy/node vitest-auto-spy/rstest vitest-auto-spy/rxjs vitest-auto-spy/console vitest-auto-spy/dom-stubs vitest-auto-spy/diagnostics vitest-auto-spy/jasmine vitest-auto-spy/jasmine-compat vitest-auto-spy/observer-spy vitest-auto-spy/angular vitest-auto-spy/angular/diagnostics vitest-auto-spy/angular/doubles vitest-auto-spy/angular/matchers vitest-auto-spy/angular-http vitest-auto-spy/angular-router vitest-auto-spy/signal-forms vitest-auto-spy/nestjs vitest-auto-spy/react vitest-auto-spy/vue vitest-auto-spy/svelte vitest-auto-spy/setup vitest-auto-spy/zone vitest-auto-spy/eslint-plugin vitest-auto-spy/perf-reporter";
 var EXPORTED_BY = {
   AccessorImplementations: "0 1 2 3 4 12 20 21 22",
@@ -8236,7 +8245,8 @@ function formatVerdict(rows, paint) {
     ],
     paint
   );
-  return [`perf gate verdict \u2014 ${rows.length} judged, ${failing} ${failing === 1 ? "fails" : "fail"} the run`, ...table];
+  const title = `perf gate verdict \u2014 ${rows.length} judged, ${failing} ${failing === 1 ? "fails" : "fail"} the run`;
+  return [failing > 0 ? paint.red(title) : title, ...table];
 }
 
 // src/cli/report-markdown.ts
@@ -8464,7 +8474,7 @@ ${nothingToDo(analysis)}`);
   reportOnly(analysis.findings, io, minSeverity);
 }
 function reportOnly(findings, io, minSeverity) {
-  const report2 = formatFindings(findings, minSeverity);
+  const report2 = formatFindings(findings, minSeverity, outputWidth(), painterFor(void 0));
   if (report2 !== "") {
     io.out(`
 ${report2}`);
@@ -9085,7 +9095,7 @@ function doctorCommand(cwd, argv, io) {
   io.out(`vitest-auto-spy doctor \u2014 ${cwd}`);
   io.out(`${profile.files.length} files scanned, ${specFiles} of them spec files \u2014 runner: ${profile.runner}, entry: ${profile.entry}
 `);
-  const report2 = findings.length === 0 ? "No problems found." : formatFindings(findings, minSeverity);
+  const report2 = findings.length === 0 ? "No problems found." : formatFindings(findings, minSeverity, outputWidth(), painterFor(void 0));
   if (report2 !== "") {
     io.out(`${report2}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitest-auto-spy",
-  "version": "5.49.0",
+  "version": "5.50.0",
   "description": "Auto-generate fully-typed test spies from a class — across Vitest, Bun, node:test and Rstest, with Angular/NestJS/React/Vue/Svelte recipes. Drop-in replacement for jest-auto-spies and jasmine-auto-spies.",
   "keywords": [
     "auto-mock",