@lmzhen/dsh-evolution-ui 0.32.5 → 0.32.6

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

@@ -22,6 +22,9 @@ export interface PanelFace extends Copy {
     readonly loadDiff: (name: string, v: number) => Promise<VersionDiffRow>;
     readonly loadBody: (name: string, v: number) => Promise<VersionBodyRow>;
     readonly undo: (name: string, v?: number, unitId?: string) => Promise<string>;
+    /** One explicit navigation request: select this skill when the revision is new. */
+    readonly focusSkill?: string | undefined;
+    readonly focusRevision?: number | undefined;
 }
 export declare function SkillHistoryPanel(face: PanelFace): ReactNode;
 //# sourceMappingURL=Panel.d.ts.map

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

@@ -0,0 +1,53 @@
+/**
+ * The family's one task page. G3 owns the history view; later groups add health
+ * without creating another page or a second navigation registry.
+ * @module @lmzhen/dsh-evolution-ui/panels/history/client
+ */
+import { type ReactNode } from 'react';
+import { type PanelFace } from './Panel.ts';
+import { type PendingCardFace } from '../../settings/PendingCard.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 history: PanelFace;
+    readonly pending: PendingCardFace;
+    /** 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;
+}
+/**
+ * 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 & {
+    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;
+/** 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/index.d.ts

@@ -1,11 +1,15 @@
+/**
+ * Browser half: the family workbench page, starting with the history view.
+ * @module @lmzhen/dsh-evolution-ui/panels/history/client
+ */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import { PANEL_ORDER } from './ids.ts';
+export { PANEL_ORDER };
 /** Required client services: the slot registry and the locale seat. */
 export declare const inject: string[];
-/** Row order inside the global panel list (beside the platform's own rows). */
-export declare const PANEL_ORDER = 35;
 /**
- * Register the locale namespace, the panel row and the panel body.
- * @param ctx - the client cordis context.
+ * Register the locale namespace, the workbench page, and its sidebar entry.
+ * @param ctx - client cordis context.
  */
 export declare function apply(ctx: ClientContext): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -29,6 +29,8 @@ export interface ParamCardFace {
     namespace: string;
     fields: readonly ClientParamField[];
     t: (key: MessageKey, values?: Readonly<Record<string, string | number>>) => string;
+    /** Current UI language for generated labels; omitted defaults to zh. */
+    lang?: () => ParamLanguage;
     /** 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>;
@@ -46,6 +48,8 @@ export type ParamCardProps = Omit<ParamCardFace, 'hooks'> & {
     /** Bound from \`hooks.paramSection\` by the renderer. */
     readonly useParamSection: <T>(selector: (state: ParamSectionSnapshot) => T) => T;
 };
+/** Generated-copy language. */
+export type ParamLanguage = 'zh' | 'en';
 /** The op list a save hands to the seat — the seam's own shape, never a second vocabulary. */
 export type SettingsParamOp = SettingsPathOpLike;
 /**
@@ -83,6 +87,8 @@ export interface ParamCardViewProps {
     namespace: string;
     fields: readonly ClientParamField[];
     t: (key: MessageKey, values?: Readonly<Record<string, string | number>>) => string;
+    /** Current UI language for generated labels; omitted defaults to zh. */
+    lang?: () => ParamLanguage;
     /** ONE call per save, carrying every dirty field as one op list (T5-01/A56). */
     mutateOnce: (ops: readonly SettingsParamOp[]) => Promise<boolean>;
     /** Ask the scope to drop one override; resolves when the scope answered, not when it landed. */
