@morlay/dsh-client-ui-primitives 0.0.4 → 0.0.5

package/dist/client.cjs

@@ -21,7 +21,6 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react_jsx_runtime = require("react/jsx-runtime");
-		/** 空的元数据：动态子节点（无声明 schema 的 dict 键）与空字段树用它。 */
 		function emptyMeta() {
 			return {
 				description: void 0,
@@ -42,11 +41,9 @@ window.__ModuleLoader__.load({
 				extra: void 0
 			};
 		}
-		/** `badges` 只留文本：配色与文案由字典决定。 */
 		function badgesOf(meta) {
 			return (meta.badges ?? []).map((badge) => badge.text);
 		}
-		/** 归一化一个节点的 meta。 */
 		function metaOf(schema) {
 			const meta = schema.meta ?? {};
 			return {
@@ -68,17 +65,14 @@ window.__ModuleLoader__.load({
 				extra: meta.extra
 			};
 		}
-		/** 外层 meta 与内层 meta 合并：外层的 undefined 不覆盖内层（transform 的 inner 带着自己的角色）。 */
 		function mergeMeta(inner, outer) {
 			const merged = { ...inner };
 			for (const [key, value] of Object.entries(outer)) if (value !== void 0) merged[key] = value;
 			return merged;
 		}
-		/** 节点自己的路径末段：动态段保持占位，根节点为空串。 */
 		function keyOf(path) {
 			return path[path.length - 1] ?? "";
 		}
-		/** 一个纯字符串叶子（dict 没有声明键 schema 时用它）。 */
 		function stringLeaf(path, meta) {
 			return {
 				key: keyOf(path),
@@ -89,7 +83,6 @@ window.__ModuleLoader__.load({
 				type: "string"
 			};
 		}
-		/** 把 schema 的类型名收口成渲染层认识的那几种。 */
 		function leafTypeOf(type) {
 			switch (type) {
 				case "string": return "string";
@@ -100,12 +93,6 @@ window.__ModuleLoader__.load({
 				default: return "any";
 			}
 		}
-		/**
-		* 投影一个 schema 节点。
-		* @param schema - rehydrate 之后的 volatile 表单 schema（或它的子节点）。
-		* @param path - 该节点相对段根的路径；动态子节点由调用方给占位段。
-		* @returns 渲染层要的字段树。
-		*/
 		function projectNode(schema, path = []) {
 			return project(schema, path, []);
 		}
@@ -223,13 +210,11 @@ window.__ModuleLoader__.load({
 				};
 			}
 		}
-		/** 展开 `lazy` 包装：投影里 lazy 只是一层，值仍在同一路径上。 */
 		function unwrapLazy(node) {
 			let current = node;
 			while (current?.type === "lazy") current = current.inner;
 			return current;
 		}
-		/** 某一层可见的字段：object 直接给；union / intersect 把各变体的对象字段并起来。 */
 		function fieldsOf(node) {
 			const current = unwrapLazy(node);
 			switch (current?.type) {
@@ -239,12 +224,6 @@ window.__ModuleLoader__.load({
 				default: return [];
 			}
 		}
-		/**
-		* 按具体路径找回投影节点（动态段匹配真实键或索引）。
-		* @param root - 段根的字段树。
-		* @param path - 具体路径。
-		* @returns 命中的节点，或 `undefined`。
-		*/
 		function seekNode(root, path) {
 			let current = root;
 			for (const segment of path) {
@@ -270,16 +249,6 @@ window.__ModuleLoader__.load({
 			}
 			return unwrapLazy(current);
 		}
-		/**
-		* 按当前值把字段树展开成渲染顺序的扁平列表（前序）：容器在前、子项紧随其后。
-		*
-		* 出现的**只有值里有的东西，加上必填的**：对象的必填字段始终占行（值是空的也要让用户看见"必须填"），非必填的
-		* 按值出现——值里没有就不占行，它在这一层的「添加属性」候选里，选中才加。数组按索引、字典按键展开；字面量
-		* union 是叶子控件，对象 union 只展开与当前值匹配的那个变体，intersect 的各成员在同一层展开。
-		* @param root - 段根的字段树。
-		* @param value - 生效值（或草稿后的值）。
-		* @returns 渲染顺序的字段列表。
-		*/
 		function walkFields(root, value) {
 			const out = [];
 			visit(root, root.path, value, out, true, void 0, /* @__PURE__ */ new Set(), void 0);
@@ -345,14 +314,12 @@ window.__ModuleLoader__.load({
 				default: return;
 			}
 		}
-		/** 数组的项身份：显式声明优先，否则 item 上的 `id` 字段。 */
 		function mergeKeyOf(schema, item) {
 			const declared = declaredExtra(schema, "mergeKey");
 			if (declared !== void 0) return declared;
 			const current = unwrapLazy(item);
 			return current?.type === "object" && current.fields.some((field) => field.key === "id") ? "id" : void 0;
 		}
-		/** union 的判别标签：显式声明优先，否则所有对象成员共有的唯一常量字段。 */
 		function tagKeyOf(schema, variants) {
 			const declared = declaredExtra(schema, "tag");
 			if (declared !== void 0) return declared;
@@ -362,29 +329,18 @@ window.__ModuleLoader__.load({
 			const candidates = (objects[0]?.fields ?? []).map((field) => unwrapLazy(field)).filter((field) => field?.type === "const").map((field) => field.key).filter((key) => objects.every((object) => unwrapLazy(object.fields.find((field) => field.key === key))?.type === "const"));
 			return candidates.length === 1 ? candidates[0] : void 0;
 		}
-		/** `role(text, { … })` 里声明的字符串约定（项身份 `mergeKey`、判别标签 `tag`）。 */
 		function declaredExtra(schema, name) {
 			const extra = schema.meta?.extra;
 			if (typeof extra !== "object" || extra === null) return void 0;
 			const value = Reflect.get(extra, name);
 			return typeof value === "string" && value.length > 0 ? value : void 0;
 		}
-		/** 一项的项身份值（渲染与冲突检查共用的读法）。 */
 		function memberLabel(value, mergeKey) {
 			if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
 			const member = Reflect.get(value, mergeKey);
 			if (typeof member === "string") return member;
 			if (typeof member === "number" && Number.isFinite(member)) return String(member);
 		}
-		/**
-		* 项身份冲突：同一层里两个成员同名，或某个成员没有名字。
-		*
-		* 名字是成员的「身份」，写盘仍按索引——所以这只是保存前的本地校验：重名的数组在页面上是非法草稿，
-		* 而不是悄悄写到 host 上。
-		* @param root - 段根的字段树。
-		* @param value - 草稿后的段值。
-		* @returns 第一处冲突，或 `undefined`。
-		*/
 		function mergeKeyConflict(root, value) {
 			return scanConflict(root, root.path, value);
 		}
@@ -449,34 +405,24 @@ window.__ModuleLoader__.load({
 				default: return;
 			}
 		}
-		/** 一个容器值里的成员（对象键或数组索引）。 */
 		function entriesOf(value) {
 			if (Array.isArray(value)) return value.map((item, index) => [String(index), item]);
 			if (typeof value === "object" && value !== null) return Object.entries(value);
 			return [];
 		}
-		/** 读一个成员的值。 */
 		function memberOf(value, key) {
 			if (Array.isArray(value)) return value[Number(key)];
 			if (typeof value === "object" && value !== null) return value[String(key)];
 		}
-		/** 把节点收成 union：渲染层判形状与选支都从这里进。 */
 		function unionOf(node) {
 			const current = unwrapLazy(node);
 			return current?.type === "union" ? current : void 0;
 		}
-		/**
-		* 当前值落在哪一支：与 {@link walkFields} 的展开同一判据（标签值优先，其次值的形状，最后第一支）。
-		* @param node - 字段节点（不是 union 就原样返回）。
-		* @param value - 这一层的值。
-		* @returns 选中变体的节点。
-		*/
 		function variantOf(node, value) {
 			const union = unionOf(node);
 			if (union === void 0) return unwrapLazy(node) ?? node;
 			return pickVariant(union, value) ?? union;
 		}
-		/** 变体里那个判别标签字段的常量值（不是 `const` 就没有）。 */
 		function tagValueOf(variant, tagKey) {
 			const current = unwrapLazy(variant);
 			if (current?.type !== "object" && current?.type !== "intersect") return {
@@ -496,7 +442,6 @@ window.__ModuleLoader__.load({
 				value: void 0
 			};
 		}
-		/** 一个变体在页面上的名字：能看出"这一支是什么"，而不是内部类型名。 */
 		function variantLabel(variant, tag) {
 			if (tag.found) return JSON.stringify(tag.value);
 			switch (unwrapLazy(variant)?.type) {
@@ -511,14 +456,6 @@ window.__ModuleLoader__.load({
 				default: return unwrapLazy(variant)?.type ?? "any";
 			}
 		}
-		/**
-		* 变体切换的选项。
-		*
-		* 带判别标签的 union 写**标签值**（`session-rdb` 的 `type: sqlite` ↔ `type: postgres`）；没有标签的写目标变体的
-		* 空值（`access` 在「一段文本」与「一组文本」之间切）。
-		* @param union - 投影出来的 union 节点。
-		* @returns 每个变体一项，顺序即声明顺序。
-		*/
 		function variantChoices(union) {
 			return union.variants.map((variant) => {
 				const tag = union.tagKey === void 0 ? {
@@ -531,7 +468,6 @@ window.__ModuleLoader__.load({
 				};
 			});
 		}
-		/** 按路径读一个值：对象键与数组下标都认（值的读法只有这一处）。 */
 		function readPath(root, path) {
 			return path.reduce((node, segment) => {
 				if (Array.isArray(node)) return node[Number(segment)];
@@ -539,29 +475,12 @@ window.__ModuleLoader__.load({
 				return node[segment];
 			}, root);
 		}
-		/**
-		* 这个"默认值"其实不是值——它不该用来当新加进来的那一项的初值。
-		*
-		* 两种：`null`（"没有值"的判断位，例如 `defaultModel` 用 `.default(null)` 表达"没配就没有这个键"），以及
-		* schemastery 给容器类型自动塞的空壳（`{}`）。两种都该让容器把字段摆出来。
-		* @param node - 字段节点。
-		* @returns 是不是空壳。
-		*/
 		function isBlankDefault(node) {
 			const value = node.meta.defaultValue;
 			if (value === null) return true;
 			if (node.type !== "object" && node.type !== "intersect") return false;
 			return typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0;
 		}
-		/**
-		* 一个新子节点的初值：声明的默认值优先；对象把字段摆出来（见下）；字典/数组给空的容器；其余标量给 **`null`**。
-		*
-		* `null` 在这里是"还没有值"的判断位（`null` / `undefined` 都算），页面据此把它画成一个等着输入的位子——
-		* 而不是 `""`、`0` 这种看着像已经填过的值。host 侧也认这个语义：非必填字段拿到 `null` 回退到默认值，
-		* 必填字段拿到 `null` 就是"必须填"。
-		* @param node - 子节点的字段树。
-		* @returns 初值。
-		*/
 		function emptyValueOf(node) {
 			if (node.meta.hasDefault && !isBlankDefault(node)) return structuredClone(node.meta.defaultValue);
 			switch (node.type) {
@@ -576,7 +495,6 @@ window.__ModuleLoader__.load({
 				default: return null;
 			}
 		}
-		/** 选中与当前值匹配的 union 变体：对象按判别标签的值判，叶子按值类型判。 */
 		function pickVariant(node, value) {
 			if (node.tagKey !== void 0 && typeof value === "object" && value !== null && !Array.isArray(value)) {
 				const tagValue = Reflect.get(value, node.tagKey);
@@ -598,14 +516,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/schema-form/draft.ts
-		/**
-		* 把校验器抛出的错误收成一条失败。
-		*
-		* schemastery 的 `ValidationError` 把路径留在 `options.path` 上（消息里的 `$…` 前缀是给命令行看的），所以这里
-		* 取路径、去前缀——行内报错据此知道挂在哪一行。
-		* @param error - 校验器抛出的错误。
-		* @returns 消息与路径。
-		*/
 		function failureOf(error) {
 			const raw = error instanceof Error ? error.message : String(error);
 			const path = (error.options?.path ?? []).filter((segment) => typeof segment === "string" || typeof segment === "number").map(String);
@@ -615,9 +525,6 @@ window.__ModuleLoader__.load({
 				path
 			};
 		}
-		/**
-		* 一页配置的草稿。一个命名空间一个实例：它订阅共享配置表单，投影给渲染层读。
-		*/
 		var SchemaDraftModel = class {
 			#scope;
 			#root;
@@ -629,9 +536,6 @@ window.__ModuleLoader__.load({
 			#saving = false;
 			#failed = false;
 			#violation;
-			/**
-			* @param options - 本页的共享配置表单、字段树与整段校验。
-			*/
 			constructor(options) {
 				this.#scope = options.scope;
 				this.#root = options.root;
@@ -640,32 +544,15 @@ window.__ModuleLoader__.load({
 					this.#publish();
 				});
 			}
-			/**
-			* 换一份字段树。
-			*
-			* 增删项要按它取节点默认值，而 schema 可能随 describe 变（行的 Config 改了）——所以控制器每次投影都同步一次，
-			* 否则加进来的项会取不到默认值。
-			* @param root - 段根的字段树。
-			*/
 			setRoot(root) {
 				this.#root = root;
 			}
-			/**
-			* 观察草稿与读数的变化。
-			* @param listener - 每次投影都调一次的回调。
-			* @returns 取消订阅。
-			*/
 			subscribe(listener) {
 				this.#listeners.add(listener);
 				return () => {
 					this.#listeners.delete(listener);
 				};
 			}
-			/**
-			* 投影一份读数给渲染层。
-			* @param project - 用模型的当前读数造渲染要的状态。
-			* @returns 渲染层按选择器读的 store。
-			*/
 			bind(project) {
 				const store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)(project());
 				this.subscribe(() => {
@@ -673,10 +560,6 @@ window.__ModuleLoader__.load({
 				});
 				return store;
 			}
-			/**
-			* 表单级状态（与上游 `SettingsForm` 的壳同形）。
-			* @returns 可用性、可写性、脏、非法、保存中、上次保存失败。
-			*/
 			shell() {
 				const { writes, blocked } = this.#plan();
 				return {
@@ -688,22 +571,9 @@ window.__ModuleLoader__.load({
 					failed: this.#failed
 				};
 			}
-			/**
-			* 保存前的整段校验（保存被 schema 挡下时非空）。
-			* @returns 失败消息与它的位置，或 `undefined`。
-			*/
 			violation() {
 				return this.#violation;
 			}
-			/**
-			* 读一个字段的草稿状态。
-			* @param path - 具体路径（动态段已按真实键或索引替换）。
-			* @param preview - 本轮已经算好的读数（`preview()` 的结果）。
-			*
-			* **容器的值要跟着别处的草稿走**：判别式 union 的选支就是容器的值，若这里读生效层，`type` 的切换控件会显示旧
-			* 的那一支（字段树却已经换了）。所以有 `preview` 就用它——控制器一次投影里只算一份。
-			* @returns 显示值、文本草稿、非法消息、是否覆盖。
-			*/
 			field(path, preview) {
 				const snapshot = this.#scope.getSnapshot();
 				const staged = this.#staged.get(pathKey(path));
@@ -749,23 +619,12 @@ window.__ModuleLoader__.load({
 					};
 				}
 			}
-			/**
-			* 暂存一个合法值。
-			* @param path - 具体路径。
-			* @param value - 控件给出的值。
-			*/
 			set(path, value) {
 				this.#stage(path, {
 					kind: "value",
 					value
 				});
 			}
-			/**
-			* 暂存一段文本，保存时才解析。
-			* @param path - 具体路径。
-			* @param text - 用户输入的原文。
-			* @param parse - 解析规则；失败时给出消息并挡住保存。
-			*/
 			setText(path, text, parse) {
 				this.#stage(path, {
 					kind: "text",
@@ -773,17 +632,9 @@ window.__ModuleLoader__.load({
 					parse
 				});
 			}
-			/**
-			* 暂存「恢复默认」。
-			* @param path - 具体路径。
-			*/
 			clear(path) {
 				this.#stage(path, { kind: "clear" });
 			}
-			/**
-			* 追加一个数组项，值取该项节点的默认值。
-			* @param path - 数组字段的具体路径。
-			*/
 			appendItem(path) {
 				const node = seekNode(this.#root, path);
 				if (node?.type !== "array") return;
@@ -791,21 +642,9 @@ window.__ModuleLoader__.load({
 				const index = Array.isArray(current) ? current.length : 0;
 				this.set([...path, String(index)], emptyValueOf(node.item));
 			}
-			/**
-			* 移除一个数组项。
-			* @param path - 数组字段的具体路径。
-			* @param index - 项在数组里的位置。
-			*/
 			removeItem(path, index) {
 				this.#stage([...path, String(index)], { kind: "drop" });
 			}
-			/**
-			* 给一层加一项，值取它的默认值。
-			*
-			* 字典认任意键；对象只认 schema 声明过的字段（写一个没声明的键会被 host 挡下，所以这里直接不写）。
-			* @param path - 容器的具体路径。
-			* @param key - 要加的键。
-			*/
 			addKey(path, key) {
 				const node = seekNode(this.#root, path);
 				if (node === void 0) return;
@@ -817,25 +656,15 @@ window.__ModuleLoader__.load({
 				if (field === void 0) return;
 				this.set([...path, key], emptyValueOf(field));
 			}
-			/**
-			* 删一个字典键。
-			* @param path - 字典字段的具体路径。
-			* @param key - 要删的键。
-			*/
 			removeKey(path, key) {
 				this.#stage([...path, key], { kind: "drop" });
 			}
-			/**
-			* 撤销一个字段的草稿（回到它当前的生效值）——行内编辑取消时用。
-			* @param path - 具体路径。
-			*/
 			revert(path) {
 				if (!this.#staged.delete(pathKey(path))) return;
 				this.#failed = false;
 				this.#violation = void 0;
 				this.#publish();
 			}
-			/** 丢弃全部草稿，回到 host 的读数。 */
 			discard() {
 				if (this.#staged.size === 0 && !this.#failed && this.#violation === void 0) return;
 				this.#staged.clear();
@@ -844,13 +673,6 @@ window.__ModuleLoader__.load({
 				this.#violation = void 0;
 				this.#publish();
 			}
-			/**
-			* 把全部草稿写成一次带 revision 栅栏的提交。
-			*
-			* host 是「值是否被接受」的唯一权威（有些约束 schema 表达不出来），所以落盘与否读回来决定，而不是在这里
-			* 预测；没落盘的保存保留草稿，让用户改而不是重打。
-			* @returns 写完与读回之后的收束。
-			*/
 			async save() {
 				const snapshot = this.#scope.getSnapshot();
 				if (this.#saving || !snapshot.writable) return;
@@ -886,12 +708,10 @@ window.__ModuleLoader__.load({
 					this.#publish();
 				}
 			}
-			/** 释放对共享配置表单的订阅。 */
 			dispose() {
 				this.#unsubscribe();
 				this.#listeners.clear();
 			}
-			/** 每条草稿这一轮会写什么；被 schema 挡下的草稿没有 op，但仍然是脏的。 */
 			#plan() {
 				const snapshot = this.#scope.getSnapshot();
 				const writes = [];
@@ -932,7 +752,6 @@ window.__ModuleLoader__.load({
 					blocked
 				};
 			}
-			/** 生效值套上本轮草稿后的段值：字段树按它展开（追加的数组项立刻出现），整段校验也看它。 */
 			preview() {
 				const ops = this.#plan().writes.flatMap((item) => item.op === void 0 ? [] : [item.op]);
 				return applyOps(this.#scope.getSnapshot().value ?? {}, ops);
@@ -951,17 +770,14 @@ window.__ModuleLoader__.load({
 				for (const listener of this.#listeners) listener();
 			}
 		};
-		/** 深比较：值相等就不写（避免把「改回原值」也当成一次写）。 */
 		function sameValue$1(left, right) {
 			if (Object.is(left, right)) return true;
 			if (typeof left !== "object" || typeof right !== "object" || left === null || right === null) return false;
 			return JSON.stringify(left) === JSON.stringify(right);
 		}
-		/** 路径的 map 键。 */
 		function pathKey(path) {
 			return JSON.stringify(path);
 		}
-		/** 路径末段是否在用户层里存在（覆盖判据）。 */
 		function hasPath(root, path) {
 			if (path.length === 0) return root !== void 0;
 			const parent = readPath(root, path.slice(0, -1));
@@ -970,7 +786,6 @@ window.__ModuleLoader__.load({
 			if (typeof parent !== "object" || parent === null) return false;
 			return leaf in parent;
 		}
-		/** 把一组 op 套到一个段值上（本地读数用，不写 host）。 */
 		function applyOps(section, ops) {
 			const next = structuredClone(section);
 			for (const op of ops) {
@@ -989,26 +804,15 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/schema-form/controller.ts
-		/** `role('select', { source })` 里声明的候选源名字。 */
 		function declaredSource(node) {
 			const extra = node?.meta.extra;
 			if (typeof extra !== "object" || extra === null) return void 0;
 			const name = Reflect.get(extra, "source");
 			return typeof name === "string" && name.length > 0 ? name : void 0;
 		}
-		/** 字段在状态表里的键（具体路径的 JSON）。 */
 		function fieldKey(path) {
 			return JSON.stringify(path);
 		}
-		/**
-		* rehydrate 一段配置 schema，并判它能不能当页面的根。
-		*
-		* 能当根的形状有三种：对象段、**相交段**（共享判别字段 + 各分支的 `const` 标记，段值仍是对象）、以及带判别
-		* 标签的 `union`（成员都是对象）。字面量 `union`（整段就是一个标量）不行：那一行的写盘会变成整段替换。
-		* @param serialized - host 发来的 `schema.toJSON()`。
-		* @param rehydrate - host schema 的 rehydrate。
-		* @returns schema 与它的字段树，或 `undefined`（不能当页面根）。
-		*/
 		function projectRoot(serialized, rehydrate) {
 			try {
 				const schema = rehydrate(serialized);
@@ -1026,16 +830,9 @@ window.__ModuleLoader__.load({
 				return;
 			}
 		}
-		/**
-		* 一行能否自动生成配置页：它的 schema 能 rehydrate 且根是 {@link projectRoot} 认的形状。
-		* @param view - host 发来的命名空间视图。
-		* @param rehydrate - host schema 的 rehydrate。
-		* @returns 是否可以渲染。
-		*/
 		function canRender(view, rehydrate) {
 			return view !== void 0 && projectRoot(view.schema, rehydrate) !== void 0;
 		}
-		/** 段根不是可渲染对象时的空字段树。 */
 		const NO_FIELDS = {
 			key: "",
 			path: [],
@@ -1045,23 +842,11 @@ window.__ModuleLoader__.load({
 			type: "object",
 			fields: []
 		};
-		/** 值里已有的键（数组给索引）。 */
 		function keysOf(value) {
 			if (Array.isArray(value)) return value.map((_item, index) => String(index));
 			if (typeof value === "object" && value !== null) return Object.keys(value);
 			return [];
 		}
-		/**
-		* 一个容器当前能加什么。
-		*
-		* 对象层（含相交与 union 的选中变体）是**非必填**、值里又没有的字段——必填的已经占着行了；字典层是业务注册的
-		* 候选键（模式清单这类运行期数据）。数组层不在这里：它的「添加一项」是追加一个空项，没有键名可选。
-		* @param node - 容器节点。
-		* @param path - 该容器的具体路径。
-		* @param value - 该容器自己的值（草稿后的）。
-		* @param hints - 提示面（只用到候选键）。
-		* @returns 可添加项，顺序即 schema / 读数的顺序；列表为空时页面不给输入框。
-		*/
 		function addableAt(node, path, value, hints) {
 			const current = variantOf(node, value);
 			if (current.type === "dict") {
@@ -1077,17 +862,6 @@ window.__ModuleLoader__.load({
 				description: field.meta.description ?? field.meta.comment
 			}] : []);
 		}
-		/**
-		* 一个字段的可选项。
-		*
-		* 字面量集合的 union（`z.union(["wal", "delete"])`）自己就带着候选；其余看提示面注册的读数——读的时候把依赖的
-		* 兄弟字段值喂进去，所以「选完服务商才列它有哪些模型」是投影的一部分，不是额外的一次订阅。
-		* @param node - 字段节点。
-		* @param path - 该字段的具体路径。
-		* @param value - 段值（草稿后的）。
-		* @param hints - 提示面。
-		* @returns 可选项；没有候选就是 `undefined`。
-		*/
 		function optionsFor(node, path, value, hints) {
 			const current = unwrapLazy(node);
 			if (current?.type === "union" && current.choices !== void 0) return current.choices.map((choice) => ({ value: choice }));
@@ -1098,9 +872,6 @@ window.__ModuleLoader__.load({
 			const options = spec.options((relative) => readPath(value, [...parent, ...relative]));
 			return options.length === 0 ? void 0 : options;
 		}
-		/**
-		* 一行配置页的控制器。
-		*/
 		var SchemaFormController = class {
 			#ns;
 			#deps;
@@ -1110,10 +881,6 @@ window.__ModuleLoader__.load({
 			#view;
 			#schema;
 			#root;
-			/**
-			* @param ns - settings 命名空间（行 id）。
-			* @param deps - 该行的共享表单与 schema 面。
-			*/
 			constructor(ns, deps) {
 				this.#ns = ns;
 				this.#deps = deps;
@@ -1132,7 +899,6 @@ window.__ModuleLoader__.load({
 				deps.describe.ensure();
 				this.#sync();
 			}
-			/** 槽位渲染器要的动作与状态。 */
 			face() {
 				return {
 					hooks: { schemaForm: this.#store },
@@ -1168,20 +934,16 @@ window.__ModuleLoader__.load({
 					}
 				};
 			}
-			/** 本行的 settings 命名空间。 */
 			namespace() {
 				return this.#ns;
 			}
-			/** 外部提示（候选键这类）变了：重新投影一次，字段树与草稿都不动。 */
 			refresh() {
 				this.#store.set(this.#project());
 			}
-			/** 释放订阅。 */
 			dispose() {
 				for (const dispose of this.#disposers.splice(0)) dispose();
 				this.#model.dispose();
 			}
-			/** 重新读 schema（describe 变了）：只换字段树，草稿与 store 不动。 */
 			#sync() {
 				const view = this.#deps.describe.getSnapshot().view?.namespaces.find((row) => row.ns === this.#ns);
 				this.#view = view;
@@ -1191,7 +953,6 @@ window.__ModuleLoader__.load({
 				this.#model.setRoot(projected?.root ?? NO_FIELDS);
 				this.#store.set(this.#project());
 			}
-			/** 整段校验：schema 先说话，再看数组的项身份有没有冲突。 */
 			#validate(deps, value) {
 				if (this.#schema !== void 0) {
 					const failure = deps.validate(this.#schema, value);
@@ -1208,7 +969,6 @@ window.__ModuleLoader__.load({
 					path: conflict.path
 				};
 			}
-			/** 渲染层读的一份完整投影。 */
 			#project() {
 				const fields = /* @__PURE__ */ new Map();
 				const root = this.#root;
@@ -1248,41 +1008,21 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region src/client/schema-form/hints.ts
-		/**
-		* 通用表单的提示面：业务知道、而 schema 表达不了的结构信息。
-		*
-		* 两件事：**dict 字段的候选键**（例如「会话模式」那一行，键是运行期清单里的模式 id，schema 里写不出来），以及
-		* **字段的候选值**（选服务商、选模型这类——候选来自部署里的另一份配置，还经常互相依赖）。业务在客户端注册一个
-		* 同步读数，表单一侧在投影时用它补出「未配置」行或把字段画成选择器。
-		*
-		* 读数必须是**同步**的：投影发生在渲染帧里。异步来源（HTTP / remote）由业务自己取好再注册；注册本身就当作一次
-		* 变更通知（所以"取到清单后再注册"是推荐用法）。
-		*/
-		/** 提示面的完整服务（业务用注册侧，表单一侧用读侧）。 */
 		var SchemaFormHints = class extends _deepseek_ai_cordis.Service {
 			#readers = /* @__PURE__ */ new Map();
 			#texts = /* @__PURE__ */ new Map();
 			#selects = /* @__PURE__ */ new Map();
 			#sources = /* @__PURE__ */ new Map();
 			#listeners = /* @__PURE__ */ new Set();
-			/** @param ctx - 提供本服务的插件上下文。 */
 			constructor(ctx) {
 				super(ctx, "schemaFormHints");
 			}
-			/** @param ns - settings 命名空间。 @param path - 字段路径。 @returns 该处的键。 */
 			keysFor(ns, path) {
 				return lookup(this.#readers, ns, path)?.() ?? [];
 			}
-			/** @param ns - settings 命名空间。 @param path - 字段路径。 @returns 该处注册的文案。 */
 			textFor(ns, path) {
 				return lookup(this.#texts, ns, path)?.() ?? {};
 			}
-			/**
-			* @param ns - settings 命名空间。
-			* @param path - 字段路径。
-			* @param spec - 候选取法与依赖。
-			* @returns 注销函数。
-			*/
 			select(ns, path, spec) {
 				const key = locationKey(ns, path);
 				this.#selects.set(key, spec);
@@ -1293,15 +1033,9 @@ window.__ModuleLoader__.load({
 					this.#publish();
 				};
 			}
-			/** @param ns - settings 命名空间。 @param path - 字段路径。 @returns 该处注册的候选读数。 */
 			selectFor(ns, path) {
 				return lookup(this.#selects, ns, path);
 			}
-			/**
-			* @param name - 源的名字。
-			* @param spec - 候选取法与依赖。
-			* @returns 注销函数。
-			*/
 			source(name, spec) {
 				this.#sources.set(name, spec);
 				this.#publish();
@@ -1311,16 +1045,9 @@ window.__ModuleLoader__.load({
 					this.#publish();
 				};
 			}
-			/** @param name - 源的名字。 @returns 该源注册的候选读数。 */
 			sourceFor(name) {
 				return this.#sources.get(name);
 			}
-			/**
-			* @param ns - settings 命名空间。
-			* @param path - 字段路径。
-			* @param read - 同步读数。
-			* @returns 注销函数。
-			*/
 			describe(ns, path, read) {
 				const key = locationKey(ns, path);
 				this.#texts.set(key, read);
@@ -1331,12 +1058,6 @@ window.__ModuleLoader__.load({
 					this.#publish();
 				};
 			}
-			/**
-			* @param ns - settings 命名空间。
-			* @param path - 字段路径。
-			* @param read - 同步读数。
-			* @returns 注销函数。
-			*/
 			suggestKeys(ns, path, read) {
 				const key = locationKey(ns, path);
 				this.#readers.set(key, read);
@@ -1347,20 +1068,12 @@ window.__ModuleLoader__.load({
 					this.#publish();
 				};
 			}
-			/**
-			* 观察候选键的变化（注册与注销）。
-			* @param listener - 变更回调。
-			* @returns 取消订阅。
-			*/
 			subscribe(listener) {
 				this.#listeners.add(listener);
 				return () => {
 					this.#listeners.delete(listener);
 				};
 			}
-			/**
-			* 重新通知一次：读数背后的数据变了（业务自己知道），页面据此重算候选行。
-			*/
 			refresh() {
 				this.#publish();
 			}
@@ -1368,19 +1081,9 @@ window.__ModuleLoader__.load({
 				for (const listener of this.#listeners) listener();
 			}
 		};
-		/** 一处字段的定位键（命名空间 + 路径）。 */
 		function locationKey(ns, path) {
 			return `${ns}\u0000${path.join("\0")}`;
 		}
-		/**
-		* 按具体路径找一处注册：先精确匹配，再试**模板变体**（动态键 / 数组下标的段写成 `*`）。
-		*
-		* 业务因此可以注册一次 `models.*.provider` 就覆盖每个模式，不必知道运行期有哪些键。
-		* @param map - 某类注册表。
-		* @param ns - settings 命名空间。
-		* @param path - 具体路径。
-		* @returns 命中的注册，或 `undefined`。
-		*/
 		function lookup(map, ns, path) {
 			const exact = map.get(locationKey(ns, path));
 			if (exact !== void 0) return exact;
@@ -1389,19 +1092,12 @@ window.__ModuleLoader__.load({
 				if (hit !== void 0) return hit;
 			}
 		}
-		/** 具体路径的模板变体（首段是顶层字段名，保持原样）：通配得多的先试。 */
 		function* templates(path) {
 			const wildcardable = Math.max(0, path.length - 1);
 			for (let bits = (1 << wildcardable) - 1; bits > 0; bits--) yield path.map((segment, index) => index > 0 && (bits & 1 << index - 1) !== 0 ? "*" : segment);
 		}
 		//#endregion
 		//#region src/client/schema-form/locales.ts
-		/**
-		* 本包字典（命名空间 `settings.schema-form`）：表单壳、字段控件与只读呈现的文案。
-		*
-		* 字段自身的人话标签不在这里（那是业务方经字段槽或 schema `description` 给的），这里只放**机制**文案。
-		*/
-		/** 中文文案（部署语言偏好是 zh）。 */
 		const zh = {
 			unavailable: "该插件当前未加载，暂时无法配置。",
 			readOnly: "本部署的设置为只读。",
@@ -1456,7 +1152,6 @@ window.__ModuleLoader__.load({
 			duplicateItem: "重复的 {key}：{value}",
 			missingItem: "每一项都需要一个 {key}"
 		};
-		/** 英文文案。 */
 		const en = {
 			unavailable: "This plugin is not loaded, so it cannot be configured right now.",
 			readOnly: "This deployment stores settings read-only.",
@@ -1513,12 +1208,6 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region src/client/schema-form/rows.ts
-		/**
-		* 配对命名空间与 bundle 行清单。
-		* @param namespaces - host 发来的命名空间视图。
-		* @param bundles - host 的 bundle 清单（含各 bundle 声明的行 id）。
-		* @returns 该自动注册的行，按命名空间视图的顺序。
-		*/
 		function rowRegistrations(namespaces, bundles) {
 			const owners = /* @__PURE__ */ new Map();
 			for (const bundle of bundles) for (const row of bundle.rows) owners.set(row.rowId, bundle.name);
@@ -1534,28 +1223,15 @@ window.__ModuleLoader__.load({
 			}
 			return plans;
 		}
-		/** 自动项的兜底优先级：手写卡片（默认 0）遮住它。 */
 		const FALLBACK_PRIORITY = 100;
-		/**
-		* 自动注册的差分器：按 describe 与 bundle 清单把「该有的行」与「已在的行」对齐。
-		*/
 		var RowRegistration = class {
 			#deps;
 			#live = /* @__PURE__ */ new Map();
 			#pending;
 			#disposed = false;
-			/**
-			* @param deps - 槽位、清单读面与每行的槽项工厂。
-			*/
 			constructor(deps) {
 				this.#deps = deps;
 			}
-			/**
-			* 对齐一次：新增该有的行，注销不该有的行。
-			*
-			* 并发调用折叠成一次（bundle 清单只读一趟），后到的调用等同一趟结束。
-			* @returns 对齐完成。
-			*/
 			sync() {
 				if (this.#disposed) return Promise.resolve();
 				this.#pending ??= this.#run().finally(() => {
@@ -1563,7 +1239,6 @@ window.__ModuleLoader__.load({
 				});
 				return this.#pending;
 			}
-			/** 收掉自己：注销还活着的全部注册并释放它们的控制器。 */
 			dispose() {
 				this.#disposed = true;
 				this.#release();
@@ -1596,7 +1271,6 @@ window.__ModuleLoader__.load({
 					this.#live.set(ns, dispose);
 				}
 			}
-			/** 注销全部并释放控制器。 */
 			#release() {
 				for (const [ns, dispose] of this.#live) {
 					dispose();
@@ -1607,7 +1281,6 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region src/client/schema-form/labels.ts
-		/** 字段的说明（`description` 本地化后 + `comment`），没有就是 undefined。 */
 		function fieldHint(node, resolveText) {
 			const parts = [];
 			if (node.meta.description !== void 0) parts.push(resolveText(node.meta.description));
@@ -1616,21 +1289,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/schema-form/lines.ts
-		/**
-		* 行模型：把字段树（`walkFields` 的结果）排成**编辑器的行**——结构行（`{` / `[` / `}` / `]`）、字段行、注释行、
-		* 以及容器尾部的添加行。
-		*
-		* 渲染层因此只按行画，不必自己递归：行序 = 视觉顺序，行号连续。折叠在这里生效（折叠的容器只留开启行）。
-		*/
-		/**
-		* 容器的形状：对象类用 `{}`，序列类用 `[]`。
-		*
-		* union 没有自己的形状——它跟着**当前选中那一支**走（`access` 是数组就在页面上画 `[`），这也是
-		* `access: string | string[]` 这类字段以前被画成对象容器的原因。
-		* @param node - 字段节点。
-		* @param value - 这一层的值（选支判据）。
-		* @returns 形状；叶子节点是 `undefined`。
-		*/
 		function containerShape(node, value) {
 			switch (variantOf(node, value).type) {
 				case "object":
@@ -1641,7 +1299,6 @@ window.__ModuleLoader__.load({
 				default: return;
 			}
 		}
-		/** 渲染顺序里可见的字段：折叠的容器把整棵子树滤掉，只留它自己的开启行。 */
 		function visibleFields(state, fold) {
 			const containers = new Set(state.walked.filter((item) => containerShape(item.node, valueAt(state, item.path)) !== void 0).map((item) => fieldKey(item.path)));
 			return state.walked.filter((item) => {
@@ -1652,11 +1309,9 @@ window.__ModuleLoader__.load({
 				return true;
 			});
 		}
-		/** 这一层的当前值：与字段行显示的是同一份读数（草稿优先）。 */
 		function valueAt(state, path) {
 			return state.fields.get(fieldKey(path))?.value;
 		}
-		/** 这一层能加什么：数组追加空项，字典敲键名（可来自候选），对象从还没配的声明字段里选。 */
 		function addOf(node, shape, options) {
 			if (shape === "array") return { kind: "item" };
 			if (unwrapLazy(node)?.type === "dict") return {
@@ -1668,7 +1323,6 @@ window.__ModuleLoader__.load({
 				options
 			};
 		}
-		/** 一个节点上的变体切换控件：不是 union、或只有一支、或成员全是常量（字面量集合是选择器）时没有。 */
 		function variantsOf(node, value) {
 			const union = unionOf(node);
 			if (union === void 0 || union.choices !== void 0 || union.variants.length < 2) return void 0;
@@ -1677,14 +1331,6 @@ window.__ModuleLoader__.load({
 				selected: union.variants.indexOf(variantOf(union, value))
 			};
 		}
-		/**
-		* 排成行序列。
-		* @param state - 页面读数。
-		* @param fold - 折叠状态。
-		* @param resolveText - `description` 的本地化。
-		* @param t - 本包字典。
-		* @returns 行序列（行号即下标）。
-		*/
 		function editorLines(state, fold, resolveText, t) {
 			const lines = [];
 			const open = [];
@@ -1773,10 +1419,6 @@ window.__ModuleLoader__.load({
 			}
 			return moveVariantControlToTag(lines);
 		}
-		/**
-		* 判别式 union 的切换控件挪到**标签字段那一行**上：`session-rdb` 的页面上用户改的就是 `type`，把它放在容器
-		* 行上等于让人在两处看同一件事。没有标签字段（`access` 这种按值形状选的）就留在 union 自己那一行。
-		*/
 		function moveVariantControlToTag(lines) {
 			for (const line of lines) {
 				if (line.kind === "comment" || line.kind === "close") continue;
@@ -1792,12 +1434,6 @@ window.__ModuleLoader__.load({
 			}
 			return lines;
 		}
-		/**
-		* 一行的注释：业务给的文案（字段槽的 label/hint）优先，其次 schema 的说明。
-		*
-		* 这一行有问题时**注释位让给那条消息**（参考实现也是把错误画在行尾那一段的位置上）——说明换成"哪里不对"，
-		* 错误因此不必挤在值后面。
-		*/
 		function commentFor(state, item, resolveText, t) {
 			const key = fieldKey(item.path);
 			const failure = state.fields.get(key)?.invalid ?? state.invalidAt.get(key);
@@ -1817,7 +1453,6 @@ window.__ModuleLoader__.load({
 				invalid: false
 			};
 		}
-		/** `path` 是不是 `prefix` 的后代（含自身）。 */
 		function isPrefix(prefix, path) {
 			if (prefix.length > path.length) return false;
 			return prefix.every((segment, index) => path[index] === segment);
@@ -2100,10 +1735,6 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/styling/styled.tsx
 		const sxSymbol = Symbol("styled.sx");
-		/**
-		* `styled('div')({ padding: '4px' }, { '&:hover': { … } })` → 带 `data-css-*` 的组件。
-		* 多个样式对象按顺序深合并（后者覆盖前者），便于把变体叠在基样式上。
-		*/
 		function styled(Component, defaultProps = {}) {
 			return (...styles) => {
 				const sx = styles.reduce((merged, style) => toMerged(merged, style), {});
@@ -2120,19 +1751,11 @@ window.__ModuleLoader__.load({
 				return Object.assign(Styled, { [sxSymbol]: sx });
 			};
 		}
-		/** 取回 styled 组件携带的样式对象（需要在其之上继续组合时用）。 */
 		function styleOf(component) {
 			return component[sxSymbol];
 		}
 		//#endregion
 		//#region src/client/theme.generated.ts
-		/**
-		* 官方主题的 `--dsw-*` token 全集（400 个），由 packages/client/ui-primitives/scripts/gen-design-tokens.mts 生成，勿手改。
-		*
-		* 叶子是该变量的**默认值**（官方 light 主题里首次出现的定义）：既是类型推导的来源，也可作 fallback。
-		* `"$"` 键出现在「自身也是 token 的分支」上（命名体系里有 40 个短名同时是长名前缀的 token）。
-		* 消费时只需树形状——`Token.vars()` 生成 `var(--dsw-…)`，不重新定义变量。
-		* 漂移、往返与默认值完整性由 src/__tests__/design-tokens.spec.ts 守卫。 */
 		const designTokens = {
 			alias: {
 				bg: {
@@ -2808,36 +2431,18 @@ window.__ModuleLoader__.load({
 		const dsw = Token.vars(designTokens, { prefix: "dsw" });
 		//#endregion
 		//#region src/client/schema-form/styles.ts
-		/**
-		* 行式编辑器的样式：等宽、行号、语法色、悬停行为——全部消费官方 `--dsw-*` token。
-		*
-		* 几何只有一套：行高、行内间距、动作按钮尺寸都由下面几个常量给，行与行之间不各自决定。
-		*/
-		/** 等宽字体栈：配置值的观感与代码一致。 */
 		const MONO = "ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace";
-		/** 行高：行内容、行内输入、折叠箭头、按钮排都在这一档上对齐。 */
 		const ROW = "22px";
-		/** 行内元素之间的间距。 */
 		const GAP = "6px";
-		/** 动作按钮：方形图标键，尺寸与行高同一档的紧凑版。 */
 		const ACTION = "20px";
-		/** 动作按钮之间的间距（比行内间距紧一档）。 */
 		const ACTION_GAP = "4px";
-		/** 折叠列（chevron 与它的占位）宽度。 */
 		const FOLD = "14px";
-		/** 行号列宽度。 */
 		const NUMBER = "32px";
-		/** 行尾留白。 */
 		const PAD = "8px";
-		/** 细线：theme 给的 0.5px 描边（`0 0 0 0.5px var(--dsw-elevation-stroke-color)`）。 */
 		const HAIRLINE = dsw.elevation.stroke;
-		/** 描边色：theme 里给描边用的那一档（与官方 `Menu` 面板同源）。 */
 		const LINE = dsw.elevation.stroke.color;
-		/** 行左侧那道「改过」的标记宽度。 */
 		const EDGE = "2px";
-		/** 出错那一行的底色：theme 的红掺进透明里（半透明红），比整行实红轻、又比只有一道条明显。 */
 		const ERROR_WASH = `color-mix(in srgb, ${String(dsw.alias.state.error.secondary)} 12%, transparent)`;
-		/** 编辑器的根：纵向排列的行。 */
 		const EditorRoot = styled("div")({
 			display: "flex",
 			flexDirection: "column",
@@ -2847,7 +2452,6 @@ window.__ModuleLoader__.load({
 			lineHeight: ROW,
 			color: dsw.alias.label.primary
 		});
-		/** 一行：行号 + 折进 + 行内容。悬停给一层浅底。 */
 		const LineRow = styled("div")({
 			display: "flex",
 			alignItems: "flex-start",
@@ -2868,7 +2472,6 @@ window.__ModuleLoader__.load({
 			"&[data-invalid='true'] [data-role='key']": { color: dsw.alias.state.error.primary },
 			"&:hover [data-role='actions']": { opacity: 1 }
 		});
-		/** 一行的内容区：**缩进只作用在这里**——行号列固定在左边，缩进不推它。 */
 		const LineBody = styled("div")({
 			display: "flex",
 			alignItems: "center",
@@ -2877,7 +2480,6 @@ window.__ModuleLoader__.load({
 			minWidth: 0,
 			minHeight: ROW
 		});
-		/** 行号列：右对齐、不可选、淡色。 */
 		const LineNumber = styled("span")({
 			flex: "none",
 			width: NUMBER,
@@ -2887,7 +2489,6 @@ window.__ModuleLoader__.load({
 			userSelect: "none",
 			cursor: "pointer"
 		});
-		/** 折叠 chevron（官方箭头图标，尺寸与别的行内图标同源）。 */
 		const LineFold = styled("button")({
 			display: "inline-flex",
 			alignItems: "center",
@@ -2902,23 +2503,19 @@ window.__ModuleLoader__.load({
 			cursor: "pointer",
 			"&:hover": { color: dsw.alias.label.secondary }
 		});
-		/** 叶子行的折叠占位（保持列对齐）。 */
 		const LineFoldSpacer = styled("span")({
 			flex: "none",
 			width: FOLD
 		});
-		/** 键名（配置键原样；数组下标淡一些）。 */
 		const LineKey = styled("span")({
 			flex: "none",
 			color: dsw.alias.label.primary,
 			"&[data-index='true']": { color: dsw.alias.label.caption }
 		});
-		/** 结构符与标点（`{` `}` `[` `]` `:`）。 */
 		const LineToken = styled("span")({
 			flex: "none",
 			color: dsw.alias.label.caption
 		});
-		/** 值（token）：字符串 / 数字 / 布尔各有语法色。 */
 		const LineValue = styled("span")({
 			minWidth: 0,
 			overflow: "hidden",
@@ -2929,9 +2526,6 @@ window.__ModuleLoader__.load({
 			"&[data-tone='boolean']": { color: dsw.alias.state.success.primary },
 			"&[data-tone='empty']": { color: dsw.alias.label.caption }
 		});
-		/**
-		* 值上的下拉触发：**它自己就是值的呈现**（不再是「值 + 一个下拉」两遍），点开才出菜单。
-		*/
 		const ValueTrigger = styled("button")({
 			display: "inline-flex",
 			alignItems: "center",
@@ -2947,11 +2541,6 @@ window.__ModuleLoader__.load({
 			"&:disabled": { cursor: "default" },
 			"&:focus-visible": { outline: "none" }
 		});
-		/**
-		* 行内输入的外壳：官方 `Input` 压到与值同一行高，并**吃掉剩下的宽度**。
-		*
-		* 行内编辑与容器闭合行的添加输入共用它——两处的输入框因此长得一模一样。
-		*/
 		const CompactInput = styled("span")({
 			display: "inline-flex",
 			flex: "1 1 auto",
@@ -2967,10 +2556,6 @@ window.__ModuleLoader__.load({
 				lineHeight: ROW
 			}
 		});
-		/**
-		* 多行值的行内输入：官方没有多行原子，所以这里用同一套观感的字段壳（同边框、同圆角、同焦点色），
-		* 高度跟着内容长、宽度同样撑满剩下的位置。
-		*/
 		const CompactTextField = styled("span")({
 			display: "inline-flex",
 			flex: "1 1 auto",
@@ -2998,7 +2583,6 @@ window.__ModuleLoader__.load({
 				color: dsw.alias.label.primary
 			}
 		});
-		/** 行内注释（schema 说明与业务文案）：比配置值小一档，占满这一行剩下的宽度，长了就截断（hover 看全文）。 */
 		const LineComment = styled("span")({
 			flex: "1 1 auto",
 			minWidth: 0,
@@ -3008,16 +2592,12 @@ window.__ModuleLoader__.load({
 			fontFamily: "inherit",
 			fontSize: "12px"
 		});
-		/** 行内的校验消息（与注释放同一档字号）。 */
 		const LineInvalid = styled("span")({
 			flex: "none",
 			color: dsw.alias.state.error.primary,
 			fontFamily: "inherit",
 			fontSize: "12px"
 		});
-		/**
-		* 悬停行时才显示这一行的动作按钮：显形规则写在行上（`[data-role='actions']`），组件只需要带这个属性。
-		*/
 		const HoverActions = styled(styled("span")({
 			display: "inline-flex",
 			alignItems: "center",
@@ -3045,12 +2625,7 @@ window.__ModuleLoader__.load({
 					color: dsw.alias.label.dimmed
 				}
 			}
-		}))({ 
-		/**
-		* 编辑态的两个按钮常显，而且**要有底色与描边**：行底色上只有淡色图标是看不见的，
-		* 所以这里给实体按钮（theme 的描边 + 一层底），确认用成功档、取消用中性档。
-		*/
-"&[data-editing='true']": {
+		}))({ "&[data-editing='true']": {
 			opacity: 1,
 			gap: GAP,
 			"& > button": {
@@ -3060,7 +2635,6 @@ window.__ModuleLoader__.load({
 				"&:first-of-type": { color: dsw.alias.state.success.primary }
 			}
 		} });
-		/** 添加输入：**跟在容器的闭合括号同一行**（菜单锚在它上面），宽度吃掉剩下的位置。 */
 		const AddWrap = styled("span")({
 			position: "relative",
 			display: "inline-flex",
@@ -3071,7 +2645,6 @@ window.__ModuleLoader__.load({
 			marginLeft: GAP,
 			"&[data-invalid='true'] input": { borderColor: dsw.alias.state.error.primary }
 		});
-		/** 一行说明（不可用 / 没有可生成项时用）。 */
 		const Hint$1 = styled("p")({
 			margin: 0,
 			fontSize: "12px",
@@ -3080,42 +2653,27 @@ window.__ModuleLoader__.load({
 		});
 		//#endregion
 		//#region src/client/schema-form/value.tsx
-		/**
-		* 行内值的呈现与编辑文本规则，以及字段槽注册方复用的默认值组件。
-		*
-		* 值本身仍走草稿：这个文件只决定"怎么显示"（语法色 token、下拉触发的呈现）与"怎么编辑"（一行输入框里的文本
-		* 形状——字符串把换行写成 `\n`，与一行的输入框相配）。
-		*/
-		/** 编辑态文本：字符串就是原文（换行照旧），其余按 JSON 写。 */
 		function valueText(value) {
 			if (value === void 0 || value === null) return "";
 			if (typeof value === "string") return value;
 			if (typeof value === "number" || typeof value === "boolean") return String(value);
 			return JSON.stringify(value);
 		}
-		/** 这个值要在多行输入里编辑吗（字符串带换行）。 */
 		function isMultiline(value) {
 			return typeof value === "string" && /[\r\n]/.test(value);
 		}
-		/** 显示态文本：字符串带引号；多行与特殊字符都按 JSON 的写法收在一行里。 */
 		function tokenText(value) {
 			if (value === void 0 || value === null) return "null";
 			if (typeof value === "string") return JSON.stringify(value);
 			if (typeof value === "number" || typeof value === "boolean") return String(value);
 			return JSON.stringify(value);
 		}
-		/** 值的语法色分组。 */
 		function tokenTone(value) {
 			if (value === void 0 || value === null) return "empty";
 			if (typeof value === "number") return "number";
 			if (typeof value === "boolean") return "boolean";
 			return "string";
 		}
-		/**
-		* 行内值的默认呈现（显示态 token）。
-		* @param props.owner - 字段上下文（值、是否 secret、只读原因）。
-		* @returns 一行里的值节点。
-		*/
 		function InlineValue({ owner }) {
 			if (owner.options !== void 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OptionSelect, {
 				owner,
@@ -3132,11 +2690,6 @@ window.__ModuleLoader__.load({
 				children: tokenText(owner.value)
 			});
 		}
-		/**
-		* 选择器：**值本身**就是下拉的触发（不再另画一个 `select` 与它并列），点开是官方菜单。
-		*
-		* 当前值不在候选里时（例如目录里已经没有那个服务商）照原样显示，选中才换成新值。
-		*/
 		function OptionSelect({ owner, options }) {
 			const [open, setOpen] = (0, react.useState)(false);
 			const selected = options.findIndex((option) => sameValue(option.value, owner.value));
@@ -3175,31 +2728,16 @@ window.__ModuleLoader__.load({
 				})
 			});
 		}
-		/** 值是否就是这一项（菜单的高亮判据）。 */
 		function sameValue(left, right) {
 			if (Object.is(left, right)) return true;
 			if (typeof left !== "object" || typeof right !== "object" || left === null || right === null) return false;
 			return JSON.stringify(left) === JSON.stringify(right);
 		}
-		/**
-		* 字段槽注册方复用的默认值：只改文案时拿它包一层即可（`owner` 上覆盖 `label`/`hint`）。
-		*
-		* 注意行式视图里键名来自配置键本身、注释来自 `hint`，所以 `label` 只在业务自写控件时才需要。
-		*/
 		function SchemaFieldDefault({ owner }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InlineValue, { owner });
 		}
 		//#endregion
 		//#region src/client/schema-form/fields.tsx
-		/**
-		* 各类型的文本解析规则（消息来自本包字典）。
-		*
-		* 解析不只看类型：schema 上声明的界限（`pattern` / `min` / `max` / `step`）与字面量集合都在这里说话——
-		* 用户敲完当场就知道对不对，而不是等保存时被整段校验退回。
-		* @param node - 字段节点（`meta` 是约束的来源）。
-		* @param t - 本包字典。
-		* @returns 这段文本的解析规则。
-		*/
 		function parseFor(node, t) {
 			switch (node.type) {
 				case "number": return (text) => {
@@ -3313,20 +2851,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/schema-form/Editor.tsx
-		/**
-		* 行式编辑器：按 `editorLines` 排出的行画 JSON 结构视图——行号、折进、`key: value`、结构行、注释行、容器闭合行
-		* 后面的添加入口；值在行内点开编辑（Enter 提交 / Esc 撤销）。
-		*
-		* 缩进只作用在**行内容**上（行号列固定），添加输入与闭合括号同一行；行内控件用官方的 `Input` / `Menu` / `Button`，
-		* 与设置页其余部分同一套视觉与键盘行为。
-		*
-		* 字段槽仍然生效：命中时该字段**值**的位置换成注册方的组件，键名、注释、行号与行为按钮仍由这里画。
-		*/
-		/**
-		* 画一行的配置。
-		* @param props - 读数、动作、字典与字段槽入口。
-		* @returns 行式编辑器。
-		*/
 		function Editor(props) {
 			const { ns, state, face, t, resolveText, renderField } = props;
 			const [toggled, setToggled] = (0, react.useState)(() => /* @__PURE__ */ new Set());
@@ -3377,7 +2901,6 @@ window.__ModuleLoader__.load({
 				}, `${line.kind}:${fieldKey(line.path)}:${String(index)}`))
 			});
 		}
-		/** 折叠状态：记「用户切换过的路径」，开合 = 切换过就反转 schema 的默认值。 */
 		function useFold(state, toggled, setToggled) {
 			const defaults = (0, react.useMemo)(() => {
 				const collapsed = /* @__PURE__ */ new Set();
@@ -3405,7 +2928,6 @@ window.__ModuleLoader__.load({
 				toggled
 			]);
 		}
-		/** 一行的渲染分派。 */
 		function Row({ line, n, ns, state, face, fold, t, resolveText, disabled, editing, selected, dismissed, onEdit, onAdded, onDismiss, onSelect, renderField }) {
 			const key = fieldKey(line.path);
 			const indent = { paddingLeft: `${String(line.depth * 14)}px` };
@@ -3485,7 +3007,6 @@ window.__ModuleLoader__.load({
 				})]
 			});
 		}
-		/** 字段行：`key: value`（数组成员的键名是下标，淡一些）。 */
 		function FieldLine({ line, ns, state, face, t, disabled, editing, dismissed, onEdit, onDismiss, renderField }) {
 			const key = fieldKey(line.path);
 			const member = line.member;
@@ -3642,11 +3163,9 @@ window.__ModuleLoader__.load({
 				})
 			] });
 		}
-		/** 复制用的文本（字符串带引号，粘到哪里都是合法片段）。 */
 		function tokenFor(value) {
 			return typeof value === "string" ? JSON.stringify(value) : JSON.stringify(value ?? null);
 		}
-		/** 变体切换：判别式 union 挂在标签行上，按形状选的挂在字段行上。触发元素就是当前那一支。 */
 		function VariantSelect({ control, path, face, disabled, t }) {
 			const [open, setOpen] = (0, react.useState)(false);
 			if (control === void 0) return null;
@@ -3685,7 +3204,6 @@ window.__ModuleLoader__.load({
 				})
 			});
 		}
-		/** 开启行的前缀：字段键名（对象里的一层）或数组成员的下标；成员行另外带移除。 */
 		function LinePrefix({ line, face, t, disabled }) {
 			const member = line.member;
 			const key = member?.key ?? line.node.key;
@@ -3710,7 +3228,6 @@ window.__ModuleLoader__.load({
 				})
 			] });
 		}
-		/** 成员行的移除（悬停时出现）：数组项按索引、字典键按键名。 */
 		function RemoveLineButton({ member, face, t, disabled }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 				type: "button",
@@ -3724,12 +3241,6 @@ window.__ModuleLoader__.load({
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutlineRegular, { size: 14 })
 			});
 		}
-		/**
-		* 容器闭合行后面的添加入口。
-		*
-		* 数组是「追加一个空项」；对象/字典给出**候选**——对象列的是 schema 声明了、值里还没有的字段（带说明），
-		* 字典列的是业务注册的候选键（还能自己敲键名）。粘一整段 `{…}` / `[…]` 则整层覆盖。
-		*/
 		function AddLine({ line, state, face, t, resolveText, disabled, onAdded }) {
 			const spec = line.add;
 			const [text, setText] = (0, react.useState)("");
@@ -3824,17 +3335,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/schema-form/SchemaForm.tsx
-		/**
-		* 一行的配置页：官方表单壳（保存 / 丢弃 / 只读 / 不可用）+ 行式 JSON 结构编辑器 + 字段槽。
-		*
-		* 每个可渲染的行注册项经 `renderFactorySlot('settings.schema-form.form', …)` 渲染这个 Factory，字段槽因此只需在
-		* Factory 的 `children` 里声明一次（slots 的 children 声明 per key 唯一，而本包给每个行都注册了一项）。
-		*/
-		/**
-		* 渲染一行的配置页。
-		* @param props - 行 id、控制器面、本地化解析与框架注入的槽位渲染座位。
-		* @returns 表单壳里的行式编辑器，或「没有可自动生成的配置项」一行。
-		*/
 		function SchemaForm(props) {
 			const { ns, face, t, resolveText, renderSlotChain } = props;
 			const store = face.hooks.schemaForm;
@@ -3876,7 +3376,6 @@ window.__ModuleLoader__.load({
 				})]
 			});
 		}
-		/** 文本草稿的解析规则按字段类型给：行内编辑只上报原文，值在保存那一刻成形。 */
 		function withParse(owner, t) {
 			return (text, parse) => {
 				owner.onEditText(text, parse ?? parseFor(owner.node, t));
@@ -3907,9 +3406,7 @@ window.__ModuleLoader__.load({
 			visibleFields: () => visibleFields,
 			walkFields: () => walkFields
 		});
-		/** 本包字典与槽位文案的命名空间。 */
 		const NS = "settings.schema-form";
-		/** 需要的服务：槽位、字典、共享配置表单、schema 服务与插件管理（bundle 行清单）。 */
 		const inject$1 = [
 			"slots",
 			"locale",
@@ -3918,10 +3415,6 @@ window.__ModuleLoader__.load({
 			"remote",
 			"remote.pluginManager"
 		];
-		/**
-		* 装上本包：字典、Factory（字段槽的声明者）与按行自动注册。
-		* @param ctx - 浏览器插件上下文。
-		*/
 		function apply$1(ctx) {
 			ctx.effect(() => ctx.locale.register(NS, {
 				zh,
@@ -4030,26 +3523,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/settings-form/form-model.ts
-		/**
-		* The staged form model behind a plugin's settings page.
-		*
-		* A card stages what the user types and writes it only when they save. Each
-		* settings write is a durable, revision-fenced document mutation, so a control
-		* that committed as it settled turned one edit into a write the user never
-		* asked for and could not preview; staged text makes what is on screen exactly
-		* what a save would store.
-		*
-		* A field shows its effective value — the user layer over the composition
-		* layer over the schema default — and whether the user layer carries it. That
-		* presence, not a value comparison, is what marks a field overridden: an
-		* override equal to the composition default is still an override.
-		*/
-		/**
-		* A whole-number field. An empty draft clears the field; any other draft that
-		* is not a finite number blocks the save.
-		* @param field - field name inside the namespace section.
-		* @returns the field's conversion spec.
-		*/
 		function settingsNumberField(field) {
 			return {
 				field,
@@ -4065,12 +3538,6 @@ window.__ModuleLoader__.load({
 				}
 			};
 		}
-		/**
-		* A free-text field. An empty draft clears the field, so emptying the control
-		* and saving is the same gesture as resetting it.
-		* @param field - field name inside the namespace section.
-		* @returns the field's conversion spec.
-		*/
 		function settingsTextField(field) {
 			return {
 				field,
@@ -4084,13 +3551,6 @@ window.__ModuleLoader__.load({
 				}
 			};
 		}
-		/**
-		* Stages one card's edits over one settings namespace and writes them on save.
-		*
-		* The form publishes through a snapshot store because slot components read
-		* through a snapshot selector, while both the scope and the local drafts
-		* change underneath; every projection is rebuilt from the two together.
-		*/
 		var SettingsFormModel = class {
 			scope;
 			specs;
@@ -4101,11 +3561,6 @@ window.__ModuleLoader__.load({
 			unsubscribe;
 			saving = false;
 			failed = false;
-			/**
-			* @param scope - the shared configuration form for this card's namespace.
-			* @param specs - the section fields this card edits.
-			* @param secrets - the card's write-only controls, written outside the section.
-			*/
 			constructor(scope, specs, secrets = []) {
 				this.scope = scope;
 				this.specs = new Map(specs.map((spec) => [spec.field, spec]));
@@ -4114,11 +3569,6 @@ window.__ModuleLoader__.load({
 					this.publish();
 				});
 			}
-			/**
-			* Publish a projection of this form, rebuilt whenever the scope or a draft changes.
-			* @param project - build the card's state from the form's current reads.
-			* @returns the store the card's component reads through its bound selector.
-			*/
 			bind(project) {
 				const store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)(project());
 				this.listeners.add(() => {
@@ -4126,10 +3576,6 @@ window.__ModuleLoader__.load({
 				});
 				return store;
 			}
-			/**
-			* Read the card-level state: what the Host serves, and what a save would do.
-			* @returns the form state every card shares.
-			*/
 			shell() {
 				const snapshot = this.scope.getSnapshot();
 				const plan = this.plan();
@@ -4142,11 +3588,6 @@ window.__ModuleLoader__.load({
 					failed: this.failed
 				};
 			}
-			/**
-			* Read one control's state.
-			* @param field - field name of a section field or of a write-only control.
-			* @returns the draft text, whether a save would leave an override, and whether it is invalid.
-			*/
 			field(field) {
 				const staged = this.staged.get(field);
 				if (this.secretSpecs.has(field)) return {
@@ -4167,10 +3608,6 @@ window.__ModuleLoader__.load({
 					invalid: write === void 0
 				};
 			}
-			/**
-			* Build the edit, reset, save, and discard actions bound to this form.
-			* @returns the actions a card's slot entry injects.
-			*/
 			actions() {
 				return {
 					edit: (field, text) => {
@@ -4197,15 +3634,6 @@ window.__ModuleLoader__.load({
 					}
 				};
 			}
-			/**
-			* Write every staged edit, then re-seed from what the Host accepted.
-			*
-			* The Host is the only authority on whether a value was accepted — its
-			* validators own the constraints no schema can express — so the outcome is
-			* read back from the section rather than predicted here. A save that did not
-			* land keeps its drafts, so the user can correct them instead of retyping.
-			* @returns settlement after every write and the read-back.
-			*/
 			async save() {
 				const plan = this.plan();
 				if (!plan.length || this.saving || !this.scope.getSnapshot().writable || plan.some((item) => item.run === void 0 && item.op === void 0)) return;
@@ -4232,17 +3660,10 @@ window.__ModuleLoader__.load({
 					this.publish();
 				}
 			}
-			/** Release the form's accepted-value subscription. */
 			dispose() {
 				this.unsubscribe();
 				this.listeners.clear();
 			}
-			/**
-			* Every staged edit a save would write. An entry whose draft is not a value
-			* its field accepts carries no write: the form is still dirty, and the save
-			* refuses rather than dropping the edit.
-			* @returns the planned writes, in the order the fields were staged.
-			*/
 			plan() {
 				const plan = [];
 				for (const [field, staged] of this.staged) {
@@ -4469,7 +3890,6 @@ window.__ModuleLoader__.load({
 		const Input = styled("input")(styles$1.input);
 		const Invalid = styled("p")(styles$1.invalid);
 		const Hint = styled("p")(styles$1.hint);
-		/** 上游 icons 里的 IconInfoOutlineRegular（fill-only 几何，整份图标表不搬）。 */
 		function InfoGlyph({ size }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
 				width: size,
@@ -4494,13 +3914,6 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
-		/**
-		* A staged value field. `numeric` only hints the keypad: which drafts a field
-		* accepts is decided by its spec, so the control never silently rewrites what
-		* the user typed.
-		* @param props - the field's copy, its staged text, and the edit actions.
-		* @returns the labelled control.
-		*/
 		function SettingsValueField(props) {
 			const [helpOpen, setHelpOpen] = (0, react.useState)(false);
 			const helpId = `${props.id}-help`;
@@ -4554,14 +3967,6 @@ window.__ModuleLoader__.load({
 				}) : null
 			] });
 		}
-		/**
-		* A write-only credential control. The value never rides a response, so the
-		* control reports only whether one is configured and starts blank; a blank
-		* draft writes nothing, which keeps the stored key rather than clearing it.
-		* 控件要求浏览器不要把已存的登录密码自动填进来（上游 11c0511271）。
-		* @param props - the field's copy, its staged text, and the configured state.
-		* @returns the labelled control.
-		*/
 		function SettingsSecretField(props) {
 			const Badge = props.configured ? NeutralBadge : QuietBadge;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Field, { children: [
@@ -4635,11 +4040,6 @@ window.__ModuleLoader__.load({
 		const Footer = styled("div")(styles.footer);
 		const Failed = styled("p")(styles.failed);
 		const Save = styled("button")(styles.save);
-		/**
-		* Render one plugin's settings form.
-		* @param props - the form's copy and state, its controls, and the save and discard actions.
-		* @returns the form, or the unavailable line while the namespace is not served.
-		*/
 		function SettingsForm(props) {
 			const { state, labels } = props;
 			const discard = (0, react.useRef)(props.onDiscard);
@@ -17492,7 +16892,6 @@ window.__ModuleLoader__.load({
 				...column === void 0 ? {} : { column: Number(column) }
 			};
 		}
-		/** 引号 mention 的起手字符：`@"path with spaces"`。 */
 		const QUOTED_PATH = "\"";
 		function parseQuotedReference(body) {
 			const end = body.indexOf(QUOTED_PATH, 1);
@@ -17629,15 +17028,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/index.ts
-		/**
-		* 需要的**服务名**：样式与引用那半不要服务，schema 表单那半要槽位、字典与配置表单。
-		*
-		* 与包清单里的 `dsh.client.inject` 不是一回事：那份是**装配行 id**（谁先到），交给模块系统排 arrival 顺序；
-		* 这里读的是 cordis 服务名（谁已 provide），Loader 拿它决定这一行何时才算 active。写错成包名，这一行就永远
-		* pending（`web boot: ... waiting for services`）。
-		*
-		* 值直接取自 schema 表单那一面，不另抄一份清单。
-		*/
 		const inject = [...inject$1];
 		function apply(ctx) {
 			apply$1(ctx);