@webskill/sdk 0.11.0 → 0.13.0

package/dist/{dist-DTHZS2k1.js → dist-DqcL6jKO.js}

@@ -1,7 +1,7 @@
 import { h as WebSkillError } from "./dist-Bev6i6Ip.js";
 import { toJSONSchema, z } from "zod";
 
-//#region ../ui/dist/webskillCatalog-DrmnCbsR.js
+//#region ../ui/dist/webskillCatalog-nTgkL9Xe.js
 const DEFAULT_INTERACTION_TEXTS = {
 	submit: "Submit",
 	cancel: "Cancel",
@@ -39,6 +39,19 @@ function resolveSurfaceFormTexts(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) {
@@ -216,23 +229,27 @@ function renderMiniMarkdown(text, doc) {
 	}
 	return root;
 }
+/** 与 catalog `Chart` 的 props 枚举逐字一致（`ui/catalog/uiCatalog.ts`） */
 const KINDS = /* @__PURE__ */ new Set([
 	"bar",
 	"line",
-	"pie"
+	"area",
+	"pie",
+	"scatter",
+	"stacked-bar",
+	"dual-axis"
 ]);
 const list = (value) => Array.isArray(value) ? value : [];
 /**
 * catalog `Chart` 节点 props → `ChartSpec`。四档共用这一份转换：
 * 此前 native / OpenUI / json-render / A2UI 各抄了一遍，改一处就会漂移。
-* catalog 的 `area` 在 `ChartSpec` 里没有对应枚举，按折线渲染——
-* 原先的裸 cast 会把非法枚举一路带进渲染器，画出空图。
+* 非法枚举**原样保留**，由 `toEchartsOption` 给出可见降级提示——
+* 此前偷偷改写成 `'line'`，画出的图与模型的意图无关且不可察觉。
 */
 function chartSpecFromProps(props) {
-	const type = typeof props["type"] === "string" ? props["type"] : "bar";
 	const series = list(props["series"]);
 	return {
-		kind: KINDS.has(type) ? type : "line",
+		kind: typeof props["type"] === "string" ? props["type"] : "",
 		labels: list(props["labels"]),
 		series: series.map((item) => ({
 			...typeof item.name === "string" ? { name: item.name } : {},
@@ -242,24 +259,70 @@ function chartSpecFromProps(props) {
 	};
 }
 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) {
+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 ? {
-			text: chart.title,
+		title: chart.title || notice ? {
+			text: chart.title ?? "",
 			left: "center",
-			textStyle: { fontSize: 14 }
+			textStyle: { fontSize: font.title },
+			...notice ? { subtext: notice } : {}
 		} : void 0,
 		tooltip: { trigger: chart.kind === "pie" ? "item" : "axis" },
-		legend: { bottom: 0 },
+		legend: {
+			bottom: 0,
+			textStyle: { fontSize: font.legend }
+		},
 		xAxis: chart.kind === "pie" ? void 0 : {
 			type: "category",
-			data: chart.labels
+			data: chart.labels,
+			axisLabel: { fontSize: font.axisLabel }
 		},
-		yAxis: chart.kind === "pie" ? void 0 : { type: "value" },
+		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,
@@ -267,10 +330,11 @@ function toEchartsOption(chart) {
 				name: label,
 				value: series.data[index] ?? 0
 			}))
-		})) : chart.series.map((series) => ({
-			type: chart.kind,
+		})) : chart.series.map((series, index) => ({
+			...shape,
 			name: series.name,
-			data: series.data
+			data: series.data,
+			...chart.kind === "dual-axis" ? { yAxisIndex: index === 0 ? 0 : 1 } : {}
 		}))
 	};
 }
