niceeval 0.12.1 → 0.12.2-canary.31

package/dist/report/components/summaries/stability-overview.d.ts

@@ -1,13 +0,0 @@
-import type { DimensionInput } from "../../model/types.ts";
-import type { Sample } from "../../../record/types.ts";
-import { type ReportLocale } from "../../model/locale.ts";
-export interface StabilityOverviewProps {
-    input?: Sample;
-    /** 条件维度;缺省 "experiment",与 show --stats 相同。 */
-    columns?: DimensionInput;
-    /** 聚合前收窄题集。 */
-    evals?: string | readonly string[];
-    locale?: ReportLocale;
-    className?: string;
-}
-export declare const StabilityOverview: import("../../definition/tree.ts").ReportComponent<StabilityOverviewProps>;

package/dist/report/components/summaries/stability-overview.js

@@ -1,73 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// StabilityOverview:stability 视图的主体——读数格 + 稳定性散点 + 判定构成堆叠柱 + 矩阵。
-// 全部区块来自 stabilityMatrix 一次计算与字面投影,不新增聚合口径
-// (docs/feature/reports/components/summaries/stability-overview.md)。
-import { defineComponent } from "../../definition/tree.js";
-import { Chart, Col, Grid, Series, Stat, TableContentView } from "../../definition/primitives.js";
-import { DEFAULT_REPORT_LOCALE, localeText } from "../../model/locale.js";
-import { stabilityMatrixData } from "../../slices/compute.js";
-import { stabilityMatrixContent } from "../../slices/content.js";
-export const StabilityOverview = defineComponent(async (props, ctx) => {
-    const input = props.input ?? ctx.scope;
-    const locale = props.locale ?? DEFAULT_REPORT_LOCALE;
-    const content = stabilityMatrixContent(await stabilityMatrixData(input, { by: props.columns ?? "experiment", evals: props.evals }));
-    const conditions = content.columns
-        .map((column) => column.key)
-        .filter((key) => key !== "eval" && key !== "total");
-    // 散点:一点一格(eval × 条件),x = 执行次数,y = 历史通过率;y=0 一排即零通过题,
-    // 0 与 1 之间即闪烁。闪烁判据:任一条件格 0 < passed < executions,全过与全挂都不算。
-    const points = [];
-    let flaky = 0;
-    for (const row of content.rows) {
-        let rowFlaky = false;
-        for (const condition of conditions) {
-            const cell = row.cells[condition];
-            if (cell?.kind !== "verdict" || !cell.counts)
-                continue;
-            const n = cell.counts.passed + cell.counts.failed + cell.counts.errored;
-            if (n === 0)
-                continue;
-            if (cell.counts.passed > 0 && cell.counts.passed < n)
-                rowFlaky = true;
-            const refs = [...(cell.refs ?? [])];
-            const ratio = cell.counts.passed / n;
-            points.push({
-                key: `${row.evalId} · ${condition}`,
-                values: {
-                    eval: row.evalId,
-                    condition,
-                    executions: { value: n, basis: "eval", samples: n, total: n, refs },
-                    passRatio: { value: ratio, unit: "%", better: "higher", bounds: { min: 0, max: 1 }, basis: "eval", samples: n, total: n, refs },
-                },
-            });
-        }
-        if (rowFlaky)
-            flaky += 1;
-    }
-    const scatter = {
-        fields: [
-            { name: "eval", kind: "dimension", valueType: "string" },
-            { name: "condition", kind: "dimension", valueType: "string" },
-            { name: "executions", kind: "metric", valueType: "number" },
-            { name: "passRatio", kind: "metric", valueType: "number", better: "higher", bounds: { min: 0, max: 1 } },
-        ],
-        rows: points,
-    };
-    // 堆叠柱:一条件一柱,passed / failed / errored 三段与矩阵合计行同值。
-    const bars = {
-        fields: [
-            { name: "condition", kind: "dimension", valueType: "string" },
-            { name: "passed", kind: "metric", valueType: "number" },
-            { name: "failed", kind: "metric", valueType: "number" },
-            { name: "errored", kind: "metric", valueType: "number" },
-        ],
-        rows: Object.entries(content.totals).map(([condition, totals]) => ({
-            key: condition,
-            values: { condition, passed: totals.passed, failed: totals.failed, errored: totals.errored },
-        })),
-    };
-    const executions = Object.values(content.totals).reduce((sum, totals) => sum + totals.executions, 0);
-    const neverPassed = content.rows.filter((row) => row.neverPassed).length;
-    return (_jsxs(Col, { className: props.className, children: [_jsxs(Grid, { children: [_jsx(Stat, { label: localeText(locale, "stabilityOverview.executions"), value: executions }), _jsx(Stat, { label: localeText(locale, "stabilityOverview.neverPassed"), value: neverPassed }), _jsx(Stat, { label: localeText(locale, "stabilityOverview.flaky"), value: flaky })] }), _jsx(Chart, { data: scatter, x: "executions", y: "passRatio", legend: true, tooltip: true, locale: props.locale, children: _jsx(Series, { id: "stability", mark: "scatter", points: "eval", by: "condition" }) }), _jsxs(Chart, { data: bars, x: "condition", y: "passed", legend: true, tooltip: true, locale: props.locale, children: [_jsx(Series, { id: "passed", mark: "bar", y: "passed", stack: "verdicts" }), _jsx(Series, { id: "failed", mark: "bar", y: "failed", stack: "verdicts" }), _jsx(Series, { id: "errored", mark: "bar", y: "errored", stack: "verdicts" })] }), _jsx(TableContentView, { data: content, locale: props.locale })] }));
-});
-StabilityOverview.displayName = "StabilityOverview";

