niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/model/chart/math.d.mts

@@ -0,0 +1,73 @@
+/** 指标的自然边界(Metric.bounds / MetricColumn.bounds);两端各自可选。 */
+export interface AxisBounds {
+    min?: number;
+    max?: number;
+}
+/**
+ * 图轴值域推定(docs/feature/reports/library.md「值域」),两步:
+ *
+ * ① 呼吸边距:数据极值向两端各扩数据跨度的 20%,数据极值点因此不落在绘图框线上。数据跨度
+ * 为零(单点,或全部点同值)时,边距改取该值绝对值的 20%;值恰为 0 时取 1(否则唯一的点仍会
+ * 贴框)。
+ *
+ * ② 最小跨度下限:值域跨度不得小于量程参考的 1/3——值域永远贴着数据画的话,数据聚集时微小
+ * 差距会撑满绘图区被读成显著差异。不足时以数据为中心对称扩展补足,一端被 bounds 顶住时余量
+ * 推到另一端。量程参考:bounds 两端都声明取全量程;只声明一端取声明端到数据另一侧极值的
+ * 距离;都未声明(MetricLine 的 NumericAxis)不适用下限。
+ *
+ * 声明了 bounds 的一端,两步扩展都截到边界为止——贴边数据点如实落在框线上(如通过率 100%),
+ * 那是指标的自然边界,不是裁剪。Scatter 与 Line 的两轴共用同一个函数;
+ * web SVG 与 text 字符坐标图消费同一份返回值,渲染层不重算。
+ */
+export declare function paddedAxisDomain(values: readonly number[], bounds?: AxisBounds): [number, number];
+/**
+ * `[lo, hi]` 域内的整齐(Heckbert nice-numbers)刻度。与经典算法的差别:经典算法向外扩张
+ * `[min, max]` 到下一个整齐边界再取刻度;这里 `[lo, hi]` 已经是呼吸边距 / bounds 钳制后的
+ * 值域本身,刻度只在其内部取值,不再向外扩张——否则会在值域之外画出不存在的假刻度。
+ */
+/** 相邻刻度的步长;单刻度返回 NaN(调用方回退通用格式化)。 */
+export declare function tickStepOf(ticks: readonly number[]): number;
+export declare function ticksInDomain(lo: number, hi: number, count?: number): number[];
+export interface AxisScale {
+    /** 值域内的整齐刻度(ticksInDomain 的产物)。 */
+    ticks: number[];
+    /** 值 → 像素坐标的线性映射。 */
+    scale(value: number): number;
+}
+/**
+ * 一根轴的完整推定:先用 `paddedAxisDomain` 定值域(呼吸边距 + bounds 钳制),再用
+ * `ticksInDomain` 在域内取整齐刻度,最后按 `[pixelLo, pixelHi]` 做线性映射。`invert` 只影响
+ * 最后这一步的映射方向(`better: "lower"` 的轴反向渲染)——值域先按呼吸边距 / bounds 推定,
+ * 再决定要不要反向,反向不改变值域本身或钳制结果。Scatter 与 Line 的两轴共用
+ * 这一个函数(docs/feature/reports/library.md「值域」)。
+ */
+export declare function axisScale(values: readonly number[], bounds: AxisBounds | undefined, pixelLo: number, pixelHi: number, invert: boolean): AxisScale;
+export interface PointLabelInput {
+    cx: number;
+    cy: number;
+    /** 标签文本的估算宽度(px)。 */
+    width: number;
+}
+/** 标签允许占用的画布范围(含坐标轴边距,标签可以借用空白边距)。 */
+export interface LabelBounds {
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+}
+export interface PlacedPointLabel {
+    /** <text> 的锚点坐标(y 为文字基线)。 */
+    x: number;
+    y: number;
+    anchor: "start" | "end" | "middle";
+    /** 标签不在点左右紧邻位:渲染层补 leader line 连回原点。 */
+    leader: boolean;
+}
+/**
+ * 散点直接标签的候选位择优布局(docs/feature/reports/library.md「Scatter」):
+ * 每个标签在点四周由近及远的候选环上打分——与已放置标签的重叠、与任何数据点的重叠、
+ * 越出画布的面积、离点距离逐项累加,取代价最小的候选。存在无冲突候选时标签必不遮点、
+ * 不叠标签、不越界;全候选冲突时取重叠最小者,绝不丢标签。重合点簇因此向不同方向散开,
+ * 而不是单向堆叠压到下方的数据点上。
+ */
+export declare function placePointLabels(points: PointLabelInput[], bounds: LabelBounds): PlacedPointLabel[];

package/dist/report/model/chart/math.d.ts

