niceeval 0.11.4-canary.21 → 0.12.0

package/dist/report/assets/series-encoding.d.ts

@@ -0,0 +1,36 @@
+import type { ReactNode } from "react";
+import type { SeriesVariant } from "../presentation.ts";
+/** 槽位色板下标 1..6 → CSS 变量,原样交给 fill / stroke / color。 */
+export declare function seriesColorVar(colorIndex: number): string;
+/** SVG pattern id:niceeval-series-pat-v{2|3|4}-c{1..6}。variant 1 是实心,无 pattern。 */
+export declare function seriesPatternId(colorIndex: number, variant: SeriesVariant): string;
+export declare function seriesFill(colorIndex: number, variant: SeriesVariant): string;
+/** 线型变体 → strokeDasharray;variant 1 为空串(实线)。 */
+export declare function seriesStrokeDasharray(variant: SeriesVariant): string;
+export interface SeriesMarkerShape {
+    readonly path: string;
+    readonly viewBox: string;
+}
+/** 四种 marker 形状(viewBox 0 0 12 12),变体按 docs 槽序表 1–4。 */
+export declare function seriesMarkerShape(variant: SeriesVariant): SeriesMarkerShape;
+export declare function seriesMarker(colorIndex: number, variant: SeriesVariant): {
+    readonly path: string;
+    readonly viewBox: string;
+    readonly fill: string;
+    readonly stroke: string;
+};
+/**
+ * 从 presentation.fill 反推 HTML 柱需要的系列 class。
+ * SVG 用 url(#pattern)/var();HTML 柱不能引用 SVG pattern,改挂 series-cN + fill-vN 类,
+ * 由 styles.css 用 repeating-linear-gradient 画等效图案,颜色仍走 --series 令牌。
+ */
+export declare function seriesClassesFromFill(fill: string): string;
+/** 从 color 呈现或 series 的 stroke/fill 反推 series-cN 类(图例色点回落)。 */
+export declare function seriesClassFromColorVar(color: string): string;
+/**
+ * 页内注入一次的 SVG pattern defs。
+ * 18 个 pattern(3 非实心变体 × 6 色);id 与 seriesFill() 产出的 url(#…) 对齐。
+ * 子元素直接写 var(--niceeval-color-series-N),不走 currentColor
+ * (SVG pattern 内部 currentColor 取自 pattern 自身,引用者传不进来)。
+ */
+export declare function SeriesPatternDefs(): ReactNode;

package/dist/report/assets/series-encoding.js

