@webskill/sdk 0.22.0 → 0.24.0

package/dist/{openUiSpecLang-BSYYnjay.js → openUiSpecLang-DIcLcybq.js}

@@ -45,6 +45,88 @@ function resolveChartFontSizes(sizes) {
 		...sizes
 	};
 }
+/**
+* 颜色回落值的**全仓唯一来源**：逐项照抄 echarts 6 的现行默认
+* （primary `#3c3c41`、secondary/axisLabel `#54555a`、axisSplitLine `#dbdee4`）。
+*
+* 照抄而不是另调一套，是为了让「读不到计算样式」这条路径与 0.24.0 之前逐像素相同。
+*/
+const DEFAULT_CHART_COLORS = {
+	title: "#3c3c41",
+	axisLabel: "#54555a",
+	legend: "#54555a",
+	axisLine: "#54555a",
+	splitLine: "#dbdee4"
+};
+/** 逐字段兜底：宿主通常只想改其中一两项 */
+function resolveChartColors(colors) {
+	return {
+		...DEFAULT_CHART_COLORS,
+		...colors
+	};
+}
+/**
+* 两个 alpha 不是拍的，是从 echarts 默认反推的：黑字浅底下
+* 0.65 合成 `#595959`（对 `#54555a`）、0.15 合成 `#d9d9d9`（对 `#dbdee4`）。
+* 取这两个值，浅色宿主上的轴线与网格线几乎与以往一样，深色宿主上自动变成同色低透明度。
+*/
+const AXIS_LINE_ALPHA = .65;
+const SPLIT_LINE_ALPHA = .15;
+/** 计算值是 `rgb()` / `rgba()` 时的快路径；认不出返回 undefined，**不猜** */
+function parseRgb(value) {
+	if (typeof value !== "string") return void 0;
+	const match = /^rgba?\(([^)]+)\)$/.exec(value.trim());
+	if (!match) return void 0;
+	const parts = match[1].split(/[,\s/]+/).map((part) => part.trim()).filter((part) => part !== "");
+	if (parts.length < 3) return void 0;
+	const channels = parts.slice(0, 3).map((part) => Number.parseFloat(part));
+	if (channels.some((channel) => !Number.isFinite(channel))) return void 0;
+	return channels;
+}
+/**
+* 计算值不是 `rgb()` 写法时的慢路径：让浏览器自己画一个像素再读回来。
+*
+* CSSOM 早年确实只吐 `rgb()`，但主题变量现在普遍是 `oklch()`（Tailwind v4 即是），
+* 计算值会**原样保留**那种写法。只认 `rgb()` 的话，暗色主题下整张图会悄悄回落到
+* 浅灰默认色——正是分册 14 要修的「看不清」。
+* 这里不自己写色彩空间换算：换算表抄错一位没人看得出来，而 canvas 用的就是
+* 浏览器那份实现，认得出的颜色它都认得。
+*/
+function probeRgb(container, value) {
+	if (typeof value !== "string" || value.trim() === "") return void 0;
+	const view = container.ownerDocument?.defaultView;
+	if (typeof view?.CSS?.supports === "function" && !view.CSS.supports("color", value)) return void 0;
+	const canvas = container.ownerDocument?.createElement("canvas");
+	if (!canvas) return void 0;
+	canvas.width = 1;
+	canvas.height = 1;
+	const ctx = canvas.getContext("2d");
+	if (!ctx) return void 0;
+	ctx.fillStyle = value;
+	ctx.fillRect(0, 0, 1, 1);
+	const pixel = ctx.getImageData(0, 0, 1, 1).data;
+	if (pixel[3] === 0) return void 0;
+	return [
+		pixel[0],
+		pixel[1],
+		pixel[2]
+	];
+}
+/** 画布够不到 CSS，所以把容器的计算 `color` 当作这张图的取色依据（需求 14 §2.1） */
+function chartColorsFromContainer(container) {
+	const computed = container.ownerDocument?.defaultView?.getComputedStyle(container);
+	const rgb = parseRgb(computed?.color) ?? probeRgb(container, computed?.color);
+	if (!rgb) return void 0;
+	const [r, g, b] = rgb;
+	const at = (alpha) => `rgba(${r}, ${g}, ${b}, ${alpha})`;
+	return {
+		title: at(1),
+		legend: at(1),
+		axisLabel: at(1),
+		axisLine: at(AXIS_LINE_ALPHA),
+		splitLine: at(SPLIT_LINE_ALPHA)
+	};
+}
 /** echarts 的图例条目来源：饼图按标签分项，其余按系列名 */
 const legendEntries = (chart) => chart.kind === "pie" ? chart.labels : seriesNames(chart);
 /**
@@ -68,32 +150,52 @@ const SERIES_SHAPE = {
 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) {
+function toEchartsOption(chart, fontSizes, colors) {
 	const font = resolveChartFontSizes(fontSizes);
+	const color = resolveChartColors(colors);
 	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 }
+		axisLabel: {
+			fontSize: font.axisLabel,
+			color: color.axisLabel
+		},
+		axisLine: { lineStyle: { color: color.axisLine } },
+		splitLine: { lineStyle: { color: color.splitLine } }
 	};
 	return {
 		animation: false,
 		title: chart.title || notice ? {
 			text: chart.title ?? "",
 			left: "center",
-			textStyle: { fontSize: font.title },
-			...notice ? { subtext: notice } : {}
+			textStyle: {
+				fontSize: font.title,
+				color: color.title
+			},
+			...notice ? {
+				subtext: notice,
+				subtextStyle: { color: color.axisLabel }
+			} : {}
 		} : void 0,
 		tooltip: { trigger: chart.kind === "pie" ? "item" : "axis" },
 		legend: {
 			bottom: 0,
-			textStyle: { fontSize: font.legend }
+			textStyle: {
+				fontSize: font.legend,
+				color: color.legend
+			}
 		},
 		xAxis: chart.kind === "pie" ? void 0 : {
 			type: "category",
 			data: chart.labels,
-			axisLabel: { fontSize: font.axisLabel }
+			axisLabel: {
+				fontSize: font.axisLabel,
+				color: color.axisLabel
+			},
+			axisLine: { lineStyle: { color: color.axisLine } },
+			splitLine: { lineStyle: { color: color.splitLine } }
 		},
 		yAxis: chart.kind === "pie" ? void 0 : chart.kind === "dual-axis" ? [valueAxis, { ...valueAxis }] : valueAxis,
 		series: chart.kind === "pie" ? chart.series.map((series) => ({
@@ -128,6 +230,7 @@ function applyChartDomContract(container, chart) {
 */
 let echartsModule;
 const loadEcharts = () => echartsModule ??= import("./echarts-BE7oV_Dl.js");
