@huanlin/dsh-plugin-sidebar-brand-text 0.4.2 → 0.6.0

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

@@ -1,38 +1,38 @@
-/**
- * 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 { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
-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:
+ *   - `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;

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

@@ -1,29 +1,29 @@
-import type { BrandTextState } from './controller.ts';
-import type { SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
-/** 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 (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 {};

package/lib/types/settings.d.ts

@@ -1,31 +1,31 @@
-/**
- * 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: import("@deepseek-ai/dsh-settings").SettingsNamespace;
-/** 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`.
+ *
+ * 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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huanlin/dsh-plugin-sidebar-brand-text",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "publishConfig": {
     "access": "public"
   },
@@ -17,10 +17,6 @@
       "types": "./lib/types/index.d.ts",
       "import": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "import": "./lib/invariant.js"
-    },
     "./client": {
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
@@ -38,24 +34,27 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-api-session-controller",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-store",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-settings-plugins",
         "@deepseek-ai/dsh-client-ui-sidebar",
-        "@deepseek-ai/dsh-client-ui-settings-plugins"
+        "@deepseek-ai/dsh-client-ui-slots"
       ],
       "platform": "web"
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.0-rc.7",
-    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-invariants": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
+    "@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",
     "react": "^18.2.0"
   },
@@ -63,10 +62,16 @@
     "@deepseek-ai/cordis": {
       "optional": true
     },
+    "@deepseek-ai/dsh-api-session-controller": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-client-locale": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-runtime": {
+    "@deepseek-ai/dsh-client-store": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-renderer": {
       "optional": true
     },
     "@deepseek-ai/dsh-client-ui-settings-plugins": {
@@ -78,9 +83,6 @@
     "@deepseek-ai/dsh-client-ui-slots": {
       "optional": true
     },
-    "@deepseek-ai/dsh-invariants": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-settings": {
       "optional": true
     },
@@ -92,14 +94,7 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.0-rc.7",
-    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-invariants": "0.1.0-rc.8",
-    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
+    "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/schemastery": "^3.18.1",
     "@types/node": "^22.20.1",
     "@types/react": "~18.3.31",

package/lib/invariant.js

@@ -1,21 +0,0 @@
-//#region src/invariant.ts
-const PACKAGE_NAME = "@huanlin/dsh-plugin-sidebar-brand-text";
-const name = "sidebar-brand-text-invariant";
-const inject = ["invariants"];
-/**
-* No runtime invariant: the single `sidebar.brand.name` slot registration
-* is a registry-owned contribution whose disposal is proven by the
-* declaration-aware `slots.inject()` rollback. The plugin retains no
-* mutable state beyond the config snapshot closed over by the inject
-* factory.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,10 +0,0 @@
-/** Package invariant companion for dsh-plugin-sidebar-brand-text. */
-import type { Context } from '@deepseek-ai/cordis';
-export declare const name = "sidebar-brand-text-invariant";
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;