niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/definition/report.d.ts

@@ -0,0 +1,203 @@
+/**
+ * The Report author declaration.  This module deliberately knows how to
+ * validate and normalize author data, but never how to open a Record, run an
+ * Effect, or publish a site.  Those are Host responsibilities.
+ */
+import type { AttemptEvidenceDomainView, JsonValue, PricingProfile, Sample as AnalysisSample } from "../../analysis/index.js";
+import type { AttemptLocator } from "../../attempt-locator.js";
+import type { LocalizedText } from "../model/locale.js";
+import { type ThemeDefinition } from "../theme.js";
+import { type DimensionPins } from "../presentation.js";
+import type { ReportNode } from "./tree.js";
+export type { DimensionPins } from "../presentation.js";
+export type { PricingProfile } from "../../analysis/index.js";
+/**
+ * A Host-issued Analysis capability at the Report boundary.  It is an alias,
+ * rather than a wrapper, so the Analysis facade can consume it without a
+ * second capability registry.  Its public shape exposes no reader, path, or
+ * Effect Scope.
+ */
+export type ReportSample = AnalysisSample;
+/** Author-facing Sample alias for Report imports. */
+export type Sample = ReportSample;
+export declare const DEFAULT_PAGE_ID = "report";
+export declare const DEFAULT_PAGE_TITLE: LocalizedText;
+export type HeadAttributeValue = string | true;
+export type HeadAttributes = Readonly<Record<string, HeadAttributeValue>>;
+export type ScriptCrossOrigin = "anonymous" | "use-credentials";
+export type ScriptReferrerPolicy = "no-referrer" | "no-referrer-when-downgrade" | "origin" | "origin-when-cross-origin" | "same-origin" | "strict-origin" | "strict-origin-when-cross-origin" | "unsafe-url";
+/** The normalized script attributes retained after Host validation. */
+export type ScriptHeadAttributes = Readonly<{
+    readonly src?: string;
+    readonly type?: string;
+    readonly async?: true;
+    readonly defer?: true;
+    readonly integrity?: string;
+    readonly crossorigin?: ScriptCrossOrigin;
+    readonly referrerpolicy?: ScriptReferrerPolicy;
+}> & Readonly<Partial<Record<`data-${string}`, string>>>;
+/**
+ * The author shape: a closed tag-name union with ordinary string/boolean
+ * attributes. The Host still applies tag-specific validation before any value
+ * enters a revision, so this preserves author inference without opening raw
+ * HTML or bypassing the script/style safety boundary.
+ */
+export type HeadTag = Readonly<{
+    readonly tag: "meta" | "link";
+    readonly attrs: HeadAttributes;
+    readonly children?: never;
+}> | Readonly<{
+    readonly tag: "script" | "style";
+    readonly attrs?: HeadAttributes;
+    readonly children?: string;
+}>;
+export type StyleDeclaration = Readonly<{
+    readonly tag: "style";
+    readonly attrs?: HeadAttributes;
+    readonly children: string;
+}>;
+/** Declarative asset value; materialization remains Host-owned. */
+export type ReportAsset = Readonly<{
+    readonly src: string;
+    readonly inline?: never;
+}> | Readonly<{
+    readonly inline: string;
+    readonly src?: never;
+}>;
+export interface ReportShell {
+    readonly title?: LocalizedText;
+    readonly theme?: ThemeDefinition;
+    readonly dimensionPins?: DimensionPins;
+    readonly head?: readonly HeadTag[];
+    /**
+     * The one pricing source for this Report's cost projections.  It must be a
+     * pricing-profile/v1 value created by Analysis `definePricingProfile`.
+     * Report validates it through Analysis and retains the same frozen object.
+     */
+    readonly pricing?: PricingProfile;
+}
+/** The page identity made available to callbacks while the ReportSample lives. */
+export interface PageContext {
+    readonly id: string;
+    readonly path: string;
+    readonly title: LocalizedText;
+    /** Present only for one already-enumerated parameterized Page instance. */
+    readonly params?: JsonValue;
+}
+/** A canonical locator selects one Host-provided closed Evidence view. */
+export type EvidenceLocator = AttemptLocator;
+export type PageEvidence = AttemptEvidenceDomainView;
+/**
+ * The deliberately narrow Page data access surface.  Evidence is already a
+ * closed domain view; no Record reader, source root, filesystem path, or
+ * arbitrary lookup enters author callbacks.
+ */
+export interface PageLoadContext {
+    readonly page: PageContext;
+    readonly evidence: (locator: EvidenceLocator) => Promise<PageEvidence>;
+}
+export type PageLoad<Params, Input> = (sample: ReportSample, params: Params, context: PageLoadContext) => Input | Promise<Input>;
+export type PageRender<Input> = (input: Input, context: PageContext) => ReportNode | Promise<ReportNode>;
+/** A parameter codec and the finite set of instances belonging to one build. */
+export interface PageParams<Params extends JsonValue> {
+    readonly encode: (params: Params) => string;
+    readonly decode: (key: string) => Params;
+    readonly enumerate: (sample: ReportSample) => Iterable<Params> | Promise<Iterable<Params>>;
+}
+/** A typed target for a Report-owned route. */
+export interface ReportTarget<Params extends JsonValue = JsonValue> {
+    readonly page: string;
+    readonly params?: Params;
+}
+/** A normal Page.  Without load(), its render input is the fixed ReportSample. */
+export interface PlainPage<Input = ReportSample> {
+    readonly id: string;
+    readonly path?: string;
+    readonly title: LocalizedText;
+    readonly navigation?: boolean;
+    readonly params?: never;
+    readonly load?: PageLoad<void, Input>;
+    readonly render: PageRender<Input>;
+}
+/** A parameterized page has no navigation entry until a Host enumerates it. */
+export interface ParameterizedPage<Params extends JsonValue, Input> {
+    readonly id: string;
+    readonly path?: string;
+    readonly title: LocalizedText;
+    readonly navigation: false;
+    readonly params: PageParams<Params>;
+    readonly load: PageLoad<Params, Input>;
+    readonly render: PageRender<Input>;
+}
+export type Page<Params extends JsonValue | void = void, Input = ReportSample> = [
+    Params
+] extends [void] ? PlainPage<Input> : ParameterizedPage<Extract<Params, JsonValue>, Input>;
+type AnyPage = PlainPage<any> | ParameterizedPage<any, any>;
+interface NormalizedPlainPage<Input = unknown> {
+    readonly id: string;
+    readonly path: string;
+    readonly title: LocalizedText;
+    readonly navigation: boolean;
+    readonly params?: never;
+    readonly load?: PageLoad<void, Input>;
+    readonly render: PageRender<Input>;
+}
+interface NormalizedParameterizedPage<Params extends JsonValue = JsonValue, Input = unknown> {
+    readonly id: string;
+    readonly path: string;
+    readonly title: LocalizedText;
+    readonly navigation: false;
+    readonly params: PageParams<Params>;
+    readonly load: PageLoad<Params, Input>;
+    readonly render: PageRender<Input>;
+}
+type NormalizedPage = NormalizedPlainPage | NormalizedParameterizedPage;
+/** Internal product-list helper also used by the built-in declaration factory. */
+export type NonEmptyArray<Value> = readonly [Value, ...Value[]];
+interface ReportInput<Pages extends NonEmptyArray<AnyPage> = NonEmptyArray<AnyPage>> extends ReportShell {
+    readonly pages: Pages;
+}
+/** Internal input shape for package-built Report factories; not a public manifest alias. */
+export interface ReportOptions<Pages extends NonEmptyArray<AnyPage> = NonEmptyArray<AnyPage>> extends ReportInput<Pages> {
+}
+/**
+ * A frozen Report definition.  Callback-bearing pages stay here only while a
+ * Host resolves them; a finished Site revision must never retain this value.
+ */
+export interface ReportDefinition extends Omit<ReportShell, "pricing"> {
+    readonly kind: "report";
+    /** Structural-only declaration marker that survives independently emitted declarations. */
+    readonly __niceevalReportDefinition: never;
+    readonly head: readonly HeadTag[];
+    readonly pages: NonEmptyArray<NormalizedPage>;
+    /** The exact Analysis-created Profile, or the explicit no-Profile state. */
+    readonly pricing: PricingProfile | null;
+}
+export interface ReportMetaPage {
+    readonly id: string;
+    readonly title: LocalizedText;
+    readonly navigation: boolean;
+}
+/** Closed declaration metadata available as ctx.report during one resolve. */
+export interface ReportMeta {
+    readonly title: LocalizedText;
+    readonly pages: readonly ReportMetaPage[];
+    /**
+     * The exact same frozen value as the owning ReportDefinition's `pricing`.
+     * `ctx.report.pricing === report.pricing` holds by construction; consumers
+     * pass it to the profile-taking `costUSD(profile)` / `totalCostUSD(profile)`.
+     */
+    readonly pricing: PricingProfile | null;
+}
+/**
+ * Defines a Report with a non-empty Page list. A separate overload accepts a
+ * single-page shorthand and normalizes it to /.
+ */
+export declare function defineReport<const Pages extends NonEmptyArray<AnyPage>>(definition: ReportInput<Pages>): ReportDefinition;
+export declare function defineReport(render: (sample: ReportSample) => ReportNode | Promise<ReportNode>): ReportDefinition;
+/** Recognizes a Report from another installed copy of niceeval as well. */
+export declare function isReport(value: unknown): value is ReportDefinition;
+/** The declaration title is stable without opening a Sample. */
+export declare function resolveReportTitle(value: ReportDefinition): LocalizedText;
+/** Produces declaration-only metadata for ctx.report; it never opens a Sample. */
+export declare function buildReportMeta(value: ReportDefinition): ReportMeta;

