niceeval 0.5.3 → 0.6.0

package/dist/report/react/MetricScatter.js

@@ -0,0 +1,100 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatMetricValue } from "../format.js";
+import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveMetricLabel } from "../locale.js";
+import { layoutLabelOffsets, niceTicks } from "./chart-math.js";
+import { colorClassForKey, seriesClassForKey } from "./colors.js";
+import { cx } from "./format.js";
+const WIDTH = 640;
+const HEIGHT = 360;
+const MARGIN = { top: 26, right: 24, bottom: 46, left: 62 };
+const PLOT_W = WIDTH - MARGIN.left - MARGIN.right;
+const PLOT_H = HEIGHT - MARGIN.top - MARGIN.bottom;
+/** 点的直接标签:experiment id 的末段(完整 id 在 <title> 里)。 */
+function pointLabel(key) {
+    return key.split("/").filter(Boolean).at(-1) ?? key;
+}
+/**
+ * 一根轴:niceTicks 撑出整齐的值域,值 → 像素做线性映射;
+ * better: "lower" 时反向,好的一端固定在右 / 上。
+ */
+function axisScale(values, better, pixelLo, pixelHi) {
+    const ticks = niceTicks(Math.min(...values), Math.max(...values), 5);
+    const lo = ticks[0];
+    const hi = ticks[ticks.length - 1];
+    const scale = (v) => {
+        let t = (v - lo) / (hi - lo || 1);
+        if (better === "lower")
+            t = 1 - t; // 反向:值越低越靠「好」的一端
+        return pixelLo + t * (pixelHi - pixelLo);
+    };
+    return { ticks, scale };
+}
+export function MetricScatter({ data, pointHref, className, locale = DEFAULT_REPORT_LOCALE, }) {
+    const missing = data.rows.filter((r) => r.x.value === null || r.y.value === null);
+    const drawableRows = data.rows.filter((r) => r.x.value !== null && r.y.value !== null);
+    const missingNote = missing.length > 0 ? (_jsx("p", { className: "nre-scatter-missing", title: missing.map((r) => r.key).join(", "), children: countText(locale, "pointsMissing", missing.length) })) : null;
+    const xLabel = resolveMetricLabel(data.x.label, locale, data.x.key);
+    const yLabel = resolveMetricLabel(data.y.label, locale, data.y.key);
+    // 0 个可画点:x/y 指标没有可用数据 —— 明确说缺哪两个指标,不画一张空坐标系
+    // (与表格的「绝不画 0」同态度)。
+    if (drawableRows.length === 0) {
+        return (_jsxs("figure", { className: cx("nre", "nre-metric-scatter", className), children: [_jsx("p", { className: "nre-scatter-empty nre-missing", children: localeText(locale, "scatter.noData", { x: xLabel, y: yLabel }) }), missingNote] }));
+    }
+    // 恰好 1 个可画点:成本 × 通过率的对比至少要两个实验,单点不成图 —— 显式说清而不是画个孤点。
+    if (drawableRows.length === 1) {
+        return (_jsxs("figure", { className: cx("nre", "nre-metric-scatter", className), children: [_jsx("p", { className: "nre-scatter-empty", children: localeText(locale, "scatter.needTwo", { x: xLabel, y: yLabel }) }), missingNote] }));
+    }
+    const axisLabel = (label, col) => `${label}${col.unit ? `(${col.unit})` : ""}`;
+    const xScale = axisScale(drawableRows.map((r) => r.x.value), data.x.better, MARGIN.left, MARGIN.left + PLOT_W);
+    // y 像素轴向下增长:better:"higher" 高值在上 → 映射到 [bottom, top];"lower" 由 axisScale 反向后同样落到上方
+    const yScale = axisScale(drawableRows.map((r) => r.y.value), data.y.better, MARGIN.top + PLOT_H, MARGIN.top);
+    const points = drawableRows.map((r) => {
+        const xValue = r.x.value;
+        const yValue = r.y.value;
+        return {
+            key: r.key,
+            series: r.series,
+            label: pointLabel(r.key),
+            xValue,
+            yValue,
+            // hover 内容:experiment(点键)+ 系列(series,CostPassRateComparison 传的是 agent 维度,
+            // 有则加一行;无系列的散点没有这行)+ 两轴 display 与 samples/total(docs/feature/reports/library.md「MetricScatter」行为清单)
+            title: `${r.key}${r.series !== undefined ? `\n${r.series}` : ""}\n${xLabel}: ${r.x.display}(${r.x.samples}/${r.x.total})\n${yLabel}: ${r.y.display}(${r.y.samples}/${r.y.total})`,
+            px: xScale.scale(xValue),
+            py: yScale.scale(yValue),
+        };
+    });
+    // 同系列的点按 x 值排序连线;无系列的点只画点不连线
+    const seriesOrder = [];
+    const bySeries = new Map();
+    for (const p of points) {
+        if (p.series === undefined)
+            continue;
+        if (!bySeries.has(p.series)) {
+            bySeries.set(p.series, []);
+            seriesOrder.push(p.series);
+        }
+        bySeries.get(p.series).push(p);
+    }
+    for (const list of bySeries.values())
+        list.sort((a, b) => a.xValue - b.xValue);
+    // 直接标签的防撞布局:靠右的点把标签锚到左侧,重叠的往下推、补 leader line
+    const positions = points.map((p) => {
+        const anchorLeft = p.px >= MARGIN.left + PLOT_W * 0.72;
+        return { cx: p.px, cy: p.py, anchorLeft, width: p.label.length * 6.4 + 10 };
+    });
+    const labelOffsets = layoutLabelOffsets(positions);
+    return (_jsxs("figure", { className: cx("nre", "nre-metric-scatter", className), children: [_jsxs("svg", { className: "nre-scatter-svg", viewBox: `0 0 ${WIDTH} ${HEIGHT}`, role: "img", "aria-label": `${axisLabel(xLabel, data.x)} × ${axisLabel(yLabel, data.y)}`, children: [_jsxs("g", { className: "nre-scatter-grid", children: [yScale.ticks.map((tick) => (_jsx("line", { x1: MARGIN.left, x2: MARGIN.left + PLOT_W, y1: yScale.scale(tick), y2: yScale.scale(tick) }, `gy${tick}`))), xScale.ticks.map((tick) => (_jsx("line", { y1: MARGIN.top, y2: MARGIN.top + PLOT_H, x1: xScale.scale(tick), x2: xScale.scale(tick) }, `gx${tick}`)))] }), _jsx("text", { className: "nre-scatter-better-hint", x: MARGIN.left + PLOT_W - 6, y: MARGIN.top + 14, textAnchor: "end", children: localeText(locale, "scatter.betterHint") }), _jsx("g", { className: "nre-scatter-axis nre-scatter-axis-y", children: yScale.ticks.map((tick) => (_jsx("text", { className: "nre-scatter-tick", x: MARGIN.left - 8, y: yScale.scale(tick) + 3, textAnchor: "end", children: formatMetricValue(tick, data.y.unit) }, `ay${tick}`))) }), _jsx("g", { className: "nre-scatter-axis nre-scatter-axis-x", children: xScale.ticks.map((tick) => (_jsx("text", { className: "nre-scatter-tick", x: xScale.scale(tick), y: MARGIN.top + PLOT_H + 16, textAnchor: "middle", children: formatMetricValue(tick, data.x.unit) }, `ax${tick}`))) }), _jsx("text", { className: "nre-scatter-xlabel", x: MARGIN.left + PLOT_W / 2, y: HEIGHT - 8, textAnchor: "middle", children: axisLabel(xLabel, data.x) }), _jsx("text", { className: "nre-scatter-ylabel", x: 14, y: MARGIN.top + PLOT_H / 2, textAnchor: "middle", transform: `rotate(-90 14 ${MARGIN.top + PLOT_H / 2})`, children: axisLabel(yLabel, data.y) }), seriesOrder.map((series) => {
+                        const list = bySeries.get(series);
+                        if (list.length < 2)
+                            return null;
+                        return (_jsx("polyline", { className: cx("nre-scatter-line", seriesClassForKey(series)), "data-series": series, points: list.map((p) => `${p.px},${p.py}`).join(" "), fill: "none" }, series));
+                    }), points.map((p, i) => {
+                        const { anchorLeft } = positions[i];
+                        const labelX = p.px + (anchorLeft ? -10 : 10);
+                        const labelY = p.py + 4 + labelOffsets[i];
+                        const group = (_jsxs("g", { className: cx("nre-scatter-point", p.series !== undefined ? seriesClassForKey(p.series) : "nre-series-none"), "data-key": p.key, children: [_jsx("title", { children: p.title }), labelOffsets[i] !== 0 && _jsx("line", { className: "nre-leader", x1: p.px, y1: p.py, x2: labelX, y2: labelY - 4 }), _jsx("circle", { className: "nre-scatter-hit", cx: p.px, cy: p.py, r: 12 }), _jsx("circle", { className: "nre-scatter-dot", cx: p.px, cy: p.py, r: 4.5 }), _jsx("text", { className: "nre-scatter-point-label", x: labelX, y: labelY, textAnchor: anchorLeft ? "end" : "start", children: p.label })] }));
+                        const row = drawableRows[i];
+                        return pointHref ? (_jsx("a", { className: "nre-scatter-point-link", href: pointHref(row), children: group }, p.key)) : (_jsx("g", { children: group }, p.key));
+                    })] }), seriesOrder.length > 0 && (_jsx("figcaption", { className: "nre-scatter-legend", children: seriesOrder.map((series) => (_jsx("span", { className: cx("nre-legend-key", "nre-key", colorClassForKey(series)), children: series }, series))) })), missingNote] }));
+}