@@ -0,0 +1,104 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** 槽位色板下标 1..6 → CSS 变量,原样交给 fill / stroke / color。 */
+export function seriesColorVar(colorIndex) {
+    if (!Number.isInteger(colorIndex) || colorIndex < 1 || colorIndex > 6) {
+        throw new Error(`colorIndex must be an integer in [1, 6], got ${colorIndex}.`);
+    }
+    return `var(--niceeval-color-series-${colorIndex})`;
+}
+/** SVG pattern id:niceeval-series-pat-v{2|3|4}-c{1..6}。variant 1 是实心,无 pattern。 */
+export function seriesPatternId(colorIndex, variant) {
+    if (variant === 1) {
+        throw new Error("variant 1 is solid fill; it has no pattern id.");
+    }
+    return `niceeval-series-pat-v${variant}-c${colorIndex}`;
+}
+export function seriesFill(colorIndex, variant) {
+    if (variant === 1)
+        return seriesColorVar(colorIndex);
+    return `url(#${seriesPatternId(colorIndex, variant)})`;
+}
+/** 线型变体 → strokeDasharray;variant 1 为空串(实线)。 */
+export function seriesStrokeDasharray(variant) {
+    switch (variant) {
+        case 1:
+            return "";
+        case 2:
+            return "6 4";
+        case 3:
+            return "2 3";
+        case 4:
+            return "8 3 2 3";
+    }
+}
+/** 四种 marker 形状(viewBox 0 0 12 12),变体按 docs 槽序表 1–4。 */
+export function seriesMarkerShape(variant) {
+    switch (variant) {
+        case 1:
+            // 圆
+            return { path: "M6 1.5a4.5 4.5 0 1 0 0.01 0z", viewBox: "0 0 12 12" };
+        case 2:
+            // 方
+            return { path: "M2.5 2.5h7v7h-7z", viewBox: "0 0 12 12" };
+        case 3:
+            // 菱
+            return { path: "M6 1.5 10.5 6 6 10.5 1.5 6z", viewBox: "0 0 12 12" };
+        case 4:
+            // 三角
+            return { path: "M6 1.5 10.5 10.5 1.5 10.5z", viewBox: "0 0 12 12" };
+    }
+}
+export function seriesMarker(colorIndex, variant) {
+    const shape = seriesMarkerShape(variant);
+    const color = seriesColorVar(colorIndex);
+    return {
+        path: shape.path,
+        viewBox: shape.viewBox,
+        fill: color,
+        stroke: color,
+    };
+}
+/**
+ * 从 presentation.fill 反推 HTML 柱需要的系列 class。
+ * SVG 用 url(#pattern)/var();HTML 柱不能引用 SVG pattern,改挂 series-cN + fill-vN 类,
+ * 由 styles.css 用 repeating-linear-gradient 画等效图案,颜色仍走 --series 令牌。
+ */
+export function seriesClassesFromFill(fill) {
+    const pattern = /^url\(#niceeval-series-pat-v([2-4])-c([1-6])\)$/.exec(fill);
+    if (pattern) {
+        const variant = pattern[1];
+        const colorIndex = Number(pattern[2]);
+        return `niceeval-series-c${colorIndex - 1} niceeval-series-fill-v${variant}`;
+    }
+    const solid = /^var\(--niceeval-color-series-([1-6])\)$/.exec(fill);
+    if (solid) {
+        return `niceeval-series-c${Number(solid[1]) - 1}`;
+    }
+    return "niceeval-series-none";
+}
+/** 从 color 呈现或 series 的 stroke/fill 反推 series-cN 类(图例色点回落)。 */
+export function seriesClassFromColorVar(color) {
+    const solid = /^var\(--niceeval-color-series-([1-6])\)$/.exec(color);
+    if (solid)
+        return `niceeval-series-c${Number(solid[1]) - 1}`;
+    return "niceeval-series-none";
+}
+/**
+ * 页内注入一次的 SVG pattern defs。
+ * 18 个 pattern(3 非实心变体 × 6 色);id 与 seriesFill() 产出的 url(#…) 对齐。
+ * 子元素直接写 var(--niceeval-color-series-N),不走 currentColor
+ * (SVG pattern 内部 currentColor 取自 pattern 自身,引用者传不进来)。
+ */
+export function SeriesPatternDefs() {
+    const patterns = [];
+    for (let colorIndex = 1; colorIndex <= 6; colorIndex++) {
+        const color = seriesColorVar(colorIndex);
+        // v2:对角斜线
+        patterns.push(_jsxs("pattern", { id: seriesPatternId(colorIndex, 2), patternUnits: "userSpaceOnUse", width: "6", height: "6", children: [_jsx("rect", { width: "6", height: "6", fill: color, fillOpacity: 0.22 }), _jsx("path", { d: "M-1 1l2-2M0 6l6-6M5 7l2-2", stroke: color, strokeWidth: 1.4, fill: "none" })] }, `v2-c${colorIndex}`));
+        // v3:水平条纹
+        patterns.push(_jsxs("pattern", { id: seriesPatternId(colorIndex, 3), patternUnits: "userSpaceOnUse", width: "6", height: "6", children: [_jsx("rect", { width: "6", height: "6", fill: color, fillOpacity: 0.18 }), _jsx("path", { d: "M0 1.5h6M0 4.5h6", stroke: color, strokeWidth: 1.5, fill: "none" })] }, `v3-c${colorIndex}`));
+        // v4:点阵
+        patterns.push(_jsxs("pattern", { id: seriesPatternId(colorIndex, 4), patternUnits: "userSpaceOnUse", width: "6", height: "6", children: [_jsx("rect", { width: "6", height: "6", fill: color, fillOpacity: 0.16 }), _jsx("circle", { cx: "2", cy: "2", r: "1.15", fill: color }), _jsx("circle", { cx: "5", cy: "5", r: "1.15", fill: color })] }, `v4-c${colorIndex}`));
+    }
+    return (_jsx("svg", { className: "niceeval-series-defs", width: 0, height: 0, "aria-hidden": "true", focusable: "false", style: { position: "absolute", width: 0, height: 0, overflow: "hidden" }, children: _jsx("defs", { children: patterns }) }));
+}

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

@@ -6,10 +6,9 @@
 // - 聚合前按身份键去重(dedupeAttempts;missing-startedAt 不去重、如实保留、不透出警告);
 // - null ≠ 0:缺数据不编数,覆盖率经 samples/total 如实暴露;
 // - core 中立:只认 Metric / Dimension 接口,不出现具体 agent 名的分支。
-import { encodeAttemptLocator } from "../../../record/locator.js";
 import { comparabilityConfigOf, deepEqualJson } from "../../../sample/index.js";
 import { foldEvalVerdict } from "../../../shared/verdict.js";
-import { collectItems, computeCell, evalIdOf, experimentIdOf, fullEvalKey, groupItems, historicalOf, locatorOf, resolveInput, } from "../../model/aggregate.js";
+import { collectItems, computeCell, evalIdOf, experimentIdOf, fullEvalKey, groupItems, historicalOf, locatorOf, msSince, resolveInput, staleReferenceOf, } from "../../model/aggregate.js";
 import { attemptCostUSD, costUSD, durationMs, examScore, passRate, tokens, totalScore } from "../../model/metrics.js";
 import { compactAssertionSummary, primaryAssertionSummary, summaryText } from "../../../assertions/display.js";
 import { firstLine } from "../../../util.js";
@@ -68,14 +67,10 @@ async function attemptListItemOf(item) {
         costUSD: attemptCostUSD(result),
         startedAt,
         historical,
-        ...(historical ? { staleSinceMs: staleSinceMsOf(startedAt) } : {}),
+        ...(historical ? { staleSinceMs: msSince(startedAt) } : {}),
         locator: locatorOf(item),
     };
 }