@@ -0,0 +1,73 @@
+/** 指标的自然边界(Metric.bounds / MetricColumn.bounds);两端各自可选。 */
+export interface AxisBounds {
+    min?: number;
+    max?: number;
+}
+/**
+ * 图轴值域推定(docs/feature/reports/library.md「值域」),两步:
+ *
+ * ① 呼吸边距:数据极值向两端各扩数据跨度的 20%,数据极值点因此不落在绘图框线上。数据跨度
+ * 为零(单点,或全部点同值)时,边距改取该值绝对值的 20%;值恰为 0 时取 1(否则唯一的点仍会
+ * 贴框)。
+ *
+ * ② 最小跨度下限:值域跨度不得小于量程参考的 1/3——值域永远贴着数据画的话,数据聚集时微小
+ * 差距会撑满绘图区被读成显著差异。不足时以数据为中心对称扩展补足,一端被 bounds 顶住时余量
+ * 推到另一端。量程参考:bounds 两端都声明取全量程;只声明一端取声明端到数据另一侧极值的
+ * 距离;都未声明(MetricLine 的 NumericAxis)不适用下限。
+ *
+ * 声明了 bounds 的一端,两步扩展都截到边界为止——贴边数据点如实落在框线上(如通过率 100%),
+ * 那是指标的自然边界,不是裁剪。Scatter 与 Line 的两轴共用同一个函数;
+ * web SVG 与 text 字符坐标图消费同一份返回值,渲染层不重算。
+ */
+export declare function paddedAxisDomain(values: readonly number[], bounds?: AxisBounds): [number, number];
+/**
+ * `[lo, hi]` 域内的整齐(Heckbert nice-numbers)刻度。与经典算法的差别:经典算法向外扩张
+ * `[min, max]` 到下一个整齐边界再取刻度;这里 `[lo, hi]` 已经是呼吸边距 / bounds 钳制后的
+ * 值域本身,刻度只在其内部取值,不再向外扩张——否则会在值域之外画出不存在的假刻度。
+ */
+/** 相邻刻度的步长;单刻度返回 NaN(调用方回退通用格式化)。 */
+export declare function tickStepOf(ticks: readonly number[]): number;
+export declare function ticksInDomain(lo: number, hi: number, count?: number): number[];
+export interface AxisScale {
+    /** 值域内的整齐刻度(ticksInDomain 的产物)。 */
+    ticks: number[];
+    /** 值 → 像素坐标的线性映射。 */
+    scale(value: number): number;
+}
+/**
+ * 一根轴的完整推定:先用 `paddedAxisDomain` 定值域(呼吸边距 + bounds 钳制),再用
+ * `ticksInDomain` 在域内取整齐刻度,最后按 `[pixelLo, pixelHi]` 做线性映射。`invert` 只影响
+ * 最后这一步的映射方向(`better: "lower"` 的轴反向渲染)——值域先按呼吸边距 / bounds 推定,
+ * 再决定要不要反向,反向不改变值域本身或钳制结果。Scatter 与 Line 的两轴共用
+ * 这一个函数(docs/feature/reports/library.md「值域」)。
+ */
+export declare function axisScale(values: readonly number[], bounds: AxisBounds | undefined, pixelLo: number, pixelHi: number, invert: boolean): AxisScale;
+export interface PointLabelInput {
+    cx: number;
+    cy: number;
+    /** 标签文本的估算宽度(px)。 */
+    width: number;
+}
+/** 标签允许占用的画布范围(含坐标轴边距,标签可以借用空白边距)。 */
+export interface LabelBounds {
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+}
+export interface PlacedPointLabel {
+    /** <text> 的锚点坐标(y 为文字基线)。 */
+    x: number;
+    y: number;
+    anchor: "start" | "end" | "middle";
+    /** 标签不在点左右紧邻位:渲染层补 leader line 连回原点。 */
+    leader: boolean;
+}
+/**
+ * 散点直接标签的候选位择优布局(docs/feature/reports/library.md「Scatter」):
+ * 每个标签在点四周由近及远的候选环上打分——与已放置标签的重叠、与任何数据点的重叠、
+ * 越出画布的面积、离点距离逐项累加,取代价最小的候选。存在无冲突候选时标签必不遮点、
+ * 不叠标签、不越界;全候选冲突时取重叠最小者,绝不丢标签。重合点簇因此向不同方向散开,
+ * 而不是单向堆叠压到下方的数据点上。
+ */
+export declare function placePointLabels(points: PointLabelInput[], bounds: LabelBounds): PlacedPointLabel[];

package/dist/report/model/chart/math.js

@@ -0,0 +1,14 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./math.cjs");
+const __niceevalExport0 = __niceevalCanonical["axisScale"];
+export { __niceevalExport0 as axisScale };
+const __niceevalExport1 = __niceevalCanonical["paddedAxisDomain"];
+export { __niceevalExport1 as paddedAxisDomain };
+const __niceevalExport2 = __niceevalCanonical["placePointLabels"];
+export { __niceevalExport2 as placePointLabels };
+const __niceevalExport3 = __niceevalCanonical["tickStepOf"];
+export { __niceevalExport3 as tickStepOf };
+const __niceevalExport4 = __niceevalCanonical["ticksInDomain"];
+export { __niceevalExport4 as ticksInDomain };
+//# sourceMappingURL=math.js.map

package/dist/report/model/chart/math.js.map

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