package/dist/report/react/MetricTable.d.ts

@@ -0,0 +1,11 @@
+import type { ReactElement } from "react";
+import type { TableData } from "../types.ts";
+import type { AttemptLocator } from "../../results/locator.ts";
+import { type ReportLocale } from "../locale.ts";
+export declare function MetricTable({ data, attemptHref, filter, className, locale, }: {
+    data: TableData;
+    attemptHref?: (locator: AttemptLocator) => string;
+    filter?: boolean;
+    className?: string;
+    locale?: ReportLocale;
+}): ReactElement;

package/dist/report/react/MetricTable.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DEFAULT_REPORT_LOCALE, localeText, resolveMetricLabel } from "../locale.js";
+import { MetricCellView } from "./cell.js";
+import { colorClassForKey } from "./colors.js";
+import { cx } from "./format.js";
+/** verdict 计票 pill(「3 passed / 1 failed」):非零判定各一枚,全零如实空。 */
+function VerdictTally({ verdicts, locale, }) {
+    const kinds = ["passed", "failed", "errored", "skipped"].filter((k) => verdicts[k] > 0);
+    return (_jsxs("span", { className: "nre-verdict-tally", children: [kinds.map((kind) => (_jsxs("span", { className: cx("nre-verdict-pill", `nre-verdict-${kind}`), children: [verdicts[kind], " ", localeText(locale, `verdict.${kind}`)] }, kind))), kinds.length === 0 && _jsx("span", { className: "nre-missing", children: "\u2014" })] }));
+}
+export function MetricTable({ data, attemptHref, filter, className, locale = DEFAULT_REPORT_LOCALE, }) {
+    const hasMeta = data.rows.some((row) => row.meta !== undefined);
+    const hasModel = data.rows.some((row) => row.meta?.model !== undefined);
+    const hasVerdicts = data.rows.some((row) => row.meta?.verdicts !== undefined);
+    const table = (_jsxs("table", { className: cx("nre", "nre-metric-table", !filter && className), children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { scope: "col", className: "nre-dimension", "data-nre-sort": "", children: data.dimension }), hasMeta && hasModel && (_jsx("th", { scope: "col", className: "nre-meta-col", "data-nre-sort": "", children: localeText(locale, "table.model") })), hasMeta && (_jsx("th", { scope: "col", className: "nre-meta-col", "data-nre-sort": "", children: localeText(locale, "table.agent") })), data.columns.map((col) => (_jsxs("th", { scope: "col", className: "nre-metric-col", "data-nre-sort": "", children: [resolveMetricLabel(col.label, locale, col.key), col.unit && _jsxs("span", { className: "nre-unit", children: ["(", col.unit, ")"] }), col.better && (_jsx("span", { className: "nre-better", title: localeText(locale, col.better === "higher" ? "table.higherBetter" : "table.lowerBetter"), children: col.better === "higher" ? "↑" : "↓" }))] }, col.key))), hasVerdicts && (_jsx("th", { scope: "col", className: "nre-verdicts-col", "data-nre-sort": "", children: localeText(locale, "table.verdicts") }))] }) }), _jsx("tbody", { children: data.rows.map((row) => (_jsxs("tr", { children: [_jsxs("th", { scope: "row", className: cx("nre-row-key", "nre-key", colorClassForKey(row.key)), "data-sort-value": row.key, children: [row.key, row.meta?.evals !== undefined && (_jsxs("div", { className: "nre-row-meta-sub", children: [localeText(locale, "overview.evalsCount", { n: row.meta.evals }), row.meta.attempts !== undefined && row.meta.attempts > row.meta.evals
+                                            ? ` · ${localeText(locale, "overview.attemptsCount", { n: row.meta.attempts })}`
+                                            : "", row.meta.lastRunAt ? ` · ${localeText(locale, "latestRun", { run: row.meta.lastRunAt })}` : ""] }))] }), hasMeta && hasModel && (_jsx("td", { className: "nre-td nre-meta-cell", "data-sort-value": row.meta?.model ?? "", children: row.meta?.model ?? _jsx("span", { className: "nre-missing", children: "\u2014" }) })), hasMeta && (_jsx("td", { className: "nre-td nre-meta-cell", "data-sort-value": row.meta?.agent ?? "", children: row.meta?.agent ?? _jsx("span", { className: "nre-missing", children: "\u2014" }) })), data.columns.map((col) => {
+                            const cell = row.cells[col.key];
+                            return (_jsx("td", { className: "nre-td", "data-sort-value": cell?.value ?? "", children: cell ? (_jsx(MetricCellView, { cell: cell, attemptHref: attemptHref, locale: locale })) : (_jsx("span", { className: "nre-empty" })) }, col.key));
+                        }), hasVerdicts && (_jsx("td", { className: "nre-td nre-verdicts-cell", "data-sort-value": row.meta?.verdicts?.passed ?? "", children: row.meta?.verdicts ? (_jsx(VerdictTally, { verdicts: row.meta.verdicts, locale: locale })) : (_jsx("span", { className: "nre-missing", children: "\u2014" })) }))] }, row.key))) })] }));
+    if (!filter)
+        return table;
+    // 过滤输入框渲染在表格前(同一个 wrap 里),enhance.js 经 data-nre-filter 接管;
+    // 无 JS 时静默无功能,表格内容依旧完整。
+    return (_jsxs("div", { className: cx("nre", "nre-metric-table-wrap", className), children: [_jsx("input", { className: "nre-filter", "data-nre-filter": "", type: "search", placeholder: localeText(locale, "table.filterPlaceholder") }), table] }));
+}

