@lmzhen/dsh-evolution-settings-ui 0.16.0 → 0.16.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

@@ -769,7 +769,7 @@ window.__ModuleLoader__.load({
 		/** Chinese copy (the family's primary language). */
 		const zh = {
 			title: "自进化",
-			subtitle: "下面按功能列出你能改的参数；没有列出的由安装时的配置决定。",
+			subtitle: "待你决定的写入在最上面；下面按功能列出你能改的参数，没有列出的由安装时的配置决定。",
 			overridden: "我改过",
 			deployment: "默认",
 			loading: "正在读取设置…",
@@ -814,7 +814,7 @@ 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…",
@@ -1109,10 +1109,20 @@ window.__ModuleLoader__.load({
 		//#region src/client/seam.ts
 		/** Our card slot, hosted by the section this bundle registers. */
 		const CARD_SLOT = "evolution.namespace.card";
+		/**
+		* 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 +1136,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 }))));
@@ -1235,13 +1248,6 @@ window.__ModuleLoader__.load({
 		const SECTION_ID = "evolution";
 		const SECTION_ORDER = 25;
 		/**
-		* 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.
-		*/
-		const PENDING_CARD_KEY = "approval-pending";
-		/**
 		* Register the locale namespace, the section and its cards.
 		* @param ctx - client cordis context.
 		*/

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/index.d.ts

@@ -16,18 +16,14 @@
  * @module @lmzhen/dsh-evolution-settings-ui/client
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import { PENDING_CARD_KEY } from './seam.ts';
 /** Required client services: the slot registry, the settings transport, the locale seat. */
 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 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";
+/** The pending-window card's key, re-exported from `seam.ts` (the section names it as well). */
+export { PENDING_CARD_KEY };
 /**
  * Register the locale namespace, the section and its cards.
  * @param ctx - client cordis context.

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

@@ -13,7 +13,7 @@ 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: "正在读取设置…";

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

@@ -13,6 +13,15 @@
 import type { ReactNode } from 'react';
 /** Our card slot, hosted by the section this bundle registers. */
 export declare const CARD_SLOT = "evolution.namespace.card";
+/**
+ * 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 namespace, as the client scope reports it. */
 export interface ParamSectionSnapshot {
     status: 'loading' | 'ready' | 'unavailable';

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.16.1",
   "publishConfig": {
     "access": "public"
   },