@huanlin/dsh-plugin-sidebar-brand-text 0.6.1 → 0.7.0

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

@@ -1,38 +1,39 @@
-/**
- * sidebar-brand-text — browser half.
- *
- * Two registrations:
- *   - `settings.plugin.item` keyed slot (key `sidebar-brand-text`) — a card
- *     in the Plugin Config page with two text inputs (name + revision).
- *     Reads/writes through the `/sbbt/api` HTTP route via the shared
- *     `BrandTextSettingsController`.
- *   - `sidebar.brand.name` single slot — renders the configured brand name
- *     text and optional revision badge. Reads from the same controller
- *     store via `useSnapshot`, so a save in the card is instantly
- *     reflected in the sidebar.
- *
- * The mark slot (`sidebar.brand.mark`) is deliberately NOT registered:
- * the fish logo stays in place unless another plugin (e.g.
- * `ui-brand-official`) replaces it.
- *
- * @module @huanlin/dsh-plugin-sidebar-brand-text/client
- */
-import type { Context as ClientContext } from '@deepseek-ai/cordis';
-import { type BrandTextKey } from './locales.ts';
-declare module '@deepseek-ai/dsh-client-ui-slots' {
-    interface LocaleNamespaceMap {
-        /** The settings card labels. */
-        'dsh-plugin-sidebar-brand-text': BrandTextKey;
-    }
-}
-/** Required services: slots + locale + sessions (sessions drives the title writer). */
-export declare const inject: string[];
-/**
- * Client plugin body: register the brand-name slot occupant, the settings
- * card, the locale dictionary, and the stylesheet.
- *
- * A single `BrandTextSettingsController` is shared between the card and
- * the brand text so a save is instantly reflected in the sidebar.
- * @param ctx - client root context.
- */
-export declare function apply(ctx: ClientContext): void;
+/**
+ * sidebar-brand-text — browser half.
+ *
+ * Two registrations:
+ *   - `plugins.row.config` keyed slot (key
+ *     `@huanlin/dsh-plugin-sidebar-brand-text#sidebar-brand-text`) — the
+ *     plugin's configuration page on the Plugins page, with two text inputs
+ *     (name + revision). Reads/writes through the `/sbbt/api` HTTP route via
+ *     the shared `BrandTextSettingsController`.
+ *   - `sidebar.brand.name` single slot — renders the configured brand name
+ *     text and optional revision badge. Reads from the same controller
+ *     store via `useSnapshot`, so a save in the card is instantly
+ *     reflected in the sidebar.
+ *
+ * The mark slot (`sidebar.brand.mark`) is deliberately NOT registered:
+ * the fish logo stays in place unless another plugin (e.g.
+ * `ui-brand-official`) replaces it.
+ *
+ * @module @huanlin/dsh-plugin-sidebar-brand-text/client
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import { type BrandTextKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The settings card labels. */
+        'dsh-plugin-sidebar-brand-text': BrandTextKey;
+    }
+}
+/** Required services: slots + locale + sessions (sessions drives the title writer). */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the brand-name slot occupant, the settings
+ * card, the locale dictionary, and the stylesheet.
+ *
+ * A single `BrandTextSettingsController` is shared between the card and
+ * the brand text so a save is instantly reflected in the sidebar.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;

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