package/dist/report/react/RunOverview.d.ts

@@ -0,0 +1,8 @@
+import type { ReactElement } from "react";
+import type { OverviewData } from "../types.ts";
+import { type ReportLocale } from "../locale.ts";
+export declare function RunOverview({ data, className, locale, }: {
+    data: OverviewData;
+    className?: string;
+    locale?: ReportLocale;
+}): ReactElement;

package/dist/report/react/RunOverview.js

@@ -0,0 +1,12 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DEFAULT_REPORT_LOCALE, localeText } from "../locale.js";
+import { cx, formatDurationMs, formatUSD } from "./format.js";
+export function RunOverview({ data, className, locale = DEFAULT_REPORT_LOCALE, }) {
+    const { totals } = data;
+    const missing = _jsx("span", { className: "nre-missing", children: localeText(locale, "cell.missing") });
+    // 通过率只渲染 computeCell 算好的 MetricCell,不现场重算——覆盖率角标复用
+    // MetricCellView 的缺数据/coverage 语义(缺数据 = 显式文案,绝不画 0%)
+    const { passRate } = totals;
+    const passRateNode = passRate.value === null ? (missing) : (_jsxs(_Fragment, { children: [passRate.display, passRate.samples < passRate.total && (_jsxs("sup", { className: "nre-coverage", title: localeText(locale, "cell.coverageTitle", { samples: passRate.samples, total: passRate.total }), children: [passRate.samples, "/", passRate.total] }))] }));
+    return (_jsxs("header", { className: cx("nre", "nre-overview", className), children: [_jsxs("dl", { className: "nre-kpis", children: [_jsxs("div", { className: "nre-kpi", children: [_jsx("dt", { children: localeText(locale, "overview.snapshots") }), _jsx("dd", { children: data.snapshots.length })] }), _jsxs("div", { className: "nre-kpi", children: [_jsx("dt", { children: localeText(locale, "overview.evals") }), _jsx("dd", { children: totals.evals })] }), _jsxs("div", { className: "nre-kpi", children: [_jsx("dt", { children: localeText(locale, "overview.attempts") }), _jsx("dd", { children: totals.attempts })] }), _jsxs("div", { className: "nre-kpi", children: [_jsx("dt", { children: localeText(locale, "overview.passRate") }), _jsx("dd", { children: passRateNode })] }), _jsxs("div", { className: "nre-kpi", children: [_jsx("dt", { children: localeText(locale, "overview.totalCost") }), _jsx("dd", { children: totals.costUSD === null ? missing : formatUSD(totals.costUSD) })] }), _jsxs("div", { className: "nre-kpi", children: [_jsx("dt", { children: localeText(locale, "overview.totalDuration") }), _jsx("dd", { children: formatDurationMs(totals.durationMs) })] })] }), _jsxs("p", { className: "nre-verdicts", children: [_jsxs("span", { className: "nre-verdict nre-verdict-passed", children: [localeText(locale, "verdict.passed"), " ", totals.passed] }), _jsxs("span", { className: "nre-verdict nre-verdict-failed", children: [localeText(locale, "verdict.failed"), " ", totals.failed] }), _jsxs("span", { className: "nre-verdict nre-verdict-errored", children: [localeText(locale, "verdict.errored"), " ", totals.errored] }), _jsxs("span", { className: "nre-verdict nre-verdict-skipped", children: [localeText(locale, "verdict.skipped"), " ", totals.skipped] })] }), _jsxs("p", { className: "nre-source", children: [localeText(locale, "overview.source", { n: data.snapshots.length }), data.snapshots.map((s) => (_jsxs("span", { className: "nre-source-snapshot", children: [s.experimentId, "(", s.agent, s.model ? ` · ${s.model}` : "", ")@ ", s.startedAt] }, `${s.experimentId}@${s.startedAt}`)))] }), data.warnings.length > 0 && (_jsx("ul", { className: "nre-warnings", children: data.warnings.map((w, i) => (_jsx("li", { className: "nre-warning", "data-kind": w.kind, children: w.message }, i))) }))] }));
+}