package/dist/report/components/summaries/validate.d.ts

@@ -1,2 +0,0 @@
-import { type Validator } from "../shared.ts";
-export declare const validateSampleSummaryContent: Validator;

package/dist/report/components/summaries/validate.js

@@ -1,29 +0,0 @@
-import { cellProblem, isObject, tallyProblem } from "../shared.js";
-export const validateSampleSummaryContent = (data) => {
-    if (!isObject(data))
-        return "expected an object";
-    if (!isObject(data.range))
-        return 'missing "range" ({ earliestStartedAt, latestStartedAt })';
-    if (!(data.range.earliestStartedAt === null || typeof data.range.earliestStartedAt === "string")) {
-        return '"range.earliestStartedAt" must be a string or null';
-    }
-    if (!(data.range.latestStartedAt === null || typeof data.range.latestStartedAt === "string")) {
-        return '"range.latestStartedAt" must be a string or null';
-    }
-    if (typeof data.experiments !== "number")
-        return '"experiments" must be a number';
-    if (typeof data.evals !== "number")
-        return '"evals" must be a number';
-    if (typeof data.attempts !== "number")
-        return '"attempts" must be a number';
-    const evalVerdictsProblem = tallyProblem(data.evalVerdicts, "evalVerdicts");
-    if (evalVerdictsProblem !== null)
-        return evalVerdictsProblem;
-    const attemptVerdictsProblem = tallyProblem(data.attemptVerdicts, "attemptVerdicts");
-    if (attemptVerdictsProblem !== null)
-        return attemptVerdictsProblem;
-    const passRateProblem = cellProblem(data.endToEndPassRate, "endToEndPassRate");
-    if (passRateProblem !== null)
-        return passRateProblem;
-    return cellProblem(data.totalCostUSD, "totalCostUSD");
-};

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