@@ -1,29 +1,34 @@
-import type { BrandTextState } from './controller.ts';
-import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
-/** Minimal face of `sessions.list` we depend on (ISessions.list slice). */
-interface SessionListSnapshot {
-    current: string | undefined;
-    byId: Record<string, {
-        title?: string;
-    } | undefined>;
-}
-/** Minimal face of the `sessions` service we depend on. */
-interface SessionsLike {
-    readonly list: {
-        getSnapshot(): SessionListSnapshot;
-        subscribe(fn: () => void): () => void;
-    };
-}
-/** Disposer returned by {@link startTitleWriter}. */
-export type TitleWriterDisposer = () => void;
-/**
- * Start overriding `document.title` with the configured brand name.
- *
- * @param sessions - the cordis `sessions` service (read-only face).
- * @param store - the shared `BrandTextSettingsController` store; the title
- *   updates when the config changes (card save) as well as when the current
- *   session changes.
- * @returns a disposer that tears down all subscriptions and the observer.
- */
-export declare function startTitleWriter(sessions: SessionsLike | undefined, store: SnapshotStore<BrandTextState>): TitleWriterDisposer;
-export {};
+import type { BrandTextState } from './controller.ts';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+/** Minimal face of `sessions.list` we depend on.
+ *
+ * rc.1's `ISessions.list` snapshot (`SessionListState`) carries `byId` only:
+ * the selected-session id moved out of the sessions domain. `current` is kept
+ * optional so the writer still accepts the rc.1 snapshot; when it is absent the
+ * title falls back to the brand name alone. */
+interface SessionListSnapshot {
+    current?: string | undefined;
+    byId: Record<string, {
+        title?: string;
+    } | undefined>;
+}
+/** Minimal face of the `sessions` service we depend on. */
+interface SessionsLike {
+    readonly list: {
+        getSnapshot(): SessionListSnapshot;
+        subscribe(fn: () => void): () => void;
+    };
+}
+/** Disposer returned by {@link startTitleWriter}. */
+export type TitleWriterDisposer = () => void;
+/**
+ * Start overriding `document.title` with the configured brand name.
+ *
+ * @param sessions - the cordis `sessions` service (read-only face).
+ * @param store - the shared `BrandTextSettingsController` store; the title
+ *   updates when the config changes (card save) as well as when the current
+ *   session changes.
+ * @returns a disposer that tears down all subscriptions and the observer.
+ */
+export declare function startTitleWriter(sessions: SessionsLike | undefined, store: SnapshotStore<BrandTextState>): TitleWriterDisposer;
+export {};

package/lib/types/config.d.ts

@@ -9,9 +9,19 @@
  * @module @huanlin/dsh-plugin-sidebar-brand-text/config
  */
 import z from '@deepseek-ai/schemastery';
+import type { Volatile } from '@deepseek-ai/cordis';
 import type { BrandTextConfig } from './types.ts';
-/** Schemastery schema for the composition entry and the settings namespace. */
-export declare const Config: z<BrandTextConfig>;
+/**
+ * Volatile Cordis config the loader passes to {@link apply}: each editable
+ * field is a stable reference whose `.get()` returns the latest accepted
+ * value. `Settings` enumerates these fields for the profile-owned form.
+ */
+export interface BrandTextEntryConfig {
+    name: Volatile<string>;
+    revision: Volatile<string>;
+}
+/** Schemastery schema for the composition entry (live-editable via `.volatile()`). */
+export declare const Config: z<BrandTextEntryConfig>;
 /**
  * Resolve a raw config object into a complete {@link BrandTextConfig}.
  *

package/lib/types/index.d.ts

@@ -16,7 +16,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import { Config } from './config.ts';
-import type { BrandTextConfig } from './types.ts';
+import type { BrandTextEntryConfig } from './config.ts';
 export declare const name = "sidebar-brand-text";
 /** `webServer` is required for the HTTP gateway that backs the settings card. */
 export declare const inject: string[];
@@ -27,6 +27,6 @@ export { Config };
  * Plugin body: install the settings bridge and register the HTTP gateway.
  *
  * @param ctx - host context carrying `webServer`.
- * @param config - resolved config (seed values).
+ * @param config - the entry's volatile Cordis config.
  */
-export declare function apply(ctx: Context, config: BrandTextConfig): void;
+export declare function apply(ctx: Context, config: BrandTextEntryConfig): void;

package/lib/types/settings.d.ts