package/dist/report/model/chart/plot.cjs

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderCharPlot = renderCharPlot;
+exports.renderCoordinateTable = renderCoordinateTable;
+// text 面的字符坐标图:Scatter / Line 共用。
+// 形态照 docs-site/zh/reference/report-components.mdx 的示例块:y 轴刻度 + │ 边框,
+// 点用字母标注、图例列在图下;lower-better 的轴反向,「好」的角落恒在右上。
+const text_layout_ts_1 = require("../text-layout.cjs");
+function makeScale(lo, hi, cells, invert) {
+    const span = hi - lo;
+    return {
+        lo,
+        hi,
+        at(value) {
+            // 单值域:唯一的点落正中
+            let t = span === 0 ? 0.5 : (value - lo) / span;
+            if (invert)
+                t = 1 - t;
+            return Math.max(0, Math.min(cells - 1, Math.round(t * (cells - 1))));
+        },
+    };
+}
+/** 值空间折线 → 网格 · 描画:相邻点之间按列逐格线性插值。 */
+function drawLine(grid, a, b) {
+    const steps = Math.max(Math.abs(b.col - a.col), Math.abs(b.row - a.row));
+    for (let i = 1; i < steps; i++) {
+        const col = Math.round(a.col + ((b.col - a.col) * i) / steps);
+        const row = Math.round(a.row + ((b.row - a.row) * i) / steps);
+        if (grid[row][col] === " ")
+            grid[row][col] = "·";
+    }
+}
+function renderCharPlot(opts) {
+    const height = Math.max(4, opts.height ?? 9);
+    const yTickTexts = [opts.formatY(opts.yDomain[0]), opts.formatY(opts.yDomain[1])]; // 仅估 gutter 宽度,精度不参与展示
+    const gutter = Math.max(...yTickTexts.map(text_layout_ts_1.stringWidth)) + 1;
+    const plotWidth = Math.max(16, opts.width - gutter - 1);
+    const xScale = makeScale(opts.xDomain[0], opts.xDomain[1], plotWidth, opts.invertX ?? false);
+    // y:大下标 = 「好」的一端;网格第 0 行是顶端,行下标 = height-1 - at,
+    // 所以 invertY=false(higher 好)时 hi 折到 at=height-1 → 顶行,lower 好时反之
+    const yScale = makeScale(opts.yDomain[0], opts.yDomain[1], height, opts.invertY ?? false);
+    const rowOf = (y) => height - 1 - yScale.at(y);
+    const grid = Array.from({ length: height }, () => Array.from({ length: plotWidth }, () => " "));
+    for (const line of opts.lines ?? []) {
+        for (let i = 1; i < line.length; i++) {
+            drawLine(grid, { col: xScale.at(line[i - 1].x), row: rowOf(line[i - 1].y) }, { col: xScale.at(line[i].x), row: rowOf(line[i].y) });
+        }
+    }
+    for (const point of opts.points) {
+        grid[rowOf(point.y)][xScale.at(point.x)] = point.mark;
+    }
+    // y 轴刻度:极值行标注 display,其余空
+    const tickByRow = new Map();
+    tickByRow.set(rowOf(yScale.lo), opts.formatY(yScale.lo, yScale.hi - yScale.lo));
+    tickByRow.set(rowOf(yScale.hi), opts.formatY(yScale.hi, yScale.hi - yScale.lo));
+    const out = [];
+    out.push(`${" ".repeat(gutter)}${opts.yLabel} ↑`);
+    for (let row = 0; row < height; row++) {
+        const tick = tickByRow.get(row) ?? "";
+        out.push(`${(0, text_layout_ts_1.padStartDisplay)(tick, gutter)}│${grid[row].join("")}`.replace(/\s+$/, ""));
+    }
+    out.push(`${" ".repeat(gutter)}└${"─".repeat(plotWidth)}→ ${opts.xLabel}`);
+    // x 轴刻度:两端极值(反向轴时右端是 lo),标在真实位置上
+    const ticksRow = Array.from({ length: plotWidth }, () => " ");
+    for (const value of xScale.lo === xScale.hi ? [xScale.lo] : [xScale.lo, xScale.hi]) {
+        const label = opts.formatX(value, xScale.hi - xScale.lo);
+        let col = xScale.at(value);
+        col = Math.min(col, plotWidth - (0, text_layout_ts_1.stringWidth)(label));
+        for (let i = 0; i < label.length && col + i < plotWidth; i++)
+            ticksRow[col + i] = label[i];
+    }
+    out.push(`${" ".repeat(gutter + 1)}${ticksRow.join("")}`.replace(/\s+$/, ""));
+    return out.join("\n");
+}
+/**
+ * 图下的读值表:每行是一个点的标记字母、所属系列、点名与两轴终值。字母把图上的记号与这
+ * 一行绑在一起(docs/feature/reports/cli.md「标记字母按图例顺序分配」);
+ * `series` 列只在有两个以上系列时出现,单系列时那一列全是同一个词、占宽度不给信息。
+ */
+function renderCoordinateTable(rows, header) {
+    const all = [header, ...rows];
+    const columns = ["mark", "series", "key", "x"];
+    const widths = new Map();
+    for (const column of columns) {
+        widths.set(column, Math.max(...all.map((row) => (0, text_layout_ts_1.stringWidth)(row[column] ?? ""))));
+    }
+    return all
+        .map((row) => [...columns.map((column) => (0, text_layout_ts_1.padDisplay)(row[column] ?? "", widths.get(column))), row.y]
+        .filter((cell) => cell.length > 0)
+        .join("   ")
+        .replace(/\s+$/, ""))
+        .join("\n");
+}
+//# sourceMappingURL=plot.cjs.map

