niceeval 0.6.1 → 0.7.0

package/dist/report/components.js

@@ -1,18 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-// 官方双面组件的装配点:web 面(./react/ 的纯 React 组件)+ text 面(./text/faces.ts)
-// + 挂在组件上的 data 计算函数。faces 两键必填 —— 配对是结构义务,不是配对表;
-// MetricBars.data 就是 MetricMatrix.data(同一份矩阵数据的另一种摆法),别名显式化。
-//
-// 官方组件在宿主里自动接上证据室:web 面的 attemptHref 缺省取 ctx.attemptHref
-// (宿主注入的证据室深链);显式传 prop 可覆盖(嵌进自己应用时自定去处)。三个实体列表
-// (ExperimentList / EvalList / AttemptList)没有这个覆盖口子——它们的 locator 徽标恒经
-// ctx.attemptHref / ctx.attemptCommand,不接受 attemptHref/attemptCommand prop(docs/feature/reports/library.md
-// 「嵌入自己的 React 页面」的函数签名没有这个参数),证据室深链在这三个组件上不是可选行为。
-import { defineComponent, isHostWebContextActive } from "./tree.js";
-import { attemptListData, deltaData, evalListData, experimentListData, groupSummaryData, lineData, matrixData, overviewData, scatterData, scoreboardData, tableData, } from "./compute.js";
-import { attemptListText, barsText, deltaText, evalListText, experimentListText, groupSummaryText, lineText, matrixText, overviewText, scatterText, scoreboardText, tableText, } from "./text/faces.js";
-import { RunOverview as RunOverviewWeb } from "./react/RunOverview.js";
-import { GroupSummary as GroupSummaryWeb } from "./react/GroupSummary.js";
+import { defineComponent, isHostWebContextActive, memoFetchOf, } from "./tree.js";
+import { attemptListData, deltaTableData, evalListData, experimentComparisonData, experimentListData, metricLineData, metricMatrixData, metricScatterData, metricTableData, scopeSummaryData, scoreboardData, } from "./compute.js";
+import { collectItems, locatorOf, resolveInput } from "./aggregate.js";
+import { attemptListText, deltaText, evalListText, experimentComparisonText, experimentListText, barsText, lineText, matrixText, scatterText, scoreboardText, scopeSummaryText, tableText, } from "./text/faces.js";
+import { ScopeSummary as ScopeSummaryWeb } from "./react/ScopeSummary.js";
+import { ExperimentComparisonView } from "./react/ExperimentComparison.js";
 import { ExperimentList as ExperimentListWeb } from "./react/ExperimentList.js";
 import { EvalList as EvalListWeb } from "./react/EvalList.js";
 import { AttemptList as AttemptListWeb } from "./react/AttemptList.js";
@@ -23,110 +15,381 @@ import { Scoreboard as ScoreboardWeb } from "./react/Scoreboard.js";
 import { MetricScatter as MetricScatterWeb } from "./react/MetricScatter.js";
 import { MetricLine as MetricLineWeb } from "./react/MetricLine.js";
 import { DeltaTable as DeltaTableWeb } from "./react/DeltaTable.js";