+const sameColors = (a, b) => a === b || a !== void 0 && b !== void 0 && a.title === b.title && a.axisLabel === b.axisLabel && a.legend === b.legend && a.axisLine === b.axisLine && a.splitLine === b.splitLine;
 /**
 * 框架无关的 echarts 挂载点：三档的 React 组件与 A2UI 档的 Lit 元素共用同一实现，
 * 图表不再因档位而异。echarts 走动态 import，不打进首屏。
@@ -137,12 +240,40 @@ function mountEchart(container) {
 	let instance;
 	let queued;
 	let observer;
-	const apply = (chart, fontSizes) => {
-		instance?.setOption(toEchartsOption(chart, fontSizes), {
+	let themeObserver;
+	let inherited;
+	const apply = (chart, fontSizes, colors) => {
+		inherited = chartColorsFromContainer(container);
+		const effective = colors ? {
+			...inherited,
+			...colors
+		} : inherited;
+		instance?.setOption(toEchartsOption(chart, fontSizes, effective), {
 			notMerge: true,
 			lazyUpdate: true
 		});
 	};
+	/**
+	* 主题切换改的是祖先链上的 class（ThemeScope）或根节点属性（扩展 viewer），
+	* 两者都表现为祖先的属性变更。观察一条从容器到 documentElement 的链，
+	* 命中就重算一次颜色；颜色没变则什么都不做（避免无谓重绘）。
+	*/
+	const watchAncestors = () => {
+		if (typeof MutationObserver === "undefined") return;
+		themeObserver = new MutationObserver(() => {
+			if (disposed || queued === void 0) return;
+			if (sameColors(chartColorsFromContainer(container), inherited)) return;
+			apply(queued.chart, queued.fontSizes, queued.colors);
+		});
+		for (let node = container; node; node = node.parentElement) themeObserver.observe(node, {
+			attributes: true,
+			attributeFilter: [
+				"class",
+				"style",
+				"data-theme"
+			]
+		});
+	};
 	loadEcharts().then((echarts) => {
 		if (disposed) return;
 		instance = echarts.init(container);
@@ -150,21 +281,25 @@ function mountEchart(container) {
 			observer = new ResizeObserver(() => instance?.resize());
 			observer.observe(container);
 		}
-		if (queued) apply(queued.chart, queued.fontSizes);
+		watchAncestors();
+		if (queued) apply(queued.chart, queued.fontSizes, queued.colors);
 	});
 	return {
-		setChart(chart, fontSizes) {
+		setChart(chart, fontSizes, colors) {
 			applyChartDomContract(container, chart);
 			queued = {
 				chart,
-				...fontSizes ? { fontSizes } : {}
+				...fontSizes ? { fontSizes } : {},
+				...colors ? { colors } : {}
 			};
-			apply(chart, fontSizes);
+			apply(chart, fontSizes, colors);
 		},
 		dispose() {
 			disposed = true;
 			observer?.disconnect();
 			observer = void 0;
+			themeObserver?.disconnect();
+			themeObserver = void 0;
 			instance?.dispose();
 			instance = void 0;
 		}
@@ -1900,4 +2035,4 @@ function toOpenUiSpecLang(spec, catalog = uiCatalog) {
 }
 
 //#endregion
-export { DEFAULT_CHART_FONT_SIZES as C, toEchartsOption as D, resolveChartFontSizes as E, gaugePercent as S, mountEchart as T, defineUiCatalog as _, SPEC_TABLE_MIN_COLUMN_VAR as a, CATALOG_SCHEMA_MAX as b, resolveColumnWidths as c, collectFormScopes as d, collectScopedValues as f, uiCatalog as g, UI_CATALOG_PROMPT_BUDGET_BYTES as h, normalizeFieldOptions as i, MAX_CONDITION_DEPTH as l, UI_CATALOG_GROUPS as m, interactionToUiSpec as n, SPEC_TABLE_MIN_COLUMN_WIDTH as o, qualifyFieldName as p, toJsonRenderSpec as r, normalizeColumnWidths as s, toOpenUiSpecLang as t, evaluateFieldCondition as u, CATALOG_BUDGET_STAGE as v, chartSpecFromProps as w, PLANNED_INCREMENT as x, CATALOG_PROMPT_MAX as y };
+export { DEFAULT_CHART_COLORS as C, resolveChartColors as D, mountEchart as E, resolveChartFontSizes as O, gaugePercent as S, chartSpecFromProps as T, defineUiCatalog as _, SPEC_TABLE_MIN_COLUMN_VAR as a, CATALOG_SCHEMA_MAX as b, resolveColumnWidths as c, collectFormScopes as d, collectScopedValues as f, uiCatalog as g, UI_CATALOG_PROMPT_BUDGET_BYTES as h, normalizeFieldOptions as i, toEchartsOption as k, MAX_CONDITION_DEPTH as l, UI_CATALOG_GROUPS as m, interactionToUiSpec as n, SPEC_TABLE_MIN_COLUMN_WIDTH as o, qualifyFieldName as p, toJsonRenderSpec as r, normalizeColumnWidths as s, toOpenUiSpecLang as t, evaluateFieldCondition as u, CATALOG_BUDGET_STAGE as v, DEFAULT_CHART_FONT_SIZES as w, PLANNED_INCREMENT as x, CATALOG_PROMPT_MAX as y };

package/dist/{pathSecurity-B1owvJAF.js → pathSecurity-CirkQwWP.js}

@@ -20,6 +20,17 @@ async function atomicWriteText(fs, path, content) {
 	await fs.writeText(tmp, content);
 	await fs.rename(tmp, path);
 }
+/**
+* 原子写二进制：与 `atomicWriteText` 逐字对称，只换写入方法（0.23.0 分册 20）。
+*
+* 临时名必须沿用同一条 `ATOMIC_TMP_SUFFIX_PATTERN` 形状——打包与列举侧靠那条正则
+* 排除中断残留，另起一套命名会让残留的临时文件被打进技能包。
+*/
+async function atomicWriteBinary(fs, path, content) {
+	const tmp = `${path}.tmp-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+	await fs.writeBinary(tmp, content);
+	await fs.rename(tmp, path);
+}
 
 //#endregion
 //#region ../core/src/fs/pathSecurity.ts
@@ -62,4 +73,4 @@ function resolveInsideRoot(root, relativePath) {
 }
 
 //#endregion
-export { atomicWriteText as a, ATOMIC_TMP_SUFFIX_PATTERN as i, normalizePath as n, isAtomicTempPath as o, resolveInsideRoot as r, assertSafePathSegment as t };
+export { atomicWriteBinary as a, ATOMIC_TMP_SUFFIX_PATTERN as i, normalizePath as n, atomicWriteText as o, resolveInsideRoot as r, isAtomicTempPath as s, assertSafePathSegment as t };

package/dist/{skill-CAJMsLod.js → skill-WSUDp6A1.js}

@@ -1,5 +1,5 @@
 import { n as messageOf, t as WebSkillError } from "./errors-BDZNpC13.js";
-import { a as atomicWriteText, o as isAtomicTempPath, r as resolveInsideRoot } from "./pathSecurity-B1owvJAF.js";
+import { o as atomicWriteText, r as resolveInsideRoot, s as isAtomicTempPath } from "./pathSecurity-CirkQwWP.js";
 import { parse } from "yaml";
 import { Unzip, UnzipInflate, zipSync } from "fflate";
 

package/dist/{skillVersionStore-B24Jjjry-BY1H7Krp.d.ts → skillVersionStore-S4_HJ_Fl-Ds97pwm5.d.ts}

@@ -1,5 +1,5 @@
-import { K as FileSystemProvider, St as SkillManifest, et as Page, ht as SkillCatalogEntry, tt as PageQuery } from "./types-CpDRZ0rA-BM5FI9oN.js";
-//#region ../governance/dist/skillVersionStore-B24Jjjry.d.ts
+import { K as FileSystemProvider, St as SkillManifest, et as Page, ht as SkillCatalogEntry, tt as PageQuery } from "./types-CpDRZ0rA-CFQ-vdKz.js";
+//#region ../governance/dist/skillVersionStore-S4_HJ_Fl.d.ts
 //#region src/types.d.ts
 type CandidateStatus = 'draft' | 'pending-review' | 'approved' | 'published' | 'rejected';
 /** `generated` 是 0.5.0 的技能自动生成来源（需求 12 号 AC-9.1） */
@@ -8,7 +8,29 @@ type CandidateRisk = 'low' | 'medium' | 'high';
 interface CandidateFile {
   path: string;
   kind: 'skill-md' | 'script' | 'reference' | 'asset';
+  /**
+   * 文件正文。二进制条目为空串——字节存在候选自己的旁路里，见 `binary`。
+   * 保持必填 `string`：它的消费方遍布审核 UI、发布链路与测试，
+   * 改成联合类型会让每一处都要分支，而其中大多数只关心文本。
+   */
   content: string;
+  /** 在场即本条目是二进制，正文在旁路文件里（0.23.0 分册 20） */
+  binary?: CandidateBinaryRef;
+}
+/**
+ * 候选二进制旁路里的一份字节（0.23.0 分册 20）。
+ *
+ * 字节**不内嵌进候选 JSON**：`CandidateStore.list()` 会把目录里每一个 JSON 全文读出来解析，
+ * 内嵌等于审批列表每翻一页都要把所有候选的二进制读进内存再做一次 base64 往返。
+ */
+interface CandidateBinaryRef {
+  /** 候选二进制目录（`<id>.files/`）下的文件名，不是路径 */
+  file: string;
+  size: number;
+  /** sha-256，十六进制小写；AC-20.1 的「逐字节相同」靠它判 */
+  sha256: string;
+  /** 来源附件的原始文件名，供审核者辨认（FR-20.10） */
+  sourceName: string;
 }
 interface CandidateSkill {
   id: string;
@@ -97,7 +119,16 @@ declare class CandidateStore {
     /** 治理根下该技能是否仍装着；不注入则 published 一律拒删（见 `remove`） */
     isSkillInstalled?: (name: string) => Promise<boolean>;
   });
-  save(candidate: CandidateSkill): Promise<void>;
+  /**
+   * 存候选。`binaries` 的键是 `CandidateFile.binary.file`，缺省即本候选全是文本。
+   *
+   * 落盘顺序是**先字节、后 JSON**（0.23.0 分册 20 §3.2）：反过来的话，
+   * 崩溃会留下一条指向不存在字节的元数据，而那种候选要到审批安装那一步才暴露——
+   * 正是 FR-20.6 要避免的那类「延迟到审批才失败」。
+   */
+  save(candidate: CandidateSkill, binaries?: ReadonlyMap<string, Uint8Array>): Promise<void>;
+  /** 读回候选旁路里的一份字节（安装时按原样写进技能目录，0.23.0 分册 20 FR-20.8） */
+  readCandidateBinary(id: string, file: string): Promise<Uint8Array>;
   get(id: string): Promise<CandidateSkill>;
   /**
    * 候选（= 审批队列）分页。`status` 是端口参数而不是上层 `.filter()`：
@@ -182,4 +213,4 @@ declare class SkillVersionStore {
   }): Promise<SkillVersion>;
 }
 //#endregion
-export { SkillState as _, AuditLog as a, SkillVersionStore as b, CandidateFile as c, CandidateSkill as d, CandidateSource as f, SKILL_VERSION_PAGE_SIZE as g, CompositeApprovalPolicy as h, AuditEvent as i, CandidatePage as l, CandidateStore as m, ApprovalDecision as n, AuditQueryFilter as o, CandidateStatus as p, ApprovalPolicy as r, CANDIDATE_PAGE_SIZE as s, AlwaysHumanApprovalPolicy as t, CandidateRisk as u, SkillVersion as v, candidateToCatalogEntry as x, SkillVersionPage as y };
+export { candidateToCatalogEntry as S, SKILL_VERSION_PAGE_SIZE as _, AuditLog as a, SkillVersionPage as b, CandidateBinaryRef as c, CandidateRisk as d, CandidateSkill as f, CompositeApprovalPolicy as g, CandidateStore as h, AuditEvent as i, CandidateFile as l, CandidateStatus as m, ApprovalDecision as n, AuditQueryFilter as o, CandidateSource as p, ApprovalPolicy as r, CANDIDATE_PAGE_SIZE as s, AlwaysHumanApprovalPolicy as t, CandidatePage as u, SkillState as v, SkillVersionStore as x, SkillVersion as y };

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { S as UiBridge, c as InteractionResponse, l as LlmClient, m as LlmStreamEvent, n as ArtifactStore, p as LlmResponse, s as InteractionRequest, t as Artifact, u as LlmCompleteInput, v as MemoryStore } from "./types-CpDRZ0rA-BM5FI9oN.js";
+import { S as UiBridge, c as InteractionResponse, l as LlmClient, m as LlmStreamEvent, n as ArtifactStore, p as LlmResponse, s as InteractionRequest, t as Artifact, u as LlmCompleteInput, v as MemoryStore } from "./types-CpDRZ0rA-CFQ-vdKz.js";
 import { a as loadGoogleConfigFromEnv, i as loadAnthropicConfigFromEnv, n as LlmEnvConfig, o as loadLlmConfigFromEnv, r as ProviderEnvConfig } from "./env-AK3cSMEA-Dli6QU5E.js";
 //#region ../runtime/dist/testing.d.ts
 //#region src/llm/mockLlmClient.d.ts

package/dist/{types-CpDRZ0rA-BM5FI9oN.d.ts → types-CpDRZ0rA-CFQ-vdKz.d.ts}

@@ -46,6 +46,10 @@ type WebSkillErrorCode = 'FS_NOT_FOUND' | 'FS_PATH_OUTSIDE_ROOT' | 'SKILL_NOT_FO
 'TEMPLATE_ROW_INSERT_RANGE' |
 /** 目标格由模板的公式算出，写值会把它摧毁（FR-42.28） */
 'TEMPLATE_CELL_IS_FORMULA' |
+/** 目标格落在合并区内且不是左上角：写进去 Excel 不显示（0.24.0 FR-17.6） */
+'TEMPLATE_CELL_IS_COVERED' |
+/** 请求了若干格，一条都没写成——那不是部分成功，是整个填错了地方（0.24.0 FR-17.10） */
+'TEMPLATE_FILL_REJECTED' |
 /** 用户拒绝了这次工具调用（0.14.0 分册 20） */
 'TOOL_DENIED';
 /**
@@ -416,6 +420,13 @@ declare const isAtomicTempPath: (path: string) => boolean;
  * 对崩溃一致性要求极高的场景在浏览器侧需知悉此前提。
  */
 declare function atomicWriteText(fs: FileSystemProvider, path: string, content: string): Promise<void>;
+/**
+ * 原子写二进制：与 `atomicWriteText` 逐字对称，只换写入方法（0.23.0 分册 20）。
+ *
+ * 临时名必须沿用同一条 `ATOMIC_TMP_SUFFIX_PATTERN` 形状——打包与列举侧靠那条正则
+ * 排除中断残留，另起一套命名会让残留的临时文件被打进技能包。
+ */
+declare function atomicWriteBinary(fs: FileSystemProvider, path: string, content: Uint8Array): Promise<void>;
 //#endregion
 //#region src/fs/pathSecurity.d.ts
 /** 统一分隔符为 `/`，去除 `.` 段与重复分隔符（不解析 `..`） */
@@ -1261,4 +1272,4 @@ interface MemoryStore {
   transaction?<T>(scope: string, fn: (inner: MemoryStore) => Promise<T>): Promise<T>;
 }
 //#endregion
-export { PPTX_MIME as $, extractedDocumentFormat as $t, extractSkillCandidate as A, TrustedKey as At, DOCX_MIME as B, assertRemoteUrlAllowed as Bt, UiSpecActionCapability as C, xmlRenderer as Cn, SkillMetadata as Ct, UiSpecSnapshot as D, SkillSource as Dt, UiSpecPatch as E, SkillSignature as Et, BINARY_EXTENSIONS as F, ValidationReport as Ft, FileStat as G, checkDependencyCycles as Gt, DiscoveryResult as H, atomicWriteText as Ht, CatalogRenderer as I, VerifyResult as It, FsTrustedKeyStore as J, computeDigest as Jt, FileSystemProvider as K, checkSkillRules as Kt, ChatAttachmentKind as L, WebSkillError as Lt, ATTACHMENT_TEXT_LIMIT as M, UNTRUSTED_LINE_LIMIT as Mt, ArchiveLimits as N, UiSpecNode as Nt, UiSurfaceActionRequest as O, SkillsLockfile as Ot, AttachmentTextInput as P, UnsignedPolicy as Pt, MemoryFS as Q, exportSkills as Qt, CryptoKeyLike as R, WebSkillErrorCode as Rt, UiBridge as S, verifySkillSignature as Sn, SkillManifest as St, UiSpecEvent as T, SkillReader as Tt, ExtractedDocumentFormat as U, buildCatalog as Ut, DWG_MIME_TYPES as V, assertSafePathSegment as Vt, FILE_MIME_TYPES as W, buildManifest as Wt, JsonSchema as X, detectSkillArchiveShapeFromFs as Xt, IMAGE_MIME_TYPES as Y, detectSkillArchiveShape as Yt, MANIFEST_EXCLUDED_FILES as Z, escapeXml as Zt, LlmToolSpec as _, signaturePayloadBytes as _n, SkillDocument as _t, InteractionOrigin as a, messageOf as an, SKILL_MANIFEST_FILE as at, RenderResultRequest as b, validateSkills as bn, SkillLocation as bt, InteractionResponse as c, parseSkillPackManifest as cn, SKILL_PACK_FILE as ct, LlmContentPart as d, renderAvailableSkillsXml as dn, SignatureVerdict as dt, formatAttachmentText as en, Page as et, LlmMessage as f, renderCatalogJson as fn, SkillArchiveDetection as ft, LlmToolCall as g, signSkill as gn, SkillDiscovery as gt, LlmTokenUsage as h, sanitizeUntrustedLine as hn, SkillCatalogEntry as ht, FormField as i, keyIdOf as in, SKILLS_LOCKFILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, TrustedKeyStore as jt, UiSurfaceActionResponse as k, TEXT_EXTENSIONS as kt, LlmClient as l, readResponseWithLimit as ln, SKILL_SIGNATURE_FILE as lt, LlmStreamEvent as m, resolveInsideRoot as mn, SkillCatalog as mt, ArtifactStore as n, isValidSkillName as nn, RemoteUrlPolicy as nt, InteractionPolicy as o, normalizePath as on, SKILL_NAME_MAX_LENGTH as ot, LlmResponse as p, resolveArchiveLimits as pn, SkillArchiveShape as pt, FileWriteStream as q, classifyAttachment as qt, ChartSpec as r, jsonRenderer as rn, SIGNATURE_SCHEMA_VERSION as rt, InteractionRequest as s, parseSkillMarkdown as sn, SKILL_NAME_PATTERN as st, Artifact as t, isAtomicTempPath as tn, PageQuery as tt, LlmCompleteInput as u, readSkillSignature as un, SignatureAuditSink as ut, MemoryStore as v, stripArchiveRoot as vn, SkillInstallSource as vt, UiSpecDrafts as w, SkillPackManifest as wt, SkillCandidateMarker as x, verifyManifest as xn, SkillManagerPort as xt, RenderBlock as y, unzipWithLimits as yn, SkillIssue as yt, DEFAULT_ARCHIVE_LIMITS as z, XLSX_MIME as zt };
+export { PPTX_MIME as $, exportSkills as $t, extractSkillCandidate as A, TrustedKey as At, DOCX_MIME as B, assertRemoteUrlAllowed as Bt, UiSpecActionCapability as C, verifySkillSignature as Cn, SkillMetadata as Ct, UiSpecSnapshot as D, SkillSource as Dt, UiSpecPatch as E, SkillSignature as Et, BINARY_EXTENSIONS as F, ValidationReport as Ft, FileStat as G, buildManifest as Gt, DiscoveryResult as H, atomicWriteBinary as Ht, CatalogRenderer as I, VerifyResult as It, FsTrustedKeyStore as J, classifyAttachment as Jt, FileSystemProvider as K, checkDependencyCycles as Kt, ChatAttachmentKind as L, WebSkillError as Lt, ATTACHMENT_TEXT_LIMIT as M, UNTRUSTED_LINE_LIMIT as Mt, ArchiveLimits as N, UiSpecNode as Nt, UiSurfaceActionRequest as O, SkillsLockfile as Ot, AttachmentTextInput as P, UnsignedPolicy as Pt, MemoryFS as Q, escapeXml as Qt, CryptoKeyLike as R, WebSkillErrorCode as Rt, UiBridge as S, verifyManifest as Sn, SkillManifest as St, UiSpecEvent as T, SkillReader as Tt, ExtractedDocumentFormat as U, atomicWriteText as Ut, DWG_MIME_TYPES as V, assertSafePathSegment as Vt, FILE_MIME_TYPES as W, buildCatalog as Wt, JsonSchema as X, detectSkillArchiveShape as Xt, IMAGE_MIME_TYPES as Y, computeDigest as Yt, MANIFEST_EXCLUDED_FILES as Z, detectSkillArchiveShapeFromFs as Zt, LlmToolSpec as _, signSkill as _n, SkillDocument as _t, InteractionOrigin as a, keyIdOf as an, SKILL_MANIFEST_FILE as at, RenderResultRequest as b, unzipWithLimits as bn, SkillLocation as bt, InteractionResponse as c, parseSkillMarkdown as cn, SKILL_PACK_FILE as ct, LlmContentPart as d, readSkillSignature as dn, SignatureVerdict as dt, extractedDocumentFormat as en, Page as et, LlmMessage as f, renderAvailableSkillsXml as fn, SkillArchiveDetection as ft, LlmToolCall as g, sanitizeUntrustedLine as gn, SkillDiscovery as gt, LlmTokenUsage as h, resolveInsideRoot as hn, SkillCatalogEntry as ht, FormField as i, jsonRenderer as in, SKILLS_LOCKFILE as it, ATOMIC_TMP_SUFFIX_PATTERN as j, TrustedKeyStore as jt, UiSurfaceActionResponse as k, TEXT_EXTENSIONS as kt, LlmClient as l, parseSkillPackManifest as ln, SKILL_SIGNATURE_FILE as lt, LlmStreamEvent as m, resolveArchiveLimits as mn, SkillCatalog as mt, ArtifactStore as n, isAtomicTempPath as nn, RemoteUrlPolicy as nt, InteractionPolicy as o, messageOf as on, SKILL_NAME_MAX_LENGTH as ot, LlmResponse as p, renderCatalogJson as pn, SkillArchiveShape as pt, FileWriteStream as q, checkSkillRules as qt, ChartSpec as r, isValidSkillName as rn, SIGNATURE_SCHEMA_VERSION as rt, InteractionRequest as s, normalizePath as sn, SKILL_NAME_PATTERN as st, Artifact as t, formatAttachmentText as tn, PageQuery as tt, LlmCompleteInput as u, readResponseWithLimit as un, SignatureAuditSink as ut, MemoryStore as v, signaturePayloadBytes as vn, SkillInstallSource as vt, UiSpecDrafts as w, xmlRenderer as wn, SkillPackManifest as wt, SkillCandidateMarker as x, validateSkills as xn, SkillManagerPort as xt, RenderBlock as y, stripArchiveRoot as yn, SkillIssue as yt, DEFAULT_ARCHIVE_LIMITS as z, XLSX_MIME as zt };

package/dist/ui-react.d.ts

@@ -1,6 +1,6 @@
-import { C as UiSpecActionCapability, D as UiSpecSnapshot, Nt as UiSpecNode, O as UiSurfaceActionRequest, S as UiBridge, T as UiSpecEvent, b as RenderResultRequest, c as InteractionResponse, k as UiSurfaceActionResponse, s as InteractionRequest, w as UiSpecDrafts } from "./types-CpDRZ0rA-BM5FI9oN.js";
-import { P as DocumentSurfacePort } from "./index-YPd8ZSEa.js";
-import { F as InteractionSpecLabels, J as SurfaceFormTexts, Y as SurfaceHostControlTexts, v as ChartFontSizes } from "./index-BiO9_XRk.js";
+import { C as UiSpecActionCapability, D as UiSpecSnapshot, Nt as UiSpecNode, O as UiSurfaceActionRequest, S as UiBridge, T as UiSpecEvent, b as RenderResultRequest, c as InteractionResponse, k as UiSurfaceActionResponse, s as InteractionRequest, w as UiSpecDrafts } from "./types-CpDRZ0rA-CFQ-vdKz.js";
+import { P as DocumentSurfacePort } from "./index-Bq299VnF.js";
+import { L as InteractionSpecLabels, X as SurfaceFormTexts, Z as SurfaceHostControlTexts, v as ChartColors, y as ChartFontSizes } from "./index-mKgZU7cG.js";
 import { z } from "zod";
 import React$1, { ComponentType, ReactNode } from "react";
 import "react/jsx-runtime";
@@ -555,4 +555,11 @@ declare function ChartFontSizesProvider({ sizes, children }: {
   children: ReactNode;
 }): import("react").JSX.Element;
 //#endregion
-export { type CatalogNodeProps, ChartFontSizesProvider, type CustomSurfaceActionEvent, type DroppedSurfaceActionWarning, InteractionForm, type JsonRenderActionDispatch, JsonRenderSpecSurface, type JsonRenderSpecSurfaceProps, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, type NativeSpecSurfaceProps, OpenUiSpecSurface, type OpenUiSpecSurfaceProps, ReactBridgeState, type ReactBridgeStateOptions, type RegisteredSurfaceProps, ResultBlocks, SpecInteractionChannel, type SpecInteractionSession, StreamingText, SurfaceFormTextsProvider, type SurfaceRegistration, SurfaceRegistry, type UiSurfaceActionEvent, UiSurfaceList, type UiSurfaceListProps, UiSurfaceSnapshotList, type UiSurfaceSnapshotListProps, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability, useChartFontSizes, useSurfaceFormTexts, useSurfaceHostControlTexts };
+//#region src/components/chartColors.d.ts
+declare function useChartColors(): Partial<ChartColors> | undefined;
+declare function ChartColorsProvider({ colors, children }: {
+  colors?: Partial<ChartColors> | undefined;
+  children: ReactNode;
+}): import("react").JSX.Element;
+//#endregion
+export { type CatalogNodeProps, ChartColorsProvider, ChartFontSizesProvider, type CustomSurfaceActionEvent, type DroppedSurfaceActionWarning, InteractionForm, type JsonRenderActionDispatch, JsonRenderSpecSurface, type JsonRenderSpecSurfaceProps, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, type NativeSpecSurfaceProps, OpenUiSpecSurface, type OpenUiSpecSurfaceProps, ReactBridgeState, type ReactBridgeStateOptions, type RegisteredSurfaceProps, ResultBlocks, SpecInteractionChannel, type SpecInteractionSession, StreamingText, SurfaceFormTextsProvider, type SurfaceRegistration, SurfaceRegistry, type UiSurfaceActionEvent, UiSurfaceList, type UiSurfaceListProps, UiSurfaceSnapshotList, type UiSurfaceSnapshotListProps, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability, useChartColors, useChartFontSizes, useSurfaceFormTexts, useSurfaceHostControlTexts };

package/dist/ui-react.js

@@ -2,7 +2,7 @@ import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM, r as __
 import { n as messageOf, t as WebSkillError } from "./errors-BDZNpC13.js";
 import { n as validateUiSpecEvent, r as validateUiSpecNode } from "./surface-DVGiCmwq.js";
 import { a as applySuggestion, c as DEFAULT_SURFACE_FORM_TEXTS, f as resolveSurfaceFormTexts, i as renderMiniMarkdown, l as DEFAULT_SURFACE_HOST_CONTROL_TEXTS, m as shapeInteractionValue, o as collectValues, p as resolveSurfaceHostControlTexts, r as renderMiniChart, u as interactionToFormModel } from "./miniChart-D0nYMzz8.js";
-import { C as DEFAULT_CHART_FONT_SIZES, E as resolveChartFontSizes, S as gaugePercent, T as mountEchart, c as resolveColumnWidths, d as collectFormScopes, f as collectScopedValues, g as uiCatalog, i as normalizeFieldOptions, n as interactionToUiSpec, p as qualifyFieldName, r as toJsonRenderSpec, s as normalizeColumnWidths, t as toOpenUiSpecLang, u as evaluateFieldCondition, w as chartSpecFromProps } from "./openUiSpecLang-BSYYnjay.js";
+import { E as mountEchart, O as resolveChartFontSizes, S as gaugePercent, T as chartSpecFromProps, c as resolveColumnWidths, d as collectFormScopes, f as collectScopedValues, g as uiCatalog, i as normalizeFieldOptions, n as interactionToUiSpec, p as qualifyFieldName, r as toJsonRenderSpec, s as normalizeColumnWidths, t as toOpenUiSpecLang, u as evaluateFieldCondition, w as DEFAULT_CHART_FONT_SIZES } from "./openUiSpecLang-DIcLcybq.js";
 import minpath from "node:path";
 import { fileURLToPath as urlToPath } from "node:url";
 import { z } from "zod";
@@ -258,6 +258,8 @@ var ReactBridgeState = class {
 	streamingRunId = null;
 	streamingText = "";
 	#listeners = /* @__PURE__ */ new Set();
+	/** 待决交互队列，队头即 `pending`（0.23.0 分册 19 FR-19.6） */
+	#queue = [];
 	#resolvers = /* @__PURE__ */ new Map();
 	#surfaceActionResolvers = /* @__PURE__ */ new Map();
 	#processedSurfaceActionNonces = /* @__PURE__ */ new Set();
@@ -301,10 +303,11 @@ var ReactBridgeState = class {
 		for (const listener of [...this.#listeners]) listener();
 	}
 	request(input) {
-		this.pending = input;
-		this.#emit();
 		return new Promise((resolve) => {
 			this.#resolvers.set(input.id, resolve);
+			this.#queue.push(input);
+			this.pending = this.#queue[0] ?? null;
+			this.#emit();
 		});
 	}
 	/** 组件提交/取消回调 */
@@ -312,7 +315,8 @@ var ReactBridgeState = class {
 		const resolver = this.#resolvers.get(response.id);
 		if (!resolver) return;
 		this.#resolvers.delete(response.id);
-		this.pending = null;
+		this.#queue = this.#queue.filter((request) => request.id !== response.id);
+		this.pending = this.#queue[0] ?? null;
 		this.#emit();
 		resolver(response);
 	}
@@ -124762,14 +124766,52 @@ function ChartFontSizesProvider({ sizes, children }) {
 	});
 }
 
+//#endregion
+//#region ../ui-react/src/components/chartColors.tsx
+/**
+* 画布内取色的注入口（0.24.0 分册 14 FR-14.8）。与 `ChartFontSizesProvider` 同构，
+* 只有缺省来源不同：字号缺省是常量，颜色缺省是**不注入**——
+* 那样 `mountEchart` 会去读容器的计算 `color`，图表因此跟着宿主主题走。
+* 所以这里的 context 缺省值是 `undefined` 而不是 `DEFAULT_CHART_COLORS`：
+* 填上常量就等于把所有图表钉死在浅色默认上，正是本册要修的毛病。
+*/
+const ChartColorsContext = createContext(void 0);
+function useChartColors() {
+	return useContext(ChartColorsContext);
+}
+function ChartColorsProvider({ colors, children }) {
+	const { title, axisLabel, legend, axisLine, splitLine } = colors ?? {};
+	const absent = colors === void 0;
+	const value = useMemo(() => absent ? void 0 : {
+		title,
+		axisLabel,
+		legend,
+		axisLine,
+		splitLine
+	}, [
+		absent,
+		title,
+		axisLabel,
+		legend,
+		axisLine,
+		splitLine
+	]);
+	return /* @__PURE__ */ jsx(ChartColorsContext.Provider, {
+		value,
+		children
+	});
+}
+
 //#endregion
 //#region ../ui-react/src/components/EChart.tsx
 /** echarts 挂载点：surface 图表与 catalog 声明树的 Chart 节点共用，实现在 `@webskill/ui`，与 A2UI 档同一份 */
-function EChart({ chart, fontSizes }) {
+function EChart({ chart, fontSizes, colors }) {
 	const containerRef = useRef(null);
 	const handleRef = useRef(void 0);
 	const inherited = useChartFontSizes();
 	const effective = fontSizes ?? inherited;
+	const inheritedColors = useChartColors();
+	const effectiveColors = colors ?? inheritedColors;
 	useEffect(() => {
 		const container = containerRef.current;
 		if (!container) return;
@@ -124781,8 +124823,12 @@ function EChart({ chart, fontSizes }) {
 		};
 	}, []);
 	useEffect(() => {
-		handleRef.current?.setChart(chart, effective);
-	}, [chart, effective]);
+		handleRef.current?.setChart(chart, effective, effectiveColors);
+	}, [
+		chart,
+		effective,
+		effectiveColors
+	]);
 	return /* @__PURE__ */ jsx("div", {
 		className: "webskill-surface__chart",
 		ref: containerRef
@@ -134885,7 +134931,14 @@ async function probeJsonRenderAvailability() {
 var SpecInteractionChannel = class {
 	/** 宿主注入的界面文案（本地化）；未设时用 FormModel 的英文默认值 */
 	labelsFor = () => ({});
-	#current;
+	/**
+	* 待决交互队列，队头即 `current`（0.23.0 分册 19 FR-19.6）。
+	*
+	* 原本是单槽，新请求到来时把旧请求主动取消。并发子 agent 下那一句
+	* 「正常路径 runtime 串行」不再成立，而主动取消比悬挂还糟：
+	* 子 agent 会收到一个看似正常的 `cancelled: true`，然后把「用户拒绝了」写进结论。
+	*/
+	#queue = [];
 	#listeners = /* @__PURE__ */ new Set();
 	#attached = 0;
 	#failure;
@@ -134895,7 +134948,7 @@ var SpecInteractionChannel = class {
 		return () => this.#listeners.delete(listener);
 	};
 	get current() {
-		return this.#current?.session;
+		return this.#queue[0]?.session;
 	}
 	get isAttached() {
 		return this.#attached > 0;
@@ -134911,26 +134964,22 @@ var SpecInteractionChannel = class {
 		this.#attached = Math.max(0, this.#attached - 1);
 	}
 	request(input) {
-		if (this.#current) this.#settle({
-			id: this.#current.session.request.id,
-			cancelled: true
-		});
 		return new Promise((resolve, reject) => {
 			const session = {
 				request: input,
 				spec: interactionToUiSpec(input, this.labelsFor(input))
 			};
-			this.#current = {
+			this.#queue.push({
 				session,
 				resolve,
 				reject
-			};
+			});
 			this.#emit();
 		});
 	}
 	/** runtime 交互超时/取消：以 cancelled resolve 挂起的 request（防悬挂 + 残留） */
 	cancel(id) {
-		if (this.#current?.session.request.id === id) this.#settle({
+		if (this.#queue.some((entry) => entry.session.request.id === id)) this.#settle({
 			id,
 			cancelled: true
 		});
@@ -134941,14 +134990,14 @@ var SpecInteractionChannel = class {
 	* 本通道只提供入口：裸用本通道的宿主不调就维持原来的 cancelled 语义。
 	*/
 	decline(id) {
-		if (this.#current?.session.request.id === id) this.#settle({
+		if (this.#queue.some((entry) => entry.session.request.id === id)) this.#settle({
 			id,
 			value: false
 		});
 	}
 	/** react 层动作回传：submit 归形提交值，其余意图（cancel）按取消收尾 */
 	handleAction(event) {
-		const pending = this.#current;
+		const pending = this.#queue[0];
 		if (!pending) return;
 		const { request } = pending.session;
 		if (event.intent !== "submit") {
@@ -134967,14 +135016,16 @@ var SpecInteractionChannel = class {
 	/** react 层初始化失败：挂起请求 reject 并记录原因（桥读取后降级 native） */
 	fail(message) {
 		this.#failure = message;
-		const pending = this.#current;
-		this.#current = void 0;
+		const pendings = this.#queue;
+		this.#queue = [];
 		this.#emit();
-		pending?.reject(new Error(message));
+		const error = new Error(message);
+		for (const pending of pendings) pending.reject(error);
 	}
 	#settle(response) {
-		const pending = this.#current;
-		this.#current = void 0;
+		const index = this.#queue.findIndex((entry) => entry.session.request.id === response.id);
+		if (index < 0) return;
+		const [pending] = this.#queue.splice(index, 1);
 		this.#emit();
 		pending?.resolve(response);
 	}
@@ -134994,7 +135045,7 @@ function OpenUiSpecSurface({ spec, surfaceId, actions, onAction }) {
 	const [unavailable, setUnavailable] = useState(false);
 	useEffect(() => {
 		let cancelled = false;
-		import("./openUiLibrary-B7j3rLrm.js").then((loaded) => {
+		import("./openUiLibrary-CxtrnX54.js").then((loaded) => {
 			if (!cancelled) setModule(loaded);
 		}).catch(() => {
 			if (!cancelled) setUnavailable(true);
@@ -135033,4 +135084,4 @@ function OpenUiSpecSurface({ spec, surfaceId, actions, onAction }) {
 }
 
 //#endregion
-export { ChartFontSizesProvider, InteractionForm, JsonRenderSpecSurface, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, ResultBlocks, SpecInteractionChannel, StreamingText, SurfaceFormTextsProvider, SurfaceRegistry, UiSurfaceList, UiSurfaceSnapshotList, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability, CatalogNode as t, useChartFontSizes, useSurfaceFormTexts, useSurfaceHostControlTexts };
+export { ChartColorsProvider, ChartFontSizesProvider, InteractionForm, JsonRenderSpecSurface, NATIVE_SPEC_COMPONENTS, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, ResultBlocks, SpecInteractionChannel, StreamingText, SurfaceFormTextsProvider, SurfaceRegistry, UiSurfaceList, UiSurfaceSnapshotList, UiSurfaceStore, catalogComponentImpls, createJsonRenderRegistry, probeJsonRenderAvailability, CatalogNode as t, useChartColors, useChartFontSizes, useSurfaceFormTexts, useSurfaceHostControlTexts };

package/dist/ui-vue.d.ts

@@ -1,4 +1,4 @@
-import { S as UiBridge, b as RenderResultRequest, c as InteractionResponse, s as InteractionRequest } from "./types-CpDRZ0rA-BM5FI9oN.js";
+import { S as UiBridge, b as RenderResultRequest, c as InteractionResponse, s as InteractionRequest } from "./types-CpDRZ0rA-CFQ-vdKz.js";
 import { PropType } from "vue";
 //#region ../ui-vue/dist/index.d.ts
 //#region src/bridgeState.d.ts