niceeval 0.9.1 → 0.10.0

package/dist/report/{report.d.ts → definition/report.d.ts}

@@ -1,6 +1,6 @@
-import type { Results, Scope } from "../results/types.ts";
-import { type ReportNode, type TextRenderOptions } from "./tree.ts";
-import { type LocalizedText, type ReportLocale } from "./locale.ts";
+import type { Scope } from "../../results/types.ts";
+import type { ReportNode } from "./tree.ts";
+import { type LocalizedText } from "../model/locale.ts";
 export interface ReportLink {
     label: LocalizedText;
     href: string;
@@ -55,7 +55,7 @@ export interface ReportShell {
     styles?: ReportAsset[];
 }
 export type NonEmptyArray<T> = readonly [T, ...T[]];
-export interface ReportPage {
+export interface ReportPageBase {
     /** 页面身份:`--page <id>` 的取值、web 路由 `#/page/<id>` 与导航锚。小写字母、数字与连字符。 */
     id: string;
     /** 导航中的页名。 */
@@ -63,6 +63,21 @@ export interface ReportPage {
     /** 这一页的报告树;ReportDefinition 不是 ReportNode,页装不进外壳。 */
     content: ReportNode;
 }
+/**
+ * 页按输入分两种形态,仍是同一个类型族,走同一条 resolve → validate → render 管线
+ * (docs/feature/reports/architecture.md「Attempt 详情是一张参数化 page」):
+ * - `input` 省略或为 `"scope"`:消费宿主选择的 Scope;省略时规范化为 `navigation: true`。
+ * - `input: "attempt"`:以 locator 为参数,消费一份 AttemptEvidence;没有 locator 时不能打开,
+ *   必须显式 `navigation: false`,不进导航。
+ * 一份报告至多声明一张 attempt-input page。
+ */
+export type ReportPage = (ReportPageBase & {
+    input?: "scope";
+    navigation?: boolean;
+}) | (ReportPageBase & {
+    input: "attempt";
+    navigation: false;
+});
 /** content / pages / extends 三选一由类型表达,不把非法状态留到运行期。 */
 export type ReportDef = ReportShell & ({
     /** 单页缩写,等价于只含 id `report` 的页列表。 */
@@ -70,7 +85,7 @@ export type ReportDef = ReportShell & ({
     pages?: never;
     extends?: never;
 } | {
-    /** 非空页列表;导航按数组顺序显示。 */
+    /** 非空页列表;`navigation !== false` 的项按数组顺序显示。 */
     pages: NonEmptyArray<ReportPage>;
     content?: never;
     extends?: never;
@@ -100,20 +115,26 @@ export interface ReportDefinition {
     readonly styles: readonly ReportAsset[];
     readonly pages: NonEmptyArray<ReportPage>;
 }
-/** 规范化后的报告声明,经组合组件 ctx.report 只读可见(scripts / styles 是注入资产,不进)。 */
+/** 规范化后页列表在 ctx.report 上的元数据形态(id / 导航页名 / 输入声明 / 导航资格)。 */
+export interface ReportMetaPage {
+    id: string;
+    title: LocalizedText;
+    input: "scope" | "attempt";
+    navigation: boolean;
+}
+/**
+ * 规范化后的报告声明,经组合组件 ctx.report 只读可见(scripts / styles 是注入资产,不进)。
+ * 不携带"当前是哪一页"——那由 ctx.page(PageContext)表达,两者不是同一份状态
+ * (docs/feature/reports/library/shell.md「行为约束」)。
+ */
 export interface ReportMeta {
     /** 走完回退链(声明 title → 唯一快照 name → 内置文案「Eval 运行结果 / Eval Results」)后的标题。 */
     title: LocalizedText;
     /** 页头外链;声明省略时为空数组。 */
     links: readonly ReportLink[];
     footer?: LocalizedText;
-    /** 规范化后的页列表(id 与导航页名),恒非空。 */
-    pages: NonEmptyArray<{
-        id: string;
-        title: LocalizedText;
-    }>;
-    /** 当前渲染中的页 id。 */
-    pageId: string;
+    /** 规范化后的页列表,恒非空。 */
+    pages: NonEmptyArray<ReportMetaPage>;
 }
 /** 单页缩写展开出的唯一页 id 与内置页名。 */
 export declare const DEFAULT_PAGE_ID = "report";
@@ -129,55 +150,5 @@ export declare const FALLBACK_REPORT_TITLE: LocalizedText;
  * 都落到内置文案,不按数组顺序挑。
  */
 export declare function resolveReportTitle(definition: ReportDefinition, scope: Scope): LocalizedText;
-/** 规范化声明 → 组合组件可见的 ReportMeta(scripts / styles 是注入资产,不进)。 */
-export declare function buildReportMeta(definition: ReportDefinition, scope: Scope, pageId: string): ReportMeta;
-/** `--page` 未命中:宿主据此按用法错误退出并列出可用页 id。 */
-export declare class ReportPageNotFoundError extends Error {
-    readonly pageId: string;
-    readonly available: string[];
-    constructor(pageId: string, available: string[]);
-}
-export declare function pickReportPage(definition: ReportDefinition, pageId?: string): ReportPage;
-/** 宿主注入的渲染上下文:官方口径挑好的 Scope 与结果根完整读取面。 */
-export interface ReportHostContext {
-    scope: Scope;
-    /** 组合组件 ctx.results 的来源;历史视图从这里自行挑 Snapshot[]。 */
-    results: Results;
-}
-export interface RenderReportTextOptions extends TextRenderOptions {
-    /** 渲染哪一页;缺省第一页。未命中抛 ReportPageNotFoundError。 */
-    pageId?: string;
-}
-/**
- * text 宿主的装载语义:选页 → resolve(组合展开 + spec 取数,唯一的 await 边界)→ 树校验 →
- * 遍历渲染 text 面。不需要 react-dom。宿主不在报告树外另设警告通道——挑选警告的呈现件是
- * `ScopeWarnings` 组件,内建报告每页都放它,自定义报告放不放是作者义务
- * (docs/feature/reports/architecture.md「Scope 是计算入口」)。
- */
-export declare function renderReportToText(definition: ReportDefinition, ctx: ReportHostContext, options?: RenderReportTextOptions): Promise<string>;
-/** 页索引标题行(show 多页索引 / view 导航共用的解析结果):按 locale 解析的标题字符串。 */
-export declare function reportTitleText(definition: ReportDefinition, scope: Scope, locale: ReportLocale): string;
-/** 宿主索引命令的完整上下文(docs/feature/reports/show/reports.md「索引命令携带完整上下文」)。 */
-export interface HostCommandContext {
-    patterns: string[];
-    results?: string;
-    experiment?: string;
-    report?: string;
-    page?: string;
-}
-/** 逐页渲染的宿主上下文:官方口径的 Scope、结果根读取面与规范化声明(ctx.report)。 */
-export interface ReportTreeHostContext {
-    scope: Scope;
-    results: Results;
-    report: ReportMeta;
-}
-export interface RenderTreeTextOptions extends TextRenderOptions {
-    /** 组索引命令的完整上下文;给了就按它拼命令,experimentCommand 显式注入时以后者为准。 */
-    commandContext?: HostCommandContext;
-}
-/**
- * 渲染一页报告树的 text 面(宿主逐页调用;页选择归宿主):
- * resolve(组合展开 + spec 取数)→ validate → render。宿主不在报告树外另设警告通道,
- * 挑选警告由页内的 `ScopeWarnings` 组件呈现(内建报告每页都放它)。
- */
-export declare function renderReportTreeToText(tree: ReportNode, ctx: ReportTreeHostContext, options?: RenderTreeTextOptions): Promise<string>;
+/** 规范化声明 → 组合组件可见的 ReportMeta(scripts / styles 是注入资产,不进;不携带当前页)。 */
+export declare function buildReportMeta(definition: ReportDefinition, scope: Scope): ReportMeta;

package/dist/report/{report.js → definition/report.js}

@@ -5,11 +5,10 @@
 // `extends` 在另一份报告上叠外壳——页归 base、外壳逐字段覆盖,合并在调用时折叠完成,
 // 宿主装载看到的永远是已折叠的普通产物。
 //
-// renderReportToText 是 text 宿主(show)的装载入口;web 宿主(view)的
-// renderReportToStaticHtml 在 ./web.ts(那一侧才 import react-dom)。管线以页为单位执行:
-// 装载(规范化 + 静态校验)→ resolve → validate → render。
-import { createTextContext, renderNodeToText, resolveReportTree, validateReportTree, ResolveMemo, } from "./tree.js";
-import { localizedTextEquals, resolveLocalizedText, } from "./locale.js";
+// text/web 两个宿主的渲染入口(renderReportToText / renderReportToStaticHtml)在 ../runtime/
+// (text.ts / web.ts);这里只有 ReportDefinition 的类型体系、装载规范化与元数据折叠
+// (buildReportMeta / resolveReportTitle),不做任何渲染。
+import { localizedTextEquals } from "../model/locale.js";
 const REPORT_DEFINITION = Symbol.for("niceeval.report.definition");
 /** 单页缩写展开出的唯一页 id 与内置页名。 */
 export const DEFAULT_PAGE_ID = "report";
@@ -152,6 +151,45 @@ function assertHeadTags(tags) {
     }
     return tags;
 }
+/**
+ * page 的 input / navigation 规范化(shell.md「page 显式声明输入」):省略或 "scope" 时补
+ * `input: "scope"`,`navigation` 缺省为 true;"attempt" 必须显式 `navigation: false`——
+ * 没有 locator 时不可打开,不能悄悄挤进导航,省略或传 true 都在装载期报错。
+ */
+function normalizePageInputAndNavigation(page) {
+    const input = page.input;
+    if (input === undefined || input === "scope") {
+        return {
+            id: page.id,
+            title: page.title,
+            content: page.content,
+            input: "scope",
+            navigation: page.navigation !== false,
+        };
+    }
+    if (input === "attempt") {
+        if (page.navigation !== false) {
+            throw new Error(`Report page "${page.id}" declares input: "attempt" but not navigation: false — an attempt-input page has no content without a locator, so it must not appear in navigation. Add navigation: false.`);
+        }
+        return {
+            id: page.id,
+            title: page.title,
+            content: page.content,
+            input: "attempt",
+            navigation: false,
+        };
+    }
+    throw new Error(`Report page "${page.id}" input ${JSON.stringify(input)} is not valid — input is omitted, "scope", or "attempt".`);
+}
+/** 一份报告至多一张 attempt-input page,避免 show @<locator> 与 locator 链接出现多个目标。 */
+function assertAtMostOneAttemptPage(pages) {
+    const attemptPages = pages.filter((p) => p.input === "attempt");
+    if (attemptPages.length > 1) {
+        throw new Error(`A report can declare at most one input: "attempt" page — got ${attemptPages.length} (${attemptPages
+            .map((p) => `"${p.id}"`)
+            .join(", ")}). Keep one and remove the others, or fold their content into a single attempt-input page.`);
+    }
+}
 export function defineReport(input) {
     assertNotDefinition(input, "defineReport(...)");
     const def = isReportNodeInput(input)
@@ -186,7 +224,9 @@ export function defineReport(input) {
     }
     else if (hasContent) {
         assertNotDefinition(def.content, 'defineReport "content"');
-        pages = [{ id: DEFAULT_PAGE_ID, title: DEFAULT_PAGE_TITLE, content: def.content }];
+        pages = [
+            { id: DEFAULT_PAGE_ID, title: DEFAULT_PAGE_TITLE, input: "scope", navigation: true, content: def.content },
+        ];
     }
     else {
         const raw = def.pages;
@@ -194,6 +234,7 @@ export function defineReport(input) {
             throw new Error(`defineReport "pages" must be a non-empty array of { id, title, content }. ${EXTENDS_NEXT_STEP}`);
         }
         const seen = new Set();
+        const normalized = [];
         for (const page of raw) {
             if (typeof page?.id !== "string" || !PAGE_ID_PATTERN.test(page.id)) {
                 throw new Error(`Report page id ${JSON.stringify(page?.id)} is invalid: ids are lowercase letters, digits and hyphens (they become --page values and #/page/<id> routes). Rename it, e.g. "overview".`);
@@ -204,9 +245,11 @@ export function defineReport(input) {
             seen.add(page.id);
             assertLocalizedText(page.title, `Report page "${page.id}" title`);
             assertNotDefinition(page.content, `Report page "${page.id}" content`);
+            normalized.push(normalizePageInputAndNavigation(page));
         }
-        pages = raw;
+        pages = normalized;
     }
+    assertAtMostOneAttemptPage(pages);
     if (def.title !== undefined)
         assertLocalizedText(def.title, "defineReport title");
     if (def.footer !== undefined)
@@ -279,92 +322,17 @@ export function resolveReportTitle(definition, scope) {
     const first = names[0];
     return names.every((name) => localizedTextEquals(name, first)) ? first : FALLBACK_REPORT_TITLE;
 }
-/** 规范化声明 → 组合组件可见的 ReportMeta(scripts / styles 是注入资产,不进)。 */
-export function buildReportMeta(definition, scope, pageId) {
+/** 规范化声明 → 组合组件可见的 ReportMeta(scripts / styles 是注入资产,不进;不携带当前页)。 */
+export function buildReportMeta(definition, scope) {
     return {
         title: resolveReportTitle(definition, scope),
         links: definition.links,
         ...(definition.footer !== undefined ? { footer: definition.footer } : {}),
-        pages: definition.pages.map((page) => ({ id: page.id, title: page.title })),
-        pageId,
-    };
-}
-// ───────────────────────── 页选择与 text 宿主入口 ─────────────────────────
-/** `--page` 未命中:宿主据此按用法错误退出并列出可用页 id。 */
-export class ReportPageNotFoundError extends Error {
-    pageId;
-    available;
-    constructor(pageId, available) {
-        super(`page "${pageId}" not found. Available pages: ${available.join(", ")}`);
-        this.pageId = pageId;
-        this.available = available;
-    }
-}
-export function pickReportPage(definition, pageId) {
-    if (pageId === undefined)
-        return definition.pages[0];
-    const page = definition.pages.find((p) => p.id === pageId);
-    if (!page) {
-        throw new ReportPageNotFoundError(pageId, definition.pages.map((p) => p.id));
-    }
-    return page;
-}
-/**
- * text 宿主的装载语义:选页 → resolve(组合展开 + spec 取数,唯一的 await 边界)→ 树校验 →
- * 遍历渲染 text 面。不需要 react-dom。宿主不在报告树外另设警告通道——挑选警告的呈现件是
- * `ScopeWarnings` 组件,内建报告每页都放它,自定义报告放不放是作者义务
- * (docs/feature/reports/architecture.md「Scope 是计算入口」)。
- */
-export async function renderReportToText(definition, ctx, options) {
-    const page = pickReportPage(definition, options?.pageId);
-    const meta = buildReportMeta(definition, ctx.scope, page.id);
-    const resolved = await resolveReportTree(page.content, {
-        scope: ctx.scope,
-        results: ctx.results,
-        report: meta,
-        memo: new ResolveMemo(),
-    });
-    validateReportTree(resolved);
-    return renderNodeToText(resolved, createTextContext(options));
-}
-/** 页索引标题行(show 多页索引 / view 导航共用的解析结果):按 locale 解析的标题字符串。 */
-export function reportTitleText(definition, scope, locale) {
-    return resolveLocalizedText(resolveReportTitle(definition, scope), locale);
-}
-function quoteArg(value) {
-    return /^[A-Za-z0-9._/@-]+$/.test(value) ? value : `'${value.replaceAll("'", `'"'"'`)}'`;
-}
-/** 按上下文拼组索引的可复制命令:`niceeval show <patterns> --exp <id> [--results/--report/--page]`。 */
-function experimentCommandFor(ctx) {
-    return (prefix) => {
-        const parts = ["niceeval show", ...ctx.patterns.map(quoteArg), `--exp ${quoteArg(prefix)}`];
-        if (ctx.results !== undefined)
-            parts.push(`--results ${quoteArg(ctx.results)}`);
-        if (ctx.report !== undefined)
-            parts.push(`--report ${quoteArg(ctx.report)}`);
-        if (ctx.page !== undefined)
-            parts.push(`--page ${quoteArg(ctx.page)}`);
-        return parts.join(" ");
+        pages: definition.pages.map((page) => ({
+            id: page.id,
+            title: page.title,
+            input: page.input ?? "scope",
+            navigation: page.navigation ?? true,
+        })),
     };
 }
-/**
- * 渲染一页报告树的 text 面(宿主逐页调用;页选择归宿主):
- * resolve(组合展开 + spec 取数)→ validate → render。宿主不在报告树外另设警告通道,
- * 挑选警告由页内的 `ScopeWarnings` 组件呈现(内建报告每页都放它)。
- */
-export async function renderReportTreeToText(tree, ctx, options) {
-    const resolved = await resolveReportTree(tree, {
-        scope: ctx.scope,
-        results: ctx.results,
-        report: ctx.report,
-        memo: new ResolveMemo(),
-    });
-    validateReportTree(resolved);
-    const textCtx = createTextContext({
-        ...options,
-        ...(options?.experimentCommand === undefined && options?.commandContext !== undefined
-            ? { experimentCommand: experimentCommandFor(options.commandContext) }
-            : {}),
-    });
-    return renderNodeToText(resolved, textCtx);
-}

package/dist/report/{text/table.d.ts → definition/table-text.d.ts}

@@ -1,5 +1,5 @@
-import type { TableProps } from "../primitives.tsx";
-import type { TextContext } from "../tree.ts";
+import type { TableProps } from "./primitives.tsx";
+import type { TextContext } from "./tree.ts";
 /**
  * <Table> 的 text 面:columns × rows → 对齐的字符表。
  * 有任一行带 locator 时追加一列 attempt(locator 本身就是 `niceeval show <locator>`

package/dist/report/{text/table.js → definition/table-text.js}

@@ -5,8 +5,8 @@
 //
 // 列宽按显示宽度算(CJK 记 2 列);null 渲染 —,不补 0;超宽先折最宽的左对齐列,
 // 压到下限仍放不下就从右侧丢列并如实报数(「截断报剩余」是既有契约,不在这里破例)。
-import { countText, localeText, resolveLocalizedText } from "../locale.js";
-import { charDisplayWidth, renderAlignedRows, stringWidth, wrapDisplay } from "./layout.js";
+import { countText, localeText, resolveLocalizedText } from "../model/locale.js";
+import { charDisplayWidth, renderAlignedRows, stringWidth, wrapDisplay } from "../model/text-layout.js";
 const MISSING_MARK = "—";
 /** 列间距,与 renderAlignedRows 的 join("   ") 一致。 */
 const COLUMN_GAP = 3;

package/dist/report/{tree.d.ts → definition/tree.d.ts}

@@ -1,9 +1,29 @@
 import type { ReactNode } from "react";
-import type { AttemptLocator } from "../results/locator.ts";
-import type { Results, Scope } from "../results/types.ts";
-import { type ReportLocale } from "./locale.ts";
-import type { ReportInput } from "./types.ts";
+import type { AttemptLocator } from "../../results/locator.ts";
+import type { AttemptEvidence } from "../../results/attempt-evidence.ts";
+import type { Results, Scope } from "../../results/types.ts";
+import { type ReportLocale } from "../model/locale.ts";
+import type { ReportInput } from "../model/types.ts";
 import type { ReportMeta } from "./report.ts";
+/** scope-input page 的当前页上下文:消费宿主选择的 Scope,没有 locator/evidence。 */
+export interface ScopePageContext {
+    id: string;
+    input: "scope";
+}
+/** attempt-input page 的当前页上下文:按 locator 消费一份 AttemptEvidence。 */
+export interface AttemptPageContext {
+    id: string;
+    input: "attempt";
+    locator: AttemptLocator;
+    evidence: AttemptEvidence;
+}
+/**
+ * 当前渲染中的页判别联合(docs/feature/reports/library/shell.md「行为约束」、
+ * library/attempt-detail.md「page 输入与 spec / data 形态」)。经 ComposeContext.page 与
+ * ResolveContext.page 双双可见:组合组件靠它读当前页 id 与输入分支;attempt 叶子组件靠它
+ * 取省略 input 时的缺省 evidence。
+ */
+export type PageContext = ScopePageContext | AttemptPageContext;
 /** 标准 jsx-runtime 元素形状;text 宿主只认 type / props,不管 $$typeof。 */
 export interface ReportElement {
     type: unknown;
@@ -34,8 +54,12 @@ export interface TextContext {
     locale: ReportLocale;
     /** 容器组件渲染 children 用,宽度显式传递。 */
     render(node: ReportNode, width?: number): string;
-    /** 下钻命令,通证据室:`niceeval show @<locator>`。 */
-    attemptCommand(locator: AttemptLocator): string;
+    /**
+     * 下钻命令,通 attempt-input page:`niceeval show @<locator>`。当前报告没有声明
+     * attempt-input page 时不存在——宿主不生成假命令,locator 只是文本(architecture.md
+     * 「Attempt 详情是一张参数化 page」)。
+     */
+    attemptCommand?(locator: AttemptLocator): string;
     /**
      * 组索引一类「按实验收窄」命令的生成;宿主注入以携带完整上下文(--results / --report /
      * --page 与位置参数),默认 `niceeval show --exp <id>`。非契约字段,官方组件内部用。
@@ -43,14 +67,20 @@ export interface TextContext {
     experimentCommand(experimentIdPrefix: string): string;
 }
 export interface WebContext {
-    /** 证据室深链,同 view 的 attempt 路由(`#/attempt/@<locator>`,单段、不透明)。 */
-    attemptHref(locator: AttemptLocator): string;
+    /**
+     * attempt-input page 深链,同 view 的 attempt 路由(`#/attempt/@<locator>`,单段、不透明)。
+     * 当前报告没有声明 attempt-input page 时不存在——宿主不生成空 href 或假链接,locator 只是
+     * 文本(architecture.md「Attempt 详情是一张参数化 page」)。
+     */
+    attemptHref?(locator: AttemptLocator): string;
     /** chrome 文案的 locale;官方组件渲染面经上下文读取,宿主外默认 "en"。 */
     locale: ReportLocale;
 }
 /** 双面组件解析面的上下文:宿主注入的数据来源;props 显式给出 input 时以 props 为准。 */
 export interface ResolveContext {
     input: ReportInput;
+    /** 当前页判别;attempt 叶子组件省略 input 时从这里的 attempt 分支取缺省 evidence。 */
+    page: PageContext;
 }
 /** 组合组件的上下文:宿主 Scope、结果根完整读取面与规范化后的报告声明。 */
 export interface ComposeContext {
@@ -60,6 +90,8 @@ export interface ComposeContext {
     results: Results;
     /** 规范化后的报告声明,只读(docs/feature/reports/library/layout.md「自定义组件」)。 */
     report: ReportMeta;
+    /** 当前页判别:scope 分支只有 id;attempt 分支带 locator + evidence。 */
+    page: PageContext;
 }
 export interface ComponentFaces<P, R = P> {
     /**
@@ -86,8 +118,6 @@ export type ReportComponent<P> = ((props: P) => ReactNode) & {
 };
 /** web 宿主用:在给定 WebContext 下同步渲染(React 静态渲染本身是同步的)。 */
 export declare function runWithWebContext<T>(ctx: WebContext, fn: () => T): T;
-/** 官方组件的装配用:宿主上下文激活时才把 ctx.attemptHref 当默认下钻。 */
-export declare function isHostWebContextActive(): boolean;
 /** 函数形态:组合组件,只装配已有组件,可以异步;ctx 携带 scope / results / report。 */
 export declare function defineComponent<P>(compose: (props: P, context: ComposeContext) => ReportNode | Promise<ReportNode>): ReportComponent<P>;
 /** 对象形态:双面组件,自己渲染;text 与 web 两面必填,可选 resolve 承担取数。 */
@@ -105,11 +135,13 @@ export declare class ResolveMemo {
     private readonly entries;
     fetch(fn: unknown, input: unknown, spec: unknown, compute: () => Promise<unknown>): Promise<unknown>;
 }
-/** resolveReportTree 的环境:宿主注入的 Scope / 读取面 / 规范化声明。 */
+/** resolveReportTree 的环境:宿主注入的 Scope / 读取面 / 规范化声明 / 当前页判别。 */
 export interface ResolveEnv {
     scope: Scope;
     results: Results;
     report: ReportMeta;
+    /** 当前渲染的页:scope 分支只有 id;attempt 分支带 locator + evidence。 */
+    page: PageContext;
     /** 一次页渲染一份;跨页共享缓存时由宿主显式传同一实例。 */
     memo?: ResolveMemo;
 }

package/dist/report/{tree.js → definition/tree.js}

@@ -8,7 +8,7 @@
 // 同层并行保声明序,按「同引用 input + 深相等 spec」记忆化)→ validate(两面资格)→
 // render(纯同步)。渲染面是纯同步函数:零 IO、零 await —— 可达百 MB 的 artifact
 // 只在 resolve 阶段被懒加载,永远不进渲染路径。
-import { DEFAULT_REPORT_LOCALE } from "./locale.js";
+import { DEFAULT_REPORT_LOCALE } from "../model/locale.js";
 // react/jsx-runtime 的 Fragment 是注册符号,跨 react 版本稳定;不 import react 也认得它
 const REACT_FRAGMENT = Symbol.for("react.fragment");
 function isReportElement(node) {
@@ -32,9 +32,9 @@ export const COMPONENT_ROLE = Symbol.for("niceeval.report.role");
  */
 export const COMPONENT_RAW_CHILDREN = Symbol.for("niceeval.report.rawChildren");
 // web 面的环境上下文:web 宿主渲染前设好;宿主之外(组件直接嵌进用户 React 应用)
-// 用默认值 —— attemptHref 默认 view 的 attempt 路由格式。
+// 用默认值——没有 attemptHref,组件显式传 prop 才产生外部链接(architecture.md
+// 「Attempt 详情是一张参数化 page」:没有 target 时 locator 只是文本,不生成假 href)。
 const DEFAULT_WEB_CONTEXT = {
-    attemptHref: (locator) => `#/attempt/${locator}`,
     locale: DEFAULT_REPORT_LOCALE,
 };
 let activeWebContext = null;
@@ -49,10 +49,6 @@ export function runWithWebContext(ctx, fn) {
         activeWebContext = prev;
     }
 }
-/** 官方组件的装配用:宿主上下文激活时才把 ctx.attemptHref 当默认下钻。 */
-export function isHostWebContextActive() {
-    return activeWebContext !== null;
-}
 export function defineComponent(input) {
     if (typeof input === "function") {
         const component = ((_props) => {
@@ -176,7 +172,7 @@ function bareTextError(value, path) {
  */
 export async function resolveReportTree(node, env) {
     const memo = env.memo ?? new ResolveMemo();
-    const composeCtx = { scope: env.scope, results: env.results, report: env.report };
+    const composeCtx = { scope: env.scope, results: env.results, report: env.report, page: env.page };
     return resolveNode(node, { memo, composeCtx }, []);
 }
 async function resolveNode(node, state, path) {
@@ -214,6 +210,7 @@ async function resolveNode(node, state, path) {
             const input = props.input ?? state.composeCtx.scope;
             const ctx = {
                 input,
+                page: state.composeCtx.page,
                 memoFetch: (dataFn, dataInput, options, compute) => state.memo.fetch(dataFn, dataInput, options, compute),
             };
             const resolved = await state.memo.fetch(resolveFn, input, props, async () => resolveFn(props, ctx));
@@ -348,9 +345,10 @@ function shellQuote(value) {
 export function createTextContext(options) {
     const width = Math.max(20, options?.width ?? 80);
     const locale = options?.locale ?? DEFAULT_REPORT_LOCALE;
-    // 默认下钻命令:AttemptLocator 是 `@` 前缀的不透明短串,`niceeval show @<locator>` 是
-    // show 已实现的真实 CLI 语法,不需要反查 eval id 再拼一条近似命令。
-    const attemptCommand = options?.attemptCommand ?? ((locator) => `niceeval show ${locator}`);
+    // 没有默认值:当前报告没有声明 attempt-input page 时不存在下钻命令——宿主(report.ts /
+    // web.ts 的渲染入口)据规范化 definition 是否有 attempt page 决定要不要注入生成器,
+    // 这里只透传调用方给的值(architecture.md「Attempt 详情是一张参数化 page」)。
+    const attemptCommand = options?.attemptCommand;
     const experimentCommand = options?.experimentCommand ?? ((prefix) => `niceeval show --exp ${shellQuote(prefix)}`);
     const make = (w) => ({
         width: w,

package/dist/report/index.d.ts

@@ -1,19 +1,34 @@
-export { assistantTurns, costUSD, defineMetric, durationMs, endToEndPassRate, examScore, executionReliability, repeatedFailedCommands, taskPassRate, tokens, } from "./metrics.ts";
-export { flag, numericFlag, numericRunConfig, runConfig } from "./flag.ts";
-export { buildReportMeta, defineReport, isReportDefinition, pickReportPage, renderReportToText, renderReportTreeToText, reportTitleText, resolveReportTitle, ReportPageNotFoundError, DEFAULT_PAGE_ID, } from "./report.ts";
-export type { HostCommandContext, NonEmptyArray, RenderReportTextOptions, RenderTreeTextOptions, ReportTreeHostContext, HeadTag, ReportAsset, ReportDef, ReportDefinition, ReportHostContext, ReportLink, ReportMeta, ReportPage, ReportShell, } from "./report.ts";
-export { defineComponent, createTextContext, renderNodeToText, resolveReportTree, validateReportTree, ResolveMemo } from "./tree.ts";
-export type { ComponentFaces, ComposeContext, ReportComponent, ReportElement, ReportNode, ResolveContext, ResolveEnv, TextContext, TextRenderOptions, WebContext, } from "./tree.ts";
-export { Col, Row, Section, Style, Tab, Table, Tabs, Text } from "./primitives.tsx";
-export type { ColProps, LayoutProps, RowProps, SectionProps, StyleProps, TabProps, TableColumn, TableProps, TableRow, TabsProps, TextProps, } from "./primitives.tsx";
-export { stringWidth, padDisplay as padEnd, padStartDisplay as padStart, wrapDisplay as wrapText, indentBlock as indent, textBar as bar, joinColumns as columns, } from "./text/layout.ts";
-export type { ColumnAlign } from "./text/layout.ts";
-export { DEFAULT_REPORT_LOCALE, localizedTextEquals, resolveLocalizedText, resolveMetricLabel } from "./locale.ts";
-export type { LocalizedText, ReportLocale } from "./locale.ts";
-export { AttemptList, CopyFixPrompt, DeltaTable, EvalList, ExperimentComparison, ExperimentList, FailureList, Hero, HeroCard, MetricBars, MetricLine, MetricMatrix, MetricScatter, MetricTable, PoweredBy, Scoreboard, ScopeSummary, ScopeWarnings, TraceWaterfall, } from "./components.tsx";
-export type { AttemptListProps, CopyFixPromptProps, DataProps, DeltaTableProps, EvalListProps, ExperimentComparisonProps, ExperimentListProps, FailureListProps, HeroCardProps, HeroProps, MetricBarsProps, MetricLineProps, MetricMatrixProps, MetricScatterProps, MetricTableProps, ScoreboardProps, ScopeSummaryProps, ScopeWarningsProps, TraceWaterfallProps, } from "./components.tsx";
-export { attemptListData, copyFixPromptData, deltaTableData, evalListData, experimentComparisonData, experimentListData, heroData, metricLineData, metricMatrixData, metricScatterData, metricTableData, pairsByFlag, scopeSummaryData, scopeWarningsData, scoreboardData, traceWaterfallData, } from "./compute.ts";
-export type { DeltaTableOptions, MetricLineOptions, MetricMatrixOptions, MetricScatterOptions, MetricTableOptions, ScoreboardOptions, } from "./compute.ts";
-export type { Aggregator, AttemptListItem, AttemptLocator, BuiltInDimension, CopyFixPromptData, CustomDimension, DeltaData, DeltaPair, DimensionInput, DimensionOptions, DimensionRef, EvalListItem, ExperimentComparisonData, ExperimentComparisonGroupData, ExperimentListEvalRow, ExperimentListItem, FlagPairs, HeroData, LineData, MatrixData, Metric, MetricAggregate, MetricCell, MetricColumn, NumericAxis, NumericAxisOptions, NumericRunConfigAxisOptions, ReportInput, RunConfigKey, ScatterData, ScopeSummaryData, ScopeWarning, ScoreboardData, TableData, TraceSpanSummary, TraceWaterfallRow, VerdictTally, } from "./types.ts";
+export { assistantTurns, costUSD, defineMetric, durationMs, endToEndPassRate, examScore, executionReliability, repeatedFailedCommands, taskPassRate, tokens, } from "./model/metrics.ts";
+export { flag, label, numericFlag, numericLabel, numericRunConfig, runConfig } from "./model/flag.ts";
+export { buildReportMeta, defineReport, isReportDefinition, resolveReportTitle, DEFAULT_PAGE_ID, } from "./definition/report.ts";
+export type { NonEmptyArray, HeadTag, ReportAsset, ReportDef, ReportDefinition, ReportLink, ReportMeta, ReportMetaPage, ReportPage, ReportPageBase, ReportShell, } from "./definition/report.ts";
+export { pickReportPage, renderReportToText, renderReportTreeToText, reportTitleText, ReportPageNotFoundError, ReportPageNeedsLocatorError, } from "./runtime/text.ts";
+export type { HostCommandContext, RenderReportTextOptions, RenderTreeTextOptions, ReportTreeHostContext, ReportHostContext, } from "./runtime/text.ts";
+export { defineComponent, createTextContext, renderNodeToText, resolveReportTree, validateReportTree, ResolveMemo } from "./definition/tree.ts";
+export type { AttemptEvidence, AttemptEvidenceCapabilities } from "../results/attempt-evidence.ts";
+export type { AttemptPageContext, ComponentFaces, ComposeContext, PageContext, ReportComponent, ReportElement, ReportNode, ResolveContext, ResolveEnv, ScopePageContext, TextContext, TextRenderOptions, WebContext, } from "./definition/tree.ts";
+export { Col, Grid, Row, Section, Stat, Style, Tab, Table, Tabs, Text } from "./definition/primitives.tsx";
+export type { ColProps, GridProps, LayoutProps, RowProps, SectionProps, StatProps, StatTone, StyleProps, TabProps, TableColumn, TableProps, TableRow, TabsProps, TextProps, } from "./definition/primitives.tsx";
+export { stringWidth, padDisplay as padEnd, padStartDisplay as padStart, wrapDisplay as wrapText, indentBlock as indent, textBar as bar, joinColumns as columns, } from "./model/text-layout.ts";
+export type { ColumnAlign } from "./model/text-layout.ts";
+export { DEFAULT_REPORT_LOCALE, localizedTextEquals, resolveLocalizedText, resolveMetricLabel } from "./model/locale.ts";
+export type { LocalizedText, ReportLocale } from "./model/locale.ts";
+export { ScopeSummary, ExperimentComparison } from "./components/summaries/index.tsx";
+export type { ScopeSummaryProps, ExperimentComparisonProps } from "./components/summaries/index.tsx";
+export { AttemptList, EvalList, ExperimentList, FailureList } from "./components/entity-lists/index.tsx";
+export type { AttemptListProps, EvalListProps, ExperimentListProps, FailureListProps, } from "./components/entity-lists/index.tsx";
+export { DeltaTable, MetricBars, MetricLine, MetricMatrix, MetricScatter, MetricTable, Scoreboard, } from "./components/metric-views/index.tsx";
+export type { DeltaTableProps, MetricBarsProps, MetricLineProps, MetricMatrixProps, MetricScatterProps, MetricTableProps, ScoreboardProps, } from "./components/metric-views/index.tsx";
+export { CopyFixPrompt, Hero, HeroCard, PoweredBy, ScopeWarnings, TraceWaterfall, } from "./components/site-components/index.tsx";
+export type { CopyFixPromptProps, HeroCardProps, HeroProps, ScopeWarningsProps, TraceWaterfallProps, } from "./components/site-components/index.tsx";
+export { AttemptAssertions, AttemptAssessment, AttemptConversation, AttemptDetail, AttemptDiagnostics, AttemptDiff, AttemptError, AttemptFixPrompt, AttemptSource, AttemptSummary, AttemptTimeline, AttemptTrace, AttemptUsage, } from "./components/attempt-detail/index.tsx";
+export type { AttemptSectionProps } from "./components/attempt-detail/index.tsx";
+export { scopeSummaryData } from "./components/summaries/compute.ts";
+export { attemptListData, evalListData, experimentListData } from "./components/entity-lists/compute.ts";
+export { deltaTableData, metricLineData, metricMatrixData, metricScatterData, metricTableData, pairsByFlag, scoreboardData, } from "./components/metric-views/compute.ts";
+export type { DeltaTableOptions, MetricLineOptions, MetricMatrixOptions, MetricScatterOptions, MetricTableOptions, ScoreboardOptions, } from "./components/metric-views/compute.ts";
+export { copyFixPromptData, heroData, scopeWarningsData, traceWaterfallData, } from "./components/site-components/compute.ts";
+export { attemptAssertionsData, attemptConversationData, attemptDiagnosticsData, attemptDiffData, attemptErrorData, attemptFixPromptData, attemptSourceData, attemptSummaryData, attemptTimelineData, attemptTraceData, attemptUsageData, } from "./components/attempt-detail/compute.ts";
+export type { Aggregator, AttemptListItem, AttemptLocator, BuiltInDimension, CopyFixPromptData, CustomDimension, DeltaData, DeltaPair, DimensionInput, DimensionOptions, DimensionRef, EvalListItem, ExperimentListEvalRow, ExperimentListItem, FlagPairs, HeroData, LineData, MatrixData, Metric, MetricAggregate, MetricCell, MetricColumn, NumericAxis, NumericAxisOptions, NumericRunConfigAxisOptions, ReportInput, RunConfigKey, ScatterData, ScopeSummaryData, ScopeWarning, ScoreboardData, SeriesInput, TableData, TraceSpanSummary, TraceWaterfallRow, VerdictTally, } from "./model/types.ts";
+export type { AttemptAssertionsData, AttemptConversationData, AttemptConversationReply, AttemptConversationRound, AttemptDiagnosticsData, AttemptDiffData, AttemptDiffFileEntry, AttemptErrorData, AttemptFixPromptData, AttemptSourceData, AttemptSummaryData, AttemptTimelineData, AttemptTraceData, AttemptUsageData, } from "./model/types.ts";
 export type { AttemptHandle, Results, Scope, Snapshot } from "../results/types.ts";
-export { experimentGroupOf } from "../shared/aggregate.ts";