package/dist/report/model/chart/plot.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot.js","sourceRoot":"","sources":["plot.ts"],"names":[],"mappings":"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","sourcesContent":["// text 面的字符坐标图:Scatter / Line 共用。\n// 形态照 docs-site/zh/reference/report-components.mdx 的示例块:y 轴刻度 + │ 边框,\n// 点用字母标注、图例列在图下;lower-better 的轴反向,「好」的角落恒在右上。\nimport { padDisplay, padStartDisplay, stringWidth } from \"../text-layout.ts\";\nexport interface PlotPoint {\n    /** 图上的标记字符(点或系列的字母)。 */\n    mark: string;\n    x: number;\n    y: number;\n}\nexport interface CharPlotOptions {\n    /** 总列宽(含 y 轴刻度区)。 */\n    width: number;\n    /** 网格行数;默认 9。 */\n    height?: number;\n    points: PlotPoint[];\n    /**\n     * 值域(已按呼吸边距 / bounds 钳制推定,与 web 面共用同一份——见\n     * chart-math.ts 的 `paddedAxisDomain`,调用方在此之前算好,text 面按字符行列粒度取整,\n     * 不重算)。\n     */\n    xDomain: [\n        number,\n        number\n    ];\n    yDomain: [\n        number,\n        number\n    ];\n    /** 值空间的折线(同系列点按 x 排序连线),用 · 描画,字母覆盖其上。 */\n    lines?: {\n        x: number;\n        y: number;\n    }[][];\n    xLabel: string;\n    yLabel: string;\n    /** 值 → 刻度文案(已格式化的 display)。 */\n    formatX: (value: number, step?: number) => string;\n    formatY: (value: number, step?: number) => string;\n    /** better: \"lower\" 的轴反向 —— 好的一端在右 / 上。 */\n    invertX?: boolean;\n    invertY?: boolean;\n}\ninterface Scale {\n    lo: number;\n    hi: number;\n    /** 值 → [0, cells-1] 的下标。 */\n    at(value: number): number;\n}\nfunction makeScale(lo: number, hi: number, cells: number, invert: boolean): Scale {\n    const span = hi - lo;\n    return {\n        lo,\n        hi,\n        at(value: number): number {\n            // 单值域:唯一的点落正中\n            let t = span === 0 ? 0.5 : (value - lo) / span;\n            if (invert)\n                t = 1 - t;\n            return Math.max(0, Math.min(cells - 1, Math.round(t * (cells - 1))));\n        },\n    };\n}\n/** 值空间折线 → 网格 · 描画:相邻点之间按列逐格线性插值。 */\nfunction drawLine(grid: string[][], a: {\n    col: number;\n    row: number;\n}, b: {\n    col: number;\n    row: number;\n}): void {\n    const steps = Math.max(Math.abs(b.col - a.col), Math.abs(b.row - a.row));\n    for (let i = 1; i < steps; i++) {\n        const col = Math.round(a.col + ((b.col - a.col) * i) / steps);\n        const row = Math.round(a.row + ((b.row - a.row) * i) / steps);\n        if (grid[row][col] === \" \")\n            grid[row][col] = \"·\";\n    }\n}\nexport function renderCharPlot(opts: CharPlotOptions): string {\n    const height = Math.max(4, opts.height ?? 9);\n    const yTickTexts = [opts.formatY(opts.yDomain[0]), opts.formatY(opts.yDomain[1])]; // 仅估 gutter 宽度,精度不参与展示\n    const gutter = Math.max(...yTickTexts.map(stringWidth)) + 1;\n    const plotWidth = Math.max(16, opts.width - gutter - 1);\n    const xScale = makeScale(opts.xDomain[0], opts.xDomain[1], plotWidth, opts.invertX ?? false);\n    // y:大下标 = 「好」的一端;网格第 0 行是顶端,行下标 = height-1 - at,\n    // 所以 invertY=false(higher 好)时 hi 折到 at=height-1 → 顶行,lower 好时反之\n    const yScale = makeScale(opts.yDomain[0], opts.yDomain[1], height, opts.invertY ?? false);\n    const rowOf = (y: number) => height - 1 - yScale.at(y);\n    const grid: string[][] = Array.from({ length: height }, () => Array.from({ length: plotWidth }, () => \" \"));\n    for (const line of opts.lines ?? []) {\n        for (let i = 1; i < line.length; i++) {\n            drawLine(grid, { col: xScale.at(line[i - 1].x), row: rowOf(line[i - 1].y) }, { col: xScale.at(line[i].x), row: rowOf(line[i].y) });\n        }\n    }\n    for (const point of opts.points) {\n        grid[rowOf(point.y)][xScale.at(point.x)] = point.mark;\n    }\n    // y 轴刻度:极值行标注 display,其余空\n    const tickByRow = new Map<number, string>();\n    tickByRow.set(rowOf(yScale.lo), opts.formatY(yScale.lo, yScale.hi - yScale.lo));\n    tickByRow.set(rowOf(yScale.hi), opts.formatY(yScale.hi, yScale.hi - yScale.lo));\n    const out: string[] = [];\n    out.push(`${\" \".repeat(gutter)}${opts.yLabel} ↑`);\n    for (let row = 0; row < height; row++) {\n        const tick = tickByRow.get(row) ?? \"\";\n        out.push(`${padStartDisplay(tick, gutter)}│${grid[row].join(\"\")}`.replace(/\\s+$/, \"\"));\n    }\n    out.push(`${\" \".repeat(gutter)}└${\"─\".repeat(plotWidth)}→ ${opts.xLabel}`);\n    // x 轴刻度:两端极值(反向轴时右端是 lo),标在真实位置上\n    const ticksRow = Array.from({ length: plotWidth }, () => \" \");\n    for (const value of xScale.lo === xScale.hi ? [xScale.lo] : [xScale.lo, xScale.hi]) {\n        const label = opts.formatX(value, xScale.hi - xScale.lo);\n        let col = xScale.at(value);\n        col = Math.min(col, plotWidth - stringWidth(label));\n        for (let i = 0; i < label.length && col + i < plotWidth; i++)\n            ticksRow[col + i] = label[i];\n    }\n    out.push(`${\" \".repeat(gutter + 1)}${ticksRow.join(\"\")}`.replace(/\\s+$/, \"\"));\n    return out.join(\"\\n\");\n}\n/**\n * 图下的读值表:每行是一个点的标记字母、所属系列、点名与两轴终值。字母把图上的记号与这\n * 一行绑在一起(docs/feature/reports/cli.md「标记字母按图例顺序分配」);\n * `series` 列只在有两个以上系列时出现,单系列时那一列全是同一个词、占宽度不给信息。\n */\nexport function renderCoordinateTable(rows: {\n    mark?: string;\n    series?: string;\n    key: string;\n    x: string;\n    y: string;\n}[], header: {\n    mark?: string;\n    series?: string;\n    key: string;\n    x: string;\n    y: string;\n}): string {\n    const all = [header, ...rows];\n    const columns: (\"mark\" | \"series\" | \"key\" | \"x\")[] = [\"mark\", \"series\", \"key\", \"x\"];\n    const widths = new Map<string, number>();\n    for (const column of columns) {\n        widths.set(column, Math.max(...all.map((row) => stringWidth(row[column] ?? \"\"))));\n    }\n    return all\n        .map((row) => [...columns.map((column) => padDisplay(row[column] ?? \"\", widths.get(column)!)), row.y]\n        .filter((cell) => cell.length > 0)\n        .join(\"   \")\n        .replace(/\\s+$/, \"\"))\n        .join(\"\\n\");\n}\n"]}