package/dist/report/react/Scoreboard.d.ts

@@ -0,0 +1,8 @@
+import type { ReactElement } from "react";
+import type { ScoreboardData } from "../types.ts";
+import { type ReportLocale } from "../locale.ts";
+export declare function Scoreboard({ data, className, locale, }: {
+    data: ScoreboardData;
+    className?: string;
+    locale?: ReportLocale;
+}): ReactElement;

package/dist/report/react/Scoreboard.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DEFAULT_REPORT_LOCALE, countText, localeText } from "../locale.js";
+import { colorClassForKey } from "./colors.js";
+import { cx } from "./format.js";
+export function Scoreboard({ data, className, locale = DEFAULT_REPORT_LOCALE, }) {
+    // 科目列 = 各行 subjects 的并集,按首次出现顺序;固定分母下各行本应一致,这里防御性合并
+    const subjectKeys = [];
+    for (const row of data.rows) {
+        for (const subject of row.subjects) {
+            if (!subjectKeys.includes(subject.key))
+                subjectKeys.push(subject.key);
+        }
+    }
+    return (_jsxs("section", { className: cx("nre", "nre-scoreboard", className), children: [_jsxs("table", { className: "nre-scoreboard-table", children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { scope: "col", className: "nre-dimension", children: data.dimension }), _jsxs("th", { scope: "col", className: "nre-total-col", children: [localeText(locale, "scoreboard.total"), _jsxs("span", { className: "nre-full-marks", children: ["/ ", data.fullMarks] })] }), subjectKeys.map((key) => (_jsx("th", { scope: "col", className: "nre-subject-col", children: key }, key)))] }) }), _jsx("tbody", { children: data.rows.map((row) => (_jsxs("tr", { children: [_jsx("th", { scope: "row", className: cx("nre-row-key", "nre-key", colorClassForKey(row.key)), children: row.key }), _jsx("td", { className: "nre-total", children: row.total.display }), subjectKeys.map((key) => {
+                                    const subject = row.subjects.find((s) => s.key === key);
+                                    if (!subject)
+                                        return _jsx("td", { className: "nre-td-empty" }, key);
+                                    return (_jsxs("td", { className: "nre-subject", children: [_jsxs("span", { className: "nre-subject-score", title: localeText(locale, "scoreboard.subjectTitle", {
+                                                    evals: subject.evals,
+                                                    earned: subject.earned,
+                                                    possible: subject.possible,
+                                                }), children: [subject.earned, "/", subject.possible] }), subject.missing > 0 && (_jsx("span", { className: "nre-subject-missing", children: countText(locale, "scoreboard.missing", subject.missing) }))] }, key));
+                                })] }, row.key))) })] }), _jsxs("p", { className: "nre-weights", children: [localeText(locale, "scoreboard.weights"), " ", data.weights.length === 0
+                        ? localeText(locale, "scoreboard.allWeights")
+                        : data.weights.map((w) => (_jsxs("span", { className: "nre-weight", children: [w.prefix, " \u00D7", w.weight] }, w.prefix))), data.weights.length > 0 && _jsx("span", { className: "nre-weight-rest", children: localeText(locale, "scoreboard.othersWeight") })] })] }));
+}

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

