@lmzhen/dsh-evolution-ui 0.32.6 → 0.34.0

package/lib/types/panels/history/client/Workbench.d.ts

@@ -6,48 +6,35 @@
 import { type ReactNode } from 'react';
 import { type PanelFace } from './Panel.ts';
 import { type PendingCardFace } from '../../settings/PendingCard.ts';
+import { type DiagnosticsCardFace } from '../../settings/DiagnosticsCard.ts';
+import type { WorkbenchStore } from './WorkbenchStore.ts';
 /** Stable page id used by the sidebar row, the page slot key, and navigation params. */
 export declare const WORKBENCH_ID = "evolution.workbench";
-/** Owner props supplied by the platform page slot. */
-export interface WorkbenchOwner {
-    readonly pageId: string;
-    readonly params?: Readonly<Record<string, string | number | boolean | null>> | undefined;
-    readonly revision?: number | undefined;
-}
 /** Injected face: copy plus the history view's data callbacks. */
 export interface WorkbenchFace {
     readonly t: (key: string) => string;
+    readonly store: WorkbenchStore;
     readonly history: PanelFace;
     readonly pending: PendingCardFace;
+    readonly diagnostics: DiagnosticsCardFace;
     /** Whether a feature view is actually mounted (health is disabled by default). */
     readonly hasView?: (view: 'merge' | 'health') => boolean;
 }
-/** The two views the workbench owns today. */
-export type WorkbenchView = 'history' | 'pending' | 'merge' | 'health';
-/** Sidebar row owner props supplied by the platform list slot. */
-export interface WorkbenchNavOwner {
-    readonly activePageId: string | null;
-    readonly openPage: (pageId: string) => void;
-}
-/** Sidebar row injected face. */
-export interface WorkbenchNavFace {
-    readonly t: (key: string) => string;
-}
+export type { WorkbenchView } from './WorkbenchStore.ts';
 /**
  * Render the workbench page. The platform keeps it mounted; this component only
  * consumes a new explicit revision exactly once.
  * @param props - page owner props plus the injected history face.
  * @returns the page surface.
  */