@@ -1,118 +0,0 @@
-import type { AttemptLocator } from "../../record/locator.ts";
-import type { LocalizedText } from "../../shared/types.ts";
-import type { Verdict } from "../../shared/types.ts";
-import type { MetricValue } from "../model/calculation.ts";
-import { type ReportLocale } from "../model/locale.ts";
-/** 判定计票:passed / failed / errored / skipped。 */
-export interface VerdictCounts {
-    readonly passed: number;
-    readonly failed: number;
-    readonly errored: number;
-    readonly skipped: number;
-}
-/**
- * 官方表格一格。三条不变量:
- * - metric 格永远带证据(不得压成 text);
- * - notApplicable 与 missing 不合并;
- * - summary 的文本已在上游折好。
- */
-export type Cell = {
-    readonly kind: "metric";
-    readonly metric: MetricValue;
-} | {
-    readonly kind: "verdict";
-    readonly verdict?: Verdict | "skipped";
-    readonly counts?: VerdictCounts;
-    /** 计票覆盖的 attempt 引用(有证据可下钻的计票格才携带,如稳定性矩阵)。 */
-    readonly refs?: readonly AttemptLocator[];
-    /** 单判定形态历史执行的距今毫秒数;新执行时省略,不伪造 0(与 locator 格同一条纪律)。 */
-    readonly staleSinceMs?: number;
-    /** 单判定形态省略判定词、只留判定符(如对照矩阵逐格只放得下一个符号的场景)。 */
-    readonly bare?: boolean;
-} | {
-    readonly kind: "score";
-    readonly earned: number;
-    readonly possible?: number;
-} | {
-    readonly kind: "summary";
-    readonly text: string;
-    readonly more?: number;
-} | {
-    readonly kind: "locator";
-    readonly locator: AttemptLocator;
-    readonly staleSinceMs?: number;
-    /** 有判定的 attempt 行:判定长在 locator 上(判定符 + 语义色),没有判定就省略。 */
-    readonly verdict?: Verdict | "skipped";
-} | {
-    readonly kind: "text";
-    readonly text: string;
-    readonly detail?: string;
-} | {
-    readonly kind: "notApplicable";
-} | {
-    readonly kind: "missing";
-    readonly code: string;
-    /** 补上这一格的命令,可直接复制(如 `niceeval exp <experimentId>`)。 */
-    readonly detail?: string;
-    /**
-     * 记录里存在、但与当前基准不可比的最近一条判定;不进任何计数,两面都降饱和显示,
-     * 只提供 locator 下钻(docs/feature/reports/library/presentation.md「missing 格的完整形状」)。
-     */
-    readonly reference?: {
-        readonly locator: AttemptLocator;
-        readonly verdict: Verdict | "skipped";
-        readonly staleSinceMs: number;
-    };
-} | {
-    readonly kind: "composition";
-    /** 段名由投影按 locale 给出;Table 不认识段的业务含义,只按声明序渲染,计数为零的段不显示。 */
-    readonly segments: readonly {
-        readonly label: LocalizedText;
-        readonly count: number;
-    }[];
-};
-export interface ColumnSpec {
-    readonly key: string;
-    readonly unit?: string;
-    readonly better?: "higher" | "lower";
-    /**
-     * 列表头。text / web 两面按当前 locale 解析同一份;省略时按 key 原样显示
-     * (维度值列——条件名、实验 id 这类列名即数据的列——用这一支)。
-     * Table 原语自己不携带列名词表,表头只来自这里
-     * (docs/feature/reports/components/primitives/table.md「Content 协议」)。
-     */
-    readonly header?: LocalizedText;
-}
-/**
- * 表行 Content。与布局原语 `Row` 组件不同名。
- * placeholder 行照常渲染,但不进任何列的聚合读数。
- * group 行的读数由自己的 subRows 聚合而来,不是一条独立事实。
- */
-export interface TableContentRow {
-    readonly key: string;
-    readonly cells: Readonly<Record<string, Cell>>;
-    readonly subRows?: readonly TableContentRow[];
-    /** group 行的读数由自己的 subRows 聚合而来，不是一条独立事实。 */
-    readonly variant?: "normal" | "placeholder" | "group";
-}
-export interface TableContent {
-    readonly columns: readonly ColumnSpec[];
-    readonly rows: readonly TableContentRow[];
-}
-/** 把 Cell 折成 text 面可见字符串(缺数据 / 不适用统一不补成 0)。 */
-export declare function formatCellText(cell: Cell | null | undefined, locale?: ReportLocale): string;
-/** 把 TableContent 展平为 text 排版器用的预格式化行(含 subRows 缩进前缀)。 */
-export declare function flattenTableContentForText(content: TableContent, locale?: string): {
-    columns: Array<{
-        key: string;
-        header: string;
-        align?: "left" | "right";
-    }>;
-    /** depth 是行树里的层数(顶层 0);text 面按它画组边界横线,不认识具体实体。 */
-    rows: Array<{
-        key: string;
-        cells: Record<string, string | null>;
-        variant?: string;
-        depth: number;
-    }>;
-};

