@webskill/sdk 0.7.0 → 0.8.0

package/dist/ui-react.js

@@ -1,8 +1,8 @@
 import { r as __exportAll$1 } from "./rolldown-runtime-BOF7iYI8.js";
-import { m as WebSkillError } from "./dist-8oQRa8Xz.js";
-import { Et as validateUiSpecNode, Tt as validateUiSpecEvent } from "./dist-D0qW6e40.js";
-import { B as toOpenUiSpecLang, I as shapeInteractionValue, O as interactionToFormModel, P as renderMiniChart, Q as chartSpecFromProps, g as applySuggestion, k as interactionToUiSpec, nt as uiCatalog, tt as renderMiniMarkdown, x as collectValues, z as toJsonRenderSpec } from "./dist-DnYG2-eY.js";
-import { C as Markdown, S as Input, _ as DataTable, a as SpecProgress, b as DropdownMenuContent, c as SurfaceButton, d as catalogComponentImpls, f as str, g as Button, h as Badge, i as SpecGrid, l as SurfaceField, m as useSurfaceForm, n as CatalogSurfaceProvider, o as SpecTabs, p as useCatalogSurfaceForm, r as EChart, s as SpecTimeline, u as SurfaceFormButtons, v as DropdownMenu, w as Separator, x as DropdownMenuTrigger, y as DropdownMenuCheckboxItem } from "./catalogComponents-Dr5dFMAb-DKH_7VPI.js";
+import { m as WebSkillError } from "./dist-59XlqDuv.js";
+import { Ot as validateUiSpecEvent, kt as validateUiSpecNode } from "./dist-DmI5SBBF.js";
+import { F as normalizeColumnWidths, M as interactionToUiSpec, R as renderMiniChart, U as toJsonRenderSpec, W as toOpenUiSpecLang, Z as DEFAULT_SURFACE_FORM_TEXTS, ct as renderMiniMarkdown, dt as shapeInteractionValue, ft as uiCatalog, it as chartSpecFromProps, ot as interactionToFormModel, w as collectValues, y as applySuggestion } from "./dist-CJqQsIm9.js";
+import { C as DropdownMenuContent, D as Separator, E as Markdown, S as DropdownMenuCheckboxItem, T as Input, _ as useSurfaceFormTexts, a as SpecProgress, b as DataTable, c as SurfaceButton, d as SurfaceFormButtons, f as SurfaceFormTextsProvider, g as useSurfaceForm, h as useCatalogSurfaceForm, i as SpecGrid, l as SurfaceField, m as str, n as CatalogSurfaceProvider, o as SpecTabs, p as catalogComponentImpls, r as EChart, s as SpecTimeline, u as SurfaceFieldArray, v as Badge, w as DropdownMenuTrigger, x as DropdownMenu, y as Button } from "./catalogComponents-DfxxfUvn-D55Gbb2l.js";
 import { z } from "zod";
 import * as React$1 from "react";
 import React, { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
@@ -6819,7 +6819,7 @@ function InteractionForm({ bridge }) {
 						id: `webskill-error-${control.name}`,
 						role: "alert",
 						className: "webskill-form__error",
-						children: "This field is required"
+						children: DEFAULT_SURFACE_FORM_TEXTS.required
 					}) : null
 				]
 			}, control.name)),
@@ -6912,15 +6912,63 @@ function StreamingText({ bridge }) {
 	});
 }
 /**
+* 渲染前的逐节点降级（FR-23.3）。
+*
+* 三档过去都是「整树 validate，失败即整块换成一行红字」——一个节点的一个 prop 不合法
+* 就让整个 surface 消失。到了渲染层这份 spec 可能来自快照重放或更早的语法版本，
+* 此刻整块拒绝而 run 还在等它的响应，正是 AC-G11 要防的「整块消失」。
+*/
+function useSanitizedSpec(spec) {
+	return useMemo(() => uiCatalog.sanitize(spec), [spec]);
+}
+const isOutOfCatalog = (degradation) => degradation.kind === "unknown-component";
+/**
+* 越界组件名的响亮拒绝。
+*
+* 它是**对 spec 本身**的判定，与渲染器装没装无关，所以要渲染在可选依赖的门禁之前——
+* 放到门禁后面，未安装该档时这条越界信号就消失了。
+*/
+function SurfaceRejectionAlert({ degradations }) {
+	const rejected = degradations.filter(isOutOfCatalog);
+	if (rejected.length === 0) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		role: "alert",
+		className: "webskill-surface--error text-sm text-destructive",
+		children: ["Invalid UI spec: ", rejected.map((item) => `${item.path}: ${item.detail}`).join("; ")]
+	});
+}
+/** 其余降级的中性说明（AC-23.8）：不是错误，是「这个档 / 这份 spec 有一部分做不到」 */
+function SurfaceSimplifiedNote({ degradations }) {
+	const simplified = degradations.filter((degradation) => !isOutOfCatalog(degradation));
+	if (simplified.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		role: "note",
+		"data-webskill-degraded": simplified.length,
+		className: "webskill-surface--unsupported text-xs text-muted",
+		children: simplified.map((item) => `${item.path} (${item.kind})`).join("; ")
+	});
+}
+/** 两级合并渲染；可选依赖有门禁的档要分开用上面两个 */
+function SurfaceDegradationNote({ degradations }) {
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(SurfaceRejectionAlert, { degradations }), /* @__PURE__ */ jsx(SurfaceSimplifiedNote, { degradations })] });
+}
+/**
 * catalog `Table` 节点的渲染实现：排序 / 筛选 / 分页 / 列显隐 / 虚拟滚动。
 * 这些是宿主侧的呈现能力，不进 catalog props——模型只声明 columns 与 rows。
 * 它们都带 `data-webskill-host-control`，跨渲染器语义对括据此排除宿主控件。
 */