@@ -0,0 +1,9 @@
+import type { ReactElement } from "react";
+import type { MetricCell } from "../types.ts";
+import type { AttemptLocator } from "../../results/locator.ts";
+import { type ReportLocale } from "../locale.ts";
+export declare function MetricCellView({ cell, attemptHref, locale, }: {
+    cell: MetricCell;
+    attemptHref?: (locator: AttemptLocator) => string;
+    locale?: ReportLocale;
+}): ReactElement;

package/dist/report/react/cell.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DEFAULT_REPORT_LOCALE, localeText } from "../locale.js";
+export function MetricCellView({ cell, attemptHref, locale = DEFAULT_REPORT_LOCALE, }) {
+    // 全 null(没有任何有效样本)→ 缺数据文案,绝不画 0;total 仍如实入 title
+    if (cell.value === null) {
+        return (_jsx("span", { className: "nre-cell nre-cell-missing", children: _jsx("span", { className: "nre-missing", title: localeText(locale, "cell.noneMeasurableTitle", { total: cell.total }), children: localeText(locale, "cell.missing") }) }));
+    }
+    return (_jsxs("span", { className: "nre-cell", children: [_jsx("span", { className: "nre-value", title: localeText(locale, "cell.measuredTitle", { samples: cell.samples, total: cell.total }), children: cell.display }), cell.samples < cell.total && (_jsxs("sup", { className: "nre-coverage", title: localeText(locale, "cell.coverageTitle", { samples: cell.samples, total: cell.total }), children: [cell.samples, "/", cell.total] })), attemptHref && cell.refs && cell.refs.length > 0 && (_jsx("span", { className: "nre-refs", children: cell.refs.map((locator, i) => (_jsxs("a", { className: "nre-ref", href: attemptHref(locator), children: ["#", i + 1] }, locator))) }))] }));
+}

