@webskill/sdk 0.14.0 → 0.15.0

package/dist/dist-CiaDIqkV.js

@@ -1,3509 +0,0 @@
-import { b as WebSkillError } from "./dist-D5YhlCdY.js";
-import { toJSONSchema, z } from "zod";
-
-//#region ../ui/dist/webskillCatalog-nTgkL9Xe.js
-const DEFAULT_INTERACTION_TEXTS = {
-	submit: "Submit",
-	cancel: "Cancel",
-	confirm: "Confirm",
-	select: "Select",
-	allow: "Allow",
-	deny: "Deny",
-	chooseFile: "Choose file",
-	decline: "Decline",
-	required: "This field is required",
-	suggested: "Suggested:",
-	useSuggestion: "Use"
-};
-function resolveInteractionTexts(texts) {
-	return texts ? {
-		...DEFAULT_INTERACTION_TEXTS,
-		...texts
-	} : DEFAULT_INTERACTION_TEXTS;
-}
-/** 可复用的部分取自 DEFAULT_INTERACTION_TEXTS，不另抄一份（AC-G10） */
-const DEFAULT_SURFACE_FORM_TEXTS = {
-	required: DEFAULT_INTERACTION_TEXTS.required,
-	submit: DEFAULT_INTERACTION_TEXTS.submit,
-	cancel: DEFAULT_INTERACTION_TEXTS.cancel,
-	addItem: "Add",
-	removeItem: "Remove",
-	arrayFirstItemOnly: "This renderer shows only the first item of a repeatable group.",
-	readOnlySnapshot: "This is a saved record — its actions are no longer available.",
-	suggested: DEFAULT_INTERACTION_TEXTS.suggested,
-	useSuggestion: DEFAULT_INTERACTION_TEXTS.useSuggestion
-};
-function resolveSurfaceFormTexts(texts) {
-	return texts ? {
-		...DEFAULT_SURFACE_FORM_TEXTS,
-		...texts
-	} : DEFAULT_SURFACE_FORM_TEXTS;
-}
-const DEFAULT_SURFACE_HOST_CONTROL_TEXTS = {
-	previousPage: "Previous page",
-	previous: "Previous",
-	nextPage: "Next page",
-	next: "Next",
-	carousel: "Carousel"
-};
-function resolveSurfaceHostControlTexts(texts) {
-	return texts ? {
-		...DEFAULT_SURFACE_HOST_CONTROL_TEXTS,
-		...texts
-	} : DEFAULT_SURFACE_HOST_CONTROL_TEXTS;
-}
-/** 提交值按请求类型归形（WebFormBridge 与框架组件库共享单一来源） */
-function shapeInteractionValue(model, values) {
-	switch (model.kind) {
-		case "ask": return values["answer"];
-		case "confirm": return values["confirmed"] === true;
-		case "select": return values["selected"];
-		case "authorize": return true;
-		case "file-pick": return values["file"];
-		case "form": return values;
-	}
-}
-/** 五类 InteractionRequest → 统一中间模型（框架无关） */
-function interactionToFormModel(request, texts) {
-	const t = resolveInteractionTexts(texts);
-	switch (request.type) {
-		case "ask": return {
-			kind: "ask",
-			message: request.message,
-			controls: [{
-				name: "answer",
-				label: request.message,
-				control: "text",
-				required: true,
-				...request.suggestion ? { suggestion: request.suggestion } : {}
-			}],
-			submitLabel: t.submit,
-			cancelLabel: t.cancel
-		};
-		case "confirm": return {
-			kind: "confirm",
-			message: request.message,
-			controls: [{
-				name: "confirmed",
-				label: request.message,
-				control: "boolean",
-				defaultValue: request.defaultValue ?? true
-			}],
-			submitLabel: t.confirm,
-			cancelLabel: t.cancel
-		};
-		case "form": return {
-			kind: "form",
-			...request.title ? { title: request.title } : {},
-			controls: request.fields.map((f) => ({
-				name: f.name,
-				label: f.label,
-				control: f.type,
-				...f.required ? { required: true } : {},
-				...f.description ? { description: f.description } : {},
-				...f.defaultValue !== void 0 ? { defaultValue: f.defaultValue } : {},
-				...f.suggestion ? { suggestion: f.suggestion } : {},
-				...f.options ? { options: f.options } : {}
-			})),
-			submitLabel: t.submit,
-			cancelLabel: t.cancel
-		};
-		case "select": return {
-			kind: "select",
-			message: request.message,
-			controls: [{
-				name: "selected",
-				label: request.message,
-				control: "select",
-				required: true,
-				options: request.options,
-				...request.suggestion ? { suggestion: request.suggestion } : {}
-			}],
-			submitLabel: t.select,
-			cancelLabel: t.cancel
-		};
-		case "authorize": return {
-			kind: "authorize",
-			title: "Authorization required",
-			message: request.message,
-			controls: [],
-			submitLabel: t.allow,
-			cancelLabel: t.deny
-		};
-		case "file-pick": return {
-			kind: "file-pick",
-			title: "File requested",
-			message: request.message,
-			controls: [{
-				name: "file",
-				label: request.field ?? "file",
-				control: "file",
-				required: true,
-				...request.accept ? { accept: request.accept } : {},
-				...request.multiple ? { multiple: true } : {}
-			}],
-			submitLabel: t.chooseFile,
-			cancelLabel: t.decline
-		};
-	}
-}
-/**
-* 最小子集 markdown → DOM：标题（#..###）、无序列表、代码块（```）、加粗、链接。
-* 全部内容经 textContent 写入，用户内容天然转义防 HTML 注入。
-*/
-const INLINE_RE = /\*\*([^*]+)\*\*|\[([^\]]+)\]\(([^)\s]+)\)/g;
-function appendInline(container, text, doc) {
-	let last = 0;
-	for (const match of text.matchAll(INLINE_RE)) {
-		const index = match.index ?? 0;
-		if (index > last) container.appendChild(doc.createTextNode(text.slice(last, index)));
-		if (match[1] !== void 0) {
-			const strong = doc.createElement("strong");
-			strong.textContent = match[1];
-			container.appendChild(strong);
-		} else {
-			const label = match[2] ?? "";
-			const url = match[3] ?? "";
-			if (/^https?:\/\//.test(url)) {
-				const a = doc.createElement("a");
-				a.href = url;
-				a.textContent = label;
-				a.rel = "noopener noreferrer";
-				container.appendChild(a);
-			} else container.appendChild(doc.createTextNode(match[0]));
-		}
-		last = index + match[0].length;
-	}
-	if (last < text.length) container.appendChild(doc.createTextNode(text.slice(last)));
-}
-function renderMiniMarkdown(text, doc) {
-	const root = doc.createElement("div");
-	root.className = "webskill-md";
-	const lines = text.split(/\r?\n/);
-	let i = 0;
-	while (i < lines.length) {
-		const line = lines[i] ?? "";
-		if (line.trimStart().startsWith("```")) {
-			const codeLines = [];
-			i++;
-			while (i < lines.length && !(lines[i] ?? "").trimStart().startsWith("```")) {
-				codeLines.push(lines[i] ?? "");
-				i++;
-			}
-			i++;
-			const pre = doc.createElement("pre");
-			const code = doc.createElement("code");
-			code.textContent = codeLines.join("\n");
-			pre.appendChild(code);
-			root.appendChild(pre);
-			continue;
-		}
-		const heading = /^(#{1,3})\s+(.*)$/.exec(line);
-		if (heading) {
-			const level = heading[1].length;
-			const h = doc.createElement(`h${level}`);
-			appendInline(h, heading[2] ?? "", doc);
-			root.appendChild(h);
-			i++;
-			continue;
-		}
-		if (/^\s*[-*]\s+/.test(line)) {
-			const ul = doc.createElement("ul");
-			while (i < lines.length && /^\s*[-*]\s+/.test(lines[i] ?? "")) {
-				const li = doc.createElement("li");
-				appendInline(li, (lines[i] ?? "").replace(/^\s*[-*]\s+/, ""), doc);
-				ul.appendChild(li);
-				i++;
-			}
-			root.appendChild(ul);
-			continue;
-		}
-		if (line.trim() === "") {
-			i++;
-			continue;
-		}
-		const p = doc.createElement("p");
-		appendInline(p, line, doc);
-		root.appendChild(p);
-		i++;
-	}
-	return root;
-}
-/** 与 catalog `Chart` 的 props 枚举逐字一致（`ui/catalog/uiCatalog.ts`） */
-const KINDS = /* @__PURE__ */ new Set([
-	"bar",
-	"line",
-	"area",
-	"pie",
-	"scatter",
-	"stacked-bar",
-	"dual-axis"
-]);
-const list = (value) => Array.isArray(value) ? value : [];
-/**
-* catalog `Chart` 节点 props → `ChartSpec`。四档共用这一份转换：
-* 此前 native / OpenUI / json-render / A2UI 各抄了一遍，改一处就会漂移。
-* 非法枚举**原样保留**，由 `toEchartsOption` 给出可见降级提示——
-* 此前偷偷改写成 `'line'`，画出的图与模型的意图无关且不可察觉。
-*/
-function chartSpecFromProps(props) {
-	const series = list(props["series"]);
-	return {
-		kind: typeof props["type"] === "string" ? props["type"] : "",
-		labels: list(props["labels"]),
-		series: series.map((item) => ({
-			...typeof item.name === "string" ? { name: item.name } : {},
-			data: list(item.values)
-		})),
-		...typeof props["title"] === "string" ? { title: props["title"] } : {}
-	};
-}
-const seriesNames = (chart) => chart.series.map((series) => series.name ?? "");
-/** 字号默认值的**全仓唯一来源**；`12` 是 echarts 的全局默认，显式写出后渲染不变 */
-const DEFAULT_CHART_FONT_SIZES = {
-	title: 14,
-	axisLabel: 12,
-	legend: 12
-};
-/** 逐字段兜底：宿主通常只想调大其中一两项 */
-function resolveChartFontSizes(sizes) {
-	return {
-		...DEFAULT_CHART_FONT_SIZES,
-		...sizes
-	};
-}
-/** echarts 的图例条目来源：饼图按标签分项，其余按系列名 */
-const legendEntries = (chart) => chart.kind === "pie" ? chart.labels : seriesNames(chart);
-/**
-* 非饼图的 series 形状表：catalog 声明的每种类型对应「基础 type + 零到一个修饰」。
-* 饼图不在表内——它的 data 要按 labels 重组，形状与其余六种不同。
-*/
-const SERIES_SHAPE = {
-	bar: { type: "bar" },
-	line: { type: "line" },
-	area: {
-		type: "line",
-		areaStyle: {}
-	},
-	scatter: { type: "scatter" },
-	"stacked-bar": {
-		type: "bar",
-		stack: "total"
-	},
-	"dual-axis": { type: "line" }
-};
-const FALLBACK_KIND = "bar";
-const fallbackNotice = (kind) => kind === "" ? `Missing chart type; rendered as a ${FALLBACK_KIND} chart.` : `Unsupported chart type "${kind}"; rendered as a ${FALLBACK_KIND} chart.`;
-/** `ChartSpec` → ECharts option：图表类型、数据系列、图例的唯一定义处 */
-function toEchartsOption(chart, fontSizes) {
-	const font = resolveChartFontSizes(fontSizes);
-	const known = KINDS.has(chart.kind);
-	const shape = SERIES_SHAPE[known ? chart.kind : FALLBACK_KIND];
-	const notice = known ? void 0 : fallbackNotice(chart.kind);
-	const valueAxis = {
-		type: "value",
-		axisLabel: { fontSize: font.axisLabel }
-	};
-	return {
-		animation: false,
-		title: chart.title || notice ? {
-			text: chart.title ?? "",
-			left: "center",
-			textStyle: { fontSize: font.title },
-			...notice ? { subtext: notice } : {}
-		} : void 0,
-		tooltip: { trigger: chart.kind === "pie" ? "item" : "axis" },
-		legend: {
-			bottom: 0,
-			textStyle: { fontSize: font.legend }
-		},
-		xAxis: chart.kind === "pie" ? void 0 : {
-			type: "category",
-			data: chart.labels,
-			axisLabel: { fontSize: font.axisLabel }
-		},
-		yAxis: chart.kind === "pie" ? void 0 : chart.kind === "dual-axis" ? [valueAxis, { ...valueAxis }] : valueAxis,
-		series: chart.kind === "pie" ? chart.series.map((series) => ({
-			type: "pie",
-			name: series.name,
-			data: chart.labels.map((label, index) => ({
-				name: label,
-				value: series.data[index] ?? 0
-			}))
-		})) : chart.series.map((series, index) => ({
-			...shape,
-			name: series.name,
-			data: series.data,
-			...chart.kind === "dual-axis" ? { yAxisIndex: index === 0 ? 0 : 1 } : {}
-		}))
-	};
-}
-/**
-* 图表的 DOM 契约。echarts 画在 canvas 上，DOM 里读不到图表类型/系列/图例，
-* 「同一份 ChartSpec 在各档下一致」只能靠宿主元素上的这三个属性对拍。
-*/
-function applyChartDomContract(container, chart) {
-	container.setAttribute("data-webskill-chart", chart.kind);
-	container.setAttribute("data-webskill-chart-series", seriesNames(chart).join("|"));
-	container.setAttribute("data-webskill-chart-legend", legendEntries(chart).join("|"));
-	if (chart.title) container.setAttribute("aria-label", chart.title);
-	else container.removeAttribute("aria-label");
-}
-/**
-* 一篇文档常同时挂载多张图表；共用同一个模块 promise，
-* 避免每个挂载点各自发起一次动态 import。
-*/
-let echartsModule;
-const loadEcharts = () => echartsModule ??= import("./echarts-De78wXqV.js");
-/**
-* 框架无关的 echarts 挂载点：三档的 React 组件与 A2UI 档的 Lit 元素共用同一实现，
-* 图表不再因档位而异。echarts 走动态 import，不打进首屏。
-*/
-function mountEchart(container) {
-	let disposed = false;
-	let instance;
-	let queued;
-	let observer;
-	const apply = (chart, fontSizes) => {
-		instance?.setOption(toEchartsOption(chart, fontSizes), {
-			notMerge: true,
-			lazyUpdate: true
-		});
-	};
-	loadEcharts().then((echarts) => {
-		if (disposed) return;
-		instance = echarts.init(container);
-		if (typeof ResizeObserver !== "undefined") {
-			observer = new ResizeObserver(() => instance?.resize());
-			observer.observe(container);
-		}
-		if (queued) apply(queued.chart, queued.fontSizes);
-	});
-	return {
-		setChart(chart, fontSizes) {
-			applyChartDomContract(container, chart);
-			queued = {
-				chart,
-				...fontSizes ? { fontSizes } : {}
-			};
-			apply(chart, fontSizes);
-		},
-		dispose() {
-			disposed = true;
-			observer?.disconnect();
-			observer = void 0;
-			instance?.dispose();
-			instance = void 0;
-		}
-	};
-}
-/**
-* catalog 请求体积上限（0.11.0 分册 14 / AC-G20）的**数字单一来源**。
-*
-* 度量与报错格式在 `scripts/catalogBudget.mjs`（`check:contracts` 与 vitest 共用）；
-* 那边不重复这些数字，一律从本模块读——两处各写一份阈值就等于没有阈值。
-*
-* catalog 进入每一次 LLM 请求的有两处：系统提示词 `toPrompt()` 与
-* `render_ui` 入参 `toJsonSchema()`。只量前者会漏掉约 2/3 的成本。
-*
-* **超阈值的处置是砍组件或收窄枚举取值，不是抬高这里的数字。**
-*/
-/**
-* 预算阶段。分册 12 是本版最后一处 catalog 增量（分册 11 只把 `date` 加进
-* 已有的 `Field.type`，分册 23 不碰 catalog），故在此切到 `'final'`：
-* 阈值收紧到实测终态 + 余量，且余量小于一个平均组件的成本
-* ——余量大于一个组件，等于默许下一版无声塞进一个。
-*/
-const CATALOG_BUDGET_STAGE = "final";
-/**
-* 阈值 = **已落地实测** + 余量，余量须小于一个平均组件的成本。
-*
-* 2026-08-14 实测终态（分册 12 落地后）：prompt 12 744 / schema 21 470，30 个组件。
-* 平均组件成本 prompt 425 / schema 716。
-* 当前余量 prompt 256 / schema 330，均小于一个平均组件——再加一个组件必红。
-*
-* ⚠️ **本版这两个数字被上调过两次**，两次都由需求方裁决并改写了需求文档
-* （分册 29 §2 范围订正 第 7 条与 §2.2），不是实现阶段自行放宽：
-*
-* 1. 11 200 → 12 200 / 20 500 → 21 200：分册 13 组件描述由短改长。
-*    `example` 是既有护栏的硬要求（`catalog.test.ts` 与 `catalogMatrix.test.tsx`
-*    逐个组件校验并四档渲染），靠省掉示例腾出的空间收不回来。
-* 2. 12 200 → 13 000 / 21 200 → 21 800：分册 12 的 `Split` 实测 490 + 694，
-*    超出计划增量（403 + 1 047）的 prompt 侧。需求方裁定
-*    「描述要长，可用性大于预算阈值」——收紧措辞可省回 158 字节，
-*    但砍的正是各组件「何时改用 X」的辨析句，即选型准确率本身。
-*
-* 两次上调合计把单请求成本从 21.7 KB 抬到约 34.2 KB。
-* **AC-G20 原文「超了砍组件、不抬阈值」已被推翻，但仅限本版；
-* 后续再撞顶仍须回到需求方，不得沿用本版作为先例。**
-*/
-const CATALOG_PROMPT_MAX = 13e3;
-const CATALOG_SCHEMA_MAX = 21800;
-/**
-* **尚未落地**的计划增量。本版已无剩余 catalog 增量，故归零；
-* `CATALOG_BUDGET_STAGE` 同时切到 `'final'`，余量改由「小于一个平均组件」判定。
-*/
-const PLANNED_INCREMENT = {
-	prompt: 0,
-	schema: 0
-};
-/** 码与人话之间的分隔符。放在消息最前面，`codeOfIssue` 才能从 zod 的 issue 里认出它。 */
-const SEPARATOR = ": ";
-/**
-* 给 zod 的 `error` 文案打上稳定码。
-*
-* 组件自己在 schema 里声明，sanitize 只负责把码搬到 `UiSpecDegradation.code` 上——
-* 这样新增一条策略性约束不需要去 sanitize 里加组件名分支（写死清单是本仓反复出问题的地方）。
-*/
-function codedError(code, message) {
-	return `${code}${SEPARATOR}${message}`;
-}
-/** 从 zod issue 的消息里取回码；没有码就返回 undefined（普通类型错误就是这种）。 */
-function codeOfIssue(message) {
-	const index = message.indexOf(SEPARATOR);
-	if (index <= 0) return void 0;
-	const head = message.slice(0, index);
-	return /^[A-Z][A-Z0-9_]*$/.test(head) ? head : void 0;
-}
-function isRecord$1$1(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
-* 逐节点降级（FR-23.3）。
-*
-* 与 `validate` 的关系见 `UiCatalog.sanitize` 的注释：一个整块拒绝、一个逐节点救。
-*
-* **不写回 `safeParse` 的结果**是刻意的：zod 会剥离未声明的键，
-* 而渲染层确实在读若干未进 zod 的 prop（如 `suggestion`，由 SDK 侧下发而非模型生成）。
-* 写回等于把它们悄悄删掉。这里只删「确实解析失败」的那几个键。
-*/
-function sanitizeNode(catalog, byName, node, path, degradations) {
-	if (!isRecord$1$1(node)) {
-		degradations.push({
-			path,
-			kind: "node-dropped",
-			component: "unknown",
-			detail: "Node is not an object."
-		});
-		return;
-	}
-	const name = node["component"];
-	if (typeof name !== "string") {
-		degradations.push({
-			path,
-			kind: "node-dropped",
-			component: "unknown",
-			detail: "Node has no \"component\" name."
-		});
-		return;
-	}
-	const def = byName.get(name);
-	if (!def) {
-		degradations.push({
-			path,
-			kind: "unknown-component",
-			component: name,
-			detail: `Unknown component "${name}"; the catalog declares: ${catalog.components.map((c) => c.name).join(", ")}`
-		});
-		return;
-	}
-	const rawProps = isRecord$1$1(node["props"]) ? node["props"] : {};
-	let props = rawProps;
-	const parsed = def.props.safeParse(rawProps);
-	if (!parsed.success) {
-		const offending = new Set(parsed.error.issues.map((issue) => String(issue.path[0] ?? "")).filter((key) => key !== ""));
-		const codes = /* @__PURE__ */ new Map();
-		for (const issue of parsed.error.issues) {
-			const key = String(issue.path[0] ?? "");
-			const code = codeOfIssue(issue.message);
-			if (key !== "" && code !== void 0) codes.set(key, code);
-		}
-		const kept = {};
-		for (const [key, value] of Object.entries(rawProps)) if (!offending.has(key)) kept[key] = value;
-		const retry = def.props.safeParse(kept);
-		if (!retry.success) {
-			const carried = [...codes.values()].find((code) => code !== void 0);
-			degradations.push({
-				path,
-				kind: "node-dropped",
-				component: name,
-				detail: `Props cannot be repaired by dropping invalid keys: ${retry.error.issues.map((i) => i.message).join("; ")}`,
-				...carried === void 0 ? {} : { code: carried }
-			});
-			return;
-		}
-		for (const key of offending) {
-			const code = codes.get(key);
-			degradations.push({
-				path: `${path}.props.${key}`,
-				kind: "prop-dropped",
-				component: name,
-				detail: `Dropped invalid prop "${key}".`,
-				...code === void 0 ? {} : { code }
-			});
-		}
-		props = kept;
-	}
-	const sanitized = {
-		component: name,
-		props
-	};
-	if (typeof node["id"] === "string") sanitized.id = node["id"];
-	const children = node["children"];
-	if (children === void 0) return sanitized;
-	if (!Array.isArray(children)) {
-		degradations.push({
-			path: `${path}.children`,
-			kind: "constraint-ignored",
-			component: name,
-			detail: "children is not an array; rendered without children."
-		});
-		return sanitized;
-	}
-	if (def.children === void 0) {
-		degradations.push({
-			path: `${path}.children`,
-			kind: "constraint-ignored",
-			component: name,
-			detail: `Component "${name}" is a leaf; its children were dropped.`
-		});
-		return sanitized;
-	}
-	const allowed = def.children;
-	const singletons = /* @__PURE__ */ new Map();
-	const kept = [];
-	children.forEach((child, index) => {
-		const childPath = `${path}.children[${index}]`;
-		const childName = isRecord$1$1(child) && typeof child["component"] === "string" ? child["component"] : void 0;
-		if (allowed !== "any" && childName !== void 0 && !allowed.includes(childName)) {
-			degradations.push({
-				path: childPath,
-				kind: byName.has(childName) ? "node-dropped" : "unknown-component",
-				component: childName,
-				detail: byName.has(childName) ? `Component "${name}" only accepts children: ${[...allowed].join(", ")}` : `Unknown component "${childName}"; the catalog declares: ${catalog.components.map((c) => c.name).join(", ")}`
-			});
-			return;
-		}
-		if (childName !== void 0 && byName.get(childName)?.singletonPerContainer === true) {
-			const seen = (singletons.get(childName) ?? 0) + 1;
-			singletons.set(childName, seen);
-			if (seen > 1) {
-				degradations.push({
-					path: childPath,
-					kind: "node-dropped",
-					component: childName,
-					detail: `At most one "${childName}" per container; the extra one was dropped.`
-				});
-				return;
-			}
-		}
-		const sanitizedChild = sanitizeNode(catalog, byName, child, childPath, degradations);
-		if (sanitizedChild) kept.push(sanitizedChild);
-	});
-	sanitized.children = kept;
-	return sanitized;
-}
-function sanitizeUiSpec(catalog, byName, spec) {
-	const degradations = [];
-	return {
-		node: sanitizeNode(catalog, byName, spec, "root", degradations),
-		degradations
-	};
-}
-function componentSchema(def, rootDefs) {
-	const props = liftDefs(toJSONSchema(def.props, { io: "input" }), def.name, rootDefs);
-	const node = {
-		type: "object",
-		description: def.description,
-		properties: {
-			component: {
-				type: "string",
-				const: def.name
-			},
-			id: {
-				type: "string",
-				description: "Stable node id, reused on replay"
-			},
-			props
-		},
-		required: ["component"]
-	};
-	if (def.children !== void 0) node.properties = {
-		...node.properties,
-		children: {
-			type: "array",
-			description: def.children === "any" ? "Any catalog component" : `One of: ${[...def.children].join(", ")}`,
-			items: { $ref: "#" }
-		}
-	};
-	return node;
-}
-function isRecord$2(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-const DEFS_REF_PREFIX = "#/$defs/";
-function rewriteDefRefs(node, renames) {
-	if (Array.isArray(node)) return node.map((child) => rewriteDefRefs(child, renames));
-	if (!isRecord$2(node)) return node;
-	const out = {};
-	for (const [key, value] of Object.entries(node)) {
-		if (key === "$ref" && typeof value === "string" && value.startsWith(DEFS_REF_PREFIX)) {
-			const [head, ...tail] = value.slice(8).split("/");
-			const mapped = head === void 0 ? void 0 : renames.get(head);
-			out[key] = mapped === void 0 ? value : [`${DEFS_REF_PREFIX}${mapped}`, ...tail].join("/");
-			continue;
-		}
-		out[key] = rewriteDefRefs(value, renames);
-	}
-	return out;
-}
-/**
-* zod 每个组件各自产出 `$defs.__schemaN`，其 `#/$defs/...` 指的是那次转换自己的根；
-* 直接嵌进 catalog 大 schema 后那个 `#` 变成了 catalog 根，引用从产物根解析不到。
-* 提到根并以组件名限定，避免不同组件的同名定义互相覆盖。
-*/
-function liftDefs(schema, owner, rootDefs) {
-	const defs = schema["$defs"];
-	if (!isRecord$2(defs)) return schema;
-	const renames = /* @__PURE__ */ new Map();
-	for (const name of Object.keys(defs)) renames.set(name, `${owner}_${name}`);
-	for (const [name, def] of Object.entries(defs)) rootDefs[renames.get(name)] = rewriteDefRefs(def, renames);
-	const body = {};
-	for (const [key, value] of Object.entries(schema)) if (key !== "$defs") body[key] = value;
-	return rewriteDefRefs(body, renames);
-}
-function typeOf(schema) {
-	if (Array.isArray(schema.enum)) return schema.enum.map((option) => JSON.stringify(option)).join(" | ");
-	if (schema["const"] !== void 0) return JSON.stringify(schema["const"]);
-	const union = schema["anyOf"] ?? schema["oneOf"];
-	if (Array.isArray(union)) return union.map(typeOf).join(" | ");
-	if (schema.type === "array" && schema.items) return `${typeOf(schema.items)}[]`;
-	return typeof schema.type === "string" ? schema.type : "unknown";
-}
-function describeProps(def) {
-	const schema = toJSONSchema(def.props, { io: "input" });
-	const properties = schema.properties ?? {};
-	const required = new Set(schema.required ?? []);
-	const entries = Object.entries(properties).map(([key, value]) => `${key}${required.has(key) ? "" : "?"}: ${typeOf(value)}`);
-	return entries.length === 0 ? "—" : entries.join(", ");
-}
-function promptFor(catalog, options) {
-	const lines = [(options.mode === "tool-description" ? "" : `# ${catalog.title} (${catalog.version})\n\n`) + catalog.instructions.trim(), ""];
-	const groups = /* @__PURE__ */ new Map();
-	for (const def of catalog.components) groups.set(def.group, [...groups.get(def.group) ?? [], def]);
-	for (const [group, defs] of groups) {
-		lines.push(`## ${group}`, "");
-		for (const def of defs) {
-			lines.push(`### ${def.name}`, def.description, "", `props: ${describeProps(def)}`);
-			if (def.children !== void 0) lines.push(`children: ${def.children === "any" ? "any component" : [...def.children].join(" | ")}`);
-			for (const constraint of def.constraints ?? []) lines.push(`- ${constraint}`);
-			if (def.example) lines.push("", "```json", JSON.stringify(def.example), "```");
-			lines.push("");
-		}
-	}
-	if (catalog.actions.length > 0) {
-		lines.push("## actions", "");
-		for (const action of catalog.actions) lines.push(`- \`${action.name}\` — ${action.description}`);
-		lines.push("");
-	}
-	return lines.join("\n").trimEnd();
-}
-function validateNode(catalog, byName, node, path, issues) {
-	if (!isRecord$2(node)) {
-		issues.push({
-			path,
-			message: "Node must be an object"
-		});
-		return;
-	}
-	const name = node["component"];
-	if (typeof name !== "string") {
-		issues.push({
-			path,
-			message: "Node is missing a \"component\" name"
-		});
-		return;
-	}
-	const def = byName.get(name);
-	if (!def) {
-		issues.push({
-			path,
-			message: `Unknown component "${name}"; the catalog declares: ${catalog.components.map((c) => c.name).join(", ")}`
-		});
-		return;
-	}
-	const parsed = def.props.safeParse(node["props"] ?? {});
-	if (!parsed.success) for (const issue of parsed.error.issues) issues.push({
-		path: `${path}.props${issue.path.map((part) => `.${String(part)}`).join("")}`,
-		message: issue.message
-	});
-	const children = node["children"];
-	if (children === void 0) return;
-	if (!Array.isArray(children)) {
-		issues.push({
-			path: `${path}.children`,
-			message: "children must be an array"
-		});
-		return;
-	}
-	if (def.children === void 0) {
-		issues.push({
-			path: `${path}.children`,
-			message: `Component "${name}" is a leaf and cannot have children`
-		});
-		return;
-	}
-	const allowed = def.children;
-	const singletons = /* @__PURE__ */ new Map();
-	children.forEach((child, index) => {
-		const childPath = `${path}.children[${index}]`;
-		if (allowed !== "any" && isRecord$2(child) && typeof child["component"] === "string") {
-			if (!allowed.includes(child["component"])) {
-				issues.push({
-					path: childPath,
-					message: `Component "${name}" only accepts children: ${[...allowed].join(", ")}`
-				});
-				return;
-			}
-		}
-		if (isRecord$2(child) && typeof child["component"] === "string") {
-			const childName = child["component"];
-			if (byName.get(childName)?.singletonPerContainer === true) {
-				const seen = (singletons.get(childName) ?? 0) + 1;
-				singletons.set(childName, seen);
-				if (seen > 1) issues.push({
-					path: childPath,
-					message: `At most one "${childName}" per container; "${name}" already contains one`
-				});
-			}
-		}
-		validateNode(catalog, byName, child, childPath, issues);
-	});
-}
-/**
-* 同一份定义派生出 JSON Schema / prompt / validator 三种投影，
-* 不允许任何一方手写副本（21 号文档 §1）。
-*/
-function defineUiCatalog(input) {
-	const byName = new Map(input.components.map((def) => [def.name, def]));
-	if (byName.size !== input.components.length) {
-		const seen = /* @__PURE__ */ new Set();
-		const duplicate = input.components.find((def) => seen.has(def.name) ? true : (seen.add(def.name), false));
-		throw new Error(`Duplicate component name "${duplicate?.name}" in UI catalog "${input.id}"`);
-	}
-	return {
-		...input,
-		componentNames: input.components.map((def) => def.name),
-		actionNames: input.actions.map((action) => action.name),
-		component: (name) => byName.get(name),
-		toJsonSchema: () => {
-			const $defs = {};
-			const oneOf = input.components.map((def) => componentSchema(def, $defs));
-			return {
-				$schema: "https://json-schema.org/draft/2020-12/schema",
-				$id: input.id,
-				title: input.title,
-				description: input.instructions,
-				...Object.keys($defs).length > 0 ? { $defs } : {},
-				oneOf
-			};
-		},
-		toPrompt: (options = {}) => promptFor(input, options),
-		validate: (spec) => {
-			const issues = [];
-			validateNode(input, byName, spec, "root", issues);
-			return issues.length === 0 ? { ok: true } : {
-				ok: false,
-				issues
-			};
-		},
-		sanitize: (spec) => sanitizeUiSpec(input, byName, spec)
-	};
-}
-const tone = z.enum([
-	"neutral",
-	"success",
-	"warning",
-	"info",
-	"destructive"
-]);
-/**
-* 装饰色。与 `tone` 语义**不重叠**：tone 表状态（success 是「成功」），
-* palette 表美观（「行程第三天」用绿色不代表它成功了）。
-* 取值是色板名不是颜色值——必须映射到 design token，深浅色主题才能自动跟随。
-*/
-const palette = z.enum([
-	"sky",
-	"violet",
-	"amber",
-	"rose",
-	"emerald"
-]);
-/**
-* surface 级视觉档（FR-13.4）。只在**根节点**上有意义，切的是一组 token
-* （圆角/阴影/底色），不是逐组件改样式；作用域限于该 surface 子树。
-* `office` 是缺省，与本版之前逐字节一致——它是回归基线。
-*/
-const surfaceTheme = z.enum([
-	"office",
-	"vivid",
-	"dashboard-dark"
-]);
-/** 图标白名单：任意名字会让模型产出渲染不出来的节点，且枚举长度直接计入每次请求 */
-const iconName = z.enum([
-	"info",
-	"check",
-	"alert",
-	"x",
-	"clock",
-	"calendar",
-	"user",
-	"star",
-	"search",
-	"settings",
-	"download",
-	"link",
-	"chart",
-	"file",
-	"folder",
-	"mail"
-]);
-/**
-* `Image.src` 的同源约束（AC-13.4）。**判定放在 schema 上，`validate` 与 `sanitize` 两条路径就都覆盖**；
-* 只写进组件描述等于把安全交给模型自觉——提示注入可以用 `src` 把数据带到任意主机上去。
-*
-* 同源按**语法**判：`data:image/` 与相对路径放行，任何带 scheme 的绝对 URL
-* 以及协议相对的 `//host/...` 一律拒。这样判定不需要知道当前 origin，
-* `@webskill/ui` 得以保持环境无关。
-*/
-const imageSrc = z.string().refine((src) => /^data:image\//i.test(src) || !/^([a-z][a-z0-9+.-]*:|\/\/)/i.test(src), { error: codedError("IMAGE_SRC_NOT_ALLOWED", "Image.src must be a same-origin path or a data:image URL; remote URLs are rejected by policy.") });
-const actionRef = z.object({
-	/** catalog actions 里声明过的名字 */
-	action: z.string().describe("Action name declared by the catalog"),
-	label: z.string(),
-	disabled: z.boolean().optional()
-});
-const CONTENT = [
-	"Stack",
-	"Card",
-	"Separator",
-	"Heading",
-	"Text",
-	"Markdown",
-	"Badge"
-];
-const DATA = [
-	"Metric",
-	"Table",
-	"Chart",
-	"Timeline",
-	"FileLink"
-];
-const INPUT = [
-	"Form",
-	"Field",
-	"FieldArray",
-	"Button"
-];
-/**
-* `visibleWhen` 的结构化条件（设计 23 §1.2）。用 `z.lazy` 自引用；
-* 语义深度上限不在 zod 里卡，由 `evaluateFieldCondition` 按 `MAX_CONDITION_DEPTH` 降级处理。
-*/
-const fieldCondition = z.lazy(() => z.union([
-	z.object({
-		field: z.string(),
-		equals: z.union([
-			z.string(),
-			z.number(),
-			z.boolean()
-		])
-	}),
-	z.object({
-		field: z.string(),
-		in: z.array(z.union([z.string(), z.number()]))
-	}),
-	z.object({
-		field: z.string(),
-		notEmpty: z.literal(true)
-	}),
-	z.object({ allOf: z.array(fieldCondition).min(1) }),
-	z.object({ anyOf: z.array(fieldCondition).min(1) })
-]));
-/** 选项既可以写死，也可以声明成异步取值（取值通道属分册 24） */
-const fieldOptions = z.array(z.object({
-	label: z.string(),
-	value: z.union([z.string(), z.number()])
-}));
-/** Tabs 的面板与 Grid 的格子必须自成容器，否则「每容器至多一个表单」就没有落脚点 */
-const PANEL = ["Card", "Stack"];
-/**
-* v3 首发 catalog：覆盖旧六类 surface（metric / chart / table / form / file / custom）的全部表达力，先窄后宽。
-* 只依赖 zod —— 不 import 任何 UI framework（21 号文档 §5.1）。
-*/
-const uiCatalog = defineUiCatalog({
-	id: "https://webskill.dev/catalogs/v1",
-	version: "1.0.0",
-	title: "WebSkill AI Component Catalog",
-	instructions: [
-		"Compose the answer UI from the components below. Rules:",
-		"",
-		"- The root node of a surface must be `Stack` or `Card`.",
-		"- Ask for user input with `Form` + `Field`; never describe an input in `Text`.",
-		"- A `Button`'s `action` must be one of the catalog actions.",
-		"- Never emit HTML or scripts. `Image.src` must be same-origin or a data URL.",
-		"- Prefer `Table` for many rows, `Chart` for trends, `Metric` for a single number,",
-		"  `Timeline` for ordered steps and `Progress` for how far a long task has come.",
-		"- Match `Field.type` to the question instead of using `text` for everything:",
-		"  `select` / `multi-select` for a fixed set of options, `date` for dates,",
-		"  `toggle` for yes/no, `number` for quantities, `textarea` for several sentences.",
-		"- Group independent sections with `Tabs` or `Grid` instead of one long column.",
-		"- At most one `Form` per container; a `Tabs` panel and a `Grid` cell are separate containers."
-	].join("\n"),
-	components: [
-		{
-			name: "Stack",
-			group: "layout",
-			description: "Vertical or horizontal container. Use it as the root of most surfaces.",
-			props: z.object({
-				direction: z.enum(["vertical", "horizontal"]).default("vertical"),
-				gap: z.enum([
-					"sm",
-					"md",
-					"lg"
-				]).default("md"),
-				align: z.enum([
-					"start",
-					"center",
-					"end",
-					"stretch"
-				]).optional(),
-				theme: surfaceTheme.optional()
-			}),
-			children: "any",
-			example: {
-				component: "Stack",
-				props: { direction: "vertical" },
-				children: [{
-					component: "Heading",
-					props: {
-						level: 2,
-						text: "Q4 results"
-					}
-				}]
-			}
-		},
-		{
-			name: "Card",
-			group: "layout",
-			description: "A titled section that groups related content.",
-			props: z.object({
-				title: z.string(),
-				description: z.string().optional(),
-				palette: palette.optional(),
-				theme: surfaceTheme.optional(),
-				span: z.union([z.literal(1), z.literal(2)]).default(1),
-				density: z.enum([
-					"compact",
-					"default",
-					"comfortable"
-				]).default("default")
-			}),
-			children: "any",
-			example: {
-				component: "Card",
-				props: { title: "Revenue" },
-				children: [{
-					component: "Metric",
-					props: {
-						label: "MRR",
-						value: "12,400"
-					}
-				}]
-			}
-		},
-		{
-			name: "Separator",
-			group: "layout",
-			description: "A horizontal rule between sections.",
-			props: z.object({}),
-			example: { component: "Separator" }
-		},
-		{
-			name: "Tabs",
-			group: "layout",
-			description: "Switchable panels. Each child is one panel and its own form container.",
-			props: z.object({ labels: z.array(z.string()).min(2) }),
-			children: PANEL,
-			constraints: ["One child per label, in the same order"],
-			example: {
-				component: "Tabs",
-				props: { labels: ["Filters", "Export"] },
-				children: [{
-					component: "Stack",
-					children: [{
-						component: "Text",
-						props: { text: "Pick a date range." }
-					}]
-				}, {
-					component: "Stack",
-					children: [{
-						component: "Text",
-						props: { text: "Choose a file format." }
-					}]
-				}]
-			}
-		},
-		{
-			name: "Split",
-			group: "layout",
-			description: "Two panes side by side at a fixed ratio — a chart next to its takeaways, a form next to its help text, a summary next to the detail it summarises. Takes exactly two children and stacks them vertically when the container is narrow, so the main pane always comes first. Use `Grid` when the cells are peers rather than a main/side pair.",
-			props: z.object({ ratio: z.enum([
-				"1:1",
-				"2:1",
-				"3:1",
-				"1:2"
-			]).default("1:1") }),
-			children: PANEL,
-			example: {
-				component: "Split",
-				props: { ratio: "2:1" },
-				children: [{
-					component: "Card",
-					props: { title: "Trend" }
-				}, {
-					component: "Card",
-					props: { title: "Notes" }
-				}]
-			}
-		},
-		{
-			name: "Grid",
-			group: "layout",
-			description: "Dashboard grid: several tiles, metrics or charts the reader scans in parallel. Each child is one cell and its own form container. Prefer `columns: 'auto'` with a `minColumnWidth` — it fits as many cells as the container allows and reflows when narrow, which a fixed count cannot do. Set a fixed count only when the layout really needs exactly N.",
-			props: z.object({
-				columns: z.union([
-					z.literal(2),
-					z.literal(3),
-					z.literal(4),
-					z.literal("auto")
-				]).default(2),
-				minColumnWidth: z.enum([
-					"sm",
-					"md",
-					"lg"
-				]).default("md")
-			}),
-			children: PANEL,
-			example: {
-				component: "Grid",
-				props: { columns: 2 },
-				children: [{
-					component: "Card",
-					props: { title: "Revenue" },
-					children: [{
-						component: "Metric",
-						props: {
-							label: "MRR",
-							value: "12,400"
-						}
-					}]
-				}, {
-					component: "Card",
-					props: { title: "Churn" },
-					children: [{
-						component: "Metric",
-						props: {
-							label: "Rate",
-							value: "2.1%"
-						}
-					}]
-				}]
-			}
-		},
-		{
-			name: "Heading",
-			group: "content",
-			description: "Section heading. Level 2 is the largest allowed inside a message.",
-			props: z.object({
-				level: z.union([
-					z.literal(2),
-					z.literal(3),
-					z.literal(4)
-				]).default(3),
-				text: z.string(),
-				palette: palette.optional()
-			}),
-			example: {
-				component: "Heading",
-				props: {
-					level: 3,
-					text: "Summary"
-				}
-			}
-		},
-		{
-			name: "Text",
-			group: "content",
-			description: "A paragraph of plain text.",
-			props: z.object({
-				text: z.string(),
-				tone: z.enum(["default", "muted"]).default("default")
-			}),
-			example: {
-				component: "Text",
-				props: { text: "Revenue grew 12% quarter over quarter." }
-			}
-		},
-		{
-			name: "Markdown",
-			group: "content",
-			description: "Restricted Markdown (no HTML). Use for lists and emphasis, not for tables.",
-			props: z.object({ text: z.string() }),
-			constraints: ["HTML tags are rejected; use Table for tabular data"],
-			example: {
-				component: "Markdown",
-				props: { text: "- first\n- second" }
-			}
-		},
-		{
-			name: "Badge",
-			group: "content",
-			description: "A short status label.",
-			props: z.object({
-				text: z.string(),
-				tone: tone.default("neutral"),
-				palette: palette.optional()
-			}),
-			example: {
-				component: "Badge",
-				props: {
-					text: "active",
-					tone: "success"
-				}
-			}
-		},
-		{
-			name: "Metric",
-			group: "data",
-			description: "A single headline number with an optional change indicator.",
-			props: z.object({
-				label: z.string(),
-				value: z.union([z.string(), z.number()]),
-				change: z.string().optional(),
-				trend: z.enum([
-					"up",
-					"down",
-					"neutral"
-				]).optional()
-			}),
-			example: {
-				component: "Metric",
-				props: {
-					label: "MRR",
-					value: "12,400",
-					trend: "up",
-					change: "+12%"
-				}
-			}
-		},
-		{
-			name: "Table",
-			group: "data",
-			description: "Tabular data with explicit columns. Prefer it over Markdown tables.",
-			props: z.object({
-				title: z.string().optional(),
-				columns: z.array(z.string()).min(1),
-				rows: z.array(z.array(z.union([
-					z.string(),
-					z.number(),
-					z.boolean(),
-					z.null()
-				]))),
-				/** 列宽权重，长度需与 columns 一致；不一致时整项忽略而不拒绝渲染 */
-				columnWidths: z.array(z.number().positive()).optional()
-			}),
-			example: {
-				component: "Table",
-				props: {
-					columns: ["Quarter", "Revenue"],
-					rows: [["Q3", 9800], ["Q4", 12400]]
-				}
-			}
-		},
-		{
-			name: "Chart",
-			group: "data",
-			description: "A bar, line, area, pie, scatter, stacked or dual-axis chart over labelled series.",
-			props: z.object({
-				type: z.enum([
-					"bar",
-					"line",
-					"area",
-					"pie",
-					"scatter",
-					"stacked-bar",
-					"dual-axis"
-				]),
-				title: z.string().optional(),
-				labels: z.array(z.string()).min(1),
-				series: z.array(z.object({
-					name: z.string(),
-					values: z.array(z.number())
-				})).min(1)
-			}),
-			example: {
-				component: "Chart",
-				props: {
-					type: "bar",
-					labels: ["Q3", "Q4"],
-					series: [{
-						name: "Revenue",
-						values: [9800, 12400]
-					}]
-				}
-			}
-		},
-		{
-			name: "Timeline",
-			group: "data",
-			description: "Ordered steps or events, earliest first.",
-			props: z.object({ items: z.array(z.object({
-				title: z.string(),
-				time: z.string().optional(),
-				description: z.string().optional(),
-				state: z.enum([
-					"done",
-					"active",
-					"pending"
-				]).default("pending")
-			})).min(1) }),
-			example: {
-				component: "Timeline",
-				props: { items: [{
-					title: "Plan",
-					time: "Mon",
-					state: "done"
-				}, {
-					title: "Build",
-					time: "Tue",
-					state: "active"
-				}] }
-			}
-		},
-		{
-			name: "FileLink",
-			group: "data",
-			description: "A download entry for a file. The host automatically renders every artifact the run produced as a download card, so never create a FileLink for those; use it only for files that are not run artifacts.",
-			props: z.object({
-				path: z.string(),
-				label: z.string().optional(),
-				mimeType: z.string().optional(),
-				/** 字节数；人类可读格式化是渲染层的事，不进 props */
-				size: z.number().int().nonnegative().optional(),
-				actions: z.array(actionRef).optional()
-			}),
-			constraints: ["size is a byte count, not a formatted string"],
-			example: {
-				component: "FileLink",
-				props: {
-					path: "report.csv",
-					label: "Download report",
-					size: 2411724
-				}
-			}
-		},
-		{
-			name: "Form",
-			group: "input",
-			description: "Collects user input. Children must be Field nodes; actions go in the buttons prop.",
-			props: z.object({
-				title: z.string().optional(),
-				submitLabel: z.string().default("Submit"),
-				cancelLabel: z.string().optional()
-			}),
-			children: ["Field", "FieldArray"],
-			singletonPerContainer: true,
-			constraints: ["At most one Form per container", "Every Field name must be unique inside the Form"],
-			example: {
-				component: "Form",
-				props: { title: "Schedule report" },
-				children: [{
-					component: "Field",
-					props: {
-						name: "email",
-						label: "Email",
-						type: "text",
-						required: true
-					}
-				}]
-			}
-		},
-		{
-			name: "Field",
-			group: "input",
-			description: "A single form control. Only valid inside a Form.",
-			props: z.object({
-				name: z.string(),
-				label: z.string(),
-				type: z.enum([
-					"text",
-					"number",
-					"date",
-					"textarea",
-					"select",
-					"multi-select",
-					"toggle",
-					"file",
-					"password"
-				]),
-				required: z.boolean().optional(),
-				description: z.string().optional(),
-				defaultValue: z.unknown().optional(),
-				options: fieldOptions.optional(),
-				/** 声明后选项由宕主异步提供；与写死的 options 互斥 */
-				optionsSource: z.string().optional(),
-				visibleWhen: fieldCondition.optional()
-			}),
-			constraints: [
-				"select / multi-select must provide options or optionsSource",
-				"password values are never persisted, never echoed and never enter the user profile",
-				"visibleWhen may only reference fields declared in the same Form"
-			],
-			example: {
-				component: "Field",
-				props: {
-					name: "range",
-					label: "Range",
-					type: "select",
-					options: []
-				}
-			}
-		},
-		{
-			name: "FieldArray",
-			group: "input",
-			description: "A repeatable group of fields. Only valid inside a Form; children must be Field nodes.",
-			props: z.object({
-				name: z.string(),
-				label: z.string(),
-				minItems: z.number().int().min(0).optional(),
-				maxItems: z.number().int().min(1).optional(),
-				addLabel: z.string().optional(),
-				removeLabel: z.string().optional()
-			}),
-			children: ["Field"],
-			constraints: ["Only valid inside a Form", "Submitted as an array of objects keyed by the inner Field names"],
-			example: {
-				component: "FieldArray",
-				props: {
-					name: "recipients",
-					label: "Recipients",
-					minItems: 1
-				},
-				children: [{
-					component: "Field",
-					props: {
-						name: "email",
-						label: "Email",
-						type: "text"
-					}
-				}]
-			}
-		},
-		{
-			name: "Button",
-			group: "input",
-			description: "Triggers one of the catalog actions.",
-			props: actionRef,
-			example: {
-				component: "Button",
-				props: {
-					action: "submit",
-					label: "Send"
-				}
-			}
-		},
-		{
-			name: "Progress",
-			group: "feedback",
-			description: "How far a long-running task has come, in percent.",
-			props: z.object({
-				label: z.string().optional(),
-				value: z.number().min(0).max(100),
-				tone: z.enum([
-					"neutral",
-					"success",
-					"warning"
-				]).default("neutral")
-			}),
-			example: {
-				component: "Progress",
-				props: {
-					label: "Indexing",
-					value: 42
-				}
-			}
-		},
-		{
-			name: "Icon",
-			group: "content",
-			description: "A small semantic icon, picked from the catalog whitelist. Use it to mark an item inside a list or next to a heading, never on its own as decoration. Names outside the whitelist are dropped by the renderer, so choose the closest listed name instead of inventing one.",
-			props: z.object({
-				name: iconName,
-				palette: palette.optional()
-			}),
-			example: {
-				component: "Icon",
-				props: {
-					name: "check",
-					palette: "emerald"
-				}
-			}
-		},
-		{
-			name: "Image",
-			group: "content",
-			description: "An image the host already serves. `src` must be same-origin or a data URL — remote URLs are rejected by policy, so never link to an image you found on the web. `alt` is required: it is what a screen reader and a later model read instead of the pixels.",
-			props: z.object({
-				src: imageSrc,
-				alt: z.string(),
-				ratio: z.enum([
-					"auto",
-					"1:1",
-					"4:3",
-					"16:9"
-				]).default("auto")
-			}),
-			example: {
-				component: "Image",
-				props: {
-					src: "/chart.png",
-					alt: "Revenue by region",
-					ratio: "16:9"
-				}
-			}
-		},
-		{
-			name: "Quote",
-			group: "content",
-			description: "Someone else's words, set apart from your own. Use it when you are repeating a customer comment, a policy sentence or a source document, so the reader can tell it apart from your summary. Do not use it for emphasis.",
-			props: z.object({
-				text: z.string(),
-				by: z.string().optional()
-			}),
-			example: {
-				component: "Quote",
-				props: {
-					text: "Delivery was two days late.",
-					by: "Order A-1002"
-				}
-			}
-		},
-		{
-			name: "Callout",
-			group: "content",
-			description: "A side note the reader may want but does not have to act on — background, a caveat, a definition. Use `Alert` instead when it is a state they must react to, and plain `Text` when it belongs in the flow of the answer.",
-			props: z.object({
-				title: z.string().optional(),
-				text: z.string(),
-				palette: palette.optional()
-			}),
-			example: {
-				component: "Callout",
-				props: {
-					title: "How this is counted",
-					text: "Refunds are excluded."
-				}
-			}
-		},
-		{
-			name: "KeyValue",
-			group: "data",
-			description: "Facts about one thing, as label/value pairs. Use it when a `Table` would have a single row, for example the details of one order. For several comparable rows use `Table`, and for one headline number use `Metric`.",
-			props: z.object({ items: z.array(z.object({
-				label: z.string(),
-				value: z.string()
-			})).min(1) }),
-			example: {
-				component: "KeyValue",
-				props: { items: [{
-					label: "Status",
-					value: "Shipped"
-				}, {
-					label: "Carrier",
-					value: "DHL"
-				}] }
-			}
-		},
-		{
-			name: "Gauge",
-			group: "data",
-			description: "One value read against a range — capacity used, budget spent, a score out of a maximum. Give `min` and `max` when the range is not 0-100. Use `Progress` for how far a task has come, and `Metric` when there is no range to compare against.",
-			props: z.object({
-				label: z.string().optional(),
-				value: z.number(),
-				min: z.number().default(0),
-				max: z.number().default(100),
-				tone: z.enum([
-					"neutral",
-					"success",
-					"warning"
-				]).default("neutral")
-			}),
-			example: {
-				component: "Gauge",
-				props: {
-					label: "Disk used",
-					value: 82,
-					tone: "warning"
-				}
-			}
-		},
-		{
-			name: "Accordion",
-			group: "layout",
-			description: "Sections the reader opens one at a time. Use it for a long report where most readers only need one part, so the answer stays scannable instead of becoming a wall of text. Use `Tabs` when the sections are alternatives rather than a sequence, and plain `Card`s when there are only two or three short ones.",
-			props: z.object({ items: z.array(z.object({
-				title: z.string(),
-				text: z.string()
-			})).min(1) }),
-			example: {
-				component: "Accordion",
-				props: { items: [{
-					title: "Method",
-					text: "Sampled hourly."
-				}, {
-					title: "Caveats",
-					text: "Week 12 is partial."
-				}] }
-			}
-		},
-		{
-			name: "Carousel",
-			group: "layout",
-			description: "Slides the reader scrolls through sideways — an itinerary day by day, a set of options, a small gallery. Each slide carries its own title and optional image, and only one is in view at a time. Use `Grid` when the reader should compare the items side by side instead of one at a time.",
-			props: z.object({ items: z.array(z.object({
-				title: z.string(),
-				text: z.string().optional(),
-				src: z.string().optional()
-			})).min(1) }),
-			example: {
-				component: "Carousel",
-				props: { items: [{
-					title: "Day 1",
-					text: "Arrival"
-				}, {
-					title: "Day 2",
-					text: "Old town"
-				}] }
-			}
-		},
-		{
-			name: "Alert",
-			group: "feedback",
-			description: "Draws attention to a state the user must know about.",
-			props: z.object({
-				tone: z.enum([
-					"info",
-					"warning",
-					"destructive"
-				]).default("info"),
-				title: z.string(),
-				description: z.string().optional()
-			}),
-			example: {
-				component: "Alert",
-				props: {
-					tone: "warning",
-					title: "Partial data"
-				}
-			}
-		},
-		{
-			name: "Custom",
-			group: "layout",
-			description: "Host extension point; the name must be registered in the host SurfaceRegistry.",
-			props: z.object({
-				name: z.string(),
-				props: z.record(z.string(), z.unknown()).default({})
-			}),
-			constraints: ["Rejected when the host has not registered the component name"],
-			example: {
-				component: "Custom",
-				props: {
-					name: "sales-map",
-					props: {}
-				}
-			}
-		}
-	],
-	actions: [
-		{
-			name: "submit",
-			description: "Submit the surface form values back to the waiting run."
-		},
-		{
-			name: "cancel",
-			description: "Dismiss the surface without submitting."
-		},
-		{
-			name: "select",
-			description: "Report a selected row or option."
-		},
-		{
-			name: "download",
-			description: "Download the referenced artifact."
-		},
-		{
-			name: "refresh",
-			description: "Ask the run to recompute the surface."
-		}
-	]
-});
-/** prompt / 文档里引用的分组顺序（Console 展示同序） */
-const UI_CATALOG_GROUPS = {
-	content: CONTENT,
-	data: DATA,
-	input: INPUT
-};
-/**
-* catalog 系统提示的体积上限（UTF-8 字节，FR-6.6）。
-*
-* **0.11.0 起只是 `CATALOG_PROMPT_MAX` 的别名**：旧值 20 480 相对实际 7 788 宽了 2.6 倍，
-* 拦不住任何东西；且它只量提示词，漏掉了 `render_ui` 入参 Schema 那约两分之一的成本。
-* @deprecated 用 `CATALOG_PROMPT_MAX` / `CATALOG_SCHEMA_MAX`（`./budget`）。
-*/
-const UI_CATALOG_PROMPT_BUDGET_BYTES = CATALOG_PROMPT_MAX;
-/** A2UI 协议公共类型（与 @a2ui/web_core 的 common-types 同一套定义） */
-const A2UI_COMMON_TYPES = "https://a2ui.org/specification/v0_9/common_types.json";
-const CHILD_LIST_REF = `${A2UI_COMMON_TYPES}#/$defs/ChildList`;
-const ACTION_REF = `${A2UI_COMMON_TYPES}#/$defs/Action`;
-const DYNAMIC_VALUE_REF = `${A2UI_COMMON_TYPES}#/$defs/DynamicValue`;
-/** catalog 里承载 action 名的 props 字段 */
-const ACTION_PROP = "action";
-/** 表单控件的标识字段；有它才谈得上把值写进数据模型 */
-const NAME_PROP = "name";
-const SUBMIT_LABEL_PROP = "submitLabel";
-const CANCEL_LABEL_PROP = "cancelLabel";
-/** A2UI 线上形状里表单控件的取值字段 */
-const A2UI_VALUE_PROP = "value";
-/** A2UI 线上形状里的子节点字段 */
-const A2UI_CHILDREN_PROP = "children";
-/** catalog → 每个组件的 A2UI 线上形状 */
-function a2uiComponentShapes(catalog) {
-	const branches = catalog.toJsonSchema()["oneOf"] ?? [];
-	const byName = /* @__PURE__ */ new Map();
-	for (const branch of branches) {
-		const name = (branch.properties?.["component"])?.["const"];
-		if (typeof name === "string") byName.set(name, branch);
-	}
-	return catalog.components.map((def) => {
-		const branch = byName.get(def.name);
-		const props = branch?.properties?.["props"] ?? { type: "object" };
-		const keys = Object.keys(props.properties ?? {});
-		const childrenDescription = (branch?.properties?.["children"])?.description;
-		return {
-			name: def.name,
-			description: def.description,
-			props,
-			staticProps: keys.filter((key) => key !== ACTION_PROP),
-			childList: def.children !== void 0,
-			...childrenDescription ? { childListDescription: childrenDescription } : {},
-			actionProps: keys.filter((key) => key === ACTION_PROP),
-			valueProps: def.group === "input" && def.children === void 0 && keys.includes(NAME_PROP) ? [A2UI_VALUE_PROP] : [],
-			...keys.includes(SUBMIT_LABEL_PROP) ? { submitLabelProp: SUBMIT_LABEL_PROP } : {},
-			...keys.includes(CANCEL_LABEL_PROP) ? { cancelLabelProp: CANCEL_LABEL_PROP } : {}
-		};
-	});
-}
-/** 单个组件的 A2UI props JSON Schema（协议要求每个组件是一份 schema） */
-function a2uiComponentSchema(shape) {
-	const properties = { ...shape.props.properties ?? {} };
-	for (const key of shape.actionProps) properties[key] = {
-		$ref: ACTION_REF,
-		description: "What happens when the user activates this component."
-	};
-	for (const key of shape.valueProps) properties[key] = {
-		$ref: DYNAMIC_VALUE_REF,
-		description: "Two-way binding to the surface data model."
-	};
-	if (shape.childList) properties[A2UI_CHILDREN_PROP] = {
-		$ref: CHILD_LIST_REF,
-		description: shape.childListDescription ? `${shape.childListDescription}. Children are referenced by id, never inlined.` : "Child component ids, in render order."
-	};
-	return {
-		...shape.props,
-		description: shape.description,
-		properties
-	};
-}
-/** 自定义 catalog 的协议 id（对齐 https://a2ui.org/specification/v1_0/catalog_definition.json） */
-const WEBSKILL_A2UI_CATALOG_ID = "https://webskill.dev/a2ui/catalogs/v1/catalog.json";
-/**
-* WebSkill catalog → A2UI `catalog_definition.json`。
-* 组件 schema 由 catalog 的 JSON Schema 投影经 `a2uiComponentShapes` 改写成 A2UI 线上形状
-* （嵌套变 id 引用、action 名变协议信封），不手写第二份词汇表——
-* Lit 元素的 zod API 也由同一份 shape 派生。
-*/
-function buildA2uiCatalogDefinition(catalog) {
-	const components = {};
-	for (const shape of a2uiComponentShapes(catalog)) components[shape.name] = a2uiComponentSchema(shape);
-	return {
-		catalogId: WEBSKILL_A2UI_CATALOG_ID,
-		title: catalog.title,
-		description: `${catalog.title} ${catalog.version}`,
-		instructions: catalog.instructions,
-		components,
-		functions: Object.fromEntries(catalog.actions.map((action) => [action.name, { description: action.description }]))
-	};
-}
-
-//#endregion
-//#region ../ui/dist/index.js
-const isEmpty$1 = (v) => v === void 0 || v === "";
-/**
-* 控件名 → 属性选择器：优先 CSS.escape（标识符形式，免引号转义）；
-* 无 CSS.escape 的环境退化为引号包裹 + 转义反斜杠/双引号（防选择器注入崩溃）
-*/
-function controlSelector(name) {
-	if (typeof CSS !== "undefined" && typeof CSS.escape === "function") return `[data-webskill-control=${CSS.escape(name)}]`;
-	return `[data-webskill-control="${name.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"]`;
-}
-/**
-* 严格类型化控件值收集：
-* - number 空串 → undefined（非 0）；非数值输入（NaN）按缺失处理（required 时入 missingRequired）
-* - select 用 option 值本身经 JSON 编码比对命中（对象值可正确命中）
-* - required 空值列入 missingRequired（由调用方阻止提交并标记）
-*/
-function collectValues(controls, container) {
-	const values = {};
-	const missingRequired = [];
-	for (const control of controls) {
-		const el = container.querySelector(controlSelector(control.name));
-		let value;
-		if (el === null) value = void 0;
-		else if (control.control === "boolean") value = el.checked;
-		else if (control.control === "number") {
-			const raw = el.value.trim();
-			if (raw === "") value = void 0;
-			else {
-				const n = Number(raw);
-				value = Number.isNaN(n) ? void 0 : n;
-			}
-		} else if (control.control === "select") {
-			const attr = el.value;
-			const hit = control.options?.find((o) => JSON.stringify(o.value) === attr);
-			value = hit ? hit.value : attr === "" ? void 0 : attr;
-		} else {
-			const raw = el.value;
-			value = raw === "" ? void 0 : raw;
-		}
-		values[control.name] = value;
-		if (control.required && isEmpty$1(value)) missingRequired.push(control.name);
-	}
-	return {
-		values,
-		missingRequired
-	};
-}
-/**
-* 采纳建议值（FR-5.9）：把 `control.suggestion` 写进已渲染的控件。
-* 与 `collectValues` 共用同一套选择器与编码约定——两边分开实现的话，
-* select 的 JSON 编码值迟早会对不上。
-* @experimental
-*/
-function applySuggestion(control, container) {
-	if (control.suggestion === void 0) return;
-	const el = container.querySelector(controlSelector(control.name));
-	if (el === null) return;
-	const { value } = control.suggestion;
-	if (control.control === "boolean") {
-		el.checked = value === true;
-		return;
-	}
-	if (control.control === "select") {
-		el.value = JSON.stringify(value);
-		return;
-	}
-	el.value = value === void 0 || value === null ? "" : String(value);
-}
-/**
-* 轻量 SVG 图表自绘（bar/line/pie，零依赖，三端复用单一来源）。
-* 全部经 doc.createElementNS 构建（内容来自技能输出，不拼 innerHTML）。
-*/
-const SVG_NS = "http://www.w3.org/2000/svg";
-/**
-* 固定 8 色循环调色板。这是**数据编码**（区分序列），不是主题色；
-* 图表的轴线与文字等“外壳”颜色走 currentColor，跟随宿主容器的主题。
-*/
-const CHART_PALETTE = [
-	"#4e79a7",
-	"#f28e2b",
-	"#e15759",
-	"#76b7b2",
-	"#59a14f",
-	"#edc948",
-	"#b07aa1",
-	"#ff9da7"
-];
-const WIDTH = 320;
-const HEIGHT = 200;
-function el(doc, name, attrs) {
-	const node = doc.createElementNS(SVG_NS, name);
-	for (const [key, value] of Object.entries(attrs)) node.setAttribute(key, value);
-	return node;
-}
-function text(doc, x, y, content, attrs = {}) {
-	const node = el(doc, "text", {
-		x: String(x),
-		y: String(y),
-		"font-size": "9",
-		fill: "currentColor",
-		"fill-opacity": "0.65",
-		...attrs
-	});
-	node.textContent = content;
-	return node;
-}
-const fmt = (n) => Number.isInteger(n) ? String(n) : n.toFixed(1);
-function maxValue(chart) {
-	let max = 0;
-	for (const s of chart.series) for (const v of s.data) if (v > max) max = v;
-	return max;
-}
-function renderBar(chart, svg, doc) {
-	const plot = {
-		x0: 30,
-		y0: 24,
-		x1: 312,
-		y1: 164
-	};
-	const max = maxValue(chart);
-	svg.appendChild(el(doc, "line", {
-		x1: String(plot.x0),
-		y1: String(plot.y0),
-		x2: String(plot.x0),
-		y2: String(plot.y1),
-		stroke: "currentColor",
-		"stroke-opacity": "0.35"
-	}));
-	svg.appendChild(el(doc, "line", {
-		x1: String(plot.x0),
-		y1: String(plot.y1),
-		x2: String(plot.x1),
-		y2: String(plot.y1),
-		stroke: "currentColor",
-		"stroke-opacity": "0.35"
-	}));
-	if (max <= 0 || chart.labels.length === 0 || chart.series.length === 0) return;
-	const groupWidth = (plot.x1 - plot.x0) / chart.labels.length;
-	const barWidth = Math.max(1, groupWidth / chart.series.length * .7);
-	chart.series.forEach((series, si) => {
-		const color = CHART_PALETTE[si % CHART_PALETTE.length];
-		series.data.forEach((value, li) => {
-			if (li >= chart.labels.length) return;
-			const height = (plot.y1 - plot.y0) * value / max;
-			const x = plot.x0 + li * groupWidth + (groupWidth - barWidth * chart.series.length) / 2 + si * barWidth;
-			const y = plot.y1 - height;
-			svg.appendChild(el(doc, "rect", {
-				x: String(x),
-				y: String(y),
-				width: String(barWidth),
-				height: String(height),
-				fill: color,
-				"data-series": series.name ?? String(si)
-			}));
-			if (chart.series.length === 1) svg.appendChild(text(doc, x + barWidth / 2, y - 2, fmt(value), { "text-anchor": "middle" }));
-		});
-	});
-	chart.labels.forEach((label, li) => {
-		svg.appendChild(text(doc, plot.x0 + li * groupWidth + groupWidth / 2, plot.y1 + 12, label, { "text-anchor": "middle" }));
-	});
-}
-function renderLine(chart, svg, doc) {
-	const plot = {
-		x0: 30,
-		y0: 24,
-		x1: 312,
-		y1: 164
-	};
-	const max = maxValue(chart);
-	svg.appendChild(el(doc, "line", {
-		x1: String(plot.x0),
-		y1: String(plot.y0),
-		x2: String(plot.x0),
-		y2: String(plot.y1),
-		stroke: "currentColor",
-		"stroke-opacity": "0.35"
-	}));
-	svg.appendChild(el(doc, "line", {
-		x1: String(plot.x0),
-		y1: String(plot.y1),
-		x2: String(plot.x1),
-		y2: String(plot.y1),
-		stroke: "currentColor",
-		"stroke-opacity": "0.35"
-	}));
-	if (max <= 0 || chart.labels.length === 0 || chart.series.length === 0) return;
-	const step = chart.labels.length > 1 ? (plot.x1 - plot.x0) / (chart.labels.length - 1) : 0;
-	const px = (li) => chart.labels.length > 1 ? plot.x0 + li * step : (plot.x0 + plot.x1) / 2;
-	const py = (v) => plot.y1 - (plot.y1 - plot.y0) * v / max;
-	chart.series.forEach((series, si) => {
-		const color = CHART_PALETTE[si % CHART_PALETTE.length];
-		const points = series.data.slice(0, chart.labels.length).map((v, li) => `${px(li)},${py(v)}`).join(" ");
-		if (points !== "") svg.appendChild(el(doc, "polyline", {
-			points,
-			fill: "none",
-			stroke: color,
-			"stroke-width": "1.5"
-		}));
-		series.data.slice(0, chart.labels.length).forEach((v, li) => {
-			svg.appendChild(el(doc, "circle", {
-				cx: String(px(li)),
-				cy: String(py(v)),
-				r: "2",
-				fill: color
-			}));
-		});
-	});
-	chart.labels.forEach((label, li) => {
-		svg.appendChild(text(doc, px(li), plot.y1 + 12, label, { "text-anchor": "middle" }));
-	});
-}
-function renderPie(chart, svg, doc) {
-	const data = (chart.series[0]?.data ?? []).slice(0, chart.labels.length);
-	const total = data.reduce((sum, v) => sum + (v > 0 ? v : 0), 0);
-	const cx = 90;
-	const cy = 104;
-	const r = 72;
-	if (total <= 0) {
-		svg.appendChild(text(doc, cx, cy, "No data", { "text-anchor": "middle" }));
-		return;
-	}
-	let angle = -Math.PI / 2;
-	data.forEach((value, i) => {
-		const label = chart.labels[i] ?? String(i);
-		const color = CHART_PALETTE[i % CHART_PALETTE.length];
-		const slice = Math.max(value, 0) / total * Math.PI * 2;
-		const x0 = cx + r * Math.cos(angle);
-		const y0 = cy + r * Math.sin(angle);
-		const x1 = cx + r * Math.cos(angle + slice);
-		const y1 = cy + r * Math.sin(angle + slice);
-		const path = el(doc, "path", {
-			d: `M ${cx} ${cy} L ${x0} ${y0} A ${r} ${r} 0 ${slice > Math.PI ? "1" : "0"} 1 ${x1} ${y1} Z`,
-			fill: color,
-			"data-label": label
-		});
-		svg.appendChild(path);
-		angle += slice;
-		const ly = 40 + i * 14;
-		svg.appendChild(el(doc, "rect", {
-			x: "190",
-			y: String(ly - 7),
-			width: "8",
-			height: "8",
-			fill: color
-		}));
-		svg.appendChild(text(doc, 202, ly, `${label} (${fmt(value)})`));
-	});
-}
-/**
-* ChartSpec → SVG（bar 等宽柱 + 值标签；line 折线 + 点；pie 扇形 + 图例；空数据容错）。
-* mini 档只有这三种画法，其余类型走最接近的一种并在图内注明是近似呈现。
-* @stable
-*/
-function renderMiniChart(chart, doc) {
-	const svg = el(doc, "svg", {
-		viewBox: `0 0 ${WIDTH} ${HEIGHT}`,
-		width: String(WIDTH),
-		height: String(HEIGHT),
-		class: `webskill-chart webskill-chart--${chart.kind}`,
-		role: "img"
-	});
-	if (chart.title) svg.appendChild(text(doc, WIDTH / 2, 14, chart.title, {
-		"text-anchor": "middle",
-		"font-size": "11",
-		fill: "currentColor",
-		"fill-opacity": "1"
-	}));
-	switch (chart.kind) {
-		case "bar":
-		case "stacked-bar":
-			renderBar(chart, svg, doc);
-			break;
-		case "line":
-			renderLine(chart, svg, doc);
-			break;
-		case "pie":
-			renderPie(chart, svg, doc);
-			break;
-		default:
-			renderLine(chart, svg, doc);
-			break;
-	}
-	if (chart.kind !== "bar" && chart.kind !== "line" && chart.kind !== "pie") svg.appendChild(text(doc, WIDTH / 2, HEIGHT - 4, `Approximate rendering of "${chart.kind}"`, { "text-anchor": "middle" }));
-	return svg;
-}
-/** A2UI/OpenUI 降级：chart → table（labels 为首列，series 各为一列） */
-function chartToTable(chart) {
-	return {
-		type: "table",
-		columns: ["label", ...chart.series.map((s, i) => s.name ?? `series ${i + 1}`)],
-		rows: chart.labels.map((label, li) => [label, ...chart.series.map((s) => s.data[li] ?? null)])
-	};
-}
-/**
-* `Gauge` 的百分比换算（0.11.0 分册 19 FR-19.2）。
-*
-* catalog 的 React `SpecGauge` 与文档面的预置组件都读这一份：
-* 换算里有两个容易各写各的判断——`max === min` 时不能除零、越界值要夹紧——
-* 两处各写一遍就会在边界值上给出不同的条。
-*/
-function gaugePercent(value, min, max) {
-	const span = max - min;
-	if (span <= 0) return 0;
-	return Math.max(0, Math.min(100, (value - min) / span * 100));
-}
-/** RenderBlock → DOM（markdown/json/table/image/file/chart 六种） */
-function renderBlocks(container, blocks, doc) {
-	for (const block of blocks) switch (block.type) {
-		case "chart":
-			container.appendChild(renderMiniChart(block.chart, doc));
-			break;
-		case "markdown":
-			container.appendChild(renderMiniMarkdown(block.text, doc));
-			break;
-		case "json": {
-			const pre = doc.createElement("pre");
-			pre.className = "webskill-result__json";
-			pre.textContent = JSON.stringify(block.data, null, 2);
-			container.appendChild(pre);
-			break;
-		}
-		case "table": {
-			const table = doc.createElement("table");
-			const thead = doc.createElement("thead");
-			const headRow = doc.createElement("tr");
-			for (const column of block.columns) {
-				const th = doc.createElement("th");
-				th.textContent = column;
-				headRow.appendChild(th);
-			}
-			thead.appendChild(headRow);
-			table.appendChild(thead);
-			const tbody = doc.createElement("tbody");
-			for (const row of block.rows) {
-				const tr = doc.createElement("tr");
-				for (const cell of row) {
-					const td = doc.createElement("td");
-					td.textContent = typeof cell === "object" ? JSON.stringify(cell) : String(cell ?? "");
-					tr.appendChild(td);
-				}
-				tbody.appendChild(tr);
-			}
-			table.appendChild(tbody);
-			container.appendChild(table);
-			break;
-		}
-		case "image": {
-			const img = doc.createElement("img");
-			img.src = block.url;
-			img.alt = block.alt ?? "";
-			container.appendChild(img);
-			break;
-		}
-		case "file": {
-			const div = doc.createElement("div");
-			div.className = "webskill-result__file";
-			const meta = [block.mimeType, block.size !== void 0 ? `${block.size} bytes` : void 0].filter(Boolean).join(", ");
-			div.textContent = meta ? `${block.path} (${meta})` : block.path;
-			container.appendChild(div);
-			break;
-		}
-	}
-}
-/** 完整 RenderResultRequest → DOM（summary 头 + blocks） */
-function renderRenderResult(request, doc) {
-	const root = doc.createElement("div");
-	root.className = "webskill-result";
-	if (request.title) {
-		const title = doc.createElement("div");
-		title.className = "webskill-form__title";
-		title.textContent = request.title;
-		root.appendChild(title);
-	}
-	if (request.summary) {
-		const summary = doc.createElement("div");
-		summary.className = "webskill-result__summary";
-		summary.textContent = request.summary;
-		root.appendChild(summary);
-	}
-	renderBlocks(root, request.blocks, doc);
-	return root;
-}
-/**
-* viewer 的宿主预置组件（0.11.0 分册 18 FR-18.5 / 分册 19）。
-*
-* 技能**不写 JS**：文档 HTML 里只留占位，由这里挂载真实组件。
-* 交互只落在图表上——表格排序的例子已作废（分册 29 §2 登记 #13）。
-*
-* 三条硬约束：
-* - props 用 **catalog 自己的 zod schema** 解析，同形因此是机制上成立的，
-*   不是靠一句「记得同步」的注释（FR-19.2）；
-* - 值一律经 `textContent` 落地，**永不** `innerHTML`（FR-19.4 / AC-19.5）；
-* - 白名单外的名字只渲染降级提示，**不触发任何按名 import**（FR-19.3）。
-*/
-/** 占位元素的属性名，模板与挂载方共用（FR-19.1 的契约） */
-const VIEWER_COMPONENT_ATTR = "data-webskill-component";
-const VIEWER_PROPS_ATTR = "data-webskill-props";
-/** 降级提示的标记；模板 CSS 与判据都认这个属性，不认某个 class 名 */
-const VIEWER_FALLBACK_ATTR = "data-webskill-fallback";
-/** 文档面可用的组件白名单（FR-19.3）。字面量数组——不接受任何按名动态加载 */
-const DOCUMENT_COMPONENTS = [
-	"Chart",
-	"Table",
-	"Metric",
-	"Gauge",
-	"KeyValue"
-];
-const WHITELIST = new Set(DOCUMENT_COMPONENTS);
-/**
-* 扫描 `root` 下的占位并挂载预置组件。
-*
-* 逐个占位独立处理：一个坏占位只降级它自己，不会让整篇文档变空白。
-*/
-function mountViewerComponents(root, options) {
-	const handles = [];
-	for (const node of Array.from(root.querySelectorAll(`[${VIEWER_COMPONENT_ATTR}]`))) {
-		const element = node;
-		const name = element.getAttribute("data-webskill-component") ?? "";
-		if (!WHITELIST.has(name)) {
-			fallback(element, `Unsupported component "${name}"`);
-			continue;
-		}
-		const props = readProps(element, name);
-		if (!props) continue;
-		const handle = render(element, name, props, options?.fontSizes);
-		if (handle) handles.push(handle);
-	}
-	return { dispose: () => {
-		for (const handle of handles) handle.dispose();
-		handles.length = 0;
-	} };
-}
-/** 用 catalog 的 schema 解析：多余字段被丢弃，缺省值与 catalog 完全一致 */
-function readProps(element, name) {
-	const raw = element.getAttribute(VIEWER_PROPS_ATTR);
-	if (raw === null || raw === "") {
-		fallback(element, `Component "${name}" is missing ${VIEWER_PROPS_ATTR}`);
-		return;
-	}
-	let parsed;
-	try {
-		parsed = JSON.parse(raw);
-	} catch {
-		fallback(element, `Component "${name}" has invalid props JSON`);
-		return;
-	}
-	const schema = uiCatalog.component(name)?.props;
-	if (!schema) {
-		fallback(element, `Component "${name}" is not declared in the catalog`);
-		return;
-	}
-	const result = schema.safeParse(parsed);
-	if (!result.success) {
-		fallback(element, `Component "${name}" has props the catalog rejects`);
-		return;
-	}
-	return result.data;
-}
-function render(element, name, props, fontSizes) {
-	const doc = element.ownerDocument;
-	element.replaceChildren();
-	switch (name) {
-		case "Chart": {
-			const handle = mountEchart(element);
-			handle.setChart(chartSpecFromProps(props), fontSizes);
-			return handle;
-		}
-		case "Table":
-			renderBlocks(element, [{
-				type: "table",
-				columns: props["columns"],
-				rows: props["rows"]
-			}], doc);
-			return;
-		case "Metric": {
-			append(doc, element, "span", String(props["label"]), { "data-webskill-metric": "label" });
-			append(doc, element, "strong", String(props["value"]), { "data-webskill-metric": "value" });
-			const change = props["change"];
-			if (typeof change === "string") append(doc, element, "span", change, {
-				"data-webskill-metric": "change",
-				"data-trend": String(props["trend"] ?? "neutral")
-			});
-			return;
-		}
-		case "Gauge": {
-			const value = props["value"];
-			const min = props["min"];
-			const max = props["max"];
-			const label = typeof props["label"] === "string" ? props["label"] : "";
-			element.setAttribute("data-tone", String(props["tone"]));
-			if (label !== "") append(doc, element, "span", label, { "data-webskill-gauge": "label" });
-			const fill = append(doc, append(doc, element, "div", "", {
-				role: "meter",
-				"aria-label": label === "" ? "Gauge" : label,
-				"aria-valuenow": String(value),
-				"aria-valuemin": String(min),
-				"aria-valuemax": String(max),
-				"data-webskill-gauge": "track"
-			}), "div", "", { "data-webskill-gauge": "fill" });
-			fill.style.width = `${gaugePercent(value, min, max)}%`;
-			append(doc, element, "span", String(value), { "data-webskill-gauge": "value" });
-			return;
-		}
-		case "KeyValue": {
-			const dl = append(doc, element, "dl", "", {});
-			for (const item of props["items"]) {
-				append(doc, dl, "dt", item.label, {});
-				append(doc, dl, "dd", item.value, {});
-			}
-			return;
-		}
-	}
-}
-function append(doc, parent, tag, text, attrs) {
-	const el = doc.createElement(tag);
-	for (const [key, value] of Object.entries(attrs)) el.setAttribute(key, value);
-	if (text !== "") el.textContent = text;
-	parent.appendChild(el);
-	return el;
-}
-/**
-* 可见降级（AC-19.4）。
-*
-* 静默留空是最坏的结果：文档看着「渲染成功」，作者却不知道自己写错了组件名。
-* 原有内容整体替换，避免半截渲染与提示并存。
-*/
-function fallback(element, reason) {
-	element.setAttribute(VIEWER_FALLBACK_ATTR, "true");
-	element.textContent = reason;
-}
-/** 最小样式（BEM class，应用可整体覆写） */
-const WEBSKILL_STYLES_CSS = `
-.webskill-form { display: block; padding: 12px; border: 1px solid #d0d0d0; border-radius: 8px; font-family: system-ui, sans-serif; max-width: 420px; }
-.webskill-form__title { margin: 0 0 8px; font-size: 15px; font-weight: 600; }
-.webskill-form__message { margin: 0 0 10px; font-size: 14px; }
-.webskill-form__control { margin-bottom: 10px; display: flex; flex-direction: column; gap: 4px; }
-.webskill-form__control--invalid .webskill-form__input { border-color: #d33; }
-.webskill-form__label { font-size: 13px; font-weight: 500; }
-.webskill-form__label-required::after { content: ' *'; color: #d33; }
-.webskill-form__description { font-size: 12px; color: #666; }
-.webskill-form__error { font-size: 12px; color: #d33; display: none; }
-.webskill-form__control--invalid .webskill-form__error { display: block; }
-.webskill-form__input { padding: 6px 8px; border: 1px solid #bbb; border-radius: 4px; font-size: 14px; font-family: inherit; }
-.webskill-form__suggestion { display: flex; align-items: center; gap: 6px; font-size: 12px; color: #666; }
-.webskill-form__suggestion-use { padding: 1px 8px; border-radius: 4px; border: 1px solid #bbb; background: #fff; cursor: pointer; font-size: 12px; }
-.webskill-form__actions { display: flex; gap: 8px; margin-top: 12px; }
-.webskill-form__button { padding: 6px 14px; border-radius: 4px; border: 1px solid #bbb; background: #fff; cursor: pointer; font-size: 14px; }
-.webskill-form__button--primary { background: #2563eb; border-color: #2563eb; color: #fff; }
-.webskill-form__button--ghost { background: transparent; }
-.webskill-result { font-family: system-ui, sans-serif; font-size: 14px; }
-.webskill-result__summary { font-size: 12px; color: #666; margin-bottom: 6px; }
-.webskill-result__json { background: #f5f5f5; padding: 8px; border-radius: 4px; overflow-x: auto; }
-.webskill-result__file { padding: 4px 0; font-size: 13px; }
-.webskill-md pre { background: #f5f5f5; padding: 8px; border-radius: 4px; overflow-x: auto; }
-.webskill-md h1, .webskill-md h2, .webskill-md h3 { margin: 8px 0 4px; }
-.webskill-md p { margin: 4px 0; }
-.webskill-md ul { margin: 4px 0; padding-left: 20px; }
-`;
-/** 每个 document 只注入一次 */
-function ensureStyles(doc) {
-	if (doc.querySelector("style[data-webskill]")) return;
-	const style = doc.createElement("style");
-	style.setAttribute("data-webskill", "");
-	style.textContent = WEBSKILL_STYLES_CSS;
-	doc.head.appendChild(style);
-}
-const CONTROL_TAG = "data-webskill-control";
-/**
-* 框架无关原生 DOM 的 UiBridge：request 渲染表单并返回 Promise
-* （提交 resolve / 取消 {cancelled:true}），完成后卸载 DOM。
-* document 可注入（jsdom 测试）；BEM class 样式可覆写。
-*/
-var WebFormBridge = class {
-	#mount;
-	#doc;
-	#styles;
-	#progressEl;
-	#texts;
-	#interactionTexts;
-	/** 等待中的 request 取消句柄（id → 触发 cancelled 并卸载 DOM） */
-	#pending = /* @__PURE__ */ new Map();
-	constructor(options) {
-		this.#mount = options.mount;
-		this.#doc = options.document ?? options.mount.ownerDocument;
-		this.#styles = options.styles ?? true;
-		this.#interactionTexts = options.texts;
-		this.#texts = resolveSurfaceFormTexts(options.texts);
-	}
-	request(input) {
-		if (this.#styles) ensureStyles(this.#doc);
-		this.#clearProgress();
-		const model = interactionToFormModel(input, this.#interactionTexts);
-		const { form, cleanup } = this.#renderForm(model);
-		return new Promise((resolve) => {
-			const cancel = () => {
-				cleanup();
-				this.#pending.delete(input.id);
-				resolve({
-					id: input.id,
-					cancelled: true
-				});
-			};
-			this.#pending.set(input.id, cancel);
-			form.addEventListener("submit", (event) => {
-				event.preventDefault();
-				const { values, missingRequired } = collectValues(model.controls, form);
-				if (missingRequired.length > 0) {
-					for (const name of missingRequired) {
-						const wrapper = form.querySelector(`[${CONTROL_TAG}="${name}"]`)?.closest(".webskill-form__control");
-						wrapper?.classList.add("webskill-form__control--invalid");
-						wrapper?.querySelector(".webskill-form__input")?.setAttribute("aria-invalid", "true");
-					}
-					return;
-				}
-				this.#pending.delete(input.id);
-				cleanup();
-				resolve({
-					id: input.id,
-					value: shapeInteractionValue(model, values)
-				});
-			});
-			form.querySelector("[data-webskill-cancel]")?.addEventListener("click", (event) => {
-				event.preventDefault();
-				cancel();
-			});
-			this.#mount.appendChild(form);
-		});
-	}
-	/** 尽力取消等待中的 request（超时后清理遗留表单） */
-	cancel(id) {
-		this.#pending.get(id)?.();
-	}
-	async renderResult(input) {
-		if (this.#styles) ensureStyles(this.#doc);
-		this.#clearProgress();
-		this.#mount.querySelector(".webskill-result")?.remove();
-		this.#mount.appendChild(renderRenderResult(input, this.#doc));
-	}
-	async progress(input) {
-		if (!this.#progressEl) {
-			this.#progressEl = this.#doc.createElement("div");
-			this.#progressEl.className = "webskill-result__summary";
-			this.#mount.appendChild(this.#progressEl);
-		}
-		const pct = input.value !== void 0 ? ` (${Math.round(input.value * 100)}%)` : "";
-		this.#progressEl.textContent = `${input.message}${pct}`;
-	}
-	/** 新一轮交互/结果渲染开始时移除遗留 progress 元素 */
-	#clearProgress() {
-		this.#progressEl?.remove();
-		this.#progressEl = void 0;
-	}
-	#renderForm(model) {
-		const doc = this.#doc;
-		const form = doc.createElement("form");
-		form.className = "webskill-form";
-		form.noValidate = true;
-		if (model.title) {
-			const title = doc.createElement("div");
-			title.className = "webskill-form__title";
-			title.textContent = model.title;
-			form.appendChild(title);
-		}
-		if (model.message && model.kind !== "confirm" && model.kind !== "ask" && model.kind !== "select") {
-			const message = doc.createElement("p");
-			message.className = "webskill-form__message";
-			message.textContent = model.message;
-			form.appendChild(message);
-		}
-		for (const control of model.controls) form.appendChild(this.#renderControl(control));
-		const actions = doc.createElement("div");
-		actions.className = "webskill-form__actions";
-		const submit = doc.createElement("button");
-		submit.type = "submit";
-		submit.className = "webskill-form__button webskill-form__button--primary";
-		submit.textContent = model.submitLabel;
-		actions.appendChild(submit);
-		if (model.cancelLabel) {
-			const cancel = doc.createElement("button");
-			cancel.type = "button";
-			cancel.className = "webskill-form__button webskill-form__button--ghost";
-			cancel.textContent = model.cancelLabel;
-			cancel.setAttribute("data-webskill-cancel", "");
-			actions.appendChild(cancel);
-		}
-		form.appendChild(actions);
-		return {
-			form,
-			cleanup: () => form.remove()
-		};
-	}
-	#renderControl(control) {
-		const doc = this.#doc;
-		const wrapper = doc.createElement("div");
-		wrapper.className = "webskill-form__control";
-		const controlId = `webskill-field-${control.name}`;
-		const errorId = `webskill-error-${control.name}`;
-		const label = doc.createElement("label");
-		label.className = control.required ? "webskill-form__label webskill-form__label-required" : "webskill-form__label";
-		label.textContent = control.label;
-		label.htmlFor = controlId;
-		wrapper.appendChild(label);
-		if (control.description) {
-			const desc = doc.createElement("div");
-			desc.className = "webskill-form__description";
-			desc.textContent = control.description;
-			wrapper.appendChild(desc);
-		}
-		let input;
-		if (control.control === "select") {
-			const select = doc.createElement("select");
-			select.className = "webskill-form__input";
-			for (const option of control.options ?? []) {
-				const opt = doc.createElement("option");
-				opt.value = JSON.stringify(option.value);
-				opt.textContent = option.label;
-				if (control.defaultValue !== void 0 && JSON.stringify(control.defaultValue) === opt.value) opt.selected = true;
-				select.appendChild(opt);
-			}
-			input = select;
-		} else if (control.control === "boolean") {
-			const checkbox = doc.createElement("input");
-			checkbox.type = "checkbox";
-			checkbox.className = "webskill-form__input";
-			checkbox.checked = control.defaultValue === true;
-			input = checkbox;
-		} else if (control.control === "textarea") {
-			const textarea = doc.createElement("textarea");
-			textarea.className = "webskill-form__input";
-			textarea.value = control.defaultValue !== void 0 ? String(control.defaultValue) : "";
-			input = textarea;
-		} else {
-			const textInput = doc.createElement("input");
-			textInput.type = control.control === "number" ? "number" : control.control === "date" ? "date" : "text";
-			textInput.className = "webskill-form__input";
-			if (control.defaultValue !== void 0) textInput.value = String(control.defaultValue);
-			input = textInput;
-		}
-		input.setAttribute(CONTROL_TAG, control.name);
-		input.id = controlId;
-		input.setAttribute("aria-describedby", errorId);
-		wrapper.appendChild(input);
-		if (control.suggestion !== void 0) wrapper.appendChild(this.#renderSuggestion(control, wrapper));
-		const error = doc.createElement("div");
-		error.className = "webskill-form__error";
-		error.id = errorId;
-		error.setAttribute("role", "alert");
-		error.textContent = this.#texts.required;
-		wrapper.appendChild(error);
-		return wrapper;
-	}
-	/** 建议值以**建议**形态出现（FR-19.4）：控件初始值仍为空，点「使用」才写入 */
-	#renderSuggestion(control, container) {
-		const doc = this.#doc;
-		const row = doc.createElement("div");
-		row.className = "webskill-form__suggestion";
-		row.setAttribute("data-webskill-suggestion", control.name);
-		const preview = doc.createElement("span");
-		preview.className = "webskill-form__suggestion-value";
-		preview.textContent = `Suggested: ${String(control.suggestion?.value)}`;
-		row.appendChild(preview);
-		const reason = control.suggestion?.reason;
-		if (reason !== void 0 && reason !== "") {
-			const why = doc.createElement("span");
-			why.className = "webskill-form__suggestion-reason";
-			why.textContent = `(${reason})`;
-			row.appendChild(why);
-		}
-		const use = doc.createElement("button");
-		use.type = "button";
-		use.className = "webskill-form__suggestion-use";
-		use.textContent = "Use";
-		use.setAttribute("data-webskill-suggestion-use", control.name);
-		use.addEventListener("click", () => applySuggestion(control, container));
-		row.appendChild(use);
-		return row;
-	}
-};
-function fieldNamesOf(form) {
-	const names = [];
-	const walk = (node) => {
-		const name = node.props?.["name"];
-		if (node.component === "Field" && typeof name === "string") names.push(name);
-		for (const child of node.children ?? []) walk(child);
-	};
-	walk(form);
-	return names;
-}
-/**
-* 按出现序列出声明树里的每个 `Form`。
-*
-* 单表单时 action id 保持 `submit` / `cancel`，回传形状与容器级放宽前逐字节一致——
-* 向后兼容是 FR-6.3 的硬约束，不能让既有单表单卡片跟着改。
-* 多表单时每个表单拿到独立的 action id 与 `scopeId`，渲染层据此只收集本表单子树内的字段。
-*/
-function collectFormScopes(spec) {
-	const forms = [];
-	const walk = (node) => {
-		if (node.component === "Form") forms.push(node);
-		for (const child of node.children ?? []) walk(child);
-	};
-	walk(spec);
-	if (forms.length === 1) {
-		const form = forms[0];
-		return [{
-			scopeId: form.id ?? "form",
-			submitActionId: "submit",
-			cancelActionId: "cancel",
-			fieldNames: fieldNamesOf(form),
-			form
-		}];
-	}
-	return forms.map((form, index) => {
-		const scopeId = form.id ?? `form-${index}`;
-		return {
-			scopeId,
-			submitActionId: `${scopeId}:submit`,
-			cancelActionId: `${scopeId}:cancel`,
-			fieldNames: fieldNamesOf(form),
-			form
-		};
-	});
-}
-/**
-* 多表单时字段值在渲染层的存储键。
-*
-* 跨表单重名过去不可能发生，容器级放宽后它变成合法输入：两个表单各有一个 `email`，
-* 共用一张扁平表就是后写的覆盖先写的，用户在 A 里输入会串到 B。
-* 因此多表单时按作用域限定键；单表单不加前缀，存储与草稿形状保持不变。
-*/
-function qualifyFieldName(name, scopeId) {
-	return scopeId === void 0 ? name : `${scopeId}.${name}`;
-}
-/**
-* 提交时回传的字段值。
-*
-* 不给 `scope` → 整张 surface 的扁平值，与容器级放宽前完全一致（FR-6.3 第 3 条）。
-* 给了 `scope` → 只取该表单子树内的字段，键回落成裸字段名，
-* 因此接收端看到的载荷形状与单表单时相同。
-*/
-function collectScopedValues(values, scope) {
-	if (!scope) return { ...values };
-	const out = {};
-	for (const name of scope.fieldNames) {
-		const key = qualifyFieldName(name, scope.scopeId);
-		if (key in values) out[name] = values[key];
-		else if (name in values) out[name] = values[name];
-	}
-	return out;
-}
-/**
-* 条件树的语义深度上限。
-* `MAX_JSON_DEPTH` 管的是 props 的 JSON 深度，管不到这里——超它之前就能先把栈打爆。
-*/
-const MAX_CONDITION_DEPTH = 8;
-const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const isEmpty = (value) => value === void 0 || value === null || value === "" || Array.isArray(value) && value.length === 0;
-function invalid(path, detail) {
-	return {
-		visible: true,
-		degraded: {
-			path,
-			kind: "condition-invalid",
-			detail
-		}
-	};
-}
-function evaluate(condition, context, depth) {
-	if (depth > 8) return invalid(context.path, `Condition nesting exceeds 8 levels.`);
-	if (!isRecord$1(condition)) return invalid(context.path, "Condition must be an object.");
-	if (Array.isArray(condition["allOf"]) || Array.isArray(condition["anyOf"])) {
-		const isAll = Array.isArray(condition["allOf"]);
-		const branches = isAll ? condition["allOf"] : condition["anyOf"];
-		if (branches.length === 0) return invalid(context.path, `"${isAll ? "allOf" : "anyOf"}" must not be empty.`);
-		let visible = isAll;
-		for (const branch of branches) {
-			const result = evaluate(branch, context, depth + 1);
-			if (result.degraded) return result;
-			visible = isAll ? visible && result.visible : visible || result.visible;
-		}
-		return { visible };
-	}
-	const field = condition["field"];
-	if (typeof field !== "string" || field === "") return invalid(context.path, "Condition needs a \"field\" name.");
-	const value = context.resolve(field);
-	if ("equals" in condition) {
-		const expected = condition["equals"];
-		if (typeof expected !== "string" && typeof expected !== "number" && typeof expected !== "boolean") return invalid(context.path, "\"equals\" must be a string, number or boolean.");
-		return { visible: value === expected };
-	}
-	if ("in" in condition) {
-		const options = condition["in"];
-		if (!Array.isArray(options)) return invalid(context.path, "\"in\" must be an array.");
-		return { visible: options.some((option) => option === value) };
-	}
-	if ("notEmpty" in condition) {
-		if (condition["notEmpty"] !== true) return invalid(context.path, "\"notEmpty\" must be true.");
-		return { visible: !isEmpty(value) };
-	}
-	return invalid(context.path, "Condition has no recognised operator (equals / in / notEmpty / allOf / anyOf).");
-}
-/**
-* 全仓唯一的条件求值实现（AC-23.4）。纯函数、无 React 依赖——
-* `useSurfaceForm` 在 ui-react 且是 hook，ui-vue 用不了它。
-*/
-function evaluateFieldCondition(condition, values, options = {}) {
-	const resolveField = options.resolveField;
-	return evaluate(condition, {
-		values,
-		resolve: (field) => values[resolveField ? resolveField(field) : field],
-		path: options.path ?? "visibleWhen"
-	}, 1);
-}
-/**
-* 生成式表格的列模型（分册 15-03 定义 `priority`，分册 25 在同一结构上追加 `weight`）。
-*
-* 四个渲染档共用这一份：native / json-render / OpenUI 走 TS，a2ui 是 Lit，
-* 后者读不到 TS 常量，所以最小列宽以 **CSS 变量**交付，两侧引用同一个名字。
-*/
-/** 最小列宽的分档取值。`desktop` 沿用历史值，改它会动所有既有表格的视觉基线 */
-const SPEC_TABLE_MIN_COLUMN_WIDTH = {
-	desktop: "8rem",
-	mobile: "5rem"
-};
-/** CSS 侧的引用名：`surfaces.css` 与 a2ui 的 Lit 样式都只写这个变量，不写字面量 */
-const SPEC_TABLE_MIN_COLUMN_VAR = "--webskill-table-min-col";
-/**
-* 校验并归一化 `columnWidths`。
-*
-* **整项忽略**是刻意的：部分采纳（例如只丢掉那个负数）会让模型拿到一个
-* 「看起来生效了」的结果，更难发现自己写错了（FR-25.3）。
-*/
-function normalizeColumnWidths(raw, columnCount) {
-	const equal = () => Array.from({ length: columnCount }, () => 1);
-	if (raw === void 0) return { weights: equal() };
-	if (raw.length !== columnCount) return {
-		weights: equal(),
-		rejected: "length-mismatch"
-	};
-	if (raw.some((value) => typeof value !== "number" || !Number.isFinite(value))) return {
-		weights: equal(),
-		rejected: "non-finite"
-	};
-	if (raw.some((value) => value < 0)) return {
-		weights: equal(),
-		rejected: "negative"
-	};
-	if (raw.every((value) => value === 0)) return {
-		weights: equal(),
-		rejected: "all-zero"
-	};
-	return { weights: [...raw] };
-}
-/**
-* 按权重分配列宽，且每列不低于 `minWidth`。
-*
-* 朴素实现（按权重算一遍、低于下限的抬到下限）会让总宽超出容器，
-* 白白产生本可避免的横滚。这里迭代到不动点：每轮把触底的列钉住，
-* 剩余空间在剩余列间按权重重新分配（FR-25.2）。
-*
-* 容器本身放不下 `columnCount * minWidth` 时无解——此时全部取下限并返回，
-* 由调用方决定横滚（AC-25.4）。
-*/
-function resolveColumnWidths(weights, available, minWidth) {
-	const count = weights.length;
-	if (count === 0) return [];
-	if (available <= count * minWidth) return Array.from({ length: count }, () => minWidth);
-	const result = Array.from({ length: count }, () => 0);
-	const pinned = new Array(count).fill(false);
-	for (let round = 0; round <= count; round += 1) {
-		const freeIndexes = result.map((_, index) => index).filter((index) => !pinned[index]);
-		const remaining = available - result.reduce((sum, value, index) => pinned[index] ? sum + value : sum, 0);
-		const weightTotal = freeIndexes.reduce((sum, index) => sum + (weights[index] ?? 0), 0);
-		let changed = false;
-		for (const index of freeIndexes) {
-			const share = weightTotal > 0 ? remaining * (weights[index] ?? 0) / weightTotal : remaining / freeIndexes.length;
-			if (share < minWidth) {
-				result[index] = minWidth;
-				pinned[index] = true;
-				changed = true;
-			} else result[index] = share;
-		}
-		if (!changed) break;
-	}
-	return result;
-}
-/** 五类场景预设（FR-6.4）。@experimental */
-const UI_PRESETS = [
-	{
-		name: "charts",
-		summary: "One question, one chart, with the takeaway spelled out above it.",
-		guidance: [
-			"Layout: `Card` → `Heading` (the takeaway, not \"Chart\") → `Chart` → optional `Text` for the caveat.",
-			"Pick the chart type from the question: `line` / `area` for time, `bar` for comparison, `pie` for shares.",
-			"Every series needs a name; labels and values must be the same length.",
-			"Never repeat the same numbers in a `Table` right under the chart."
-		].join("\n"),
-		example: {
-			component: "Card",
-			props: { title: "Revenue" },
-			children: [
-				{
-					component: "Heading",
-					props: {
-						level: 3,
-						text: "Revenue grew 27% in Q4"
-					}
-				},
-				{
-					component: "Chart",
-					props: {
-						type: "line",
-						labels: [
-							"Q1",
-							"Q2",
-							"Q3",
-							"Q4"
-						],
-						series: [{
-							name: "Revenue",
-							values: [
-								8,
-								9,
-								9.8,
-								12.4
-							]
-						}]
-					}
-				},
-				{
-					component: "Text",
-					props: {
-						text: "Figures in millions, unaudited.",
-						tone: "muted"
-					}
-				}
-			]
-		}
-	},
-	{
-		name: "cards",
-		summary: "A short list of comparable items, one `Card` each.",
-		guidance: [
-			"Layout: `Grid` (2 or 3 columns) → one `Card` per item.",
-			"Keep every card the same shape: title, one `Metric` or `Text`, at most one `Badge` for status.",
-			"Use `Grid` rather than a vertical `Stack` as soon as there are three or more items.",
-			"Put an action on a card only when the user can act on that single item."
-		].join("\n"),
-		example: {
-			component: "Grid",
-			props: { columns: 2 },
-			children: [{
-				component: "Card",
-				props: { title: "Checkout" },
-				children: [{
-					component: "Metric",
-					props: {
-						label: "Errors",
-						value: 12,
-						trend: "down"
-					}
-				}, {
-					component: "Badge",
-					props: {
-						text: "healthy",
-						tone: "success"
-					}
-				}]
-			}, {
-				component: "Card",
-				props: { title: "Search" },
-				children: [{
-					component: "Metric",
-					props: {
-						label: "Errors",
-						value: 143,
-						trend: "up"
-					}
-				}, {
-					component: "Badge",
-					props: {
-						text: "degraded",
-						tone: "warning"
-					}
-				}]
-			}]
-		}
-	},
-	{
-		name: "dashboards",
-		summary: "Headline numbers first, then detail, optionally split across `Tabs`.",
-		guidance: [
-			"Layout: `Stack` → `Grid` of `Metric` cards → `Chart` or `Table` for the detail.",
-			"Use `Tabs` when the detail splits into independent groups (filters, exports, alerts).",
-			"Each `Tabs` panel and each `Grid` cell is its own form container: at most one `Form` inside.",
-			"Show at most four headline metrics; anything more belongs in a `Table`."
-		].join("\n"),
-		example: {
-			component: "Stack",
-			children: [{
-				component: "Grid",
-				props: { columns: 2 },
-				children: [{
-					component: "Card",
-					props: { title: "MRR" },
-					children: [{
-						component: "Metric",
-						props: {
-							label: "This month",
-							value: "12,400",
-							trend: "up"
-						}
-					}]
-				}, {
-					component: "Card",
-					props: { title: "Churn" },
-					children: [{
-						component: "Metric",
-						props: {
-							label: "This month",
-							value: "2.1%",
-							trend: "down"
-						}
-					}]
-				}]
-			}, {
-				component: "Tabs",
-				props: { labels: ["Trend", "Breakdown"] },
-				children: [{
-					component: "Stack",
-					children: [{
-						component: "Chart",
-						props: {
-							type: "bar",
-							labels: ["Q3", "Q4"],
-							series: [{
-								name: "Revenue",
-								values: [9800, 12400]
-							}]
-						}
-					}]
-				}, {
-					component: "Stack",
-					children: [{
-						component: "Table",
-						props: {
-							columns: ["Region", "Revenue"],
-							rows: [["EMEA", 5400], ["AMER", 7e3]]
-						}
-					}]
-				}]
-			}]
-		}
-	},
-	{
-		name: "slides",
-		summary: "One idea per `Tabs` panel, headline plus at most three supporting lines.",
-		guidance: [
-			"Layout: `Tabs` → one `Stack` per slide, labelled with the slide title.",
-			"Each slide: one `Heading` (level 2) stating the point, then a `Chart`, `Metric` or short `Markdown` list.",
-			"Never put more than one idea on a slide; add a panel instead.",
-			"No `Form` inside slides — a deck is for reading, not for input."
-		].join("\n"),
-		example: {
-			component: "Tabs",
-			props: { labels: ["Where we are", "What we do next"] },
-			children: [{
-				component: "Stack",
-				children: [{
-					component: "Heading",
-					props: {
-						level: 2,
-						text: "Revenue grew 27% in Q4"
-					}
-				}, {
-					component: "Metric",
-					props: {
-						label: "Q4 revenue",
-						value: "12,400",
-						trend: "up"
-					}
-				}]
-			}, {
-				component: "Stack",
-				children: [{
-					component: "Heading",
-					props: {
-						level: 2,
-						text: "Double down on EMEA"
-					}
-				}, {
-					component: "Markdown",
-					props: { text: "- hire two AEs\n- localise pricing" }
-				}]
-			}]
-		}
-	},
-	{
-		name: "reports",
-		summary: "A long-form document: sections, tables and an optional `Timeline`.",
-		guidance: [
-			"Layout: `Stack` → `Heading` (level 2) → body → `Separator` between sections.",
-			"Use `Table` for figures, `Timeline` for what happened when, `Markdown` for prose.",
-			"Open with a one-paragraph summary before any detail.",
-			"Attach generated files with `FileLink` at the end rather than inlining raw data."
-		].join("\n"),
-		example: {
-			component: "Stack",
-			children: [
-				{
-					component: "Heading",
-					props: {
-						level: 2,
-						text: "Q4 incident review"
-					}
-				},
-				{
-					component: "Text",
-					props: { text: "Three incidents, all recovered within the hour." }
-				},
-				{ component: "Separator" },
-				{
-					component: "Timeline",
-					props: { items: [{
-						title: "Search latency spike",
-						time: "12 Nov",
-						state: "done"
-					}, {
-						title: "Checkout timeouts",
-						time: "03 Dec",
-						state: "done"
-					}] }
-				},
-				{
-					component: "FileLink",
-					props: {
-						path: "q4-incidents.csv",
-						label: "Full log",
-						size: 24117
-					}
-				}
-			]
-		}
-	}
-];
-const UI_PRESET_NAMES = UI_PRESETS.map((preset) => preset.name);
-/** Returns undefined for names outside the catalog presets. @experimental */
-function uiPreset(name) {
-	return UI_PRESETS.find((preset) => preset.name === name);
-}
-/**
-* catalog 声明树 → json-render 扁平 spec。纯数据变换，不 import json-render
-* （`@webskill/ui` 保持环境无关）。
-*/
-function toJsonRenderSpec(spec) {
-	const elements = {};
-	let counter = 0;
-	const walk = (node) => {
-		const key = node.id ?? `${node.component.toLowerCase()}-${counter++}`;
-		const children = (node.children ?? []).map(walk);
-		elements[key] = {
-			type: node.component,
-			props: node.props ?? {},
-			...children.length > 0 ? { children } : {}
-		};
-		return key;
-	};
-	return {
-		root: walk(spec),
-		elements
-	};
-}
-/** ControlModel 的控件词汇 → catalog `Field.type`（catalog 的 9 种是超集） */
-const FIELD_TYPE = {
-	text: "text",
-	number: "number",
-	boolean: "toggle",
-	select: "select",
-	textarea: "textarea",
-	file: "file",
-	password: "password",
-	date: "date"
-};
-function toOptions(options) {
-	return (options ?? []).map((option) => ({
-		label: option.label,
-		value: typeof option.value === "number" ? option.value : String(option.value)
-	}));
-}
-function toField(control) {
-	return {
-		component: "Field",
-		props: {
-			name: control.name,
-			label: control.label,
-			type: FIELD_TYPE[control.control],
-			...control.required ? { required: true } : {},
-			...control.description ? { description: control.description } : {},
-			...control.defaultValue !== void 0 ? { defaultValue: control.defaultValue } : {},
-			...control.suggestion ? { suggestion: control.suggestion } : {},
-			...control.accept ? { accept: [...control.accept] } : {},
-			...control.multiple ? { multiple: true } : {},
-			...control.options ? { options: toOptions(control.options) } : {}
-		}
-	};
-}
-/**
-* 五类 `InteractionRequest` → catalog 声明树。
-*
-* 路径 A（runtime 发起的交互请求）与路径 B（模型产出的 surface）的差别只在「谁产出这棵树」；
-* 产出之后四档走的是同一条 spec 渲染路径，因此这份生成器全仓只写一份。
-*/
-function interactionToUiSpec(request, labels = {}) {
-	const model = interactionToFormModel(request);
-	const title = labels.title ?? model.title;
-	const cancelLabel = labels.cancelLabel ?? model.cancelLabel;
-	const form = {
-		component: "Form",
-		props: {
-			...title ? { title } : {},
-			submitLabel: labels.submitLabel ?? model.submitLabel,
-			...cancelLabel ? { cancelLabel } : {}
-		},
-		children: model.controls.map(toField)
-	};
-	if (model.controls.length > 0 || !model.message) return form;
-	return {
-		component: "Stack",
-		children: [{
-			component: "Text",
-			props: { text: model.message }
-		}, form]
-	};
-}
-const RENDER_UI_TOOL = "render_ui";
-const DESCRIBE_UI_PRESET_TOOL = "describe_ui_preset";
-const defaultId = () => `ui-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-/**
-* 工具描述只留一句指针：catalog 本体走 system 消息（C4）。
-* 工具 `description` 的长度上限与截断在各 provider 上不一致且是静默的，
-* 近 5000 字符的 catalog 放在那里，被截断时模型拿到的是半份规格而请求照样成功。
-*/
-const RENDER_UI_DESCRIPTION = [
-	"Render a UI for the answer instead of prose.",
-	"Use it for forms, tables, charts, metrics or file downloads.",
-	"The component catalog is in the system prompt."
-].join(" ");
-const INTENTS = /* @__PURE__ */ new Set([
-	"submit",
-	"cancel",
-	"select",
-	"download",
-	"refresh"
-]);
-/** 去重靠指纹兜底，但重复调用本身也浪费一轮，所以先在提示词里劝阻（FR-21.5） */
-const NO_DUPLICATE_RENDER = "If a skill has already rendered a surface for this request, do not call render_ui again with the same content.";
-function isIntent(value) {
-	return typeof value === "string" && INTENTS.has(value);
-}
-/**
-* 从节点树抽出 action 能力表。能力表走事件外壳而非树内：
-* 树是模型可写的，nonce 放进去就等于让模型自己签发能力。
-* action id 取节点 id；Button 未声明 id 时退回 intent 名（同 intent 只留一条）。
-* 表单的提交/取消取自作用域表：容器级放宽后一张 surface 可能有多个表单。
-*/
-function collectActions(node, out, scopes) {
-	if (node.component === "Button" && isIntent(node.props?.["action"])) {
-		const intent = node.props["action"];
-		const id = node.id ?? intent;
-		if (!out.has(id)) out.set(id, {
-			id,
-			intent,
-			...intent === "submit" ? { awaitResponse: true } : {}
-		});
-	}
-	const scope = scopes.get(node);
-	if (scope) {
-		if (!out.has(scope.submitActionId)) out.set(scope.submitActionId, {
-			id: scope.submitActionId,
-			intent: "submit",
-			awaitResponse: true
-		});
-		if (typeof node.props?.["cancelLabel"] === "string" && !out.has(scope.cancelActionId)) out.set(scope.cancelActionId, {
-			id: scope.cancelActionId,
-			intent: "cancel"
-		});
-	}
-	for (const child of node.children ?? []) collectActions(child, out, scopes);
-}
-/** 节点树声明的 action 能力表（renderer 据此生成按钮，runtime 据此签发 nonce）。@experimental */
-function collectSpecActions(spec) {
-	const actions = /* @__PURE__ */ new Map();
-	collectActions(spec, actions, new Map(collectFormScopes(spec).map((scope) => [scope.form, scope])));
-	return [...actions.values()];
-}
-/**
-* 把 catalog 变成一个工具的入参 Schema，让模型直接生成声明式 UI（21 号文档 §3）：
-* agentLoop / UiBridge / extractUiSpecEvents 全部零改动，装配处只多一个 externalTools 条目。
-*/
-function createUiCatalogToolSource(options = {}) {
-	const catalog = options.catalog ?? uiCatalog;
-	const newSurfaceId = options.newSurfaceId ?? defaultId;
-	const presets = options.presets ? options.presets.flatMap((name) => uiPreset(name) ?? []) : UI_PRESETS;
-	const presetChoices = presets.map((preset) => `${preset.name} — ${preset.summary}`).join("\n");
-	const presetTool = () => ({
-		name: DESCRIBE_UI_PRESET_TOOL,
-		description: `Fetch the layout guidance for one scenario preset before calling ${RENDER_UI_TOOL}.\n${presetChoices}`,
-		inputSchema: {
-			type: "object",
-			properties: { preset: {
-				type: "string",
-				enum: presets.map((preset) => preset.name)
-			} },
-			required: ["preset"],
-			additionalProperties: false
-		}
-	});
-	const renderTool = () => ({
-		name: RENDER_UI_TOOL,
-		description: RENDER_UI_DESCRIPTION,
-		inputSchema: {
-			type: "object",
-			properties: {
-				spec: catalog.toJsonSchema(),
-				...presets.length > 0 ? { preset: {
-					type: "string",
-					enum: presets.map((preset) => preset.name),
-					description: `Scenario preset this surface follows; call ${DESCRIBE_UI_PRESET_TOOL} first for its layout guidance.`
-				} } : {}
-			},
-			required: ["spec"],
-			additionalProperties: false
-		}
-	});
-	return {
-		kind: "ui-catalog",
-		systemPrompt: () => Promise.resolve(`${catalog.toPrompt()}\n\n${NO_DUPLICATE_RENDER}`),
-		listToolSpecs: () => Promise.resolve(presets.length > 0 ? [renderTool(), presetTool()] : [renderTool()]),
-		canHandle: (name) => name === "render_ui" || presets.length > 0 && name === "describe_ui_preset",
-		argCaptureTrust: (name) => name === "render_ui" || name === "describe_ui_preset" ? { tier: "reviewed" } : void 0,
-		call: (name, args) => {
-			if (name === "describe_ui_preset") {
-				const requested = args["preset"];
-				const preset = presets.find((candidate) => candidate.name === requested);
-				if (!preset) return Promise.resolve({
-					ok: false,
-					content: [],
-					error: {
-						code: "VALIDATION_FAILED",
-						message: `Unknown UI preset "${String(requested)}"; available presets: ${presets.map((candidate) => candidate.name).join(", ")}`
-					}
-				});
-				return Promise.resolve({
-					ok: true,
-					content: [{
-						type: "text",
-						text: `${preset.guidance}\n\nExample spec:\n${JSON.stringify(preset.example)}`
-					}]
-				});
-			}
-			const spec = args["spec"];
-			const result = catalog.validate(spec);
-			if (!result.ok) return Promise.resolve({
-				ok: false,
-				content: [],
-				error: {
-					code: "UI_SPEC_INVALID",
-					message: `The UI spec does not match the catalog: ${result.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ")}`
-				}
-			});
-			const node = spec;
-			const surfaceId = newSurfaceId();
-			const actions = collectSpecActions(node);
-			return Promise.resolve({
-				ok: true,
-				content: [{
-					type: "json",
-					data: { $surface: {
-						type: "open",
-						id: surfaceId,
-						node,
-						...actions.length > 0 ? { actions } : {}
-					} }
-				}, {
-					type: "text",
-					text: `Rendered surface ${surfaceId}.`
-				}]
-			});
-		}
-	};
-}
-const VERCEL_INTERACTION_TOOL_NAME = "webskill_interaction";
-/** InteractionRequest → SDK tool UI 结构（应用聊天 UI 直接消费） */
-function toVercelToolInvocation(request) {
-	return {
-		type: "tool-call",
-		toolCallId: request.id,
-		toolName: VERCEL_INTERACTION_TOOL_NAME,
-		input: request
-	};
-}
-/** SDK 回传（tool result / output）→ InteractionResponse */
-function fromVercelToolResult(part) {
-	const p = part ?? {};
-	const id = String(p["toolCallId"] ?? p["id"] ?? "");
-	if (p["cancelled"] === true) return {
-		id,
-		cancelled: true
-	};
-	return {
-		id,
-		value: p["output"] ?? p["result"] ?? p["value"]
-	};
-}
-/**
-* 薄桥接类：request → SDK tool UI 结构 → 应用的聊天 UI（sendInteraction 回调实现）
-* → SDK 回传 → InteractionResponse。
-*/
-var VercelUiBridge = class {
-	#sendInteraction;
-	constructor(deps) {
-		this.#sendInteraction = deps.sendInteraction;
-	}
-	async request(input) {
-		return fromVercelToolResult(await this.#sendInteraction(toVercelToolInvocation(input)));
-	}
-};
-const literal = (value) => JSON.stringify(value ?? null);
-/** 组件的位置参数顺序 = catalog props 的 schema key 顺序（OpenUI 的 param map 同源） */
-function propOrder(catalog) {
-	const branches = catalog.toJsonSchema()["oneOf"] ?? [];
-	const order = /* @__PURE__ */ new Map();
-	for (const branch of branches) {
-		const name = (branch.properties?.["component"])?.["const"];
-		const props = branch.properties?.["props"];
-		if (typeof name === "string") order.set(name, Object.keys(props?.properties ?? {}));
-	}
-	return order;
-}
-/**
-* catalog 声明树 → openui-lang 文本。语法为每行一条 `id = Component(位置参数…)`，
-* `root = …` 为入口；容器组件的子节点作为最后一个参数传 id 数组。
-*/
-function toOpenUiSpecLang(spec, catalog = uiCatalog) {
-	const order = propOrder(catalog);
-	const lines = [];
-	let counter = 0;
-	const walk = (node) => {
-		const id = node.id ?? `n${counter++}`;
-		const childIds = (node.children ?? []).map(walk);
-		const def = catalog.component(node.component);
-		const args = (order.get(node.component) ?? []).map((key) => literal(node.props?.[key]));
-		if (def?.children !== void 0) args.push(`[${childIds.join(", ")}]`);
-		lines.push(`${id} = ${node.component}(${args.join(", ")})`);
-		return id;
-	};
-	const rootId = walk(spec);
-	return [...lines.filter((line) => !line.startsWith(`${rootId} =`)), `root = ${lines.find((line) => line.startsWith(`${rootId} =`)).slice(rootId.length + 3)}`].join("\n");
-}
-const WEBSKILL_SURFACE_ACTION = "webskill:surface-action";
-function toUiSurfaceActionDispatch(snapshot, action, value, scopeId) {
-	return {
-		...snapshot.runId ? { runId: snapshot.runId } : {},
-		surfaceId: snapshot.id,
-		actionId: action.id,
-		intent: action.intent,
-		...action.nonce ? { nonce: action.nonce } : {},
-		...scopeId ? { scopeId } : {},
-		...value ? { value } : {}
-	};
-}
-/** Returns undefined for malformed or non-WebSkill renderer events. @experimental */
-function fromUiSurfaceActionDispatch(value) {
-	if (typeof value !== "object" || value === null) return void 0;
-	const event = value;
-	if (typeof event["surfaceId"] !== "string" || typeof event["actionId"] !== "string" || !isSurfaceActionIntent(event["intent"])) return;
-	return {
-		...typeof event["runId"] === "string" ? { runId: event["runId"] } : {},
-		surfaceId: event["surfaceId"],
-		actionId: event["actionId"],
-		intent: event["intent"],
-		...typeof event["nonce"] === "string" ? { nonce: event["nonce"] } : {},
-		...typeof event["scopeId"] === "string" ? { scopeId: event["scopeId"] } : {},
-		...isRecord(event["value"]) ? { value: event["value"] } : {},
-		...event["cancelled"] === true ? { cancelled: true } : {}
-	};
-}
-function isSurfaceActionIntent(value) {
-	return value === "submit" || value === "cancel" || value === "select" || value === "download" || value === "refresh";
-}
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
-* A2UI 协议常量与 surface 动作编解码（v0.9.1）。
-* 依据 https://a2ui.org/specification/v0.9-a2ui/：
-* - 信封 {version, createSurface|updateComponents|updateDataModel|deleteSurface}
-* - 组件为扁平邻接表（id 引用），root 必需
-* - 输入组件与数据模型经 JSON Pointer 双向绑定；action.context 回传
-*
-* 声明树 → A2UI 消息的转换在 `specToA2ui.ts`（四档共用的单一渲染路径）。
-*/
-const A2UI_VERSION = "v0.9.1";
-const A2UI_BASIC_CATALOG_ID = "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json";
-const A2UI_SURFACE_ACTION = WEBSKILL_SURFACE_ACTION;
-/** Decodes a nonce-bound action emitted by a WebSkill A2UI extension host. @experimental */
-function fromA2uiSurfaceAction(event) {
-	const action = event;
-	if (action?.name !== "webskill:surface-action") return void 0;
-	return fromUiSurfaceActionDispatch(action.context);
-}
-/** Builds the A2UI event payload an extension host sends after a user action. @experimental */
-function toA2uiSurfaceAction(snapshot, action, value, scopeId) {
-	return {
-		name: A2UI_SURFACE_ACTION,
-		context: toUiSurfaceActionDispatch(snapshot, action, value, scopeId)
-	};
-}
-/** 声明树里按钮触发的事件名（宿主据 context.actionId 回传 surface action） */
-const A2UI_SPEC_ACTION = "webskill:spec-action";
-/** 表单值在 A2UI 数据模型里的根路径 */
-const A2UI_SPEC_FORM_PATH = "/form";
-/**
-* catalog 声明树 → A2UI 消息序列。
-*
-* 协议要求组件是扁平邻接表且根节点 id 为 `root`，因此这里做树 → 邻接表的展开。
-* 三处改写全部由 `a2uiComponentShapes` 决定，本函数不认识任何具体组件名：
-* - 子节点变成 props.children 里的 id 引用
-* - 表单控件的值经 JSON Pointer 与数据模型双向绑定
-* - 自带提交/取消标签的组件（A2UI 没有表单提交事件）把按钮物化成 Button 子节点，
-*   与 `toA2uiMessages` 对交互请求的处理同一手法
-*/
-function toA2uiSpecMessages(catalog, spec, options) {
-	const shapes = new Map(a2uiComponentShapes(catalog).map((shape) => [shape.name, shape]));
-	const components = [];
-	const defaults = {};
-	let counter = 0;
-	const event = (actionId) => ({ event: {
-		name: A2UI_SPEC_ACTION,
-		context: {
-			...options.context,
-			actionId
-		}
-	} });
-	const button = (id, text, actionId) => {
-		components.push({
-			id,
-			component: "Button",
-			label: text,
-			action: event(actionId)
-		});
-		return id;
-	};
-	const walk = (node, id) => {
-		const props = { ...node.props };
-		const shape = shapes.get(node.component);
-		const children = (node.children ?? []).map((child) => walk(child, child.id ?? `n${counter++}`));
-		for (const key of shape?.valueProps ?? []) {
-			const name = typeof props["name"] === "string" ? props["name"] : id;
-			if (props["defaultValue"] !== void 0) defaults[name] = props["defaultValue"];
-			props[key] = { path: `${A2UI_SPEC_FORM_PATH}/${name}` };
-		}
-		for (const key of shape?.actionProps ?? []) props[key] = event(typeof props[key] === "string" ? props[key] : "select");
-		if (shape?.submitLabelProp) {
-			const text = props[shape.submitLabelProp];
-			children.push(button(`${id}-submit`, typeof text === "string" ? text : "Submit", "submit"));
-		}
-		if (shape?.cancelLabelProp && typeof props[shape.cancelLabelProp] === "string") children.push(button(`${id}-cancel`, props[shape.cancelLabelProp], "cancel"));
-		if (children.length > 0) props[A2UI_CHILDREN_PROP] = children;
-		components.push({
-			...props,
-			id,
-			component: node.component
-		});
-		return id;
-	};
-	walk(spec, "root");
-	const messages = [{
-		version: A2UI_VERSION,
-		createSurface: {
-			surfaceId: options.surfaceId,
-			catalogId: options.catalogId ?? "https://webskill.dev/a2ui/catalogs/v1/catalog.json",
-			sendDataModel: true
-		}
-	}, {
-		version: A2UI_VERSION,
-		updateComponents: {
-			surfaceId: options.surfaceId,
-			components
-		}
-	}];
-	if (Object.keys(defaults).length > 0) messages.push({
-		version: A2UI_VERSION,
-		updateDataModel: {
-			surfaceId: options.surfaceId,
-			path: A2UI_SPEC_FORM_PATH,
-			value: defaults
-		}
-	});
-	return messages;
-}
-/** A2UI action 事件 → 声明树 action（非本 catalog 的事件返回 undefined） */
-function fromA2uiSpecAction(event) {
-	const action = event;
-	if (action?.name !== "webskill:spec-action") return void 0;
-	const context = action.context ?? {};
-	const actionId = context["actionId"];
-	if (typeof actionId !== "string") return void 0;
-	return {
-		actionId,
-		context
-	};
-}
-/**
-* BYOC Lit 元素的加载入口。
-*
-* 元素模块静态依赖 `lit` 与 `@a2ui/*`（三者都是 optional peer），
-* 因此只能经动态 import 进来：未用 A2UI 档的应用不为这段体积买单，
-* 缺依赖时给出带安装提示的 `UI_UNAVAILABLE`，而不是一个空白 surface。
-*/
-async function loadWebSkillLitCatalog() {
-	try {
-		const { webskillLitCatalog } = await import("./webskillLitCatalog-D_zCqeQF-swXsWoAe.js");
-		return webskillLitCatalog();
-	} catch (cause) {
-		throw new WebSkillError("UI_UNAVAILABLE", "The WebSkill A2UI catalog is unavailable; install @a2ui/lit, @a2ui/web_core and lit to render catalog surfaces with A2UI", cause);
-	}
-}
-/**
-* Loads the optional OpenUI peers (@openuidev/react-lang and zod) for the OpenUI
-* interaction/surface paths. Throws a WebSkillError with code UI_UNAVAILABLE and an
-* install hint when either peer is missing, so callers can fall back to native
-* rendering instead of leaving a blank surface.
-*/
-async function loadOpenUiPeers() {
-	try {
-		const [openuiModule, zodModule] = await Promise.all([import("./dist-DxyxmXPU-DGC-dpXf.js"), import("zod")]);
-		return {
-			openui: openuiModule,
-			z: zodModule.z
-		};
-	} catch (cause) {
-		throw new WebSkillError("UI_UNAVAILABLE", "The OpenUI renderer is unavailable; install @openuidev/react-lang and zod to render surfaces and interactions with the OpenUI track", cause);
-	}
-}
-
-//#endregion
-export { uiPreset as $, ensureStyles as A, mountViewerComponents as B, applySuggestion as C, resolveSurfaceFormTexts as Ct, collectSpecActions as D, uiCatalog as Dt, collectScopedValues as E, toEchartsOption as Et, fromVercelToolResult as F, renderRenderResult as G, qualifyFieldName as H, gaugePercent as I, toA2uiSurfaceAction as J, resolveColumnWidths as K, interactionToUiSpec as L, fromA2uiSpecAction as M, fromA2uiSurfaceAction as N, collectValues as O, fromUiSurfaceActionDispatch as P, toVercelToolInvocation as Q, loadOpenUiPeers as R, WebFormBridge as S, resolveInteractionTexts as St, collectFormScopes as T, shapeInteractionValue as Tt, renderBlocks as U, normalizeColumnWidths as V, renderMiniChart as W, toOpenUiSpecLang as X, toJsonRenderSpec as Y, toUiSurfaceActionDispatch as Z, VIEWER_FALLBACK_ATTR as _, defineUiCatalog as _t, A2UI_VERSION as a, DEFAULT_CHART_FONT_SIZES as at, WEBSKILL_STYLES_CSS as b, renderMiniMarkdown as bt, DOCUMENT_COMPONENTS as c, DEFAULT_SURFACE_HOST_CONTROL_TEXTS as ct, SPEC_TABLE_MIN_COLUMN_VAR as d, UI_CATALOG_PROMPT_BUDGET_BYTES as dt, A2UI_CHILDREN_PROP as et, SPEC_TABLE_MIN_COLUMN_WIDTH as f, WEBSKILL_A2UI_CATALOG_ID as ft, VIEWER_COMPONENT_ATTR as g, chartSpecFromProps as gt, VERCEL_INTERACTION_TOOL_NAME as h, buildA2uiCatalogDefinition as ht, A2UI_SURFACE_ACTION as i, CATALOG_SCHEMA_MAX as it, evaluateFieldCondition as j, createUiCatalogToolSource as k, MAX_CONDITION_DEPTH as l, PLANNED_INCREMENT as lt, UI_PRESET_NAMES as m, a2uiComponentShapes as mt, A2UI_SPEC_ACTION as n, CATALOG_BUDGET_STAGE as nt, CHART_PALETTE as o, DEFAULT_INTERACTION_TEXTS as ot, UI_PRESETS as p, a2uiComponentSchema as pt, toA2uiSpecMessages as q, A2UI_SPEC_FORM_PATH as r, CATALOG_PROMPT_MAX as rt, DESCRIBE_UI_PRESET_TOOL as s, DEFAULT_SURFACE_FORM_TEXTS as st, A2UI_BASIC_CATALOG_ID as t, A2UI_COMMON_TYPES as tt, RENDER_UI_TOOL as u, UI_CATALOG_GROUPS as ut, VIEWER_PROPS_ATTR as v, interactionToFormModel as vt, chartToTable as w, resolveSurfaceHostControlTexts as wt, WEBSKILL_SURFACE_ACTION as x, resolveChartFontSizes as xt, VercelUiBridge as y, mountEchart as yt, loadWebSkillLitCatalog as z };