niceeval 0.9.0 → 0.10.0

package/src/view/view-report.test.ts

@@ -1,8 +1,8 @@
 // cases: docs/engineering/unit-tests/reports/cases.md
 // niceeval view 的报告槽与宿主组合语义(docs/feature/reports/architecture.md「Selection 是计算入口」
-// 与裁决记录 6;公开行为准绳 docs-site/zh/how-to/viewing-results.mdx / custom-reports.mdx)。
+// 与裁决记录 6;公开行为准绳 docs-site/zh/tutorials/viewing-results.mdx / custom-reports.mdx)。
 // 覆盖:
-// - 组合语义与 show 对齐:位置前缀收窄报告槽 Scope、--experiment 过滤、匹配不到直说;
+// - 组合语义与 show 对齐:位置前缀收窄报告槽 Scope、--exp 过滤、匹配不到直说;
 // - 输入语义:位置参数只表示 eval id 前缀(不随文件系统状态改变),结果根走 --results,
 //   单开一份快照走 --snapshot(文件不可读时失败);
 // - 报告槽恒在:裸跑填充内建报告,--report 整槽替换;en / zh-CN 双语各渲染一遍;
@@ -13,7 +13,7 @@
 // fixture 直接写新布局(<expDir>/<snapDir>/snapshot.json + <evalId>/a<n>/result.json),
 // 依据是 docs/feature/results/architecture.md 的稳定磁盘契约,不经 writer 运行时 API。
 
-import { mkdir, mkdtemp, readFile, rm, utimes, writeFile } from "node:fs/promises";
+import { mkdir, mkdtemp, readdir, readFile, rm, utimes, writeFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, resolve } from "node:path";
@@ -21,11 +21,12 @@ import { afterEach, describe, expect, it } from "vitest";
 // dist-sourced: this must be the exact class loadViewScan()/data.ts's loadReportFile() throws
 // (see src/view/data.ts's comment) — a raw-src import would be a structurally-identical but
 // `instanceof`-incompatible class.
-import { ReportLoadError } from "../../dist/report/load.js";
+import { ReportLoadError } from "../../dist/report/runtime/load.js";
 import { ViewInputError, loadViewScan, type ViewScan } from "./data.ts";
 import { renderHtml } from "./site.ts";
 import { buildView, resolveViewInput } from "./index.ts";
 import { runShow } from "../show/index.ts";
+import { createResultsWriter } from "../results/index.ts";
 import { RESULTS_FORMAT, RESULTS_SCHEMA_VERSION, type EvalResult, type Verdict } from "../types.ts";
 
 const EXAM_REPORT = resolve(__dirname, "../../test/fixtures/report/exam-report.tsx");