package/dist/report/react/chart-math.d.ts

@@ -0,0 +1,14 @@
+/** [min, max] 区间上生成 count 个左右的“整齐”刻度(Heckbert nice-numbers)。 */
+export declare function niceTicks(min: number, max: number, count?: number): number[];
+export interface LabelInput {
+    cx: number;
+    cy: number;
+    width: number;
+    /** true = 文字锚在点左侧(text-anchor: end),false = 锚在右侧(text-anchor: start)。 */
+    anchorLeft: boolean;
+}
+/**
+ * 贪心地把互相重叠的直接标签往下推开(按 y 排序、逐个查重叠再下移),点本身位置不变。
+ * 散点常见同分不同价的聚簇,这一步避免标签叠成一团糊字。
+ */
+export declare function layoutLabelOffsets(items: LabelInput[], lineHeight?: number, padX?: number): number[];

package/dist/report/react/chart-math.js

@@ -0,0 +1,68 @@
+// 通用图表数值工具:round-number 刻度生成与标签防撞布局,零依赖纯函数。
+// 从 src/view/app/lib/chart.ts 迁来(view 侧从这里 re-export),报告组件与 view 共用同一份。
+function niceNumber(range, round) {
+    if (range <= 0)
+        return 1;
+    const exponent = Math.floor(Math.log10(range));
+    const fraction = range / 10 ** exponent;
+    let niceFraction;
+    if (round) {
+        if (fraction < 1.5)
+            niceFraction = 1;
+        else if (fraction < 3)
+            niceFraction = 2;
+        else if (fraction < 7)
+            niceFraction = 5;
+        else
+            niceFraction = 10;
+    }
+    else {
+        if (fraction <= 1)
+            niceFraction = 1;
+        else if (fraction <= 2)
+            niceFraction = 2;
+        else if (fraction <= 5)
+            niceFraction = 5;
+        else
+            niceFraction = 10;
+    }
+    return niceFraction * 10 ** exponent;
+}
+/** [min, max] 区间上生成 count 个左右的“整齐”刻度(Heckbert nice-numbers)。 */
+export function niceTicks(min, max, count = 5) {
+    if (min === max) {
+        min -= 1;
+        max += 1;
+    }
+    const range = niceNumber(max - min, false);
+    const step = niceNumber(range / Math.max(1, count - 1), true);
+    const niceMin = Math.floor(min / step) * step;
+    const niceMax = Math.ceil(max / step) * step;
+    const ticks = [];
+    for (let v = niceMin; v <= niceMax + step * 0.5; v += step)
+        ticks.push(Number(v.toFixed(10)));
+    return ticks;
+}
+/**
+ * 贪心地把互相重叠的直接标签往下推开(按 y 排序、逐个查重叠再下移),点本身位置不变。
+ * 散点常见同分不同价的聚簇,这一步避免标签叠成一团糊字。
+ */
+export function layoutLabelOffsets(items, lineHeight = 14, padX = 4) {
+    const offsets = new Array(items.length).fill(0);
+    const order = [...items.keys()].sort((a, b) => items[a].cy - items[b].cy || items[a].cx - items[b].cx);
+    const placed = [];
+    for (const i of order) {
+        const it = items[i];
+        const x0 = it.anchorLeft ? it.cx - it.width : it.cx;
+        const x1 = it.anchorLeft ? it.cx : it.cx + it.width;
+        let y = it.cy;
+        let guard = 0;
+        while (guard < 40 && placed.some((p) => x0 < p.x1 + padX && x1 > p.x0 - padX && Math.abs(y - p.y) < lineHeight)) {
+            y += lineHeight;
+            guard++;
+        }
+        placed.push({ x0, x1, y });
+        offsets[i] = y - it.cy;
+    }
+    return offsets;
+}

