niceeval 0.12.1 → 0.12.2-canary.31

package/dist/report/definition/table-text.js

@@ -1,187 +0,0 @@
-// <Table> 原语的 text 面(../primitives.tsx 的 Table.text 就是它)。
-// 官方的表状组件(Table / Scoreboard / DeltaTable)的 text 面也直接
-// 调它 —— 官方与自定义表共用同一个渲染器,是「用户组件与官方组件对等」的构造证明:
-// 官方用不上的能力用户就拿不到,官方绕过它手搓它就一定会长歪。
-//
-// 列宽按显示宽度算(CJK 记 2 列);null 渲染 —,不补 0;超宽按比例压左对齐列并在格内折行,
-// 全压到下限仍放不下才从右侧丢列并如实报数(「截断报剩余」是既有契约,不在这里破例)。
-// 画线与不画线是同一份列宽算术:数据格框的列间 ` │ ` 与朴素形态的 `   ` 都占 3 列。
-import { countText, localeText, resolveLocalizedText } from "../model/locale.js";
-import { charDisplayWidth, padDisplay, padStartDisplay, renderAlignedRows, stringWidth, wrapDisplay, } from "../model/text-layout.js";
-import { DATA_BOX_FRAME_OVERHEAD, dataBoxBorder, dataBoxMode, dataBoxRow } from "../model/panel.js";
-const MISSING_MARK = "—";
-/** 列间距,与 renderAlignedRows 的 join("   ") 一致。 */
-const COLUMN_GAP = 3;
-/** 左对齐列的压缩下限:再窄就读不成句,宁可丢列。 */
-const MIN_TEXT_COLUMN = 8;
-/** 身份列(首列)的压缩下限:读不出身份的行等于没有,所以它比其余文本列早停在这个宽度
- *  ——列自然宽本来就短于它时以自然宽为准,不给短列补空。压到这一步还放不下就丢列。 */
-const MIN_IDENTITY_COLUMN = 24;
-/** 格子的文本形态:缺这个键、或值是 null,都渲染 —(与 web 面同源)。 */
-function cellText(row, key) {
-    const value = row.cells[key];
-    return value === null || value === undefined ? MISSING_MARK : value;
-}
-function totalWidth(widths) {
-    return widths.reduce((sum, w) => sum + w, 0) + COLUMN_GAP * Math.max(0, widths.length - 1);
-}
-/**
- * 自然列宽 → 放得进 available 的列宽。两步,顺序即优先级:
- * 1. 按自然宽的比例压所有左对齐列(文本列)到下限 —— 右对齐列是数字,折行读不了,不压;
- *    按比例分摊而不是逐个压最宽的那列:两个都很长的文本列各让一半,比把其中一个压到
- *    下限(读出来是「Experime / nt」)可读得多;
- * 2. 全部压到下限仍放不下,才从右侧丢列(至少留一列),丢了几列如实返回。
- */
-function fitWidths(natural, align, available) {
-    const widths = [...natural];
-    const floorOf = (c) => c === 0 ? Math.min(natural[0] ?? MIN_IDENTITY_COLUMN, MIN_IDENTITY_COLUMN) : MIN_TEXT_COLUMN;
-    for (;;) {
-        const over = totalWidth(widths) - available;
-        if (over <= 0)
-            break;
-        const flexible = widths
-            .map((w, c) => ({ c, w, floor: floorOf(c) }))
-            .filter(({ c, w, floor }) => align[c] !== "right" && w > floor);
-        if (flexible.length === 0)
-            break;
-        // 可压缩总量按各列自己的余量加权分摊;取整后的余数留给下一轮,循环终止于「无列可压」。
-        const slack = flexible.reduce((sum, { w, floor }) => sum + (w - floor), 0);
-        let remaining = Math.min(over, slack);
-        for (const { c, w, floor } of flexible) {
-            if (remaining <= 0)
-                break;
-            const share = Math.min(w - floor, Math.max(1, Math.round((over * (w - floor)) / slack)), remaining);
-            widths[c] = w - share;
-            remaining -= share;
-        }
-    }
-    let hidden = 0;
-    while (widths.length > 1 && totalWidth(widths) > available) {
-        widths.pop();
-        hidden += 1;
-    }
-    return { widths, hidden };
-}
-/** 按显示宽度截到 width(不够放 `…` 时原样返回)。 */
-function truncateDisplay(text, width) {
-    if (stringWidth(text) <= width)
-        return text;
-    let out = "";
-    let used = 0;
-    for (const ch of text) {
-        const w = charDisplayWidth(ch.codePointAt(0));
-        if (used + w > width)
-            break;
-        out += ch;
-        used += w;
-    }
-    return out;
-}
-/** 列的 maxLines 收口:超出的行丢弃,最后一行以 `…` 如实标注被收口。 */
-function clampCellLines(lines, maxLines, width) {
-    if (maxLines === undefined || lines.length <= maxLines)
-        return lines;
-    const kept = lines.slice(0, Math.max(1, maxLines));
-    const last = kept[kept.length - 1];
-    kept[kept.length - 1] = `${truncateDisplay(last, Math.max(1, width - 1))}…`;
-    return kept;
-}
-/**
- * 折行时保住格子开头的缩进:层级就长在首列的缩进上(docs 的「层级与横线」),而 wrapDisplay
- * 会把行首空格吃掉——身份被压窄正是最需要看清层级的时候,不能一折行就把层级折没了。
- * 续行跟着对齐到同一个缩进。
- */
-function wrapIndented(cell, width) {
-    const indent = cell.length - cell.trimStart().length;
-    if (indent === 0)
-        return wrapDisplay(cell, width);
-    const pad = " ".repeat(indent);
-    const body = wrapDisplay(cell.slice(indent), Math.max(1, width - indent));
-    return body.map((line) => `${pad}${line}`);
-}
-/** 逻辑行 → 物理行:每格折到自己的列宽,列带 maxLines 就收口,行高取最高的那格,矮格补空串。 */
-function toPhysicalRows(cells, widths, maxLines) {
-    const wrapped = cells.map((cell, c) => 
-    // 放得下就原样保留:wrapDisplay 会把连续空格折成一个,而 DeltaTable 的
-    // "50% → 62%   +12pp" 这类格子内含固定间距 —— 不折行时一个字节都不能动。
-    clampCellLines(!cell.includes("\n") && stringWidth(cell) <= widths[c] ? [cell] : wrapIndented(cell, widths[c]), maxLines[c], widths[c]));
-    const height = Math.max(...wrapped.map((lines) => lines.length), 1);
-    const out = [];
-    for (let i = 0; i < height; i++)
-        out.push(wrapped.map((lines) => lines[i] ?? ""));
-    return out;
-}
-/**
- * <Table> 的 text 面:columns × rows → 对齐的字符表。
- * 有任一行带 locator 时追加一列 attempt(locator 本身就是 `niceeval show <locator>`
- * 的位置参数;逐行重复整条命令会把表撑宽,与三个实体列表 text 面的既有取舍一致)。
- */
-export function renderTableText(props, ctx) {
-    const locale = props.locale ?? ctx.locale;
-    const hasLocator = props.rows.some((row) => row.locator !== undefined);
-    if (props.columns.length === 0 && !hasLocator)
-        return "";
-    const header = props.columns.map((column) => resolveLocalizedText(column.header, locale));
-    const align = props.columns.map((column) => column.align ?? "left");
-    const body = props.rows.map((row) => props.columns.map((column) => cellText(row, column.key)));
-    if (hasLocator) {
-        header.push(localeText(locale, "table.attempt"));
-        align.push("left");
-        props.rows.forEach((row, i) => body[i].push(row.locator ?? MISSING_MARK));
-    }
-    const matrix = [header, ...body];
-    const natural = header.map((_, c) => Math.max(...matrix.map((row) => stringWidth(row[c] ?? ""))));
-    // 画线时列间距与不画线时相同(` │ ` 与 `   ` 都是 3 列),所以只有外框那 4 列要先让出来。
-    const lines = dataBoxMode(ctx.panelMode, ctx.width) === "boxed";
-    // 嵌在画框的 Section 里:边界已由面板的框给出,自己只留列边界与表头横线,不套二层框。
-    const outerFrame = lines && ctx.sectionBoxedDepth === 0;
-    const available = outerFrame ? ctx.width - DATA_BOX_FRAME_OVERHEAD : ctx.width;
-    const { widths, hidden } = fitWidths(natural, align, available);
-    const maxLines = props.columns.map((column) => column.maxLines);
-    if (hasLocator)
-        maxLines.push(undefined);
-    // 表头不参与 maxLines 收口:表头是自己写的短词,收口只服务数据格。
-    const headerPhysical = toPhysicalRows(header.slice(0, widths.length), widths, widths.map(() => undefined));
-    const bodyBlocks = body.map((row, i) => ({
-        depth: props.rows[i]?.depth ?? 0,
-        physical: toPhysicalRows(row.slice(0, widths.length), widths, maxLines),
-    }));
-    const bodyPhysical = bodyBlocks.flatMap((block) => block.physical);
-    const table = lines
-        ? renderFramedTable(headerPhysical, bodyBlocks, widths, align, outerFrame)
-        : renderAlignedRows([...headerPhysical, ...bodyPhysical], align);
-    return hidden > 0 ? `${table}\n${countText(locale, "table.columnsHidden", hidden)}` : table;
-}
-/**
- * 数据格框形态:列边界贯穿全表,横线画在行树自己的边界上——表头与正文之间一条,行树有
- * 嵌套时每个顶层行之前再一条(一组一格,组内不切)。平表只有表头那一条:逐行切割读起来
- * 是一堆独立小框,层级与分组反而看不出来。分隔只按 depth 判,`Table` 不认识具体实体。
- *
- * 框宽跟随表自己的内容宽度(`fitWidths` 已经把它压进可用列数),不硬拉满终端——
- * 窄表拉满只会让同一行的读数彼此远离。
- */
-function renderFramedTable(header, body, widths, align, outerFrame) {
-    // 实际列宽取该列所有物理行的最宽者:压缩与折行之后不少列比预算更窄,框跟着收。
-    const physical = [...header, ...body.flatMap((block) => block.physical)];
-    const actual = widths.map((w, c) => {
-        const widest = Math.max(...physical.map((row) => stringWidth(row[c] ?? "")), 1);
-        return Math.min(w, widest);
-    });
-    const line = (row) => dataBoxRow(actual.map((w, c) => (align[c] === "right" ? padStartDisplay(row[c] ?? "", w) : padDisplay(row[c] ?? "", w))), outerFrame);
-    const nested = body.some((block) => block.depth > 0);
-    const out = [];
-    if (outerFrame)
-        out.push(dataBoxBorder("top", actual, true));
-    for (const row of header)
-        out.push(line(row));
-    out.push(dataBoxBorder("rule", actual, outerFrame));
-    body.forEach((block, i) => {
-        if (nested && i > 0 && block.depth === 0)
-            out.push(dataBoxBorder("rule", actual, outerFrame));
-        for (const row of block.physical)
-            out.push(line(row));
-    });
-    if (outerFrame)
-        out.push(dataBoxBorder("bottom", actual, true));
-    return out.join("\n");
-}

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