-// ───────────────────────── 装配 ─────────────────────────
-const SCATTER_UNRESOLVED_MESSAGE = "MetricScatter received unresolved (selection-form) props outside the report host pipeline. " +
-    "Render through defineReport + niceeval show/view (or renderReportToText/renderReportToStaticHtml), " +
-    "or precompute with `await MetricScatter.data(selection, options)` and pass the result as `data`.";
-/** 渲染面(web / text)只吃已解析的数据形态;selection 形态漏解析时直说,而不是画一张空组件。 */
-function requireScatterData(props) {
-    if (props.data === undefined)
-        throw new Error(SCATTER_UNRESOLVED_MESSAGE);
-    return props.data;
+// ───────────────────────── data 结构校验(版本漂移防线)─────────────────────────
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-/** 页头 KPI 条:何时跑的、几个配置、几道题、通过率、总成本;Selection 的警告随行显示在条内。 */
-export const RunOverview = Object.assign(defineComponent({
-    web: (props, ctx) => _jsx(RunOverviewWeb, { ...props, locale: props.locale ?? ctx.locale }),
-    text: ({ data }, ctx) => overviewText(data, ctx),
-}), { data: overviewData });
-RunOverview.displayName = "RunOverview";
-/**
- * 组摘要:一组 experiment(典型用法是同一 `<Section>` 内的全部 experiment)的紧凑统计——
- * 通过率(旧 GroupSelector 卡片口径)、experiment/eval/attempt 数、eval 级折叠计票、
- * 总成本、最后运行时间。
- */
-export const GroupSummary = Object.assign(defineComponent({
-    web: (props, ctx) => _jsx(GroupSummaryWeb, { ...props, locale: props.locale ?? ctx.locale }),
-    text: ({ data }, ctx) => groupSummaryText(data, ctx),
-}), { data: groupSummaryData });
-GroupSummary.displayName = "GroupSummary";
-/**
- * 实验列表:每项一个 experiment,固定展示身份、配置(flags)、Eval 判定构成和官方两级聚合
- * 汇总指标;展开到这个 experiment 的 Eval,每道题内联该题全部 Attempt 的 locator 徽标。
- * 没有 selection-form:`ExperimentList.data(selection)` 产出普通数组,过滤由报告作者对
- * 数组调用 `.filter()`。
- */
-export const ExperimentList = Object.assign(defineComponent({
-    web: (props, ctx) => _jsx(ExperimentListWeb, { ...props, locale: props.locale ?? ctx.locale, attemptHref: ctx.attemptHref }),
-    text: ({ items }, ctx) => experimentListText(items, ctx),
-}), { data: experimentListData });
-ExperimentList.displayName = "ExperimentList";
+function isCell(value) {
+    return (isObject(value) &&
+        "value" in value &&
+        "display" in value &&
+        typeof value.samples === "number" &&
+        typeof value.total === "number" &&
+        Array.isArray(value.refs));
+}
+function isTally(value) {
+    return (isObject(value) &&
+        typeof value.passed === "number" &&
+        typeof value.failed === "number" &&
+        typeof value.errored === "number" &&
+        typeof value.skipped === "number");
+}
+function dataShapeError(component, dataFnName, shape, problem) {
+    return new Error(`<${component}> received data that does not match the current ${shape} shape: ${problem}. ` +
+        `It may have been computed by a different niceeval version (component data carries no schemaVersion; the support window is same-version write and read). ` +
+        `Recompute it with ${dataFnName}() from this niceeval version, then re-render.`);
+}
+const validateTableData = (data) => {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.rowDimension !== "string")
+        return 'missing "rowDimension" (string)';
+    if (!Array.isArray(data.columns))
+        return 'missing "columns" (array)';
+    if (!Array.isArray(data.rows))
+        return 'missing "rows" (array)';
+    for (const row of data.rows) {
+        if (!isObject(row) || typeof row.key !== "string" || !isObject(row.cells)) {
+            return 'each row needs { key, cells }';
+        }
+    }
+    return null;
+};
+const validateMatrixData = (data) => {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.rowDimension !== "string" || typeof data.columnDimension !== "string") {
+        return 'missing "rowDimension" / "columnDimension" (string)';
+    }
+    if (!isObject(data.metric))
+        return 'missing "metric" (MetricColumn)';
+    if (!Array.isArray(data.cells))
+        return 'missing "cells" (array)';
+    return null;
+};
+const validateScatterData = (data) => {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.pointDimension !== "string")
+        return 'missing "pointDimension" (string)';
+    if (!isObject(data.x) || !isObject(data.y))
+        return 'missing "x" / "y" (MetricColumn)';
+    if (!Array.isArray(data.rows))
+        return 'missing "rows" (array)';
+    for (const row of data.rows) {
+        if (!isObject(row) || typeof row.key !== "string" || !isCell(row.x) || !isCell(row.y)) {
+            return "each row needs { key, x: MetricCell, y: MetricCell }";
+        }
+    }
+    return null;
+};
+const validateLineData = (data) => {
+    if (!isObject(data))
+        return "expected an object";
+    if (!isObject(data.x) || typeof data.x.key !== "string")
+        return 'missing "x" axis descriptor';
+    if (!isObject(data.y))
+        return 'missing "y" (MetricColumn)';
+    if (!Array.isArray(data.rows))
+        return 'missing "rows" (array)';
+    return null;
+};
+const validateScoreboardData = (data) => {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.rowDimension !== "string")
+        return 'missing "rowDimension" (string)';
+    if (!Array.isArray(data.questions))
+        return 'missing "questions" (array)';
+    if (typeof data.fullMarks !== "number")
+        return 'missing "fullMarks" (number)';
+    if (typeof data.ignoredEvals !== "number")
+        return 'missing "ignoredEvals" (number)';
+    if (!Array.isArray(data.rows))
+        return 'missing "rows" (array)';
+    for (const row of data.rows) {
+        if (!isObject(row) || !isObject(row.total) || typeof row.total.notRun !== "number") {
+            return 'each row needs { key, total: { value, display, notRun, unscorable, refs }, subjects }';
+        }
+    }
+    return null;
+};
+const validateDeltaData = (data) => {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.byDimension !== "string")
+        return 'missing "byDimension" (string)';
+    if (!Array.isArray(data.columns) || !Array.isArray(data.rows))
+        return 'missing "columns" / "rows" (array)';
+    for (const row of data.rows) {
+        if (!isObject(row) || row.label === undefined || !isObject(row.a) || !isObject(row.b)) {
+            return "each row needs { key, label, a, b, cells }";
+        }
+    }
+    return null;
+};
+const validateScopeSummaryData = (data) => {
+    if (!isObject(data))
+        return "expected an object";
+    if (!isObject(data.range))
+        return 'missing "range" ({ earliestStartedAt, latestStartedAt })';
+    if (!isTally(data.evalVerdicts) || !isTally(data.attemptVerdicts)) {
+        return 'missing "evalVerdicts" / "attemptVerdicts" tallies';
+    }
+    if (!isCell(data.endToEndPassRate) || !isCell(data.totalCostUSD)) {
+        return 'missing "endToEndPassRate" / "totalCostUSD" (MetricCell)';
+    }
+    return null;
+};
+const validateComparisonData = (data) => {
+    if (!isObject(data))
+        return "expected an object";
+    if (!Array.isArray(data.groups))
+        return 'missing "groups" (array)';
+    for (const group of data.groups) {
+        if (!isObject(group) || typeof group.key !== "string" || validateScopeSummaryData(group.summary) !== null) {
+            return "each group needs { key, summary, scatter, experiments }";
+        }
+    }
+    return null;
+};
+const validateExperimentListData = (data) => {
+    if (!Array.isArray(data))
+        return "expected an array of ExperimentListItem";
+    for (const item of data) {
+        if (!isObject(item) || typeof item.experimentId !== "string" || !isTally(item.evalVerdicts) || !isCell(item.endToEndPassRate)) {
+            return "each item needs { experimentId, evalVerdicts, endToEndPassRate, costUSD, durationMs, tokens, evalRows, … }";
+        }
+    }
+    return null;
+};
+const validateEvalListData = (data) => {
+    if (!Array.isArray(data))
+        return "expected an array of EvalListItem";
+    for (const item of data) {
+        if (!isObject(item) || typeof item.evalId !== "string" || !isCell(item.examScore) || !Array.isArray(item.attempts)) {
+            return "each item needs { experimentId, evalId, verdict, examScore, durationMs, costUSD, attempts }";
+        }
+    }
+    return null;
+};
+const validateAttemptListData = (data) => {
+    if (!Array.isArray(data))
+        return "expected an array of AttemptListItem";
+    for (const item of data) {
+        if (!isObject(item) || typeof item.evalId !== "string" || !("failureSummary" in item) || !("costUSD" in item)) {
+            return "each item needs { experimentId, evalId, verdict, failureSummary, moreFailures, examScore, durationMs, costUSD, locator }";
+        }
+    }
+    return null;
+};
+function makeDataComponent(def) {
+    const assertData = (data) => {
+        const problem = def.validate(data);
+        if (problem !== null)
+            throw dataShapeError(def.name, def.dataFnName, def.shapeName, problem);
+        return data;
+    };
+    const resolve = async (props, ctx) => {
+        const givenSpec = def.specKeys.filter((key) => props[key] !== undefined);
+        if (props.data !== undefined) {
+            if (givenSpec.length > 0 || props.input !== undefined) {
+                const extras = [...givenSpec, ...(props.input !== undefined ? ["input"] : [])];
+                throw new Error(`<${def.name}> got both \`data\` and spec field${extras.length > 1 ? "s" : ""} (${extras.join(", ")}) — the two data sources are exclusive and niceeval will not silently pick one. ` +
+                    `Keep \`data\` (precomputed with ${def.dataFnName}()) and drop the spec fields, or drop \`data\` and let the pipeline compute from the spec.`);
+            }
+            assertData(props.data);
+            return props;
+        }
+        const options = {};
+        for (const key of givenSpec)
+            options[key] = props[key];
+        const input = props.input ?? ctx.input;
+        const data = await memoFetchOf(ctx)(def.dataFn, input, options, () => def.dataFn(input, options));
+        const rest = { ...props };
+        delete rest.input;
+        for (const key of def.specKeys)
+            delete rest[key];
+        return { ...rest, data };
+    };
+    const component = defineComponent({
+        resolve,
+        web: (props, ctx) => {
+            assertData(props.data);
+            return def.web(props, ctx);
+        },
+        text: (props, ctx) => {
+            assertData(props.data);
+            return def.text(props, ctx);
+        },
+    });
+    component.displayName = def.name;
+    return component;
+}
+/** 宿主内缺省接证据室,显式 prop 覆盖;宿主外不传 attemptHref 就是纯展示。 */
+function hrefOf(props, ctx) {
+    return props.attemptHref ?? (isHostWebContextActive() ? ctx.attemptHref : undefined);
+}
+/** 范围摘要卡:时间窗、数量、两级计票、端到端成功率与总成本。 */
+export const ScopeSummary = makeDataComponent({
+    name: "ScopeSummary",
+    dataFnName: "scopeSummaryData",
+    shapeName: "ScopeSummaryData",
+    dataFn: (input) => scopeSummaryData(input),
+    specKeys: [],
+    validate: validateScopeSummaryData,
+    web: (props, ctx) => _jsx(ScopeSummaryWeb, { ...props, locale: props.locale ?? ctx.locale }),
+    text: (props, ctx) => scopeSummaryText(props.data, props.votes ?? "eval", ctx),
+});
 /**
- * Eval 列表:每项一个 `experimentId + evalId`,固定展示判定、Attempt 数、分数、成本、耗时
- * 与失败原因;展开到这道题的 Attempt(与 AttemptList 同一份 AttemptListItem)。
+ * 内建报告的默认组合件:先把 input 按可比组分区,再为每组分别计算 ScopeSummary、
+ * 成本 × 端到端成功率散点和 ExperimentList。web 面持有完整组索引并一次聚焦一组;
+ * text 面命中多个组时只显示组索引与可执行的单组查看命令,命中单组时才输出完整散点与列表。
  */