@@ -97,11 +103,13 @@ export interface ParamCardViewProps {
  */
 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.
+ * 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/api.d.ts

@@ -12,6 +12,11 @@ export interface PendingRow {
     };
     readonly status: 'pending' | 'executing' | 'approved' | 'rejected';
     readonly claimedBy?: string | undefined;
+    /** Structured summary from the host; absent on older rows. */
+    readonly verb?: string | undefined;
+    readonly target?: string | undefined;
+    readonly operationCount?: number | undefined;
+    readonly actions?: readonly string[] | undefined;
 }
 /** One windowed hunk of a previewed change: the region the write would touch. */
 export interface PreviewHunk {
@@ -52,6 +57,8 @@ export interface ApprovalApi {
     approve: (id: string) => Promise<ApprovalAnswer<unknown>>;
     /** Close one staged write without replaying it. */
     reject: (id: string) => Promise<ApprovalAnswer<unknown>>;
+    /** Put an EXECUTING claim back into the pending window without replaying it. */
+    release: (id: string) => Promise<ApprovalAnswer<unknown>>;
     /** What that staged write would store, resolved by the host without running it. */
     preview: (id: string) => Promise<ApprovalAnswer<PreviewAnswer>>;
 }

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.5";
+export declare const FAMILY_VERSION = "0.32.6";
 /** 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/generated-params.d.ts

@@ -8,22 +8,34 @@
 export interface ClientParamField {
     id: string;
     group: string;
+    /** User-language group heading. */
+    groupLabel: string;
+    /** English group heading. */
+    groupLabelEn: string;
     /** U-4: the sibling id this field may not go below (an empty string when the row declares no relation). */
     atLeast: string;
     /** The registry summary (English), kept for parity with PARAMETERS.md. */
     doc: string;
     /** Card label, from the registry UI tail (Chinese). */
     label: string;
+    /** English card label (the registry UI tail is Chinese). */
+    labelEn: string;
     /** Card help text, from the registry UI tail (Chinese). */
     hint: string;
+    /** English help text. */
+    hintEn: string;
     /** Which control the card renders. */
     control: 'number' | 'switch' | 'select' | 'text';
     /** Unit suffix for a number field ('' when it carries none). */
     unit: string;
+    /** English unit suffix. */
+    unitEn: string;
     /** Allowed values for a select field ([] otherwise). */
     values: readonly string[];
     /** Display names for `values`, same order ([] shows the raw value). */
     valueLabels: readonly string[];
+    /** English display names for `values`, same order. */
+    valueLabelsEn: readonly string[];
 }
 /** One card: the settings namespace it writes through, the SEAT key its source is looked up by,
  * and the fields it exposes. A73 (`ClientParamSection.namespace` 一名字两义): the two roles are
@@ -37,15 +49,4 @@ 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/panels/settings/index.d.ts

@@ -1,29 +1,14 @@
 /**
- * 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.
+ * Browser half: parameter cards register on the platform's Plugins surface
+ * (`settings.plugin.item`); the family-owned `settings.section` is now only the
+ * diagnostics card. Pending decisions live in `evolution.workbench`.
  *
- * 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 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 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.
  *
- * 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.
+ * A row the Host does not serve renders nothing.
  * @module @lmzhen/dsh-evolution-ui/panels/settings/client
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';

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

@@ -14,6 +14,7 @@ export declare const NS = "evolution-settings";
 export declare const zh: {
     readonly title: "自进化";
     readonly subtitle: "待你决定的写入在最上面；下面按功能列出你能改的参数，没有列出的由安装时的配置决定。";
+    readonly aboutPurpose: "自进化设置与技能历史";
     readonly overridden: "已覆盖";
     readonly deployment: "默认";
     readonly loading: "正在读取设置…";
@@ -36,6 +37,8 @@ export declare const zh: {
     readonly approvalConfirmYes: "确认批准";
     readonly approvalConfirmNo: "取消";
     readonly resetTo: "复位为 {value}";
+    readonly saved: "已保存。";
+    readonly resetDone: "已恢复默认值。";
     readonly refused: "这个值没有被接受（界面上保持原样）。想看原因：在对话里让它说明。";
     readonly resetRefused: "恢复默认值没有生效（这一行还是你的值）。想看原因：在对话里让它说明。";
     readonly cardReview: "会话回顾";
@@ -58,10 +61,22 @@ export declare const zh: {
     readonly approvalCount: "{n} 项待批";
     readonly approvalRunningCount: "{n} 项执行中";
     readonly approvalRefresh: "刷新";
-    readonly approvalExecuting: "执行中：这条的写效果可能已经落地，不要重复批准；要清掉它请用拒绝。";
+    readonly approvalApproving: "批准中…";
+    readonly approvalRejecting: "拒绝中…";
+    readonly approvalExecuting: "执行中：写效果可能已经落地，不要重复批准。先核验效果，再用「放回待批」释放占用；释放不会停止或撤销在途写入。";
+    readonly approvalRelease: "放回待批";
+    readonly approvalReleasing: "释放中…";
     readonly approvalKindMemory: "记忆";
     readonly approvalKindSkill: "技能";
     readonly approvalKindCapability: "能力";
+    readonly approvalVerbAdd: "新增";
+    readonly approvalVerbCreate: "创建";
+    readonly approvalVerbUpdate: "更新";
+    readonly approvalVerbRemove: "移除";
+    readonly approvalVerbDelete: "删除";
+    readonly approvalVerbArchive: "归档";
+    readonly approvalVerbRestore: "恢复";
+    readonly approvalVerbMerge: "合并";
     readonly approvalAgeNow: "刚刚";
     readonly approvalAgeMinutes: "{n} 分钟前";
     readonly approvalAgeHours: "{n} 小时前";
@@ -71,6 +86,7 @@ export declare const zh: {
     readonly approvalPreviewClose: "收起";
     readonly approvalPreviewReading: "正在读取预览…";
     readonly approvalPreviewNone: "看不了预览：";
+    readonly approvalPreviewPath: "文件：{path}";
     readonly approvalDiffAdded: "{n} 行新增";
     readonly approvalDiffRemoved: "{n} 行删除";
     readonly approvalDiffCut: "改动区域已截断";
@@ -109,7 +125,7 @@ export type MessageKey = keyof typeof zh;
 /**
  * Resolve one message without the locale seat (tests and the fallback path).
  * @param key - the message key.
- * @param language - which dictionary to read; defaults to English (the platform FALLBACK_LOCALE).
+ * @param language - which dictionary to read; defaults to zh, matching the platform FALLBACK_LOCALE.
  * @returns the copy this bundle carries.
  */
 export declare function message(key: MessageKey, language?: 'zh' | 'en'): string;

