@lmzhen/dsh-evolution-settings-ui 0.16.0 → 0.17.0-rc.1

package/README.md

@@ -31,6 +31,13 @@ writes and carries the two decisions plus a preview. It reads the approval plugi
 (`src/client/api.ts` + `approval-routes.ts`; the path literals are compared against the host table by a spec),
 wears the same card shell and button vocabulary as the parameter cards, and invents no state of its own.
 
+The card rides that keyed slot with a key of its own (`approval-pending`): it has no namespace, so no
+namespace-driven loop can name it — and a keyed slot renders ONLY the keys its section asks for, so
+`SettingsSection` names it explicitly and puts it FIRST (it is the one card in this section that waits on a
+decision). A registration nobody asks for renders nowhere: 0.16.0 shipped exactly that, which is why
+`tests/section.client.spec.ts` now drives the real `apply()` and requires the section's `renderSlot` calls to cover
+every key the bundle registers into the slot.
+
 Its states are deliberately distinct: **reading** ("正在读取待批项…"), **empty** ("没有待批的写入") and
 **failed** (the reason plus a retry). Merging the first two is what once made a slow answer read as lost data
 (E7), so the state machine lives in `pending-state.ts` and the three are asserted without a browser.

package/lib/client.js

@@ -214,55 +214,6 @@ window.__ModuleLoader__.load({
 					}
 				]
 			},