-function SpecTable({ columns, rows, label }) {
+function SpecTable({ columns, rows, label, columnWidths, onDegraded }) {
 	const [sorting, setSorting] = useState([]);
 	const [globalFilter, setGlobalFilter] = useState("");
 	const [columnVisibility, setColumnVisibility] = useState({});
 	const scrollRef = useRef(null);
+	const normalized = normalizeColumnWidths(columnWidths, columns.length);
+	const weightTotal = normalized.weights.reduce((sum, weight) => sum + weight, 0);
+	const widthPercents = normalized.weights.map((weight) => weightTotal > 0 ? weight / weightTotal * 100 : 0);
+	const rejected = normalized.rejected;
+	useEffect(() => {
+		if (rejected !== void 0) onDegraded?.(rejected);
+	}, [rejected, onDegraded]);
 	const table = useReactTable({
 		data: rows,
 		columns: columns.map((header, index) => ({
@@ -6983,30 +7031,34 @@ function SpecTable({ columns, rows, label }) {
 			/* @__PURE__ */ jsxs(DataTable, {
 				"aria-label": label,
 				containerClassName: "webskill-surface__table-scroll",
-				children: [/* @__PURE__ */ jsx("thead", {
-					className: "webskill-surface__table-header",
-					children: /* @__PURE__ */ jsx("tr", { children: table.getFlatHeaders().map((header) => /* @__PURE__ */ jsx("th", {
-						scope: "col",
-						...header.column.id === "selection" ? { "data-webskill-host-control": "" } : {},
-						"aria-sort": header.column.getIsSorted() === "asc" ? "ascending" : header.column.getIsSorted() === "desc" ? "descending" : "none",
-						children: header.column.getCanSort() ? /* @__PURE__ */ jsx("button", {
-							type: "button",
-							"data-webskill-host-control": "",
-							onClick: header.column.getToggleSortingHandler(),
-							children: flexRender(header.column.columnDef.header, header.getContext())
-						}) : flexRender(header.column.columnDef.header, header.getContext())
-					}, header.id)) })
-				}), /* @__PURE__ */ jsx("tbody", {
-					ref: scrollRef,
-					className: "webskill-surface__table-body",
-					children: renderedRows.map((virtualRow) => {
-						const row = modelRows[virtualRow.index];
-						return /* @__PURE__ */ jsx("tr", { children: row.getVisibleCells().map((cell) => /* @__PURE__ */ jsx("td", {
-							...cell.column.id === "selection" ? { "data-webskill-host-control": "" } : {},
-							children: flexRender(cell.column.columnDef.cell, cell.getContext())
-						}, cell.id)) }, row.id);
+				children: [
+					/* @__PURE__ */ jsx("colgroup", { children: widthPercents.map((percent, index) => /* @__PURE__ */ jsx("col", { style: { width: `${percent}%` } }, index)) }),
+					/* @__PURE__ */ jsx("thead", {
+						className: "webskill-surface__table-header",
+						children: /* @__PURE__ */ jsx("tr", { children: table.getFlatHeaders().map((header) => /* @__PURE__ */ jsx("th", {
+							scope: "col",
+							...header.column.id === "selection" ? { "data-webskill-host-control": "" } : {},
+							"aria-sort": header.column.getIsSorted() === "asc" ? "ascending" : header.column.getIsSorted() === "desc" ? "descending" : "none",
+							children: header.column.getCanSort() ? /* @__PURE__ */ jsx("button", {
+								type: "button",
+								"data-webskill-host-control": "",
+								onClick: header.column.getToggleSortingHandler(),
+								children: flexRender(header.column.columnDef.header, header.getContext())
+							}) : flexRender(header.column.columnDef.header, header.getContext())
+						}, header.id)) })
+					}),
+					/* @__PURE__ */ jsx("tbody", {
+						ref: scrollRef,
+						className: "webskill-surface__table-body",
+						children: renderedRows.map((virtualRow) => {
+							const row = modelRows[virtualRow.index];
+							return /* @__PURE__ */ jsx("tr", { children: row.getVisibleCells().map((cell) => /* @__PURE__ */ jsx("td", {
+								...cell.column.id === "selection" ? { "data-webskill-host-control": "" } : {},
+								children: flexRender(cell.column.columnDef.cell, cell.getContext())
+							}, cell.id)) }, row.id);
+						})
 					})
-				})]
+				]
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				className: "webskill-surface__table-pagination",
@@ -7096,11 +7148,17 @@ function renderNode(node, context, key, scope) {
 				}) : null
 			]
 		}, key);
-		case "Table": return /* @__PURE__ */ jsx(SpecTable, {
-			columns: Array.isArray(props["columns"]) ? props["columns"] : [],
-			rows: Array.isArray(props["rows"]) ? props["rows"] : [],
-			label: str(props, "title", "Data")
-		}, key);
+		case "Table": {
+			const columns = Array.isArray(props["columns"]) ? props["columns"] : [];
+			const rows = Array.isArray(props["rows"]) ? props["rows"] : [];
+			const columnWidths = Array.isArray(props["columnWidths"]) ? props["columnWidths"] : void 0;
+			return /* @__PURE__ */ jsx(SpecTable, {
+				columns,
+				rows,
+				label: str(props, "title", "Data"),
+				...columnWidths ? { columnWidths } : {}
+			}, key);
+		}
 		case "Chart": return /* @__PURE__ */ jsx(EChart, { chart: chartSpecFromProps(props) }, key);
 		case "Tabs": return /* @__PURE__ */ jsx(SpecTabs, {
 			props,
@@ -7117,7 +7175,7 @@ function renderNode(node, context, key, scope) {
 			children: [/* @__PURE__ */ jsx("span", {
 				className: "text-ink",
 				children: str(props, "label", str(props, "path"))
-			}), /* @__PURE__ */ jsx(Button, {
+			}), context.readOnly ? null : /* @__PURE__ */ jsx(Button, {
 				size: "sm",
 				variant: "secondary",
 				"data-webskill-surface-action": context.resolveActionId("download", node.id),
@@ -7150,6 +7208,11 @@ function renderNode(node, context, key, scope) {
 			props,
 			scope
 		}, key);
+		case "FieldArray": return /* @__PURE__ */ jsx(SurfaceFieldArray, {
+			form: context,
+			props,
+			scope
+		}, key);
 		case "Button": return /* @__PURE__ */ jsx(SurfaceButton, {
 			form: context,
 			props,
@@ -7204,29 +7267,35 @@ function renderNode(node, context, key, scope) {
 * 节点树取代六类 surface 后，这里是 native 档唯一的渲染实现。
 */
 function NativeSpecSurface({ surfaceId, spec, actions, registry, runId, draft, onAction, onDraftChange, shell = "card" }) {
+	const sanitized = useSanitizedSpec(spec);
+	const form = useSurfaceForm({
+		surfaceId,
+		spec: sanitized.node ?? spec,
+		actions,
+		runId,
+		draft,
+		onAction,
+		onDraftChange
+	});
 	const context = {
-		...useSurfaceForm({
-			surfaceId,
-			spec,
-			actions,
-			runId,
-			draft,
-			onAction,
-			onDraftChange
-		}),
+		...form,
 		registry,
 		onAction
 	};
-	const validation = uiCatalog.validate(spec);
-	if (!validation.ok) return /* @__PURE__ */ jsxs("div", {
-		role: "alert",
-		className: "webskill-surface--error text-sm text-destructive",
-		children: ["Invalid UI spec: ", validation.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ")]
-	});
-	return /* @__PURE__ */ jsx("div", {
+	const texts = useSurfaceFormTexts();
+	const { node, degradations } = sanitized;
+	return /* @__PURE__ */ jsxs("div", {
 		className: shell === "none" ? "webskill-surface--spec" : "webskill-surface webskill-surface--spec",
 		"data-testid": "native-spec-surface",
-		children: renderNode(spec, context, "root")
+		children: [
+			node ? renderNode(node, context, "root") : null,
+			form.readOnly && actions.length > 0 ? /* @__PURE__ */ jsx("p", {
+				"data-testid": "surface-readonly-note",
+				className: "mt-2 text-xs text-muted",
+				children: texts.readOnlySnapshot
+			}) : null,
+			/* @__PURE__ */ jsx(SurfaceDegradationNote, { degradations })
+		]
 	});
 }
 function Surface({ snapshot, registry, onAction, drafts, onDraftChange }) {
@@ -7324,27 +7393,27 @@ function JsonRenderSpecSurface({ spec, surfaceId, actions, onAction }) {
 			cancelled = true;
 		};
 	}, []);
-	const validation = uiCatalog.validate(spec);
-	if (!validation.ok) return /* @__PURE__ */ jsxs("div", {
-		role: "alert",
-		className: "webskill-surface--error text-sm text-destructive",
-		children: ["Invalid UI spec: ", validation.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ")]
-	});
-	if (unavailable) return /* @__PURE__ */ jsx("div", {
+	const sanitized = useSanitizedSpec(spec);
+	const rejection = /* @__PURE__ */ jsx(SurfaceRejectionAlert, { degradations: sanitized.degradations });
+	if (unavailable) return /* @__PURE__ */ jsxs(Fragment$1, { children: [rejection, /* @__PURE__ */ jsx("div", {
 		role: "alert",
 		className: "webskill-surface--unsupported text-sm text-muted",
 		children: "The json-render renderer is not installed: add @json-render/core and @json-render/react to this host."
-	});
-	if (!module) return null;
-	return /* @__PURE__ */ jsx(CatalogSurfaceProvider, {
+	})] });
+	if (!module) return rejection;
+	return /* @__PURE__ */ jsxs(CatalogSurfaceProvider, {
 		surfaceId,
-		spec,
+		spec: sanitized.node ?? spec,
 		actions: actions ?? [],
 		...onAction ? { onAction } : {},
-		children: /* @__PURE__ */ jsx(JsonRenderBody, {
-			spec,
-			module
-		})
+		children: [
+			rejection,
+			sanitized.node ? /* @__PURE__ */ jsx(JsonRenderBody, {
+				spec: sanitized.node,
+				module
+			}) : null,
+			/* @__PURE__ */ jsx(SurfaceSimplifiedNote, { degradations: sanitized.degradations })
+		]
 	});
 }
 /** registry 的 action 出口绑定到本 surface：json-render 派发的动作与组件内点击回传同一份载荷 */
@@ -7518,7 +7587,7 @@ function OpenUiSpecSurface({ spec, surfaceId, actions, onAction }) {
 	const [unavailable, setUnavailable] = useState(false);
 	useEffect(() => {
 		let cancelled = false;
-		import("./openUiLibrary-Bdrji9qK-D2LxmM-a.js").then((loaded) => {
+		import("./openUiLibrary-DURlAxjk-CU6AzfSW.js").then((loaded) => {
 			if (!cancelled) setModule(loaded);
 		}).catch(() => {
 			if (!cancelled) setUnavailable(true);
@@ -7527,34 +7596,34 @@ function OpenUiSpecSurface({ spec, surfaceId, actions, onAction }) {
 			cancelled = true;
 		};
 	}, []);
-	const validation = uiCatalog.validate(spec);
-	if (!validation.ok) return /* @__PURE__ */ jsxs("div", {
-		role: "alert",
-		className: "webskill-surface--error text-sm text-destructive",
-		children: ["Invalid UI spec: ", validation.issues.map((issue) => `${issue.path}: ${issue.message}`).join("; ")]
-	});
-	if (unavailable) return /* @__PURE__ */ jsx("div", {
+	const sanitized = useSanitizedSpec(spec);
+	const rejection = /* @__PURE__ */ jsx(SurfaceRejectionAlert, { degradations: sanitized.degradations });
+	if (unavailable) return /* @__PURE__ */ jsxs(Fragment$1, { children: [rejection, /* @__PURE__ */ jsx("div", {
 		role: "alert",
 		className: "webskill-surface--unsupported text-sm text-muted",
 		children: "The OpenUI renderer is not installed: add @openuidev/react-lang to this host."
-	});
-	if (!module) return null;
+	})] });
+	if (!module) return rejection;
 	const { Renderer, webskillOpenUiLibrary } = module;
 	return /* @__PURE__ */ jsx(CatalogSurfaceProvider, {
 		surfaceId,
-		spec,
+		spec: sanitized.node ?? spec,
 		actions: actions ?? [],
 		...onAction ? { onAction } : {},
-		children: /* @__PURE__ */ jsx("div", {
+		children: /* @__PURE__ */ jsxs("div", {
 			className: "webskill-surface webskill-surface--spec",
 			"data-testid": "openui-spec-surface",
-			children: /* @__PURE__ */ jsx(Renderer, {
-				response: toOpenUiSpecLang(spec),
-				library: webskillOpenUiLibrary
-			})
+			children: [
+				sanitized.node ? /* @__PURE__ */ jsx(Renderer, {
+					response: toOpenUiSpecLang(sanitized.node),
+					library: webskillOpenUiLibrary
+				}) : null,
+				rejection,
+				/* @__PURE__ */ jsx(SurfaceSimplifiedNote, { degradations: sanitized.degradations })
+			]
 		})
 	});
 }
 
 //#endregion
-export { InteractionForm, JsonRenderSpecSurface, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, ResultBlocks, SpecInteractionChannel, StreamingText, SurfaceRegistry, UiSurfaceList, UiSurfaceSnapshotList, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability };
+export { InteractionForm, JsonRenderSpecSurface, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, ResultBlocks, SpecInteractionChannel, StreamingText, SurfaceFormTextsProvider, SurfaceRegistry, UiSurfaceList, UiSurfaceSnapshotList, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability, useSurfaceFormTexts };

package/dist/ui-vue.d.ts

@@ -1,4 +1,4 @@
-import { c as InteractionResponse, s as InteractionRequest, x as UiBridge, y as RenderResultRequest } from "./types-CcxRLdJG-DCXyw1US.js";
+import { c as InteractionResponse, s as InteractionRequest, x as UiBridge, y as RenderResultRequest } from "./types-B3n0cMZu-BdcqQ35O.js";
 import { PropType } from "vue";
 //#region ../ui-vue/dist/index.d.ts
 //#region src/bridgeState.d.ts

package/dist/ui-vue.js

@@ -1,4 +1,4 @@
-import { I as shapeInteractionValue, O as interactionToFormModel, P as renderMiniChart, g as applySuggestion, tt as renderMiniMarkdown, x as collectValues } from "./dist-DnYG2-eY.js";
+import { R as renderMiniChart, Z as DEFAULT_SURFACE_FORM_TEXTS, ct as renderMiniMarkdown, dt as shapeInteractionValue, ot as interactionToFormModel, w as collectValues, y as applySuggestion } from "./dist-CJqQsIm9.js";
 import { defineComponent, h, reactive, ref } from "vue";
 
 //#region ../ui-vue/dist/index.js
@@ -164,7 +164,7 @@ const InteractionForm = defineComponent({
 						id: `webskill-error-${control.name}`,
 						role: "alert",
 						class: "webskill-form__error"
-					}, "This field is required") : null
+					}, DEFAULT_SURFACE_FORM_TEXTS.required) : null
 				])),
 				h("div", { class: "webskill-form__actions" }, [h("button", {
 					type: "submit",

package/dist/ui.d.ts

@@ -1,4 +1,4 @@
-import { gt as UiSpecNode } from "./types-CcxRLdJG-DCXyw1US.js";
-import { mn as buildRenderResult } from "./index-DkbABR43.js";
-import { $ as buildA2uiCatalogDefinition, A as UiActionDef, At as uiCatalog, B as UiSpecValidation, C as OpenUiRendererProps, Ct as shapeInteractionValue, D as UI_CATALOG_PROMPT_BUDGET_BYTES, Dt as toOpenUiSpecLang, E as UI_CATALOG_GROUPS, Et as toJsonRenderSpec, F as UiComponentDef, G as WEBSKILL_A2UI_CATALOG_ID, H as VERCEL_INTERACTION_TOOL_NAME, I as UiFormScope, J as WebFormBridge, K as WEBSKILL_STYLES_CSS, L as UiPreset, M as UiCatalogInput, N as UiCatalogPromptOptions, O as UI_PRESETS, Ot as toUiSurfaceActionDispatch, P as UiCatalogToolSourceOptions, Q as applySuggestion, R as UiPresetName, S as LoadedOpenUiPeers, St as renderRenderResult, T as RENDER_UI_TOOL, Tt as toA2uiSurfaceAction, U as VercelToolInvocation, V as UiSurfaceActionDispatch, W as VercelUiBridge, X as a2uiComponentSchema, Y as ZodRuntime, Z as a2uiComponentShapes, _ as DESCRIBE_UI_PRESET_TOOL, _t as mountEchart, a as A2UI_SURFACE_ACTION, at as collectValues, b as InteractionSpecLabels, bt as renderMiniChart, c as A2uiCatalogDefinition, ct as ensureStyles, d as A2uiMessage, dt as fromUiSurfaceActionDispatch, et as chartSpecFromProps, f as A2uiSpecActionEvent, ft as fromVercelToolResult, g as ControlModel, gt as loadWebSkillLitCatalog, h as CollectedValues, ht as loadOpenUiPeers, i as A2UI_SPEC_FORM_PATH, it as collectSpecActions, j as UiCatalog, jt as uiPreset, k as UI_PRESET_NAMES, kt as toVercelToolInvocation, l as A2uiCatalogHandle, lt as fromA2uiSpecAction, m as CHART_PALETTE, mt as interactionToUiSpec, n as A2UI_COMMON_TYPES, nt as collectFormScopes, o as A2UI_VERSION, ot as createUiCatalogToolSource, p as A2uiSpecMessageOptions, pt as interactionToFormModel, q as WEBSKILL_SURFACE_ACTION, r as A2UI_SPEC_ACTION, rt as collectScopedValues, s as A2uiCatalogComponent, st as defineUiCatalog, t as A2UI_BASIC_CATALOG_ID, tt as chartToTable, u as A2uiComponentShape, ut as fromA2uiSurfaceAction, v as EchartHandle, vt as qualifyFieldName, w as OpenUiRuntime, wt as toA2uiSpecMessages, x as JsonRenderSpec, xt as renderMiniMarkdown, y as FormModel, yt as renderBlocks, z as UiSpecIssue } from "./index-BwsK9lGk.js";
-export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, type A2uiCatalogComponent, type A2uiCatalogDefinition, type A2uiCatalogHandle, type A2uiComponentShape, type A2uiMessage, type A2uiSpecActionEvent, type A2uiSpecMessageOptions, CHART_PALETTE, type CollectedValues, type ControlModel, DESCRIBE_UI_PRESET_TOOL, type EchartHandle, type FormModel, type InteractionSpecLabels, type JsonRenderSpec, type LoadedOpenUiPeers, type OpenUiRendererProps, type OpenUiRuntime, RENDER_UI_TOOL, UI_CATALOG_GROUPS, UI_CATALOG_PROMPT_BUDGET_BYTES, UI_PRESETS, UI_PRESET_NAMES, type UiActionDef, type UiCatalog, type UiCatalogInput, type UiCatalogPromptOptions, type UiCatalogToolSourceOptions, type UiComponentDef, type UiFormScope, type UiPreset, type UiPresetName, type UiSpecIssue, type UiSpecNode, type UiSpecValidation, type UiSurfaceActionDispatch, VERCEL_INTERACTION_TOOL_NAME, type VercelToolInvocation, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, type ZodRuntime, a2uiComponentSchema, a2uiComponentShapes, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, qualifyFieldName, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };
+import { vt as UiSpecNode } from "./types-B3n0cMZu-BdcqQ35O.js";
+import { vn as buildRenderResult } from "./index-K-eewlGL.js";
+import { $ as UiSpecIssue, A as MAX_CONDITION_DEPTH, At as interactionToUiSpec, B as UI_CATALOG_PROMPT_BUDGET_BYTES, Bt as resolveColumnWidths, C as FieldCondition, Ct as ensureStyles, D as InteractionTexts, Dt as fromUiSurfaceActionDispatch, E as InteractionSpecLabels, Et as fromA2uiSurfaceAction, F as SPEC_TABLE_MIN_COLUMN_VAR, Ft as qualifyFieldName, G as UiCatalogInput, Gt as toA2uiSurfaceAction, H as UI_PRESET_NAMES, Ht as resolveSurfaceFormTexts, I as SPEC_TABLE_MIN_COLUMN_WIDTH, It as renderBlocks, J as UiComponentDef, Jt as toUiSurfaceActionDispatch, K as UiCatalogPromptOptions, Kt as toJsonRenderSpec, L as SpecColumnMeta, Lt as renderMiniChart, M as OpenUiRendererProps, Mt as loadWebSkillLitCatalog, N as OpenUiRuntime, Nt as mountEchart, O as JsonRenderSpec, Ot as fromVercelToolResult, P as RENDER_UI_TOOL, Pt as normalizeColumnWidths, Q as UiSpecDegradation, R as SurfaceFormTexts, Rt as renderMiniMarkdown, S as EvaluateFieldConditionOptions, St as defineUiCatalog, T as FormModel, Tt as fromA2uiSpecAction, U as UiActionDef, Ut as shapeInteractionValue, V as UI_PRESETS, Vt as resolveInteractionTexts, W as UiCatalog, Wt as toA2uiSpecMessages, X as UiPreset, Xt as uiCatalog, Y as UiFormScope, Yt as toVercelToolInvocation, Z as UiPresetName, Zt as uiPreset, _ as ControlModel, _t as collectFormScopes, a as A2UI_SURFACE_ACTION, at as VercelUiBridge, b as DESCRIBE_UI_PRESET_TOOL, bt as collectValues, c as A2uiCatalogDefinition, ct as WEBSKILL_SURFACE_ACTION, d as A2uiMessage, dt as a2uiComponentSchema, et as UiSpecSanitization, f as A2uiSpecActionEvent, ft as a2uiComponentShapes, g as ColumnWidthsRejection, gt as chartToTable, h as CollectedValues, ht as chartSpecFromProps, i as A2UI_SPEC_FORM_PATH, it as VercelToolInvocation, j as NormalizedColumnWidths, jt as loadOpenUiPeers, k as LoadedOpenUiPeers, kt as interactionToFormModel, l as A2uiCatalogHandle, lt as WebFormBridge, m as CHART_PALETTE, mt as buildA2uiCatalogDefinition, n as A2UI_COMMON_TYPES, nt as UiSurfaceActionDispatch, o as A2UI_VERSION, ot as WEBSKILL_A2UI_CATALOG_ID, p as A2uiSpecMessageOptions, pt as applySuggestion, q as UiCatalogToolSourceOptions, qt as toOpenUiSpecLang, r as A2UI_SPEC_ACTION, rt as VERCEL_INTERACTION_TOOL_NAME, s as A2uiCatalogComponent, st as WEBSKILL_STYLES_CSS, t as A2UI_BASIC_CATALOG_ID, tt as UiSpecValidation, u as A2uiComponentShape, ut as ZodRuntime, v as DEFAULT_INTERACTION_TEXTS, vt as collectScopedValues, w as FieldConditionResult, wt as evaluateFieldCondition, x as EchartHandle, xt as createUiCatalogToolSource, y as DEFAULT_SURFACE_FORM_TEXTS, yt as collectSpecActions, z as UI_CATALOG_GROUPS, zt as renderRenderResult } from "./index-P9J2LTfU.js";
+export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, type A2uiCatalogComponent, type A2uiCatalogDefinition, type A2uiCatalogHandle, type A2uiComponentShape, type A2uiMessage, type A2uiSpecActionEvent, type A2uiSpecMessageOptions, CHART_PALETTE, type CollectedValues, type ColumnWidthsRejection, type ControlModel, DEFAULT_INTERACTION_TEXTS, DEFAULT_SURFACE_FORM_TEXTS, DESCRIBE_UI_PRESET_TOOL, type EchartHandle, type EvaluateFieldConditionOptions, type FieldCondition, type FieldConditionResult, type FormModel, type InteractionSpecLabels, type InteractionTexts, type JsonRenderSpec, type LoadedOpenUiPeers, MAX_CONDITION_DEPTH, type NormalizedColumnWidths, type OpenUiRendererProps, type OpenUiRuntime, RENDER_UI_TOOL, SPEC_TABLE_MIN_COLUMN_VAR, SPEC_TABLE_MIN_COLUMN_WIDTH, type SpecColumnMeta, type SurfaceFormTexts, UI_CATALOG_GROUPS, UI_CATALOG_PROMPT_BUDGET_BYTES, UI_PRESETS, UI_PRESET_NAMES, type UiActionDef, type UiCatalog, type UiCatalogInput, type UiCatalogPromptOptions, type UiCatalogToolSourceOptions, type UiComponentDef, type UiFormScope, type UiPreset, type UiPresetName, type UiSpecDegradation, type UiSpecIssue, type UiSpecNode, type UiSpecSanitization, type UiSpecValidation, type UiSurfaceActionDispatch, VERCEL_INTERACTION_TOOL_NAME, type VercelToolInvocation, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, type ZodRuntime, a2uiComponentSchema, a2uiComponentShapes, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, evaluateFieldCondition, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, normalizeColumnWidths, qualifyFieldName, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, resolveColumnWidths, resolveInteractionTexts, resolveSurfaceFormTexts, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };

package/dist/ui.js

@@ -1,4 +1,4 @@
-import { V as buildRenderResult } from "./dist-D0qW6e40.js";
-import { $ as defineUiCatalog, A as loadOpenUiPeers, B as toOpenUiSpecLang, C as ensureStyles, D as fromVercelToolResult, E as fromUiSurfaceActionDispatch, F as renderRenderResult, G as A2UI_COMMON_TYPES, H as toVercelToolInvocation, I as shapeInteractionValue, J as WEBSKILL_A2UI_CATALOG_ID, K as UI_CATALOG_GROUPS, L as toA2uiSpecMessages, M as qualifyFieldName, N as renderBlocks, O as interactionToFormModel, P as renderMiniChart, Q as chartSpecFromProps, R as toA2uiSurfaceAction, S as createUiCatalogToolSource, T as fromA2uiSurfaceAction, U as uiPreset, V as toUiSurfaceActionDispatch, X as a2uiComponentShapes, Y as a2uiComponentSchema, Z as buildA2uiCatalogDefinition, _ as chartToTable, a as A2UI_VERSION, b as collectSpecActions, c as RENDER_UI_TOOL, d as VERCEL_INTERACTION_TOOL_NAME, et as mountEchart, f as VercelUiBridge, g as applySuggestion, h as WebFormBridge, i as A2UI_SURFACE_ACTION, j as loadWebSkillLitCatalog, k as interactionToUiSpec, l as UI_PRESETS, m as WEBSKILL_SURFACE_ACTION, n as A2UI_SPEC_ACTION, nt as uiCatalog, o as CHART_PALETTE, p as WEBSKILL_STYLES_CSS, q as UI_CATALOG_PROMPT_BUDGET_BYTES, r as A2UI_SPEC_FORM_PATH, s as DESCRIBE_UI_PRESET_TOOL, t as A2UI_BASIC_CATALOG_ID, tt as renderMiniMarkdown, u as UI_PRESET_NAMES, v as collectFormScopes, w as fromA2uiSpecAction, x as collectValues, y as collectScopedValues, z as toJsonRenderSpec } from "./dist-DnYG2-eY.js";
+import { V as buildRenderResult } from "./dist-DmI5SBBF.js";
+import { $ as UI_CATALOG_PROMPT_BUDGET_BYTES, A as fromUiSurfaceActionDispatch, B as resolveColumnWidths, C as collectSpecActions, D as evaluateFieldCondition, E as ensureStyles, F as normalizeColumnWidths, G as toUiSurfaceActionDispatch, H as toA2uiSurfaceAction, I as qualifyFieldName, K as toVercelToolInvocation, L as renderBlocks, M as interactionToUiSpec, N as loadOpenUiPeers, O as fromA2uiSpecAction, P as loadWebSkillLitCatalog, Q as UI_CATALOG_GROUPS, R as renderMiniChart, S as collectScopedValues, T as createUiCatalogToolSource, U as toJsonRenderSpec, V as toA2uiSpecMessages, W as toOpenUiSpecLang, X as DEFAULT_INTERACTION_TEXTS, Y as A2UI_COMMON_TYPES, Z as DEFAULT_SURFACE_FORM_TEXTS, _ as WEBSKILL_SURFACE_ACTION, a as A2UI_VERSION, at as defineUiCatalog, b as chartToTable, c as MAX_CONDITION_DEPTH, ct as renderMiniMarkdown, d as SPEC_TABLE_MIN_COLUMN_WIDTH, dt as shapeInteractionValue, et as WEBSKILL_A2UI_CATALOG_ID, f as UI_PRESETS, ft as uiCatalog, g as WEBSKILL_STYLES_CSS, h as VercelUiBridge, i as A2UI_SURFACE_ACTION, it as chartSpecFromProps, j as fromVercelToolResult, k as fromA2uiSurfaceAction, l as RENDER_UI_TOOL, lt as resolveInteractionTexts, m as VERCEL_INTERACTION_TOOL_NAME, n as A2UI_SPEC_ACTION, nt as a2uiComponentShapes, o as CHART_PALETTE, ot as interactionToFormModel, p as UI_PRESET_NAMES, q as uiPreset, r as A2UI_SPEC_FORM_PATH, rt as buildA2uiCatalogDefinition, s as DESCRIBE_UI_PRESET_TOOL, st as mountEchart, t as A2UI_BASIC_CATALOG_ID, tt as a2uiComponentSchema, u as SPEC_TABLE_MIN_COLUMN_VAR, ut as resolveSurfaceFormTexts, v as WebFormBridge, w as collectValues, x as collectFormScopes, y as applySuggestion, z as renderRenderResult } from "./dist-CJqQsIm9.js";
 
-export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, CHART_PALETTE, DESCRIBE_UI_PRESET_TOOL, RENDER_UI_TOOL, UI_CATALOG_GROUPS, UI_CATALOG_PROMPT_BUDGET_BYTES, UI_PRESETS, UI_PRESET_NAMES, VERCEL_INTERACTION_TOOL_NAME, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, a2uiComponentSchema, a2uiComponentShapes, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, qualifyFieldName, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };
+export { A2UI_BASIC_CATALOG_ID, A2UI_COMMON_TYPES, A2UI_SPEC_ACTION, A2UI_SPEC_FORM_PATH, A2UI_SURFACE_ACTION, A2UI_VERSION, CHART_PALETTE, DEFAULT_INTERACTION_TEXTS, DEFAULT_SURFACE_FORM_TEXTS, DESCRIBE_UI_PRESET_TOOL, MAX_CONDITION_DEPTH, RENDER_UI_TOOL, SPEC_TABLE_MIN_COLUMN_VAR, SPEC_TABLE_MIN_COLUMN_WIDTH, UI_CATALOG_GROUPS, UI_CATALOG_PROMPT_BUDGET_BYTES, UI_PRESETS, UI_PRESET_NAMES, VERCEL_INTERACTION_TOOL_NAME, VercelUiBridge, WEBSKILL_A2UI_CATALOG_ID, WEBSKILL_STYLES_CSS, WEBSKILL_SURFACE_ACTION, WebFormBridge, a2uiComponentSchema, a2uiComponentShapes, applySuggestion, buildA2uiCatalogDefinition, buildRenderResult, chartSpecFromProps, chartToTable, collectFormScopes, collectScopedValues, collectSpecActions, collectValues, createUiCatalogToolSource, defineUiCatalog, ensureStyles, evaluateFieldCondition, fromA2uiSpecAction, fromA2uiSurfaceAction, fromUiSurfaceActionDispatch, fromVercelToolResult, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, mountEchart, normalizeColumnWidths, qualifyFieldName, renderBlocks, renderMiniChart, renderMiniMarkdown, renderRenderResult, resolveColumnWidths, resolveInteractionTexts, resolveSurfaceFormTexts, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toJsonRenderSpec, toOpenUiSpecLang, toUiSurfaceActionDispatch, toVercelToolInvocation, uiCatalog, uiPreset };

package/dist/{webskillLitCatalog-_mugzRHx-B_54vxum.js → webskillLitCatalog-DwTwSBFt-DiXXpNZA.js}

@@ -1,4 +1,4 @@
-import { J as WEBSKILL_A2UI_CATALOG_ID, Q as chartSpecFromProps, W as A2UI_CHILDREN_PROP, X as a2uiComponentShapes, et as mountEchart, nt as uiCatalog, tt as renderMiniMarkdown } from "./dist-DnYG2-eY.js";
+import { J as A2UI_CHILDREN_PROP, Z as DEFAULT_SURFACE_FORM_TEXTS, ct as renderMiniMarkdown, et as WEBSKILL_A2UI_CATALOG_ID, ft as uiCatalog, it as chartSpecFromProps, nt as a2uiComponentShapes, st as mountEchart } from "./dist-CJqQsIm9.js";
 import { A2uiController, A2uiLitElement } from "@a2ui/lit/v0_9";
 import { Catalog } from "@a2ui/web_core/v0_9";
 import { z } from "zod/v3";
@@ -1419,7 +1419,7 @@ var f = class extends i {
 };
 
 //#endregion
-//#region ../ui/dist/webskillLitCatalog-_mugzRHx.js
+//#region ../ui/dist/webskillLitCatalog-DwTwSBFt.js
 /**
 * Lit 元素上的 echarts 挂载指令。
 * A2UI 档的 catalog `Chart` 渲染在 shadow root 里，实例必须随元素断开而 dispose，
@@ -1539,6 +1539,16 @@ const sharedStyles = i$4`
     overflow: auto;
     border: 1px solid var(--border);
     border-radius: var(--radius);
+    container-type: inline-size;
+    container-name: webskill-table;
+  }
+  /* 窄档降到 SPEC_TABLE_MIN_COLUMN_WIDTH.mobile。native 档的同名规则在 surfaces.css，
+     那边的选择器进不了 shadow root，所以两侧各写一遍——变量名与取值必须同步（T-25-F） */
+  @container webskill-table (width < 30rem) {
+    th,
+    td {
+      --webskill-table-min-col: 5rem;
+    }
   }
   table {
     width: max-content;
@@ -1548,7 +1558,7 @@ const sharedStyles = i$4`
   }
   th,
   td {
-    min-width: 8rem;
+    min-width: var(--webskill-table-min-col, 8rem);
     border-bottom: 1px solid var(--border);
     padding: 0.375rem 0.5rem;
     text-align: left;
@@ -1738,6 +1748,15 @@ const renderers = {
     <form @submit=${(event) => event.preventDefault()}>
       ${props["title"] ? T`<h3>${str(props, "title")}</h3>` : A} ${children(props, host)}
     </form>
+  `,
+	FieldArray: (props, host) => T`
+    <fieldset data-webskill-surface-array=${str(props, "name")}>
+      <legend>${str(props, "label", str(props, "name"))}</legend>
+      ${children(props, host)}
+      <p role="note" data-webskill-degraded="field-array">
+        ${str(props, "degradedNote", DEFAULT_SURFACE_FORM_TEXTS.arrayFirstItemOnly)}
+      </p>
+    </fieldset>
   `,
 	Field: (props) => {
 		const name = str(props, "name");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webskill/sdk",
-  "version": "0.7.0",
-  "description": "WebSkill \u2014 browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
+  "version": "0.8.0",
+  "description": "WebSkill — browser/Node agent skill runtime (skills, tools, MCP, governance, UI)",
   "license": "MIT",
   "type": "module",
   "engines": {