package/dist/report/definition/cell.js

@@ -1,96 +0,0 @@
-// 官方表格数据协议的单元格类型(docs/feature/reports/components/primitives/table.md「单元格类型」)。
-// Table / Grid / Stat 共用这份判别联合;自定义 Source 要交给这些原语必须适配成这个形状。
-import { formatMetricValue, formatTimeDistance, missingText, verdictMark } from "../model/format.js";
-import { DEFAULT_REPORT_LOCALE, localeText, resolveLocalizedText, } from "../model/locale.js";
-/** 把 Cell 折成 text 面可见字符串(缺数据 / 不适用统一不补成 0)。 */
-export function formatCellText(cell, locale) {
-    if (cell == null)
-        return "—";
-    switch (cell.kind) {
-        case "notApplicable":
-            return "—";
-        case "missing": {
-            const loc = locale ?? DEFAULT_REPORT_LOCALE;
-            // 带参考时用参考替代原因文案——参考本身已经说明这一格为什么空着,不把同一句话说两遍。
-            const reason = cell.reference
-                ? `${verdictMark(cell.reference.verdict === "skipped" ? "skipped" : cell.reference.verdict)} ${cell.reference.locator} ${formatTimeDistance(cell.reference.staleSinceMs, loc)}`
-                : missingText(cell.code, loc);
-            return cell.detail ? `${reason} · ${cell.detail}` : reason;
-        }
-        case "text":
-            return cell.detail ? `${cell.text}\n  ${cell.detail}` : cell.text;
-        case "locator": {
-            const stale = cell.staleSinceMs !== undefined ? ` ${formatTimeDistance(cell.staleSinceMs, locale ?? DEFAULT_REPORT_LOCALE)}` : "";
-            const mark = cell.verdict !== undefined ? `${verdictMark(cell.verdict === "skipped" ? "skipped" : cell.verdict)} ` : "";
-            return `${mark}${cell.locator}${stale}`;
-        }
-        case "summary": {
-            const more = cell.more && cell.more > 0 ? ` +${cell.more} more` : "";
-            return `${cell.text}${more}`;
-        }
-        case "score":
-            return cell.possible !== undefined ? `${cell.earned} / ${cell.possible}` : String(cell.earned);
-        case "verdict": {
-            const loc = locale ?? DEFAULT_REPORT_LOCALE;
-            if (cell.counts) {
-                const parts = ["passed", "failed", "errored", "skipped"]
-                    .filter((k) => cell.counts[k] > 0)
-                    .map((k) => `${cell.counts[k]} ${localeText(loc, `verdict.${k === "skipped" ? "skipped" : k}`)}`);
-                return parts.join(" · ") || "—";
-            }
-            if (cell.verdict !== undefined) {
-                const v = cell.verdict === "skipped" ? "skipped" : cell.verdict;
-                const stale = cell.staleSinceMs !== undefined ? ` ${formatTimeDistance(cell.staleSinceMs, loc)}` : "";
-                // 判定符与判定词同场,与 locator 格、web 面同一条纪律:单色打印下照样读得出。
-                // bare 省略判定词,只留判定符(+ 可选时距),供逐格空间紧张的场景(如对照矩阵)使用。
-                if (cell.bare)
-                    return `${verdictMark(v)}${stale}`;
-                return `${verdictMark(v)} ${localeText(loc, `verdict.${v}`)}${stale}`;
-            }
-            return "—";
-        }
-        case "metric": {
-            const m = cell.metric;
-            return formatMetricValue(m.value, m.unit, m.format, locale ?? DEFAULT_REPORT_LOCALE);
-        }
-        case "composition": {
-            const loc = locale ?? DEFAULT_REPORT_LOCALE;
-            // text 面退化成与判定计票同构的计数串,与「计数为零的段不出现」同一条规则。
-            const parts = cell.segments
-                .filter((segment) => segment.count > 0)
-                .map((segment) => `${segment.count} ${resolveLocalizedText(segment.label, loc)}`);
-            return parts.join(" · ") || "—";
-        }
-        default: {
-            const _exhaustive = cell;
-            return _exhaustive;
-        }
-    }
-}
-/** 把 TableContent 展平为 text 排版器用的预格式化行(含 subRows 缩进前缀)。 */
-export function flattenTableContentForText(content, locale) {
-    // 表头与 web 面同源:走列声明的 header,缺省才回落 key。
-    const columns = content.columns.map((c) => ({
-        key: c.key,
-        header: c.header !== undefined ? resolveLocalizedText(c.header, locale ?? DEFAULT_REPORT_LOCALE) : c.key,
-        align: (c.better ? "right" : "left"),
-    }));
-    const rows = [];
-    const walk = (row, depth) => {
-        const cells = {};
-        for (const col of content.columns) {
-            const cell = row.cells[col.key];
-            let text = formatCellText(cell, locale);
-            if (depth > 0 && col === content.columns[0] && text !== "—") {
-                text = `${"  ".repeat(depth)}${text}`;
-            }
-            cells[col.key] = text;
-        }
-        rows.push({ key: row.key, cells, variant: row.variant, depth });
-        for (const child of row.subRows ?? [])
-            walk(child, depth + 1);
-    };
-    for (const row of content.rows)
-        walk(row, 0);
-    return { columns, rows };
-}

