@vitest-agent/ui 4.1.0 → 5.0.1

package/README.md

@@ -11,8 +11,8 @@ Pure rendering primitives for vitest-agent. Owns the `RunEvent` reducer, the sha
 ## Features
 
 - **Reducer** — pure `(state, event) => state` fold over the `RunEvent` discriminated union; `reduceRenderStateAll` for one-shot replay
-- **Dispatcher matrix** — `dispatch` and `dispatchInk` route a `DispatchInputs` to the matching `(RunShape, RunOutcome)` cell; `classifyRunShape` and `classifyOutcome` derive the coordinates
-- **Ink components** — `StreamApp` and the supporting primitives (`ModuleHeader`, `TestRow`, `CoverageBlock`, `TrendLine`, `FailureSection`, etc.) for live `stream`-mode frames
+- **Dispatcher matrix** — `dispatch` routes a `DispatchInputs` to the matching `(RunShape, RunOutcome)` cell; `classifyRunShape` and `classifyOutcome` derive the coordinates
+- **Ink components** (`@vitest-agent/ui/ink`) — `StreamApp` and the supporting primitives (`ModuleHeader`, `TestRow`, `CoverageBlock`, `TrendLine`, `FailureSection`, etc.) for live `stream`-mode frames, plus `dispatchInk` / `inkDispatcherTable`, the Ink half of the matrix. The package root never loads React or Ink; only this subpath does
 - **Synthesizers** — `synthesizeRunEvents` from live Vitest modules; `synthesizeFromAgentReport` from a stored `AgentReport`
 - **Footer builder** — `buildFooter` assembles the L1 MCP-tool-pointer footer; `dominantClassification` picks the most actionable failure class
 
@@ -24,7 +24,7 @@ npm install @vitest-agent/ui
 pnpm add @vitest-agent/ui
 ```
 
-React and Ink are required peers:
+React and Ink are optional peers, needed only for the `@vitest-agent/ui/ink` subpath:
 
 ```bash
 npm install react ink

package/dispatcher/cells/single-file-fail.js

@@ -1,7 +1,6 @@
 import { buildFooter } from "../footer.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { formatFailure, soleModulePath } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-file-fail.ts
 const DEFAULT_WIDTH = 80;