-/** 一个 ISO 时刻距渲染时刻(`Date.now()`)的毫秒数,恒不小于 0。 */
-function staleSinceMsOf(startedAtIso) {
-    return Math.max(0, Date.now() - Date.parse(startedAtIso));
-}
 /**
  * 「只看新执行」开关在场的判据(docs/feature/reports/components/summaries/experiment-table.md
  * 「只看新执行」):Sample 里既没有历史执行也没有过期结论时不画开关——一个永远不改变行集的
@@ -201,16 +196,9 @@ function staleReferencesFor(experimentId, missingEvalIds, historyAttempts, ancho
     }
     const out = {};
     for (const [evalId, candidates] of candidatesByEval) {
-        const newest = candidates.reduce((a, b) => (a.result.startedAt ?? "") >= (b.result.startedAt ?? "") ? a : b);
-        const startedAt = newest.result.startedAt;
-        if (!startedAt)
-            continue; // 无时刻的 legacy 落盘算不出时距,不伪造参考
-        out[evalId] = {
-            locator: newest.locator ??
-                encodeAttemptLocator({ runId: newest.run.runId, evalId: newest.evalId, attempt: newest.result.attempt }),
-            verdict: newest.result.verdict,
-            staleSinceMs: staleSinceMsOf(startedAt),
-        };
+        const reference = staleReferenceOf(candidates);
+        if (reference)
+            out[evalId] = reference;
     }
     return out;
 }

package/dist/report/components/entity-lists/content.d.ts

@@ -1,5 +1,7 @@
 import type { TableContent } from "../../definition/cell.ts";
 import type { AttemptListItem, EvalListItem, ExperimentListItem } from "../../model/types.ts";
+/** 覆盖构成副行的 key 前缀;测试与消费方靠它把这一行从 Eval / 组行里筛出去。 */
+export declare const COVERAGE_ROW_PREFIX = "coverage:";
 export declare function experimentListContent(items: readonly ExperimentListItem[]): TableContent;
 export declare function evalListContent(items: readonly EvalListItem[]): TableContent;
 export declare function attemptListContent(items: readonly AttemptListItem[]): TableContent;

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

@@ -23,7 +23,6 @@ const HEADER = {
     verdict: localizedMessage("experimentList.status"),
     result: localizedMessage("experimentList.result"),
     score: localizedMessage("experimentList.totalScore"),
-    coverage: localizedMessage("experimentList.coverage"),
 };
 /** 原料 → 行 cells:列集外的原料丢掉,原料没覆盖的列显式填 notApplicable。 */
 function projectCells(bag, columns) {
@@ -382,13 +381,33 @@ function coverageSegments(item) {
         count: [fresh, historical, stale, notRun][i],
     }));
 }