@@ -1,233 +0,0 @@
-import type { ReactNode } from "react";
-import type { Record, Sample } from "../../record/types.ts";
-import { type ReportLocale } from "../model/locale.ts";
-import type { ReportInput } from "../model/types.ts";
-import type { PageRenderInput, ReportMeta, ReportTarget } from "./report.ts";
-import type { PanelMode, PanelRow } from "../model/panel.ts";
-import { type DimensionDeclarations, type DimensionPins, type PresentedDimension } from "../presentation.ts";
-/**
- * 当前渲染中的页上下文(docs/feature/reports/library/shell.md「行为约束」、
- * docs/feature/reports/library.md「defineReport() 保留静态 page 边界」):结构化,不是按实体
- * 种类判别的联合——`input` 是该页 `load`(或省略 load 时宿主选择的 Sample)产出的值,类型随
- * 页而变。经 ComposeContext.page 与 ResolveContext.page 双双可见:组合组件靠它读当前页 id;
- * 消费 attempt 证据的叶子组件对 `input` 做结构校验(参见 `isAttemptEvidence`),不查一个
- * 实体名字段。
- */
-export interface PageContext<Input extends PageRenderInput = PageRenderInput> {
-    id: string;
-    input: Input;
-}
-/** 标准 jsx-runtime 元素形状;text 宿主只认 type / props,不管 $$typeof。 */
-export interface ReportElement {
-    type: string | symbol | ReportComponent<never>;
-    props: object & {
-        readonly children?: ReportNode;
-    };
-    key?: string | number | bigint | null;
-}
-/**
- * 报告树节点,形状穷尽(docs/feature/reports/library/layout.md「树的节点」):
- * 元素、数组 / Fragment(展平保序),或条件渲染的空分支(渲染为空)。
- * 裸字符串与数字**不是**节点——自由文本必须经 <Text> 携带,树校验遇到时按完整用户反馈拒绝。
- */
-export type ReportNode = ReportElement | readonly ReportNode[] | null | undefined | boolean;
-/** 挂 faces 的私有键:管线与树校验靠它识别双面组件。 */
-export declare const COMPONENT_FACES: unique symbol;
-/** 挂组合函数的私有键:resolve 阶段靠它识别组合组件。 */
-export declare const COMPONENT_COMPOSE: unique symbol;
-/** Tabs / Tab 的结构角色标记:树校验的配对规则靠它,不 import primitives(避免环)。 */
-export declare const COMPONENT_ROLE: unique symbol;
-/**
- * children 是不透明值(自由文本 / CSS 字符串)而非报告树的组件标记(Text / Style):
- * resolve 与 validate 不下钻它们的 children——那是组件自己的 props,不是树。
- */
-export declare const COMPONENT_RAW_CHILDREN: unique symbol;
-export interface TextContext {
-    /** 可用列宽;Row 分栏后变窄。 */
-    width: number;
-    /** chrome 文案的 locale(verdict 词、注脚、占位符);默认 "en",show 输出不变。 */
-    locale: ReportLocale;
-    /** 容器组件渲染 children 用,宽度显式传递。 */
-    render(node: ReportNode, width?: number): string;
-    /**
-     * 把一个下钻目标格式化成 text 宿主的下钻命令(library.md「目标与下钻」:「text 宿主没有
-     * 链接，把可服务的目标格式化成下钻命令」)。恒存在(不是可选方法——是否能服务某个目标
-     * 由每次调用的返回值回答);目标页不存在、参数编码失败,或宿主没有为该目标接通命令时
-     * 返回 `undefined`,组件把 target 携带的内容按纯文本呈现,不拼假命令。
-     * 与 `WebContext.href` 是同一条通道在两个渲染面各自的形态,签名同样只认 `ReportTarget`
-     * ——不认 locator,新实体注册新参数化页即可自动获得下钻命令,不需要改这个类型。
-     */
-    command(target: ReportTarget): string | undefined;
-    /**
-     * 组索引一类「按实验收窄」命令的生成;宿主注入以携带完整上下文(--record / --report /
-     * --page 与位置参数),默认 `niceeval show --exp <id>`。非契约字段,官方组件内部用。
-     */
-    experimentCommand(experimentIdPrefix: string): string;
-    /**
-     * `Section` text 面的框线传输能力(docs/feature/reports/library/layout.md「区域框」):
-     * `"boxed"` 时画区域框,`"plain"` 时降级为无框文本。宿主按真实 TTY / NO_COLOR 探测结果
-     * 注入;省略时默认 `"plain"`——不假设有终端,保证现有(未显式声明能力的)调用方行为不变。
-     * 是否真的画框还要再叠加宽度下限,那份判断只在 `panel.ts` 里做一次。
-     */
-    panelMode: PanelMode;
-    /** 当前 boxed Section 的运行期深度；属于一次渲染上下文，绝不写到模块全局。 */
-    sectionBoxedDepth: number;
-    /** boxed 嵌套 Section 向最近外层 Section 登记结构化横隔的带外渲染期通道。 */
-    collectPanelRow?(row: PanelRow): void;
-    /**
-     * 取本组件 `dimensions()` 声明的某个句柄在这一页的呈现面。text 面恒返回 label 面
-     * (没有颜色 / 线型 / pattern);查别的组件的句柄或没声明的句柄抛
-     * `UndeclaredDimensionValueError`(components/README.md「维度呈现:分配单位是页」)。
-     */
-    dimension(handle: string): PresentedDimension;
-}
-export interface WebContext {
-    /**
-     * 下钻目标 → URL 的唯一通道(library.md「目标与下钻」)。恒存在:目标页存在且参数经该页
-     * `params.encode` 可编码就给出链接;页不存在、参数编码失败或宿主服务不了,返回
-     * `undefined`,组件退化成纯文本,不产出空 href 或假链接。组件对宿主能力零知识——
-     * view、静态导出、嵌入产品各自决定能服务哪些目标。
-     */
-    href(target: ReportTarget): string | undefined;
-    /** chrome 文案的 locale;官方组件渲染面经上下文读取,宿主外默认 "en"。 */
-    locale: ReportLocale;
-    /**
-     * 取本组件 `dimensions()` 声明的某个句柄在这一页的呈现面(label / color / series 的
-     * fill·stroke·marker 等可直接使用的值)。查别的组件的句柄或没声明的句柄抛
-     * `UndeclaredDimensionValueError`。
-     */
-    dimension(handle: string): PresentedDimension;
-}
-/** 双面组件解析面的上下文:宿主注入的数据来源;props 显式给出 input 时以 props 为准。 */
-export interface ResolveContext {
-    input: ReportInput;
-    /** 当前页判别;attempt 叶子组件省略 input 时从这里的 attempt 分支取缺省 evidence。 */
-    page: PageContext;
-}
-/** 组合组件的上下文:宿主 Sample、结果根完整读取面与规范化后的报告声明。 */
-export interface ComposeContext {
-    /** 宿主注入的 Sample。 */
-    scope: Sample;
-    /** 结果根完整读取面;历史视图从这里自行挑 Run[]。 */
-    results: Record;
-    /** 规范化后的报告声明,只读(docs/feature/reports/library/layout.md「自定义组件」)。 */
-    report: ReportMeta;
-    /** 当前页判别:scope 分支只有 id;attempt 分支带 locator + evidence。 */
-    page: PageContext;
-}
-export interface ComponentFaces<P extends object, R extends object = P> {
-    /**
-     * 组件唯一的异步 / IO 面:把作者写下的 props 规范化成渲染 props(R)。宿主管线在
-     * resolve 阶段调用它,按「同引用 input + 深相等 spec」在一次页渲染内记忆化;
-     * 渲染面(web / text)只看已解析的 R,保持同步、零 IO。不实现 resolve 时 R = P。
-     */
-    resolve?(props: P, context: ResolveContext): R | Promise<R>;
-    /**
-     * 声明这份数据会消费哪些维度值以及用哪种编码,在页级呈现分配之前调用;不是渲染面,
-     * 不返回标签或颜色,也不改变数据。对象形态定义时必填——不消费任何维度的组件显式写
-     * `dimensions: () => ({})`,让「参不参与页级身份分配」由声明回答而不是由省略表达。
-     * 类型上可选只是为了让运行期的完整用户反馈接住无类型 JS 输入。
-     */
-    dimensions?(data: R, options: P): DimensionDeclarations;
-    /** 真 React JSX 在这个面里;返回静态可渲染的 ReactNode。只看已解析的 R。 */
-    web(props: R, ctx: WebContext): ReactNode;
-    text(props: R, ctx: TextContext): string;
-}
-/**
- * 报告组件的产物:可直接用于 JSX。双面组件当普通 React 组件调用时走 web 面(只接受
- * 数据形态 props);组合组件只在报告管线内展开,宿主外直接渲染报错。R 只在
- * 组件注册边界擦除为 `object`；树遍历在调用 resolve 后立即将同一个值交给
- * dimensions / web / text，不把擦除值存入领域模型。
- */
-export type ReportComponent<P extends object> = ((props: P) => ReactNode) & {
-    [COMPONENT_FACES]?: ComponentFaces<P, object>;
-    [COMPONENT_COMPOSE]?: (props: P, ctx: ComposeContext) => ReportNode | Promise<ReportNode>;
-    [COMPONENT_ROLE]?: "tabs" | "tab";
-    [COMPONENT_RAW_CHILDREN]?: true;
-    displayName?: string;
-};
-/**
- * 一页的呈现分配结果对渲染面的投影:组件按**自己的 props 身份**取自己声明的句柄。
- * 键是 props 对象身份而不是句柄名——句柄名只在组件内唯一,页级汇总里必然重名,
- * 按名查会让 A 组件读到 B 组件的声明,查询封闭性就没了。
- */
-export interface PageDimensions {
-    dimension(props: object, handle: string): PresentedDimension;
-    /** 维度 name → 值 → seriesSlot；测试与调试观察槽位分配，组件渲染不读槽号。 */
-    readonly slotsByDimension: ReadonlyMap<string, ReadonlyMap<string, number>>;
-}
-/** 宿主渲染前把这一页的分配结果挂到渲染上下文上(text 与 web 同一条通道)。 */
-export declare function withPageDimensions<C extends object>(ctx: C, plan: PageDimensions | undefined): C;
-/**
- * 管线的 collect dimensions 阶段(validate 之后、render 之前一次完成):遍历已 resolve 的树,
- * 对每个声明了 `dimensions` 的节点以 (已解析 props, props) 调用它,汇总整页两个 keyset,
- * 交给 `allocatePageDimensions` 分配。text 面只算标签,不算视觉槽,也不做容量校验。
- */
-export declare function collectPageDimensions(node: ReportNode, pins?: DimensionPins, face?: "text" | "web"): PageDimensions;
-/** web 宿主用:在给定 WebContext 下同步渲染(React 静态渲染本身是同步的)。 */
-export declare function runWithWebContext<T>(ctx: WebContext, fn: () => T): T;
-/** 函数形态:组合组件,只装配已有组件,可以异步;ctx 携带 scope / results / report。 */
-export declare function defineComponent<P extends object>(compose: (props: P, context: ComposeContext) => ReportNode | Promise<ReportNode>): ReportComponent<P>;
-/** 对象形态:双面组件,自己渲染;text 与 web 两面必填,可选 resolve 承担取数。 */
-export declare function defineComponent<P extends object, R extends object = P>(faces: ComponentFaces<P, R>): ReportComponent<P>;
-export declare function facesOf(type: unknown): ComponentFaces<object, object> | undefined;
-export declare function composeOf(type: unknown): ((props: object, ctx: ComposeContext) => ReportNode | Promise<ReportNode>) | undefined;
-/**
- * resolve 记忆化的深相等:只递归比较可序列化值(普通对象 / 数组 / 原始值);
- * 函数与 Metric / Dimension / NumericAxis 一类携带函数的实例按引用比较——
- * 共享计算的成立条件是引用同一实例,引用不同的等价定义只是各算一次,不构成错误。
- */
-export declare function deepEqualSpec(a: unknown, b: unknown): boolean;
-/** 一次页渲染内的记忆化缓存:键 = 计算函数引用 → (同引用 input + 深相等 spec) 命中。 */
-export declare class ResolveMemo {
-    private readonly entries;
-    fetch<T extends object>(fn: object, input: object, spec: object, compute: () => Promise<T>): Promise<T>;
-}
-/** resolveReportTree 的环境:宿主注入的 Sample / 读取面 / 规范化声明 / 当前页判别。 */
-export interface ResolveEnv {
-    scope: Sample;
-    results: Record;
-    report: ReportMeta;
-    /** 当前渲染的页:scope 分支只有 id;attempt 分支带 locator + evidence。 */
-    page: PageContext;
-    /** 一次页渲染一份;跨页共享缓存时由宿主显式传同一实例。 */
-    memo?: ResolveMemo;
-}
-/** 官方 spec 组件在 resolve 内取数的记忆化入口;经内部扩展的 ResolveContext 传递。 */
-export interface InternalResolveContext extends ResolveContext {
-    /** 按 (计算函数引用, 同引用 input, 深相等 options) 记忆化地调用计算函数。 */
-    memoFetch<T extends object>(dataFn: object, input: object, options: object, compute: () => Promise<T>): Promise<T>;
-}
-/** 组件 resolve 里安全取记忆化入口:经宿主管线时在场,手工直调 resolve 时退化为直接计算。 */
-export declare function memoFetchOf(ctx: ResolveContext): InternalResolveContext["memoFetch"];
-/**
- * 管线的 resolve 阶段:递归展开组合组件(以 (props, ctx) 调用并 await 返回树)、执行双面
- * 组件的解析面;同层 sibling 并行取数且不改变节点顺序;带 resolve 的组件按「同引用 input +
- * 深相等 spec」记忆化。非法节点(React 组件、未经 defineComponent 的普通函数、任意 HTML
- * intrinsic)在展开遇到时立即以完整用户反馈拒绝,不为非法节点取数。
- */
-export declare function resolveReportTree(node: ReportNode, env: ResolveEnv): Promise<ReportNode>;
-/**
- * 管线的 validate 阶段:确保展开后树中每个组件都有 text 和 web 两面。校验只看节点资格,
- * 不限定树形:根节点可以是单个组件、Col 或 Tabs,宿主不强制任何最外层容器。
- * 裸字符串 / 数字、HTML intrinsic、无两面资格的函数都以完整用户反馈拒绝;
- * Tabs / Tab 的结构配对(空 Tabs、游离 Tab、非 Tab 直接子节点)也在这里校验。
- */
-export declare function validateReportTree(node: ReportNode, path?: string[], insideTabs?: boolean): void;
-export interface TextRenderOptions {
-    /** 终端可用列宽;默认 80。 */
-    width?: number;
-    /** 下钻目标 → 命令的生成;宿主注入,省略时对任何目标都返回 `undefined`(不生成假命令)。 */
-    command?: (target: ReportTarget) => string | undefined;
-    /** 组索引命令的生成;宿主注入以携带 --record / --report / --page 等上下文。 */
-    experimentCommand?: (experimentIdPrefix: string) => string;
-    /** chrome 文案的 locale;默认 "en"(`niceeval show` 现有输出不变)。 */
-    locale?: ReportLocale;
-    /** `Section` 的框线传输能力;默认 `"plain"`,由宿主按真实 TTY / NO_COLOR 探测结果注入。 */
-    panelMode?: PanelMode;
-    /** 这一页的呈现分配(text 面只有标签);省略时 `ctx.dimension` 说明当前不在管线里。 */
-    pageDimensions?: PageDimensions;
-}
-export declare function createTextContext(options?: TextRenderOptions): TextContext;
-/** text 宿主的遍历渲染:双面组件走 text 面,块之间以换行相接。只吃已 resolve + validate 的树。 */
-export declare function renderNodeToText(node: ReportNode, ctx: TextContext): string;