@@ -20,10 +19,7 @@ const renderAgent = (inputs) => {
 	}
 	return `${sections.join("\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleFileFail = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleFileFail = { agent: renderAgent };
 
 //#endregion
 export { renderSingleFileFail };

package/dispatcher/cells/single-file-pass.js

@@ -1,7 +1,6 @@
 import { buildFooter } from "../footer.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { soleModulePath } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 import { Fmt } from "@effected/cli";
 
 //#region src/dispatcher/cells/single-file-pass.ts
@@ -11,10 +10,7 @@ const renderAgent = (inputs) => {
 	const { passCount, durationMs } = inputs.state.totals;
 	return `${modulePath}: ${Fmt.plural(passCount, "test")} passed (${formatDisplayDuration(durationMs)})\n${buildFooter(inputs)}`;
 };
-const renderSingleFilePass = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleFilePass = { agent: renderAgent };
 
 //#endregion
 export { renderSingleFilePass };

package/dispatcher/cells/single-file-threshold.js

@@ -1,7 +1,6 @@
 import { buildFooter } from "../footer.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { formatCoverageSummaryLines, soleModulePath } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 import { Fmt } from "@effected/cli";
 
 //#region src/dispatcher/cells/single-file-threshold.ts
@@ -13,10 +12,7 @@ const renderAgent = (inputs) => {
 	lines.push(...formatCoverageSummaryLines(inputs.state));
 	return `${lines.join("\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleFileThreshold = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleFileThreshold = { agent: renderAgent };
 
 //#endregion
 export { renderSingleFileThreshold };

package/dispatcher/cells/single-project-fail.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatFailure, formatTotals } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-project-fail.ts
 const DEFAULT_WIDTH = 80;
@@ -25,10 +24,7 @@ const renderAgent = (inputs) => {
 	if (moduleLines.length > 1) sections.push(moduleLines);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleProjectFail = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleProjectFail = { agent: renderAgent };
 
 //#endregion
 export { renderSingleProjectFail };

package/dispatcher/cells/single-project-pass.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatTotals } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 import { Fmt } from "@effected/cli";
 
 //#region src/dispatcher/cells/single-project-pass.ts
@@ -10,10 +9,7 @@ const renderAgent = (inputs) => {
 	const collected = inputs.state.collectedModules ?? inputs.state.moduleOrder.length;
 	return `${(collected === 0 ? [formatTotals(inputs.state)] : [formatTotals(inputs.state), `${Fmt.plural(collected, "module")} all-passed.`]).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleProjectPass = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleProjectPass = { agent: renderAgent };
 
 //#endregion
 export { renderSingleProjectPass };

package/dispatcher/cells/single-project-threshold.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatBelowTargetTable, formatCoverageSummaryLines, formatTotals, formatTrendLine } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-project-threshold.ts
 const BELOW_TARGET_LIMIT = 5;
@@ -16,10 +15,7 @@ const renderAgent = (inputs) => {
 	if (below.length > 0) sections.push([...below]);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderSingleProjectThreshold = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleProjectThreshold = { agent: renderAgent };
 
 //#endregion
 export { renderSingleProjectThreshold };

package/dispatcher/cells/single-test-fail.js

@@ -2,7 +2,6 @@ import { buildFooter } from "../footer.js";
 import { statusGlyph } from "../../theme.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { formatFailure, formatTestName, soleTest } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-test-fail.ts
 const DEFAULT_WIDTH = 80;
@@ -14,10 +13,7 @@ const renderAgent = (inputs) => {
 	const failure = inputs.state.failures[0];
 	return `${failure === void 0 ? `${header}\n` : `${header}\n${formatFailure(failure, DEFAULT_WIDTH).join("\n")}\n`}${buildFooter(inputs)}`;
 };
-const renderSingleTestFail = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleTestFail = { agent: renderAgent };
 
 //#endregion
 export { renderSingleTestFail };

package/dispatcher/cells/single-test-pass.js

@@ -2,7 +2,6 @@ import { buildFooter } from "../footer.js";
 import { statusGlyph } from "../../theme.js";
 import { formatDisplayDuration } from "../../format-duration.js";
 import { formatTestName, soleTest } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/single-test-pass.ts
 const renderAgent = (inputs) => {
@@ -11,10 +10,7 @@ const renderAgent = (inputs) => {
 	const duration = test.durationMs ?? 0;
 	return `${statusGlyph("success")} ${formatTestName(test)} (${formatDisplayDuration(duration)})\n${buildFooter(inputs)}`;
 };
-const renderSingleTestPass = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderSingleTestPass = { agent: renderAgent };
 
 //#endregion
 export { renderSingleTestPass };

package/dispatcher/cells/workspace-fail.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatFailure, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/workspace-fail.ts
 const DEFAULT_WIDTH = 80;
@@ -18,10 +17,7 @@ const renderAgent = (inputs) => {
 	if (inputs.projects.length > 0) sections.push([formatWorkspaceTotal(inputs.projects)]);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderWorkspaceFail = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderWorkspaceFail = { agent: renderAgent };
 
 //#endregion
 export { renderWorkspaceFail };

package/dispatcher/cells/workspace-pass.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatCoverageJudgmentLine, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/workspace-pass.ts
 const renderAgent = (inputs) => {
@@ -16,10 +15,7 @@ const renderAgent = (inputs) => {
 	if (inputs.projects.length > 0) sections.push([formatWorkspaceTotal(inputs.projects)]);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderWorkspacePass = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderWorkspacePass = { agent: renderAgent };
 
 //#endregion
 export { renderWorkspacePass };

package/dispatcher/cells/workspace-threshold.js

@@ -1,6 +1,5 @@
 import { buildFooter } from "../footer.js";
 import { formatBelowTargetTable, formatCoverageSummaryLines, formatProjectsTable, formatTrendLine, formatWorkspaceTotal } from "../helpers.js";
-import { renderAgentStringAsInk } from "../ink-helpers.js";
 
 //#region src/dispatcher/cells/workspace-threshold.ts
 const BELOW_TARGET_LIMIT = 10;
@@ -19,10 +18,7 @@ const renderAgent = (inputs) => {
 	if (inputs.projects.length > 0) sections.push([formatWorkspaceTotal(inputs.projects)]);
 	return `${sections.map((section) => section.join("\n")).join("\n\n")}\n${buildFooter(inputs)}`;
 };
-const renderWorkspaceThreshold = {
-	agent: renderAgent,
-	ink: (inputs) => renderAgentStringAsInk(renderAgent(inputs))
-};
+const renderWorkspaceThreshold = { agent: renderAgent };
 
 //#endregion
 export { renderWorkspaceThreshold };

package/dispatcher/dispatch.js

@@ -10,9 +10,7 @@ import { renderSingleTestThreshold } from "./cells/single-test-threshold.js";
 import { renderWorkspaceFail } from "./cells/workspace-fail.js";
 import { renderWorkspacePass } from "./cells/workspace-pass.js";
 import { renderWorkspaceThreshold } from "./cells/workspace-threshold.js";
-import { formatScopedCoverageNote } from "@vitest-agent/sdk";
-import { Box, Text } from "ink";
-import { createElement } from "react";
+import { formatScopedCoverageNote, formatStrayOutputNote } from "@vitest-agent/sdk";
 
 //#region src/dispatcher/dispatch.ts
 /**
@@ -56,11 +54,27 @@ const dispatcherTable = {
 const dispatch = (inputs, opts) => {
 	const body = dispatcherTable[inputs.shape][inputs.outcome].agent(inputs, opts);
 	const note = scopedCoverageNoteFor(inputs);
-	return note !== null ? `${body}\n${note}` : body;
+	const withNote = note !== null ? `${body}\n${note}` : body;
+	const stray = strayOutputNoteFor(inputs);
+	return stray !== null ? `${withNote}\n${stray}\n` : withNote;
+};
+/**
+* The stray-output note for a run that wrote past Vitest's console capture,
+* or `null` when it wrote nothing stray. `dispatch` and `dispatchInk` append
+* it after the cell's output (and the scoped-coverage note); cells never emit
+* it themselves.
+*
+* @param inputs - the classified dispatch inputs
+* @returns the note's lines joined, or `null`
+* @internal
+*/
+const strayOutputNoteFor = (inputs) => {
+	const stray = inputs.state.strayOutput;
+	return stray === void 0 ? null : formatStrayOutputNote(stray).join("\n");
 };
 /**
 * Build the scoped-coverage note for this run, or `null` on a full
-* (non-scoped) run. Shared by {@link dispatch} and {@link dispatchInk} so
+* (non-scoped) run. Shared by {@link dispatch} and the Ink entry's `dispatchInk` so
 * both render paths surface the same information (issue #160 gap 1) —
 * Vitest's coverage thresholds are meaningless against a subset of the
 * project's test files, so every cell's own threshold-flavored coverage
@@ -73,25 +87,6 @@ const scopedCoverageNoteFor = (inputs) => {
 	if (cov === null || cov.scoped !== true) return null;
 	return formatScopedCoverageNote(cov.scopedFiles ?? 0, cov.totalFiles);
 };
-/**
-* Dispatch to the cell that matches `(inputs.shape, inputs.outcome)`
-* and return its Ink-half React tree. Returns `null` when the matched
-* cell does not expose an `ink` half — callers should fall back to
-* the agent string in that case.
-*
-* @param inputs - the classified dispatch inputs
-* @param opts - cell rendering options
-* @returns the Ink React element, or `null` when the cell has no Ink half
-* @public
-*/
-const dispatchInk = (inputs, opts) => {
-	const cell = dispatcherTable[inputs.shape][inputs.outcome];
-	if (cell.ink === void 0) return null;
-	const element = cell.ink(inputs, opts);
-	const note = scopedCoverageNoteFor(inputs);
-	if (note === null) return element;
-	return createElement(Box, { flexDirection: "column" }, element, createElement(Text, null, note));
-};
 
 //#endregion
-export { dispatch, dispatchInk, dispatcherTable };
+export { dispatch, dispatcherTable, scopedCoverageNoteFor, strayOutputNoteFor };