-export const EvalList = Object.assign(defineComponent({
-    web: (props, ctx) => _jsx(EvalListWeb, { ...props, locale: props.locale ?? ctx.locale, attemptHref: ctx.attemptHref }),
-    text: ({ items }, ctx) => evalListText(items, ctx),
-}), { data: evalListData });
-EvalList.displayName = "EvalList";
+export const ExperimentComparison = makeDataComponent({
+    name: "ExperimentComparison",
+    dataFnName: "experimentComparisonData",
+    shapeName: "ExperimentComparisonData",
+    dataFn: (input) => experimentComparisonData(input),
+    specKeys: [],
+    validate: validateComparisonData,
+    web: (props, ctx) => (_jsx(ExperimentComparisonView, { data: props.data, locale: props.locale ?? ctx.locale, className: props.className, attemptHref: isHostWebContextActive() ? ctx.attemptHref : undefined })),
+    text: (props, ctx) => experimentComparisonText(props.data, props.className, ctx),
+});
+/** 实验列表:每项一个 experiment,固定八列比较表 + 展开到 Eval / Attempt。 */
+export const ExperimentList = makeDataComponent({
+    name: "ExperimentList",
+    dataFnName: "experimentListData",
+    shapeName: "ExperimentListItem[]",
+    dataFn: (input, options) => experimentListData(input, options),
+    specKeys: ["redact"],
+    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) ?? ctx.attemptHref, 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, options) => evalListData(input, options),
+    specKeys: ["redact"],
+    validate: validateEvalListData,
+    web: (props, ctx) => (_jsx(EvalListWeb, { data: props.data, locale: props.locale ?? ctx.locale, attemptHref: hrefOf(props, ctx) ?? ctx.attemptHref, 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, options) => attemptListData(input, options),
+    specKeys: ["redact"],
+    validate: validateAttemptListData,
+    web: (props, ctx) => (_jsx(AttemptListWeb, { data: props.data, total: props.total, locale: props.locale ?? ctx.locale, attemptHref: hrefOf(props, ctx) ?? ctx.attemptHref, className: props.className })),
+    text: (props, ctx) => attemptListText(props.data, props.total, ctx),
+});
 /**
- * Attempt 列表:实体列表的叶子层,每项一个 Attempt,固定展示判定、断言、error、Judge 评语
- * (assertions 的 detail/evidence)与证据引用(locator)。它不预设只看失败;
- * 报告作者过滤 `AttemptListItem[]`、用 `.slice()` 限量,`total` 让渲染面如实报告剩余数量。
+ * 「现在有哪些失败要处理」的成品组合件:内部就是 attemptListData → 过滤 → AttemptList
+ * data 形态,与手写组合严格等价、没有私有能力(docs/feature/reports/library/entity-lists.md)。
+ * verdict ∈ failed / errored,按 attempt 开始时间降序(同刻按 locator 字典序),
+ * 截断到 limit(默认 20),total 报告截断前总数。
  */