package/lib/types/panels/settings/pending-state.d.ts

@@ -41,6 +41,8 @@ export interface PendingState {
     readonly view: PendingView;
     readonly busy: readonly string[];
     readonly notice: string | null;
+    /** A background re-read is in flight; the previous rows stay on screen. */
+    readonly refreshing: boolean;
     /** The row whose preview is open, or null. One at a time: a preview is a thing being read. */
     readonly open: string | null;
     readonly preview: PreviewView | null;

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

@@ -5,28 +5,14 @@
  * 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.
+ * registration hosting a keyed card slot, 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-ui/panels/settings/client
  */
 import type { ReactNode } from 'react';
 import type { ConfigFormLike as KitConfigFormLike, ConfigFormSnapshotLike as KitConfigFormSnapshotLike, ConfigPathOpLike } from '@lmzhen/dsh-evolution-client-kit';
 /** Our card slot, hosted by the section this bundle registers. */
 export declare const CARD_SLOT = "evolution.namespace.card";
-/** 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`'s config-ledger module 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.
  *
@@ -82,7 +68,7 @@ export type ConfigFormLike<T = Record<string, unknown>> = KitConfigFormLike<T>;
  */
 export interface ConfigFormsSeat {
     /** One Host plugin entry id to its form. */
-    get<T>(entryId: string): ConfigFormLike<T>;
+    get<T>(entryId: string): ConfigFormLike<T> | undefined;
 }
 /** Registration options the keyed card slot under our own section takes. */
 export interface SlotRegisterOptions {
@@ -91,11 +77,12 @@ export interface SlotRegisterOptions {
     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;
+/** Registration options the platform's Plugins list takes for one parameter card. */
+export interface PluginItemRegisterOptions {
+    name: 'settings.plugin.item';
+    id: string;
+    order: number;
+    locale: string;
     inject: () => unknown;
 }
 /** Options a `settings.section` registration carries (the shell's own shape). */
@@ -125,10 +112,8 @@ export interface SectionFace {
     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.
+ * The face the test helper uses to render a parameter card with a page-owned form:
+ * the helper renders from `state` and writes through `mutate`.
  */
 export interface RowConfigViewProps {
     /** `summary` is the row's one-line description fallback; `page` is the whole form. */
@@ -153,7 +138,7 @@ export interface LocaleSeat {
 export interface ClientSeam {
     slots: {
         inject(name: string, callback: () => Generator<unknown, void, unknown>): unknown;
-        register(options: SlotRegisterOptions | RowSeatRegisterOptions | SectionRegisterOptions, component: (props: never) => unknown): () => void;
+        register(options: SlotRegisterOptions | PluginItemRegisterOptions | SectionRegisterOptions, component: (props: never) => unknown): () => void;
     };
     locale: LocaleSeat;
 }

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.5",
+  "version": "0.32.6",
   "publishConfig": {
     "access": "public"
   },
@@ -45,9 +45,9 @@
     "react": "^18.2.0"
   },
   "dependencies": {
-    "@lmzhen/dsh-evolution-client-kit": "^0.32.5",
-    "@lmzhen/dsh-evolution-core": "^0.32.5",
-    "@lmzhen/dsh-evolution-curator": "^0.32.5"
+    "@lmzhen/dsh-evolution-client-kit": "^0.32.6",
+    "@lmzhen/dsh-evolution-core": "^0.32.6",
+    "@lmzhen/dsh-evolution-curator": "^0.32.6"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",

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

@@ -1,30 +0,0 @@
-/**
- * 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-ui/panels/settings/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, values?: Readonly<Record<string, string | number>>) => 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