-/** experiment 的 evalRows + missingEvalIds → 递归嵌套的 subRows。 */
+/** 覆盖构成副行的 key 前缀;测试与消费方靠它把这一行从 Eval / 组行里筛出去。 */
+export const COVERAGE_ROW_PREFIX = "coverage:";
+/**
+ * 覆盖构成副行(docs/feature/reports/components/summaries/experiment-table.md「覆盖构成」):
+ * experiment 行 subRows 的最后一条,把已知题按结论出身分成四段互斥的构成格,交给中立的
+ * `composition` 格——渲染在同一个 `record` 列位置(与 Eval / Attempt 行的判定构成、占位行的
+ * missing 格同一个槽位,三种形态各自对应不同的行语义,不是同一行的三种读法)。
+ * 它不是 Eval / 组行,没有身份(entity 是 notApplicable),不参与嵌套排序或收起判定。
+ */
+function coverageRow(item, view) {
+    const bag = {
+        entity: { kind: "notApplicable" },
+        record: { kind: "composition", segments: coverageSegments(item) },
+    };
+    return {
+        key: `${COVERAGE_ROW_PREFIX}${item.experimentId}`,
+        cells: projectCells(bag, view.columns),
+    };
+}
+/** experiment 的 evalRows + missingEvalIds → 递归嵌套的 subRows,末尾追加覆盖构成副行。 */
 function experimentSubRows(item, view) {
     const members = [
         ...item.evalRows.map((row) => ({ kind: "eval", row })),
         ...item.missingEvalIds.map((evalId) => ({ kind: "missing", evalId })),
     ];
-    return nestLevel(members, "", "", item, view);
+    const nested = nestLevel(members, "", "", item, view);
+    return members.length > 0 ? [...nested, coverageRow(item, view)] : nested;
 }
 function experimentRow(item, view) {
     const bag = {
@@ -401,9 +420,6 @@ function experimentRow(item, view) {
         tokens: measureCell(item.tokens),
         costUSD: measureCell(item.costUSD),
         record: verdictCell(item.evalVerdicts),
-        // 覆盖构成是 experiment 这一行独有的事实(experiment-table.md「覆盖构成」),Eval / Attempt /
-        // 路径段组行没有这一格——projectCells 按列集自动填 notApplicable,不额外分支。
-        coverage: { kind: "composition", segments: coverageSegments(item) },
     };
     return {
         key: item.experimentId,
@@ -423,7 +439,6 @@ function experimentColumns(composition) {
         { key: "tokens", better: "lower", header: HEADER.tokens },
         { key: "costUSD", better: "lower", header: HEADER.costUSD },
         { key: "record", header: HEADER.record },
-        { key: "coverage", header: HEADER.coverage },
     ];
 }
 /** Eval / Attempt 平铺表的列集(两张表同一份)。 */

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

@@ -25,6 +25,10 @@ export type Cell = {
     readonly counts?: VerdictCounts;
     /** 计票覆盖的 attempt 引用(有证据可下钻的计票格才携带,如稳定性矩阵)。 */
     readonly refs?: readonly AttemptLocator[];
+    /** 单判定形态历史执行的距今毫秒数;新执行时省略,不伪造 0(与 locator 格同一条纪律)。 */
+    readonly staleSinceMs?: number;
+    /** 单判定形态省略判定词、只留判定符(如对照矩阵逐格只放得下一个符号的场景)。 */
+    readonly bare?: boolean;
 } | {
     readonly kind: "score";
     readonly earned: number;

package/dist/report/definition/cell.js

@@ -40,8 +40,12 @@ export function formatCellText(cell, locale) {
             }
             if (cell.verdict !== undefined) {
                 const v = cell.verdict === "skipped" ? "skipped" : cell.verdict;
+                const stale = cell.staleSinceMs !== undefined ? ` ${formatTimeDistance(cell.staleSinceMs, loc)}` : "";
                 // 判定符与判定词同场,与 locator 格、web 面同一条纪律:单色打印下照样读得出。
-                return `${verdictMark(v)} ${localeText(loc, `verdict.${v}`)}`;
+                // bare 省略判定词,只留判定符(+ 可选时距),供逐格空间紧张的场景(如对照矩阵)使用。
+                if (cell.bare)
+                    return `${verdictMark(v)}${stale}`;
+                return `${verdictMark(v)} ${localeText(loc, `verdict.${v}`)}${stale}`;
             }
             return "—";
         }

package/dist/report/definition/primitives/chart.js

@@ -1,4 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { SeriesPatternDefs, seriesClassFromColorVar, seriesClassesFromFill, } from "../../assets/series-encoding.js";
 import { defineComponent } from "../tree.js";
 import { countText, localeText, resolveLocalizedText } from "../../model/locale.js";
 import { formatAxisTick, formatMetricValue, shortestUniqueLabels } from "../../model/format.js";
@@ -91,7 +92,8 @@ function chartFieldLabel(field, meta, locale) {
     const base = dictionary[field] ? localeText(locale, dictionary[field]) : field;
     return meta.unit ? `${base}(${meta.unit})` : base;
 }
-function seriesClass(mapped, series, point, ctx) {
+/** 解析点所属 series 句柄与下标;单系列隐式图不声明视觉身份。 */
+function seriesPresentationOf(mapped, series, point, ctx) {
     let handle;
     let index;
     if (series.byField !== undefined && point.seriesValue !== undefined) {
@@ -101,12 +103,104 @@ function seriesClass(mapped, series, point, ctx) {
     else {
         const ids = mapped.filter((item) => !item.hidden && item.byField === undefined).map((item) => item.id);
         if (ids.length < 2)
-            return "niceeval-series-none";
+            return undefined;
         handle = IMPLICIT_SERIES_HANDLE;
         index = ids.indexOf(series.id);
     }
-    const colorIndex = ctx.dimension(handle).at(index).colorIndex;
-    return colorIndex === undefined ? "niceeval-series-none" : `niceeval-series-c${colorIndex - 1}`;
+    if (index < 0)
+        return undefined;
+    return ctx.dimension(handle).at(index);
+}
+/** SVG 路径:只挂 series-cN 设 --series;pattern 由 fill 属性 / style 承载。 */
+function seriesColorClass(presentation) {
+    if (!presentation)
+        return "niceeval-series-none";
+    if (presentation.kind === "color")
+        return seriesClassFromColorVar(presentation.color);
+    if (presentation.kind !== "series")
+        return "niceeval-series-none";
+    // switch 按 mark 收窄;Fill 的 mark 是 "bar"|"area" 联合,if/|| 在部分 TS 版本下剔不干净。
+    switch (presentation.mark) {
+        case "bar":
+        case "area": {
+            // 只要色类,不要 HTML 专用的 fill-vN(SVG 用 url(#pattern))。
+            const classes = seriesClassesFromFill(presentation.fill).split(" ");
+            return classes.find((c) => c.startsWith("niceeval-series-c") || c === "niceeval-series-none") ?? "niceeval-series-none";
+        }
+        case "line":
+            return seriesClassFromColorVar(presentation.stroke);
+        case "scatter":
+            return seriesClassFromColorVar(presentation.marker.fill);
+    }
+}
+/** HTML 横向柱:色类 + fill-vN 图案类(CSS repeating-linear-gradient 等效 SVG pattern)。 */
+function seriesHtmlBarClass(presentation) {
+    if (!presentation)
+        return "niceeval-series-none";
+    if (presentation.kind === "series" && (presentation.mark === "bar" || presentation.mark === "area")) {
+        return seriesClassesFromFill(presentation.fill);
+    }
+    return seriesColorClass(presentation);
+}
+/**
+ * 作者在 `<Series line>` 上显式声明的 dashed/dotted **优先于** 页级 variant 的 strokeDasharray。
+ * 未声明时消费 LineSeriesPresentation / FillSeriesPresentation 的 strokeDasharray(空串 = 实线)。
+ */
+function resolveStrokeDasharray(series, presentation) {
+    if (series.line !== undefined)
+        return lineDash(series.line);
+    if (presentation?.kind === "series" && "strokeDasharray" in presentation) {
+        return presentation.strokeDasharray || undefined;
+    }
+    return undefined;
+}
+/** SVG 柱/面:pattern fill 必须用 style 压过 `.niceeval-chart-bar { fill: var(--series) }`。 */
+function seriesSvgFillStyle(presentation) {
+    if (presentation?.kind !== "series")
+        return undefined;
+    if (presentation.mark !== "bar" && presentation.mark !== "area")
+        return undefined;
+    if (!presentation.fill.startsWith("url("))
+        return undefined;
+    return { fill: presentation.fill };
+}
+function renderMarkerShape(presentation, px, py, colorClass, title) {
+    const marker = presentation?.kind === "series" && (presentation.mark === "scatter" || presentation.mark === "line")
+        ? presentation.marker
+        : undefined;
+    if (!marker) {
+        return (_jsx("circle", { className: cx("niceeval-chart-dot", colorClass), cx: px, cy: py, r: 4.5, children: title }));
+    }
+    // path 在 0..12 viewBox;缩放到 ~9px 并居中到 (px, py)。
+    return (_jsx("path", { className: cx("niceeval-chart-dot", colorClass), d: marker.path, transform: `translate(${px} ${py}) scale(0.75) translate(-6 -6)`, fill: marker.fill, stroke: "var(--panel)", strokeWidth: 1.6, children: title }));
+}
+function legendSwatch(presentation, mark) {
+    if (!presentation || presentation.kind !== "series") {
+        return _jsx("span", { className: cx("niceeval-chart-legend-swatch", "niceeval-series-none") });
+    }
+    // 图例方块跟 series mark 取义:柱/面用填充图案,线用 dash+marker,散点用 marker 形状。
+    if (mark === "bar" || mark === "area") {
+        const fillClass = presentation.mark === "bar" || presentation.mark === "area"
+            ? seriesClassesFromFill(presentation.fill)
+            : seriesColorClass(presentation);
+        return _jsx("span", { className: cx("niceeval-chart-legend-swatch", fillClass) });
+    }
+    if (mark === "line") {
+        // 线系图例需要 stroke + marker;presentation 可能是 line 或 scatter(by 切分后 mark 对齐)。
+        if (presentation.mark === "line") {
+            return (_jsxs("svg", { className: "niceeval-chart-legend-swatch-svg", width: "16", height: "10", "aria-hidden": "true", children: [_jsx("line", { x1: "0", y1: "5", x2: "16", y2: "5", stroke: presentation.stroke, strokeWidth: 2, strokeDasharray: presentation.strokeDasharray || undefined }), _jsx("path", { d: presentation.marker.path, transform: "translate(8 5) scale(0.55) translate(-6 -6)", fill: presentation.marker.fill })] }));
+        }
+        if (presentation.mark === "scatter") {
+            return (_jsxs("svg", { className: "niceeval-chart-legend-swatch-svg", width: "16", height: "10", "aria-hidden": "true", children: [_jsx("line", { x1: "0", y1: "5", x2: "16", y2: "5", stroke: presentation.marker.fill, strokeWidth: 2 }), _jsx("path", { d: presentation.marker.path, transform: "translate(8 5) scale(0.55) translate(-6 -6)", fill: presentation.marker.fill })] }));
+        }
+        // fill presentation 配 line mark 的退化:只画色块。
+        return _jsx("span", { className: cx("niceeval-chart-legend-swatch", seriesColorClass(presentation)) });
+    }
+    // mark === "scatter"
+    if (presentation.mark === "scatter" || presentation.mark === "line") {
+        return (_jsx("svg", { className: "niceeval-chart-legend-swatch-svg", width: "10", height: "10", "aria-hidden": "true", children: _jsx("path", { d: presentation.marker.path, transform: "translate(5 5) scale(0.7) translate(-6 -6)", fill: presentation.marker.fill }) }));
+    }
+    return _jsx("span", { className: cx("niceeval-chart-legend-swatch", seriesColorClass(presentation)) });
 }
 function metricDisplay(point, axis, meta, locale) {
     if (meta.kind === "dimension") {
@@ -129,10 +223,7 @@ function renderLegend(mapped, visible, locale, ctx) {
                     : implicitIds.indexOf(series.id);
                 const presentation = handle ? ctx.dimension(handle).at(index) : undefined;
                 const label = presentation?.label ?? (series.label ? resolveLocalizedText(series.label, locale) : series.id);
-                const colorClass = presentation?.colorIndex === undefined
-                    ? "niceeval-series-none"
-                    : `niceeval-series-c${presentation.colorIndex - 1}`;
-                return (_jsx("li", { className: cx("niceeval-chart-legend-item", colorClass), children: label }, `${series.id}:${value}`));
+                return (_jsxs("li", { className: "niceeval-chart-legend-item", children: [legendSwatch(presentation, series.mark), label] }, `${series.id}:${value}`));
             });
         }) }));
 }