package/dist/report/model/chart/plot.d.cts

@@ -0,0 +1,52 @@
+export interface PlotPoint {
+    /** 图上的标记字符(点或系列的字母)。 */
+    mark: string;
+    x: number;
+    y: number;
+}
+export interface CharPlotOptions {
+    /** 总列宽(含 y 轴刻度区)。 */
+    width: number;
+    /** 网格行数;默认 9。 */
+    height?: number;
+    points: PlotPoint[];
+    /**
+     * 值域(已按呼吸边距 / bounds 钳制推定,与 web 面共用同一份——见
+     * chart-math.ts 的 `paddedAxisDomain`,调用方在此之前算好,text 面按字符行列粒度取整,
+     * 不重算)。
+     */
+    xDomain: [number, number];
+    yDomain: [number, number];
+    /** 值空间的折线(同系列点按 x 排序连线),用 · 描画,字母覆盖其上。 */
+    lines?: {
+        x: number;
+        y: number;
+    }[][];
+    xLabel: string;
+    yLabel: string;
+    /** 值 → 刻度文案(已格式化的 display)。 */
+    formatX: (value: number, step?: number) => string;
+    formatY: (value: number, step?: number) => string;
+    /** better: "lower" 的轴反向 —— 好的一端在右 / 上。 */
+    invertX?: boolean;
+    invertY?: boolean;
+}
+export declare function renderCharPlot(opts: CharPlotOptions): string;
+/**
+ * 图下的读值表:每行是一个点的标记字母、所属系列、点名与两轴终值。字母把图上的记号与这
+ * 一行绑在一起(docs/feature/reports/cli.md「标记字母按图例顺序分配」);
+ * `series` 列只在有两个以上系列时出现,单系列时那一列全是同一个词、占宽度不给信息。
+ */
+export declare function renderCoordinateTable(rows: {
+    mark?: string;
+    series?: string;
+    key: string;
+    x: string;
+    y: string;
+}[], header: {
+    mark?: string;
+    series?: string;
+    key: string;
+    x: string;
+    y: string;
+}): string;

package/dist/report/model/chart/plot.d.mts

