niceeval 0.9.0 → 0.10.0

package/dist/report/components/entity-lists/index.js

@@ -0,0 +1,165 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// 官方双面组件的装配点:web 面(./ExperimentList.tsx / EvalList.tsx / AttemptList.tsx 的纯
+// React 组件)+ text 面(./faces.ts)+ resolve 解析面(spec 形态由管线代调配套 ./compute.ts)。
+// FailureList 是组合组件,内部就是 attemptListData → 过滤 → AttemptList data 形态,不产生
+// 自己的 data。
+import { defineComponent } from "../../definition/tree.js";
+import { collectItems, locatorOf, resolveInput } from "../../model/aggregate.js";
+import { arrayProblem, cellProblem, isObject, makeDataComponent, hrefOf, tallyProblem, } from "../shared.js";
+import { attemptListData, evalListData, experimentListData } from "./compute.js";
+import { attemptListText, evalListText, experimentListText } from "./faces.js";
+import { AttemptList as AttemptListWeb } from "./AttemptList.js";
+import { EvalList as EvalListWeb } from "./EvalList.js";
+import { ExperimentList as ExperimentListWeb } from "./ExperimentList.js";
+/** AttemptListItem(src/report/model/types.ts):三个组件族共用的叶子形状(独立 data 或嵌套在 evalRows/attempts 里)。 */
+function attemptListItemProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be an object`;
+    if (typeof value.experimentId !== "string")
+        return `"${path}.experimentId" must be a string`;
+    if (typeof value.evalId !== "string")
+        return `"${path}.evalId" must be a string`;
+    if (typeof value.attempt !== "number")
+        return `"${path}.attempt" must be a number`;
+    if (typeof value.agent !== "string")
+        return `"${path}.agent" must be a string`;
+    if (typeof value.verdict !== "string")
+        return `"${path}.verdict" must be a string`;
+    if (!(value.failureSummary === null || typeof value.failureSummary === "string")) {
+        return `"${path}.failureSummary" must be a string or null`;
+    }
+    if (typeof value.moreFailures !== "number")
+        return `"${path}.moreFailures" must be a number`;
+    const examScoreProblem = cellProblem(value.examScore, `${path}.examScore`);
+    if (examScoreProblem !== null)
+        return examScoreProblem;
+    if (typeof value.durationMs !== "number")
+        return `"${path}.durationMs" must be a number`;
+    if (!(value.costUSD === null || typeof value.costUSD === "number"))
+        return `"${path}.costUSD" must be a number or null`;
+    if (typeof value.locator !== "string")
+        return `"${path}.locator" must be a string`;
+    return null;
+}
+export const validateExperimentListData = (data) => arrayProblem(data, "data", (item, path) => {
+    if (!isObject(item))
+        return `"${path}" must be an object`;
+    if (typeof item.experimentId !== "string")
+        return `"${path}.experimentId" must be a string`;
+    if (typeof item.agent !== "string")
+        return `"${path}.agent" must be a string`;
+    const verdictsProblem = tallyProblem(item.evalVerdicts, `${path}.evalVerdicts`);
+    if (verdictsProblem !== null)
+        return verdictsProblem;
+    const passRateProblem = cellProblem(item.endToEndPassRate, `${path}.endToEndPassRate`);
+    if (passRateProblem !== null)
+        return passRateProblem;
+    const costProblem = cellProblem(item.costUSD, `${path}.costUSD`);
+    if (costProblem !== null)
+        return costProblem;
+    const durationProblem = cellProblem(item.durationMs, `${path}.durationMs`);
+    if (durationProblem !== null)
+        return durationProblem;
+    const tokensProblem = cellProblem(item.tokens, `${path}.tokens`);
+    if (tokensProblem !== null)
+        return tokensProblem;
+    if (typeof item.evals !== "number")
+        return `"${path}.evals" must be a number`;
+    if (typeof item.attempts !== "number")
+        return `"${path}.attempts" must be a number`;
+    if (typeof item.lastRunAt !== "string")
+        return `"${path}.lastRunAt" must be a string`;
+    return arrayProblem(item.evalRows, `${path}.evalRows`, (row, rowPath) => {
+        if (!isObject(row) || typeof row.evalId !== "string") {
+            return `"${rowPath}" must be an object with a string "evalId"`;
+        }
+        const rowDurationProblem = cellProblem(row.durationMs, `${rowPath}.durationMs`);
+        if (rowDurationProblem !== null)
+            return rowDurationProblem;
+        const rowCostProblem = cellProblem(row.costUSD, `${rowPath}.costUSD`);
+        if (rowCostProblem !== null)
+            return rowCostProblem;
+        return arrayProblem(row.attempts, `${rowPath}.attempts`, attemptListItemProblem);
+    });
+});
+export const validateEvalListData = (data) => arrayProblem(data, "data", (item, path) => {
+    if (!isObject(item))
+        return `"${path}" must be an object`;
+    if (typeof item.experimentId !== "string")
+        return `"${path}.experimentId" must be a string`;
+    if (typeof item.evalId !== "string")
+        return `"${path}.evalId" must be a string`;
+    if (typeof item.verdict !== "string")
+        return `"${path}.verdict" must be a string`;
+    const examScoreProblem = cellProblem(item.examScore, `${path}.examScore`);
+    if (examScoreProblem !== null)
+        return examScoreProblem;
+    const durationProblem = cellProblem(item.durationMs, `${path}.durationMs`);
+    if (durationProblem !== null)
+        return durationProblem;
+    const costProblem = cellProblem(item.costUSD, `${path}.costUSD`);
+    if (costProblem !== null)
+        return costProblem;
+    return arrayProblem(item.attempts, `${path}.attempts`, attemptListItemProblem);
+});
+export const validateAttemptListData = (data) => arrayProblem(data, "data", attemptListItemProblem);
+/** 实验列表:每项一个 experiment,固定八列比较表 + 展开到 Eval / Attempt。 */
+export const ExperimentList = makeDataComponent({
+    name: "ExperimentList",
+    dataFnName: "experimentListData",
+    shapeName: "ExperimentListItem[]",
+    dataFn: (input) => experimentListData(input),
+    specKeys: [],
+    validate: validateExperimentListData,
+    web: (props, ctx) => (_jsx(ExperimentListWeb, { data: props.data, filter: props.filter, relativeTo: props.relativeTo, locale: props.locale ?? ctx.locale, attemptHref: hrefOf(props, ctx), className: props.className })),
+    text: (props, ctx) => experimentListText(props.data, ctx, props.relativeTo),
+});
+/** Eval 列表:每项一个 experimentId + evalId,展开到这道题的 Attempt。 */
+export const EvalList = makeDataComponent({
+    name: "EvalList",
+    dataFnName: "evalListData",
+    shapeName: "EvalListItem[]",
+    dataFn: (input) => evalListData(input),
+    specKeys: [],
+    validate: validateEvalListData,
+    web: (props, ctx) => (_jsx(EvalListWeb, { data: props.data, locale: props.locale ?? ctx.locale, attemptHref: hrefOf(props, ctx), className: props.className })),
+    text: (props, ctx) => evalListText(props.data, ctx),
+});
+/** Attempt 列表:实体列表的叶子层,每项一次 attempt 的判定、单行摘要与 locator。 */
+export const AttemptList = makeDataComponent({
+    name: "AttemptList",
+    dataFnName: "attemptListData",
+    shapeName: "AttemptListItem[]",
+    dataFn: (input) => attemptListData(input),
+    specKeys: [],
+    validate: validateAttemptListData,
+    web: (props, ctx) => (_jsx(AttemptListWeb, { data: props.data, total: props.total, filter: props.filter, locale: props.locale ?? ctx.locale, attemptHref: hrefOf(props, ctx), className: props.className })),
+    text: (props, ctx) => attemptListText(props.data, props.total, ctx),
+});
+/**
+ * 「现在有哪些失败要处理」的成品组合件:内部就是 attemptListData → 过滤 → AttemptList
+ * data 形态,与手写组合严格等价、没有私有能力(docs/feature/reports/library/entity-lists.md)。
+ * verdict ∈ failed / errored,按 attempt 开始时间降序(同刻按 locator 字典序),
+ * 截断到 limit(默认 20),total 报告截断前总数。
+ */
+export const FailureList = defineComponent(async (props, ctx) => {
+    const input = props.input ?? ctx.scope;
+    const all = await attemptListData(input);
+    // attempt 开始时间不在列表条目里(它不是列表展示字段);从同一 input 的读取面按 locator 对回。
+    const startedAtByLocator = new Map();
+    for (const item of collectItems(resolveInput(input).snapshots)) {
+        startedAtByLocator.set(locatorOf(item), item.attempt.result.startedAt ?? "");
+    }
+    const failures = all
+        .filter((item) => item.verdict === "failed" || item.verdict === "errored")
+        .sort((a, b) => {
+        const ta = startedAtByLocator.get(a.locator) ?? "";
+        const tb = startedAtByLocator.get(b.locator) ?? "";
+        if (ta !== tb)
+            return ta < tb ? 1 : -1; // 最近的失败在前
+        return a.locator < b.locator ? -1 : a.locator > b.locator ? 1 : 0;
+    });
+    const limit = props.limit ?? 20;
+    return (_jsx(AttemptList, { data: failures.slice(0, limit), total: failures.length, attemptHref: props.attemptHref, locale: props.locale, className: props.className }));
+});
+FailureList.displayName = "FailureList";

package/dist/report/{react → components}/fixtures.d.ts

@@ -1,8 +1,8 @@
-import type { AttemptListItem, DeltaData, EvalListItem, ExperimentListItem, LineData, MatrixData, MetricColumn, ScatterData, ScopeSummaryData, ScoreboardData, TableData } from "../types.ts";
+import type { AttemptListItem, DeltaData, EvalListItem, ExperimentListItem, LineData, MatrixData, MetricColumn, ScatterData, ScopeSummaryData, ScoreboardData, TableData } from "../model/types.ts";
 export declare const passRateColumn: MetricColumn;
 export declare const codeLinesColumn: MetricColumn;
 export declare const costColumn: MetricColumn;
-/** scopeSummaryData 的产物形态:两级计票恒随行,成功率与总成本是官方 MetricCell。 */
+/** scopeSummaryData 的产物形态:两级计票恒随行,通过率与总成本是官方 MetricCell。 */
 export declare const scopeSummaryData: ScopeSummaryData;
 export declare const tableData: TableData;
 export declare const matrixData: MatrixData;

package/dist/report/{react → components}/fixtures.js

@@ -6,7 +6,7 @@ const locator = (s) => s;
 export const passRateColumn = { key: "task-pass-rate", label: "pass rate", unit: "%", better: "higher" };
 export const codeLinesColumn = { key: "code-lines", label: "code lines", unit: "lines", better: "lower" };
 export const costColumn = { key: "cost", label: "cost", unit: "$", better: "lower" };
-/** scopeSummaryData 的产物形态:两级计票恒随行,成功率与总成本是官方 MetricCell。 */
+/** scopeSummaryData 的产物形态:两级计票恒随行,通过率与总成本是官方 MetricCell。 */
 export const scopeSummaryData = {
     range: { earliestStartedAt: "2026-07-01T10:00:00Z", latestStartedAt: "2026-07-01T11:30:00Z" },
     experiments: 2,

package/dist/report/{react → components/metric-views}/DeltaTable.d.ts

@@ -1,6 +1,6 @@
 import type { ReactElement } from "react";
-import type { DeltaData } from "../types.ts";
-import { type ReportLocale } from "../locale.ts";
+import type { DeltaData } from "../../model/types.ts";
+import { type ReportLocale } from "../../model/locale.ts";
 export declare function DeltaTable({ data, className, locale, }: {
     data: DeltaData;
     className?: string;

package/dist/report/{react → components/metric-views}/DeltaTable.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_REPORT_LOCALE, localeText, resolveLocalizedText, resolveMetricLabel } from "../locale.js";
-import { MetricCellView } from "./cell.js";
-import { colorClassForKey } from "./colors.js";
-import { cx } from "./format.js";
+import { DEFAULT_REPORT_LOCALE, localeText, resolveLocalizedText, resolveMetricLabel } from "../../model/locale.js";
+import { MetricCellView } from "../cell.js";
+import { colorClassForKey } from "../../assets/colors.js";
+import { cx } from "../shared.js";
 const OUTCOME_CLASS = {
     improved: "nre-delta-good",
     regressed: "nre-delta-bad",

package/dist/report/{react → components/metric-views}/MetricBars.d.ts

@@ -1,7 +1,7 @@
 import type { ReactElement } from "react";
-import type { MatrixData } from "../types.ts";
-import type { AttemptLocator } from "../../results/locator.ts";
-import { type ReportLocale } from "../locale.ts";
+import type { MatrixData } from "../../model/types.ts";
+import type { AttemptLocator } from "../../../results/locator.ts";
+import { type ReportLocale } from "../../model/locale.ts";
 export declare function MetricBars({ data, attemptHref, className, locale, }: {
     data: MatrixData;
     attemptHref?: (locator: AttemptLocator) => string;

package/dist/report/{react → components/metric-views}/MetricBars.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_REPORT_LOCALE, resolveLocalizedText, resolveMetricLabel } from "../locale.js";
-import { colorClassForKey, seriesClassForKey } from "./colors.js";
-import { cx } from "./format.js";
+import { DEFAULT_REPORT_LOCALE, resolveLocalizedText, resolveMetricLabel } from "../../model/locale.js";
+import { colorClassForKey, seriesClassForKey } from "../../assets/colors.js";
+import { cx } from "../shared.js";
 const WIDTH = 640;
 const HEIGHT = 320;
 const PLOT = { left: 16, right: WIDTH - 16, top: 28, bottom: HEIGHT - 40 };

package/dist/report/{react → components/metric-views}/MetricLine.d.ts

@@ -1,6 +1,6 @@
 import type { ReactElement } from "react";
-import type { LineData } from "../types.ts";
-import { type ReportLocale } from "../locale.ts";
+import type { LineData } from "../../model/types.ts";
+import { type ReportLocale } from "../../model/locale.ts";
 export declare function MetricLine({ data, pointHref, className, locale, }: {
     data: LineData;
     pointHref?: (row: LineData["rows"][number]) => string;

package/dist/report/{react → components/metric-views}/MetricLine.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveLocalizedText, resolveMetricLabel } from "../locale.js";
-import { seriesClassForKey } from "./colors.js";
-import { cx } from "./format.js";
+import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveLocalizedText, resolveMetricLabel } from "../../model/locale.js";
+import { colorIndicesForKeys } from "../../assets/colors.js";
+import { cx } from "../shared.js";
 const WIDTH = 640;
 const HEIGHT = 360;
 const PLOT = { left: 64, right: WIDTH - 140, top: 24, bottom: HEIGHT - 56 };
@@ -52,6 +52,9 @@ export function MetricLine({ data, pointHref, className, locale = DEFAULT_REPORT
     }
     for (const list of bySeries.values())
         list.sort((a, b) => a.xValue - b.xValue);
+    // 同图撞色消解:散列格作起点,按图例顺序线性探测空格(colors.ts 的契约注释)
+    const colorIdx = colorIndicesForKeys(seriesOrder.filter((s) => s !== ""));
+    const seriesClassOf = (series) => (series === "" ? "nre-series-none" : `nre-series-c${colorIdx.get(series) ?? 0}`);
     const xTicks = xScale.lo === xScale.hi ? [xScale.lo] : [xScale.lo, xScale.hi];
     const yTicks = yScale.lo === yScale.hi ? [yScale.lo] : [yScale.lo, yScale.hi];
     const xDisplayFor = (value) => {
@@ -64,11 +67,11 @@ export function MetricLine({ data, pointHref, className, locale = DEFAULT_REPORT
     };
     return (_jsxs("figure", { className: cx("nre", "nre-metric-line", className), children: [_jsxs("svg", { className: "nre-line-svg", viewBox: `0 0 ${WIDTH} ${HEIGHT}`, role: "img", "aria-label": `${yLabel} by ${xLabel}`, children: [_jsx("rect", { className: "nre-line-plot", x: PLOT.left, y: PLOT.top, width: PLOT.right - PLOT.left, height: PLOT.bottom - PLOT.top, fill: "none" }), _jsxs("text", { className: "nre-line-xlabel", x: (PLOT.left + PLOT.right) / 2, y: HEIGHT - 8, textAnchor: "middle", children: [xLabel, data.x.unit ? `(${data.x.unit})` : ""] }), _jsxs("text", { className: "nre-line-ylabel", x: 16, y: (PLOT.top + PLOT.bottom) / 2, textAnchor: "middle", transform: `rotate(-90 16 ${(PLOT.top + PLOT.bottom) / 2})`, children: [yLabel, data.y.unit ? `(${data.y.unit})` : ""] }), xTicks.map((v) => (_jsx("text", { className: "nre-line-tick", x: xScale.scale(v), y: PLOT.bottom + 16, textAnchor: "middle", children: xDisplayFor(v) }, `x${v}`))), yTicks.map((v) => (_jsx("text", { className: "nre-line-tick", x: PLOT.left - 6, y: yScale.scale(v) + 4, textAnchor: "end", children: yDisplayFor(v) }, `y${v}`))), seriesOrder.map((series) => {
                         const list = bySeries.get(series);
-                        const seriesClass = series === "" ? "nre-series-none" : seriesClassForKey(series);
+                        const seriesClass = seriesClassOf(series);
                         const labelAt = list.reduce((a, b) => (b.px > a.px ? b : a));
                         return (_jsxs("g", { className: cx("nre-line-series", seriesClass), "data-series": series || undefined, children: [list.length > 1 && (_jsx("polyline", { className: "nre-line-path", points: list.map((p) => `${p.px},${p.py}`).join(" "), fill: "none" })), series !== "" && (_jsx("text", { className: "nre-line-series-label", x: labelAt.px + 8, y: labelAt.py + 4, children: series }))] }, series || "(single)"));
                     }), points.map((p, i) => {
-                        const circle = (_jsx("circle", { className: cx("nre-line-point", p.series !== undefined ? seriesClassForKey(p.series) : "nre-series-none"), "data-key": p.key, cx: p.px, cy: p.py, r: 4, children: _jsx("title", { children: p.title }) }));
+                        const circle = (_jsx("circle", { className: cx("nre-line-point", p.series !== undefined ? seriesClassOf(p.series) : "nre-series-none"), "data-key": p.key, cx: p.px, cy: p.py, r: 4, children: _jsx("title", { children: p.title }) }));
                         const row = drawableRows[i];
                         return pointHref ? (_jsx("a", { className: "nre-line-point-link", href: pointHref(row), children: circle }, `${p.key}:${i}`)) : (_jsx("g", { children: circle }, `${p.key}:${i}`));
                     })] }), missingNote] }));

package/dist/report/{react → components/metric-views}/MetricMatrix.d.ts

@@ -1,7 +1,7 @@
 import type { ReactElement } from "react";
-import type { MatrixData } from "../types.ts";
-import type { AttemptLocator } from "../../results/locator.ts";
-import { type ReportLocale } from "../locale.ts";
+import type { MatrixData } from "../../model/types.ts";
+import type { AttemptLocator } from "../../../results/locator.ts";
+import { type ReportLocale } from "../../model/locale.ts";
 export declare function MetricMatrix({ data, attemptHref, className, locale, }: {
     data: MatrixData;
     attemptHref?: (locator: AttemptLocator) => string;

package/dist/report/{react → components/metric-views}/MetricMatrix.js

@@ -1,8 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_REPORT_LOCALE, resolveMetricLabel } from "../locale.js";
-import { MetricCellView } from "./cell.js";
-import { colorClassForKey } from "./colors.js";
-import { cx } from "./format.js";
+import { DEFAULT_REPORT_LOCALE, resolveMetricLabel } from "../../model/locale.js";
+import { MetricCellView } from "../cell.js";
+import { colorClassForKey } from "../../assets/colors.js";
+import { cx } from "../shared.js";
 export function MetricMatrix({ data, attemptHref, className, locale = DEFAULT_REPORT_LOCALE, }) {
     // 稀疏 cells → 首次出现顺序的行/列键 + 查找表;组件只整理形状,不碰数值
     const rowKeys = [];

package/dist/report/components/metric-views/MetricScatter.d.ts

@@ -0,0 +1,11 @@
+import type { ReactElement } from "react";
+import type { ScatterData } from "../../model/types.ts";
+import { type ReportLocale } from "../../model/locale.ts";
+export declare function MetricScatter({ data, connect, pointHref, className, locale, }: {
+    data: ScatterData;
+    /** series 内按 x 升序连折线;默认 false,只给「线 = 同族变体」的 lineage series 用。 */
+    connect?: boolean;
+    pointHref?: (row: ScatterData["rows"][number]) => string;
+    className?: string;
+    locale?: ReportLocale;
+}): ReactElement;

package/dist/report/{react → components/metric-views}/MetricScatter.js

@@ -1,12 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { formatMetricValue } from "../format.js";
-import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveLocalizedText, resolveMetricLabel } from "../locale.js";
+import { formatMetricValue } from "../../model/format.js";
+import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveLocalizedText, resolveMetricLabel } from "../../model/locale.js";
 import { niceTicks, placePointLabels } 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 };
+import { colorIndicesForKeys } from "../../assets/colors.js";
+import { cx } from "../shared.js";
+const WIDTH = 760;
+const HEIGHT = 400;
+const MARGIN = { top: 28, right: 32, bottom: 48, left: 64 };
 const PLOT_W = WIDTH - MARGIN.left - MARGIN.right;
 const PLOT_H = HEIGHT - MARGIN.top - MARGIN.bottom;
 /**
@@ -62,7 +62,7 @@ function axisScale(values, pixelLo, pixelHi, invert) {
     };
     return { ticks, scale };
 }
-export function MetricScatter({ data, pointHref, className, locale = DEFAULT_REPORT_LOCALE, }) {
+export function MetricScatter({ data, connect = false, 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;
@@ -97,31 +97,34 @@ export function MetricScatter({ data, pointHref, className, locale = DEFAULT_REP
             py: yScale.scale(yValue),
         };
     });
-    // 同系列的点按 x 值排序连线;无系列的点只画点不连线
-    const seriesOrder = [];
+    // 系列分组:图例与配色按显示键字典序;connect 时 series 内按 x 升序连折线
     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);
+        const list = bySeries.get(p.series) ?? [];
+        list.push(p);
+        bySeries.set(p.series, list);
     }
+    const seriesOrder = [...bySeries.keys()].sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
     for (const list of bySeries.values())
         list.sort((a, b) => a.xValue - b.xValue);
+    // 同图撞色消解:散列格作起点,按图例顺序线性探测空格(colors.ts 的契约注释)
+    const colorIdx = colorIndicesForKeys(seriesOrder);
+    const seriesClassOf = (series) => `nre-series-c${colorIdx.get(series) ?? 0}`;
+    const keyClassOf = (series) => `nre-c${colorIdx.get(series) ?? 0}`;
     // 直接标签的候选位择优布局:锚向、避让方向都由布局按空间决定,画布边界含边距
     const labels = placePointLabels(points.map((p) => ({ cx: p.px, cy: p.py, width: p.label.length * 6.4 + 10 })), { x0: 2, y0: 2, x1: WIDTH - 2, y1: HEIGHT - 2 });
-    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}`)))] }), showBetterHint && (_jsx("text", { className: "nre-scatter-better-hint", x: MARGIN.left + PLOT_W - 6, y: MARGIN.top + 14, textAnchor: "end", children: localeText(locale, "scatter.betterUpperRight") })), _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) => {
+    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}`)))] }), showBetterHint && (_jsx("text", { className: "nre-scatter-better-hint", x: MARGIN.left + PLOT_W - 6, y: MARGIN.top + 14, textAnchor: "end", children: localeText(locale, "scatter.betterUpperRight") })), _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) }), connect &&
+                        seriesOrder.map((series) => {
+                            const list = bySeries.get(series);
+                            if (list.length < 2)
+                                return null;
+                            return (_jsx("polyline", { className: cx("nre-scatter-line", seriesClassOf(series)), "data-series": series, points: list.map((p) => `${p.px},${p.py}`).join(" "), fill: "none" }, series));
+                        }), points.map((p, i) => {
                         const label = labels[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 }), label.leader && _jsx("line", { className: "nre-leader", x1: p.px, y1: p.py, x2: label.x, y2: label.y - 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: label.x, y: label.y, textAnchor: label.anchor, children: p.label })] }));
+                        const group = (_jsxs("g", { className: cx("nre-scatter-point", p.series !== undefined ? seriesClassOf(p.series) : "nre-series-none"), "data-key": p.key, children: [_jsx("title", { children: p.title }), label.leader && _jsx("line", { className: "nre-leader", x1: p.px, y1: p.py, x2: label.x, y2: label.y - 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: label.x, y: label.y, textAnchor: label.anchor, 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] }));
+                    })] }), seriesOrder.length > 0 && (_jsx("figcaption", { className: "nre-scatter-legend", children: seriesOrder.map((series) => (_jsx("span", { className: cx("nre-legend-key", "nre-key", keyClassOf(series)), children: series }, series))) })), missingNote] }));
 }

package/dist/report/{react → components/metric-views}/MetricTable.d.ts

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

package/dist/report/{react → components/metric-views}/MetricTable.js

@@ -1,8 +1,8 @@
 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";
+import { DEFAULT_REPORT_LOCALE, localeText, resolveMetricLabel } from "../../model/locale.js";
+import { MetricCellView } from "../cell.js";
+import { colorClassForKey } from "../../assets/colors.js";
+import { cx } from "../shared.js";
 export function MetricTable({ data, attemptHref, filter, className, locale = DEFAULT_REPORT_LOCALE, }) {
     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.rowDimension }), 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)))] }) }), _jsx("tbody", { children: data.rows.map((row) => (_jsxs("tr", { children: [_jsx("th", { scope: "row", className: cx("nre-row-key", "nre-key", colorClassForKey(row.key)), "data-sort-value": row.key, children: row.key }), data.columns.map((col) => {
                             const cell = row.cells[col.key];

package/dist/report/{react → components/metric-views}/Scoreboard.d.ts

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

package/dist/report/{react → components/metric-views}/Scoreboard.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveLocalizedText } from "../locale.js";
-import { colorClassForKey } from "./colors.js";
-import { cx } from "./format.js";
+import { DEFAULT_REPORT_LOCALE, countText, localeText, resolveLocalizedText } from "../../model/locale.js";
+import { colorClassForKey } from "../../assets/colors.js";
+import { cx } from "../shared.js";
 export function Scoreboard({ data, className, locale = DEFAULT_REPORT_LOCALE, }) {
     // 科目列 = 各行 subjects 的并集,按首次出现顺序;固定分母下各行本应一致,这里防御性合并
     const subjectKeys = [];

package/dist/report/components/metric-views/compute.d.ts

@@ -0,0 +1,89 @@
+import type { DeltaData, DeltaPair, DimensionInput, FlagPairs, LineData, MatrixData, Metric, NumericAxis, ReportInput, ScatterData, ScoreboardData, SeriesInput, TableData } from "../../model/types.ts";
+import type { JsonValue } from "../../../types.ts";
+export interface MetricTableOptions {
+    /** 行维度(内置 / 自定义 / flag() / runConfig())。 */
+    rows: DimensionInput;
+    /** 每列一个指标;非空元组,元素是静态 import 的 Metric 实例。 */
+    columns: readonly [Metric, ...Metric[]];
+    /**
+     * 初始行序:必须是 columns 中同一个 Metric 实例且声明了 better,方向随 better
+     * (「好」的一头在上),缺数据行沉底;省略时按行 key 字典序。
+     */
+    sort?: Metric;
+    /** eval id 前缀过滤,同 CLI 位置参数语义;在聚合之前收窄题集。 */
+    evals?: string | readonly string[];
+}
+export declare function metricTableData(input: ReportInput, options: MetricTableOptions): Promise<TableData>;
+export interface MetricMatrixOptions {
+    rows: DimensionInput;
+    columns: DimensionInput;
+    cell: Metric;
+    /** eval id 前缀过滤,同 CLI 位置参数语义。 */
+    evals?: string | readonly string[];
+}
+export declare function metricMatrixData(input: ReportInput, options: MetricMatrixOptions): Promise<MatrixData>;
+export interface ScoreboardOptions {
+    rows: DimensionInput;
+    /** 固定题集;eval id 必须唯一。元素引用运行时数据,类型放宽为普通数组,空数组在计算时报错。 */
+    questions: readonly string[];
+    /** 分科函数;默认与 evalGroup 维度同一条规则:取 eval id 的完整父路径,无 `/` 取完整 id。 */
+    subject?: (evalId: string) => string;
+    /** 权重按 eval id 前缀匹配,多个命中时最长前缀生效;默认 1。 */
+    weights?: Readonly<Record<string, number>>;
+    fullMarks?: number;
+    score?: Metric;
+}
+/**
+ * 固定题集分母:未跑题按 0 分计入 `notRun`,跑了但指标为 null 的题按 0 分计入 `unscorable`,
+ * 两个计数不合并——成绩单能回答「这 0 分是没去考还是考了判不了」。组件不从已观测 attempt
+ * 的并集猜分母;Scope 中题集之外的 eval 被忽略并计入 `ignoredEvals`。
+ */
+export declare function scoreboardData(input: ReportInput, options: ScoreboardOptions): Promise<ScoreboardData>;
+export interface MetricScatterOptions {
+    /** 点维度:每个点 = 该组 attempt 的聚合。 */
+    points: DimensionInput;
+    /** 决定颜色和图例归类,默认不连线(连线是呈现 prop `connect`);数组形态解析为复合维度。 */
+    series?: SeriesInput;
+    x: Metric;
+    y: Metric;
+    /** eval id 前缀过滤,同 CLI 位置参数语义。 */
+    evals?: string | readonly string[];
+}
+export declare function metricScatterData(input: ReportInput, options: MetricScatterOptions): Promise<ScatterData>;
+export interface MetricLineOptions {
+    /** x 轴:NumericAxis(numericFlag() / numericLabel() / numericRunConfig() 或自定义 of),不解析 experiment 命名。 */
+    x: NumericAxis;
+    /** 数组形态解析为复合维度。 */
+    series?: SeriesInput;
+    y: Metric;
+    /** eval id 前缀过滤,同 CLI 位置参数语义。 */
+    evals?: string | readonly string[];
+}
+/**
+ * 点身份 = (series, x):落进同一桶的全部 attempt 先在各自 experiment × eval 内 perEval 聚合,
+ * 再 acrossEvals 跨题折成该点唯一的 y——聚合顺序是 (series, x, experiment, eval),同一桶里有
+ * 多个 experiment 时它们合成一个点,不画垂直来回线。前提是 x 在同一 experiment × eval 内恒定:
+ * 自定义 NumericAxis.of() 对同一 experiment × eval 的不同 attempt 返回不同值时按完整用户反馈失败。
+ * x 为 null 的 attempt 不伪造 x 值,归入该 series 的未绘制行,组件报告未绘制数量。
+ */
+export declare function metricLineData(input: ReportInput, options: MetricLineOptions): Promise<LineData>;
+/**
+ * 按 flag 派生 A/B 对(docs/feature/reports/library/metric-views.md「DeltaTable」):
+ * 配对域 = input Scope 内删除该 flag 后可比性配置深相等(不额外按 experiment id 的目录前缀分组
+ * ——architecture.md「Scope 是默认报告的比较边界」同一条契约);a 取 baseline(缺省 = 未声明该
+ * flag),b 侧该 flag 的每个其它取值各成一对;label 自动 `<完整 a experiment id> · <flag>=<显示键>`,
+ * 排序仍按 a 的末段、再按 flag 显示键(不受完整 id 的字符串差异影响)。
+ */
+export declare function pairsByFlag(name: string, options?: {
+    baseline?: JsonValue;
+}): FlagPairs;
+export interface DeltaTableOptions {
+    /** 显式维度,必填——"baseline" 不会被猜成 experiment、agent、flag 或 snapshot 中的某一种。 */
+    by: DimensionInput;
+    /** 字面 pair 数组(自定义 label),或 pairsByFlag() 的派生声明;空数组在计算时报错。 */
+    pairs: readonly DeltaPair[] | FlagPairs;
+    metrics: readonly [Metric, ...Metric[]];
+    /** eval id 前缀过滤,同 CLI 位置参数语义。 */
+    evals?: string | readonly string[];
+}
+export declare function deltaTableData(input: ReportInput, options: DeltaTableOptions): Promise<DeltaData>;