package/dist/report/definition/grid-layout.d.ts

@@ -1,77 +0,0 @@
-import type { ReportNode } from "./tree.ts";
-export interface NormalizedGridCell {
-    readonly node: ReportNode;
-    /** React key:复用元素自带 key,缺失时按展平后的声明序生成稳定回退。 */
-    readonly key: string;
-}
-/**
- * `normalizeGrid` 的产物:有序、不可拆的 cell 列表。
- * 不是公开 data shape,也不进结果或 artifact——只是两个渲染面共享的同步排版中间值。
- */
-export interface NormalizedGrid {
-    readonly cells: readonly NormalizedGridCell[];
-}
-/** `Grid` 组件创建时的一次性规范化:展平 children 成有序 cell 列表。 */
-export declare function normalizeGrid(input: {
-    children: ReportNode;
-}): NormalizedGrid;
-/**
- * 换列规则第 2 步:给定格数与容量列数,按行数摊匀。
- * 行数 = ⌈格数/容量⌉,列数 = ⌈格数/行数⌉;结果从不超过容量列数。
- */
-export declare function balanceColumns(cellCount: number, capacityColumns: number): number;
-/**
- * web 面几何常量:最小格宽与格线宽度,@container 断点与 stylesheet 共用这一份。
- * `comfortableCellWidth` 不参与换列,只是 stylesheet 里体量插值的上端——实际格宽涨到它时
- * 格内留白与 Stat 主值字号到顶。
- */
-export declare const WEB_GRID_GEOMETRY: {
-    readonly minCellWidth: 160;
-    readonly separator: 1;
-    readonly comfortableCellWidth: 220;
-};
-export interface GridColumnStep {
-    readonly columns: number;
-    /** 该列数下每格仍不低于最小格宽时的起始容器宽度(px)。 */
-    readonly minWidth: number;
-}
-/**
- * 换列阶梯:候选列数是 ⌈格数/行数⌉ 去重,起始宽度 = 列数 × 最小格宽 + (列数-1) × 格线宽。
- * 按列数升序——web 面据此生成 @container 规则时,较大断点写在后面以覆盖较小断点。
- */
-export declare function planGridColumns(cellCount: number): readonly GridColumnStep[];
-/**
- * web 面随身 `@container` 规则文本:格数的纯函数——同格数逐字相同。基线一列写在
- * stylesheet;这里只发 ≥2 列的断点。规则只声明列数(`--grid-columns` 供体量插值取用),
- * 不出现留白或字号的具体值。末行恰一格时附带 `grid-column: 1 / -1`。
- */
-export declare function gridContainerRules(cellCount: number): string;
-/** text 面规划的输入:只有可用宽度与 cell 数。 */
-export interface TextGridPlanInput {
-    readonly availableWidth: number;
-    readonly cellCount: number;
-}
-/**
- * text 面的一次性排版计划:实际列数、每列内容显示宽度、孤格铺满用的整行内容宽。
- * 格线之外不画外框,所以每行的显示宽度恰好是 `availableWidth`。
- */
-export interface TextGridPlan {
-    readonly columns: number;
-    readonly contentWidths: readonly number[];
-    /** 末行只剩一格时该格的内容显示宽度(= availableWidth,整行都归它)。 */
-    readonly fullRowContentWidth: number;
-}
-/** 相邻两格之间那条格线连同两侧留白占的显示列(` │ `)。 */
-export declare const TEXT_GRID_SEPARATOR = " \u2502 ";
-/**
- * 从格数向一列尝试,选出满足每格最小可读内容宽度的最大列数作为容量,再按行数摊匀;
- * 一列是无条件 fallback(即使内容宽度因此小于 24)。选定列数后,余下的显示列从左向右
- * 逐列多补一列,因此任意一行的显示宽度都恰好是 `availableWidth`。
- */
-export declare function planTextGrid(input: TextGridPlanInput): TextGridPlan;
-/**
- * 两行之间那条行间线:上一行 `above` 格、下一行 `below` 格,列宽取自同一份计划。
- * 两行都有的列边界画 `┼`,只有上一行有的(末行变短)收成 `┴`——末行左对齐、不拉伸,
- * 所以它的列边界总是上一行的前缀。
- */
-export declare function textGridRowSeparator(contentWidths: readonly number[], above: number, below: number): string;