package/dist/report/definition/report.js

@@ -0,0 +1,16 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./report.cjs");
+const __niceevalExport0 = __niceevalCanonical["DEFAULT_PAGE_ID"];
+export { __niceevalExport0 as DEFAULT_PAGE_ID };
+const __niceevalExport1 = __niceevalCanonical["DEFAULT_PAGE_TITLE"];
+export { __niceevalExport1 as DEFAULT_PAGE_TITLE };
+const __niceevalExport2 = __niceevalCanonical["buildReportMeta"];
+export { __niceevalExport2 as buildReportMeta };
+const __niceevalExport3 = __niceevalCanonical["defineReport"];
+export { __niceevalExport3 as defineReport };
+const __niceevalExport4 = __niceevalCanonical["isReport"];
+export { __niceevalExport4 as isReport };
+const __niceevalExport5 = __niceevalCanonical["resolveReportTitle"];
+export { __niceevalExport5 as resolveReportTitle };
+//# sourceMappingURL=report.js.map

package/dist/report/definition/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sources":[],"names":[],"mappings":""}

package/dist/report/definition/table-text.cjs

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTableText = renderTableText;
+const locale_ts_1 = require("../model/locale.cjs");
+const text_layout_ts_1 = require("../model/text-layout.cjs");
+const panel_ts_1 = require("../model/panel.cjs");
+const text_panel_state_ts_1 = require("./primitives/text-panel-state.cjs");
+const MISSING_MARK = "—";
+/** 列间距,与 renderAlignedRows 的 join("   ") 一致。 */
+const COLUMN_GAP = 3;
+/** 左对齐列的压缩下限:再窄就读不成句,宁可丢列。 */
+const MIN_TEXT_COLUMN = 8;
+/** 身份列(首列)的压缩下限:读不出身份的行等于没有,所以它比其余文本列早停在这个宽度
+ *  ——列自然宽本来就短于它时以自然宽为准,不给短列补空。压到这一步还放不下就丢列。 */
+const MIN_IDENTITY_COLUMN = 24;
+/** 格子的文本形态:缺这个键、或值是 null,都渲染 —(与 web 面同源)。 */
+function cellText(row, key) {
+    const value = row.cells[key];
+    return value === null || value === undefined ? MISSING_MARK : value;
+}
+function totalWidth(widths) {
+    return widths.reduce((sum, w) => sum + w, 0) + COLUMN_GAP * Math.max(0, widths.length - 1);
+}
+/**
+ * 自然列宽 → 放得进 available 的列宽。两步,顺序即优先级:
+ * 1. 按自然宽的比例压所有左对齐列(文本列)到下限 —— 右对齐列是数字,折行读不了,不压;
+ *    按比例分摊而不是逐个压最宽的那列:两个都很长的文本列各让一半,比把其中一个压到
+ *    下限(读出来是「Experime / nt」)可读得多;
+ * 2. 全部压到下限仍放不下,才从右侧丢列(至少留一列),丢了几列如实返回。
+ */
+function fitWidths(natural, align, available) {
+    const widths = [...natural];
+    const floorOf = (c) => c === 0 ? Math.min(natural[0] ?? MIN_IDENTITY_COLUMN, MIN_IDENTITY_COLUMN) : MIN_TEXT_COLUMN;
+    for (;;) {
+        const over = totalWidth(widths) - available;
+        if (over <= 0)
+            break;
+        const flexible = widths
+            .map((w, c) => ({ c, w, floor: floorOf(c) }))
+            .filter(({ c, w, floor }) => align[c] !== "right" && w > floor);
+        if (flexible.length === 0)
+            break;
+        // 可压缩总量按各列自己的余量加权分摊;取整后的余数留给下一轮,循环终止于「无列可压」。
+        const slack = flexible.reduce((sum, { w, floor }) => sum + (w - floor), 0);
+        let remaining = Math.min(over, slack);
+        for (const { c, w, floor } of flexible) {
+            if (remaining <= 0)
+                break;
+            const share = Math.min(w - floor, Math.max(1, Math.round((over * (w - floor)) / slack)), remaining);
+            widths[c] = w - share;
+            remaining -= share;
+        }
+    }
+    let hidden = 0;
+    while (widths.length > 1 && totalWidth(widths) > available) {
+        widths.pop();
+        hidden += 1;
+    }
+    return { widths, hidden };
+}
+/** 按显示宽度截到 width(不够放 `…` 时原样返回)。 */
+function truncateDisplay(text, width) {
+    if ((0, text_layout_ts_1.stringWidth)(text) <= width)
+        return text;
+    let out = "";
+    let used = 0;
+    for (const ch of text) {
+        const w = (0, text_layout_ts_1.charDisplayWidth)(ch.codePointAt(0));
+        if (used + w > width)
+            break;
+        out += ch;
+        used += w;
+    }
+    return out;
+}
+/** 列的 maxLines 收口:超出的行丢弃,最后一行以 `…` 如实标注被收口。 */
+function clampCellLines(lines, maxLines, width) {
+    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;
+}
+/**
+ * 折行时保住格子开头的缩进:层级就长在首列的缩进上(docs 的「层级与横线」),而 wrapDisplay
+ * 会把行首空格吃掉——身份被压窄正是最需要看清层级的时候,不能一折行就把层级折没了。
+ * 续行跟着对齐到同一个缩进。
+ */
+function wrapIndented(cell, width) {
+    const indent = cell.length - cell.trimStart().length;
+    if (indent === 0)
+        return (0, text_layout_ts_1.wrapDisplay)(cell, width);
+    const pad = " ".repeat(indent);
+    const body = (0, text_layout_ts_1.wrapDisplay)(cell.slice(indent), Math.max(1, width - indent));
+    return body.map((line) => `${pad}${line}`);
+}
+/** 逻辑行 → 物理行:每格折到自己的列宽,列带 maxLines 就收口,行高取最高的那格,矮格补空串。 */
+function toPhysicalRows(cells, widths, maxLines) {
+    const wrapped = cells.map((cell, c) => 
+    // 放得下就原样保留:wrapDisplay 会把连续空格折成一个,而 DeltaTable 的
+    // "50% → 62%   +12pp" 这类格子内含固定间距 —— 不折行时一个字节都不能动。
+    clampCellLines(!cell.includes("\n") && (0, text_layout_ts_1.stringWidth)(cell) <= widths[c] ? [cell] : wrapIndented(cell, widths[c]), maxLines[c], widths[c]));
+    const height = Math.max(...wrapped.map((lines) => lines.length), 1);
+    const out = [];
+    for (let i = 0; i < height; i++)
+        out.push(wrapped.map((lines) => lines[i] ?? ""));
+    return out;
+}
+/**
+ * <Table> 的 text 面:columns × rows → 对齐的字符表。
+ * 有任一行带 locator 时追加一列 attempt(locator 本身就是 `niceeval show <locator>`
+ * 的位置参数;逐行重复整条命令会把表撑宽,与三个实体列表 text 面的既有取舍一致)。
+ */
+function renderTableText(props, ctx) {
+    const locale = props.locale ?? ctx.locale;
+    const hasLocator = props.rows.some((row) => row.locator !== undefined);
+    if (props.columns.length === 0 && !hasLocator)
+        return "";
+    const header = props.columns.map((column) => (0, locale_ts_1.resolveLocalizedText)(column.header, locale));
+    const align = props.columns.map((column) => column.align ?? "left");
+    const body = props.rows.map((row) => props.columns.map((column) => cellText(row, column.key)));
+    if (hasLocator) {
+        header.push((0, locale_ts_1.localeText)(locale, "table.attempt"));
+        align.push("left");
+        props.rows.forEach((row, i) => body[i].push(row.locator ?? MISSING_MARK));
+    }
+    const matrix = [header, ...body];
+    const natural = header.map((_, c) => Math.max(...matrix.map((row) => (0, text_layout_ts_1.stringWidth)(row[c] ?? ""))));
+    // 画线时列间距与不画线时相同(` │ ` 与 `   ` 都是 3 列),所以只有外框那 4 列要先让出来。
+    const lines = (0, panel_ts_1.dataBoxMode)(ctx.panelMode, ctx.width) === "boxed";
+    // 嵌在画框的 Section 里:边界已由面板的框给出,自己只留列边界与表头横线,不套二层框。
+    const outerFrame = lines && (0, text_panel_state_ts_1.panelSectionDepth)() === 0;
+    const available = outerFrame ? ctx.width - panel_ts_1.DATA_BOX_FRAME_OVERHEAD : ctx.width;
+    const { widths, hidden } = fitWidths(natural, align, available);
+    const maxLines = props.columns.map((column) => column.maxLines);
+    if (hasLocator)
+        maxLines.push(undefined);
+    // 表头不参与 maxLines 收口:表头是自己写的短词,收口只服务数据格。
+    const headerPhysical = toPhysicalRows(header.slice(0, widths.length), widths, widths.map(() => undefined));
+    const bodyBlocks = body.map((row, i) => ({
+        depth: props.rows[i]?.depth ?? 0,
+        physical: toPhysicalRows(row.slice(0, widths.length), widths, maxLines),
+    }));
+    const bodyPhysical = bodyBlocks.flatMap((block) => block.physical);
+    const table = lines
+        ? renderFramedTable(headerPhysical, bodyBlocks, widths, align, outerFrame)
+        : (0, text_layout_ts_1.renderAlignedRows)([...headerPhysical, ...bodyPhysical], align);
+    return hidden > 0 ? `${table}\n${(0, locale_ts_1.countText)(locale, "table.columnsHidden", hidden)}` : table;
+}
+/**
+ * 数据格框形态:列边界贯穿全表,横线画在行树自己的边界上——表头与正文之间一条,行树有
+ * 嵌套时每个顶层行之前再一条(一组一格,组内不切)。平表只有表头那一条:逐行切割读起来
+ * 是一堆独立小框,层级与分组反而看不出来。分隔只按 depth 判,`Table` 不认识具体实体。
+ *
+ * 框宽跟随表自己的内容宽度(`fitWidths` 已经把它压进可用列数),不硬拉满终端——
+ * 窄表拉满只会让同一行的读数彼此远离。
+ */
+function renderFramedTable(header, body, widths, align, outerFrame) {
+    // 实际列宽取该列所有物理行的最宽者:压缩与折行之后不少列比预算更窄,框跟着收。
+    const physical = [...header, ...body.flatMap((block) => block.physical)];
+    const actual = widths.map((w, c) => {
+        const widest = Math.max(...physical.map((row) => (0, text_layout_ts_1.stringWidth)(row[c] ?? "")), 1);
+        return Math.min(w, widest);
+    });
+    const line = (row) => (0, panel_ts_1.dataBoxRow)(actual.map((w, c) => (align[c] === "right" ? (0, text_layout_ts_1.padStartDisplay)(row[c] ?? "", w) : (0, text_layout_ts_1.padDisplay)(row[c] ?? "", w))), outerFrame);
+    const nested = body.some((block) => block.depth > 0);
+    const out = [];
+    if (outerFrame)
+        out.push((0, panel_ts_1.dataBoxBorder)("top", actual, true));
+    for (const row of header)
+        out.push(line(row));
+    out.push((0, panel_ts_1.dataBoxBorder)("rule", actual, outerFrame));
+    body.forEach((block, i) => {
+        if (nested && i > 0 && block.depth === 0)
+            out.push((0, panel_ts_1.dataBoxBorder)("rule", actual, outerFrame));
+        for (const row of block.physical)
+            out.push(line(row));
+    });
+    if (outerFrame)
+        out.push((0, panel_ts_1.dataBoxBorder)("bottom", actual, true));
+    return out.join("\n");
+}
+//# sourceMappingURL=table-text.cjs.map

