niceeval 0.12.1 → 0.12.2-canary.31

package/dist/report/definition/primitives.js

@@ -1,691 +0,0 @@
-import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { COMPONENT_RAW_CHILDREN, COMPONENT_ROLE, defineComponent, } from "./tree.js";
-import { hrefForLocator } from "../components/shared.js";
-import { localeText, resolveLocalizedText } from "../model/locale.js";
-import { joinColumns, padDisplay, stringWidth, wrapDisplay } from "../model/text-layout.js";
-import { DATA_BOX_FRAME_OVERHEAD, dataBoxBorder, dataBoxMode, dataBoxRow, panelContentWidth, renderPanel, renderRule, } from "../model/panel.js";
-import { renderTableText } from "./table-text.js";
-import { gridContainerRules, normalizeGrid, planTextGrid, TEXT_GRID_SEPARATOR } from "./grid-layout.js";
-import { datasetToTableContent, isDataset } from "../model/dataset.js";
-import { isMetricValue } from "../model/calculation.js";
-import { flattenTableContentForText, formatCellText, } from "./cell.js";
-import { MetricCellView } from "../components/cell.js";
-import { formatTimeDistance, missingText, verdictMark } from "../model/format.js";
-function childArray(children) {
-    if (children === null || children === undefined || typeof children === "boolean")
-        return [];
-    return Array.isArray(children) ? [...children] : [children];
-}
-function cx(...parts) {
-    return parts.filter(Boolean).join(" ");
-}
-/** `null`/缺数据的统一显示符:Table 与 Stat 共用,不补成 0。 */
-const MISSING_MARK = "—";
-/** 纵向依次排列:网页是块级堆叠,终端是逐块输出(块间空一行)。两面都按声明序。 */
-export const Col = defineComponent({
-    dimensions: () => ({}),
-    web({ children, className }) {
-        return _jsx("div", { className: cx("niceeval-report", "niceeval-col", className), children: children });
-    },
-    text({ children }, ctx) {
-        return childArray(children)
-            .map((child) => ctx.render(child))
-            .filter((block) => block.length > 0)
-            .join("\n\n");
-    },
-});
-Col.displayName = "Col";
-const COLUMN_SEPARATOR = " │ ";
-/** 一段已渲染文本的自然显示宽度(最长一行)。 */
-function blockWidth(block) {
-    return Math.max(...block.split("\n").map((line) => stringWidth(line)), 0);
-}
-/**
- * 并排:web 面横排;text 面在可用宽度装得下全部子块时按显示宽度并排(与 `columns` 工具
- * 同一把尺),装不下时整块退化为纵向堆叠——不截断、不隐藏任何子块。
- */
-export const Row = defineComponent({
-    dimensions: () => ({}),
-    web({ children, className }) {
-        return _jsx("div", { className: cx("niceeval-report", "niceeval-row", className), children: children });
-    },
-    text({ children }, ctx) {
-        const blocks = childArray(children).filter((child) => child !== null && child !== undefined && typeof child !== "boolean");
-        if (blocks.length === 0)
-            return "";
-        if (blocks.length === 1)
-            return ctx.render(blocks[0]);
-        const rendered = blocks.map((child) => ctx.render(child)).filter((block) => block.length > 0);
-        if (rendered.length === 0)
-            return "";
-        const widths = rendered.map(blockWidth);
-        const total = widths.reduce((sum, w) => sum + w, 0) + COLUMN_SEPARATOR.length * (rendered.length - 1);
-        if (total > ctx.width) {
-            // 装不下:整块退化为纵向堆叠,与 Col 同一形态
-            return rendered.join("\n\n");
-        }
-        return joinColumns(rendered, widths, COLUMN_SEPARATOR);
-    },
-});
-Row.displayName = "Row";
-/**
- * 一行格子的物理行:每格按自己的列宽补白(不 trim 行尾——右边框要对齐成一条直线),
- * 行高取该行最高的那一格,矮格补空白格。
- */
-function framedGridRows(blocks, widths, outerFrame) {
-    const columns = blocks.map((block) => block.split("\n"));
-    const height = Math.max(...columns.map((lines) => lines.length), 1);
-    const out = [];
-    for (let i = 0; i < height; i++) {
-        out.push(dataBoxRow(columns.map((lines, c) => padDisplay(lines[i] ?? "", widths[c])), outerFrame));
-    }
-    return out;
-}
-/**
- * 自由摘要面板的格子容器:只负责呈现,不读取 Sample、不聚合 Metric。每个直接子节点
- * (数组 / Fragment 先按 ReportNode 规则展平,空分支不占格)是一格;`Col` 把多个区块
- * 归成一格。列数、边框与体量全由格数 × 可用宽度算出(./grid-layout.ts),Grid 不收这些
- * 参数,本文件只做两面结构适配。
- */
-export const Grid = defineComponent({
-    dimensions: () => ({}),
-    web({ children, className }) {
-        const normalized = normalizeGrid({ children });
-        const cellCount = normalized.cells.length;
-        const rules = gridContainerRules(cellCount);
-        return (_jsxs("div", { className: "niceeval-report niceeval-grid-fit", children: [rules ? _jsx("style", { children: rules }) : null, _jsx("div", { className: cx("niceeval-report", "niceeval-grid", className), "data-cells": cellCount, children: normalized.cells.map((cell) => (_jsx("div", { className: "niceeval-grid-cell", children: cell.node }, cell.key))) })] }));
-    },
-    text({ children }, ctx) {
-        const normalized = normalizeGrid({ children });
-        if (normalized.cells.length === 0)
-            return "";
-        const lines = dataBoxMode(ctx.panelMode, ctx.width) === "boxed";
-        // 嵌在画框的 Section 里只留列边界与行间线:边界已由面板的框给出,不套二层框。
-        const outerFrame = lines && ctx.sectionBoxedDepth === 0;
-        const plan = planTextGrid({
-            availableWidth: outerFrame ? ctx.width - DATA_BOX_FRAME_OVERHEAD : ctx.width,
-            cellCount: normalized.cells.length,
-        });
-        // 确定计划后才对每个 cell 调用一次 ctx.render——不为试探列数重复渲染。
-        // 末行不足一整行时,最后一格吃掉剩余宽度(只剩一格就是铺满整行)——右边框因此始终
-        // 对齐成一条直线,短末行不把框拉成锯齿。
-        const cellWidths = normalized.cells.map((_, i) => {
-            const col = i % plan.columns;
-            const lastRowStart = Math.floor((normalized.cells.length - 1) / plan.columns) * plan.columns;
-            const isLastCell = i === normalized.cells.length - 1;
-            const lastRowCells = normalized.cells.length - lastRowStart;
-            if (!isLastCell || lastRowCells === plan.columns)
-                return plan.contentWidths[col];
-            if (lastRowCells === 1)
-                return plan.fullRowContentWidth;
-            // 吃掉右侧空出来的列宽与它们的格线。
-            const rest = plan.contentWidths.slice(col);
-            return rest.reduce((sum, w) => sum + w, 0) + TEXT_GRID_SEPARATOR.length * (rest.length - 1);
-        });
-        const blocks = normalized.cells.map((cell, i) => ctx.render(cell.node, cellWidths[i]));
-        // 格宽贴合内容:计划宽度是排版上限(子节点按它折行),画框时收到这一列真正用掉的宽度
-        // ——摘要格里是 `80%`、`$0.92` 这种短读数,格子不为占满终端而撑开。
-        const columnWidths = plan.contentWidths.map((planned, col) => {
-            const widest = blocks.reduce((max, block, i) => {
-                if (i % plan.columns !== col || cellWidths[i] !== planned)
-                    return max;
-                return Math.max(max, blockWidth(block));
-            }, 1);
-            return Math.min(planned, widest);
-        });
-        // 末行吃掉剩余宽度的那一格跟着收:它补的是右侧空出来的列宽与格线,按收窄后的列重算。
-        const fittedWidths = cellWidths.map((width, i) => {
-            const col = i % plan.columns;
-            if (width === plan.contentWidths[col])
-                return columnWidths[col];
-            const rest = columnWidths.slice(col);
-            return rest.reduce((sum, w) => sum + w, 0) + TEXT_GRID_SEPARATOR.length * (rest.length - 1);
-        });
-        // 行与行之间是一条行间线,不是空行——格线要连起来才读成一片格子。
-        const out = [];
-        let previousRow = 0;
-        let lastRowWidths = plan.contentWidths;
-        for (let start = 0; start < blocks.length; start += plan.columns) {
-            const rowBlocks = blocks.slice(start, start + plan.columns);
-            const rowWidths = fittedWidths.slice(start, start + rowBlocks.length);
-            if (!lines) {
-                // 朴素形态:格线整体消失,只按列对齐;行与行之间空一行代替行间线。
-                if (start > 0)
-                    out.push("");
-                out.push(joinColumns(rowBlocks, rowWidths, "   "));
-                continue;
-            }
-            if (start === 0 && outerFrame)
-                out.push(dataBoxBorder("top", columnWidths, true));
-            if (start > 0) {
-                out.push(dataBoxBorder("rule", columnWidths.slice(0, previousRow), outerFrame, rowBlocks.length));
-            }
-            out.push(...framedGridRows(rowBlocks, rowWidths, outerFrame));
-            previousRow = rowBlocks.length;
-            // 下边框跟随末行的实际列宽——末行最后一格吃掉的那段宽度也要被下边框盖住。
-            lastRowWidths = rowWidths;
-        }
-        if (lines && outerFrame)
-            out.push(dataBoxBorder("bottom", lastRowWidths, true));
-        return out.join("\n");
-    },
-});
-Grid.displayName = "Grid";
-/**
- * Grid / Stat 共享的显示值规范化:Cell 走 formatCellText / MetricCellView;
- * LocalizedText 走 resolveLocalizedText,number 走当前 locale 的 Intl.NumberFormat,null 变 —。
- */
-function statDisplayOf(value, locale) {
-    if (value === null)
-        return MISSING_MARK;
-    if (typeof value === "number")
-        return new Intl.NumberFormat(locale).format(value);
-    if (typeof value === "object" && value !== null && "kind" in value) {
-        return formatCellText(value, locale);
-    }
-    return resolveLocalizedText(value, locale);
-}
-function isCellValue(value) {
-    return typeof value === "object" && value !== null && "kind" in value;
-}
-/** label / 主值 / 辅助信息的最小内容单元;可以脱离 Grid 单独使用。 */
-export const Stat = defineComponent({
-    dimensions: () => ({}),
-    web({ label, value, detail, tone = "neutral", className }, ctx) {
-        return (_jsxs("div", { className: cx("niceeval-report", "niceeval-stat", `niceeval-stat--${tone}`, className), children: [_jsx("div", { className: "niceeval-stat-label", children: resolveLocalizedText(label, ctx.locale) }), _jsx("div", { className: "niceeval-stat-value", children: isCellValue(value)
-                        ? renderCellWeb(value, { href: (locator) => hrefForLocator(ctx, locator), locale: ctx.locale, showMeasureRefs: false })
-                        : statDisplayOf(value, ctx.locale) }), detail !== undefined ? _jsx("div", { className: "niceeval-stat-detail", children: resolveLocalizedText(detail, ctx.locale) }) : null] }));
-    },
-    text({ label, value, detail }, ctx) {
-        const lines = [resolveLocalizedText(label, ctx.locale), statDisplayOf(value, ctx.locale)];
-        if (detail !== undefined)
-            lines.push(resolveLocalizedText(detail, ctx.locale));
-        return lines.flatMap((line) => wrapDisplay(line, ctx.width)).join("\n");
-    },
-});
-Stat.displayName = "Stat";
-/** 带标题的块:网页是标题层级(可选 meta 同行右对齐);终端面框线体裁全部委托给 panel.ts,
- *  这里只负责按 ctx.panelMode 组装 title/meta/rows 喂给它,不自己拼框字符。 */
-export const Section = defineComponent({
-    dimensions: () => ({}),
-    web({ title, meta, children, className }, ctx) {
-        const titleText = resolveLocalizedText(title, ctx.locale);
-        const metaText = meta !== undefined ? resolveLocalizedText(meta, ctx.locale) : undefined;
-        return (_jsxs("section", { className: cx("niceeval-report", "niceeval-section", className), children: [metaText !== undefined ? (_jsxs("header", { className: "niceeval-section-header", children: [_jsx("h2", { className: "niceeval-section-title", children: titleText }), _jsx("p", { className: "niceeval-section-meta", children: metaText })] })) : (_jsx("h2", { className: "niceeval-section-title", children: titleText })), children] }));
-    },
-    text({ title, meta, children }, ctx) {
-        const heading = resolveLocalizedText(title, ctx.locale);
-        const metaText = meta !== undefined ? resolveLocalizedText(meta, ctx.locale) : undefined;
-        if (ctx.panelMode !== "boxed") {
-            // plain:递归天然处理嵌套(每层 Section 各自渲染标题行 + 两格缩进的正文),不需要
-            // 横隔展开——降级后所有 Section 都按同一条规则显示,不区分是否嵌套。
-            const body = childArray(children)
-                .map((child) => ctx.render(child, ctx.width - 2))
-                .filter((block) => block.length > 0)
-                .join("\n\n");
-            return renderPanel({
-                title: heading,
-                meta: metaText,
-                rows: body.length > 0 ? [{ kind: "line", text: body }] : [],
-                width: ctx.width,
-                mode: "plain",
-            }).join("\n");
-        }
-        const nested = ctx.sectionBoxedDepth > 0;
-        if (nested) {
-            // 横隔走结构化渲染期通道；不把哨兵塞进 text(): string，避免被 Row/Grid 改写或泄漏。
-            ctx.collectPanelRow?.({ kind: "divider", title: heading, ...(metaText !== undefined ? { meta: metaText } : {}) });
-        }
-        // 外层 Section 已经把子树放进内容区；嵌套 Section 只登记横隔，不能再扣一次框宽。
-        const contentWidth = nested ? ctx.width : panelContentWidth(ctx.width, "boxed");
-        ctx.sectionBoxedDepth++;
-        try {
-            const rows = [];
-            const priorCollector = ctx.collectPanelRow;
-            ctx.collectPanelRow = (row) => rows.push(row);
-            let body;
-            try {
-                body = childArray(children)
-                    .map((child) => ctx.render(child, contentWidth))
-                    .filter((block) => block.length > 0)
-                    .join("\n\n");
-            }
-            finally {
-                ctx.collectPanelRow = priorCollector;
-            }
-            if (nested) {
-                // 更深一层的横隔由本层收集后，继续上交给真正画框的祖先。
-                for (const row of rows)
-                    priorCollector?.(row);
-                return body;
-            }
-            return renderPanel({
-                title: heading,
-                meta: metaText,
-                rows: [...rows, ...(body.length > 0 ? [{ kind: "line", text: body }] : [])],
-                width: ctx.width,
-                mode: "boxed",
-            }).join("\n");
-        }
-        finally {
-            ctx.sectionBoxedDepth--;
-        }
-    },
-});
-Section.displayName = "Section";
-/** 自由文本的显式载体:web 面负责转义,text 面按显示宽度折行。 */
-export const Text = defineComponent({
-    dimensions: () => ({}),
-    web({ children, className }) {
-        return _jsx("p", { className: cx("niceeval-report", "niceeval-text", className), children: children });
-    },
-    text({ children }, ctx) {
-        return wrapDisplay(String(children), ctx.width).join("\n");
-    },
-});
-Text.displayName = "Text";
-Text[COMPONENT_RAW_CHILDREN] = true;
-/**
- * 注入页级全局 CSS:树位置只决定声明顺序,不限定作用域;text 面零输出。
- * 组件级样式优先走 defineRenderer assets;页内 <Style> 用于页级声明。
- */
-export const Style = defineComponent({
-    dimensions: () => ({}),
-    web({ children }) {
-        return _jsx("style", { children: children });
-    },
-    text() {
-        return "";
-    },
-});
-Style.displayName = "Style";
-Style[COMPONENT_RAW_CHILDREN] = true;
-/** Tabs 的直接 Tab 子项(数组 / Fragment 已展平;结构合法性由树校验保证)。 */
-function tabEntries(children) {
-    const out = [];
-    const visit = (node) => {
-        if (node === null || node === undefined || typeof node === "boolean")
-            return;
-        if (Array.isArray(node)) {
-            for (const child of node)
-                visit(child);
-            return;
-        }
-        if (typeof node === "object" && node !== null && "props" in node) {
-            const element = node;
-            if (element.type === Symbol.for("react.fragment")) {
-                visit(element.props.children);
-                return;
-            }
-            out.push({
-                title: element.props.title ?? "",
-                children: element.props.children,
-                className: element.props.className,
-            });
-        }
-    };
-    visit(children);
-    return out;
-}
-/**
- * 页内并列视图的可切换块。tab 是页内浏览状态,不是数据边界,也不是宿主寻址单位——
- * 两个渲染面都输出全部 tab 的完整内容:web 静态 HTML 每 tab 一个 <details>(首个默认展开,
- * 渐进增强升级成单选 tab 条,切换不改变数据);text 面按声明序输出带标题分节,不折成索引
- * 也不省略(tab 没有选择器,索引只能是死路)。
- */
-export const Tabs = defineComponent({
-    dimensions: () => ({}),
-    web({ children, className }, ctx) {
-        const tabs = tabEntries(children);
-        return (_jsx("div", { className: cx("niceeval-report", "niceeval-tabs", className), "data-niceeval-tabs": true, children: tabs.map((tab, i) => (_jsxs("details", { className: cx("niceeval-tab", tab.className), open: i === 0, children: [_jsx("summary", { className: "niceeval-tab-title", children: resolveLocalizedText(tab.title, ctx.locale) }), _jsx("div", { className: "niceeval-tab-body", children: tab.children })] }, i))) }));
-    },
-    text({ children }, ctx) {
-        const tabs = tabEntries(children);
-        return tabs
-            .map((tab, i) => {
-            // 隔条只标注归属,不声明边界:tab 正文按整个可用宽度排版、不缩进,宽表与图表在 tab 里
-            // 和直接铺在页上占同样的列宽(体裁与理由见 layout.md「区域框」的画框资格段)。
-            const heading = resolveLocalizedText(tab.title, ctx.locale);
-            const rule = renderRule({
-                title: `${heading} ${i + 1}/${tabs.length}`,
-                width: ctx.width,
-                mode: ctx.panelMode,
-            });
-            const body = childArray(tab.children)
-                .map((child) => ctx.render(child, ctx.width))
-                .filter((block) => block.length > 0)
-                .join("\n\n");
-            return body.length > 0 ? `${rule}\n\n${body}` : rule;
-        })
-            .join("\n\n");
-    },
-});
-Tabs.displayName = "Tabs";
-Tabs[COMPONENT_ROLE] = "tabs";
-/** 只能直接放在 <Tabs> 下;除通用 children / className 外只有 title。不参与路由,没有 id。 */
-export const Tab = defineComponent({
-    dimensions: () => ({}),
-    web({ children, className }) {
-        return _jsx("div", { className: cx("niceeval-report", "niceeval-tab-body", className), children: children });
-    },
-    text({ children }, ctx) {
-        return childArray(children)
-            .map((child) => ctx.render(child))
-            .filter((block) => block.length > 0)
-            .join("\n\n");
-    },
-});
-Tab.displayName = "Tab";
-Tab[COMPONENT_ROLE] = "tab";
-function isPlainRowsTableProps(props) {
-    return "rows" in props;
-}
-function isLocalizedTextValue(value) {
-    if (typeof value === "string")
-        return true;
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return false;
-    return Object.values(value).every((v) => typeof v === "string");
-}
-function isPlainCellValue(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value) && "kind" in value;
-}
-function plainValueToCell(value, path, locale) {
-    if (value === undefined) {
-        throw new Error(`Table ${path} is missing — every declared column must exist on the row object.`);
-    }
-    if (isMetricValue(value)) {
-        return { kind: "metric", metric: value };
-    }
-    if (isPlainCellValue(value))
-        return value;
-    if (value === null)
-        return { kind: "text", text: "—" };
-    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
-        return { kind: "text", text: String(value) };
-    }
-    if (isLocalizedTextValue(value)) {
-        return { kind: "text", text: resolveLocalizedText(value, locale) };
-    }
-    if (Array.isArray(value)) {
-        throw new Error(`Table ${path} is an array — Table rows only accept scalars, LocalizedText, MetricValue, or Cell. Flatten or pick a display field before render.`);
-    }
-    throw new Error(`Table ${path} has unsupported object type — Table rows only accept scalars, LocalizedText, MetricValue, or Cell.`);
-}
-function resolvePlainColumnSpecs(rows, columns) {
-    if (columns && columns.length > 0) {
-        const out = [];
-        for (const col of columns) {
-            if (typeof col === "string") {
-                out.push({ field: col });
-                continue;
-            }
-            if (col.hidden)
-                continue;
-            out.push({
-                field: col.field,
-                ...(col.label !== undefined ? { label: col.label } : {}),
-            });
-        }
-        return out;
-    }
-    const first = rows[0];
-    if (!first || typeof first !== "object")
-        return [];
-    return Object.keys(first)
-        .filter((key) => key !== "refs")
-        .map((field) => ({ field }));
-}
-function plainRowsToTableContent(rows, columnSpecs, locale) {
-    if (columnSpecs.length === 0) {
-        throw new Error("Table needs at least one column: pass columns, or provide a non-empty rows array with fields.");
-    }
-    const columns = columnSpecs.map((spec) => {
-        const sample = rows.map((row) => row[spec.field]).find(isMetricValue);
-        return {
-            key: spec.field,
-            ...(sample?.unit !== undefined ? { unit: sample.unit } : {}),
-            ...(sample?.better !== undefined ? { better: sample.better } : {}),
-        };
-    });
-    const contentRows = rows.map((row, index) => {
-        const refs = row.refs;
-        const key = typeof row.key === "string"
-            ? row.key
-            : Array.isArray(refs) && typeof refs[0] === "string"
-                ? refs[0]
-                : columnSpecs.map((c) => `${c.field}=${String(row[c.field])}`).join("|") || `row-${index}`;
-        const cells = {};
-        for (const spec of columnSpecs) {
-            if (!(spec.field in row)) {
-                throw new Error(`Table rows[${index}].${spec.field} is missing — row shape must match columns.`);
-            }
-            cells[spec.field] = plainValueToCell(row[spec.field], `rows[${index}].${spec.field}`, locale);
-        }
-        return { key, cells };
-    });
-    return { columns, rows: contentRows };
-}
-// props → 唯一权威形态:列 + 层级 TableContent。校验只在这里做一次,
-// text / web 两面拿到的是同一棵已校验的行树;text 面的展平是渲染期投影,
-// 不进权威形态,行 key 判重与行形状校验因此永远按层级同层进行。
-function tableContentOf(props, locale) {
-    if (isPlainRowsTableProps(props)) {
-        const specs = resolvePlainColumnSpecs(props.rows, props.columns);
-        const content = plainRowsToTableContent(props.rows, specs, locale);
-        // 公开 rows 形态:默认原样显示字段名,`label` 覆盖。
-        const columns = specs.map((spec) => ({
-            key: spec.field,
-            header: spec.label ?? spec.field,
-            align: content.columns.find((c) => c.key === spec.field)?.better ? "right" : "left",
-            better: content.columns.find((c) => c.key === spec.field)?.better,
-        }));
-        return validatedTable(columns, content);
-    }
-    const raw = props.data;
-    const content = raw === null ? null : isDataset(raw) ? datasetToTableContent(raw) : raw;
-    if (content === null)
-        return validatedTable([], { columns: [], rows: [] });
-    // 表头长在列声明上;没声明就是 key 原样(维度值列走这一支)。
-    const columns = content.columns.map((spec) => ({
-        key: spec.key,
-        header: spec.header ?? spec.key,
-        align: spec.better ? "right" : "left",
-        better: spec.better,
-    }));
-    return validatedTable(columns, content);
-}
-function validatedTable(columns, content) {
-    if (columns.length === 0) {
-        throw new Error("Table needs at least one column: pass columns, or provide rows whose first item has visible fields.");
-    }
-    const keys = new Set();
-    for (const column of columns) {
-        if (keys.has(column.key)) {
-            throw new Error(`Table column key "${column.key}" is declared twice — column keys address row.cells and must be unique. Rename one column.`);
-        }
-        keys.add(column.key);
-    }
-    validateSiblingRowKeys(content.rows);
-    validateRowShapes(content.rows, keys);
-    return { columns: columns, content };
-}
-/**
- * 行形状与列集同源:每一行(含 group / placeholder 与各层子行)的 cells key 集合
- * 等于列集。不适用的列显式填 notApplicable,不靠缺格回落成 `—`
- * (docs/feature/reports/components/primitives/table.md「Content 协议」)。
- */
-function validateRowShapes(rows, columnKeys) {
-    for (const row of rows) {
-        for (const cellKey of Object.keys(row.cells)) {
-            if (!columnKeys.has(cellKey)) {
-                throw new Error(`Table row "${row.key}" has a cell for "${cellKey}", which is not a declared column — row cells and the column set must match exactly, so this cell can never be rendered. Drop the cell, or declare a "${cellKey}" column.`);
-            }
-        }
-        for (const columnKey of columnKeys) {
-            if (!(columnKey in row.cells)) {
-                throw new Error(`Table row "${row.key}" has no cell for column "${columnKey}" — every declared column needs a cell on every row. Fill it with { kind: "notApplicable" } when the column does not apply to this row.`);
-            }
-        }
-        if (row.subRows?.length)
-            validateRowShapes(row.subRows, columnKeys);
-    }
-}
-function validateSiblingRowKeys(rows) {
-    const keys = new Set();
-    for (const row of rows) {
-        if (keys.has(row.key)) {
-            throw new Error(`Table row key "${row.key}" is declared twice at the same level — sibling row keys are the row identity and must be unique.`);
-        }
-        keys.add(row.key);
-        if (row.subRows?.length)
-            validateSiblingRowKeys(row.subRows);
-    }
-}
-function renderCellWeb(cell, ctx) {
-    if (!cell)
-        return _jsx("span", { className: "niceeval-missing", children: MISSING_MARK });
-    switch (cell.kind) {
-        case "notApplicable":
-            return _jsx("span", { className: "niceeval-missing", children: MISSING_MARK });
-        case "missing": {
-            const reference = cell.reference;
-            let body;
-            if (reference) {
-                const mark = (_jsx("span", { className: "niceeval-locator-mark", "aria-hidden": "true", children: verdictMark(reference.verdict === "skipped" ? "skipped" : reference.verdict) }));
-                const distance = _jsx("span", { className: "niceeval-stale-distance", children: formatTimeDistance(reference.staleSinceMs, ctx.locale) });
-                const title = localeText(ctx.locale, "experimentList.staleReferenceTooltip");
-                const href = ctx.href(reference.locator);
-                body = href !== undefined ? (_jsxs("a", { className: "niceeval-locator niceeval-stale", href: href, title: title, children: [mark, reference.locator, distance] })) : (_jsxs("span", { className: "niceeval-locator niceeval-stale", title: title, children: [mark, reference.locator, distance] }));
-            }
-            else {
-                body = _jsx("span", { className: "niceeval-missing-reason", children: missingText(cell.code, ctx.locale) });
-            }
-            return (_jsxs("span", { className: "niceeval-missing", children: [body, cell.detail ? _jsx("small", { className: "niceeval-cell-detail", children: cell.detail }) : null] }));
-        }
-        case "text":
-            return (_jsxs("span", { className: "niceeval-cell-text", children: [_jsx("span", { children: cell.text }), cell.detail ? _jsx("small", { className: "niceeval-cell-detail", children: cell.detail }) : null] }));
-        case "locator": {
-            // 判定长在 locator 上:判定符与语义色同场,不靠颜色单独表意
-            // (docs/feature/reports/components/summaries/experiment-table.md)。
-            const verdict = cell.verdict;
-            const stale = cell.staleSinceMs !== undefined;
-            const className = cx("niceeval-locator", verdict !== undefined ? `niceeval-verdict-${verdict}` : undefined, stale ? "niceeval-stale" : undefined);
-            const mark = verdict === undefined ? null : (_jsx("span", { className: "niceeval-locator-mark", "aria-hidden": "true", children: verdictMark(verdict === "skipped" ? "skipped" : verdict) }));
-            const distance = stale ? (_jsx("span", { className: "niceeval-stale-distance", children: formatTimeDistance(cell.staleSinceMs, ctx.locale) })) : null;
-            const title = stale ? localeText(ctx.locale, "experimentList.historicalTooltip") : undefined;
-            const href = ctx.href(cell.locator);
-            return href !== undefined ? (_jsxs("a", { className: className, href: href, title: title, children: [mark, cell.locator, distance] })) : (_jsxs("span", { className: className, title: title, children: [mark, cell.locator, distance] }));
-        }
-        case "summary":
-        case "score":
-            return formatCellText(cell, ctx.locale);
-        case "verdict": {
-            if (cell.counts) {
-                const parts = ["passed", "failed", "errored", "skipped"].filter((kind) => cell.counts[kind] > 0);
-                return (_jsxs("span", { className: "niceeval-verdict-tally", children: [parts.map((kind) => (_jsxs("span", { className: `niceeval-verdict-${kind}`, children: [cell.counts[kind], " ", localeText(ctx.locale, `verdict.${kind === "skipped" ? "skipped" : kind}`)] }, kind))), parts.length === 0 ? _jsx("span", { className: "niceeval-missing", children: MISSING_MARK }) : null] }));
-            }
-            const verdict = cell.verdict ?? "skipped";
-            const stale = cell.staleSinceMs !== undefined;
-            // 判定符走 verdictMark 单源,与 locator 格同一张表(errored 是 `!`,不并到 `✗`)。
-            return (_jsxs("span", { className: cx("niceeval-verdict", `niceeval-verdict-${verdict}`, stale ? "niceeval-stale" : undefined), title: stale ? localeText(ctx.locale, "experimentList.historicalTooltip") : undefined, children: [verdictMark(verdict === "skipped" ? "skipped" : verdict), !cell.bare ? _jsxs(_Fragment, { children: [" ", localeText(ctx.locale, `verdict.${verdict === "skipped" ? "skipped" : verdict}`)] }) : null, stale ? _jsx("span", { className: "niceeval-stale-distance", children: formatTimeDistance(cell.staleSinceMs, ctx.locale) }) : null] }));
-        }
-        case "metric":
-            return (_jsx(MetricCellView, { cell: cell.metric, href: ctx.showMeasureRefs === false ? undefined : ctx.href, locale: ctx.locale }));
-        case "composition": {
-            // web 面画成一条分段条,hover 一段给出它的名字与计数;段的业务含义住在投影里,
-            // 这里只按声明序给一条位置驱动的渐隐色阶(docs/feature/reports/components/primitives/table.md「构成格」)。
-            const total = cell.segments.reduce((sum, segment) => sum + segment.count, 0);
-            if (total === 0)
-                return _jsx("span", { className: "niceeval-missing", children: MISSING_MARK });
-            return (_jsx("span", { className: "niceeval-composition", children: cell.segments.map((segment, i) => segment.count > 0 ? (_jsx("span", { className: "niceeval-composition-segment", style: { width: `${(segment.count / total) * 100}%`, "--composition-step": i }, title: `${resolveLocalizedText(segment.label, ctx.locale)}: ${segment.count}` }, i)) : null) }));
-        }
-        default: {
-            const _e = cell;
-            return _e;
-        }
-    }
-}
-function cellSortValue(cell) {
-    if (!cell)
-        return "";
-    if (cell.kind === "metric")
-        return cell.metric.value ?? "";
-    if (cell.kind === "score")
-        return cell.earned;
-    if (cell.kind === "text")
-        return cell.text;
-    if (cell.kind === "locator")
-        return cell.locator;
-    if (cell.kind === "verdict" && cell.counts)
-        return cell.counts.passed;
-    return formatCellText(cell);
-}
-/**
- * 层级表的列轨:只声明宽度从哪来,不写每列多宽。身份列吃掉余量并留可读下限;其余列
- * `fit-content` 贴着自己那一列的内容(封顶一列可读宽度,长文本在列内折行而不是撑爆整表)。
- * 列数以外不看列身份——表格不认识"这是成本列所以窄一点"。
- */
-function hierarchyGrid(columns) {
-    if (columns.length === 1)
-        return "minmax(15rem, 1fr)";
-    return `minmax(15rem, 1fr) repeat(${columns.length - 1}, fit-content(20rem))`;
-}
-function renderHierarchyRowsWeb(rows, columns, ctx, depth = 0) {
-    return rows.map((row) => {
-        const cells = columns.map((column, index) => (_jsx("span", { className: cx("niceeval-table-hierarchy-cell", column.align === "right" ? "niceeval-align-right" : undefined), "data-sort-value": cellSortValue(row.cells[column.key]), style: index === 0 && depth > 0 ? { paddingLeft: `${depth * 1.25}rem` } : undefined, children: renderCellWeb(row.cells[column.key], ctx) }, column.key)));
-        const className = cx("niceeval-table-hierarchy-row", row.variant === "placeholder" ? "niceeval-row-placeholder" : undefined, row.variant === "group" ? "niceeval-row-group" : undefined);
-        if (!row.subRows?.length) {
-            return (_jsx("div", { className: className, "data-depth": depth || undefined, children: cells }, row.key));
-        }
-        return (_jsxs("details", { className: cx(className, "niceeval-table-hierarchy-group"), "data-depth": depth || undefined, children: [_jsx("summary", { className: "niceeval-table-hierarchy-summary", children: cells }), _jsx("div", { className: "niceeval-table-hierarchy-children", children: renderHierarchyRowsWeb(row.subRows, columns, ctx, depth + 1) })] }, row.key));
-    });
-}
-function renderFlatContentRowsWeb(rows, columns, ctx) {
-    return rows.map((row) => (_jsx("tr", { className: cx(row.variant === "placeholder" ? "niceeval-row-placeholder" : undefined, row.variant === "group" ? "niceeval-row-group" : undefined), children: columns.map((column) => (_jsx("td", { className: column.align === "right" ? "niceeval-align-right" : undefined, children: renderCellWeb(row.cells[column.key], ctx) }, column.key))) }, row.key)));
-}
-/**
- * 行 × 列原语：公开面吃普通 rows；内部组合组件经 TableContentView 复用同一双面实现。
- */
-const TableImplementation = defineComponent({
-    dimensions: () => ({}),
-    web(props, ctx) {
-        const locale = props.locale ?? ctx.locale;
-        const { columns, content } = tableContentOf(props, locale);
-        const alignClass = (align) => (align === "right" ? "niceeval-align-right" : undefined);
-        const href = (locator) => hrefForLocator(ctx, locator);
-        const hierarchical = content.rows.some((row) => (row.subRows?.length ?? 0) > 0);
-        const table = (_jsxs("table", { className: cx("niceeval-report", "niceeval-table", hierarchical ? "niceeval-table--hierarchical" : undefined, props.className), style: hierarchical ? { "--table-grid": hierarchyGrid(columns) } : undefined, children: [_jsx("thead", { children: _jsx("tr", { children: columns.map((column) => (_jsx("th", { scope: "col", className: cx(alignClass(column.align), props.sort === column.key
-                                ? column.better === "lower"
-                                    ? "niceeval-sort-asc"
-                                    : "niceeval-sort-desc"
-                                : undefined), "data-niceeval-sort": column.better ? column.key : undefined, children: resolveLocalizedText(column.header, locale) }, column.key))) }) }), hierarchical ? (_jsx("tbody", { children: _jsx("tr", { children: _jsx("td", { colSpan: columns.length, className: "niceeval-table-hierarchy-body", children: renderHierarchyRowsWeb(content.rows, columns, {
-                                href,
-                                locale,
-                                showMeasureRefs: false,
-                            }) }) }) })) : (_jsx("tbody", { children: renderFlatContentRowsWeb(content.rows, columns, { href, locale }) }))] }));
-        const searchable = props.searchable === true;
-        if (!searchable)
-            return table;
-        return (_jsxs("div", { className: "niceeval-report niceeval-table-wrap", children: [_jsx("input", { className: "niceeval-filter", "data-niceeval-filter": "", type: "search", placeholder: localeText(locale, columns[0].key === "entity" ? "experimentList.filterPlaceholder" : "table.filterPlaceholder") }), table] }));
-    },
-    text(props, ctx) {
-        const locale = props.locale ?? ctx.locale;
-        const { columns, content } = tableContentOf(props, locale);
-        const flat = flattenTableContentForText(content, locale);
-        return renderTableText({ columns, rows: flat.rows.map((row) => ({ key: row.key, cells: row.cells, depth: row.depth })), locale }, ctx);
-    },
-});
-export const Table = TableImplementation;
-export const TableContentView = TableImplementation;
-Table.displayName = "Table";
-export { Waterfall, waterfallText } from "./primitives/waterfall.js";
-export { Callouts } from "./primitives/callouts.js";
-export { CopyBlock } from "./primitives/copy-block.js";
-export { DiffView, diffViewText } from "./primitives/diff-view.js";
-export { CommandEvidence, Conversation, ConversationEntries, conversationText, sanitizeConversationPreview } from "./primitives/conversation.js";
-export { Markdown, parseMarkdown, markdownToText, markdownToWeb } from "./primitives/markdown.js";
-export { SourceView, sourceViewText } from "./primitives/source-view.js";
-export { Chart, Series } from "./primitives/chart.js";
-export { Scatter, Line, Bars, Area, applyBarsSortLimit } from "./primitives/marks.js";
-export { pointsToDataset } from "./primitives/points-dataset.js";