package/dist/report/definition/grid-layout.js

@@ -1,147 +0,0 @@
-// Grid 的语义层与面内布局(docs/feature/reports/architecture.md「排版原语的语义层与面内布局」、
-// docs/feature/reports/library/layout.md「换列规则」)。只放同步纯函数与中间类型:
-// normalizeGrid 把 resolved ReportNode children 展平成有序 cell 列表;balanceColumns /
-// planGridColumns / planTextGrid 是两面同源的列数算术,几何常量只在这里出现一次
-// ——Grid 不收列数、边框或体量参数,这些全从格数与可用宽度算。不 import show / view、
-// Record IO 或 stylesheet;primitives.tsx 消费本文件产出两面适配。
-import { dataBoxBorder } from "../model/panel.js";
-// react/jsx-runtime 的 Fragment 注册符号,跨 react 版本稳定(tree.ts 同一常量的独立取用,
-// Symbol.for 全局注册表保证同一符号,不产生耦合)。
-const REACT_FRAGMENT = Symbol.for("react.fragment");
-function isElementNode(node) {
-    return typeof node === "object" && node !== null && !Array.isArray(node) && "type" in node && "props" in node;
-}
-function keyOf(node, fallback) {
-    if (isElementNode(node)) {
-        const key = node.key;
-        if (typeof key === "string" || typeof key === "number")
-            return String(key);
-    }
-    return fallback;
-}
-/**
- * 递归展开数组与 Fragment、跳过空分支(null/undefined/boolean),其余节点各占一格
- * ——`Col` 归拢的多个子节点、任意自定义组件的渲染结果都是不透明的一格,不下钻其内部结构。
- */
-function flattenGridChildren(children) {
-    const cells = [];
-    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 (isElementNode(node) && node.type === REACT_FRAGMENT) {
-            visit(node.props.children);
-            return;
-        }
-        cells.push({ node, key: keyOf(node, `niceeval-grid-cell-${cells.length}`) });
-    };
-    visit(children);
-    return cells;
-}
-/** `Grid` 组件创建时的一次性规范化:展平 children 成有序 cell 列表。 */
-export function normalizeGrid(input) {
-    return { cells: flattenGridChildren(input.children) };
-}
-/**
- * 换列规则第 2 步:给定格数与容量列数,按行数摊匀。
- * 行数 = ⌈格数/容量⌉,列数 = ⌈格数/行数⌉;结果从不超过容量列数。
- */
-export function balanceColumns(cellCount, capacityColumns) {
-    const cells = Math.max(1, cellCount);
-    const capacity = Math.max(1, Math.min(capacityColumns, cells));
-    const rows = Math.ceil(cells / capacity);
-    return Math.ceil(cells / rows);
-}
-/**
- * web 面几何常量:最小格宽与格线宽度,@container 断点与 stylesheet 共用这一份。
- * `comfortableCellWidth` 不参与换列,只是 stylesheet 里体量插值的上端——实际格宽涨到它时
- * 格内留白与 Stat 主值字号到顶。
- */
-export const WEB_GRID_GEOMETRY = {
-    minCellWidth: 160,
-    separator: 1,
-    comfortableCellWidth: 220,
-};
-/**
- * 换列阶梯:候选列数是 ⌈格数/行数⌉ 去重,起始宽度 = 列数 × 最小格宽 + (列数-1) × 格线宽。
- * 按列数升序——web 面据此生成 @container 规则时,较大断点写在后面以覆盖较小断点。
- */
-export function planGridColumns(cellCount) {
-    const n = Math.max(0, cellCount);
-    if (n === 0)
-        return [];
-    const { minCellWidth, separator } = WEB_GRID_GEOMETRY;
-    const seen = new Set();
-    const steps = [];
-    for (let rows = 1; rows <= n; rows++) {
-        const columns = Math.ceil(n / rows);
-        if (seen.has(columns))
-            continue;
-        seen.add(columns);
-        steps.push({
-            columns,
-            minWidth: columns * minCellWidth + (columns - 1) * separator,
-        });
-    }
-    return steps.sort((a, b) => a.columns - b.columns);
-}
-/**
- * web 面随身 `@container` 规则文本:格数的纯函数——同格数逐字相同。基线一列写在
- * stylesheet;这里只发 ≥2 列的断点。规则只声明列数(`--grid-columns` 供体量插值取用),
- * 不出现留白或字号的具体值。末行恰一格时附带 `grid-column: 1 / -1`。
- */
-export function gridContainerRules(cellCount) {
-    const parts = [];
-    for (const { columns, minWidth } of planGridColumns(cellCount)) {
-        if (columns < 2)
-            continue;
-        const selector = `.niceeval-grid[data-cells="${cellCount}"]`;
-        const lone = cellCount % columns === 1
-            ? ` ${selector} > .niceeval-grid-cell:last-child { grid-column: 1 / -1; }`
-            : "";
-        parts.push(`@container niceeval-grid (min-width: ${minWidth}px) { ${selector} { --grid-columns: ${columns}; grid-template-columns: repeat(${columns}, minmax(0, 1fr)); }${lone} }`);
-    }
-    return parts.join("\n");
-}
-/** text 面每 cell 的最小可读内容宽度:列数宁可少,也不以挤坏字段换取更多列。 */
-const MIN_CONTENT_WIDTH = 24;
-/** 相邻两格之间那条格线连同两侧留白占的显示列(` │ `)。 */
-export const TEXT_GRID_SEPARATOR = " │ ";
-/**
- * 从格数向一列尝试,选出满足每格最小可读内容宽度的最大列数作为容量,再按行数摊匀;
- * 一列是无条件 fallback(即使内容宽度因此小于 24)。选定列数后,余下的显示列从左向右
- * 逐列多补一列,因此任意一行的显示宽度都恰好是 `availableWidth`。
- */
-export function planTextGrid(input) {
-    const { availableWidth, cellCount } = input;
-    const separator = TEXT_GRID_SEPARATOR.length;
-    const cells = Math.max(1, cellCount);
-    let capacity = 1;
-    for (let n = cells; n >= 2; n--) {
-        const budget = availableWidth - separator * (n - 1);
-        if (budget >= 0 && Math.floor(budget / n) >= MIN_CONTENT_WIDTH) {
-            capacity = n;
-            break;
-        }
-    }
-    const chosen = balanceColumns(cells, capacity);
-    const budget = Math.max(0, availableWidth - separator * (chosen - 1));
-    const base = Math.floor(budget / chosen);
-    const remainder = budget - base * chosen;
-    const contentWidths = Array.from({ length: chosen }, (_, i) => Math.max(1, base + (i < remainder ? 1 : 0)));
-    return { columns: chosen, contentWidths, fullRowContentWidth: Math.max(1, availableWidth) };
-}
-/**
- * 两行之间那条行间线:上一行 `above` 格、下一行 `below` 格,列宽取自同一份计划。
- * 两行都有的列边界画 `┼`,只有上一行有的(末行变短)收成 `┴`——末行左对齐、不拉伸,
- * 所以它的列边界总是上一行的前缀。
- */
-export function textGridRowSeparator(contentWidths, above, below) {
-    // 物理字符由数据格框的单一渲染件产出(docs/cli.md「终端框线:一个渲染件,全仓消费」);
-    // 这里只决定「上一行有几格、下一行有几格」这份格几何。
-    return dataBoxBorder("rule", contentWidths.slice(0, above), false, below);
-}