package/dist/report/react/colors.d.ts

@@ -0,0 +1,14 @@
+/** 固定调色板(浅色主题值);下标即 nre-cN / nre-series-cN 的 N,与 styles.css 的 --nre-cN 逐个对应。 */
+export declare const NRE_PALETTE: readonly ["#2a78d6", "#1baf7a", "#eda100", "#008300", "#e34948", "#eb6834"];
+export declare const NRE_PALETTE_SIZE: 6;
+/** FNV-1a 32 位散列:输入相同永远得到相同下标,与运行顺序无关。 */
+export declare function colorIndexForKey(key: string): number;
+/** 键对应的稳定 class 名("nre-c3"),配 styles.css 的 .nre-cN 上文字色。 */
+export declare function colorClassForKey(key: string): string;
+/**
+ * 键对应的系列 class 名("nre-series-c3"):挂在 SVG 图形元素(线/点/柱/系列名)上,
+ * styles.css 用它设置 --nre-series,fill/stroke 走 var —— 深色主题下图表随之切换。
+ */
+export declare function seriesClassForKey(key: string): string;
+/** 键对应的十六进制颜色(浅色主题值);渲染面优先类名,这里只留给不经 CSS 的消费方。 */
+export declare function colorHexForKey(key: string): string;

package/dist/report/react/colors.js

