niceeval 0.5.3 → 0.6.0

package/dist/report/text/faces.js

@@ -0,0 +1,503 @@
+// 官方组件的 text 面:同一份算好的数据,渲染成终端字符(niceeval show 的形态)。
+// 输出形态照 docs-site/zh/guides/report-components.mdx 的示例块;与 web 面共守
+// 诚实契约:排序随 better、samples < total 角标、缺数据 — 不补 0、截断报剩余。
+// 零 react、零 IO、纯同步 —— 这是 text 宿主不需要 react-dom 的那一半。
+// chrome 文案(注脚、verdict 词、截断提示)经 ctx.locale 查 locale 字典,
+// 默认 en 与历史输出逐字一致;数据(display、键、warnings message)不本地化。
+import { attemptItemReason, capabilityBadge, formatDurationMs, formatMetricValue, formatPlainNumber, formatUSD, verdictMark, } from "../format.js";
+import { countText, localeText, resolveMetricLabel } from "../locale.js";
+import { indentBlock, padDisplay, textBar, wrapDisplay } from "./layout.js";
+import { renderTableText } from "./table.js";
+import { renderCharPlot, renderCoordinateTable } from "./plot.js";
+const MISSING_MARK = "—";
+/** 缺数据文案随 locale(en = "no data",与 MISSING_TEXT 一致)。 */
+function missingText(locale) {
+    return localeText(locale, "cell.missing");
+}
+/** 格子的文本形态:缺数据 —,覆盖不全带 samples/total 角标。 */
+export function cellText(cell) {
+    if (cell.value === null)
+        return MISSING_MARK;
+    return cell.samples < cell.total ? `${cell.display} ${cell.samples}/${cell.total}` : cell.display;
+}
+// ───────────────────────── RunOverview ─────────────────────────
+export function overviewText(data, ctx) {
+    const { totals, snapshots } = data;
+    const locale = ctx.locale;
+    const runs = new Set(snapshots.map((s) => s.startedAt)).size;
+    const latest = snapshots.map((s) => s.startedAt).sort().at(-1);
+    const head = [
+        countText(locale, "overview.experiments", snapshots.length),
+        localeText(locale, "overview.evalsCount", { n: totals.evals }),
+        localeText(locale, "overview.attemptsCount", { n: totals.attempts }),
+        // 通过率只渲染 computeCell 算好的同一个 MetricCell(cellText 复用缺数据/coverage 角标语义),
+        // 不从 passed/failed/errored 现场重算——与 web 面 RunOverview 同一份数据同一种读法。
+        `${localeText(locale, "overview.passRate")} ${cellText(totals.passRate)}`,
+        countText(locale, "composedFrom", runs),
+        ...(latest ? [localeText(locale, "latestRun", { run: latest })] : []),
+    ].join(" · ");
+    const tallies = [
+        `${localeText(locale, "verdict.passed")} ${totals.passed}`,
+        `${localeText(locale, "verdict.failed")} ${totals.failed}`,
+        `${localeText(locale, "verdict.errored")} ${totals.errored}`,
+        `${localeText(locale, "verdict.skipped")} ${totals.skipped}`,
+        totals.costUSD === null ? missingText(locale) : formatUSD(totals.costUSD),
+        formatDurationMs(totals.durationMs),
+    ].join(" · ");
+    const lines = [head, tallies];
+    for (const warning of data.warnings)
+        lines.push(`! ${warning.message}`);
+    return lines.join("\n");
+}
+// ───────────────────────── GroupSummary ─────────────────────────
+/**
+ * 一至两行:头行是通过率(GroupSummaryData.passRate.display,不重算比例)+ experiment/eval 数 +
+ * failed(+ errored,非零才列,与旧 GroupSelector 卡片一致)+ 总成本;第二行(有则加)是最后运行时间。
+ * 不依赖固定网格宽度,窄终端自然换行。
+ */
+export function groupSummaryText(data, ctx) {
+    const locale = ctx.locale;
+    const head = [
+        `${localeText(locale, "overview.passRate")} ${cellText(data.passRate)}`,
+        countText(locale, "overview.experiments", data.experiments),
+        localeText(locale, "overview.evalsCount", { n: data.evals }),
+        `${localeText(locale, "verdict.failed")} ${data.verdicts.failed}`,
+        ...(data.verdicts.errored > 0 ? [`${localeText(locale, "verdict.errored")} ${data.verdicts.errored}`] : []),
+        data.totalCostUSD === null ? missingText(locale) : formatUSD(data.totalCostUSD),
+    ].join(" · ");
+    const lines = [head];
+    if (data.lastRunAt)
+        lines.push(localeText(locale, "latestRun", { run: data.lastRunAt }));
+    return lines.join("\n");
+}
+// ───────────────────────── MetricTable ─────────────────────────
+/** verdict 计票的紧凑文案("3 passed / 1 failed"):非零判定逐个列,全部为零如实 —。 */
+export function verdictTallyText(verdicts, locale) {
+    const parts = [];
+    for (const kind of ["passed", "failed", "errored", "skipped"]) {
+        if (verdicts[kind] > 0)
+            parts.push(`${verdicts[kind]} ${localeText(locale, `verdict.${kind}`)}`);
+    }
+    return parts.length > 0 ? parts.join(" / ") : MISSING_MARK;
+}
+export function tableText(data, ctx) {
+    const locale = ctx.locale;
+    // meta 在场时补 Model / Agent / Verdicts 列(rows: "experiment" 的榜单 parity);
+    // 列序对齐 view 原生榜单:experiment、model、agent、指标列…、verdicts
+    const hasMeta = data.rows.some((row) => row.meta !== undefined);
+    const hasModel = data.rows.some((row) => row.meta?.model !== undefined);
+    const hasVerdicts = data.rows.some((row) => row.meta?.verdicts !== undefined);
+    const columns = [
+        { key: "dimension", header: data.dimension },
+        ...(hasMeta && hasModel ? [{ key: "model", header: localeText(locale, "table.model") }] : []),
+        ...(hasMeta ? [{ key: "agent", header: localeText(locale, "table.agent") }] : []),
+        // 指标列的键用序号,不用 metric name —— 维度名、"model" 这些键都在同一个命名空间里,
+        // 指标恰好叫 "agent" 时不能把 meta 列顶掉。
+        ...data.columns.map((c, i) => ({ key: `metric${i}`, header: resolveMetricLabel(c.label, locale, c.key) })),
+        ...(hasVerdicts ? [{ key: "verdicts", header: localeText(locale, "table.verdicts") }] : []),
+    ];
+    const rows = data.rows.map((row) => {
+        const cells = { dimension: row.key };
+        if (hasMeta && hasModel)
+            cells.model = row.meta?.model ?? null;
+        if (hasMeta)
+            cells.agent = row.meta?.agent ?? null;
+        data.columns.forEach((col, i) => {
+            const cell = row.cells[col.key];
+            cells[`metric${i}`] = cell ? cellText(cell) : null;
+        });
+        if (hasVerdicts)
+            cells.verdicts = row.meta?.verdicts ? verdictTallyText(row.meta.verdicts, locale) : null;
+        return { key: row.key, cells };
+    });
+    const table = renderTableText({ columns, rows, locale }, ctx);
+    // rows: "experiment" 专属的行摘要(eval/attempt 数 + 最后运行时间):表格列已经挤满
+    // dimension/model/agent/指标/verdicts,这几个数字挤进行键下面单独一行,与 web 面
+    // 「行键下的小 sub-line」同一份信息、同一种「不进列」的取舍。
+    const metaLines = [];
+    for (const row of data.rows) {
+        if (row.meta?.evals === undefined)
+            continue;
+        const parts = [localeText(locale, "overview.evalsCount", { n: row.meta.evals })];
+        if (row.meta.attempts !== undefined && row.meta.attempts > row.meta.evals) {
+            parts.push(localeText(locale, "overview.attemptsCount", { n: row.meta.attempts }));
+        }
+        if (row.meta.lastRunAt)
+            parts.push(localeText(locale, "latestRun", { run: row.meta.lastRunAt }));
+        metaLines.push(`  ${row.key}: ${parts.join(" · ")}`);
+    }
+    const blocks = [table, ...(metaLines.length > 0 ? [metaLines.join("\n")] : [])];
+    return blocks.join("\n\n");
+}
+// ───────────────────────── MetricMatrix ─────────────────────────
+export function matrixText(data, ctx) {
+    // 表体全是维度键与 display,没有 chrome 文案;"next:" 是命令提示,不本地化。
+    const rowKeys = [];
+    const columnKeys = [];
+    const byPosition = new Map();
+    for (const entry of data.cells) {
+        if (!rowKeys.includes(entry.row))
+            rowKeys.push(entry.row);
+        if (!columnKeys.includes(entry.column))
+            columnKeys.push(entry.column);
+        byPosition.set(JSON.stringify([entry.row, entry.column]), entry.cell);
+    }
+    const columns = [
+        { key: "dimension", header: data.rows },
+        ...columnKeys.map((column, i) => ({ key: `column${i}`, header: column })),
+    ];
+    const rows = rowKeys.map((row) => {
+        const cells = { dimension: row };
+        columnKeys.forEach((column, i) => {
+            const cell = byPosition.get(JSON.stringify([row, column]));
+            cells[`column${i}`] = cell ? cellText(cell) : null; // 稀疏格子在文本里以 — 呈现,不编数
+        });
+        return { key: row, cells };
+    });
+    const table = renderTableText({ columns, rows, locale: ctx.locale }, ctx);
+    // 下钻命令:行维度是 eval 时,指向最值得看的一行(先挑有缺格的,再挑按 better 最差的)
+    if (data.rows !== "eval" || rowKeys.length === 0)
+        return table;
+    const better = data.metric.better ?? "higher";
+    let next;
+    let worst;
+    for (const row of rowKeys) {
+        let sum = 0;
+        let count = 0;
+        for (const column of columnKeys) {
+            const cell = byPosition.get(JSON.stringify([row, column]));
+            if (!cell || cell.value === null) {
+                next ??= row;
+                continue;
+            }
+            sum += cell.value;
+            count += 1;
+        }
+        if (count > 0) {
+            const value = sum / count;
+            const isWorse = worst === undefined || (better === "higher" ? value < worst.value : value > worst.value);
+            if (isWorse)
+                worst = { key: row, value };
+        }
+    }
+    next ??= worst?.key;
+    return next === undefined ? table : `${table}\n\nnext: niceeval show ${next}`;
+}
+// ───────────────────────── MetricBars(矩阵数据的另一种摆法)─────────────────────────
+const BAR_WIDTH = 20;
+export function barsText(data) {
+    const groupKeys = [];
+    const seriesKeys = [];
+    const byPosition = new Map();
+    for (const entry of data.cells) {
+        if (!groupKeys.includes(entry.row))
+            groupKeys.push(entry.row);
+        if (!seriesKeys.includes(entry.column))
+            seriesKeys.push(entry.column);
+        byPosition.set(JSON.stringify([entry.row, entry.column]), entry.cell);
+    }
+    const better = data.metric.better ?? "higher";
+    // 条长刻度:% 的天然域是 [0,1],其余以全图最大值为满条
+    const values = data.cells.map((c) => c.cell.value).filter((v) => v !== null);
+    const maxValue = values.length > 0 ? Math.max(...values) : 0;
+    const ratioOf = (value) => data.metric.unit === "%" ? value : maxValue === 0 ? 0 : value / maxValue;
+    const seriesWidth = Math.max(...seriesKeys.map((k) => k.length), 0);
+    const lines = [];
+    for (const group of groupKeys) {
+        lines.push(group);
+        const entries = seriesKeys.map((series) => ({
+            series,
+            cell: byPosition.get(JSON.stringify([group, series])),
+        }));
+        // 组内按值排序,方向随 better(缺数据沉底)
+        entries.sort((a, b) => {
+            const va = a.cell?.value ?? null;
+            const vb = b.cell?.value ?? null;
+            if (va === null && vb === null)
+                return 0;
+            if (va === null)
+                return 1;
+            if (vb === null)
+                return -1;
+            return better === "lower" ? va - vb : vb - va;
+        });
+        for (const { series, cell } of entries) {
+            const label = padDisplay(series, seriesWidth);
+            if (!cell || cell.value === null) {
+                lines.push(`  ${label}   ${MISSING_MARK}`);
+                continue;
+            }
+            lines.push(`  ${label}   ${textBar(ratioOf(cell.value), BAR_WIDTH)}  ${cellText(cell)}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ───────────────────────── Scoreboard ─────────────────────────
+export function scoreboardText(data, ctx) {
+    const locale = ctx.locale;
+    const subjectKeys = [];
+    for (const row of data.rows) {
+        for (const subject of row.subjects) {
+            if (!subjectKeys.includes(subject.key))
+                subjectKeys.push(subject.key);
+        }
+    }
+    const columns = [
+        { key: "dimension", header: data.dimension },
+        { key: "total", header: localeText(locale, "scoreboard.totalText") },
+        ...subjectKeys.map((key, i) => ({ key: `subject${i}`, header: key })),
+    ];
+    const rows = data.rows.map((row) => {
+        const cells = {
+            dimension: row.key,
+            total: `${row.total.display}/${data.fullMarks}`,
+        };
+        subjectKeys.forEach((key, i) => {
+            const subject = row.subjects.find((s) => s.key === key);
+            if (!subject) {
+                cells[`subject${i}`] = null;
+                return;
+            }
+            const score = `${formatPlainNumber(subject.earned)}/${formatPlainNumber(subject.possible)}`;
+            cells[`subject${i}`] =
+                subject.missing > 0
+                    ? `${score} ${localeText(locale, "scoreboard.missingText", { n: subject.missing })}`
+                    : score;
+        });
+        return { key: row.key, cells };
+    });
+    const table = renderTableText({ columns, rows, locale }, ctx);
+    if (data.weights.length === 0)
+        return table;
+    // 实际生效的权重表 —— 成绩单可审计
+    const weights = data.weights.map((w) => `${w.prefix} ×${w.weight}`).join(" · ");
+    return `${table}\n${localeText(locale, "scoreboard.weights")} ${weights} · ${localeText(locale, "scoreboard.othersWeight")}`;
+}
+// ───────────────────────── MetricScatter ─────────────────────────
+const POINT_MARKS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+function axisLabel(col, locale) {
+    return resolveMetricLabel(col.label, locale, col.key);
+}
+export function scatterText(data, ctx) {
+    const locale = ctx.locale;
+    const drawable = data.rows.filter((r) => r.x.value !== null && r.y.value !== null);
+    const missing = data.rows.length - drawable.length;
+    const footnotes = [];
+    if (missing > 0)
+        footnotes.push(countText(locale, "pointsMissing", missing));
+    const axes = { x: axisLabel(data.x, locale), y: axisLabel(data.y, locale) };
+    // 0 个可画点:x/y 指标没有可用数据(与 web 面同一事实)。
+    if (drawable.length === 0) {
+        return [localeText(locale, "scatter.noData", axes), ...footnotes].join("\n");
+    }
+    // 恰好 1 个可画点:成本 × 通过率的比较至少要两个实验,单点不成图。
+    if (drawable.length === 1) {
+        return [localeText(locale, "scatter.needTwo", axes), ...footnotes].join("\n");
+    }
+    // 点太密排不下时降级为坐标表,不硬挤
+    if (drawable.length > POINT_MARKS.length || ctx.width < 44) {
+        const table = renderCoordinateTable(drawable.map((r) => ({ key: r.key, x: r.x.display, y: r.y.display })), { key: data.points, x: axisLabel(data.x, locale), y: axisLabel(data.y, locale) });
+        return [table, ...footnotes].join("\n");
+    }
+    const points = drawable.map((r, i) => ({
+        mark: POINT_MARKS[i],
+        x: r.x.value,
+        y: r.y.value,
+    }));
+    // 同系列的点按 x 排序连线
+    const bySeries = new Map();
+    for (const r of drawable) {
+        if (r.series === undefined)
+            continue;
+        const list = bySeries.get(r.series) ?? [];
+        list.push({ x: r.x.value, y: r.y.value });
+        bySeries.set(r.series, list);
+    }
+    for (const list of bySeries.values())
+        list.sort((a, b) => a.x - b.x);
+    const invertX = data.x.better === "lower";
+    const plot = renderCharPlot({
+        width: ctx.width,
+        points,
+        lines: [...bySeries.values()].filter((l) => l.length > 1),
+        xLabel: `${axisLabel(data.x, locale)}${invertX ? ` ${localeText(locale, "scatter.axisReversed")}` : ""}`,
+        yLabel: axisLabel(data.y, locale),
+        formatX: (v) => formatMetricValue(v, data.x.unit),
+        formatY: (v) => formatMetricValue(v, data.y.unit),
+        invertX,
+        invertY: data.y.better === "lower",
+    });
+    const legend = drawable.map((r, i) => `${POINT_MARKS[i]} ${r.key}`).join("   ");
+    return [plot, "", localeText(locale, "scatter.betterUpperRight"), legend, ...footnotes].join("\n");
+}
+// ───────────────────────── MetricLine ─────────────────────────
+export function lineText(data, ctx) {
+    const locale = ctx.locale;
+    const drawable = data.rows.filter((r) => r.x !== null && r.y.value !== null);
+    const missing = data.rows.length - drawable.length;
+    const footnotes = [];
+    if (missing > 0)
+        footnotes.push(countText(locale, "pointsMissing", missing));
+    if (drawable.length === 0)
+        return [missingText(locale), ...footnotes].join("\n");
+    // 系列 → 字母;无系列 = 单系列
+    const seriesKeys = [];
+    for (const r of drawable) {
+        const key = r.series ?? "";
+        if (!seriesKeys.includes(key))
+            seriesKeys.push(key);
+    }
+    if (seriesKeys.length > POINT_MARKS.length || ctx.width < 44) {
+        const table = renderCoordinateTable(drawable.map((r) => ({ key: r.series ? `${r.key} (${r.series})` : r.key, x: r.xDisplay, y: r.y.display })), { key: "experiment", x: data.x.label, y: axisLabel(data.y, locale) });
+        return [table, ...footnotes].join("\n");
+    }
+    const markOf = (r) => POINT_MARKS[seriesKeys.indexOf(r.series ?? "")];
+    const points = drawable.map((r) => ({
+        mark: markOf(r),
+        x: r.x,
+        y: r.y.value,
+    }));
+    const lines = seriesKeys.map((key) => drawable
+        .filter((r) => (r.series ?? "") === key)
+        .map((r) => ({ x: r.x, y: r.y.value }))
+        .sort((a, b) => a.x - b.x));
+    const plot = renderCharPlot({
+        width: ctx.width,
+        points,
+        lines: lines.filter((l) => l.length > 1),
+        xLabel: data.x.label,
+        yLabel: axisLabel(data.y, locale),
+        formatX: (v) => formatMetricValue(v, data.x.unit),
+        formatY: (v) => formatMetricValue(v, data.y.unit),
+        invertY: data.y.better === "lower",
+    });
+    const legend = seriesKeys
+        .map((key, i) => `${POINT_MARKS[i]} ${key === "" ? axisLabel(data.y, locale) : key}`)
+        .join("   ");
+    return [plot, "", legend, ...footnotes].join("\n");
+}
+// ───────────────────────── DeltaTable ─────────────────────────
+export function deltaText(data, ctx) {
+    const columns = [
+        { key: "pair", header: "pair" },
+        ...data.columns.map((c, i) => ({ key: `metric${i}`, header: resolveMetricLabel(c.label, ctx.locale, c.key) })),
+    ];
+    const rows = data.rows.map((row) => {
+        const cells = { pair: row.key };
+        data.columns.forEach((col, i) => {
+            const cell = row.cells[col.key];
+            if (!cell) {
+                cells[`metric${i}`] = null;
+                return;
+            }
+            const a = cell.a.value === null ? MISSING_MARK : cell.a.display;
+            const b = cell.b.value === null ? MISSING_MARK : cell.b.display;
+            cells[`metric${i}`] = `${a} → ${b}   ${cell.display}`;
+        });
+        return { key: row.key, cells };
+    });
+    return renderTableText({ columns, rows, locale: ctx.locale }, ctx);
+}
+// ───────────────────────── 实体列表(ExperimentList / EvalList / AttemptList)─────────────────────────
+//
+// 三面共用的紧凑标记:`locator✓[E,X,⏱]`(判定符紧跟 locator,证据能力方括号紧跟判定符,
+// 中间不留空格)——docs-site/zh/guides/report-components.mdx「终端输出形成反馈闭环」定的形态。
+// ExperimentList / EvalList 逐 attempt 只列这一个标记 + 各自的原因/耗时摘要,不重复整段
+// niceeval show 命令;要看某个 attempt 的完整证据,agent 自己拼 `niceeval show <locator>`——
+// 命令模板只在 AttemptList(叶子层)展示完整断言明细时才值得,不在中间层重复。
+function locatorBadge(item) {
+    return `${item.locator}${verdictMark(item.verdict)}${capabilityBadge(item.capabilities)}`;
+}
+// ── ExperimentList ──
+function experimentListEvalLine(row) {
+    const badges = row.attempts.map(locatorBadge).join(" ");
+    const trailer = row.verdict === "passed"
+        ? [formatDurationMs(row.duration.value ?? 0), row.cost.value === null ? undefined : formatUSD(row.cost.value)]
+            .filter((s) => s !== undefined)
+            .join(" · ")
+        : (row.reason ?? "");
+    return `  ${verdictMark(row.verdict)} ${row.evalId}   ${badges}   ${trailer}`;
+}
+export function experimentListText(items, ctx) {
+    const locale = ctx.locale;
+    if (items.length === 0)
+        return localeText(locale, "attemptList.empty");
+    const blocks = items.map((item) => {
+        const identity = item.model ? `${item.experimentId} · ${item.agent} · ${item.model}` : `${item.experimentId} · ${item.agent}`;
+        const summary = [
+            `${localeText(locale, "overview.passRate")} ${cellText(item.passRate)}`,
+            verdictTallyText(item.verdicts, locale),
+            localeText(locale, "overview.attemptsCount", { n: item.attempts }),
+            formatDurationMs(item.duration.value ?? 0),
+            item.cost.value === null ? missingText(locale) : formatUSD(item.cost.value),
+        ].join(" · ");
+        const evalLines = item.evalRows.map(experimentListEvalLine);
+        return [identity, `  ${summary}`, ...evalLines].join("\n");
+    });
+    return blocks.join("\n\n");
+}
+// ── EvalList ──
+function evalListAttemptLine(item) {
+    const reason = attemptItemReason(item);
+    return `  ${locatorBadge(item)}${reason ? ` · ${reason}` : ""}`;
+}
+export function evalListText(items, ctx) {
+    const locale = ctx.locale;
+    if (items.length === 0)
+        return localeText(locale, "attemptList.empty");
+    const blocks = items.map((item) => {
+        const identity = `${item.evalId} · ${item.experimentId} · ${localeText(locale, `verdict.${item.verdict}`)}`;
+        const summary = [
+            localeText(locale, "attemptList.score", { score: cellText(item.score) }),
+            localeText(locale, "overview.attemptsCount", { n: item.attempts.length }),
+            `${formatDurationMs(item.duration.value ?? 0)} avg`,
+            item.cost.value === null ? `${missingText(locale)} avg` : `${formatUSD(item.cost.value)} avg`,
+        ].join(" · ");
+        const attemptLines = item.attempts.map(evalListAttemptLine);
+        return [identity, `  ${summary}`, ...attemptLines].join("\n");
+    });
+    return blocks.join("\n\n");
+}
+// ── AttemptList ──
+/** 一个 AttemptListItem 的完整 text 卡片:判定符 + locator + 身份 + 耗时/成本 + 证据能力,
+ * 然后逐条断言(gate 与 soft 都列,与 web 面的 AttemptRow 同一份材料)。 */
+function attemptListItemText(item, ctx, locale) {
+    const head = [
+        `${verdictMark(item.verdict)} ${item.locator}`,
+        item.evalId,
+        item.experimentId,
+        formatDurationMs(item.durationMs),
+        ...(item.costUSD !== undefined ? [formatUSD(item.costUSD)] : []),
+        ...(capabilityBadge(item.capabilities) ? [capabilityBadge(item.capabilities)] : []),
+    ].join(" · ");
+    const lines = [head];
+    if (item.error) {
+        lines.push(indentBlock(wrapDisplay(item.error, ctx.width - 4).join("\n"), "    "));
+    }
+    for (const assertion of item.assertions) {
+        const scoreText = assertion.threshold !== undefined
+            ? `${formatPlainNumber(assertion.score)}/${formatPlainNumber(assertion.threshold)}`
+            : formatPlainNumber(assertion.score);
+        lines.push(`  ${assertion.severity} ${assertion.name} · ${localeText(locale, `verdict.${assertion.passed ? "passed" : "failed"}`)}${assertion.severity === "soft" ? ` ${scoreText}` : ""}`);
+        if (assertion.detail)
+            lines.push(indentBlock(wrapDisplay(assertion.detail, ctx.width - 4).join("\n"), "    "));
+        if (assertion.evidence) {
+            const limit = Math.max(240, ctx.width * 5);
+            const evidence = assertion.evidence.length <= limit
+                ? assertion.evidence
+                : `${assertion.evidence.slice(0, limit)}… (${assertion.evidence.length - limit} more chars; open ${item.locator} for full evidence)`;
+            lines.push(indentBlock(wrapDisplay(evidence, ctx.width - 6).join("\n"), "      "));
+        }
+    }
+    return lines.join("\n");
+}
+export function attemptListText(items, total, ctx) {
+    const locale = ctx.locale;
+    if (items.length === 0)
+        return localeText(locale, "attemptList.empty");
+    const blocks = items.map((item) => attemptListItemText(item, ctx, locale));
+    const remaining = (total ?? items.length) - items.length;
+    if (remaining > 0)
+        blocks.push(localeText(locale, "attemptList.truncatedText", { n: remaining }));
+    return blocks.join("\n\n");
+}

package/dist/report/text/layout.d.ts

@@ -0,0 +1,75 @@
+/** 终端显示宽度:CJK / 全角记 2 列,其余记 1。启发式覆盖常用区段,够对齐表格用。 */
+export declare function charDisplayWidth(codePoint: number): number;
+/**
+ * 一段文本在终端里占几列:CJK / 全角字符记 2 列,其余记 1 列。
+ *
+ * 对齐终端输出用它,不要用 `String.prototype.length`——`length` 数的是 UTF-16 码元,
+ * 一个汉字占 2 个显示列却只算 1 个码元,中文一进来列就错位。
+ *
+ * @param text 任意文本。
+ * @returns 显示列数。
+ */
+export declare function stringWidth(text: string): number;
+/**
+ * 按显示宽度在右侧补空格(左对齐)。超宽不截断,如实溢出。
+ *
+ * `String.prototype.padEnd` 的显示宽度版:内容含中文时才对得齐。
+ *
+ * @param text 要补齐的文本。
+ * @param width 目标显示宽度。
+ * @returns 补齐后的文本。
+ */
+export declare function padDisplay(text: string, width: number): string;
+/**
+ * 按显示宽度在左侧补空格(右对齐)。超宽不截断,如实溢出。
+ *
+ * 数字列靠它对齐小数点。
+ *
+ * @param text 要补齐的文本。
+ * @param width 目标显示宽度。
+ * @returns 补齐后的文本。
+ */
+export declare function padStartDisplay(text: string, width: number): string;
+/**
+ * 按显示宽度折行:优先在空格处断,单个词超宽(URL / 中文长句)按列宽硬断。
+ *
+ * @param text 要折行的文本(`\n` 分段)。
+ * @param width 每行的最大显示宽度。
+ * @returns 折好的行;至少一行(空串输入 → `[""]`)。
+ */
+export declare function wrapDisplay(text: string, width: number): string[];
+/**
+ * 给一整块文本的每行加同一段前缀(嵌套块缩进)。空行不加,不留尾随空格。
+ *
+ * @param block 多行文本。
+ * @param indent 每行的前缀,通常是若干空格。
+ * @returns 缩进后的文本块。
+ */
+export declare function indentBlock(block: string, indent: string): string;
+/** 列对齐方向:`"left"` 是默认,`"right"` 按显示宽度右对齐(数字列用)。 */
+export type ColumnAlign = "left" | "right";
+/**
+ * 对齐列渲染:每列宽 = 该列最宽格的显示宽度,列间 3 空格,行尾不留空白。首行是表头。
+ * `align[c]` 给第 c 列的对齐方向,缺省 `"left"`。
+ *
+ * 内部件:公开面是 <Table> 原语(见 ./table.ts 的 renderTableText,它先按 ctx.width
+ * 定好列宽再调这里)。不导出到 `niceeval/report` —— 两条并行的建表路径只会让作者选错。
+ */
+export declare function renderAlignedRows(rows: string[][], align?: readonly ColumnAlign[], separator?: string): string;
+/**
+ * 字符条形:比例 → `█` 填充、`░` 补齐到 `barWidth` 显示列。比例超出 [0, 1] 时钳住。
+ *
+ * @param ratio 填充比例,0 到 1。
+ * @param barWidth 整条的显示宽度。
+ * @returns 定宽的字符条。
+ */
+export declare function textBar(ratio: number, barWidth: number): string;
+/**
+ * 多块文本并排成栏(`Row` 的 text 面):逐行拼接,各栏按显示宽度补齐,短栏补空行。
+ *
+ * @param blocks 每栏一块多行文本。
+ * @param columnWidths 每栏的显示宽度,与 `blocks` 一一对应。
+ * @param separator 栏间分隔符,默认 `" │ "`。
+ * @returns 并排后的文本块。
+ */
+export declare function joinColumns(blocks: string[], columnWidths: number[], separator?: string): string;