package/dist/report/definition/primitives/callouts-logic.d.ts

@@ -1,26 +0,0 @@
-import { type LocalizedText, type ReportLocale } from "../../model/locale.ts";
-export type CalloutLevel = "error" | "warning" | "info";
-export interface CalloutItem {
-    level: CalloutLevel;
-    message: LocalizedText;
-    command?: string;
-    count?: number;
-}
-export interface CalloutGroup {
-    title: LocalizedText;
-    command?: string;
-    badges?: readonly LocalizedText[];
-    items: readonly CalloutItem[];
-    groups?: readonly CalloutGroup[];
-}
-export declare function isEmptyCallouts(groups: readonly CalloutGroup[]): boolean;
-/** 嵌套组只有一个孩子时不渲染空壳层级。 */
-export declare function flattenRenderableGroups(groups: readonly CalloutGroup[]): CalloutGroup[];
-export declare function countCalloutItems(groups: readonly CalloutGroup[]): number;
-export declare function maxCalloutLevel(groups: readonly CalloutGroup[]): CalloutLevel;
-/** 组头命令:组内去重后恰一条时归组头,否则 null(命令随明细逐条走)。 */
-export declare function effectiveGroupCommand(group: CalloutGroup): string | null;
-/** 分类计数汇总行:交代组数、条数与最高严重度。 */
-export declare function calloutsSummary(groups: readonly CalloutGroup[], locale: ReportLocale): string;
-export declare function calloutDetailsLabel(locale: ReportLocale, n: number): string;
-export declare function formatCalloutMessage(item: CalloutItem, locale: ReportLocale): string;