-export declare function WorkbenchPage(props: WorkbenchOwner & WorkbenchFace & {
+export declare function WorkbenchPage(props: WorkbenchFace & {
     readonly renderSlot?: (name: string, owner: Record<string, unknown>) => ReactNode;
 }): ReactNode;
-/**
- * Render the sidebar entry that opens the workbench.
- * @param props - active page id, opener, and copy.
- * @returns the row button.
- */
-export declare function WorkbenchNav(props: WorkbenchNavOwner & WorkbenchNavFace): ReactNode;
+/** The sidebar icon; the platform renders the row label, tooltip and active state. */
+export declare function WorkbenchIcon(props: {
+    size?: number;
+    active?: boolean;
+}): ReactNode;
 /** Workbench shell and sidebar row; colours come from the platform tokens. */
 export declare const WORKBENCH_CSS: string;
 //# sourceMappingURL=Workbench.d.ts.map

package/lib/types/panels/history/client/WorkbenchStore.d.ts

@@ -0,0 +1,16 @@
+/** Registration-owned workbench navigation state. No module-level singleton. */
+export type WorkbenchView = 'history' | 'pending' | 'merge' | 'health' | 'diagnostics';
+export interface WorkbenchState {
+    readonly view: WorkbenchView;
+    readonly selectedSkill?: string;
+    readonly focusRevision: number;
+}
+export interface WorkbenchStore {
+    getState(): WorkbenchState;
+    subscribe(listener: () => void): () => void;
+    setView(view: WorkbenchView): void;
+    openHistory(skill?: string): void;
+    clearSelection(): void;
+}
+export declare function createWorkbenchStore(initial?: WorkbenchState): WorkbenchStore;
+//# sourceMappingURL=WorkbenchStore.d.ts.map

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

@@ -8,7 +8,7 @@ export { PANEL_ORDER };
 /** Required client services: the slot registry and the locale seat. */
 export declare const inject: string[];
 /**
- * Register the locale namespace, the workbench page, and its sidebar entry.
+ * Register the locale namespace, the workbench main occupant and its sidebar row.
  * @param ctx - client cordis context.
  */
 export declare function apply(ctx: ClientContext): void;

package/lib/types/panels/settings/ParamCard.d.ts

@@ -16,7 +16,7 @@
 import { type ReactNode } from 'react';
 import type { ClientParamField } from './generated-params.ts';
 import { type MessageKey } from './messages.ts';
-import type { ParamSectionSnapshot, ParamSectionSource, SettingsPathOpLike } from './seam.ts';
+import type { ParamSectionSnapshot, ParamSectionSource, SettingsPathOpLike, SettingsSaveResult } from './seam.ts';
 /**
  * Injected face: plain data and callbacks, plus the hook seat.
  *
@@ -34,6 +34,8 @@ export interface ParamCardFace {
     /** ONE call per save, carrying every dirty field as one op list (T5-01/A56). The returned boolean IS
      * the Host's verdict (contract C2/G5): `true` = accepted, `false` = refused after its recovery read. */
     mutateOnce: (ops: readonly SettingsParamOp[]) => Promise<boolean>;
+    /** Structured write result; when present the card distinguishes acceptance from readback. */
+    saveOnce?: (ops: readonly SettingsParamOp[]) => Promise<SettingsSaveResult>;
     clear: (field: string) => Promise<boolean>;
     hooks: {
         paramSection: ParamSectionSource;
@@ -91,6 +93,7 @@ export interface ParamCardViewProps {
     lang?: () => ParamLanguage;
     /** ONE call per save, carrying every dirty field as one op list (T5-01/A56). */
     mutateOnce: (ops: readonly SettingsParamOp[]) => Promise<boolean>;
+    saveOnce?: (ops: readonly SettingsParamOp[]) => Promise<SettingsSaveResult>;
     /** Ask the scope to drop one override; resolves when the scope answered, not when it landed. */
     clear: (field: string) => Promise<boolean>;
     /** The current row state, from whichever source owns it (the bound hook or the page). */
@@ -102,14 +105,6 @@ export interface ParamCardViewProps {
  * @returns the card.
  */
 export declare function ParamCardView(props: ParamCardViewProps): ReactNode;
-/**
- * Register a plugin-surface form source by namespace. The platform's
- * `settings.plugin.item` slot does not bind the card's `hooks` compartment, so
- * the owning settings apply hands the stable source here instead.
- * @param namespace - settings namespace.
- * @param source - the stable external-store source.
- */
-export declare function registerPluginParamSource(namespace: string, source: ParamSectionSource): void;
 export declare function PluginParamCard(props: ParamCardFace): ReactNode;
 export declare function ParamCard(props: ParamCardProps): ReactNode;
 //# sourceMappingURL=ParamCard.d.ts.map

package/lib/types/panels/settings/generated-about.d.ts

@@ -5,7 +5,7 @@
  * description, so the settings surface can state both without a hand-written copy.
  */
 /** The family version this surface belongs to. */
-export declare const FAMILY_VERSION = "0.32.6";
+export declare const FAMILY_VERSION = "0.34.0";
 /** What this surface is for, in one line. */
 export declare const PACKAGE_PURPOSE = "Web UI umbrella for the evolution family: settings and skill-history panels";
 //# sourceMappingURL=generated-about.d.ts.map

package/lib/types/panels/settings/messages.d.ts

@@ -34,10 +34,14 @@ export declare const zh: {
     readonly invalidSelect: "不在允许的取值里";
     readonly invalidAtLeast: "不能小于同组的 {n}";
     readonly approvalConfirmNamed: "即将批准：{n}";
+    readonly approvalRawSummary: "原始摘要";
     readonly approvalConfirmYes: "确认批准";
     readonly approvalConfirmNo: "取消";
     readonly resetTo: "复位为 {value}";
     readonly saved: "已保存。";
+    readonly saveReadbackFailed: "写入已被接受，但回读失败；点刷新重读后再确认。";
+    readonly readbackStale: "显示的是最后一次成功读取的值；当前回读失败，刷新后可能变化。";
+    readonly saveConflict: "这个值没有被接受：设置已被其他页面修改。请重读后再保存。";
     readonly resetDone: "已恢复默认值。";
     readonly refused: "这个值没有被接受（界面上保持原样）。想看原因：在对话里让它说明。";
     readonly resetRefused: "恢复默认值没有生效（这一行还是你的值）。想看原因：在对话里让它说明。";
@@ -105,6 +109,8 @@ export declare const zh: {
     readonly diagStatusUnknown: "未知";
     readonly diagRemedy: "建议：";
     readonly diagNoRows: "没有可显示的运行状态";
+    readonly diagPurpose: "用途：检查插件挂载、平台服务和数据面是否正常，不修改任何状态。";
+    readonly diagFooter: "诊断 schema v{version} · 生成于 {at}";
     readonly stateLoading: "正在读取…";
     readonly failureUnauthorized: "需要登录：重新打开这个页面完成登录后再试。";
     readonly failureForbidden: "平台拒绝了这个请求（身份不是 owner）。";

package/lib/types/panels/settings/seam.d.ts

@@ -24,6 +24,13 @@ export declare const CARD_SLOT = "evolution.namespace.card";
 export declare const PENDING_CARD_KEY = "approval-pending";
 /** The diagnostics card's slot key: read-only, no settings namespace (its data comes from HOST_ROUTES.diagnostics). */
 export declare const DIAGNOSTICS_CARD_KEY = "diagnostics";
+/** Structured result of one settings write, separating acceptance from readback. */
+export interface SettingsSaveResult {
+    readonly written: boolean;
+    readonly readback: 'ok' | 'failed';
+    readonly kind?: 'conflict' | 'transport' | 'validation';
+    readonly failure?: unknown;
+}
 /** Snapshot of one settings row, as the client seat reports it. */
 export interface ParamSectionSnapshot {
     status: 'loading' | 'ready' | 'unavailable';
@@ -38,7 +45,9 @@ export interface ParamSectionSnapshot {
      * 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' | 'projection-failed';
+    reason?: 'seat-missing' | 'not-served' | 'projection-failed' | 'readback-failed';
+    /** Last-known values are still shown; the row could not be re-read. */
+    stale?: boolean;
 }
 /** The reactive source the renderer binds to a `use<Name>` seat. */
 export interface ParamSectionSource {
@@ -85,6 +94,15 @@ export interface PluginItemRegisterOptions {
     locale: string;
     inject: () => unknown;
 }
+/** Options a `settings.plugins.tab` contribution carries (rc.3 plugin settings page). */
+export interface PluginsTabRegisterOptions {
+    name: 'settings.plugins.tab';
+    id: string;
+    order: number;
+    label: () => string;
+    locale: string;
+    inject: () => unknown;
+}
 /** Options a `settings.section` registration carries (the shell's own shape). */
 export interface SectionRegisterOptions {
     name: 'settings.section';
@@ -138,7 +156,7 @@ export interface LocaleSeat {
 export interface ClientSeam {
     slots: {
         inject(name: string, callback: () => Generator<unknown, void, unknown>): unknown;
-        register(options: SlotRegisterOptions | PluginItemRegisterOptions | SectionRegisterOptions, component: (props: never) => unknown): () => void;
+        register(options: SlotRegisterOptions | PluginItemRegisterOptions | PluginsTabRegisterOptions | SectionRegisterOptions, component: (props: never) => unknown): () => void;
     };
     locale: LocaleSeat;
 }

package/lib/types/panels/settings/source.d.ts

@@ -22,7 +22,7 @@
  * apply time would capture `undefined` for the whole life of the fiber.
  * @module @lmzhen/dsh-evolution-ui/panels/settings/client
  */
-import type { ConfigFormLike, ConfigFormSnapshotLike, ConfigFormsSeat, ParamSectionSnapshot, ParamSectionSource, SettingsPathOpLike } from './seam.ts';
+import type { ConfigFormLike, ConfigFormSnapshotLike, ConfigFormsSeat, ParamSectionSnapshot, ParamSectionSource, SettingsPathOpLike, SettingsSaveResult } from './seam.ts';
 /** What a card shows when this UI found no settings seat at all. */
 export declare const SEAT_MISSING: ParamSectionSnapshot;
 /** What a card shows when the seat served the row but projecting it failed. A frozen constant
@@ -67,6 +67,7 @@ export declare function sourceFor(probe: SeatProbe, namespace: string): ParamSec
  */
 export declare function writeFaceFor(probe: SeatProbe, namespace: string): {
     mutateOnce: (ops: readonly SettingsPathOpLike[]) => Promise<boolean>;
+    saveOnce: (ops: readonly SettingsPathOpLike[]) => Promise<SettingsSaveResult>;
     clear: (field: string) => Promise<boolean>;
 };
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-ui",
   "description": "Web UI umbrella for the evolution family: settings and skill-history panels (community build)",
-  "version": "0.32.6",
+  "version": "0.34.0",
   "publishConfig": {
     "access": "public"
   },
@@ -45,9 +45,9 @@
     "react": "^18.2.0"
   },
   "dependencies": {
-    "@lmzhen/dsh-evolution-client-kit": "^0.32.6",
-    "@lmzhen/dsh-evolution-core": "^0.32.6",
-    "@lmzhen/dsh-evolution-curator": "^0.32.6"
+    "@lmzhen/dsh-evolution-client-kit": "^0.34.0",
+    "@lmzhen/dsh-evolution-core": "^0.34.0",
+    "@lmzhen/dsh-evolution-curator": "^0.34.0"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",