@@ -0,0 +1,52 @@
+export interface PlotPoint {
+    /** 图上的标记字符(点或系列的字母)。 */
+    mark: string;
+    x: number;
+    y: number;
+}
+export interface CharPlotOptions {
+    /** 总列宽(含 y 轴刻度区)。 */
+    width: number;
+    /** 网格行数;默认 9。 */
+    height?: number;
+    points: PlotPoint[];
+    /**
+     * 值域(已按呼吸边距 / bounds 钳制推定,与 web 面共用同一份——见
+     * chart-math.ts 的 `paddedAxisDomain`,调用方在此之前算好,text 面按字符行列粒度取整,
+     * 不重算)。
+     */
+    xDomain: [number, number];
+    yDomain: [number, number];
+    /** 值空间的折线(同系列点按 x 排序连线),用 · 描画,字母覆盖其上。 */
+    lines?: {
+        x: number;
+        y: number;
+    }[][];
+    xLabel: string;
+    yLabel: string;
+    /** 值 → 刻度文案(已格式化的 display)。 */
+    formatX: (value: number, step?: number) => string;
+    formatY: (value: number, step?: number) => string;
+    /** better: "lower" 的轴反向 —— 好的一端在右 / 上。 */
+    invertX?: boolean;
+    invertY?: boolean;
+}
+export declare function renderCharPlot(opts: CharPlotOptions): string;
+/**
+ * 图下的读值表:每行是一个点的标记字母、所属系列、点名与两轴终值。字母把图上的记号与这
+ * 一行绑在一起(docs/feature/reports/cli.md「标记字母按图例顺序分配」);
+ * `series` 列只在有两个以上系列时出现,单系列时那一列全是同一个词、占宽度不给信息。
+ */
+export declare function renderCoordinateTable(rows: {
+    mark?: string;
+    series?: string;
+    key: string;
+    x: string;
+    y: string;
+}[], header: {
+    mark?: string;
+    series?: string;
+    key: string;
+    x: string;
+    y: string;
+}): string;

package/dist/report/model/chart/plot.d.ts

@@ -0,0 +1,52 @@
+export interface PlotPoint {
+    /** 图上的标记字符(点或系列的字母)。 */
+    mark: string;
+    x: number;
+    y: number;
+}
+export interface CharPlotOptions {
+    /** 总列宽(含 y 轴刻度区)。 */
+    width: number;
+    /** 网格行数;默认 9。 */
+    height?: number;
+    points: PlotPoint[];
+    /**
+     * 值域(已按呼吸边距 / bounds 钳制推定,与 web 面共用同一份——见
+     * chart-math.ts 的 `paddedAxisDomain`,调用方在此之前算好,text 面按字符行列粒度取整,
+     * 不重算)。
+     */
+    xDomain: [number, number];
+    yDomain: [number, number];
+    /** 值空间的折线(同系列点按 x 排序连线),用 · 描画,字母覆盖其上。 */
+    lines?: {
+        x: number;
+        y: number;
+    }[][];
+    xLabel: string;
+    yLabel: string;
+    /** 值 → 刻度文案(已格式化的 display)。 */
+    formatX: (value: number, step?: number) => string;
+    formatY: (value: number, step?: number) => string;
+    /** better: "lower" 的轴反向 —— 好的一端在右 / 上。 */
+    invertX?: boolean;
+    invertY?: boolean;
+}
+export declare function renderCharPlot(opts: CharPlotOptions): string;
+/**
+ * 图下的读值表:每行是一个点的标记字母、所属系列、点名与两轴终值。字母把图上的记号与这
+ * 一行绑在一起(docs/feature/reports/cli.md「标记字母按图例顺序分配」);
+ * `series` 列只在有两个以上系列时出现,单系列时那一列全是同一个词、占宽度不给信息。
+ */
+export declare function renderCoordinateTable(rows: {
+    mark?: string;
+    series?: string;
+    key: string;
+    x: string;
+    y: string;
+}[], header: {
+    mark?: string;
+    series?: string;
+    key: string;
+    x: string;
+    y: string;
+}): string;

package/dist/report/model/chart/plot.js

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

package/dist/report/model/chart/plot.js.map

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