@@ -0,0 +1,45 @@
+// 跨块配色一致(docs/feature/reports/architecture.md「静态网页」):
+// 系列/维度键 → 固定调色板下标,用稳定散列而不是「按出现顺序分配」。
+// 这样同一个 agent 在 scatter 的线、DeltaTable 的行、matrix 的列头永远同色,
+// 不需要 Provider、不需要手工配置,甚至不需要两个组件见过同一份数据。
+//
+// 色板与 view 统一:六色 CVD 校验色板(src/view/styles.css 的 --series-1..6),
+// 顺序不要重排。深浅两套值都住在 styles.css 的 --nre-c0..c5(light-dark()),
+// 「CSS 与 colors.ts 逐个对应」契约:NRE_PALETTE 是浅色主题那套值的拷贝,
+// 渲染面优先挂类名(nre-cN 上文字色、nre-series-cN 上图形系列色)由 CSS 上色,
+// 深色主题才能跟随;colorHexForKey 只留给「不经 CSS」的消费方。改色时两边一起改。
+/** 固定调色板(浅色主题值);下标即 nre-cN / nre-series-cN 的 N,与 styles.css 的 --nre-cN 逐个对应。 */
+export const NRE_PALETTE = [
+    "#2a78d6", // c0 蓝(dark: #3987e5)
+    "#1baf7a", // c1 绿(dark: #199e70)
+    "#eda100", // c2 琥珀(dark: #c98500)
+    "#008300", // c3 深绿(dark: #008300)
+    "#e34948", // c4 红(dark: #e66767)
+    "#eb6834", // c5 橙(dark: #d95926)
+];
+export const NRE_PALETTE_SIZE = NRE_PALETTE.length;
+/** FNV-1a 32 位散列:输入相同永远得到相同下标,与运行顺序无关。 */
+export function colorIndexForKey(key) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < key.length; i++) {
+        hash ^= key.charCodeAt(i);
+        // FNV prime 乘法,拆成移位加法保持 32 位整数运算
+        hash = (hash + ((hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24))) >>> 0;
+    }
+    return hash % NRE_PALETTE_SIZE;
+}
+/** 键对应的稳定 class 名("nre-c3"),配 styles.css 的 .nre-cN 上文字色。 */
+export function colorClassForKey(key) {
+    return `nre-c${colorIndexForKey(key)}`;
+}
+/**
+ * 键对应的系列 class 名("nre-series-c3"):挂在 SVG 图形元素(线/点/柱/系列名)上,
+ * styles.css 用它设置 --nre-series,fill/stroke 走 var —— 深色主题下图表随之切换。
+ */
+export function seriesClassForKey(key) {
+    return `nre-series-c${colorIndexForKey(key)}`;
+}
+/** 键对应的十六进制颜色(浅色主题值);渲染面优先类名,这里只留给不经 CSS 的消费方。 */
+export function colorHexForKey(key) {
+    return NRE_PALETTE[colorIndexForKey(key)];
+}

package/dist/report/react/fixtures.d.ts

@@ -0,0 +1,19 @@
+import type { AttemptListItem, DeltaData, EvalListItem, ExperimentListItem, GroupSummaryData, LineData, MatrixData, MetricColumn, OverviewData, ScatterData, ScoreboardData, TableData } from "../types.ts";
+export declare const passRateColumn: MetricColumn;
+export declare const codeLinesColumn: MetricColumn;
+export declare const costColumn: MetricColumn;
+export declare const overviewData: OverviewData;
+export declare const overviewWithCost: OverviewData;
+/** GroupSummary.data 的产物形态:eval 级折叠计票 + 旧 GroupSelector 口径的通过率(包成 MetricCell)。 */
+export declare const groupSummaryData: GroupSummaryData;
+export declare const tableData: TableData<"pass-rate" | "code-lines">;
+/** rows: "experiment" 的榜单形态:行携带 agent/model 元信息与 eval 级折叠计票。 */
+export declare const tableDataWithMeta: TableData<"pass-rate">;
+export declare const matrixData: MatrixData;
+export declare const scoreboardData: ScoreboardData;
+export declare const scatterData: ScatterData;
+export declare const lineData: LineData;
+export declare const deltaData: DeltaData<"pass-rate" | "cost">;
+export declare const attemptListItems: AttemptListItem[];
+export declare const evalListItems: EvalListItem[];
+export declare const experimentListItems: ExperimentListItem[];