-			{
-				namespace: "evolution-memory",
-				fields: [
-					{
-						id: "memoryChars",
-						group: "memory",
-						doc: "Character budget the memory store enforces for MEMORY.md.",
-						label: "记忆库上限",
-						hint: "长期记忆文件（MEMORY.md）最多多少字符。",
-						control: "number",
-						unit: "字符",
-						values: [],
-						valueLabels: []
-					},
-					{
-						id: "userChars",
-						group: "memory",
-						doc: "Character budget the memory store enforces for USER.md.",
-						label: "用户画像上限",
-						hint: "用户画像文件（USER.md）最多多少字符。",
-						control: "number",
-						unit: "字符",
-						values: [],
-						valueLabels: []
-					},
-					{
-						id: "addDatePrefix",
-						group: "memory",
-						doc: "Prefix stored memory entries with their date heading.",
-						label: "记忆条目加日期",
-						hint: "写入时在条目开头加上日期。",
-						control: "switch",
-						unit: "",
-						values: [],
-						valueLabels: []
-					},
-					{
-						id: "maxConsolidationFailures",
-						group: "memory",
-						doc: "Consolidation failures one turn tolerates before the tool gives up.",
-						label: "合并失败重试",
-						hint: "合并记忆连续失败多少次后停止。",
-						control: "number",
-						unit: "次",
-						values: [],
-						valueLabels: []
-					}
-				]
-			},
 			{
 				namespace: "evolution-review",
 				fields: [
@@ -354,7 +305,70 @@ window.__ModuleLoader__.load({
 				]
 			},
 			{
-				namespace: "evolution-skills",
+				namespace: "memory-files",
+				fields: [
+					{
+						id: "memoryChars",
+						group: "memory",
+						doc: "Character budget the memory store enforces for MEMORY.md.",
+						label: "记忆库上限",
+						hint: "长期记忆文件（MEMORY.md）最多多少字符。",
+						control: "number",
+						unit: "字符",
+						values: [],
+						valueLabels: []
+					},
+					{
+						id: "userChars",
+						group: "memory",
+						doc: "Character budget the memory store enforces for USER.md.",
+						label: "用户画像上限",
+						hint: "用户画像文件（USER.md）最多多少字符。",
+						control: "number",
+						unit: "字符",
+						values: [],
+						valueLabels: []
+					},
+					{
+						id: "addDatePrefix",
+						group: "memory",
+						doc: "Prefix stored memory entries with their date heading.",
+						label: "记忆条目加日期",
+						hint: "写入时在条目开头加上日期。",
+						control: "switch",
+						unit: "",
+						values: [],
+						valueLabels: []
+					},
+					{
+						id: "maxConsolidationFailures",
+						group: "memory",
+						doc: "Consolidation failures one turn tolerates before the tool gives up.",
+						label: "合并失败重试",
+						hint: "合并记忆连续失败多少次后停止。",
+						control: "number",
+						unit: "次",
+						values: [],
+						valueLabels: []
+					}
+				]
+			},
+			{
+				namespace: "tool-memory",
+				fields: [{
+					id: "entryPreviewChars",
+					group: "memory",
+					doc: "Characters of one memory entry shown in a tool result preview.",
+					label: "记忆预览长度",
+					hint: "列表里每条记忆最多显示多少字符。",
+					control: "number",
+					unit: "字符",
+					values: [],
+					valueLabels: []
+				}]
+			},
+			{
+				namespace: "tool-skill-manage",
 				fields: [
 					{
 						id: "skillContentChars",
@@ -475,20 +489,37 @@ window.__ModuleLoader__.load({
 						valueLabels: []
 					}
 				]
+			}
+		];
+		/** Every (bundle, row) pair the Plugins page can open a configuration page for. */
+		const CLIENT_ROW_SEATS = [
+			{
+				bundle: "@lmzhen/dsh-evolution-all",
+				rows: [
+					"evolution-curator",
+					"evolution-review",
+					"memory-files",
+					"tool-memory",
+					"tool-skill-manage"
+				]
 			},
 			{
-				namespace: "evolution-tool-memory",
-				fields: [{
-					id: "entryPreviewChars",
-					group: "memory",
-					doc: "Characters of one memory entry shown in a tool result preview.",
-					label: "记忆预览长度",
-					hint: "列表里每条记忆最多显示多少字符。",
-					control: "number",
-					unit: "字符",
-					values: [],
-					valueLabels: []
-				}]
+				bundle: "@lmzhen/dsh-evolution-host",
+				rows: [
+					"evolution-curator",
+					"evolution-review",
+					"memory-files"
+				]
+			},
+			{
+				bundle: "@lmzhen/dsh-evolution-preset",
+				rows: [
+					"evolution-curator",
+					"evolution-review",
+					"memory-files",
+					"tool-memory",
+					"tool-skill-manage"
+				]
 			}
 		];
 		//#endregion
@@ -769,11 +800,12 @@ window.__ModuleLoader__.load({
 		/** Chinese copy (the family's primary language). */
 		const zh = {
 			title: "自进化",
-			subtitle: "下面按功能列出你能改的参数；没有列出的由安装时的配置决定。",
+			subtitle: "待你决定的写入在最上面；下面按功能列出你能改的参数，没有列出的由安装时的配置决定。",
 			overridden: "我改过",
 			deployment: "默认",
 			loading: "正在读取设置…",
 			unavailable: "这个功能没有启动（对应的插件没有安装）",
+			seatMissing: "这个界面没有提供设置服务，参数只能看不能改",
 			readonly: "本次会话不允许写入设置（临时运行模式）",
 			apply: "保存",
 			reset: "恢复默认值",
@@ -814,11 +846,12 @@ window.__ModuleLoader__.load({
 		/** English copy, key for key with {@link zh}. */
 		const en = {
 			title: "Self-evolution",
-			subtitle: "Changeable parameters are listed by feature below; anything not listed comes from the deployment configuration.",
+			subtitle: "Writes waiting for your decision come first; the changeable parameters are listed by feature below, and anything not listed comes from the deployment configuration.",
 			overridden: "edited by you",
 			deployment: "default",
 			loading: "reading settings…",
 			unavailable: "this feature is not running (its plugin is not installed)",
+			seatMissing: "this shell serves no settings surface, so the parameters cannot be edited here",
 			readonly: "settings cannot be written in this session (temporary mode)",
 			apply: "Save",
 			reset: "Reset to default",
@@ -863,10 +896,10 @@ window.__ModuleLoader__.load({
 		*/
 		const NAMESPACE_TITLES = Object.freeze({
 			"evolution-review": "cardReview",
-			"evolution-memory": "cardMemory",
-			"evolution-tool-memory": "cardToolMemory",
+			"memory-files": "cardMemory",
+			"tool-memory": "cardToolMemory",
 			"evolution-curator": "cardCurator",
-			"evolution-skills": "cardSkills"
+			"tool-skill-manage": "cardSkills"
 		});
 		/**
 		* Resolve one message without the locale seat (tests and the fallback path).
@@ -910,7 +943,7 @@ window.__ModuleLoader__.load({
 		* settings scope and its snapshot are declared by the shape the renderer hands
 		* over (\`getSnapshot\`/\`subscribe\`, status/value/user/writable).
 		*
-		* Layout and behaviour follow the platform's own settings fields: a collapsed card
+		* header (namespace title, change count, chevron), then one block per field —
 		* header (namespace title, change count, chevron), then one block per field —
 		* label with its unit and source chip, a control HOLDING THE CURRENT VALUE, the
 		* Chinese hint — and one 放弃修改/保存 pair at the card's foot. The control is
@@ -944,7 +977,7 @@ window.__ModuleLoader__.load({
 			}
 		}
 		/** Whether a value is a plain section object. */
-		function isSection(value) {
+		function isSection$1(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value);
 		}
 		/** One field's control, typed from the registry. */
@@ -1004,22 +1037,21 @@ window.__ModuleLoader__.load({
 			}, t("reset"))) : null);
 		}
 		/**
-		* Render one namespace's card.
-		* @param props - the card data, its callbacks, and the bound section hook.
+		* Render one row's card body from a supplied snapshot.
+		* @param props - the card data, its callbacks, and the row state to render.
 		* @returns the card.
 		*/
-		function ParamCard(props) {
-			const { t, fields, write, clear, namespace } = props;
+		function ParamCardView(props) {
+			const { t, fields, write, clear, namespace, snapshot } = props;
 			const [open, setOpen] = (0, react.useState)(false);
 			const [draft, setDraft] = (0, react.useState)({});
 			const [busy, setBusy] = (0, react.useState)(false);
 			const [error, setError] = (0, react.useState)("");
 			const [pending, setPending] = (0, react.useState)(null);
-			const snapshot = props.useParamSection((state) => state);
 			if (snapshot.status === "loading") return (0, react.createElement)("p", { className: "evolution-param-note" }, t("loading"));
-			if (snapshot.status === "unavailable") return (0, react.createElement)("p", { className: "evolution-param-note" }, t("unavailable"));
-			const user = isSection(snapshot.user) ? snapshot.user : {};
-			const value = isSection(snapshot.value) ? snapshot.value : {};
+			if (snapshot.status === "unavailable") return (0, react.createElement)("p", { className: "evolution-param-note" }, t(snapshot.reason === "seat-missing" ? "seatMissing" : "unavailable"));
+			const user = isSection$1(snapshot.user) ? snapshot.user : {};
+			const value = isSection$1(snapshot.value) ? snapshot.value : {};
 			const disabled = !snapshot.writable;
 			const locked = disabled || busy;
 			const titleKey = NAMESPACE_TITLES[namespace];
@@ -1105,14 +1137,174 @@ window.__ModuleLoader__.load({
 				onClick: save
 			}, busy ? t("saving") : t("apply")))) : null);
 		}
+		/**
+		* The card as our own section renders it: the row state comes from the hook seat the
+		* renderer binds out of the inject face's `hooks` compartment (components never hold a
+		* subscription of their own).
+		* @param props - the card data, its callbacks, and the bound row hook.
+		* @returns the card.
+		*/
+		function ParamCard(props) {
+			return ParamCardView({
+				namespace: props.namespace,
+				fields: props.fields,
+				t: props.t,
+				write: props.write,
+				clear: props.clear,
+				snapshot: props.useParamSection((state) => state)
+			});
+		}
+		//#endregion
+		//#region src/client/source.ts
+		/** What a card shows when this UI found no settings seat at all. */
+		const SEAT_MISSING = Object.freeze({
+			status: "unavailable",
+			value: void 0,
+			user: void 0,
+			writable: false,
+			reason: "seat-missing"
+		});
+		/**
+		* Whether a value is a plain section object.
+		* @param value - the value to test.
+		* @returns true for a non-null, non-array object.
+		*/
+		function isSection(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		/**
+		* Project one platform snapshot into the card's own shape.
+		* @param snapshot - the seat's snapshot.
+		* @returns the card's snapshot, with the reason an unavailable one is unavailable.
+		*/
+		function sectionSnapshotOf(snapshot) {
+			return {
+				status: snapshot.status,
+				value: isSection(snapshot.value) ? snapshot.value : void 0,
+				user: snapshot.user,
+				writable: snapshot.writable,
+				...snapshot.status === "unavailable" ? { reason: "not-served" } : {}
+			};
+		}
+		/**
+		* The live source one row's card binds.
+		* @param seat - the probed settings seat, when the deployment composed it.
+		* @param namespace - the row's entry id.
+		* @returns the source; without a seat it reports the stated empty state and never notifies.
+		*/
+		function sourceFor(seat, namespace) {
+			if (seat === void 0) return {
+				getSnapshot: () => SEAT_MISSING,
+				subscribe: () => () => {}
+			};
+			const form = seat.get(namespace);
+			return {
+				getSnapshot: () => sectionSnapshotOf(form.getSnapshot()),
+				subscribe: (listener) => form.subscribe(listener)
+			};
+		}
+		/**
+		* The write pair for one row.
+		* @param seat - the probed settings seat, when the deployment composed it.
+		* @param namespace - the row's entry id.
+		* @returns the two calls a card's save/reset path uses; without a seat they resolve without writing.
+		*/
+		function writeFaceFor(seat, namespace) {
+			const form = () => seat?.get(namespace);
+			return {
+				write: async (field, value) => {
+					await form()?.set(field, value);
+				},
+				clear: async (field) => {
+					await form()?.unset(field);
+				}
+			};
+		}
+		//#endregion
+		//#region src/client/RowConfigCard.ts
+		/**
+		* The Plugins page's per-row configuration entry for a family row.
+		*
+		* The page owns the settings subscription — it re-renders the entry — and passes the row's
+		* form in, so this component renders the SAME card body as our own section, fed by the
+		* page's state instead of the bound hook and therefore holding no subscription of its own.
+		* `summary` answers the page's one-line slot: a row's description fallback, which stays
+		* empty until the row actually overrides something, exactly as the page expects.
+		* @module @lmzhen/dsh-evolution-settings-ui/client
+		*/
+		/**
+		* Count the keys this row's user layer holds.
+		* @param user - the raw user section, as the page reports it.
+		* @param fields - the row's fields.
+		* @returns how many of them the user overrode.
+		*/
+		function overridden(user, fields) {
+			const layer = isSection(user) ? user : {};
+			return fields.filter((field) => Object.hasOwn(layer, field.id)).length;
+		}
+		/**
+		* Render one row's configuration entry.
+		* @param props - the page's view/form seat plus this row's face.
+		* @returns the entry; `summary` renders nothing for an untouched row (the page then keeps the row's own description).
+		*/
+		function RowConfigCard(props) {
+			const { t, fields, namespace, view, form } = props;
+			if (form === void 0) return view === "summary" ? null : (0, react.createElement)("p", { className: "evolution-param-note" }, t("seatMissing"));
+			const changed = overridden(form.state.user, fields);
+			if (view === "summary") return changed === 0 ? null : (0, react.createElement)("span", null, t("changed").replace("{n}", String(changed)));
+			return ParamCardView({
+				namespace,
+				fields,
+				t,
+				snapshot: sectionSnapshotOf(form.state),
+				write: async (field, value) => {
+					await form.mutate([{
+						op: "set",
+						path: [field],
+						value
+					}], form.state.revision);
+				},
+				clear: async (field) => {
+					await form.mutate([{
+						op: "unset",
+						path: [field]
+					}], form.state.revision);
+				}
+			});
+		}
 		//#endregion
 		//#region src/client/seam.ts
 		/** Our card slot, hosted by the section this bundle registers. */
 		const CARD_SLOT = "evolution.namespace.card";
+		/** The Plugins page's per-row configuration seat (declared by `ui-plugin-manager`). */
+		const ROW_CONFIG_SLOT = "plugins.row.config";
+		/**
+		* The key the Plugins page files a row's configuration under.
+		*
+		* Spelled here because the page's own helper cannot be imported (a value import from
+		* another plugin's client half is forbidden):
+		* `ui-plugin-manager/src/client/config-ledger.ts:36` is the definition this mirrors.
+		* @param bundle - the bundle package name that declares the row.
+		* @param rowId - the row id that bundle's patch declares.
+		* @returns the `plugins.row.config` key.
+		*/
+		function rowConfigKey(bundle, rowId) {
+			return bundle + "#" + rowId;
+		}
+		/**
+		* The pending-window card's slot key.
+		*
+		* The section pairs cards by key and the parameter cards use their settings namespace; this card has no
+		* namespace (its data comes from the host's approval routes), so it carries a key of its own. The constant
+		* lives HERE and not in `index.ts` because the SECTION has to name it too, and `index.ts` already imports
+		* the section — one definition in the module both sides already share is what keeps that pair acyclic.
+		*/
+		const PENDING_CARD_KEY = "approval-pending";
 		//#endregion
 		//#region src/client/SettingsSection.ts
 		/**
-		* The section shell: title, one-line explanation, then one card per namespace.
+		* The section shell: title, one-line explanation, then one card per namespace — with the staged-write
+		* window's card ahead of them all, because it is the only card here that waits on a decision.
 		*
 		* This is the shape the platform's own settings sections use — a heading plus the
 		* child slots it declared in its registration. The cards themselves are separate
@@ -1126,7 +1318,10 @@ window.__ModuleLoader__.load({
 		* @returns the section element.
 		*/
 		function SettingsSection(face) {
-			return (0, react.createElement)("div", { className: "evolution-params" }, (0, react.createElement)("h2", { className: "evolution-params-title" }, face.t("title")), (0, react.createElement)("p", { className: "evolution-params-subtitle" }, face.t("subtitle")), ...CLIENT_PARAM_SECTIONS.map((section_) => (0, react.createElement)("div", {
+			return (0, react.createElement)("div", { className: "evolution-params" }, (0, react.createElement)("h2", { className: "evolution-params-title" }, face.t("title")), (0, react.createElement)("p", { className: "evolution-params-subtitle" }, face.t("subtitle")), (0, react.createElement)("div", {
+				key: PENDING_CARD_KEY,
+				className: "evolution-params-group"
+			}, face.renderSlot(CARD_SLOT, {}, { entryKey: PENDING_CARD_KEY })), ...CLIENT_PARAM_SECTIONS.map((section_) => (0, react.createElement)("div", {
 				key: section_.namespace,
 				className: "evolution-params-group"
 			}, face.renderSlot(CARD_SLOT, {}, { entryKey: section_.namespace }))));
@@ -1225,24 +1420,20 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/index.ts
-		/** Required client services: the slot registry, the settings transport, the locale seat. */
-		const inject = [
-			"slots",
-			"settingsScope",
-			"locale"
-		];
-		/** Section id and nav order (the platform's own sections sit at 0/10/15/20). */
-		const SECTION_ID = "evolution";
-		const SECTION_ORDER = 25;
 		/**
-		* The pending-window card's slot key.
+		* Required client services: the slot registry and the locale seat.
 		*
-		* The section pairs cards by key and the parameter cards use their settings namespace; this card has no
-		* namespace (its data comes from the host's approval routes), so it carries a key of its own.
+		* The settings seat (`configForms`) is deliberately NOT here. A required inject for a
+		* service the deployment did not compose leaves this whole browser half PENDING forever —
+		* no error, no section, no UI — and the family is also installed without a settings
+		* surface. It is probed instead, and the cards say what is missing.
 		*/
-		const PENDING_CARD_KEY = "approval-pending";
+		const inject = ["slots", "locale"];
+		/** Section id and nav order (the platform's own sections sit at 0/10/15/20). */
+		const SECTION_ID = "evolution";
+		const SECTION_ORDER = 25;
 		/**
-		* Register the locale namespace, the section and its cards.
+		* Register the locale namespace, the section, its cards, and the per-row configuration entries.
 		* @param ctx - client cordis context.
 		*/
 		function apply(ctx) {
@@ -1271,6 +1462,7 @@ window.__ModuleLoader__.load({
 				}
 				return bound(key);
 			};
+			const configForms = ctx.get("configForms");
 			seam.slots.inject("settings.section", function* () {
 				yield seam.slots.register({
 					name: "settings.section",
@@ -1286,14 +1478,14 @@ window.__ModuleLoader__.load({
 			});
 			seam.slots.inject(CARD_SLOT, function* () {
 				for (const section of CLIENT_PARAM_SECTIONS) {
-					const scope = seam.settingsScope.bind({ namespace: section.namespace });
-					const source = scope;
+					const source = sourceFor(configForms, section.namespace);
+					const { write, clear } = writeFaceFor(configForms, section.namespace);
 					const face = () => ({
 						namespace: section.namespace,
 						fields: section.fields,
 						t,
-						write: (field, value) => scope.set(field, value),
-						clear: (field) => scope.unset(field),
+						write,
+						clear,
 						hooks: { paramSection: source }
 					});
 					yield seam.slots.register({
@@ -1312,6 +1504,22 @@ window.__ModuleLoader__.load({
 					})
 				}, PendingCard);
 			});
+			seam.slots.inject(ROW_CONFIG_SLOT, function* () {
+				for (const seat of CLIENT_ROW_SEATS) for (const rowId of seat.rows) {
+					const section = CLIENT_PARAM_SECTIONS.find((candidate) => candidate.namespace === rowId);
+					if (section === void 0) continue;
+					const face = () => ({
+						namespace: rowId,
+						fields: section.fields,
+						t
+					});
+					yield seam.slots.register({
+						name: ROW_CONFIG_SLOT,
+						key: rowConfigKey(seat.bundle, rowId),
+						inject: face
+					}, RowConfigCard);
+				}
+			});
 		}
 		//#endregion
 		exports.PENDING_CARD_KEY = PENDING_CARD_KEY;

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

@@ -6,7 +6,7 @@
  * settings scope and its snapshot are declared by the shape the renderer hands
  * over (\`getSnapshot\`/\`subscribe\`, status/value/user/writable).
  *
- * Layout and behaviour follow the platform's own settings fields: a collapsed card
+ * header (namespace title, change count, chevron), then one block per field —
  * header (namespace title, change count, chevron), then one block per field —
  * label with its unit and source chip, a control HOLDING THE CURRENT VALUE, the
  * Chinese hint — and one 放弃修改/保存 pair at the card's foot. The control is
@@ -49,5 +49,28 @@ export type ParamCardProps = Omit<ParamCardFace, 'hooks'> & {
  * @param props - the card data, its callbacks, and the bound section hook.
  * @returns the card.
  */
+/** Props of the shared body: the card's own data plus the row state it renders. */
+export interface ParamCardViewProps {
+    namespace: string;
+    fields: readonly ClientParamField[];
+    t: (key: MessageKey) => string;
+    write: (field: string, value: unknown) => Promise<void>;
+    clear: (field: string) => Promise<void>;
+    /** The current row state, from whichever source owns it (the bound hook or the page). */
+    snapshot: ParamSectionSnapshot;
+}
+/**
+ * Render one row's card body from a supplied snapshot.
+ * @param props - the card data, its callbacks, and the row state to render.
+ * @returns the card.
+ */
+export declare function ParamCardView(props: ParamCardViewProps): ReactNode;
+/**
+ * The card as our own section renders it: the row state comes from the hook seat the
+ * renderer binds out of the inject face's `hooks` compartment (components never hold a
+ * subscription of their own).
+ * @param props - the card data, its callbacks, and the bound row hook.
+ * @returns the card.
+ */
 export declare function ParamCard(props: ParamCardProps): ReactNode;
 //# sourceMappingURL=ParamCard.d.ts.map

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

@@ -0,0 +1,30 @@
+/**
+ * The Plugins page's per-row configuration entry for a family row.
+ *
+ * The page owns the settings subscription — it re-renders the entry — and passes the row's
+ * form in, so this component renders the SAME card body as our own section, fed by the
+ * page's state instead of the bound hook and therefore holding no subscription of its own.
+ * `summary` answers the page's one-line slot: a row's description fallback, which stays
+ * empty until the row actually overrides something, exactly as the page expects.
+ * @module @lmzhen/dsh-evolution-settings-ui/client
+ */
+import { type ReactNode } from 'react';
+import type { ClientParamField } from './generated-params.ts';
+import type { MessageKey } from './messages.ts';
+import type { RowConfigViewProps } from './seam.ts';
+/** The inject face every row registration carries (the page supplies `view` and `form`). */
+export interface RowConfigFace {
+    /** The row's entry id, for the card title. */
+    namespace: string;
+    fields: readonly ClientParamField[];
+    t: (key: MessageKey) => string;
+}
+/** Props one row entry is rendered with: the page's seat plus this row's own face. */
+export type RowConfigCardProps = RowConfigViewProps & RowConfigFace;
+/**
+ * Render one row's configuration entry.
+ * @param props - the page's view/form seat plus this row's face.
+ * @returns the entry; `summary` renders nothing for an untouched row (the page then keeps the row's own description).
+ */
+export declare function RowConfigCard(props: RowConfigCardProps): ReactNode;
+//# sourceMappingURL=RowConfigCard.d.ts.map

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

@@ -1,5 +1,6 @@
 /**
- * The section shell: title, one-line explanation, then one card per namespace.
+ * The section shell: title, one-line explanation, then one card per namespace — with the staged-write
+ * window's card ahead of them all, because it is the only card here that waits on a decision.
  *
  * This is the shape the platform's own settings sections use — a heading plus the
  * child slots it declared in its registration. The cards themselves are separate

package/lib/types/client/generated-params.d.ts

@@ -29,4 +29,15 @@ export interface ClientParamSection {
     fields: readonly ClientParamField[];
 }
 export declare const CLIENT_PARAM_SECTIONS: readonly ClientParamSection[];
+/**
+ * One bundle that mounts family rows: the plugins.row.config key of a row is
+ * <bundle package name>#<row id>. The names are the SOURCE-plane spellings -
+ * the release rescopes them with every other package literal.
+ */
+export interface ClientRowSeat {
+    bundle: string;
+    rows: readonly string[];
+}
+/** Every (bundle, row) pair the Plugins page can open a configuration page for. */
+export declare const CLIENT_ROW_SEATS: readonly ClientRowSeat[];
 //# sourceMappingURL=generated-params.d.ts.map

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

@@ -1,35 +1,49 @@
 /**
- * Browser half: one settings section ("自进化") hosting one card per namespace.
+ * Browser half: one settings section ("自进化") hosting one card per family row, plus the
+ * Plugins page's per-row configuration entry for each of those rows.
  *
  * Until 0.7.0 the cards lived inside the platform's own 插件 section, because
  * this bundle injected `@deepseek-ai/dsh-client-ui-settings-plugins` and claimed
  * its keyed `settings.plugin.item` slot. The parameters are not a plugin
  * inventory though — the other feature areas (market, skins, Web plugins, side
- * cards) each register their OWN section, so this bundle now does the same:
- * inject the settings shell, register `settings.section`, and host the cards in
- * a keyed child slot of that section.
+ * cards) each register their OWN section, so this bundle does the same: inject
+ * the settings shell, register `settings.section`, and host the cards in a keyed
+ * child slot of that section.
  *
- * The join key is still the namespace itself: the Host half of each owning plugin
- * registers it, this half claims it in the keyed card slot, and the section pairs
- * them. A namespace the Host does not serve renders nothing, and a deployment that
- * drops this row shows no section at all: the pair carries no Host-side behaviour.
+ * Since G2 that section is one of TWO render sites for the same card body. The other is
+ * the platform's Plugins page: each family row can be opened there, and the page renders
+ * whatever a plugin registered under key `<bundle package name>#<row id>`
+ * (`plugins.row.config`). The page owns that entry's subscription and hands the row's form
+ * in, so that path needs no seat of ours; our own section binds the same card to the
+ * client settings seat (`configForms`).
+ *
+ * The join key is the row's ENTRY ID — the platform derives a settings namespace from the
+ * Loader entry id, and that id is the registry's owner name — so the card, the seat lookup
+ * and the page key all spell one id. The legacy namespace strings in the registry
+ * (`evolution-memory`, …) are the G3 migration source, never a live lookup key.
+ *
+ * A row the Host does not serve renders nothing, and a deployment that drops this row
+ * shows no section at all: the pair carries no Host-side behaviour.
  * @module @lmzhen/dsh-evolution-settings-ui/client
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-/** Required client services: the slot registry, the settings transport, the locale seat. */
+import { PENDING_CARD_KEY } from './seam.ts';
+/**
+ * Required client services: the slot registry and the locale seat.
+ *
+ * The settings seat (`configForms`) is deliberately NOT here. A required inject for a
+ * service the deployment did not compose leaves this whole browser half PENDING forever —
+ * no error, no section, no UI — and the family is also installed without a settings
+ * surface. It is probed instead, and the cards say what is missing.
+ */
 export declare const inject: string[];
 /** Section id and nav order (the platform's own sections sit at 0/10/15/20). */
 export declare const SECTION_ID = "evolution";
 export declare const SECTION_ORDER = 25;
+/** The pending-window card's key, re-exported from `seam.ts` (the section names it as well). */
+export { PENDING_CARD_KEY };
 /**
- * The pending-window card's slot key.
- *
- * The section pairs cards by key and the parameter cards use their settings namespace; this card has no
- * namespace (its data comes from the host's approval routes), so it carries a key of its own.
- */
-export declare const PENDING_CARD_KEY = "approval-pending";
-/**
- * Register the locale namespace, the section and its cards.
+ * Register the locale namespace, the section, its cards, and the per-row configuration entries.
  * @param ctx - client cordis context.
  */
 export declare function apply(ctx: ClientContext): void;

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

@@ -13,11 +13,12 @@ export declare const NS = "evolution-settings";
 /** Chinese copy (the family's primary language). */
 export declare const zh: {
     readonly title: "自进化";
-    readonly subtitle: "下面按功能列出你能改的参数；没有列出的由安装时的配置决定。";
+    readonly subtitle: "待你决定的写入在最上面；下面按功能列出你能改的参数，没有列出的由安装时的配置决定。";
     readonly overridden: "我改过";
     readonly deployment: "默认";
     readonly loading: "正在读取设置…";
     readonly unavailable: "这个功能没有启动（对应的插件没有安装）";
+    readonly seatMissing: "这个界面没有提供设置服务，参数只能看不能改";
     readonly readonly: "本次会话不允许写入设置（临时运行模式）";
     readonly apply: "保存";
     readonly reset: "恢复默认值";

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

@@ -2,39 +2,104 @@
  * Structural view of the client seams this bundle uses.
  *
  * The package is distributed OUTSIDE the platform repository, so it declares the
- * two seams it consumes instead of importing another plugin's values (forbidden
- * by the client bundle-purity rule) or its types (which would drag the platform
- * sources into this project). The shapes are the shell's contract: a
- * `settings.section` registration hosting a keyed card slot, the inject faces
- * both hand back, the per-namespace settings scope the write path fences with the
- * revision it read, and the locale seat the section's copy resolves through.
+ * seams it consumes instead of importing another plugin's values (forbidden by the
+ * client bundle-purity rule) or its types (which would drag the platform sources
+ * into this project). The shapes are the shell's contract: a `settings.section`
+ * registration hosting a keyed card slot, the keyed `plugins.row.config` seat the
+ * Plugins page opens per row, the client settings seat (`configForms`, one form per
+ * Host plugin entry id), and the locale seat the section's copy resolves through.
  * @module @lmzhen/dsh-evolution-settings-ui/client
  */
 import type { ReactNode } from 'react';
 /** Our card slot, hosted by the section this bundle registers. */
 export declare const CARD_SLOT = "evolution.namespace.card";
-/** Snapshot of one settings namespace, as the client scope reports it. */
+/** The Plugins page's per-row configuration seat (declared by `ui-plugin-manager`). */
+export declare const ROW_CONFIG_SLOT = "plugins.row.config";
+/**
+ * The key the Plugins page files a row's configuration under.
+ *
+ * Spelled here because the page's own helper cannot be imported (a value import from
+ * another plugin's client half is forbidden):
+ * `ui-plugin-manager/src/client/config-ledger.ts:36` is the definition this mirrors.
+ * @param bundle - the bundle package name that declares the row.
+ * @param rowId - the row id that bundle's patch declares.
+ * @returns the `plugins.row.config` key.
+ */
+export declare function rowConfigKey(bundle: string, rowId: string): string;
+/**
+ * The pending-window card's slot key.
+ *
+ * The section pairs cards by key and the parameter cards use their settings namespace; this card has no
+ * namespace (its data comes from the host's approval routes), so it carries a key of its own. The constant
+ * lives HERE and not in `index.ts` because the SECTION has to name it too, and `index.ts` already imports
+ * the section — one definition in the module both sides already share is what keeps that pair acyclic.
+ */
+export declare const PENDING_CARD_KEY = "approval-pending";
+/** Snapshot of one settings row, as the client seat reports it. */
 export interface ParamSectionSnapshot {
     status: 'loading' | 'ready' | 'unavailable';
     value: Record<string, unknown> | undefined;
     /** Raw user section: a key's PRESENCE marks the override, not its value. */
     user: unknown;
     writable: boolean;
+    /**
+     * Why an `unavailable` snapshot is unavailable: this bundle found no settings seat at
+     * all, or the seat is there and serves no such row. The two read differently to the
+     * operator (one is the UI's own gap, the other is a row that is not composed).
+     */
+    reason?: 'seat-missing' | 'not-served';
 }
 /** The reactive source the renderer binds to a `use<Name>` seat. */
 export interface ParamSectionSource {
     getSnapshot(): ParamSectionSnapshot;
     subscribe(listener: () => void): () => void;
 }
-/** One namespace's write face. */
-export interface SettingsScopeLike {
-    set(field: string, value: unknown): Promise<void>;
-    unset(field: string): Promise<void>;
+/** One ordered field operation, as the client settings seat takes them. */
+export interface SettingsPathOpLike {
+    readonly op: 'set' | 'unset';
+    readonly path: readonly string[];
+    readonly value?: unknown;
+}
+/** One row's client form state, as `configForms.get(entryId)` reports it. */
+export interface ConfigFormSnapshotLike<T = Record<string, unknown>> {
+    status: 'loading' | 'ready' | 'unavailable';
+    value: T | undefined;
+    /** Composition layer the Host resolved `value` over; what a cleared field reverts to. */
+    base: unknown;
+    /** Raw user layer: a key's PRESENCE marks the override. */
+    user: unknown;
+    revision: number | undefined;
+    writable: boolean;
+    mode: 'host' | 'memory';
+}
+/** One row's client write face (0.2.x `configForms`). */
+export interface ConfigFormLike<T = Record<string, unknown>> {
+    getSnapshot(): ConfigFormSnapshotLike<T>;
+    subscribe(listener: () => void): () => void;
+    set(field: string, value: unknown): Promise<boolean>;
+    unset(field: string): Promise<boolean>;
+    mutate(ops: readonly SettingsPathOpLike[], expectedRevision?: number): Promise<boolean>;
+}
+/**
+ * The client settings seat, probed rather than injected: a deployment may compose the
+ * family without the settings surface, and a REQUIRED inject for a missing service
+ * leaves the whole browser half pending forever (no error, no UI).
+ */
+export interface ConfigFormsSeat {
+    /** One Host plugin entry id to its form. */
+    get<T>(entryId: string): ConfigFormLike<T>;
 }
 /** Registration options the keyed card slot under our own section takes. */
 export interface SlotRegisterOptions {
     name: typeof CARD_SLOT;
-    /** The settings namespace this card edits — the slot's key. */
+    /** The settings row this card edits — the slot's key. */
+    key: string;
+    inject: () => unknown;
+}
+/** Registration options the Plugins page's per-row config seat takes. */
+export interface RowSeatRegisterOptions {
+    name: typeof ROW_CONFIG_SLOT;
+    /** `<bundle package name>#<row id>`, as the page's ledger builds it. */
     key: string;
     inject: () => unknown;
 }
@@ -64,6 +129,23 @@ export interface SectionFace {
     /** Render one child slot; `filter` selects keyed entries (e.g. `{ entryKey }`). */
     renderSlot: (name: string, props?: Record<string, unknown>, filter?: Record<string, unknown>) => ReactNode;
 }
+/**
+ * The values and commands the Plugins page passes to a `plugins.row.config` entry:
+ * the page owns the subscription (it re-renders the entry), so the entry renders from
+ * `state` and writes through `mutate`. Both views receive this face; `summary` uses it
+ * only to say whether anything is overridden.
+ */
+export interface RowConfigViewProps {
+    /** `summary` is the row's one-line description fallback; `page` is the whole form. */
+    readonly view: 'summary' | 'page';
+    /** Absent when the Host serves no configuration for this row. */
+    readonly form?: RowConfigForm | undefined;
+}
+/** The row form the page derived from its settings seat. */
+export interface RowConfigForm {
+    readonly state: ConfigFormSnapshotLike;
+    readonly mutate: (ops: readonly SettingsPathOpLike[], revision?: number) => Promise<boolean>;
+}
 /** The locale seat: register this bundle's namespace, bind a translator. */
 export interface LocaleSeat {
     register(namespace: string, dictionaries: {
@@ -76,12 +158,7 @@ export interface LocaleSeat {
 export interface ClientSeam {
     slots: {
         inject(name: string, callback: () => Generator<unknown, void, unknown>): unknown;
-        register(options: SlotRegisterOptions | SectionRegisterOptions, component: (props: never) => unknown): () => void;
-    };
-    settingsScope: {
-        bind(spec: {
-            namespace: string;
-        }): SettingsScopeLike;
+        register(options: SlotRegisterOptions | RowSeatRegisterOptions | SectionRegisterOptions, component: (props: never) => unknown): () => void;
     };
     locale: LocaleSeat;
 }

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

@@ -0,0 +1,41 @@
+/**
+ * The adapter between the platform's client settings seat and this bundle's cards.
+ *
+ * One place maps `configForms.get(entryId)` to the three things a card needs — a
+ * snapshot, a subscription and the two write calls — so our own section's cards and the
+ * Plugins page's per-row entry cannot drift apart in how they read or write a row.
+ * @module @lmzhen/dsh-evolution-settings-ui/client
+ */
+import type { ConfigFormSnapshotLike, ConfigFormsSeat, ParamSectionSnapshot, ParamSectionSource } from './seam.ts';
+/** What a card shows when this UI found no settings seat at all. */
+export declare const SEAT_MISSING: ParamSectionSnapshot;
+/**
+ * Whether a value is a plain section object.
+ * @param value - the value to test.
+ * @returns true for a non-null, non-array object.
+ */
+export declare function isSection(value: unknown): value is Record<string, unknown>;
+/**
+ * Project one platform snapshot into the card's own shape.
+ * @param snapshot - the seat's snapshot.
+ * @returns the card's snapshot, with the reason an unavailable one is unavailable.
+ */
+export declare function sectionSnapshotOf(snapshot: ConfigFormSnapshotLike): ParamSectionSnapshot;
+/**
+ * The live source one row's card binds.
+ * @param seat - the probed settings seat, when the deployment composed it.
+ * @param namespace - the row's entry id.
+ * @returns the source; without a seat it reports the stated empty state and never notifies.
+ */
+export declare function sourceFor(seat: ConfigFormsSeat | undefined, namespace: string): ParamSectionSource;
+/**
+ * The write pair for one row.
+ * @param seat - the probed settings seat, when the deployment composed it.
+ * @param namespace - the row's entry id.
+ * @returns the two calls a card's save/reset path uses; without a seat they resolve without writing.
+ */
+export declare function writeFaceFor(seat: ConfigFormsSeat | undefined, namespace: string): {
+    write: (field: string, value: unknown) => Promise<void>;
+    clear: (field: string) => Promise<void>;
+};
+//# sourceMappingURL=source.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-settings-ui",
   "description": "Web settings cards for the evolution family's parameter namespaces (community build)",
-  "version": "0.16.0",
+  "version": "0.17.0-rc.1",
   "publishConfig": {
     "access": "public"
   },