package/dist/report/model/conversions.cjs

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toMetricDetailRow = toMetricDetailRow;
+exports.toIssueRows = toIssueRows;
+exports.toEvidenceRows = toEvidenceRows;
+exports.toIssueText = toIssueText;
+exports.toAttemptEvidence = toAttemptEvidence;
+exports.toAttemptObservability = toAttemptObservability;
+exports.toFileChanges = toFileChanges;
+exports.toSourceNavigation = toSourceNavigation;
+exports.toSources = toSources;
+exports.toSandboxHistory = toSandboxHistory;
+const index_ts_1 = require("../../analysis/index.cjs");
+const format_ts_1 = require("./format.cjs");
+/** Converts a metric for display without splitting it into a new statistical value. */
+function toMetricDetailRow(metric, locale) {
+    const value = metric.value === null
+        ? (0, format_ts_1.missingText)("noSamples", locale)
+        : (0, format_ts_1.formatMetricScalar)(metric.value, metric.unit, metric.format, locale);
+    return Object.freeze({
+        metric,
+        value,
+        state: metric.state,
+        samples: metric.samples,
+        total: metric.total,
+        basis: metric.basis,
+        issues: metric.issues,
+        refs: metric.refs,
+    });
+}
+/** Closed Analysis issues become plain rows without suppressing linked evidence. */
+function toIssueRows(issues) {
+    return Object.freeze(issues.map((issue) => Object.freeze({
+        code: issue.code,
+        message: issue.message,
+        evidence: issue.refs.map(evidenceRefText).join(", "),
+    })));
+}
+/** Evidence references become readable rows while keeping their canonical identity text. */
+function toEvidenceRows(refs) {
+    return Object.freeze(refs.map((reference) => Object.freeze({ reference: evidenceRefText(reference) })));
+}
+/** One string for constrained text surfaces; it includes all references. */
+function toIssueText(issue) {
+    const evidence = issue.refs.map(evidenceRefText).join(", ");
+    return evidence === "" ? issue.message : `${issue.message} (${evidence})`;
+}
+/** Evidence identity is already closed by Analysis; Report only formats its locator. */
+function evidenceRefText(reference) {
+    return reference.identity.locator;
+}
+/** Closes Assertions / Evidence through the one published Analysis DomainView. */
+function toAttemptEvidence(sample, locator) {
+    return (0, index_ts_1.query)(sample, {
+        kind: "domain-view",
+        view: index_ts_1.attemptEvidenceView,
+        ...(locator === undefined ? {} : { locator }),
+    });
+}
+/** Closes conversation, commands, usage, timing and diagnostics for selected Attempts. */
+function toAttemptObservability(sample, locator) {
+    return (0, index_ts_1.query)(sample, {
+        kind: "domain-view",
+        view: index_ts_1.attemptObservabilityView,
+        ...(locator === undefined ? {} : { locator }),
+    });
+}
+/** Closes the fixed Attempt file-change DomainView. */
+function toFileChanges(sample, locator) {
+    return (0, index_ts_1.query)(sample, {
+        kind: "domain-view",
+        view: index_ts_1.fileChangesView,
+        ...(locator === undefined ? {} : { locator }),
+    });
+}
+/** Closes exact physical send-to-source and send-to-timing navigation. */
+function toSourceNavigation(sample, locator) {
+    return (0, index_ts_1.query)(sample, {
+        kind: "domain-view",
+        view: index_ts_1.sourceNavigationView,
+        ...(locator === undefined ? {} : { locator }),
+    });
+}
+/** Closes the origin-Run Sources DomainView for selected Attempts. */
+function toSources(sample, locator) {
+    return (0, index_ts_1.query)(sample, {
+        kind: "domain-view",
+        view: index_ts_1.sourcesView,
+        ...(locator === undefined ? {} : { locator }),
+    });
+}
+/** Closes sandbox-only command, timing and diagnostic history. */
+function toSandboxHistory(sample, locator) {
+    return (0, index_ts_1.query)(sample, {
+        kind: "domain-view",
+        view: index_ts_1.sandboxHistoryView,
+        ...(locator === undefined ? {} : { locator }),
+    });
+}
+//# sourceMappingURL=conversions.cjs.map

package/dist/report/model/conversions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.js","sourceRoot":"","sources":["conversions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnalysisIssue, AttemptEvidenceDomainView, AttemptObservabilityDomainView, EvidenceRef, FileChangesDomainView, MetricValue, Sample, SandboxHistoryDomainView, SourceNavigationDomainView, SourcesDomainView, } from \"../../analysis/index.ts\";\nimport { attemptEvidenceView, attemptObservabilityView, fileChangesView, query, sandboxHistoryView, sourceNavigationView, sourcesView, } from \"../../analysis/index.ts\";\nimport type { AttemptLocator } from \"../../attempt-locator.ts\";\nimport { formatMetricScalar, missingText } from \"./format.ts\";\nimport type { ReportLocale } from \"./locale.ts\";\n/** A table-safe projection that still contains the original complete metric. */\nexport interface MetricDetailRow {\n    readonly metric: MetricValue;\n    readonly value: string;\n    readonly state: MetricValue[\"state\"];\n    readonly samples: number;\n    readonly total: number;\n    readonly basis: MetricValue[\"basis\"];\n    readonly issues: readonly AnalysisIssue[];\n    readonly refs: readonly EvidenceRef[];\n}\n/** Converts a metric for display without splitting it into a new statistical value. */\nexport function toMetricDetailRow(metric: MetricValue, locale?: ReportLocale): MetricDetailRow {\n    const value = metric.value === null\n        ? missingText(\"noSamples\", locale)\n        : formatMetricScalar(metric.value, metric.unit, metric.format, locale);\n    return Object.freeze({\n        metric,\n        value,\n        state: metric.state,\n        samples: metric.samples,\n        total: metric.total,\n        basis: metric.basis,\n        issues: metric.issues,\n        refs: metric.refs,\n    });\n}\n/** Closed Analysis issues become plain rows without suppressing linked evidence. */\nexport function toIssueRows(issues: readonly AnalysisIssue[]): readonly Readonly<{\n    readonly code: string;\n    readonly message: string;\n    readonly evidence: string;\n}>[] {\n    return Object.freeze(issues.map((issue) => Object.freeze({\n        code: issue.code,\n        message: issue.message,\n        evidence: issue.refs.map(evidenceRefText).join(\", \"),\n    })));\n}\n/** Evidence references become readable rows while keeping their canonical identity text. */\nexport function toEvidenceRows(refs: readonly EvidenceRef[]): readonly Readonly<{\n    readonly reference: string;\n}>[] {\n    return Object.freeze(refs.map((reference) => Object.freeze({ reference: evidenceRefText(reference) })));\n}\n/** One string for constrained text surfaces; it includes all references. */\nexport function toIssueText(issue: AnalysisIssue): string {\n    const evidence = issue.refs.map(evidenceRefText).join(\", \");\n    return evidence === \"\" ? issue.message : `${issue.message} (${evidence})`;\n}\n/** Evidence identity is already closed by Analysis; Report only formats its locator. */\nfunction evidenceRefText(reference: EvidenceRef): string {\n    return reference.identity.locator;\n}\n/** Closes Assertions / Evidence through the one published Analysis DomainView. */\nexport function toAttemptEvidence(sample: Sample, locator?: AttemptLocator): Promise<AttemptEvidenceDomainView> {\n    return query(sample, {\n        kind: \"domain-view\",\n        view: attemptEvidenceView,\n        ...(locator === undefined ? {} : { locator }),\n    });\n}\n/** Closes conversation, commands, usage, timing and diagnostics for selected Attempts. */\nexport function toAttemptObservability(sample: Sample, locator?: AttemptLocator): Promise<AttemptObservabilityDomainView> {\n    return query(sample, {\n        kind: \"domain-view\",\n        view: attemptObservabilityView,\n        ...(locator === undefined ? {} : { locator }),\n    });\n}\n/** Closes the fixed Attempt file-change DomainView. */\nexport function toFileChanges(sample: Sample, locator?: AttemptLocator): Promise<FileChangesDomainView> {\n    return query(sample, {\n        kind: \"domain-view\",\n        view: fileChangesView,\n        ...(locator === undefined ? {} : { locator }),\n    });\n}\n/** Closes exact physical send-to-source and send-to-timing navigation. */\nexport function toSourceNavigation(sample: Sample, locator?: AttemptLocator): Promise<SourceNavigationDomainView> {\n    return query(sample, {\n        kind: \"domain-view\",\n        view: sourceNavigationView,\n        ...(locator === undefined ? {} : { locator }),\n    });\n}\n/** Closes the origin-Run Sources DomainView for selected Attempts. */\nexport function toSources(sample: Sample, locator?: AttemptLocator): Promise<SourcesDomainView> {\n    return query(sample, {\n        kind: \"domain-view\",\n        view: sourcesView,\n        ...(locator === undefined ? {} : { locator }),\n    });\n}\n/** Closes sandbox-only command, timing and diagnostic history. */\nexport function toSandboxHistory(sample: Sample, locator?: AttemptLocator): Promise<SandboxHistoryDomainView> {\n    return query(sample, {\n        kind: \"domain-view\",\n        view: sandboxHistoryView,\n        ...(locator === undefined ? {} : { locator }),\n    });\n}\n"]}

