niceeval 0.6.1 → 0.7.0

package/src/report/text/plot.ts

@@ -1,5 +1,5 @@
 // text 面的字符坐标图:MetricScatter / MetricLine 共用。
-// 形态照 docs-site/zh/guides/report-components.mdx 的示例块:y 轴刻度 + │ 边框,
+// 形态照 docs-site/zh/reference/report-components.mdx 的示例块:y 轴刻度 + │ 边框,
 // 点用字母标注、图例列在图下;lower-better 的轴反向,「好」的角落恒在右上。
 
 import { padDisplay, padStartDisplay, stringWidth } from "./layout.ts";

package/src/report/text/table.ts

@@ -8,8 +8,8 @@
 
 import type { TableProps, TableRow } from "../primitives.tsx";
 import type { TextContext } from "../tree.ts";
-import { countText, localeText } from "../locale.ts";
-import { renderAlignedRows, stringWidth, wrapDisplay, type ColumnAlign } from "./layout.ts";
+import { countText, localeText, resolveLocalizedText } from "../locale.ts";
+import { charDisplayWidth, renderAlignedRows, stringWidth, wrapDisplay, type ColumnAlign } from "./layout.ts";
 
 const MISSING_MARK = "—";
 /** 列间距,与 renderAlignedRows 的 join("   ") 一致。 */
@@ -56,12 +56,43 @@ function fitWidths(
   return { widths, hidden };
 }
 
-/** 逻辑行 → 物理行:每格折到自己的列宽,行高取最高的那格,矮格补空串。 */
-function toPhysicalRows(cells: readonly string[], widths: readonly number[]): string[][] {
+/** 按显示宽度截到 width(不够放 `…` 时原样返回)。 */
+function truncateDisplay(text: string, width: number): string {
+  if (stringWidth(text) <= width) return text;
+  let out = "";
+  let used = 0;
+  for (const ch of text) {
+    const w = charDisplayWidth(ch.codePointAt(0)!);
+    if (used + w > width) break;
+    out += ch;
+    used += w;
+  }
+  return out;
+}
+
+/** 列的 maxLines 收口:超出的行丢弃,最后一行以 `…` 如实标注被收口。 */
+function clampCellLines(lines: string[], maxLines: number | undefined, width: number): string[] {
+  if (maxLines === undefined || lines.length <= maxLines) return lines;
+  const kept = lines.slice(0, Math.max(1, maxLines));
+  const last = kept[kept.length - 1]!;
+  kept[kept.length - 1] = `${truncateDisplay(last, Math.max(1, width - 1))}…`;
+  return kept;
+}
+
+/** 逻辑行 → 物理行:每格折到自己的列宽,列带 maxLines 就收口,行高取最高的那格,矮格补空串。 */
+function toPhysicalRows(
+  cells: readonly string[],
+  widths: readonly number[],
+  maxLines: readonly (number | undefined)[],
+): string[][] {
   const wrapped = cells.map((cell, c) =>
     // 放得下就原样保留:wrapDisplay 会把连续空格折成一个,而 DeltaTable 的
     // "50% → 62%   +12pp" 这类格子内含固定间距 —— 不折行时一个字节都不能动。
-    !cell.includes("\n") && stringWidth(cell) <= widths[c] ? [cell] : wrapDisplay(cell, widths[c]),
+    clampCellLines(
+      !cell.includes("\n") && stringWidth(cell) <= widths[c] ? [cell] : wrapDisplay(cell, widths[c]),
+      maxLines[c],
+      widths[c]!,
+    ),
   );
   const height = Math.max(...wrapped.map((lines) => lines.length), 1);
   const out: string[][] = [];
@@ -79,7 +110,7 @@ export function renderTableText(props: TableProps, ctx: TextContext): string {
   const hasLocator = props.rows.some((row) => row.locator !== undefined);
   if (props.columns.length === 0 && !hasLocator) return "";
 
-  const header = props.columns.map((column) => column.header);
+  const header = props.columns.map((column) => resolveLocalizedText(column.header, locale));
   const align: ColumnAlign[] = props.columns.map((column) => column.align ?? "left");
   const body = props.rows.map((row) => props.columns.map((column) => cellText(row, column.key)));
   if (hasLocator) {
@@ -92,7 +123,13 @@ export function renderTableText(props: TableProps, ctx: TextContext): string {
   const natural = header.map((_, c) => Math.max(...matrix.map((row) => stringWidth(row[c] ?? ""))));
   const { widths, hidden } = fitWidths(natural, align, ctx.width);
 
-  const physical = matrix.flatMap((row) => toPhysicalRows(row.slice(0, widths.length), widths));
+  const maxLines: (number | undefined)[] = props.columns.map((column) => column.maxLines);
+  if (hasLocator) maxLines.push(undefined);
+  // 表头不参与 maxLines 收口:表头是自己写的短词,收口只服务数据格。
+  const physical = [
+    ...toPhysicalRows(header.slice(0, widths.length), widths, widths.map(() => undefined)),
+    ...body.flatMap((row) => toPhysicalRows(row.slice(0, widths.length), widths, maxLines)),
+  ];
   const table = renderAlignedRows(physical, align);
   return hidden > 0 ? `${table}\n${countText(locale, "table.columnsHidden", hidden)}` : table;
 }