package/dist/report/definition/table-text.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-text.js","sourceRoot":"","sources":["table-text.ts"],"names":[],"mappings":"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","sourcesContent":["// <Table> 原语的 text 面(../primitives.tsx 的 Table.text 就是它)。\n// 官方的表状组件(Table / Scoreboard / DeltaTable)的 text 面也直接\n// 调它 —— 官方与自定义表共用同一个渲染器,是「用户组件与官方组件对等」的构造证明:\n// 官方用不上的能力用户就拿不到,官方绕过它手搓它就一定会长歪。\n//\n// 列宽按显示宽度算(CJK 记 2 列);null 渲染 —,不补 0;超宽按比例压左对齐列并在格内折行,\n// 全压到下限仍放不下才从右侧丢列并如实报数(「截断报剩余」是既有契约,不在这里破例)。\n// 画线与不画线是同一份列宽算术:数据格框的列间 ` │ ` 与朴素形态的 `   ` 都占 3 列。\nimport type { TableColumn, TableRow } from \"./primitives.tsx\";\nimport type { TextContext } from \"./tree.ts\";\nimport { countText, localeText, resolveLocalizedText } from \"../model/locale.ts\";\nimport { charDisplayWidth, padDisplay, padStartDisplay, renderAlignedRows, stringWidth, wrapDisplay, type ColumnAlign, } from \"../model/text-layout.ts\";\nimport { DATA_BOX_FRAME_OVERHEAD, dataBoxBorder, dataBoxMode, dataBoxRow } from \"../model/panel.ts\";\nimport { panelSectionDepth } from \"./primitives/text-panel-state.ts\";\n/** text 排版器入参:faces.ts 与旧 Table 形态共用的预格式化表。 */\nexport interface TextTableProps {\n    columns: readonly TableColumn[];\n    rows: readonly TableRow[];\n    locale?: import(\"../model/locale.ts\").ReportLocale;\n}\nconst MISSING_MARK = \"—\";\n/** 列间距,与 renderAlignedRows 的 join(\"   \") 一致。 */\nconst COLUMN_GAP = 3;\n/** 左对齐列的压缩下限:再窄就读不成句,宁可丢列。 */\nconst MIN_TEXT_COLUMN = 8;\n/** 身份列(首列)的压缩下限:读不出身份的行等于没有,所以它比其余文本列早停在这个宽度\n *  ——列自然宽本来就短于它时以自然宽为准,不给短列补空。压到这一步还放不下就丢列。 */\nconst MIN_IDENTITY_COLUMN = 24;\n/** 格子的文本形态:缺这个键、或值是 null,都渲染 —(与 web 面同源)。 */\nfunction cellText(row: TableRow, key: string): string {\n    const value = row.cells[key];\n    return value === null || value === undefined ? MISSING_MARK : value;\n}\nfunction totalWidth(widths: readonly number[]): number {\n    return widths.reduce((sum, w) => sum + w, 0) + COLUMN_GAP * Math.max(0, widths.length - 1);\n}\n/**\n * 自然列宽 → 放得进 available 的列宽。两步,顺序即优先级:\n * 1. 按自然宽的比例压所有左对齐列(文本列)到下限 —— 右对齐列是数字,折行读不了,不压;\n *    按比例分摊而不是逐个压最宽的那列:两个都很长的文本列各让一半,比把其中一个压到\n *    下限(读出来是「Experime / nt」)可读得多;\n * 2. 全部压到下限仍放不下,才从右侧丢列(至少留一列),丢了几列如实返回。\n */\nfunction fitWidths(natural: readonly number[], align: readonly ColumnAlign[], available: number): {\n    widths: number[];\n    hidden: number;\n} {\n    const widths = [...natural];\n    const floorOf = (c: number): number => c === 0 ? Math.min(natural[0] ?? MIN_IDENTITY_COLUMN, MIN_IDENTITY_COLUMN) : MIN_TEXT_COLUMN;\n    for (;;) {\n        const over = totalWidth(widths) - available;\n        if (over <= 0)\n            break;\n        const flexible = widths\n            .map((w, c) => ({ c, w, floor: floorOf(c) }))\n            .filter(({ c, w, floor }) => align[c] !== \"right\" && w > floor);\n        if (flexible.length === 0)\n            break;\n        // 可压缩总量按各列自己的余量加权分摊;取整后的余数留给下一轮,循环终止于「无列可压」。\n        const slack = flexible.reduce((sum, { w, floor }) => sum + (w - floor), 0);\n        let remaining = Math.min(over, slack);\n        for (const { c, w, floor } of flexible) {\n            if (remaining <= 0)\n                break;\n            const share = Math.min(w - floor, Math.max(1, Math.round((over * (w - floor)) / slack)), remaining);\n            widths[c] = w - share;\n            remaining -= share;\n        }\n    }\n    let hidden = 0;\n    while (widths.length > 1 && totalWidth(widths) > available) {\n        widths.pop();\n        hidden += 1;\n    }\n    return { widths, hidden };\n}\n/** 按显示宽度截到 width(不够放 `…` 时原样返回)。 */\nfunction truncateDisplay(text: string, width: number): string {\n    if (stringWidth(text) <= width)\n        return text;\n    let out = \"\";\n    let used = 0;\n    for (const ch of text) {\n        const w = charDisplayWidth(ch.codePointAt(0)!);\n        if (used + w > width)\n            break;\n        out += ch;\n        used += w;\n    }\n    return out;\n}\n/** 列的 maxLines 收口:超出的行丢弃,最后一行以 `…` 如实标注被收口。 */\nfunction clampCellLines(lines: string[], maxLines: number | undefined, width: number): string[] {\n    if (maxLines === undefined || lines.length <= maxLines)\n        return lines;\n    const kept = lines.slice(0, Math.max(1, maxLines));\n    const last = kept[kept.length - 1]!;\n    kept[kept.length - 1] = `${truncateDisplay(last, Math.max(1, width - 1))}…`;\n    return kept;\n}\n/**\n * 折行时保住格子开头的缩进:层级就长在首列的缩进上(docs 的「层级与横线」),而 wrapDisplay\n * 会把行首空格吃掉——身份被压窄正是最需要看清层级的时候,不能一折行就把层级折没了。\n * 续行跟着对齐到同一个缩进。\n */\nfunction wrapIndented(cell: string, width: number): string[] {\n    const indent = cell.length - cell.trimStart().length;\n    if (indent === 0)\n        return wrapDisplay(cell, width);\n    const pad = \" \".repeat(indent);\n    const body = wrapDisplay(cell.slice(indent), Math.max(1, width - indent));\n    return body.map((line) => `${pad}${line}`);\n}\n/** 逻辑行 → 物理行:每格折到自己的列宽,列带 maxLines 就收口,行高取最高的那格,矮格补空串。 */\nfunction toPhysicalRows(cells: readonly string[], widths: readonly number[], maxLines: readonly (number | undefined)[]): string[][] {\n    const wrapped = cells.map((cell, c) => \n    // 放得下就原样保留:wrapDisplay 会把连续空格折成一个,而 DeltaTable 的\n    // \"50% → 62%   +12pp\" 这类格子内含固定间距 —— 不折行时一个字节都不能动。\n    clampCellLines(!cell.includes(\"\\n\") && stringWidth(cell) <= widths[c] ? [cell] : wrapIndented(cell, widths[c]!), maxLines[c], widths[c]!));\n    const height = Math.max(...wrapped.map((lines) => lines.length), 1);\n    const out: string[][] = [];\n    for (let i = 0; i < height; i++)\n        out.push(wrapped.map((lines) => lines[i] ?? \"\"));\n    return out;\n}\n/**\n * <Table> 的 text 面:columns × rows → 对齐的字符表。\n * 有任一行带 locator 时追加一列 attempt(locator 本身就是 `niceeval show <locator>`\n * 的位置参数;逐行重复整条命令会把表撑宽,与三个实体列表 text 面的既有取舍一致)。\n */\nexport function renderTableText(props: TextTableProps, ctx: TextContext): string {\n    const locale = props.locale ?? ctx.locale;\n    const hasLocator = props.rows.some((row) => row.locator !== undefined);\n    if (props.columns.length === 0 && !hasLocator)\n        return \"\";\n    const header = props.columns.map((column) => resolveLocalizedText(column.header, locale));\n    const align: ColumnAlign[] = props.columns.map((column) => column.align ?? \"left\");\n    const body = props.rows.map((row) => props.columns.map((column) => cellText(row, column.key)));\n    if (hasLocator) {\n        header.push(localeText(locale, \"table.attempt\"));\n        align.push(\"left\");\n        props.rows.forEach((row, i) => body[i].push(row.locator ?? MISSING_MARK));\n    }\n    const matrix = [header, ...body];\n    const natural = header.map((_, c) => Math.max(...matrix.map((row) => stringWidth(row[c] ?? \"\"))));\n    // 画线时列间距与不画线时相同(` │ ` 与 `   ` 都是 3 列),所以只有外框那 4 列要先让出来。\n    const lines = dataBoxMode(ctx.panelMode, ctx.width) === \"boxed\";\n    // 嵌在画框的 Section 里:边界已由面板的框给出,自己只留列边界与表头横线,不套二层框。\n    const outerFrame = lines && panelSectionDepth() === 0;\n    const available = outerFrame ? ctx.width - DATA_BOX_FRAME_OVERHEAD : ctx.width;\n    const { widths, hidden } = fitWidths(natural, align, available);\n    const maxLines: (number | undefined)[] = props.columns.map((column) => column.maxLines);\n    if (hasLocator)\n        maxLines.push(undefined);\n    // 表头不参与 maxLines 收口:表头是自己写的短词,收口只服务数据格。\n    const headerPhysical = toPhysicalRows(header.slice(0, widths.length), widths, widths.map(() => undefined));\n    const bodyBlocks = body.map((row, i) => ({\n        depth: props.rows[i]?.depth ?? 0,\n        physical: toPhysicalRows(row.slice(0, widths.length), widths, maxLines),\n    }));\n    const bodyPhysical = bodyBlocks.flatMap((block) => block.physical);\n    const table = lines\n        ? renderFramedTable(headerPhysical, bodyBlocks, widths, align, outerFrame)\n        : renderAlignedRows([...headerPhysical, ...bodyPhysical], align);\n    return hidden > 0 ? `${table}\\n${countText(locale, \"table.columnsHidden\", hidden)}` : table;\n}\n/**\n * 数据格框形态:列边界贯穿全表,横线画在行树自己的边界上——表头与正文之间一条,行树有\n * 嵌套时每个顶层行之前再一条(一组一格,组内不切)。平表只有表头那一条:逐行切割读起来\n * 是一堆独立小框,层级与分组反而看不出来。分隔只按 depth 判,`Table` 不认识具体实体。\n *\n * 框宽跟随表自己的内容宽度(`fitWidths` 已经把它压进可用列数),不硬拉满终端——\n * 窄表拉满只会让同一行的读数彼此远离。\n */\nfunction renderFramedTable(header: readonly string[][], body: readonly {\n    depth: number;\n    physical: string[][];\n}[], widths: readonly number[], align: readonly ColumnAlign[], outerFrame: boolean): string {\n    // 实际列宽取该列所有物理行的最宽者:压缩与折行之后不少列比预算更窄,框跟着收。\n    const physical = [...header, ...body.flatMap((block) => block.physical)];\n    const actual = widths.map((w, c) => {\n        const widest = Math.max(...physical.map((row) => stringWidth(row[c] ?? \"\")), 1);\n        return Math.min(w, widest);\n    });\n    const line = (row: readonly string[]): string => dataBoxRow(actual.map((w, c) => (align[c] === \"right\" ? padStartDisplay(row[c] ?? \"\", w) : padDisplay(row[c] ?? \"\", w))), outerFrame);\n    const nested = body.some((block) => block.depth > 0);\n    const out: string[] = [];\n    if (outerFrame)\n        out.push(dataBoxBorder(\"top\", actual, true));\n    for (const row of header)\n        out.push(line(row));\n    out.push(dataBoxBorder(\"rule\", actual, outerFrame));\n    body.forEach((block, i) => {\n        if (nested && i > 0 && block.depth === 0)\n            out.push(dataBoxBorder(\"rule\", actual, outerFrame));\n        for (const row of block.physical)\n            out.push(line(row));\n    });\n    if (outerFrame)\n        out.push(dataBoxBorder(\"bottom\", actual, true));\n    return out.join(\"\\n\");\n}\n"]}