@@ -142,12 +233,13 @@ function renderHorizontalBarsWeb(mapped, visible, axes, locale, ctx, options) {
     const values = entries.map(({ point }) => point.y);
     const boundMax = axes.yMeta.kind === "metric" ? axes.yMeta.bounds?.max : undefined;
     const max = boundMax !== undefined && boundMax > 0 ? boundMax : Math.max(0, ...values);
-    return (_jsxs("figure", { className: cx("niceeval-report", "niceeval-chart", "niceeval-chart--bars-horizontal", options.className), children: [_jsx("div", { className: "niceeval-chart-bars-heading", children: chartFieldLabel(axes.yField, axes.yMeta, locale) }), _jsx("ol", { className: "niceeval-chart-bars", children: entries.map(({ series, point }) => {
+    return (_jsxs("figure", { className: cx("niceeval-report", "niceeval-chart", "niceeval-chart--bars-horizontal", options.className), children: [_jsx(SeriesPatternDefs, {}), _jsx("div", { className: "niceeval-chart-bars-heading", children: chartFieldLabel(axes.yField, axes.yMeta, locale) }), _jsx("ol", { className: "niceeval-chart-bars", children: entries.map(({ series, point }) => {
                     const rawLabel = point.xLabel ?? point.pointLabel;
                     const label = labels.get(rawLabel) ?? rawLabel;
                     const display = metricDisplay(point, "y", axes.yMeta, locale);
                     const href = pointHref(point, ctx, options.pointTarget);
-                    const colorClass = seriesClass(mapped, series, point, ctx);
+                    const presentation = seriesPresentationOf(mapped, series, point, ctx);
+                    const colorClass = seriesHtmlBarClass(presentation);
                     const ratio = max > 0 ? Math.max(0, Math.min(1, point.y / max)) : 0;
                     const value = (_jsxs("span", { className: "niceeval-chart-bar-value", children: [display, point.yCell && point.yCell.samples < point.yCell.total ? (_jsxs("sup", { children: [point.yCell.samples, "/", point.yCell.total] })) : null] }));
                     return (_jsxs("li", { className: "niceeval-chart-bar-row", children: [_jsx("span", { className: "niceeval-chart-bar-label", title: rawLabel, children: label }), _jsx("span", { className: "niceeval-chart-bar-track", children: _jsx("span", { className: cx("niceeval-chart-bar-fill", colorClass), style: { width: `${ratio * 100}%` }, title: `${rawLabel}\n${axes.yField}: ${display}` }) }), href ? _jsx("a", { className: "niceeval-locator", href: href, children: value }) : value] }, `${series.id}:${point.key}`));
@@ -203,16 +295,20 @@ function renderChartWeb(mapped, axes, locale, ctx, options) {
     const labelByKey = shortestUniqueLabels(allPoints.map((p) => p.pointLabel));
     const xLabel = chartFieldLabel(axes.xField, axes.xMeta, locale);
     const yLabel = chartFieldLabel(axes.yField, axes.yMeta, locale);
-    const drawable = visible.flatMap((series) => series.points.map((point) => ({
-        ...point,
-        sourceSeriesId: series.id,
-        label: labelByKey.get(point.pointLabel) ?? point.pointLabel,
-        px: xScale.scale(point.x),
-        py: yScale.scale(point.y),
-        seriesClass: seriesClass(mapped, series, point, ctx),
-    })));
+    const drawable = visible.flatMap((series) => series.points.map((point) => {
+        const presentation = seriesPresentationOf(mapped, series, point, ctx);
+        return {
+            ...point,
+            sourceSeriesId: series.id,
+            label: labelByKey.get(point.pointLabel) ?? point.pointLabel,
+            px: xScale.scale(point.x),
+            py: yScale.scale(point.y),
+            presentation,
+            seriesClass: seriesColorClass(presentation),
+        };
+    }));
     const labels = placePointLabels(drawable.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("niceeval-report", "niceeval-chart", "niceeval-chart--scatter", options.className), children: [_jsxs("svg", { className: "niceeval-chart-svg", viewBox: `0 0 ${WIDTH} ${HEIGHT}`, role: "img", "aria-label": `${axes.xField} × ${axes.yField}`, children: [options.grid !== false ? (_jsxs("g", { className: "niceeval-chart-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}`)))] })) : null, _jsx("g", { className: "niceeval-chart-axis niceeval-chart-axis-y", children: (axes.yMeta.kind === "dimension"
+    return (_jsxs("figure", { className: cx("niceeval-report", "niceeval-chart", "niceeval-chart--scatter", options.className), children: [_jsx(SeriesPatternDefs, {}), _jsxs("svg", { className: "niceeval-chart-svg", viewBox: `0 0 ${WIDTH} ${HEIGHT}`, role: "img", "aria-label": `${axes.xField} × ${axes.yField}`, children: [options.grid !== false ? (_jsxs("g", { className: "niceeval-chart-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}`)))] })) : null, _jsx("g", { className: "niceeval-chart-axis niceeval-chart-axis-y", children: (axes.yMeta.kind === "dimension"
                             ? [...new Set(drawable.map((point) => point.y))]
                             : yScale.ticks).map((tick) => (_jsx("text", { className: "niceeval-chart-tick", x: MARGIN.left - 8, y: yScale.scale(tick) + 3, textAnchor: "end", children: axes.yMeta.kind === "dimension"
                                 ? drawable.find((point) => point.y === tick)?.yLabel
@@ -226,7 +322,8 @@ function renderChartWeb(mapped, axes, locale, ctx, options) {
                             const seriesPoints = drawable.filter((p) => p.sourceSeriesId === series.id &&
                                 (series.byField === undefined || p.seriesValue === value));
                             const ordered = series.connect ? [...seriesPoints].sort((a, b) => a.x - b.x) : seriesPoints;
-                            const seriesClass = ordered[0]?.seriesClass ?? "niceeval-series-none";
+                            const seriesClassName = ordered[0]?.seriesClass ?? "niceeval-series-none";
+                            const seriesPresentation = ordered[0]?.presentation;
                             const baseline = yScale.scale(0);
                             const barGroups = [...new Set(visible
                                     .filter((item) => item.mark === "bar")
@@ -235,11 +332,13 @@ function renderChartWeb(mapped, axes, locale, ctx, options) {
                             const groupIndex = Math.max(0, barGroups.indexOf(barGroup));
                             const totalBarWidth = Math.max(8, Math.min(48, PLOT_W / Math.max(1, allPoints.length)));
                             const barWidth = totalBarWidth / Math.max(1, barGroups.length);
-                            return (_jsxs("g", { className: cx("niceeval-chart-series", seriesClass), "data-series": `${series.id}:${value}`, children: [series.mark === "area" && ordered.length > 1 ? (_jsx("polygon", { className: "niceeval-chart-area", points: [
+                            const dash = resolveStrokeDasharray(series, seriesPresentation);
+                            const areaFillStyle = seriesSvgFillStyle(seriesPresentation);
+                            return (_jsxs("g", { className: cx("niceeval-chart-series", seriesClassName), "data-series": `${series.id}:${value}`, children: [series.mark === "area" && ordered.length > 1 ? (_jsx("polygon", { className: "niceeval-chart-area", style: areaFillStyle, points: [
                                             `${ordered[0].px},${baseline}`,
                                             ...ordered.map((point) => `${point.px},${point.py}`),
                                             `${ordered[ordered.length - 1].px},${baseline}`,
-                                        ].join(" ") })) : null, (series.mark === "line" || series.mark === "area" || series.connect) && ordered.length > 1 ? (_jsx("polyline", { className: "niceeval-chart-line", points: ordered.map((p) => `${p.px},${p.py}`).join(" "), strokeDasharray: lineDash(series.line) })) : null, ordered.map((p) => {
+                                        ].join(" ") })) : null, (series.mark === "line" || series.mark === "area" || series.connect) && ordered.length > 1 ? (_jsx("polyline", { className: "niceeval-chart-line", points: ordered.map((p) => `${p.px},${p.py}`).join(" "), strokeDasharray: dash })) : null, ordered.map((p) => {
                                         const placed = labels[drawable.indexOf(p)];
                                         const href = pointHref(p, ctx, options.pointTarget);
                                         let shape;
@@ -247,10 +346,10 @@ function renderChartWeb(mapped, axes, locale, ctx, options) {
                                             const baseValue = stackedBarBase(visible, series, p.x);
                                             const baseY = yScale.scale(baseValue);
                                             const topY = yScale.scale(baseValue + p.y);
-                                            shape = (_jsx("rect", { className: cx("niceeval-chart-bar", p.seriesClass), x: p.px - totalBarWidth / 2 + groupIndex * barWidth, y: Math.min(topY, baseY), width: barWidth, height: Math.max(1, Math.abs(baseY - topY)), children: _jsx("title", { children: `${p.pointLabel}\n${series.id}: ${metricDisplay(p, "y", axes.yMeta, locale)}` }) }));
+                                            shape = (_jsx("rect", { className: cx("niceeval-chart-bar", p.seriesClass), style: seriesSvgFillStyle(p.presentation), x: p.px - totalBarWidth / 2 + groupIndex * barWidth, y: Math.min(topY, baseY), width: barWidth, height: Math.max(1, Math.abs(baseY - topY)), children: _jsx("title", { children: `${p.pointLabel}\n${series.id}: ${metricDisplay(p, "y", axes.yMeta, locale)}` }) }));
                                         }
                                         else {
-                                            shape = (_jsx("circle", { className: cx("niceeval-chart-dot", p.seriesClass), cx: p.px, cy: p.py, r: 4.5, children: _jsx("title", { children: `${p.pointLabel}\n${axes.xField}: ${metricDisplay(p, "x", axes.xMeta, locale)}\n${axes.yField}: ${metricDisplay(p, "y", axes.yMeta, locale)}` }) }));
+                                            shape = renderMarkerShape(p.presentation, p.px, p.py, p.seriesClass, _jsx("title", { children: `${p.pointLabel}\n${axes.xField}: ${metricDisplay(p, "x", axes.xMeta, locale)}\n${axes.yField}: ${metricDisplay(p, "y", axes.yMeta, locale)}` }));
                                         }
                                         return (_jsxs("g", { className: "niceeval-chart-point", children: [href ? _jsx("a", { href: href, children: shape }) : shape, series.mark === "scatter" && placed ? (_jsx("text", { className: "niceeval-chart-point-label", x: placed.x, y: placed.y, textAnchor: placed.anchor, children: p.label })) : null] }, p.key));
                                     })] }, `${series.id}:${value}`));
@@ -480,7 +579,8 @@ export const Chart = defineComponent({
                 continue;
             decls[spec.by] = {
                 dimension: spec.by,
-                encoding: { kind: "series", mark: spec.mark === "area" ? "line" : spec.mark },
+                // area 是 FillSeriesPresentation(填充图案),不再折叠成 line。
+                encoding: { kind: "series", mark: spec.mark },
                 values,
             };
         }

package/dist/report/definition/primitives.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { COMPONENT_RAW_CHILDREN, COMPONENT_ROLE, defineComponent, } from "./tree.js";
 import { hrefForLocator } from "../components/shared.js";
 import { localeText, resolveLocalizedText } from "../model/locale.js";
@@ -586,8 +586,9 @@ function renderCellWeb(cell, ctx) {
                 return (_jsxs("span", { className: "niceeval-verdict-tally", children: [parts.map((kind) => (_jsxs("span", { className: `niceeval-verdict-${kind}`, children: [cell.counts[kind], " ", localeText(ctx.locale, `verdict.${kind === "skipped" ? "skipped" : kind}`)] }, kind))), parts.length === 0 ? _jsx("span", { className: "niceeval-missing", children: MISSING_MARK }) : null] }));
             }
             const verdict = cell.verdict ?? "skipped";
+            const stale = cell.staleSinceMs !== undefined;
             // 判定符走 verdictMark 单源,与 locator 格同一张表(errored 是 `!`,不并到 `✗`)。
-            return (_jsxs("span", { className: `niceeval-verdict niceeval-verdict-${verdict}`, children: [verdictMark(verdict === "skipped" ? "skipped" : verdict), " ", localeText(ctx.locale, `verdict.${verdict === "skipped" ? "skipped" : verdict}`)] }));
+            return (_jsxs("span", { className: cx("niceeval-verdict", `niceeval-verdict-${verdict}`, stale ? "niceeval-stale" : undefined), title: stale ? localeText(ctx.locale, "experimentList.historicalTooltip") : undefined, children: [verdictMark(verdict === "skipped" ? "skipped" : verdict), !cell.bare ? _jsxs(_Fragment, { children: [" ", localeText(ctx.locale, `verdict.${verdict === "skipped" ? "skipped" : verdict}`)] }) : null, stale ? _jsx("span", { className: "niceeval-stale-distance", children: formatTimeDistance(cell.staleSinceMs, ctx.locale) }) : null] }));
         }
         case "metric":
             return (_jsx(MetricCellView, { cell: cell.metric, href: ctx.showMeasureRefs === false ? undefined : ctx.href, locale: ctx.locale }));

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

@@ -92,8 +92,9 @@ export interface WebContext {
     /** chrome 文案的 locale;官方组件渲染面经上下文读取,宿主外默认 "en"。 */
     locale: ReportLocale;
     /**
-     * 取本组件 `dimensions()` 声明的某个句柄在这一页的呈现面(含 `seriesSlot` / 色板下标 /
-     * 形状变体)。查别的组件的句柄或没声明的句柄抛 `UndeclaredDimensionValueError`。
+     * 取本组件 `dimensions()` 声明的某个句柄在这一页的呈现面(label / color / series 的
+     * fill·stroke·marker 等可直接使用的值)。查别的组件的句柄或没声明的句柄抛
+     * `UndeclaredDimensionValueError`。
      */
     dimension(handle: string): PresentedDimension;
 }
@@ -152,6 +153,8 @@ export type ReportComponent<P extends object> = ((props: P) => ReactNode) & {
  */
 export interface PageDimensions {
     dimension(props: object, handle: string): PresentedDimension;
+    /** 维度 name → 值 → seriesSlot；测试与调试观察槽位分配，组件渲染不读槽号。 */
+    readonly slotsByDimension: ReadonlyMap<string, ReadonlyMap<string, number>>;
 }
 /** 宿主渲染前把这一页的分配结果挂到渲染上下文上(text 与 web 同一条通道)。 */
 export declare function withPageDimensions<C extends object>(ctx: C, plan: PageDimensions | undefined): C;

package/dist/report/definition/tree.js

@@ -142,6 +142,7 @@ export function collectPageDimensions(node, pins = {}, face = "web") {
     visit(node);
     const plan = allocatePageDimensions(handles, pins, { face });
     return {
+        slotsByDimension: plan.slotsByDimension,
         dimension(props, handle) {
             const entry = byProps.get(props);
             const key = entry?.keys.get(handle);

package/dist/report/index.d.ts

@@ -2,7 +2,7 @@ export { aggregate, agent, costUSD, dedupeLocators, durationMs, evalId, evidence
 export type { AggregateRow, AggregationSubject, Calculation, EvidenceRow, GroupFunction, MetricBasis, MetricFormat, MetricValue, Reducer, RollupOptions, } from "./model/calculation.ts";
 export { toAttemptAssertions, toAttemptFacts, toAttemptFixPrompt, toAttemptListRows, toAttemptNotices, toAttemptRows, toAttemptSource, toAttemptSummary, toAttemptUsage, toConversationTurns, toDiffFiles, toEvalRows, toExperimentDetails, toExperimentRows, toHeroData, toRunNotices, toSampleFixPrompt, toSampleNotices, toSummaryItems, toTimelineNodes, toTraceNodes, } from "./model/conversions.ts";
 export { presentDimension, shortestUniqueLabels } from "./presentation.ts";
-export type { DimensionDeclaration, DimensionEncoding, PresentedDimension } from "./presentation.ts";
+export type { ColorPresentation, DimensionDeclaration, DimensionEncoding, DimensionPresentation, FillSeriesPresentation, LabelPresentation, LineSeriesPresentation, PresentedDimension, ScatterSeriesPresentation, } from "./presentation.ts";
 export { flag, label, numericFlag, numericLabel, numericRunConfig, runConfig } from "./model/flag.ts";
 export { evaluationKindComposition } from "./model/evaluation-kind.ts";
 export { annotatedSourceResult, attemptDetailsResult, comparisonResult, conversationResult, diffResult, historyResult, stabilityResult, standardOverviewResult, timingResult, usageResult, } from "./tasks.ts";

package/dist/report/model/aggregate.d.ts

@@ -1,6 +1,6 @@
 import type { AttemptHandle, SampleCoverage, SampleIssue, Run } from "../../record/types.ts";
 import { type AttemptLocator } from "../../record/locator.ts";
-import type { Aggregator, DimensionInput, AttemptMetric, MetricValue, MetricColumn, NumericAxis, ReportInput, SeriesInput } from "./types.ts";
+import type { Aggregator, DimensionInput, AttemptMetric, MetricValue, MetricColumn, NumericAxis, ReportInput, SeriesInput, StaleConclusionReference } from "./types.ts";
 import { type LocalizedText } from "./locale.ts";
 import { evalPrefixPredicate } from "../../shared/aggregate.ts";
 import type { JsonValue } from "../../shared/types.ts";
@@ -41,6 +41,15 @@ export declare function evalIdOf(item: Item): string;
  * 来源可能有多个,水位基准是其中 startedAt 最新的一个。
  */
 export declare function historicalOf(item: Item): boolean;
+/** 一个 ISO 时刻距渲染时刻(`Date.now()`)的毫秒数,恒不小于 0。 */
+export declare function msSince(iso: string): number;
+/**
+ * 覆盖缺口 / 对照矩阵缺席格的「过期结论」参考(docs/feature/reports/components/summaries/
+ * experiment-table.md「覆盖缺口的两档占位行」、show/compare.md 同一套口径):候选已经是与
+ * 当前基准 configHash 不可比的那些,取其中最近一条;两个消费方(entity-lists 的占位行、
+ * DeltaTable 的缺席格)共用同一份「取最新」判据,不各自实现一遍。
+ */
+export declare function staleReferenceOf(candidates: readonly AttemptHandle[]): StaleConclusionReference | undefined;
 /** 快照键:"<experimentId> @ <startedAt>"("run" 维度与手挑快照数组的对比用)。 */
 export declare function snapshotKeyOf(run: Run): string;
 /** 一组 Item 的 eval 全身份键:experimentId + eval id(聚合中的题级身份始终是这一对)。 */