@@ -1,31 +1,37 @@
-/**
- * Host-side settings bridge for `sidebar-brand-text`.
- *
- * Mirrors the ego-browser / dsh-plugin-interpreters pattern: a `source()`
- * thunk the HTTP gateway reads in-process, plus an `onChange()` subscription.
- * The settings service is reached through `ctx.inject(['settings'], ...)` so a
- * composition without a settings provider still loads (entry-source fallback,
- * no persistence). Multi-fiber dedupe is handled by catching the
- * `"already registered"` rejection.
- *
- * @module @huanlin/dsh-plugin-sidebar-brand-text/settings
- */
-import type { Context } from '@deepseek-ai/cordis';
-import type { BrandTextConfig } from './types.ts';
-/** Settings namespace under which brand-text config persists. */
-export declare const SETTINGS_NAMESPACE: "sidebar-brand-text";
-/** Bridge returned by {@link installBrandTextSettings}. */
-export interface BrandTextSettingsBridge {
-    /** Read the current resolved config (entry source or settings layer). */
-    source(): BrandTextConfig;
-    /** Subscribe to config changes (live re-registration follows every commit). */
-    onChange(callback: () => void): () => void;
-}
-/**
- * Install the `sidebar-brand-text` settings namespace and return the bridge.
- *
- * @param ctx - host context.
- * @param entry - raw composition-layer config seed.
- * @returns the settings bridge.
- */
-export declare function installBrandTextSettings(ctx: Context, entry: BrandTextConfig): BrandTextSettingsBridge;
+/**
+ * Host-side settings bridge for `sidebar-brand-text`.
+ *
+ * dsh 0.1.7-rc.1 moved plugin configuration into the profile-owned Cordis
+ * `Config`: the fields are marked `.volatile()` (see `config.ts`), so the
+ * loader commits live references without remounting. The namespace-registration API
+ * is gone; a plugin only declares the presentation policy for its own page.
+ *
+ * This bridge exposes a `source()` thunk the `/sbbt/api` gateway reads
+ * in-process. Each call reads the current volatile reference, so the gateway
+ * always serves the latest accepted value. The value persists in the active
+ * profile's `cordis.patch.yml` under the entry's `config` (the entry id is the
+ * composition row id declared in `cordis.patch.yml`).
+ *
+ * @module @huanlin/dsh-plugin-sidebar-brand-text/settings
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { BrandTextEntryConfig } from './config.ts';
+import type { BrandTextConfig } from './types.ts';
+/** The composition row id: the settings namespace / profile entry id. */
+export declare const SETTINGS_NAMESPACE: "sidebar-brand-text";
+/** Bridge returned by {@link installBrandTextSettings}. */
+export interface BrandTextSettingsBridge {
+    /** Read the current resolved config from the entry's volatile references. */
+    source(): BrandTextConfig;
+}
+/**
+ * Declare the plugin's settings presentation policy and return the bridge.
+ *
+ * `auto: false` suppresses a schema-generated page: this plugin ships its own
+ * form through the `plugins.row.config` slot on the Plugins page.
+ *
+ * @param ctx - host context.
+ * @param config - the entry's volatile Cordis config.
+ * @returns the settings bridge.
+ */
+export declare function installBrandTextSettings(ctx: Context, config: BrandTextEntryConfig): BrandTextSettingsBridge;

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Sidebar Brand Text",
+    "description": "Replace the sidebar brand name and revision badge with custom text."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "侧边栏品牌文案",
+    "description": "替换侧边栏左上角的品牌名与构建徽标文案。"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huanlin/dsh-plugin-sidebar-brand-text",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "publishConfig": {
     "access": "public"
   },
@@ -21,11 +21,13 @@
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
     },
+    "./locale/*.json": "./locale/*.json",
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
     "lib/",
+    "locale/",
     "cordis.patch.yml"
   ],
   "dsh": {
@@ -37,8 +39,8 @@
         "@deepseek-ai/dsh-api-session-controller",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-store",
+        "@deepseek-ai/dsh-client-ui-plugin-manager",
         "@deepseek-ai/dsh-client-ui-renderer",
-        "@deepseek-ai/dsh-client-ui-settings-plugins",
         "@deepseek-ai/dsh-client-ui-sidebar",
         "@deepseek-ai/dsh-client-ui-slots"
       ],
@@ -47,15 +49,15 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
-    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
@@ -71,10 +73,10 @@
     "@deepseek-ai/dsh-client-store": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-ui-renderer": {
+    "@deepseek-ai/dsh-client-ui-plugin-manager": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-ui-settings-plugins": {
+    "@deepseek-ai/dsh-client-ui-renderer": {
       "optional": true
     },
     "@deepseek-ai/dsh-client-ui-sidebar": {
@@ -95,13 +97,12 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
     "@types/node": "^22.20.1",
     "@types/react": "~18.3.31",
     "jsdom": "^26.0.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "schemastery": "^3.18.0",
     "tsdown": "^0.15.0",
     "typescript": "^5.9.0",
     "vitest": "^3.2.0"