-export const AttemptList = Object.assign(defineComponent({
-    web: (props, ctx) => _jsx(AttemptListWeb, { ...props, locale: props.locale ?? ctx.locale, attemptHref: ctx.attemptHref }),
-    text: ({ items, total }, ctx) => attemptListText(items, total, ctx),
-}), { data: attemptListData });
-AttemptList.displayName = "AttemptList";
+export const FailureList = defineComponent(async (props, ctx) => {
+    const input = props.input ?? ctx.scope;
+    const all = await attemptListData(input, props.redact !== undefined ? { redact: props.redact } : undefined);
+    // 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";
 /** 榜单:一行一个维度值、一列一个指标,回答「谁整体更好」。 */
-export const MetricTable = Object.assign(defineComponent({
-    web: (props, ctx) => (_jsx(MetricTableWeb, { ...props, locale: props.locale ?? ctx.locale, attemptHref: props.attemptHref ?? (isHostWebContextActive() ? ctx.attemptHref : undefined) })),
-    text: ({ data }, ctx) => tableText(data, ctx),
-}), { data: tableData });
-MetricTable.displayName = "MetricTable";
+export const MetricTable = makeDataComponent({
+    name: "MetricTable",
+    dataFnName: "metricTableData",
+    shapeName: "TableData",
+    dataFn: metricTableData,
+    specKeys: ["rows", "columns", "sort", "evals"],
+    validate: validateTableData,
+    web: (props, ctx) => (_jsx(MetricTableWeb, { data: props.data, filter: props.filter, locale: props.locale ?? ctx.locale, attemptHref: hrefOf(props, ctx), className: props.className })),
+    text: (props, ctx) => tableText(props.data, ctx),
+});
 /** 逐题格子:行 × 列两个维度、格子里一个指标,回答「哪道题谁挂了」。 */
-export const MetricMatrix = Object.assign(defineComponent({
-    web: (props, ctx) => (_jsx(MetricMatrixWeb, { ...props, locale: props.locale ?? ctx.locale, attemptHref: props.attemptHref ?? (isHostWebContextActive() ? ctx.attemptHref : undefined) })),
-    text: ({ data }, ctx) => matrixText(data, ctx),
-}), { data: matrixData });
-MetricMatrix.displayName = "MetricMatrix";
-/** 分组条形:同一份矩阵数据的另一种摆法;MetricBars.data 就是 MetricMatrix.data 的别名。 */
-export const MetricBars = Object.assign(defineComponent({
-    web: (props, ctx) => (_jsx(MetricBarsWeb, { ...props, locale: props.locale ?? ctx.locale, attemptHref: props.attemptHref ?? (isHostWebContextActive() ? ctx.attemptHref : undefined) })),
-    text: ({ data }) => barsText(data),
-}), { data: matrixData });
-MetricBars.displayName = "MetricBars";
-/** 考试成绩单:总分 + 分科小计,固定分母、missing 如实报。 */
-export const Scoreboard = Object.assign(defineComponent({
-    web: (props, ctx) => _jsx(ScoreboardWeb, { ...props, locale: props.locale ?? ctx.locale }),
-    text: ({ data }, ctx) => scoreboardText(data, ctx),
-}), { data: scoreboardData });
-Scoreboard.displayName = "Scoreboard";
-/** 质量 × 成本 frontier:每个点一个配置、两个指标各占一轴,「好」的角落恒在右上。 */
-export const MetricScatter = Object.assign(defineComponent({
-    resolve: async (props) => {
-        if ("data" in props && props.data !== undefined)
-            return props;
-        const { selection, points, series, x, y, ...rest } = props;
-        return { ...rest, data: await scatterData(selection, { points, series, x, y }) };
-    },
-    web: (props, ctx) => {
-        requireScatterData(props);
-        return _jsx(MetricScatterWeb, { ...props, locale: props.locale ?? ctx.locale });
-    },
-    text: (props, ctx) => scatterText(requireScatterData(props), ctx),
-}), { data: scatterData });
-MetricScatter.displayName = "MetricScatter";
-/** 趋势线:x 是 experiment 声明的 flag(flag()),同系列按 x 排序连线。 */
-export const MetricLine = Object.assign(defineComponent({
-    web: (props, ctx) => _jsx(MetricLineWeb, { ...props, locale: props.locale ?? ctx.locale }),
-    text: ({ data }, ctx) => lineText(data, ctx),
-}), { data: lineData });
-MetricLine.displayName = "MetricLine";
-/** 成对对比:每行一对配置、格子里 A、B、Δ 三个值,涨跌好坏由 better 判定。 */
-export const DeltaTable = Object.assign(defineComponent({
-    web: (props, ctx) => _jsx(DeltaTableWeb, { ...props, locale: props.locale ?? ctx.locale }),
-    text: ({ data }, ctx) => deltaText(data, ctx),
-}), { data: deltaData });
-DeltaTable.displayName = "DeltaTable";
+export const MetricMatrix = makeDataComponent({
+    name: "MetricMatrix",
+    dataFnName: "metricMatrixData",
+    shapeName: "MatrixData",
+    dataFn: metricMatrixData,
+    specKeys: ["rows", "columns", "cell", "evals"],
+    validate: validateMatrixData,
+    web: (props, ctx) => (_jsx(MetricMatrixWeb, { data: props.data, locale: props.locale ?? ctx.locale, attemptHref: hrefOf(props, ctx), className: props.className })),
+    text: (props, ctx) => matrixText(props.data, ctx),
+});
+/** 分组条形:同一份矩阵数据的另一种摆法;与 MetricMatrix 写同一份 spec 时只计算一次。 */
+export const MetricBars = makeDataComponent({
+    name: "MetricBars",
+    dataFnName: "metricMatrixData",
+    shapeName: "MatrixData",
+    dataFn: metricMatrixData,
+    specKeys: ["rows", "columns", "cell", "evals"],
+    validate: validateMatrixData,
+    web: (props, ctx) => (_jsx(MetricBarsWeb, { data: props.data, locale: props.locale ?? ctx.locale, attemptHref: hrefOf(props, ctx), className: props.className })),
+    text: (props, ctx) => barsText(props.data, ctx),
+});
+/** 考试成绩单:总分 + 分科小计,固定分母、notRun / unscorable 分开如实报。 */
+export const Scoreboard = makeDataComponent({
+    name: "Scoreboard",
+    dataFnName: "scoreboardData",
+    shapeName: "ScoreboardData",
+    dataFn: scoreboardData,
+    specKeys: ["rows", "questions", "subject", "weights", "fullMarks", "score"],
+    validate: validateScoreboardData,
+    web: (props, ctx) => _jsx(ScoreboardWeb, { data: props.data, locale: props.locale ?? ctx.locale, className: props.className }),
+    text: (props, ctx) => scoreboardText(props.data, ctx),
+});
+/** 两个指标之间的取舍:每个点一个维度值,x / y 各一个指标,series 只决定颜色和分组。 */
+export const MetricScatter = makeDataComponent({
+    name: "MetricScatter",
+    dataFnName: "metricScatterData",
+    shapeName: "ScatterData",
+    dataFn: metricScatterData,
+    specKeys: ["points", "series", "x", "y", "evals"],
+    validate: validateScatterData,
+    web: (props, ctx) => (_jsx(MetricScatterWeb, { data: props.data, pointHref: props.pointHref, locale: props.locale ?? ctx.locale, className: props.className })),
+    text: (props, ctx) => scatterText(props.data, ctx),
+});
+/** 趋势线:x 是 NumericAxis(参数轴),点身份 = (series, x)。 */
+export const MetricLine = makeDataComponent({
+    name: "MetricLine",
+    dataFnName: "metricLineData",
+    shapeName: "LineData",
+    dataFn: metricLineData,
+    specKeys: ["x", "series", "y", "evals"],
+    validate: validateLineData,
+    web: (props, ctx) => (_jsx(MetricLineWeb, { data: props.data, pointHref: props.pointHref, locale: props.locale ?? ctx.locale, className: props.className })),
+    text: (props, ctx) => lineText(props.data, ctx),
+});
+/** 成对对比:每行一对(字面声明或 pairsByFlag 派生),格子里 A、B、Δ 三个值。 */
+export const DeltaTable = makeDataComponent({
+    name: "DeltaTable",
+    dataFnName: "deltaTableData",
+    shapeName: "DeltaData",
+    dataFn: deltaTableData,
+    specKeys: ["by", "pairs", "metrics", "evals"],
+    validate: validateDeltaData,
+    web: (props, ctx) => _jsx(DeltaTableWeb, { data: props.data, locale: props.locale ?? ctx.locale, className: props.className }),
+    text: (props, ctx) => deltaText(props.data, ctx),
+});