package/dist/report/definition/table-text.d.cts

@@ -0,0 +1,14 @@
+import type { TableColumn, TableRow } from "./primitives.cjs";
+import type { TextContext } from "./tree.cjs";
+/** text 排版器入参:faces.ts 与旧 Table 形态共用的预格式化表。 */
+export interface TextTableProps {
+    columns: readonly TableColumn[];
+    rows: readonly TableRow[];
+    locale?: import("../model/locale.cjs").ReportLocale;
+}
+/**
+ * <Table> 的 text 面:columns × rows → 对齐的字符表。
+ * 有任一行带 locator 时追加一列 attempt(locator 本身就是 `niceeval show <locator>`
+ * 的位置参数;逐行重复整条命令会把表撑宽,与三个实体列表 text 面的既有取舍一致)。
+ */
+export declare function renderTableText(props: TextTableProps, ctx: TextContext): string;

package/dist/report/definition/table-text.d.mts

@@ -0,0 +1,14 @@
+import type { TableColumn, TableRow } from "./primitives.mjs";
+import type { TextContext } from "./tree.mjs";
+/** text 排版器入参:faces.ts 与旧 Table 形态共用的预格式化表。 */
+export interface TextTableProps {
+    columns: readonly TableColumn[];
+    rows: readonly TableRow[];
+    locale?: import("../model/locale.mjs").ReportLocale;
+}
+/**
+ * <Table> 的 text 面:columns × rows → 对齐的字符表。
+ * 有任一行带 locator 时追加一列 attempt(locator 本身就是 `niceeval show <locator>`
+ * 的位置参数;逐行重复整条命令会把表撑宽,与三个实体列表 text 面的既有取舍一致)。
+ */
+export declare function renderTableText(props: TextTableProps, ctx: TextContext): string;

package/dist/report/definition/table-text.d.ts

@@ -0,0 +1,14 @@
+import type { TableColumn, TableRow } from "./primitives.js";
+import type { TextContext } from "./tree.js";
+/** text 排版器入参:faces.ts 与旧 Table 形态共用的预格式化表。 */
+export interface TextTableProps {
+    columns: readonly TableColumn[];
+    rows: readonly TableRow[];
+    locale?: import("../model/locale.js").ReportLocale;
+}
+/**
+ * <Table> 的 text 面:columns × rows → 对齐的字符表。
+ * 有任一行带 locator 时追加一列 attempt(locator 本身就是 `niceeval show <locator>`
+ * 的位置参数;逐行重复整条命令会把表撑宽,与三个实体列表 text 面的既有取舍一致)。
+ */
+export declare function renderTableText(props: TextTableProps, ctx: TextContext): string;

package/dist/report/definition/table-text.js

@@ -0,0 +1,6 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./table-text.cjs");
+const __niceevalExport0 = __niceevalCanonical["renderTableText"];
+export { __niceevalExport0 as renderTableText };
+//# sourceMappingURL=table-text.js.map

package/dist/report/definition/table-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-text.js","sources":[],"names":[],"mappings":""}