package/dist/report/model/conversions.d.cts

@@ -0,0 +1,40 @@
+import type { AnalysisIssue, AttemptEvidenceDomainView, AttemptObservabilityDomainView, EvidenceRef, FileChangesDomainView, MetricValue, Sample, SandboxHistoryDomainView, SourceNavigationDomainView, SourcesDomainView } from "../../analysis/index.cjs";
+import type { AttemptLocator } from "../../attempt-locator.cjs";
+import type { ReportLocale } from "./locale.cjs";
+/** A table-safe projection that still contains the original complete metric. */
+export interface MetricDetailRow {
+    readonly metric: MetricValue;
+    readonly value: string;
+    readonly state: MetricValue["state"];
+    readonly samples: number;
+    readonly total: number;
+    readonly basis: MetricValue["basis"];
+    readonly issues: readonly AnalysisIssue[];
+    readonly refs: readonly EvidenceRef[];
+}
+/** Converts a metric for display without splitting it into a new statistical value. */
+export declare function toMetricDetailRow(metric: MetricValue, locale?: ReportLocale): MetricDetailRow;
+/** Closed Analysis issues become plain rows without suppressing linked evidence. */
+export declare function toIssueRows(issues: readonly AnalysisIssue[]): readonly Readonly<{
+    readonly code: string;
+    readonly message: string;
+    readonly evidence: string;
+}>[];
+/** Evidence references become readable rows while keeping their canonical identity text. */
+export declare function toEvidenceRows(refs: readonly EvidenceRef[]): readonly Readonly<{
+    readonly reference: string;
+}>[];
+/** One string for constrained text surfaces; it includes all references. */
+export declare function toIssueText(issue: AnalysisIssue): string;
+/** Closes Assertions / Evidence through the one published Analysis DomainView. */
+export declare function toAttemptEvidence(sample: Sample, locator?: AttemptLocator): Promise<AttemptEvidenceDomainView>;
+/** Closes conversation, commands, usage, timing and diagnostics for selected Attempts. */
+export declare function toAttemptObservability(sample: Sample, locator?: AttemptLocator): Promise<AttemptObservabilityDomainView>;
+/** Closes the fixed Attempt file-change DomainView. */
+export declare function toFileChanges(sample: Sample, locator?: AttemptLocator): Promise<FileChangesDomainView>;
+/** Closes exact physical send-to-source and send-to-timing navigation. */
+export declare function toSourceNavigation(sample: Sample, locator?: AttemptLocator): Promise<SourceNavigationDomainView>;
+/** Closes the origin-Run Sources DomainView for selected Attempts. */
+export declare function toSources(sample: Sample, locator?: AttemptLocator): Promise<SourcesDomainView>;
+/** Closes sandbox-only command, timing and diagnostic history. */
+export declare function toSandboxHistory(sample: Sample, locator?: AttemptLocator): Promise<SandboxHistoryDomainView>;