niceeval 0.9.0 → 0.10.0

package/dist/report/components/attempt-detail/index.js

@@ -0,0 +1,527 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { defineComponent } from "../../definition/tree.js";
+import { Col } from "../../definition/primitives.js";
+import { arrayProblem, dataShapeError, isObject } from "../shared.js";
+import { attemptAssertionsData, attemptConversationData, attemptDiagnosticsData, attemptDiffData, attemptErrorData, attemptFixPromptData, attemptSourceData, attemptSummaryData, attemptTimelineData, attemptTraceData, attemptUsageData, } from "./compute.js";
+import { attemptAssertionsText, attemptConversationText, attemptDiagnosticsText, attemptDiffText, attemptErrorText, attemptFixPromptText, attemptSourceText, attemptSummaryText, attemptTimelineText, attemptTraceText, attemptUsageText, } from "./faces.js";
+import { AttemptSummary as AttemptSummaryWeb } from "./AttemptSummary.js";
+import { AttemptError as AttemptErrorWeb } from "./AttemptError.js";
+import { AttemptAssertions as AttemptAssertionsWeb } from "./AttemptAssertions.js";
+import { AttemptSource as AttemptSourceWeb } from "./AttemptSource.js";
+import { AttemptFixPrompt as AttemptFixPromptWeb } from "./AttemptFixPrompt.js";
+import { AttemptTimeline as AttemptTimelineWeb } from "./AttemptTimeline.js";
+import { AttemptConversation as AttemptConversationWeb } from "./AttemptConversation.js";
+import { AttemptDiagnostics as AttemptDiagnosticsWeb } from "./AttemptDiagnostics.js";
+import { AttemptUsage as AttemptUsageWeb } from "./AttemptUsage.js";
+import { AttemptTrace as AttemptTraceWeb } from "./AttemptTrace.js";
+import { AttemptDiff as AttemptDiffWeb } from "./AttemptDiff.js";
+/**
+ * 11 个叶子组件共用的装配:resolve 决定 evidence 来源(显式 data > 显式 input > 当前
+ * attempt-input page 注入的 evidence),不在 scope-input page 上凭空工作;两面渲染前都
+ * 校验 data 结构,版本漂移时报完整用户反馈而不是静默展示错误字段。
+ */
+function makeAttemptComponent(def) {
+    const assertData = (data) => {
+        if (data === null)
+            return null;
+        const problem = def.validate(data);
+        if (problem !== null)
+            throw dataShapeError(def.name, def.dataFnName, def.shapeName, problem);
+        return data;
+    };
+    const resolve = (props, ctx) => {
+        if (props.data !== undefined) {
+            if (props.input !== undefined) {
+                throw new Error(`<${def.name}> got both \`data\` and \`input\` — the two evidence sources are exclusive and niceeval will not silently pick one. ` +
+                    `Keep \`data\` (precomputed with ${def.dataFnName}()) and drop \`input\`, or drop \`data\` and let the pipeline compute it from the evidence.`);
+            }
+            assertData(props.data);
+            return { data: props.data, className: props.className };
+        }
+        const evidence = props.input ?? (ctx.page.input === "attempt" ? ctx.page.evidence : undefined);
+        if (evidence === undefined) {
+            throw new Error(`<${def.name}> needs an attempt: the current page has no locator to derive evidence from (it is a scope-input page, or no page context is active). ` +
+                `Move it to an attempt-input page (\`input: "attempt"\`), or pass \`input\` explicitly with an AttemptEvidence.`);
+        }
+        return { data: def.dataFn(evidence), className: props.className };
+    };
+    const component = defineComponent({
+        resolve,
+        web: (props, ctx) => {
+            assertData(props.data);
+            return def.web(props, ctx);
+        },
+        text: (props, ctx) => {
+            assertData(props.data);
+            return def.text(props, ctx);
+        },
+    });
+    component.displayName = def.name;
+    return component;
+}
+// ───────────────────────── 跨叶子复用的字段路径校验 ─────────────────────────
+/** SourceLoc(src/shared/types.ts):`t.send` / 断言在 eval 源码里的调用点。 */
+function sourceLocProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be a SourceLoc { file, line }`;
+    if (typeof value.file !== "string")
+        return `"${path}.file" must be a string`;
+    if (typeof value.line !== "number")
+        return `"${path}.line" must be a number`;
+    return null;
+}
+/** AssertionResult(src/scoring/types.ts):按 outcome 判别的联合,passed/failed 要 score,unavailable 要 reason。 */
+function assertionResultProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be an AssertionResult object`;
+    if (typeof value.name !== "string")
+        return `"${path}.name" must be a string`;
+    if (value.severity !== "gate" && value.severity !== "soft")
+        return `"${path}.severity" must be "gate" or "soft"`;
+    if (value.outcome === "passed" || value.outcome === "failed") {
+        if (typeof value.score !== "number")
+            return `"${path}.score" must be a number`;
+        return null;
+    }
+    if (value.outcome === "unavailable") {
+        if (typeof value.reason !== "string")
+            return `"${path}.reason" must be a string`;
+        return null;
+    }
+    return `"${path}.outcome" must be "passed" | "failed" | "unavailable"`;
+}
+/** TraceSpan(src/o11y/types.ts):AttemptTimeline 的 trace 与 AttemptTrace 的 spans 共用。 */
+function traceSpanProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be a TraceSpan { traceId, spanId, name, startMs, endMs }`;
+    if (typeof value.traceId !== "string")
+        return `"${path}.traceId" must be a string`;
+    if (typeof value.spanId !== "string")
+        return `"${path}.spanId" must be a string`;
+    if (typeof value.name !== "string")
+        return `"${path}.name" must be a string`;
+    if (typeof value.startMs !== "number")
+        return `"${path}.startMs" must be a number`;
+    if (typeof value.endMs !== "number")
+        return `"${path}.endMs" must be a number`;
+    return null;
+}
+// ───────────────────────── AttemptSummary(恒非空) ─────────────────────────
+/** AttemptIdentity(src/results/locator.ts):locator 派生自的不可变身份元组。 */
+function attemptIdentityProblem(value, path) {
+    if (!isObject(value)) {
+        return `"${path}" must be an AttemptIdentity { experimentId, snapshotStartedAt, evalId, attempt }`;
+    }
+    if (typeof value.experimentId !== "string")
+        return `"${path}.experimentId" must be a string`;
+    if (typeof value.snapshotStartedAt !== "string")
+        return `"${path}.snapshotStartedAt" must be a string`;
+    if (typeof value.evalId !== "string")
+        return `"${path}.evalId" must be a string`;
+    if (typeof value.attempt !== "number")
+        return `"${path}.attempt" must be a number`;
+    return null;
+}
+/** AttemptEvidenceCapabilities(src/results/attempt-evidence.ts):四个证据切面开关。 */
+function capabilitiesProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be an object { source, execution, timing, diff }`;
+    for (const key of ["source", "execution", "timing", "diff"]) {
+        if (typeof value[key] !== "boolean")
+            return `"${path}.${key}" must be a boolean`;
+    }
+    return null;
+}
+export function validateSummaryData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.locator !== "string")
+        return 'missing "locator" (string)';
+    const identityProblem = attemptIdentityProblem(data.identity, "identity");
+    if (identityProblem !== null)
+        return identityProblem;
+    if (typeof data.verdict !== "string")
+        return 'missing "verdict" (string)';
+    if (typeof data.durationMs !== "number")
+        return '"durationMs" must be a number';
+    if (!(data.costUSD === null || typeof data.costUSD === "number"))
+        return '"costUSD" must be a number or null';
+    return capabilitiesProblem(data.capabilities, "capabilities");
+}
+export const AttemptSummary = makeAttemptComponent({
+    name: "AttemptSummary",
+    dataFnName: "attemptSummaryData",
+    shapeName: "AttemptSummaryData",
+    dataFn: attemptSummaryData,
+    validate: validateSummaryData,
+    web: (props, ctx) => _jsx(AttemptSummaryWeb, { data: props.data, locale: ctx.locale, className: props.className }),
+    text: (props, ctx) => attemptSummaryText(props.data, ctx),
+});
+// ───────────────────────── AttemptError ─────────────────────────
+export function validateErrorData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.code !== "string")
+        return '"code" must be a string';
+    if (typeof data.message !== "string")
+        return '"message" must be a string';
+    if (typeof data.phase !== "string")
+        return '"phase" must be a string';
+    return null;
+}
+export const AttemptError = makeAttemptComponent({
+    name: "AttemptError",
+    dataFnName: "attemptErrorData",
+    shapeName: "AttemptErrorData",
+    dataFn: attemptErrorData,
+    validate: validateErrorData,
+    web: (props, ctx) => _jsx(AttemptErrorWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptErrorText(props.data, ctx),
+});
+// ───────────────────────── AttemptAssertions ─────────────────────────
+export function validateAssertionsData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    const attentionProblem = arrayProblem(data.attention, "attention", assertionResultProblem);
+    if (attentionProblem !== null)
+        return attentionProblem;
+    return arrayProblem(data.passedGroups, "passedGroups", (group, path) => {
+        if (!isObject(group) || typeof group.group !== "string") {
+            return `"${path}" must be an object with a string "group"`;
+        }
+        return arrayProblem(group.items, `${path}.items`, assertionResultProblem);
+    });
+}
+export const AttemptAssertions = makeAttemptComponent({
+    name: "AttemptAssertions",
+    dataFnName: "attemptAssertionsData",
+    shapeName: "AttemptAssertionsData",
+    dataFn: attemptAssertionsData,
+    validate: validateAssertionsData,
+    web: (props, ctx) => _jsx(AttemptAssertionsWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptAssertionsText(props.data, ctx),
+});
+// ───────────────────────── AttemptSource ─────────────────────────
+/** AnnotatedSourceLine(src/results/annotated-source.ts):一行源码 + 映射到这一行的断言 / send 标注。 */
+function annotatedSourceLineProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be an AnnotatedSourceLine { line, text, assertions, sends }`;
+    if (typeof value.line !== "number")
+        return `"${path}.line" must be a number`;
+    if (typeof value.text !== "string")
+        return `"${path}.text" must be a string`;
+    const assertionsProblem = arrayProblem(value.assertions, `${path}.assertions`, assertionResultProblem);
+    if (assertionsProblem !== null)
+        return assertionsProblem;
+    if (!Array.isArray(value.sends))
+        return `"${path}.sends" must be an array`;
+    return null;
+}
+/** AnnotatedEvalSourceSummary(src/results/annotated-source.ts):全是计数字段。 */
+function sourceSummaryProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be an AnnotatedEvalSourceSummary`;
+    for (const key of [
+        "totalAssertions",
+        "mappedAssertions",
+        "unmappedAssertions",
+        "passed",
+        "failed",
+        "gate",
+        "soft",
+        "totalLines",
+        "annotatedLines",
+    ]) {
+        if (typeof value[key] !== "number")
+            return `"${path}.${key}" must be a number`;
+    }
+    return null;
+}
+export function validateSourceData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.locator !== "string")
+        return 'missing "locator" (string)';
+    if (typeof data.sourcePath !== "string")
+        return 'missing "sourcePath" (string)';
+    const linesProblem = arrayProblem(data.lines, "lines", annotatedSourceLineProblem);
+    if (linesProblem !== null)
+        return linesProblem;
+    const unmappedProblem = arrayProblem(data.unmapped, "unmapped", assertionResultProblem);
+    if (unmappedProblem !== null)
+        return unmappedProblem;
+    return sourceSummaryProblem(data.summary, "summary");
+}
+export const AttemptSource = makeAttemptComponent({
+    name: "AttemptSource",
+    dataFnName: "attemptSourceData",
+    shapeName: "AttemptSourceData",
+    dataFn: attemptSourceData,
+    validate: validateSourceData,
+    web: (props, ctx) => _jsx(AttemptSourceWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptSourceText(props.data, ctx),
+});
+// ───────────────────────── AttemptFixPrompt ─────────────────────────
+export function validateFixPromptData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.prompt !== "string")
+        return 'missing "prompt" (string)';
+    return null;
+}
+export const AttemptFixPrompt = makeAttemptComponent({
+    name: "AttemptFixPrompt",
+    dataFnName: "attemptFixPromptData",
+    shapeName: "AttemptFixPromptData",
+    dataFn: attemptFixPromptData,
+    validate: validateFixPromptData,
+    web: (props, ctx) => _jsx(AttemptFixPromptWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptFixPromptText(props.data, ctx),
+});
+// ───────────────────────── AttemptTimeline ─────────────────────────
+/** PhaseTiming(src/runner/types.ts):runner 阶段计时,按执行顺序。 */
+function phaseTimingProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be a PhaseTiming { name, durationMs }`;
+    if (typeof value.name !== "string")
+        return `"${path}.name" must be a string`;
+    if (typeof value.durationMs !== "number")
+        return `"${path}.durationMs" must be a number`;
+    return null;
+}
+export function validateTimelineData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.locator !== "string")
+        return 'missing "locator" (string)';
+    const phasesProblem = arrayProblem(data.phases, "phases", phaseTimingProblem);
+    if (phasesProblem !== null)
+        return phasesProblem;
+    if (data.trace !== null)
+        return arrayProblem(data.trace, "trace", traceSpanProblem);
+    return null;
+}
+export const AttemptTimeline = makeAttemptComponent({
+    name: "AttemptTimeline",
+    dataFnName: "attemptTimelineData",
+    shapeName: "AttemptTimelineData",
+    dataFn: attemptTimelineData,
+    validate: validateTimelineData,
+    web: (props, ctx) => _jsx(AttemptTimelineWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptTimelineText(props.data, ctx),
+});
+// ───────────────────────── AttemptConversation ─────────────────────────
+const CONVERSATION_REPLY_KINDS = [
+    "assistant",
+    "user",
+    "thinking",
+    "error",
+    "tool",
+    "skill",
+    "subagent",
+    "input",
+    "compaction",
+    "raw",
+];
+/**
+ * AttemptConversationReply(src/report/model/types.ts):按 `kind` 判别的联合,每支自己的必填
+ * 字段各自校验——`raw` 是未识别事件类型的兜底分支,不吞没其余 kind 的校验。
+ */
+function conversationReplyProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be an AttemptConversationReply object`;
+    switch (value.kind) {
+        case "assistant":
+        case "user":
+        case "thinking":
+        case "error":
+            if (typeof value.text !== "string")
+                return `"${path}.text" must be a string`;
+            return null;
+        case "tool":
+            if (typeof value.callId !== "string")
+                return `"${path}.callId" must be a string`;
+            if (typeof value.name !== "string")
+                return `"${path}.name" must be a string`;
+            if (!("input" in value))
+                return `"${path}.input" is required`;
+            return null;
+        case "skill":
+            if (typeof value.skill !== "string")
+                return `"${path}.skill" must be a string`;
+            return null;
+        case "subagent":
+            if (typeof value.callId !== "string")
+                return `"${path}.callId" must be a string`;
+            if (typeof value.name !== "string")
+                return `"${path}.name" must be a string`;
+            return null;
+        case "input":
+            if (!isObject(value.request))
+                return `"${path}.request" must be an InputRequest object`;
+            return null;
+        case "compaction":
+            return null;
+        case "raw":
+            if (!("raw" in value))
+                return `"${path}.raw" is required`;
+            return null;
+        default:
+            return `"${path}.kind" must be one of ${JSON.stringify(CONVERSATION_REPLY_KINDS)}`;
+    }
+}
+function conversationRoundProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be an AttemptConversationRound { sentText, replies }`;
+    if (typeof value.sentText !== "string")
+        return `"${path}.sentText" must be a string`;
+    if (value.loc !== undefined) {
+        const locProblem = sourceLocProblem(value.loc, `${path}.loc`);
+        if (locProblem !== null)
+            return locProblem;
+    }
+    return arrayProblem(value.replies, `${path}.replies`, conversationReplyProblem);
+}
+export function validateConversationData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.locator !== "string")
+        return 'missing "locator" (string)';
+    return arrayProblem(data.rounds, "rounds", conversationRoundProblem);
+}
+export const AttemptConversation = makeAttemptComponent({
+    name: "AttemptConversation",
+    dataFnName: "attemptConversationData",
+    shapeName: "AttemptConversationData",
+    dataFn: attemptConversationData,
+    validate: validateConversationData,
+    web: (props, ctx) => _jsx(AttemptConversationWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptConversationText(props.data, ctx),
+});
+// ───────────────────────── AttemptDiagnostics ─────────────────────────
+/** DiagnosticRecord(src/runner/types.ts):`level` 是消息严重度,不是 verdict 的别名。 */
+function diagnosticRecordProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be a DiagnosticRecord { code, level, message, phase }`;
+    if (typeof value.code !== "string")
+        return `"${path}.code" must be a string`;
+    if (value.level !== "warning" && value.level !== "error")
+        return `"${path}.level" must be "warning" or "error"`;
+    if (typeof value.message !== "string")
+        return `"${path}.message" must be a string`;
+    if (typeof value.phase !== "string")
+        return `"${path}.phase" must be a string`;
+    return null;
+}
+export function validateDiagnosticsData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    return arrayProblem(data.groups, "groups", (group, path) => {
+        if (!isObject(group) || typeof group.phase !== "string") {
+            return `"${path}" must be an object with a string "phase"`;
+        }
+        return arrayProblem(group.items, `${path}.items`, diagnosticRecordProblem);
+    });
+}
+export const AttemptDiagnostics = makeAttemptComponent({
+    name: "AttemptDiagnostics",
+    dataFnName: "attemptDiagnosticsData",
+    shapeName: "AttemptDiagnosticsData",
+    dataFn: attemptDiagnosticsData,
+    validate: validateDiagnosticsData,
+    web: (props, ctx) => _jsx(AttemptDiagnosticsWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptDiagnosticsText(props.data, ctx),
+});
+// ───────────────────────── AttemptUsage ─────────────────────────
+/** Usage(src/o11y/types.ts):cacheReadTokens / cacheWriteTokens / requests / costUSD 均可选。 */
+function usageProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be a Usage { inputTokens, outputTokens }`;
+    if (typeof value.inputTokens !== "number")
+        return `"${path}.inputTokens" must be a number`;
+    if (typeof value.outputTokens !== "number")
+        return `"${path}.outputTokens" must be a number`;
+    return null;
+}
+export function validateUsageData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    const usageProb = usageProblem(data.usage, "usage");
+    if (usageProb !== null)
+        return usageProb;
+    if (!(data.costUSD === null || typeof data.costUSD === "number"))
+        return '"costUSD" must be a number or null';
+    return null;
+}
+export const AttemptUsage = makeAttemptComponent({
+    name: "AttemptUsage",
+    dataFnName: "attemptUsageData",
+    shapeName: "AttemptUsageData",
+    dataFn: attemptUsageData,
+    validate: validateUsageData,
+    web: (props, ctx) => _jsx(AttemptUsageWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptUsageText(props.data, ctx),
+});
+// ───────────────────────── AttemptTrace ─────────────────────────
+export function validateTraceData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.locator !== "string")
+        return 'missing "locator" (string)';
+    return arrayProblem(data.spans, "spans", traceSpanProblem);
+}
+export const AttemptTrace = makeAttemptComponent({
+    name: "AttemptTrace",
+    dataFnName: "attemptTraceData",
+    shapeName: "AttemptTraceData",
+    dataFn: attemptTraceData,
+    validate: validateTraceData,
+    web: (props, ctx) => _jsx(AttemptTraceWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptTraceText(props.data, ctx),
+});
+// ───────────────────────── AttemptDiff ─────────────────────────
+const DIFF_FILE_NET = ["added", "modified", "deleted"];
+/** AttemptDiffFileEntry(src/report/model/types.ts):`net` 恒 !== "none"(净无变化不进这份列表)。 */
+function diffFileEntryProblem(value, path) {
+    if (!isObject(value))
+        return `"${path}" must be an AttemptDiffFileEntry { path, net, lines, windows }`;
+    if (typeof value.path !== "string")
+        return `"${path}.path" must be a string`;
+    if (typeof value.net !== "string" || !DIFF_FILE_NET.includes(value.net)) {
+        return `"${path}.net" must be one of ${JSON.stringify(DIFF_FILE_NET)}`;
+    }
+    if (!isObject(value.lines) || typeof value.lines.added !== "number" || typeof value.lines.deleted !== "number") {
+        return `"${path}.lines" must be an object { added, deleted }`;
+    }
+    if (!Array.isArray(value.windows))
+        return `"${path}.windows" must be an array`;
+    return null;
+}
+export function validateDiffData(data) {
+    if (!isObject(data))
+        return "expected an object";
+    if (typeof data.locator !== "string")
+        return 'missing "locator" (string)';
+    return arrayProblem(data.files, "files", diffFileEntryProblem);
+}
+export const AttemptDiff = makeAttemptComponent({
+    name: "AttemptDiff",
+    dataFnName: "attemptDiffData",
+    shapeName: "AttemptDiffData",
+    dataFn: attemptDiffData,
+    validate: validateDiffData,
+    web: (props, ctx) => _jsx(AttemptDiffWeb, { data: props.data, className: props.className }),
+    text: (props, ctx) => attemptDiffText(props.data, ctx),
+});
+// ───────────────────────── 两个普通组合组件 ─────────────────────────
+/** source / assertions fallback:有 source 放 AttemptSource,否则放 AttemptAssertions。 */
+export const AttemptAssessment = defineComponent((_props, ctx) => {
+    if (ctx.page.input !== "attempt") {
+        throw new Error("AttemptAssessment requires an attempt-input page (input: \"attempt\") — it reads ctx.page.evidence to choose between AttemptSource and AttemptAssertions.");
+    }
+    return (_jsxs(Col, { children: [_jsx(AttemptError, {}), ctx.page.evidence.capabilities.source ? _jsx(AttemptSource, {}) : _jsx(AttemptAssertions, {})] }));
+});
+AttemptAssessment.displayName = "AttemptAssessment";
+/** 内建排列顺序;不产生新的 data 或渲染面,用户可以在自己的 attempt-input page 里重排这些叶子。 */
+export const AttemptDetail = defineComponent(() => (_jsxs(Col, { children: [_jsx(AttemptSummary, {}), _jsx(AttemptAssessment, {}), _jsx(AttemptFixPrompt, {}), _jsx(AttemptTimeline, {}), _jsx(AttemptDiagnostics, {}), _jsx(AttemptUsage, {}), _jsx(AttemptConversation, {}), _jsx(AttemptTrace, {}), _jsx(AttemptDiff, {})] })));
+AttemptDetail.displayName = "AttemptDetail";

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

@@ -1,9 +1,11 @@
 import type { ReactElement } from "react";
-import type { MetricCell } from "../types.ts";
+import type { MetricCell } from "../model/types.ts";
 import type { AttemptLocator } from "../../results/locator.ts";
-import { type ReportLocale } from "../locale.ts";
-export declare function MetricCellView({ cell, attemptHref, locale, }: {
+import { type ReportLocale } from "../model/locale.ts";
+export declare function MetricCellView({ cell, attemptHref, locale, showCoverage, }: {
     cell: MetricCell;
     attemptHref?: (locator: AttemptLocator) => string;
     locale?: ReportLocale;
+    /** 默认用紧凑角标显示覆盖率；已有展开说明的摘要卡可关闭角标。 */
+    showCoverage?: boolean;
 }): ReactElement;

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

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_REPORT_LOCALE, localeText, resolveLocalizedText } from "../locale.js";
-export function MetricCellView({ cell, attemptHref, locale = DEFAULT_REPORT_LOCALE, }) {
+import { DEFAULT_REPORT_LOCALE, localeText, resolveLocalizedText } from "../model/locale.js";
+export function MetricCellView({ cell, attemptHref, locale = DEFAULT_REPORT_LOCALE, showCoverage = true, }) {
     // 全 null(没有任何有效样本)→ 缺数据文案,绝不画 0;total 仍如实入 title
     if (cell.value === null) {
         return (_jsx("span", { className: "nre-cell nre-cell-missing", children: _jsx("span", { className: "nre-missing", title: localeText(locale, "cell.noneMeasurableTitle", { total: cell.total }), children: localeText(locale, "cell.missing") }) }));
     }
-    return (_jsxs("span", { className: "nre-cell", children: [_jsx("span", { className: "nre-value", title: localeText(locale, "cell.measuredTitle", { samples: cell.samples, total: cell.total }), children: resolveLocalizedText(cell.display, locale) }), cell.samples < cell.total && (_jsxs("sup", { className: "nre-coverage", title: localeText(locale, "cell.coverageTitle", { samples: cell.samples, total: cell.total }), children: [cell.samples, "/", cell.total] })), attemptHref && cell.refs && cell.refs.length > 0 && (_jsx("span", { className: "nre-refs", children: cell.refs.map((locator, i) => (_jsxs("a", { className: "nre-ref", href: attemptHref(locator), children: ["#", i + 1] }, locator))) }))] }));
+    return (_jsxs("span", { className: "nre-cell", children: [_jsx("span", { className: "nre-value", title: localeText(locale, "cell.measuredTitle", { samples: cell.samples, total: cell.total }), children: resolveLocalizedText(cell.display, locale) }), showCoverage && cell.samples < cell.total && (_jsxs("sup", { className: "nre-coverage", title: localeText(locale, "cell.coverageTitle", { samples: cell.samples, total: cell.total }), children: [cell.samples, "/", cell.total] })), attemptHref && cell.refs && cell.refs.length > 0 && (_jsx("span", { className: "nre-refs", children: cell.refs.map((locator, i) => (_jsxs("a", { className: "nre-ref", href: attemptHref(locator), children: ["#", i + 1] }, locator))) }))] }));
 }

package/dist/report/{react → components/entity-lists}/AttemptList.d.ts

@@ -1,8 +1,12 @@
 import type { ReactElement } from "react";
-import type { AttemptListItem } from "../types.ts";
-import type { AttemptLocator } from "../../results/locator.ts";
-import { type ReportLocale } from "../locale.ts";
-/** locator + 判定符的普通 <a>,AttemptList/EvalList/ExperimentList 共用。 */
+import type { AttemptListItem } from "../../model/types.ts";
+import type { AttemptLocator } from "../../../results/locator.ts";
+import { type ReportLocale } from "../../model/locale.ts";
+/**
+ * locator + 判定符,AttemptList/EvalList/ExperimentList 共用。没有 target(当前报告没有
+ * declare attempt-input page,也没有显式 attemptHref)时是纯文本,不生成空 href 或假链接
+ * (docs/feature/reports/architecture.md「Attempt 详情是一张参数化 page」)。
+ */
 export declare function AttemptLocatorBadge({ item, attemptHref, }: {
     item: Pick<AttemptListItem, "locator" | "verdict">;
     attemptHref?: (locator: AttemptLocator) => string;

package/dist/report/{react → components/entity-lists}/AttemptList.js

@@ -1,11 +1,17 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_REPORT_LOCALE, countText, localeText } from "../locale.js";
-import { colorClassForKey } from "./colors.js";
-import { cx, formatDurationMs, formatUSD, verdictMark } from "./format.js";
-const DEFAULT_ATTEMPT_HREF = (locator) => `#/attempt/${locator}`;
-/** locator + 判定符的普通 <a>,AttemptList/EvalList/ExperimentList 共用。 */
-export function AttemptLocatorBadge({ item, attemptHref = DEFAULT_ATTEMPT_HREF, }) {
-    return (_jsxs("a", { className: cx("nre-locator", `nre-verdict-${item.verdict}`), href: attemptHref(item.locator), children: [item.locator, _jsx("span", { className: "nre-locator-mark", children: verdictMark(item.verdict) })] }));
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DEFAULT_REPORT_LOCALE, countText, localeText } from "../../model/locale.js";
+import { colorClassForKey } from "../../assets/colors.js";
+import { formatDurationMs, formatUSD, verdictMark } from "../../model/format.js";
+import { cx } from "../shared.js";
+/**
+ * locator + 判定符,AttemptList/EvalList/ExperimentList 共用。没有 target(当前报告没有
+ * declare attempt-input page,也没有显式 attemptHref)时是纯文本,不生成空 href 或假链接
+ * (docs/feature/reports/architecture.md「Attempt 详情是一张参数化 page」)。
+ */
+export function AttemptLocatorBadge({ item, attemptHref, }) {
+    const className = cx("nre-locator", `nre-verdict-${item.verdict}`);
+    const content = (_jsxs(_Fragment, { children: [item.locator, _jsx("span", { className: "nre-locator-mark", children: verdictMark(item.verdict) })] }));
+    return attemptHref ? (_jsx("a", { className: className, href: attemptHref(item.locator), children: content })) : (_jsx("span", { className: className, children: content }));
 }
 /** failureSummary + moreFailures 的展示形态:摘要原样,+N 计数由 moreFailures 驱动。 */
 export function failureSummaryText(item, locale) {
@@ -16,11 +22,11 @@ export function failureSummaryText(item, locale) {
         : item.failureSummary;
 }
 /** 一条 Attempt 的比较卡片;完整 assertions 通过 locator 下钻,不在列表内展开。 */
-export function AttemptRow({ item, attemptHref = DEFAULT_ATTEMPT_HREF, locale = DEFAULT_REPORT_LOCALE, }) {
+export function AttemptRow({ item, attemptHref, locale = DEFAULT_REPORT_LOCALE, }) {
     const reason = failureSummaryText(item, locale);
     return (_jsxs("li", { className: cx("nre-attempt", `nre-attempt-${item.verdict}`), "data-nre-verdict": item.verdict, children: [_jsxs("div", { className: "nre-attempt-head", children: [_jsx(AttemptLocatorBadge, { item: item, attemptHref: attemptHref }), _jsx("span", { className: "nre-attempt-eval", children: item.evalId }), _jsx("span", { className: "nre-attempt-experiment", children: item.experimentId }), _jsx("span", { className: cx("nre-attempt-agent", "nre-key", colorClassForKey(item.agent)), children: item.agent }), _jsx("span", { className: "nre-attempt-duration", children: formatDurationMs(item.durationMs) }), item.costUSD !== null && _jsx("span", { className: "nre-attempt-cost", children: formatUSD(item.costUSD) })] }), reason && _jsx("p", { className: "nre-attempt-result", children: reason })] }));
 }
-export function AttemptList({ data, total, filter = false, attemptHref = DEFAULT_ATTEMPT_HREF, className, locale = DEFAULT_REPORT_LOCALE, }) {
+export function AttemptList({ data, total, filter = false, attemptHref, className, locale = DEFAULT_REPORT_LOCALE, }) {
     const remaining = (total ?? data.length) - data.length;
     return (_jsxs("section", { className: cx("nre", "nre-attempt-list", className), children: [filter && (_jsx("input", { className: "nre-filter", "data-nre-attempt-filter": "", type: "search", placeholder: localeText(locale, "attemptList.filterPlaceholder") })), data.length === 0 && _jsx("p", { className: "nre-attempt-list-empty", children: localeText(locale, "attemptList.empty") }), _jsx("ul", { className: "nre-attempts", children: data.map((item) => (_jsx(AttemptRow, { item: item, attemptHref: attemptHref, locale: locale }, item.locator))) }), remaining > 0 && (_jsx("p", { className: "nre-truncated", children: localeText(locale, "attemptList.truncated", { n: remaining }) }))] }));
 }

package/dist/report/{react → components/entity-lists}/EvalList.d.ts

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

package/dist/report/{react → components/entity-lists}/ExperimentList.d.ts

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