@@ -286,6 +350,12 @@ function applyChartDomContract(container, chart) {
 	else container.removeAttribute("aria-label");
 }
 /**
+* 一篇文档常同时挂载多张图表；共用同一个模块 promise，
+* 避免每个挂载点各自发起一次动态 import。
+*/
+let echartsModule;
+const loadEcharts = () => echartsModule ??= import("./echarts-De78wXqV.js");
+/**
 * 框架无关的 echarts 挂载点：三档的 React 组件与 A2UI 档的 Lit 元素共用同一实现，
 * 图表不再因档位而异。echarts 走动态 import，不打进首屏。
 */
@@ -294,26 +364,29 @@ function mountEchart(container) {
 	let instance;
 	let queued;
 	let observer;
-	const apply = (chart) => {
-		instance?.setOption(toEchartsOption(chart), {
+	const apply = (chart, fontSizes) => {
+		instance?.setOption(toEchartsOption(chart, fontSizes), {
 			notMerge: true,
 			lazyUpdate: true
 		});
 	};
-	import("./echarts-DhNm2ene.js").then((echarts) => {
+	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);
+		if (queued) apply(queued.chart, queued.fontSizes);
 	});
 	return {
-		setChart(chart) {
+		setChart(chart, fontSizes) {
 			applyChartDomContract(container, chart);
-			queued = chart;
-			apply(chart);
+			queued = {
+				chart,
+				...fontSizes ? { fontSizes } : {}
+			};
+			apply(chart, fontSizes);
 		},
 		dispose() {
 			disposed = true;
@@ -537,8 +610,8 @@ function sanitizeUiSpec(catalog, byName, spec) {
 		degradations
 	};
 }
-function componentSchema(def) {
-	const props = toJSONSchema(def.props, { io: "input" });
+function componentSchema(def, rootDefs) {
+	const props = liftDefs(toJSONSchema(def.props, { io: "input" }), def.name, rootDefs);
 	const node = {
 		type: "object",
 		description: def.description,
@@ -568,6 +641,37 @@ function componentSchema(def) {
 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"]);
@@ -692,13 +796,18 @@ function defineUiCatalog(input) {
 		componentNames: input.components.map((def) => def.name),
 		actionNames: input.actions.map((action) => action.name),
 		component: (name) => byName.get(name),
-		toJsonSchema: () => ({
-			$schema: "https://json-schema.org/draft/2020-12/schema",
-			$id: input.id,
-			title: input.title,
-			description: input.instructions,
-			oneOf: input.components.map(componentSchema)
-		}),
+		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 = [];
@@ -1899,7 +2008,8 @@ function renderPie(chart, svg, doc) {
 	});
 }
 /**
-* ChartSpec → SVG（bar 等宽柱 + 值标签；line 折线 + 点；pie 扇形 + 图例；空数据容错）
+* ChartSpec → SVG（bar 等宽柱 + 值标签；line 折线 + 点；pie 扇形 + 图例；空数据容错）。
+* mini 档只有这三种画法，其余类型走最接近的一种并在图内注明是近似呈现。
 * @stable
 */
 function renderMiniChart(chart, doc) {
@@ -1918,6 +2028,7 @@ function renderMiniChart(chart, doc) {
 	}));
 	switch (chart.kind) {
 		case "bar":
+		case "stacked-bar":
 			renderBar(chart, svg, doc);
 			break;
 		case "line":
@@ -1926,7 +2037,11 @@ function renderMiniChart(chart, doc) {
 		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 各为一列） */
@@ -2057,7 +2172,7 @@ const WHITELIST = new Set(DOCUMENT_COMPONENTS);
 *
 * 逐个占位独立处理：一个坏占位只降级它自己，不会让整篇文档变空白。
 */
-function mountViewerComponents(root) {
+function mountViewerComponents(root, options) {
 	const handles = [];
 	for (const node of Array.from(root.querySelectorAll(`[${VIEWER_COMPONENT_ATTR}]`))) {
 		const element = node;
@@ -2068,7 +2183,7 @@ function mountViewerComponents(root) {
 		}
 		const props = readProps(element, name);
 		if (!props) continue;
-		const handle = render(element, name, props);
+		const handle = render(element, name, props, options?.fontSizes);
 		if (handle) handles.push(handle);
 	}
 	return { dispose: () => {
@@ -2102,13 +2217,13 @@ function readProps(element, name) {
 	}
 	return result.data;
 }
-function render(element, name, props) {
+function render(element, name, props, fontSizes) {
 	const doc = element.ownerDocument;
 	element.replaceChildren();
 	switch (name) {
 		case "Chart": {
 			const handle = mountEchart(element);
-			handle.setChart(chartSpecFromProps(props));
+			handle.setChart(chartSpecFromProps(props), fontSizes);
 			return handle;
 		}
 		case "Table":
@@ -3083,6 +3198,7 @@ function createUiCatalogToolSource(options = {}) {
 		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"];
@@ -3365,7 +3481,7 @@ function fromA2uiSpecAction(event) {
 */
 async function loadWebSkillLitCatalog() {
 	try {
-		const { webskillLitCatalog } = await import("./webskillLitCatalog-DME6PBkV-CmYNLlIT.js");
+		const { webskillLitCatalog } = await import("./webskillLitCatalog-D_zCqeQF-C9lrvvMr.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);
@@ -3390,4 +3506,4 @@ async function loadOpenUiPeers() {
 }
 
 //#endregion
-export { uiPreset as $, ensureStyles as A, mountViewerComponents as B, applySuggestion as C, collectSpecActions as D, collectScopedValues as E, 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, uiCatalog as St, collectFormScopes as T, renderBlocks as U, normalizeColumnWidths as V, renderMiniChart as W, toOpenUiSpecLang as X, toJsonRenderSpec as Y, toUiSurfaceActionDispatch as Z, VIEWER_FALLBACK_ATTR as _, mountEchart as _t, A2UI_VERSION as a, DEFAULT_INTERACTION_TEXTS as at, WEBSKILL_STYLES_CSS as b, resolveSurfaceFormTexts as bt, DOCUMENT_COMPONENTS as c, UI_CATALOG_GROUPS as ct, SPEC_TABLE_MIN_COLUMN_VAR as d, a2uiComponentSchema as dt, A2UI_CHILDREN_PROP as et, SPEC_TABLE_MIN_COLUMN_WIDTH as f, a2uiComponentShapes as ft, VIEWER_COMPONENT_ATTR as g, interactionToFormModel as gt, VERCEL_INTERACTION_TOOL_NAME as h, defineUiCatalog as ht, A2UI_SURFACE_ACTION as i, CATALOG_SCHEMA_MAX as it, evaluateFieldCondition as j, createUiCatalogToolSource as k, MAX_CONDITION_DEPTH as l, UI_CATALOG_PROMPT_BUDGET_BYTES as lt, UI_PRESET_NAMES as m, chartSpecFromProps as mt, A2UI_SPEC_ACTION as n, CATALOG_BUDGET_STAGE as nt, CHART_PALETTE as o, DEFAULT_SURFACE_FORM_TEXTS as ot, UI_PRESETS as p, buildA2uiCatalogDefinition as pt, toA2uiSpecMessages as q, A2UI_SPEC_FORM_PATH as r, CATALOG_PROMPT_MAX as rt, DESCRIBE_UI_PRESET_TOOL as s, PLANNED_INCREMENT as st, A2UI_BASIC_CATALOG_ID as t, A2UI_COMMON_TYPES as tt, RENDER_UI_TOOL as u, WEBSKILL_A2UI_CATALOG_ID as ut, VIEWER_PROPS_ATTR as v, renderMiniMarkdown as vt, chartToTable as w, WEBSKILL_SURFACE_ACTION as x, shapeInteractionValue as xt, VercelUiBridge as y, resolveInteractionTexts as yt, loadWebSkillLitCatalog as z };
+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 };