@changfenhuang/dsh-genui 0.11.1 → 0.11.2

package/lib/index.js

@@ -968,7 +968,7 @@ function normalizeNode(value, path, warnings) {
 				canonical: "items"
 			});
 		}
-		normalizedHolder.items = Array.isArray(normalizedHolder.items) ? normalizedHolder.items.map((child, childIndex) => normalizeNodeValue(child, `${path}.tabs[${index}].items[${childIndex}]`)) : normalizedHolder.items === void 0 ? normalizedHolder.items : [normalizeNodeValue(normalizedHolder.items, `${path}.tabs[${index}].items[0]`)];
+		normalizedHolder.items = Array.isArray(normalizedHolder.items) ? normalizedHolder.items.map((child, childIndex) => normalizeNodeValue(child, `${path}.tabs[${index}].items[${childIndex}]`)) : normalizedHolder.items === void 0 ? [] : [normalizeNodeValue(normalizedHolder.items, `${path}.tabs[${index}].items[0]`)];
 		return normalizedHolder;
 	});
 	else if (type === "accordion" && Array.isArray(out.items)) out.items = out.items.map((item, index) => {
@@ -2618,9 +2618,10 @@ function validateCanonicalGenuiSpec(value) {
 		}
 	};
 	walk(v.items, 0, "items");
+	const uniqueErrors = [...new Set(errors)];
 	return {
-		ok: errors.length === 0,
-		errors
+		ok: uniqueErrors.length === 0,
+		errors: uniqueErrors
 	};
 }
 /**
@@ -3426,6 +3427,188 @@ function droppedNodeFailure(processed, raw) {
 	];
 }
 //#endregion
+//#region src/plugin/inline-content-diagnostic.ts
+/** 识别文字字段中的连续代码围栏标记。 */
+function hasFencedCode(value) {
+	return /`{3,}|~{3,}/.test(value);
+}
+/** 判断相邻表头下方的 Markdown 表格分隔行。 */
+function isMarkdownTableSeparator(line) {
+	let value = line.trim();
+	if (value.startsWith("|")) value = value.slice(1);
+	if (value.endsWith("|")) value = value.slice(0, -1);
+	const cells = value.split("|").map((cell) => cell.trim());
+	return cells.length >= 2 && cells.every((cell) => /^:?-{2,}:?$/.test(cell));
+}
+/** 仅在相邻表头和分隔行构成表格时报告。 */
+function hasMarkdownTable(value) {
+	const lines = value.split(/\r?\n/);
+	for (let i = 0; i + 1 < lines.length; i++) if (lines[i].includes("|") && isMarkdownTableSeparator(lines[i + 1])) return true;
+	return false;
+}
+/** 按组件结构检查需要块级内容诊断的 canonical 显示字段。 */
+function collectInlineContentWarnings(spec) {
+	const warnings = [];
+	/** 将一个可见文字字段中的块级 Markdown 记录为稳定诊断。 */
+	function check(value, path) {
+		if (value === void 0) return;
+		if (hasFencedCode(value)) warnings.push({
+			path,
+			kind: "fenced_code",
+			replacement: "code"
+		});
+		if (hasMarkdownTable(value)) warnings.push({
+			path,
+			kind: "markdown_table",
+			replacement: "table"
+		});
+	}
+	/** 只沿 GenUI 组件的子节点字段访问下一层。 */
+	function visit(node, path) {
+		switch (node.type) {
+			case "text":
+				check(node.content, `${path}.content`);
+				break;
+			case "card":
+				check(node.title, `${path}.title`);
+				node.items.forEach((child, i) => visit(child, `${path}.items[${i}]`));
+				break;
+			case "row":
+			case "col":
+			case "grid":
+				node.items.forEach((child, i) => visit(child, `${path}.items[${i}]`));
+				break;
+			case "button":
+			case "checkbox":
+			case "link":
+			case "badge":
+			case "switch":
+			case "submit":
+				check(node.label, `${path}.label`);
+				break;
+			case "input":
+			case "select":
+			case "slider":
+			case "textarea":
+				check(node.label, `${path}.label`);
+				break;
+			case "radio":
+				check(node.label, `${path}.label`);
+				node.options.forEach((option, i) => check(option, `${path}.options[${i}]`));
+				if (typeof node.answer === "string") check(node.answer, `${path}.answer`);
+				check(node.explanation, `${path}.explanation`);
+				break;
+			case "image":
+			case "audio":
+			case "video":
+				check(node.alt, `${path}.alt`);
+				break;
+			case "hero":
+				for (const field of [
+					"label",
+					"value",
+					"delta",
+					"title",
+					"subtitle"
+				]) check(node[field], `${path}.${field}`);
+				break;
+			case "stat":
+				for (const field of [
+					"label",
+					"value",
+					"delta"
+				]) check(node[field], `${path}.${field}`);
+				break;
+			case "progress":
+				check(node.label, `${path}.label`);
+				check(node.valueLabel, `${path}.valueLabel`);
+				break;
+			case "list":
+				node.items.forEach((item, i) => {
+					const itemPath = `${path}.items[${i}]`;
+					if (typeof item === "string") check(item, itemPath);
+					else if ("type" in item && typeof item.type === "string") visit(item, itemPath);
+					else {
+						check(item.title, `${itemPath}.title`);
+						check(item.desc, `${itemPath}.desc`);
+					}
+				});
+				break;
+			case "table":
+				node.columns.forEach((column, i) => check(column, `${path}.columns[${i}]`));
+				node.rows.forEach((row, i) => {
+					const detail = node.details?.[i] ?? null;
+					row.forEach((cell, j) => {
+						if (node.types?.[j] === "index" && (j !== 0 || detail === null)) return;
+						if (typeof cell === "string") check(cell, `${path}.rows[${i}][${j}]`);
+					});
+				});
+				node.details?.forEach((detail, i) => detail?.forEach((child, j) => visit(child, `${path}.details[${i}][${j}]`)));
+				break;
+			case "chart":
+				node.series?.forEach((series, i) => check(series.label, `${path}.series[${i}].label`));
+				break;
+			case "tabs":
+				node.tabs.forEach((tab, i) => {
+					check(tab.label, `${path}.tabs[${i}].label`);
+					tab.items.forEach((child, j) => visit(child, `${path}.tabs[${i}].items[${j}]`));
+				});
+				break;
+			case "accordion":
+				node.items.forEach((item, i) => {
+					check(item.title, `${path}.items[${i}].title`);
+					item.items.forEach((child, j) => visit(child, `${path}.items[${i}].items[${j}]`));
+				});
+				break;
+			case "callout":
+				check(node.title, `${path}.title`);
+				check(node.content, `${path}.content`);
+				break;
+			case "steps":
+				node.steps.forEach((step, i) => {
+					check(step.title, `${path}.steps[${i}].title`);
+					check(step.desc, `${path}.steps[${i}].desc`);
+				});
+				break;
+			case "keyvalue":
+				node.pairs.forEach((pair, i) => {
+					check(pair.key, `${path}.pairs[${i}].key`);
+					check(pair.value, `${path}.pairs[${i}].value`);
+				});
+				break;
+			case "timeline":
+				node.items.forEach((item, i) => {
+					check(item.title, `${path}.items[${i}].title`);
+					check(item.time, `${path}.items[${i}].time`);
+					check(item.desc, `${path}.items[${i}].desc`);
+				});
+				break;
+			case "breadcrumb":
+				node.items.forEach((item, i) => check(item, `${path}.items[${i}]`));
+				break;
+			case "quiz":
+				check(node.question, `${path}.question`);
+				node.options.forEach((option, i) => {
+					check(option.label, `${path}.options[${i}].label`);
+					check(option.feedback, `${path}.options[${i}].feedback`);
+				});
+				check(node.explanation, `${path}.explanation`);
+				break;
+			case "plot":
+			case "echart":
+			case "diagram":
+			case "scene3d":
+			case "svg":
+				check(node.title, `${path}.title`);
+				break;
+			case "copy": check(node.label, `${path}.label`);
+		}
+	}
+	check(spec.title, "title");
+	spec.items.forEach((node, i) => visit(node, `items[${i}]`));
+	return warnings;
+}
+//#endregion
 //#region src/plugin/tool.ts
 /**
 * Arguments schema: an open `spec` slot. The schema must NOT reject anything
@@ -3557,6 +3740,10 @@ function formatProcessWarnings(processed) {
 		return `warning=process detail=${JSON.stringify(warning.message)}`;
 	});
 }
+/** 将行内字段的块级 Markdown 诊断写入稳定的验证协议。 */
+function formatInlineContentWarnings(spec) {
+	return collectInlineContentWarnings(spec).map((warning) => `warning=block_markdown path=${warning.path} kind=${warning.kind} replacement=${warning.replacement}`);
+}
 /** Format chart-specific process errors while keeping other schema errors generic. */
 function formatProcessFailure(processed) {
 	const chartErrors = processed.errors.filter((error) => /(?:variant is unsupported|kind must be bars, line, or donut|requires data or series|(?:data|series) is required for|(?:\.data|\.series)(?:\[\d+\])?(?:\.(?:data|label|value|color))? must|series is only supported for bars)/.test(error));
@@ -3644,7 +3831,7 @@ function createRenderUiTool() {
 * before emitting — turning "render a red banner after the fact" into
 * "verify before you send". Purely local: no LLM, no network, no DOM.
 */
-const VALIDATE_DESCRIPTION = "Validate the JSON body of a ```dsh-ui fence BEFORE emitting it — use for non-trivial specs (≥3 nodes or containing a table); skip for trivial ones (≤2 nodes). Pass the exact JSON text you are about to put inside the fence as the \"spec\" argument (a string). Returns a [genui-validation] protocol block with status, diagnostics, next action, and reply_language=conversation. When invalid JSON is repairable, next=emit_repaired_fence and repaired_json contain the exact fence body to emit.";
+const VALIDATE_DESCRIPTION = "Validate the JSON body of a ```dsh-ui fence BEFORE emitting it — use for non-trivial specs (≥3 nodes or containing a table); skip for trivial ones (≤2 nodes). Pass the exact JSON text you are about to put inside the fence as the \"spec\" argument (a string). Returns a [genui-validation] protocol block with status, diagnostics, next action, and reply_language=conversation. When invalid JSON is repairable, repaired_json contains the fixed body; emit it only with next=emit_repaired_fence. A warning=block_markdown requires the indicated replacement node and another validation call.";
 const VALIDATE_PARAMETERS = {
 	type: "object",
 	properties: { spec: {
@@ -3759,15 +3946,17 @@ function createValidateDshUiTool() {
 					if (chartFailure !== void 0) return chartFailure;
 					if (processed.spec !== null && processed.errors.length === 0) {
 						const warnings = formatProcessWarnings(processed);
+						const inlineWarnings = formatInlineContentWarnings(processed.spec);
 						return `${validationProtocol([
 							"status=invalid",
 							"error=invalid_json",
 							`detail=${JSON.stringify(detail)}`,
 							...bracketDiagnostic(raw),
 							...warnings,
+							...inlineWarnings,
 							"repair=applied",
 							`repair_count=${repaired.repairs}`,
-							"next=emit_repaired_fence"
+							inlineWarnings.length === 0 ? "next=emit_repaired_fence" : "next=fix_and_revalidate"
 						])}\nrepaired_json:\n\`\`\`\n${repaired.text}\n\`\`\``;
 					}
 				}
@@ -3798,11 +3987,13 @@ function createValidateDshUiTool() {
 				]);
 			}
 			const warnings = formatProcessWarnings(processed);
+			const inlineWarnings = formatInlineContentWarnings(processed.spec);
 			return validationProtocol([
 				"status=valid",
 				`rendered=${processed.renderedCount}`,
 				...warnings,
-				"next=emit_fence"
+				...inlineWarnings,
+				inlineWarnings.length === 0 ? "next=emit_fence" : "next=fix_and_revalidate"
 			]);
 		},
 		presentCall() {
@@ -3974,6 +4165,8 @@ function resolveFence(raw, options) {
 //#region src/plugin/fence-feedback.ts
 /** Plugin name recorded on every message this loop steers. */
 const FEEDBACK_PLUGIN_NAME = "@changfenhuang/dsh-genui";
+/** Source kind persisted by this plugin in Session format v4. */
+const FEEDBACK_SOURCE_KIND = `plugin:${FEEDBACK_PLUGIN_NAME}`;
 /** Marker prefix inside the correction text: `[genui-fence-repair #<fingerprint>]`. */
 const MARKER_PREFIX = "[genui-fence-repair #";
 /** Marker prefix written by older plugin versions. */
@@ -4068,9 +4261,20 @@ function fenceCorrectionText(failures) {
 * copy resolves identically on every host.
 *
 * @param text - the correction text.
+* @param sessionFormatVersion - the format recorded by the active session.
 * @returns a frozen user message attributed to this plugin as a notice.
 */
-function createFeedbackMessage(text) {
+function createFeedbackMessage(text, sessionFormatVersion) {
+	const source = sessionFormatVersion >= 4 ? {
+		kind: FEEDBACK_SOURCE_KIND,
+		form: "notice",
+		summary: "genui fence repair requested"
+	} : {
+		kind: "plugin",
+		plugin: FEEDBACK_PLUGIN_NAME,
+		form: "notice",
+		summary: "genui fence repair requested"
+	};
 	const message = {
 		id: randomUUID(),
 		role: "user",
@@ -4078,12 +4282,7 @@ function createFeedbackMessage(text) {
 			type: "text",
 			text
 		}],
-		source: {
-			kind: "plugin",
-			plugin: FEEDBACK_PLUGIN_NAME,
-			form: "notice",
-			summary: "genui fence repair requested"
-		}
+		source
 	};
 	Object.freeze(message.content);
 	return Object.freeze(message);
@@ -4135,6 +4334,10 @@ function markersIn(text) {
 	}
 	return out;
 }
+/** Identify this plugin's source across current and migrated session shapes. */
+function isFeedbackSource(source) {
+	return source?.kind === FEEDBACK_SOURCE_KIND || source?.kind === "plugin" && source.plugin === "@changfenhuang/dsh-genui";
+}
 /**
 * 根据插件配置启用围栏反馈流程。
 *
@@ -4173,7 +4376,7 @@ function installFenceFeedback(ctx, enabled) {
 		}
 		if (event.type !== "user/message") return;
 		const data = event.data;
-		if (data.source?.kind === "plugin" && data.source.plugin === "@changfenhuang/dsh-genui") {
+		if (isFeedbackSource(data.source)) {
 			const fingerprints = markersIn(textOfContent(data.content));
 			if (fingerprints.length === 0) return;
 			const state = stateOf(sessionId);
@@ -4198,7 +4401,7 @@ function installFenceFeedback(ctx, enabled) {
 		for (const fingerprint of plan.fingerprints) state.corrected.add(fingerprint);
 		state.lastCorrectedTurn = plan.turn;
 		try {
-			agent.steer(createFeedbackMessage(plan.text));
+			agent.steer(createFeedbackMessage(plan.text, agent.session.header.version));
 		} catch (error) {
 			ctx.logger?.warn?.(`dsh-genui: fence feedback steering failed (${error instanceof Error ? error.message : String(error)})`);
 		}
@@ -4281,8 +4484,8 @@ Allowed \`type\` values; the \`genui\` skill, when available, carries the full c
 **默认就该出 UI**：出现下列情况至少出一个围栏：
 - ≥3 条并列要点 → \`list\`；数字对比 → \`table\`；指标/进度/状态 → \`stat\`/\`progress\`/\`badge\`
 - 步骤/时间线 → \`steps\`/\`timeline\`/\`mermaid\`；架构/流程 → \`diagram\` 或 \`mermaid\`；风险/结论 → \`callout\`；代码/改动 → \`code\`/\`diff\`/\`json\`
-- 行内富文本：\`text\`/\`list\`/表格文本列/\`keyvalue\`/\`callout\` 里可写 $公式$、$$块公式$$、\`code\`、**加粗**、==高亮==、[文字](url)。
-- 默认无卡 ≠ 少用组件：硬触发照常出组件，**组件多不是问题**——判据是每个组件承载不同信息、有焦点与层次。卡片只用于并排项与数据对象；单段文字用「标题 + 正文 + 间距」。
+- 行内富文本：支持公式、\`code\`、加粗、高亮、链接；禁用 Markdown table / fenced code，改用 table / code / diff / json。
+- 默认无卡：按触发条件使用组件，每个组件承载不同信息；卡片只用于并排项与数据对象，单段文字用标题、正文与间距。
 
 **发回答前最后自检一次**：这段内容里有没有 ≥3 条并列要点、任何对比、任何数字/指标、任何步骤或流程？有就先转成组件再开口。**状态汇报、进度说明、提交与改动清单同样算**。
 - 趋势/占比 → \`chart\`（≤8 点）或 \`echart\`（多序列/要交互时）；配色默认跟随主题，只有语义需要时才用 \`palette\`/\`card.accent\`；grid 子节点用 \`"span":2\` 跨列做宽窄混排；数据多时给 \`table\`/\`chart\`/\`list\` 配一个 \`input\`(id) + \`filter\` 绑定，读者能就地筛选。
@@ -4293,7 +4496,8 @@ Allowed \`type\` values; the \`genui\` skill, when available, carries the full c
 
 Rules:
 - LANGUAGE: reply+UI=conversation language; schema fixed. NEVER infer it from prompt/skill/examples/tools. Replace \`<user-language ...>\`; never emit these placeholders literally.
-- JSON 严格: 坏组件被丢弃、坏围栏降级为代码块；≥3 节点或含 table 的围栏发出前必须调 validate_dsh_ui，按结构化诊断修好再发；小围栏字段没把握也必须先验证。
+- JSON 严格：坏组件被丢弃，坏围栏变代码块；≥3 节点或含 table 时调 validate_dsh_ui，按诊断修改并重验；小围栏字段存疑也先验证。
+- warning=block_markdown：按 replacement 改写并重验。
 - 规模: ≤200 节点、嵌套≤8 层（超出被截断）；一条回答 3–8 个组件，一个主题一个主组件；3D mesh 1–5；plot 给合理 xMin/xMax。
 - LOCAL-FIRST + actions: UI 能自己做的状态变化（判卷、判题、重置、展开、选中）就地完成，零往返；action 只用于必须模型参与的事。交互组件带 "action":"name"，交互以 [genui-action] name + 组件数据回传，届时重渲染更新 UI；无 action 的按钮禁用。
 - Durable state: 交互状态按「会话+内容指纹」持久化——刷新/重放恢复；重渲染相同内容保留，新内容重置。

package/lib/types/client/artifact/ExportableGenuiBlock.d.ts

@@ -0,0 +1,6 @@
+import type { GenuiBlockProps } from '../blocks/state.ts';
+export interface ExportableGenuiBlockProps extends GenuiBlockProps {
+    exportEnabled?: boolean;
+}
+/** 在完成态 GenUI 外层显示 artifact 导出菜单。 */
+export declare function ExportableGenuiBlock(props: ExportableGenuiBlockProps): import("react").JSX.Element;

package/lib/types/client/artifact/create.d.ts

@@ -0,0 +1,5 @@
+import type { BlockInteractionState } from '../interaction-store.ts';
+import type { GenuiSpec } from '../spec.ts';
+import { type CreateGenuiArtifactOptions, type GenuiArtifactV1 } from './types.ts';
+/** 创建规范化 artifact，并清除密码默认值及对应的持久化字段。 */
+export declare function createGenuiArtifact(spec: GenuiSpec, state?: BlockInteractionState, options?: CreateGenuiArtifactOptions): GenuiArtifactV1;

package/lib/types/client/artifact/download.d.ts

@@ -0,0 +1,9 @@
+import { type GenuiArtifactV1 } from './types.ts';
+/** 过滤文件名中的路径符号、控制字符和危险标点。 */
+export declare function sanitizeArtifactFilename(title: string | undefined, extension: '.html' | '.genui.json'): string;
+/** 触发浏览器下载并释放临时地址。 */
+export declare function downloadBlob(blob: Blob, filename: string): void;
+/** 下载规范化 GenUI JSON artifact。 */
+export declare function downloadGenuiArtifactJson(artifact: GenuiArtifactV1): void;
+/** 生成并下载独立 HTML。 */
+export declare function downloadGenuiArtifactHtml(artifact: GenuiArtifactV1): Promise<void>;

package/lib/types/client/artifact/html.d.ts

@@ -0,0 +1,5 @@
+import { type GenuiArtifactV1 } from './types.ts';
+/** 使用已下载的运行文件生成完整的独立 HTML 文档。 */
+export declare function createStandaloneHtmlDocument(artifact: GenuiArtifactV1, bundles: ReadonlyMap<string, Uint8Array>, baseURI?: string): string;
+/** 获取独立运行文件及规格实际使用的图形引擎，生成单文件 HTML。 */
+export declare function buildStandaloneHtml(rawArtifact: GenuiArtifactV1): Promise<string>;

package/lib/types/client/artifact/index.d.ts

@@ -0,0 +1,8 @@
+export { createGenuiArtifact } from './create.ts';
+export { buildStandaloneHtml } from './html.ts';
+export { downloadGenuiArtifactHtml, downloadGenuiArtifactJson } from './download.ts';
+export { parseGenuiArtifact } from './parse.ts';
+export { analyzeGenuiPortability } from './portability.ts';
+export { serializeGenuiArtifact } from './json.ts';
+export { GenuiExportError } from './types.ts';
+export type { CreateGenuiArtifactOptions, GenuiArtifactTheme, GenuiArtifactV1, GenuiExportErrorCode, GenuiPortabilityReport, GenuiStandaloneAsset, } from './types.ts';

package/lib/types/client/artifact/json.d.ts

@@ -0,0 +1,3 @@
+import type { GenuiArtifactV1 } from './types.ts';
+/** 以稳定缩进序列化 GenUI artifact。 */
+export declare function serializeGenuiArtifact(artifact: GenuiArtifactV1): string;

package/lib/types/client/artifact/parse.d.ts

@@ -0,0 +1,3 @@
+import { type GenuiArtifactV1 } from './types.ts';
+/** 校验 artifact 格式并重新执行当前 GenUI 规范化流程。 */
+export declare function parseGenuiArtifact(value: unknown): GenuiArtifactV1 | null;

package/lib/types/client/artifact/portability.d.ts

@@ -0,0 +1,4 @@
+import type { GenuiSpec } from '../spec.ts';
+import type { GenuiPortabilityReport } from './types.ts';
+/** 扫描嵌套 GenUI 节点，选择运行资源并列出独立页面限制。 */
+export declare function analyzeGenuiPortability(spec: GenuiSpec): GenuiPortabilityReport;

package/lib/types/client/artifact/standalone-theme.d.ts

@@ -0,0 +1,2 @@
+/** standalone 页面使用的基础颜色和版面样式。 */
+export declare const STANDALONE_THEME_CSS = "\n:root {\n  color-scheme: light;\n  --dsw-static-neutral-bluish-00: rgb(255, 255, 255);\n  --dsw-static-neutral-bluish-50: rgb(249, 250, 251);\n  --dsw-static-neutral-bluish-300: rgb(207, 211, 214);\n  --dsw-static-neutral-bluish-400: rgb(173, 178, 184);\n  --dsw-static-neutral-bluish-600: rgb(129, 133, 140);\n  --dsw-static-neutral-bluish-700: rgb(97, 102, 107);\n  --dsw-static-neutral-bluish-800: rgb(53, 54, 56);\n  --dsw-static-neutral-bluish-850: rgb(44, 44, 46);\n  --dsw-static-neutral-bluish-875: rgb(35, 35, 36);\n  --dsw-static-neutral-bluish-900: rgb(27, 27, 28);\n  --dsw-static-neutral-bluish-950: rgb(21, 21, 23);\n  --dsw-static-neutral-bluish-1000: rgb(15, 17, 21);\n  --dsw-alias-bg-base: var(--dsw-static-neutral-bluish-00);\n  --dsw-alias-bg-layer-1: var(--dsw-static-neutral-bluish-00);\n  --dsw-alias-bg-layer-2: var(--dsw-static-neutral-bluish-00);\n  --dsw-alias-bg-layer-3: var(--dsw-static-neutral-bluish-00);\n  --dsw-alias-border-l1: rgba(0, 0, 0, 0.04);\n  --dsw-alias-border-l2: rgba(0, 0, 0, 0.1);\n  --dsw-alias-fill-hover: #eef2f7;\n  --dsw-alias-label-primary: var(--dsw-static-neutral-bluish-1000);\n  --dsw-alias-label-secondary: var(--dsw-static-neutral-bluish-700);\n  --dsw-alias-label-tertiary: var(--dsw-static-neutral-bluish-600);\n  --dsw-alias-label-caption: var(--dsw-static-neutral-bluish-400);\n  --dsw-alias-markdown-code-block: var(--dsw-static-neutral-bluish-50);\n  --dsw-alias-markdown-hr: #cbd5e1;\n  /* DSH \u9759\u6001\u8C03\u8272\u677F\u4F9B\u8BED\u4E49\u72B6\u6001\u522B\u540D\u4F7F\u7528\u3002 */\n  --dsw-static-deepseek-100: rgb(228, 237, 253);\n  --dsw-static-deepseek-400: rgb(122, 170, 255);\n  --dsw-static-deepseek-500: rgb(65, 118, 230);\n  --dsw-static-deepseek-800: rgb(52, 65, 91);\n  --dsw-static-green-100: rgb(230, 250, 237);\n  --dsw-static-green-400: rgb(78, 209, 126);\n  --dsw-static-green-500: rgb(34, 197, 94);\n  --dsw-static-green-900: rgb(35, 60, 44);\n  --dsw-static-amber-100: rgb(254, 245, 231);\n  --dsw-static-amber-400: rgb(247, 173, 49);\n  --dsw-static-amber-500: rgb(245, 158, 11);\n  --dsw-static-amber-600: rgb(221, 134, 41);\n  --dsw-static-amber-900: rgb(39, 36, 31);\n  --dsw-static-red-400: rgb(242, 90, 90);\n  --dsw-static-red-600: rgb(236, 19, 19);\n\n  /* DSH \u6D45\u8272\u4E3B\u9898\u8BED\u4E49\u72B6\u6001\u522B\u540D\u3002 */\n  --dsw-alias-state-business-primary: var(--dsw-static-deepseek-500);\n  --dsw-alias-state-business-tertiary: var(--dsw-static-deepseek-100);\n  --dsw-alias-state-success-primary: var(--dsw-static-green-500);\n  --dsw-alias-state-success-secondary: var(--dsw-static-green-400);\n  --dsw-alias-state-success-tertiary: var(--dsw-static-green-100);\n  --dsw-alias-state-warn-label: var(--dsw-static-amber-600);\n  --dsw-alias-state-warn-primary: var(--dsw-static-amber-500);\n  --dsw-alias-state-warn-secondary: var(--dsw-static-amber-400);\n  --dsw-alias-state-warn-tertiary: var(--dsw-static-amber-100);\n  --dsw-alias-state-error-primary: var(--dsw-static-red-600);\n  --dsw-alias-state-error-secondary: var(--dsw-static-red-400);\n  --dsw-static-deepseek-300: rgb(183, 200, 254);\n  --dsw-static-deepseek-450: rgb(86, 134, 254);\n  --dsw-static-blue-450: rgb(77, 147, 248);\n}\nbody[data-ds-dark-theme] {\n  color-scheme: dark;\n  --dsw-alias-bg-base: var(--dsw-static-neutral-bluish-950);\n  --dsw-alias-bg-layer-1: var(--dsw-static-neutral-bluish-875);\n  --dsw-alias-bg-layer-2: var(--dsw-static-neutral-bluish-850);\n  --dsw-alias-bg-layer-3: var(--dsw-static-neutral-bluish-800);\n  --dsw-alias-border-l1: rgba(255, 255, 255, 0.06);\n  --dsw-alias-border-l2: rgba(255, 255, 255, 0.12);\n  --dsw-alias-fill-hover: #2b3542;\n  --dsw-alias-label-primary: var(--dsw-static-neutral-bluish-50);\n  --dsw-alias-label-secondary: var(--dsw-static-neutral-bluish-300);\n  --dsw-alias-label-tertiary: var(--dsw-static-neutral-bluish-400);\n  --dsw-alias-label-caption: var(--dsw-static-neutral-bluish-600);\n  --dsw-alias-markdown-code-block: var(--dsw-static-neutral-bluish-900);\n  --dsw-alias-markdown-hr: #465365;\n  /* DSH \u6DF1\u8272\u4E3B\u9898\u8BED\u4E49\u72B6\u6001\u522B\u540D\u3002 */\n  --dsw-alias-state-business-primary: var(--dsw-static-deepseek-400);\n  --dsw-alias-state-business-tertiary: var(--dsw-static-deepseek-800);\n  --dsw-alias-state-success-primary: var(--dsw-static-green-500);\n  --dsw-alias-state-success-secondary: var(--dsw-static-green-400);\n  --dsw-alias-state-success-tertiary: var(--dsw-static-green-900);\n  --dsw-alias-state-warn-label: var(--dsw-static-amber-600);\n  --dsw-alias-state-warn-primary: var(--dsw-static-amber-500);\n  --dsw-alias-state-warn-secondary: var(--dsw-static-amber-400);\n  --dsw-alias-state-warn-tertiary: var(--dsw-static-amber-900);\n  --dsw-alias-state-error-primary: var(--dsw-static-red-400);\n  --dsw-alias-state-error-secondary: var(--dsw-static-red-400);\n}\nhtml { min-height: 100%; }\nbody { margin: 0; min-height: 100vh; background: var(--dsw-alias-bg-base); color: var(--dsw-alias-label-primary); font-family: system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; }\n#genui-root { width: min(1200px, calc(100% - 32px)); margin: 0 auto; padding: 32px 0 56px; }\n";

package/lib/types/client/artifact/types.d.ts

@@ -0,0 +1,33 @@
+import type { LocaleId } from '../i18n/runtime.ts';
+import type { GenuiSpec } from '../spec.ts';
+import type { BlockInteractionState } from '../interaction-store.ts';
+export declare const GENUI_ARTIFACT_FORMAT = "dsh-genui";
+export declare const GENUI_ARTIFACT_VERSION: 1;
+export type GenuiArtifactTheme = 'light' | 'dark';
+export type GenuiStandaloneAsset = 'mermaid' | 'three' | 'echarts-core' | 'echarts-full';
+export interface GenuiArtifactV1 {
+    format: typeof GENUI_ARTIFACT_FORMAT;
+    version: typeof GENUI_ARTIFACT_VERSION;
+    spec: GenuiSpec;
+    state?: BlockInteractionState;
+    presentation: {
+        locale: LocaleId;
+        theme: GenuiArtifactTheme;
+    };
+}
+export interface GenuiPortabilityReport {
+    requiredAssets: GenuiStandaloneAsset[];
+    customTypes: string[];
+    externalMedia: string[];
+    hasModelActions: boolean;
+}
+export type GenuiExportErrorCode = 'unsupported-custom-component' | 'runtime-fetch-failed' | 'asset-fetch-failed' | 'artifact-invalid' | 'download-failed';
+/** 导出流程遇到可供界面识别的错误时使用。 */
+export declare class GenuiExportError extends Error {
+    readonly code: GenuiExportErrorCode;
+    constructor(code: GenuiExportErrorCode, message: string);
+}
+export interface CreateGenuiArtifactOptions {
+    locale?: LocaleId;
+    theme?: GenuiArtifactTheme;
+}

package/lib/types/client/blocks/state.d.ts

@@ -30,6 +30,8 @@ export interface GenuiBlockProps {
     /** Native hosts own durable state instead of the browser store. Read once per stateKey. */
     initialState?: BlockInteractionState | undefined;
     onStateChange?: ((state: BlockInteractionState) => void) | undefined;
+    /** Observe the current secret-free durable state without changing persistence ownership. */
+    onStateSnapshot?: ((state: BlockInteractionState) => void) | undefined;
 }
 /** Per-question metadata registered by grouped radios for local grading. */
 export interface QuestionMeta {

package/lib/types/client/echarts-engine.d.ts

@@ -0,0 +1,4 @@
+import type { GenuiEChart } from './spec.ts';
+export declare const CORE_PRESETS: ReadonlySet<string>;
+/** 依照 renderer 共用的 preset 规则选择 ECharts 资源。 */
+export declare function echartEngineFor(node: GenuiEChart): 'echarts-core' | 'echarts-full';

package/lib/types/client/echarts-lazy.d.ts

@@ -1,3 +1,4 @@
+export { CORE_PRESETS } from './echarts-engine.ts';
 /** The ECharts instance surface (the subset the component uses). */
 export interface EChartsInstance {
     setOption: (opt: unknown, notMerge?: boolean) => void;
@@ -15,6 +16,3 @@ export interface EChartsInstance {
 export declare function createChart(el: HTMLElement, option: unknown, opts?: {
     height?: number;
 }, engine?: 'core' | 'full'): Promise<EChartsInstance>;
-/** Presets the core bundle can draw; anything else (or a raw `option`) needs
- *  the full engine. Kept next to the loader so the split stays in one place. */
-export declare const CORE_PRESETS: ReadonlySet<string>;

package/lib/types/client/embed.d.ts

@@ -6,3 +6,5 @@ export { isRenderableProcess, processGenuiSpec } from './guard.ts';
 export { setGenuiAssetBase } from './asset-loader.ts';
 export type { GenuiSpec } from './spec.ts';
 export type { BlockInteractionState } from './interaction-store.ts';
+export { analyzeGenuiPortability, buildStandaloneHtml, createGenuiArtifact, downloadGenuiArtifactHtml, downloadGenuiArtifactJson, parseGenuiArtifact, serializeGenuiArtifact, } from './artifact/index.ts';
+export type { GenuiArtifactV1, GenuiPortabilityReport } from './artifact/index.ts';

package/lib/types/client/i18n/en.d.ts

@@ -9,6 +9,12 @@
  * `block.*`, `err.*`.
  */
 export declare const EN: {
+    readonly 'artifact.export': "Export";
+    readonly 'artifact.exportHtml': "HTML";
+    readonly 'artifact.exportJson': "GenUI JSON";
+    readonly 'artifact.exportFailed': "Export failed. Try again.";
+    readonly 'artifact.unsupportedCustom': "Cannot export HTML because the standalone runtime cannot render custom components: {types}. Export GenUI JSON to preserve these nodes.";
+    readonly 'artifact.externalMediaNotice': "External media may not appear when this file is opened offline.";
     readonly 'panel.badge': "Panel";
     readonly 'panel.title.default': "GenUI panel";
     readonly 'panel.title.explore': "GenUI explorer";

package/lib/types/client/primitive-adapter.d.ts

@@ -0,0 +1,4 @@
+export { CodeBlock, DiffBlock, JsonTree, writeClipboard } from '@deepseek-ai/dsh-client-ui-primitives';
+export type { DiffBlockLabels, JsonTreeLabels } from '@deepseek-ai/dsh-client-ui-primitives';
+export declare const getGenuiComponent: ((type: string) => unknown) | undefined;
+export declare const GenuiActionContext: unknown;

package/lib/types/client/primitive-labels.d.ts

@@ -6,7 +6,7 @@
  * module load — a language switch must reach a diff or JSON tree that is
  * already on screen.
  */
-import type { DiffBlockLabels, JsonTreeLabels } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { DiffBlockLabels, JsonTreeLabels } from './primitive-adapter.ts';
 /** Chrome labels for an inline GenUI diff block, in the active locale. */
 export declare function diffBlockLabels(): DiffBlockLabels;
 /** Copy labels for a code block rendered inside a GenUI fence or node. */

package/lib/types/client/standalone/asset-loader.d.ts

@@ -0,0 +1,2 @@
+/** 从启动代码预先载入的全局资源读取引擎。 */
+export declare function loadGenuiAsset<T>(name: 'mermaid' | 'three' | 'echarts-core' | 'echarts-full'): Promise<T>;

package/lib/types/client/standalone/bootstrap-types.d.ts

@@ -0,0 +1,9 @@
+import type { GenuiArtifactV1 } from '../artifact/types.ts';
+declare global {
+    interface Window {
+        __GenuiStandalone__?: {
+            mount(root: HTMLElement, artifact: GenuiArtifactV1): () => void;
+        };
+    }
+}
+export {};

package/lib/types/client/standalone/katex-style.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/client/standalone/primitive-adapter.d.ts

@@ -0,0 +1,54 @@
+import { type ReactNode } from 'react';
+export interface DiffBlockLabels {
+    copy: string;
+    copied: string;
+    codeLabel: string;
+    wrapLabel: string;
+    unwrapLabel: string;
+    collapseAria: string;
+    expandAria: (hidden: number) => string;
+    collapse: string;
+    expand: (hidden: number) => string;
+    files: (count: number) => string;
+}
+export interface JsonTreeLabels {
+    copyValue: string;
+    copyJson: string;
+    copyPath: string;
+    copyPrettyJson: string;
+    copyCompactJson: string;
+    copied: string;
+    copyFailed: string;
+    collapseNode: string;
+    expandNode: string;
+    copyButtonTitle: (action: string) => string;
+}
+/** 在独立页面显示可复制的代码内容。 */
+export declare function CodeBlock({ code, lang, copyLabel, copiedLabel }: {
+    code: string;
+    lang?: string;
+    copyLabel?: string;
+    copiedLabel?: string;
+}): ReactNode;
+/** 在独立页面以差异文本显示文件变更。 */
+export declare function DiffBlock({ diffs }: {
+    diffs: Array<{
+        path: string;
+        oldText?: string;
+        newText?: string;
+    }>;
+    labels?: DiffBlockLabels;
+}): ReactNode;
+/** 在独立页面显示 JSON，并提供本地折叠控制。 */
+export declare function JsonTree({ data, label, copyable, labels }: {
+    data: object | unknown[];
+    label?: string;
+    copyable?: boolean;
+    labels?: JsonTreeLabels;
+}): ReactNode;
+/** 将文本复制到系统剪贴板。 */
+export declare function writeClipboard(text: string): Promise<boolean>;
+/** standalone 模式不连接 DSH 注册表，因此自定义组件始终不可用。 */
+export declare function getGenuiComponent(_type: string): undefined;
+/** standalone 模式专用的空动作上下文。 */
+export declare const GenuiActionContext: import("react").Context<((action: string, payload: Record<string, unknown>) => void) | undefined>;

package/lib/types/client/standalone/runtime.d.ts

@@ -0,0 +1,2 @@
+import './katex-style.ts';
+import './bootstrap-types.ts';

package/lib/types/plugin/fence-feedback.d.ts

@@ -26,6 +26,8 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { UserMessage } from '@deepseek-ai/dsh-session';
 /** Plugin name recorded on every message this loop steers. */
 export declare const FEEDBACK_PLUGIN_NAME = "@changfenhuang/dsh-genui";
+/** Source kind persisted by this plugin in Session format v4. */
+export declare const FEEDBACK_SOURCE_KIND: "plugin:@changfenhuang/dsh-genui";
 /** One ```dsh-ui fence found in an assistant reply. */
 export interface ExtractedFence {
     /** Raw body between the fences (no delimiters). */
@@ -74,9 +76,10 @@ export declare function fenceCorrectionText(failures: readonly FenceFailure[]):
  * copy resolves identically on every host.
  *
  * @param text - the correction text.
+ * @param sessionFormatVersion - the format recorded by the active session.
  * @returns a frozen user message attributed to this plugin as a notice.
  */
-export declare function createFeedbackMessage(text: string): UserMessage;
+export declare function createFeedbackMessage(text: string, sessionFormatVersion: number): UserMessage;
 /** What the pure planner needs to decide whether a correction may be sent. */
 export interface FenceFeedbackPlanInput {
     readonly text: string;