@@ -162,10 +163,9 @@ function bareReportHtml(scan: ViewScan): { en: string; "zh-CN": string } {
 // ───────────────────────── 组合语义(与 show 对齐) ─────────────────────────
 
 describe("loadViewScan · 组合语义", () => {
-  it("位置前缀收窄对全部页生效(含内建 Attempts 页);attempt 详情路由对完整结果根解析,被滤掉的深链仍可达", async () => {
+  it("位置前缀收窄作用在有效根上:全部页与证据室一致缩小,被滤掉的 attempt 不烘进页面数据", async () => {
     const root = await seedRoot();
     const scan = await loadViewScan(root, { patterns: ["weather"] });
-    const { viewData } = scan;
     const reportHtml = bareReportHtml(scan);
     // 报告页:两实验都只剩 weather/brooklyn 一题,范围外的失败不再出现。
     expect(reportHtml.en).toContain("compare/bub");
@@ -176,16 +176,20 @@ describe("loadViewScan · 组合语义", () => {
     expect(pageHtml(scan, "traces").en).not.toContain("fixtures/button");
     const bare = await loadViewScan(root);
     expect(pageHtml(bare, "attempts").en).toContain("fixtures/button"); // 不收窄时在场,对照
-    // attempt 详情路由不是页:viewData.snapshots 全量通道保留,被滤掉的 attempt 深链仍解析成功。
-    const filteredOut = viewData.snapshots
-      .flatMap((s) => s.results)
-      .find((r) => r.id === "fixtures/button");
-    expect(filteredOut?.locator).toBeTruthy();
-    const { resolveAttemptLocator } = await import("./app/lib/attempt-route.ts");
-    expect(resolveAttemptLocator(viewData.snapshots, filteredOut!.locator!)).toBe(filteredOut);
+    // 有效根即证据室:被滤掉的 attempt 不在 attemptsByBase / attemptPages.locators 里,
+    // 站点管线(site.ts)不会为它生成 attempt/<locator>.html。
+    const filteredOut = [...scan.attemptsByBase.values()].find((a) => a.evalId === "fixtures/button");
+    expect(filteredOut).toBeUndefined();
+    expect(scan.artifactDirs.size).toBe(
+      [...scan.artifactDirs.keys()].filter((base) => base.includes("weather/brooklyn")).length,
+    );
+    // 收窄之内、不在现刻水位的口径差异由 --exp 深链测试覆盖;不收窄时深链照常可达,对照:
+    const inBare = [...bare.attemptsByBase.values()].find((a) => a.evalId === "fixtures/button");
+    expect(inBare?.locator).toBeTruthy();
+    expect(bare.attemptPages!.locators.get(inBare!.locator!)).toBe(inBare);
   });
 
-  it("--experiment 过滤:报告槽 Selection 只留该实验", async () => {
+  it("--exp 过滤:报告槽 Selection 只留该实验", async () => {
     const root = await seedRoot();
     const reportHtml = bareReportHtml(await loadViewScan(root, { experiment: "compare/codex" }));
     expect(reportHtml.en).toContain("compare/codex");
@@ -236,13 +240,13 @@ describe("loadViewScan · 默认报告槽(裸跑)", () => {
   it("报告槽双语渲染:同一棵树按 locale 渲染两遍,chrome 文案分语言、数据不分语言", async () => {
     const root = await seedRoot();
     const reportHtml = bareReportHtml(await loadViewScan(root));
-    expect(reportHtml.en).toContain("End-to-end pass rate"); // ExperimentList 主行(en)
-    expect(reportHtml["zh-CN"]).toContain("端到端成功率"); // ExperimentList 主行(zh-CN)
+    expect(reportHtml.en).toContain("Pass rate"); // ExperimentList 主行(en)
+    expect(reportHtml["zh-CN"]).toContain("通过率"); // ExperimentList 主行(zh-CN)
     for (const html of [reportHtml.en, reportHtml["zh-CN"]]) {
       expect(html).toContain("compare/bub");
-      // 失败案例深链进证据室:不透明 AttemptLocator 单段路由 `#/attempt/@<locator>`,
-      // 不再是旧的两段式 `#/attempt/<snapshot>/<attempt>`。
-      expect(html).toMatch(/href="#\/attempt\/@[0-9a-z]+"/);
+      // 失败案例深链进独立 attempt 文档:不透明 AttemptLocator 编码进文件名
+      // (`attempt/<encodeURIComponent(locator)>.html`),不再是旧的 hash 路由。
+      expect(html).toMatch(/href="attempt\/%40[0-9a-z]+\.html"/);
       expect(html).not.toContain("<script"); // 报告槽产物零客户端 JS,不 hydrate
     }
   });
@@ -268,20 +272,24 @@ describe("loadViewScan · 默认报告槽(裸跑)", () => {
 // ───────────────────────── 报告槽整槽替换 ─────────────────────────
 
 describe("loadViewScan · --report 报告槽", () => {
-  it("报告树渲染为静态 HTML:官方水位 + 自定义摆法 + <Style> 产物 + 证据室深链,零 <script>", async () => {
+  it("报告树渲染为静态 HTML:官方水位 + 自定义摆法 + <Style> 产物,零 <script>", async () => {
     const root = await seedRoot();
     const scan = await loadViewScan(root, { report: { path: EXAM_REPORT, cwd: root } });
     const html = slotHtml(scan).en;
     expect(html).toContain("考试成绩单"); // 自定义 Section
     expect(html).toContain("nre-"); // 官方组件的稳定类名
     expect(html).toContain("<style>.exam-note { color: #4a7; }</style>"); // <Style> 随树带走
-    expect(html).toMatch(/href="#\/attempt\/@[0-9a-z]+"/); // 失败案例深链进证据室(单段 locator 路由)
+    // exam-report.tsx 是树形态 defineReport,没有声明 attempt-input page:locator 因此只是
+    // 纯文本,不生成假 href(architecture.md「Attempt 详情是一张参数化 page」)。
+    expect(html).toMatch(/<span class="nre-locator[^"]*">@[0-9a-z]+/);
+    expect(html).not.toMatch(/href="#\/attempt\//);
     expect(html).not.toContain("<script"); // 报告槽产物零客户端 JS,不 hydrate
     // 用户报告同样双语渲染两遍(壳按界面语言摆放)。
     expect(slotHtml(scan)["zh-CN"]).toContain("考试成绩单");
-    // 证据室数据契约(__NICEEVAL_VIEW_DATA__)原样保留:快照、locator、skipped 不动。
-    expect(scan.viewData.snapshots.length).toBeGreaterThan(0);
-    expect(scan.viewData.snapshots.flatMap((s) => s.results).every((r) => r.locator)).toBe(true);
+    // 证据室索引(attemptsByBase,供 artifact/ 与 attempt/<locator>.html 两条出口共用)原样保留,
+    // 不受这份没有 attempt-input page 的自定义报告影响;每条都有 locator。
+    expect(scan.attemptsByBase.size).toBeGreaterThan(0);
+    expect([...scan.attemptsByBase.values()].every((a) => a.locator)).toBe(true);
     expect(JSON.stringify(scan.viewData)).not.toContain("考试成绩单"); // 报告块不进 viewData
   });
 
@@ -314,6 +322,27 @@ describe("loadViewScan · --report 报告槽", () => {
       expect(text).toContain(needle);
       expect(html.en).toContain(needle);
     }
+    // Grid/Stat/Section.meta:两面共享同一批 label/value/detail/meta 终值,不要求布局逐字一致。
+    for (const needle of ["速览", "人工摘要,非计算结果", "及格线", "60 分", "最高分", "97 分", "compare/codex"]) {
+      expect(text).toContain(needle);
+      expect(html.en).toContain(needle);
+    }
+    // web 面是 Grid 结构(稳定 nre-grid/nre-grid-cell class),text 面无 JS 概念、只有内容。
+    expect(html.en).toContain("nre-grid");
+    expect(html.en).toContain("nre-grid-cell");
+    expect(html.en).toContain("nre-stat");
+
+    // text 面按显示宽度减列但不丢 Stat:极窄终端下两个 Stat 仍都完整可读。
+    let narrowText = "";
+    const narrowCode = await runShow(root, [], { results: root, report: EXAM_REPORT }, {
+      out: (s) => (narrowText += s),
+      err: () => {},
+      width: 30,
+    });
+    expect(narrowCode).toBe(0);
+    for (const needle of ["及格线", "60 分", "最高分", "97 分"]) {
+      expect(narrowText).toContain(needle);
+    }
   });
 
   it("报告文件缺失 / 默认导出不是 defineReport 产物:ReportLoadError 直说", async () => {
@@ -346,6 +375,7 @@ describe("loadViewScan · 外壳标题与 ReportLink.icon", () => {
       '  kind: "report",',
       '  title: { en: "Memory Evals", "zh-CN": "记忆能力评测" },',
       '  links: [{ label: "GitHub", href: "https://example.com", icon: { svg: "<svg data-mark></svg>" } }],',
+      "  head: [],",
       "  scripts: [],",
       "  styles: [],",
       '  pages: [{ id: "report", title: "Report", content: { $$typeof: Symbol.for("react.transitional.element"), type: Block, props: {}, key: null } }],',
@@ -396,6 +426,7 @@ describe("loadViewScan · 报告文件变更整页重算", () => {
       "const definition = {",
       '  kind: "report",',
       "  links: [],",
+      "  head: [],",
       "  scripts: [],",
       "  styles: [],",
       '  pages: [{ id: "report", title: "Report", content: { $$typeof: Symbol.for("react.transitional.element"), type: Block, props: {}, key: null } }],',
@@ -457,7 +488,7 @@ describe("buildView · --out 与 --report", () => {
     const artifactDir = join(root, "compare_codex", "2026-07-09T10-00-00-000Z", "weather", "brooklyn", "a0");
     await mkdir(artifactDir, { recursive: true });
     await writeFile(join(artifactDir, "events.json"), "[]", "utf-8");
-    await writeFile(join(artifactDir, "diff.json"), '{"windows":[]}', "utf-8");
+    await writeFile(join(artifactDir, "diff.json"), "[]", "utf-8");
     await writeFile(join(artifactDir, "o11y.json"), "{}", "utf-8");
 
     const out = join(root, "site");
@@ -468,18 +499,41 @@ describe("buildView · --out 与 --report", () => {
     expect(existsSync(join(exported, "o11y.json"))).toBe(false);
   });
 
-  it("--out 与位置参数 / --experiment 互斥:报错含 copySnapshots + filter 下一步", async () => {
+  it("--out 接受收窄,出站的就是收窄到的:被滤掉实验的证据文件与页面数据都不出站", async () => {
     const root = await seedRoot();
+    // 两个实验各写一份 events.json:导出后只有收窄内的那份在站里。
+    const bubDir = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "weather", "brooklyn", "a0");
+    const codexDir = join(root, "compare_codex", "2026-07-09T10-00-00-000Z", "weather", "brooklyn", "a0");
+    for (const dir of [bubDir, codexDir]) {
+      await mkdir(dir, { recursive: true });
+      await writeFile(join(dir, "events.json"), "[]", "utf-8");
+    }
+
     const out = join(root, "site");
-    for (const scan of [{ patterns: ["weather"] }, { experiment: "compare/bub" }]) {
-      const attempt = buildView({ input: root, out, scan });
-      await expect(attempt).rejects.toBeInstanceOf(ViewInputError);
-      await expect(
-        buildView({ input: root, out, scan }),
-      ).rejects.toThrow(/copySnapshots/);
+    await buildView({ input: root, out, scan: { patterns: [], experiment: "compare/codex" } });
+    expect(existsSync(join(out, "artifact", "compare_codex/2026-07-09T10-00-00-000Z/weather/brooklyn/a0", "events.json"))).toBe(true);
+    // 被滤掉的实验:证据树整目录不出站,页面数据(烘进 HTML 的 viewData 与报告块)也不含它。
+    expect(existsSync(join(out, "artifact", "compare_bub"))).toBe(false);
+    const html = await readFile(join(out, "index.html"), "utf-8");
+    expect(html).not.toContain("compare/bub");
+    expect(html).toContain("compare/codex");
+  });
+
+  it("eval 前缀收窄导出:不匹配 attempt 的证据不出站", async () => {
+    const root = await seedRoot();
+    const weatherDir = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "weather", "brooklyn", "a0");
+    const buttonDir = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "fixtures", "button", "a0");
+    for (const dir of [weatherDir, buttonDir]) {
+      await mkdir(dir, { recursive: true });
+      await writeFile(join(dir, "events.json"), "[]", "utf-8");
     }
-    // 同参数不带 --out 时照常收窄报告槽(不报错)。
-    await expect(loadViewScan(root, { patterns: ["weather"] })).resolves.toBeTruthy();
+
+    const out = join(root, "site");
+    await buildView({ input: root, out, scan: { patterns: ["weather"] } });
+    expect(existsSync(join(out, "artifact", "compare_bub/2026-07-08T10-00-00-000Z/weather/brooklyn/a0", "events.json"))).toBe(true);
+    expect(existsSync(join(out, "artifact", "compare_bub/2026-07-08T10-00-00-000Z/fixtures"))).toBe(false);
+    const html = await readFile(join(out, "index.html"), "utf-8");
+    expect(html).not.toContain("fixtures/button");
   });
 
   it("默认导出(无 --report):报告槽填充 ExperimentComparison,双语块与增强 runtime 恒内联", async () => {
@@ -496,3 +550,97 @@ describe("buildView · --out 与 --report", () => {
     expect(block).not.toContain("<script");
   });
 });
+
+// ───────────────────── attempt/<locator>.html:独立静态详情文档 ─────────────────────
+
+describe("buildView · attempt/<locator>.html", () => {
+  it("收窄后有效根内每个可达 locator 各一份文档,收窄外 locator 不生成文件(cases.md 第 205 行)", async () => {
+    const root = await makeRoot();
+    const writer = createResultsWriter(root, { producer: { name: "niceeval", version: "1.0.0" } });
+    const snapA = await writer.snapshot({ experimentId: "exp/a", agent: "bub", startedAt: "2026-07-01T08:00:00.000Z" });
+    await snapA.writeAttempt({ id: "q1", verdict: "passed", attempt: 0, durationMs: 1000, assertions: [] });
+    const snapB = await writer.snapshot({ experimentId: "exp/b", agent: "bub", startedAt: "2026-07-01T09:00:00.000Z" });
+    await snapB.writeAttempt({ id: "q2", verdict: "passed", attempt: 0, durationMs: 1000, assertions: [] });
+    await writer.finish();
+
+    const scanFull = await loadViewScan(root);
+    const scanNarrowed = await loadViewScan(root, { experiment: "exp/a" });
+    expect(scanFull.attemptPages!.locators.size).toBe(2);
+    expect(scanNarrowed.attemptPages!.locators.size).toBe(1);
+    const [keptLocator] = [...scanNarrowed.attemptPages!.locators.keys()];
+    const droppedLocator = [...scanFull.attemptPages!.locators.keys()].find((l) => l !== keptLocator)!;
+
+    const out = join(root, "site");
+    await buildView({ input: root, out, scan: { experiment: "exp/a" } });
+    const files = await readdir(join(out, "attempt"));
+    expect(files).toEqual([`${keptLocator}.html`]);
+    expect(existsSync(join(out, "attempt", `${droppedLocator}.html`))).toBe(false);
+  });
+
+  it("直接读取该文档(无 JavaScript 场景)即可见完整内容:身份/verdict/断言/时间树/diagnostics/usage/对话/trace/diff 都在可见的 en 区块里,不藏在 hidden 或 <template> 里(cases.md 第 206 行)", async () => {
+    const root = await makeRoot();
+    const writer = createResultsWriter(root, { producer: { name: "niceeval", version: "1.0.0" } });
+    const snap = await writer.snapshot({ experimentId: "compare/bub", agent: "bub", startedAt: "2026-07-01T08:00:00.000Z" });
+    await snap.writeAttempt(
+      {
+        id: "weather/brooklyn",
+        verdict: "failed",
+        attempt: 0,
+        durationMs: 4200,
+        assertions: [
+          {
+            name: "temperature matches forecast",
+            severity: "gate",
+            outcome: "failed",
+            score: 0,
+            expected: "72",
+            received: "71",
+            loc: { file: "evals/weather.eval.ts", line: 1 },
+          },
+        ],
+        phases: [{ name: "eval.run", durationMs: 4000 }],
+        diagnostics: [{ code: "teardown-failed", level: "warning", phase: "sandbox.teardown", message: "container stop timed out" }],
+        usage: { inputTokens: 100, outputTokens: 50 },
+      },
+      {
+        sources: [{ path: "evals/weather.eval.ts", content: "export default 1;\n" }],
+        events: [
+          { type: "message", role: "user", text: "what is the forecast for brooklyn" },
+          { type: "message", role: "assistant", text: "72 degrees and sunny" },
+        ],
+        trace: [{ traceId: "t1", spanId: "s1", name: "turn", kind: "turn", startMs: 0, endMs: 100 }],
+        diff: [{ window: "s1/t1", changes: { "a.txt": { status: "added", after: "1" } } }] as never,
+      },
+    );
+    await writer.finish();
+
+    const out = join(root, "site");
+    await buildView({ input: root, out });
+    const [locator] = [...(await loadViewScan(root)).attemptPages!.locators.keys()];
+    const html = await readFile(join(out, "attempt", `${locator}.html`), "utf-8");
+
+    // 结构:en 可见(无 hidden 属性),zh-CN 带 hidden——两者都不需要 JS 才能被浏览器正确
+    // 处理(hidden 是浏览器原生渲染指令,不是 JS 行为);没有 <template> 把内容整个锁起来。
+    expect(html).toMatch(/<div data-nre-locale="en">/);
+    expect(html).not.toMatch(/<div data-nre-locale="en"[^>]*\shidden/);
+    expect(html).toMatch(/<div data-nre-locale="zh-CN" hidden>/);
+    const body = html.split("<body>")[1]!.split("</body>")[0]!;
+    expect(body).not.toContain("<template"); // 不像 index.html 那样把内容锁进 <template>
+    const enBlock = html.split('<div data-nre-locale="en">')[1]!.split('<div data-nre-locale="zh-CN"')[0]!;
+    for (const needle of [
+      "weather/brooklyn", // 身份
+      "compare/bub",
+      "evals/weather.eval.ts", // source
+      "temperature matches forecast", // 断言
+      "71", // received(fix prompt 里的摘要行)
+      "4.0s", // 时间树(eval.run 4000ms)
+      "container stop timed out", // diagnostics
+      "output tokens", // usage
+      "what is the forecast", // 对话
+      "nre-attempt-trace", // trace
+      "a.txt", // diff 摘要
+    ]) {
+      expect(enBlock, needle).toContain(needle);
+    }
+  });
+});

package/dist/report/components.d.ts

@@ -1,179 +0,0 @@
-import { type ReportComponent } from "./tree.ts";
-import type { LocalizedText, ReportLocale } from "./locale.ts";
-import type { AttemptLocator } from "../results/locator.ts";
-import type { AttemptListItem, CopyFixPromptData, DeltaData, EvalListItem, ExperimentComparisonData, ExperimentListItem, HeroData, LineData, MatrixData, ReportInput, ScatterData, ScopeSummaryData, ScopeWarning, ScoreboardData, TableData, TraceWaterfallRow } from "./types.ts";
-import { type DeltaTableOptions, type MetricLineOptions, type MetricMatrixOptions, type MetricScatterOptions, type MetricTableOptions, type ScoreboardOptions } from "./compute.ts";
-type Never<T> = {
-    [K in keyof T]?: never;
-};
-/**
- * 官方数据组件的统一 props 组合(docs/feature/reports/library/metric-views.md):
- * data 形态(接收配套 *Data 的产物)或 spec 形态(Options 平铺 + 可选 input)。
- */
-export type DataProps<Data, Options, Presentation> = ({
-    data: Data;
-    input?: never;
-} & Never<Options> & Presentation) | ({
-    data?: never;
-    input?: ReportInput;
-} & Options & Presentation);
-interface ChromeProps {
-    /** chrome 文案 locale;省略时随宿主上下文(宿主外默认 "en")。 */
-    locale?: ReportLocale;
-    className?: string;
-}
-export type ScopeSummaryProps = DataProps<ScopeSummaryData, Record<never, never>, ChromeProps & {
-    /** 显示哪一级计票;默认 "eval"。data 恒携带两级,votes 只选择呈现。 */
-    votes?: "eval" | "attempt";
-}>;
-/** 范围摘要卡:时间窗、数量、两级计票、端到端成功率与总成本。 */
-export declare const ScopeSummary: ReportComponent<ScopeSummaryProps>;
-export type ExperimentComparisonProps = DataProps<ExperimentComparisonData, Record<never, never>, ChromeProps>;
-/**
- * 内建报告的默认组合件:先把 input 按可比组分区,再为每组分别计算 ScopeSummary、
- * 成本 × 端到端成功率散点和 ExperimentList。web 面持有完整组索引并一次聚焦一组;
- * text 面命中多个组时只显示组索引与可执行的单组查看命令,命中单组时才输出完整散点与列表。
- */
-export declare const ExperimentComparison: ReportComponent<ExperimentComparisonProps>;
-interface EntityListChrome extends ChromeProps {
-    attemptHref?: (locator: AttemptLocator) => string;
-}
-export type ExperimentListProps = DataProps<readonly ExperimentListItem[], Record<never, never>, EntityListChrome & {
-    /** web 面在比较表前显示实验过滤框;text 面忽略。 */
-    filter?: boolean;
-    /**
-     * 可选父路径:两面的行标签去掉与它相同的前缀,只显示 experiment id 末段(默认
-     * `ExperimentComparison` 给每组传组键)。完整 id 仍是排序 / 着色 / 过滤 / 折叠的键。
-     */
-    relativeTo?: string;
-}>;
-/** 实验列表:每项一个 experiment,固定八列比较表 + 展开到 Eval / Attempt。 */
-export declare const ExperimentList: ReportComponent<ExperimentListProps>;
-export type EvalListProps = DataProps<readonly EvalListItem[], Record<never, never>, EntityListChrome>;
-/** Eval 列表:每项一个 experimentId + evalId,展开到这道题的 Attempt。 */
-export declare const EvalList: ReportComponent<EvalListProps>;
-export type AttemptListProps = DataProps<readonly AttemptListItem[], Record<never, never>, EntityListChrome & {
-    /** 过滤 / 截断前的总数;省略时等于 data 长度。 */
-    total?: number;
-    /** web 面加过滤输入框(按 experiment、eval、agent、verdict 或摘要文本收窄行);渐进增强,不改变数据与 text 面。 */
-    filter?: boolean;
-}>;
-/** Attempt 列表:实体列表的叶子层,每项一次 attempt 的判定、单行摘要与 locator。 */
-export declare const AttemptList: ReportComponent<AttemptListProps>;
-export interface FailureListProps {
-    /** 显示的最大条数;默认 20。 */
-    limit?: number;
-    /** 默认宿主注入的 Scope。 */
-    input?: ReportInput;
-    attemptHref?: (locator: AttemptLocator) => string;
-    locale?: ReportLocale;
-    className?: string;
-}
-/**
- * 「现在有哪些失败要处理」的成品组合件:内部就是 attemptListData → 过滤 → AttemptList
- * data 形态,与手写组合严格等价、没有私有能力(docs/feature/reports/library/entity-lists.md)。
- * verdict ∈ failed / errored,按 attempt 开始时间降序(同刻按 locator 字典序),
- * 截断到 limit(默认 20),total 报告截断前总数。
- */
-export declare const FailureList: ReportComponent<FailureListProps>;
-/** `Hero` 的 props:标题缺省取 `ctx.report.title`(回退链后的站点标题)。 */
-export interface HeroProps {
-    /** 覆盖标题;省略时取 ctx.report.title(回退链后的站点标题)。 */
-    title?: LocalizedText;
-    className?: string;
-}
-/**
- * `HeroCard`:Hero 的渲染件,双面组件,只收 data 形态——标题输入是站点声明与 Scope 的
- * 合成物,没有单独的 spec 等价形。web 面渲染 hero 标题(h1)、按渲染 locale 格式化的运行
- * meta(latestStartedAt 为 null 时内置「暂无运行」文案)与品牌行(等同 PoweredBy,恒含、
- * 无拆除 prop);text 面输出标题行与 meta 行,不含品牌行
- * (docs/feature/reports/library/site-components.md「HeroCard」)。
- */
-export declare const HeroCard: ReportComponent<HeroCardProps>;
-/** `HeroCard` 的 props:标题 + `heroData()` 的产物,只有 data 形态。 */
-export interface HeroCardProps {
-    title: LocalizedText;
-    data: HeroData;
-    className?: string;
-}
-/**
- * `Hero`:页首的站点标题区——标题、最后运行时间、快照合成来源,恒含品牌行。官方组合组件,
- * 与手写 `<HeroCard title={title ?? ctx.report.title} data={await heroData(ctx.scope)} />`
- * 严格等价、没有私有能力;读 `ctx.report` 意味着输出跟随站点,要站点无关的标题区直接用
- * `HeroCard` 显式传值(docs/feature/reports/library/site-components.md「Hero」)。
- */
-export declare const Hero: ReportComponent<HeroProps>;
-/**
- * `PoweredBy`:唯一的品牌件,无 props 双面组件。web 面渲染指向 niceeval 官网的一行品牌色
- * 小字(`utm_source=report&utm_medium=powered-by`,`rel` 仅 `noopener` 以保留 Referer);
- * text 面零输出。没有任何配置——品牌契约是「提供一个组件,不给开关」:不想要品牌就不用
- * 这些组件、自己写替代组件(docs/feature/reports/library/site-components.md「PoweredBy」)。
- */
-export declare const PoweredBy: ReportComponent<Record<never, never>>;
-/** `ScopeWarnings` 的 props:spec 形态取宿主 Scope 的 warnings,data 形态收 `ScopeWarning[]`。 */
-export type ScopeWarningsProps = DataProps<readonly ScopeWarning[], Record<never, never>, ChromeProps>;
-/**
- * `ScopeWarnings`:选择警告区,警告的唯一呈现组件。把 Scope 携带的 `ScopeWarning[]`
- * 按「下一步动作」聚合渲染(带 experimentId 的按实验聚合、非实验作用域按 kind 聚合;
- * integrity 组在前);web 面组头带去重后的可复制命令、明细收原生 `<details>`(总条数 ≤ 3
- * 默认展开),text 面同构但不折叠。空警告集与裸 `Snapshot[]` 输入两面零输出
- * (docs/feature/reports/library/site-components.md「ScopeWarnings」)。
- */
-export declare const ScopeWarnings: ReportComponent<ScopeWarningsProps>;
-/** `CopyFixPrompt` 的 props:spec 形态无选项,data 形态收 `copyFixPromptData()` 的产物。 */
-export type CopyFixPromptProps = DataProps<CopyFixPromptData, Record<never, never>, ChromeProps>;
-/**
- * `CopyFixPrompt`:把当前范围的全部失败整理成一段可交给 coding agent 的修复 prompt。
- * prompt 在 resolve 阶段算好、烘进静态 HTML,无 JS 时在折叠块里完整可读,「复制」是增强层
- * 行为;`failures` 为 0 时两面零输出;text 面恒零输出——终端里的等价能力是 `show` 的
- * attempt 下钻命令本身(docs/feature/reports/library/site-components.md「CopyFixPrompt」)。
- */
-export declare const CopyFixPrompt: ReportComponent<CopyFixPromptProps>;
-/** `TraceWaterfall` 的 props:spec 形态无选项,data 形态收 `traceWaterfallData()` 的产物。 */
-export type TraceWaterfallProps = DataProps<readonly TraceWaterfallRow[], Record<never, never>, ChromeProps & {
-    attemptHref?: (locator: AttemptLocator) => string;
-}>;
-/**
- * `TraceWaterfall`:每个 attempt 一行的执行时间瀑布,用 canonical OTel 字段显示被测 agent
- * 的原始 span(agent / model / tool)。web 面静态渲染顶层 span 分解条(失败 span 带失败
- * 标记),行链接 attempt 详情;text 面每 attempt 一行(locator、总耗时、span 计数与失败
- * 标记)+ 可复制的 `--timing` 下钻命令。trace 缺失的行照常出现并如实显示缺失;runner
- * 生命周期节点不进瀑布(docs/feature/reports/library/site-components.md「TraceWaterfall」)。
- */
-export declare const TraceWaterfall: ReportComponent<TraceWaterfallProps>;
-export type MetricTableProps = DataProps<TableData, MetricTableOptions, ChromeProps & {
-    /** web 面在表格前渲染过滤输入框(enhance.js 接管);无 JS 时表格内容依旧完整。 */
-    filter?: boolean;
-    attemptHref?: (locator: AttemptLocator) => string;
-}>;
-/** 榜单:一行一个维度值、一列一个指标,回答「谁整体更好」。 */
-export declare const MetricTable: ReportComponent<MetricTableProps>;
-export type MetricMatrixProps = DataProps<MatrixData, MetricMatrixOptions, ChromeProps & {
-    attemptHref?: (locator: AttemptLocator) => string;
-}>;
-export type MetricBarsProps = MetricMatrixProps;
-/** 逐题格子:行 × 列两个维度、格子里一个指标,回答「哪道题谁挂了」。 */
-export declare const MetricMatrix: ReportComponent<MetricMatrixProps>;
-/** 分组条形:同一份矩阵数据的另一种摆法;与 MetricMatrix 写同一份 spec 时只计算一次。 */
-export declare const MetricBars: ReportComponent<MetricBarsProps>;
-export type ScoreboardProps = DataProps<ScoreboardData, ScoreboardOptions, ChromeProps & {
-    attemptHref?: (locator: AttemptLocator) => string;
-}>;
-/** 考试成绩单:总分 + 分科小计,固定分母、notRun / unscorable 分开如实报。 */
-export declare const Scoreboard: ReportComponent<ScoreboardProps>;
-export type MetricScatterProps = DataProps<ScatterData, MetricScatterOptions, ChromeProps & {
-    pointHref?: (row: ScatterData["rows"][number]) => string;
-}>;
-/** 两个指标之间的取舍:每个点一个维度值,x / y 各一个指标,series 只决定颜色和分组。 */
-export declare const MetricScatter: ReportComponent<MetricScatterProps>;
-export type MetricLineProps = DataProps<LineData, MetricLineOptions, ChromeProps & {
-    pointHref?: (row: LineData["rows"][number]) => string;
-}>;
-/** 趋势线:x 是 NumericAxis(参数轴),点身份 = (series, x)。 */
-export declare const MetricLine: ReportComponent<MetricLineProps>;
-export type DeltaTableProps = DataProps<DeltaData, DeltaTableOptions, ChromeProps & {
-    attemptHref?: (locator: AttemptLocator) => string;
-}>;
-/** 成对对比:每行一对(字面声明或 pairsByFlag 派生),格子里 A、B、Δ 三个值。 */
-export declare const DeltaTable: ReportComponent<DeltaTableProps>;
-export {};