@huanlin/dsh-plugin-sidebar-brand-text 0.3.0

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["DEFAULT_BRAND_TEXT_CONFIG: BrandTextConfig","cfg: BrandTextConfig","cardStyle: CSSProperties","headerStyle: CSSProperties","headTextStyle: CSSProperties","nameStyle: CSSProperties","descStyle: CSSProperties","pendingStyle: CSSProperties","bodyStyle: CSSProperties","formStyle: CSSProperties","fieldStyle: CSSProperties","labelStyle: CSSProperties","inputStyle: CSSProperties","hintStyle: CSSProperties","footerStyle: CSSProperties","btnBase: CSSProperties","noticeStyle: CSSProperties","savedStyle: CSSProperties","errorStyle: CSSProperties","body: React.ReactNode","en: Record<BrandTextKey, string>","zh: Record<BrandTextKey, string>"],"sources":["../src/types.ts","../src/client/BrandText.tsx","../src/client/BrandTextCard.tsx","../src/client/controller.ts","../src/client/bindSnapshotSelector.ts","../src/client/locales.ts","../src/client/styles.ts","../src/client/index.ts"],"sourcesContent":["/** Shared config surface of the sidebar-brand-text plugin (host + client halves). */\n\n/**\n * The plugin's user-facing settings, persisted through the settings seam\n * under the `sidebar-brand-text` namespace in `$DSH_HOME/settings.yaml`.\n * The browser half reads these via the `/sbbt/api/get` HTTP route.\n */\nexport interface BrandTextConfig {\n  /**\n   * Brand name text shown in the sidebar's top-left brand row, beside the\n   * mark slot. Replaces the shell's \"DSH Local Build\" fallback.\n   */\n  name: string\n  /**\n   * Revision badge text rendered beside the brand name. Empty string hides\n   * the badge entirely. Replaces the shell's 7-character\n   * `DSH_CLIENT_COMMIT_HASH` fallback.\n   */\n  revision: string\n}\n\n/** Runtime defaults applied when no config arrives (defensive only). */\nexport const DEFAULT_BRAND_TEXT_CONFIG: BrandTextConfig = {\n  name: 'DSH Local Build',\n  revision: '',\n}\n","/**\n * The `sidebar.brand.name` slot occupant — renders the configured brand\n * name text and optional revision badge.\n *\n * Reads from the shared `BrandTextSettingsController` store via\n * `useSnapshot`, so a save in the settings card is instantly reflected\n * here without a DOM event or RPC re-fetch.\n *\n * Replaces the shell's fallback (`DSH Local Build` + 7-character\n * `DSH_CLIENT_COMMIT_HASH` badge). The mark slot (`sidebar.brand.mark`)\n * is untouched: the fish logo stays unless another plugin (e.g.\n * `ui-brand-official`) replaces it.\n *\n * @module @huanlin/dsh-plugin-sidebar-brand-text/client/BrandText\n */\nimport type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'\nimport type {} from '@deepseek-ai/dsh-client-ui-sidebar/client'\nimport type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots'\nimport type { BrandTextConfig } from '../types.ts'\nimport { DEFAULT_BRAND_TEXT_CONFIG } from '../types.ts'\n\n/** Inject face: the selector hook bound to the shared controller store. */\nexport interface BrandTextInjected {\n  readonly useSnapshot: SnapshotSelectorHook<BrandTextStateShell>\n}\n\n/** The slice of state the brand component reads. */\nexport interface BrandTextStateShell {\n  draft: BrandTextConfig\n  available: boolean\n}\n\n/** Full props: the slot's runtime share plus the plugin's inject face. */\nexport type BrandTextProps = PropsRuntime<'sidebar.brand.name'> & BrandTextInjected\n\n/**\n * Render the configured brand name and optional revision badge.\n *\n * While loading or on error, falls back to the shell defaults.\n * @param props - the `useSnapshot` inject face (plus the slot's runtime share, unused).\n * @returns the brand-name span and optional revision-badge span.\n */\nexport function BrandText({ useSnapshot }: BrandTextProps) {\n  const state = useSnapshot((s) => s)\n  const cfg: BrandTextConfig = state.available ? state.draft : DEFAULT_BRAND_TEXT_CONFIG\n\n  return (\n    <>\n      <span className=\"sbbt-brand-name\">{cfg.name}</span>\n      {cfg.revision !== '' ? (\n        <span className=\"sbbt-build-revision\">{cfg.revision}</span>\n      ) : null}\n    </>\n  )\n}\n","/**\n * BrandTextCard — the `settings.plugin.item` slot occupant.\n *\n * An expandable card (mirrors the ego-browser `EgoBrowserCard` pattern)\n * with two text inputs: brand name and revision badge. Reads/writes\n * through the shared `BrandTextSettingsController` which uses\n * `fetch('/sbbt/api/get')` and `fetch('/sbbt/api/set')`.\n *\n * Registered under the `settings.plugin.item` keyed slot with\n * `key: 'sidebar-brand-text'` — appears in the Plugin Config page\n * alongside the built-in cards.\n *\n * @module @huanlin/dsh-plugin-sidebar-brand-text/client/BrandTextCard\n */\nimport type { CSSProperties } from 'react'\nimport type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots'\nimport type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots'\nimport type { BrandTextState } from './controller.ts'\n\n/** Inject face: controller + selector hook. */\nexport interface BrandTextCardInjected {\n  readonly controller: {\n    readonly load: () => Promise<void>\n    readonly edit: (field: 'name' | 'revision', value: string) => void\n    readonly discard: () => void\n    readonly save: () => Promise<void>\n    readonly toggle: () => void\n  }\n  readonly useSnapshot: SnapshotSelectorHook<BrandTextState>\n}\n\n/** Full props: locale seat + inject. */\nexport type BrandTextCardProps = PropsLocale<'dsh-plugin-sidebar-brand-text'> & BrandTextCardInjected\n\nconst cardStyle: CSSProperties = {\n  border: '1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.22))',\n  background: 'var(--dsw-alias-bg-layer-3, transparent)',\n  borderRadius: 12,\n  listStyle: 'none',\n  transition: 'border-color .16s, background .16s',\n}\n\nconst headerStyle: CSSProperties = {\n  appearance: 'none',\n  width: '100%',\n  font: 'inherit',\n  color: 'inherit',\n  textAlign: 'left',\n  cursor: 'pointer',\n  background: 'transparent',\n  border: 0,\n  borderRadius: 12,\n  alignItems: 'center',\n  gap: 12,\n  padding: '14px 16px',\n  display: 'flex',\n}\n\nconst headTextStyle: CSSProperties = {\n  flexDirection: 'column',\n  flex: 1,\n  gap: 4,\n  minWidth: 0,\n  display: 'flex',\n}\n\nconst nameStyle: CSSProperties = {\n  color: 'var(--dsw-alias-label-primary, inherit)',\n  fontSize: 15,\n  fontWeight: 600,\n  lineHeight: 1.4,\n}\n\nconst descStyle: CSSProperties = {\n  color: 'var(--dsw-alias-label-tertiary, rgba(128,128,128,0.7))',\n  fontSize: 13,\n  lineHeight: 1.5,\n}\n\nconst pendingStyle: CSSProperties = {\n  whiteSpace: 'nowrap',\n  background: 'var(--dsw-alias-bg-module-platform, rgba(128,128,128,0.12))',\n  color: 'var(--dsw-alias-label-secondary, inherit)',\n  borderRadius: 999,\n  flex: 'none',\n  padding: '1px 8px',\n  fontSize: 11,\n  fontWeight: 500,\n  lineHeight: '17px',\n}\n\nconst chevronStyle = (open: boolean): CSSProperties => ({\n  color: 'var(--dsw-alias-label-tertiary, inherit)',\n  flex: 'none',\n  transition: 'transform .16s',\n  display: 'inline-flex',\n  alignItems: 'center',\n  transform: open ? 'rotate(180deg)' : 'none',\n})\n\nconst bodyStyle: CSSProperties = {\n  borderTop: '1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.22))',\n  margin: '0 16px',\n  padding: '12px 0 4px',\n}\n\nconst formStyle: CSSProperties = {\n  display: 'flex',\n  flexDirection: 'column',\n  gap: 12,\n}\n\nconst fieldStyle: CSSProperties = {\n  display: 'flex',\n  flexDirection: 'column',\n  gap: 4,\n}\n\nconst labelStyle: CSSProperties = {\n  display: 'block',\n  fontSize: 13,\n  fontWeight: 500,\n  color: 'var(--dsw-alias-label-primary, inherit)',\n}\n\nconst inputStyle: CSSProperties = {\n  width: '100%',\n  padding: '6px 10px',\n  fontSize: 13,\n  borderRadius: 8,\n  border: '1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.3))',\n  background: 'var(--dsw-alias-bg-layer-3, transparent)',\n  color: 'var(--dsw-alias-label-primary, inherit)',\n  boxSizing: 'border-box',\n  fontFamily: 'inherit',\n}\n\nconst hintStyle: CSSProperties = {\n  fontSize: 12,\n  color: 'var(--dsw-alias-label-tertiary, rgba(128,128,128,0.6))',\n  margin: 0,\n  lineHeight: 1.5,\n}\n\nconst footerStyle: CSSProperties = {\n  borderTop: '1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.22))',\n  justifyContent: 'flex-end',\n  alignItems: 'center',\n  gap: 8,\n  padding: '12px 0 4px',\n  display: 'flex',\n}\n\nconst btnBase: CSSProperties = {\n  appearance: 'none',\n  font: 'inherit',\n  cursor: 'pointer',\n  border: '1px solid transparent',\n  borderRadius: 8,\n  padding: '5px 14px',\n  fontSize: 13,\n  fontWeight: 500,\n  lineHeight: '20px',\n  color: 'var(--dsw-alias-label-primary, inherit)',\n  background: 'var(--dsw-alias-bg-module-platform, rgba(128,128,128,0.12))',\n  transition: 'background .16s, opacity .16s',\n}\n\nconst noticeStyle: CSSProperties = {\n  color: 'var(--dsw-alias-label-tertiary, rgba(128,128,128,0.7))',\n  margin: '0 0 8px',\n  fontSize: 12,\n  lineHeight: 1.5,\n}\n\nconst savedStyle: CSSProperties = {\n  color: 'var(--dsw-alias-state-success-primary, #30d158)',\n  margin: '0 0 12px',\n  fontSize: 12,\n  lineHeight: 1.5,\n}\n\nconst errorStyle: CSSProperties = {\n  color: 'var(--dsw-alias-label-error, #ff453a)',\n  margin: '0 0 12px',\n  fontSize: 12,\n  lineHeight: 1.5,\n  minWidth: 0,\n}\n\nconst CHEVRON_SVG = '<svg width=\"14\" height=\"14\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M6 9l6 6 6-6\"/></svg>'\n\n/**\n * Render the sidebar-brand-text settings card.\n * @param props - locale + controller/useSnapshot inject.\n * @returns a `<li>` card element.\n */\nexport function BrandTextCard({ t, controller, useSnapshot }: BrandTextCardProps) {\n  const state = useSnapshot((s) => s)\n  if (state.status === 'idle') void controller.load()\n\n  const degraded = state.status === 'ready' && !state.available\n  const open = state._open || degraded\n  const applyState = state.applyState ?? { kind: 'idle' }\n  const saving = applyState.kind === 'saving'\n  const saved = applyState.kind === 'saved'\n  const errorText = applyState.kind === 'error' ? applyState.message : undefined\n  const busy = !state.writable || saving\n\n  const header = (\n    <button\n      type=\"button\"\n      style={headerStyle}\n      aria-expanded={open}\n      aria-label={t('card.title')}\n      onClick={() => { if (!degraded) controller.toggle() }}\n    >\n      <span style={headTextStyle}>\n        <span style={nameStyle}>{t('card.title')}</span>\n        <span style={descStyle}>{t('card.intro')}</span>\n      </span>\n      {state.dirty ? <span style={pendingStyle}>{t('card.unsaved')}</span> : null}\n      <span style={chevronStyle(open)} dangerouslySetInnerHTML={{ __html: CHEVRON_SVG }} />\n    </button>\n  )\n\n  let body: React.ReactNode = null\n  if (open) {\n    if (!state.available) {\n      body = (\n        <div style={bodyStyle}>\n          <p style={noticeStyle} role=\"status\">{t('card.unavailable')}</p>\n          <div style={footerStyle}>\n            <button\n              type=\"button\"\n              style={btnBase}\n              onClick={() => { void controller.load() }}\n            >\n              {t('card.retry')}\n            </button>\n          </div>\n        </div>\n      )\n    } else {\n      body = (\n        <div style={bodyStyle}>\n          {saved ? <p style={savedStyle} role=\"status\">{t('card.saved')}</p> : null}\n          {errorText !== undefined ? <p style={errorStyle} role=\"status\">{errorText}</p> : null}\n          <div style={formStyle}>\n            <div style={fieldStyle}>\n              <label style={labelStyle} htmlFor=\"sbbt-name\">{t('field.name.label')}</label>\n              <input\n                id=\"sbbt-name\"\n                type=\"text\"\n                style={inputStyle}\n                value={state.draft.name}\n                placeholder={t('field.name.placeholder')}\n                disabled={busy}\n                onChange={(e) => controller.edit('name', e.target.value)}\n              />\n              <p style={hintStyle}>{t('field.name.hint')}</p>\n            </div>\n            <div style={fieldStyle}>\n              <label style={labelStyle} htmlFor=\"sbbt-revision\">{t('field.revision.label')}</label>\n              <input\n                id=\"sbbt-revision\"\n                type=\"text\"\n                style={inputStyle}\n                value={state.draft.revision}\n                placeholder={t('field.revision.placeholder')}\n                disabled={busy}\n                onChange={(e) => controller.edit('revision', e.target.value)}\n              />\n              <p style={hintStyle}>{t('field.revision.hint')}</p>\n            </div>\n          </div>\n          <div style={footerStyle}>\n            <button\n              type=\"button\"\n              style={{ ...btnBase, opacity: (!state.dirty || saving) ? 0.5 : 1 }}\n              disabled={!state.dirty || saving}\n              onClick={() => controller.discard()}\n            >\n              {t('card.discard')}\n            </button>\n            <button\n              type=\"button\"\n              style={{\n                ...btnBase,\n                background: 'var(--dsw-alias-brand-primary, #0a84ff)',\n                color: 'var(--dsw-alias-bg-layer-1, #fff)',\n                opacity: (!state.dirty || saving) ? 0.5 : 1,\n              }}\n              disabled={!state.dirty || saving}\n              onClick={() => { void controller.save() }}\n            >\n              {saving ? t('card.saving') : t('card.save')}\n            </button>\n          </div>\n        </div>\n      )\n    }\n  }\n\n  return (\n    <li style={cardStyle}>\n      {header}\n      {open ? body : null}\n    </li>\n  )\n}\n","/**\n * `BrandTextSettingsController` — client-side state store for the\n * sidebar-brand-text config.\n *\n * Loads the config from the host's `/sbbt/api/get` route, stages edits,\n * and saves via `/sbbt/api/set`. The `sidebar.brand.name` slot occupant\n * and the `settings.plugin.item` card both read from the same store via\n * `bindSnapshotSelector`, so a save is instantly reflected in the sidebar\n * without a DOM event or page reload.\n *\n * Mirrors the ego-browser `EgoBrowserSettingsController` pattern.\n *\n * @module @huanlin/dsh-plugin-sidebar-brand-text/client/controller\n */\nimport { createSnapshotStore, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'\nimport { DEFAULT_BRAND_TEXT_CONFIG, type BrandTextConfig } from '../types.ts'\n\n/** The controller's snapshot state. */\nexport interface BrandTextState {\n  /** 'idle' | 'loading' | 'ready' */\n  status: 'idle' | 'loading' | 'ready'\n  /** True after a successful `/sbbt/api/get`; false when the route is unreachable. */\n  available: boolean\n  /** False when the settings service is absent (read-only). */\n  writable: boolean\n  /** Current draft values (edited by the card, read by the brand slot). */\n  draft: BrandTextConfig\n  /** True when the draft differs from the last-saved config. */\n  dirty: boolean\n  /** Apply lifecycle: 'idle' | 'saving' | 'saved' | 'error'. */\n  applyState: { kind: 'idle' } | { kind: 'saving' } | { kind: 'saved' } | { kind: 'error', message: string }\n  /** Card expand state (toggled by the card header button). */\n  _open: boolean\n}\n\n/** Initial state before the first load. */\nfunction initialState(): BrandTextState {\n  return {\n    status: 'idle',\n    available: false,\n    writable: false,\n    draft: { ...DEFAULT_BRAND_TEXT_CONFIG },\n    dirty: false,\n    applyState: { kind: 'idle' },\n    _open: false,\n  }\n}\n\n/**\n * Controller managing the brand-text config lifecycle.\n *\n * Constructed once in the client `apply()` and shared between the\n * `sidebar.brand.name` slot and the `settings.plugin.item` card.\n */\nexport class BrandTextSettingsController {\n  readonly store: SnapshotStore<BrandTextState>\n  loaded = false\n  private generation = 0\n\n  constructor() {\n    this.store = createSnapshotStore<BrandTextState>(initialState())\n  }\n\n  /** Fetch the config from `/sbbt/api/get` and update the store. */\n  async load(): Promise<void> {\n    const gen = ++this.generation\n    this.store.update((s) => { s.status = 'loading' })\n    try {\n      const res = await fetch('/sbbt/api/get', {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: '{}',\n      })\n      if (!res.ok) {\n        this.markUnavailable(gen)\n        return\n      }\n      const parsed = await res.json().catch(() => null)\n      if (gen !== this.generation) return\n      if (!parsed || parsed.ok !== true || !parsed.value) {\n        this.markUnavailable(gen)\n        return\n      }\n      const config = parsed.value.config as BrandTextConfig | undefined\n      this.loaded = true\n      this.store.update((s) => {\n        s.status = 'ready'\n        s.available = true\n        s.writable = true\n        if (config) {\n          s.draft = { name: config.name, revision: config.revision }\n        }\n        s.dirty = false\n        s.applyState = { kind: 'idle' }\n      })\n    } catch {\n      this.markUnavailable(gen)\n    }\n  }\n\n  /** Stage an edit to a field (does not save). */\n  edit(field: 'name' | 'revision', value: string): void {\n    this.store.update((s) => {\n      if (field === 'name') s.draft.name = value\n      else s.draft.revision = value\n      s.dirty = true\n      s.applyState = { kind: 'idle' }\n    })\n  }\n\n  /** Discard staged edits and reload from the host. */\n  discard(): void {\n    void this.load()\n  }\n\n  /** Save the staged draft via `/sbbt/api/set`. */\n  async save(): Promise<void> {\n    const gen = ++this.generation\n    const snapshot = this.store.getSnapshot()\n    if (!snapshot.dirty) return\n    this.store.update((s) => { s.applyState = { kind: 'saving' } })\n    try {\n      const res = await fetch('/sbbt/api/set', {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify({ patch: snapshot.draft }),\n      })\n      const parsed = await res.json().catch(() => null)\n      if (gen !== this.generation) return\n      if (!parsed || parsed.ok !== true || !parsed.value) {\n        const message = parsed?.error?.message ?? 'Save failed'\n        this.store.update((s) => { s.applyState = { kind: 'error', message } })\n        return\n      }\n      const config = parsed.value.config as BrandTextConfig | undefined\n      this.store.update((s) => {\n        s.applyState = { kind: 'saved' }\n        if (config) {\n          s.draft = { name: config.name, revision: config.revision }\n        }\n        s.dirty = false\n      })\n    } catch (error) {\n      if (gen !== this.generation) return\n      const message = error instanceof Error ? error.message : String(error)\n      this.store.update((s) => { s.applyState = { kind: 'error', message } })\n    }\n  }\n\n  /** Toggle the card's expand state (mirrors ego-browser `controller.toggle()`). */\n  toggle(): void {\n    this.store.update((s) => { s._open = !s._open })\n  }\n\n  /** Mark the store as unavailable (route unreachable or settings service absent). */\n  private markUnavailable(gen: number): void {\n    if (gen !== this.generation) return\n    this.store.update((s) => {\n      s.status = 'ready'\n      s.available = false\n      s.writable = false\n    })\n  }\n}\n","/**\n * Inlined `bindSnapshotSelector` — rc.8 dropped this from\n * `@deepseek-ai/dsh-client-ui-renderer`'s package root, so business plugins\n * carry their own copy. Uses React 18's built-in `useSyncExternalStore`\n * with per-snapshot selector memoization via `useRef` (same approach as\n * the ego-browser plugin).\n *\n * @module @huanlin/dsh-plugin-sidebar-brand-text/client/bindSnapshotSelector\n */\nimport { useRef, useSyncExternalStore } from 'react'\nimport type { HostObservable, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots'\n\n/**\n * Bind a React selector hook to a {@link HostObservable} snapshot source.\n * @param source - the observable snapshot store.\n * @returns a `useSelector(sel, eq?)` hook.\n */\nexport function bindSnapshotSelector<T>(source: HostObservable<T>): SnapshotSelectorHook<T> {\n  const subscribe = (fn: () => void): (() => void) => source.subscribe(fn)\n  const getSnapshot = (): T => source.getSnapshot()\n  return function useSelector<S>(sel: (s: T) => S): S {\n    const snapshot = useSyncExternalStore(subscribe, getSnapshot)\n    const prevSnapshotRef = useRef<T | undefined>(undefined)\n    const prevSelectedRef = useRef<S | undefined>(undefined)\n    if (prevSnapshotRef.current !== snapshot) {\n      prevSnapshotRef.current = snapshot\n      prevSelectedRef.current = sel(snapshot)\n    }\n    return prevSelectedRef.current as S\n  }\n}\n","/**\n * Locale dictionaries for the `dsh-plugin-sidebar-brand-text` namespace.\n *\n * @module @huanlin/dsh-plugin-sidebar-brand-text/client/locales\n */\n\n/** The locale keys the settings card reads. */\nexport type BrandTextKey =\n  | 'card.title'\n  | 'card.intro'\n  | 'card.unsaved'\n  | 'card.saved'\n  | 'card.saving'\n  | 'card.discard'\n  | 'card.save'\n  | 'card.unavailable'\n  | 'card.retry'\n  | 'field.name.label'\n  | 'field.name.placeholder'\n  | 'field.name.hint'\n  | 'field.revision.label'\n  | 'field.revision.placeholder'\n  | 'field.revision.hint'\n\n/** The locale namespace name; matches the `locale: NS` passed at slot register. */\nexport const NS = 'dsh-plugin-sidebar-brand-text'\n\n/** English dictionary. */\nexport const en: Record<BrandTextKey, string> = {\n  'card.title': 'Sidebar Brand Text',\n  'card.intro': 'Replace the sidebar brand name and revision badge with custom text.',\n  'card.unsaved': 'Unsaved',\n  'card.saved': 'Saved',\n  'card.saving': 'Saving…',\n  'card.discard': 'Discard',\n  'card.save': 'Save',\n  'card.unavailable': 'The sidebar-brand-text configuration channel is unavailable. Please retry later.',\n  'card.retry': 'Retry',\n  'field.name.label': 'Brand name',\n  'field.name.placeholder': 'DSH Local Build',\n  'field.name.hint': 'Text shown in the sidebar next to the logo. Replaces the default \"DSH Local Build\".',\n  'field.revision.label': 'Revision badge',\n  'field.revision.placeholder': 'e.g. v1.0.0 or abc1234',\n  'field.revision.hint': 'Small badge text beside the brand name. Leave empty to hide the badge.',\n}\n\n/** Chinese dictionary. */\nexport const zh: Record<BrandTextKey, string> = {\n  'card.title': '侧边栏品牌文案',\n  'card.intro': '替换侧边栏左上角的品牌名与构建徽标文案。',\n  'card.unsaved': '未保存',\n  'card.saved': '已保存',\n  'card.saving': '保存中…',\n  'card.discard': '放弃',\n  'card.save': '保存',\n  'card.unavailable': '侧边栏品牌文案配置通道不可用，请稍后重试。',\n  'card.retry': '重试',\n  'field.name.label': '品牌名称',\n  'field.name.placeholder': 'DSH Local Build',\n  'field.name.hint': '侧边栏 logo 右侧显示的文案。替换默认的「DSH Local Build」。',\n  'field.revision.label': '版本徽标',\n  'field.revision.placeholder': '如 v1.0.0 或 abc1234',\n  'field.revision.hint': '品牌名右侧的小徽标文案。留空则不显示徽标。',\n}\n","/**\n * One scoped stylesheet injected for the lifetime of the client activation.\n *\n * The shell's `sidebar.brand.name` fallback renders two CSS-Module-hashed\n * spans (`.fallbackBrandName` + `.buildRevision`); those class names are\n * not stable across builds and not addressable from outside the sidebar\n * package. This plugin ships its own class names with the same visual\n * intent, all colors and typography drawn from the shared `--dsw-*`\n * tokens (never literals) so the badge tracks the active theme.\n *\n * The parent `.brandName` span (inline-flex, gap: 6px, font-size: 18px,\n * font-weight: 600) is owned by the sidebar shell and wraps whatever the\n * slot occupant returns, so this stylesheet only needs to style the two\n * child spans.\n */\nexport const CSS = `\n.sbbt-brand-name {\n  font-size: 17px;\n  letter-spacing: 0px;\n  white-space: nowrap;\n}\n\n.sbbt-build-revision {\n  display: inline-flex;\n  align-items: center;\n  height: 16px;\n  padding: 0 4px;\n  border-radius: 3px;\n  color: var(--dsw-alias-label-primary-inverted);\n  background: var(--dsw-alias-label-primary);\n  font-family: var(--ds-font-family-code);\n  font-size: 8px;\n  font-weight: 500;\n  line-height: 16px;\n}\n`\n\n/**\n * Install the stylesheet and return its disposer.\n * @returns a cleanup function that removes the injected `<style>` tag.\n */\nexport function installStyles(): () => void {\n  if (typeof document === 'undefined') return () => {}\n  const style = document.createElement('style')\n  style.setAttribute('data-sidebar-brand-text-style', '')\n  style.textContent = CSS\n  document.head.appendChild(style)\n  return () => { style.remove() }\n}\n","/**\n * sidebar-brand-text — browser half.\n *\n * Two registrations:\n *   - `settings.plugin.item` keyed slot (key `sidebar-brand-text`) — a card\n *     in the Plugin Config page with two text inputs (name + revision).\n *     Reads/writes through the `/sbbt/api` HTTP route via the shared\n *     `BrandTextSettingsController`.\n *   - `sidebar.brand.name` single slot — renders the configured brand name\n *     text and optional revision badge. Reads from the same controller\n *     store via `useSnapshot`, so a save in the card is instantly\n *     reflected in the sidebar.\n *\n * The mark slot (`sidebar.brand.mark`) is deliberately NOT registered:\n * the fish logo stays in place unless another plugin (e.g.\n * `ui-brand-official`) replaces it.\n *\n * @module @huanlin/dsh-plugin-sidebar-brand-text/client\n */\n\nimport type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'\nimport type {} from '@deepseek-ai/dsh-client-locale/client'\nimport type {} from '@deepseek-ai/dsh-client-ui-slots'\nimport type {} from '@deepseek-ai/dsh-client-ui-sidebar/client'\nimport type {} from '@deepseek-ai/dsh-client-ui-settings-plugins/client'\nimport { BrandText, type BrandTextInjected } from './BrandText.tsx'\nimport { BrandTextCard, type BrandTextCardInjected } from './BrandTextCard.tsx'\nimport { BrandTextSettingsController } from './controller.ts'\nimport { bindSnapshotSelector } from './bindSnapshotSelector.ts'\nimport { en, NS, zh, type BrandTextKey } from './locales.ts'\nimport { installStyles } from './styles.ts'\n\ndeclare module '@deepseek-ai/dsh-client-ui-slots' {\n  interface LocaleNamespaceMap {\n    /** The settings card labels. */\n    'dsh-plugin-sidebar-brand-text': BrandTextKey\n  }\n}\n\n/** Required services: slots + locale. */\nexport const inject = ['slots', 'locale']\n\n/**\n * Client plugin body: register the brand-name slot occupant, the settings\n * card, the locale dictionary, and the stylesheet.\n *\n * A single `BrandTextSettingsController` is shared between the card and\n * the brand text so a save is instantly reflected in the sidebar.\n * @param ctx - client root context.\n */\nexport function apply(ctx: ClientContext): void {\n  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'sidebar-brand-text: dictionaries')\n  ctx.effect(installStyles, 'sidebar-brand-text: styles')\n\n  const controller = new BrandTextSettingsController()\n  const useSnapshot = bindSnapshotSelector(controller.store)\n\n  void controller.load()\n\n  const brandInjected = (): BrandTextInjected => ({ useSnapshot })\n  ctx.slots.inject('sidebar.brand.name', () =>\n    ctx.slots.register(\n      {\n        name: 'sidebar.brand.name',\n        inject: brandInjected,\n      },\n      BrandText,\n    ),\n  )\n\n  const cardInjected = (): BrandTextCardInjected => ({ controller, useSnapshot })\n  ctx.slots.inject('settings.plugin.item', function* () {\n    yield ctx.slots.register(\n      {\n        name: 'settings.plugin.item',\n        key: 'sidebar-brand-text',\n        locale: NS,\n        inject: cardInjected,\n      },\n      BrandTextCard,\n    )\n  })\n}\n"],"mappings":"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"}

package/lib/index.js

@@ -0,0 +1,235 @@
+import z from "@deepseek-ai/schemastery";
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+
+//#region src/config.ts
+/** Schemastery schema for the composition entry and the settings namespace. */
+const Config = z.object({
+	name: z.string().default("DSH Local Build").description("Brand name text shown in the sidebar next to the logo."),
+	revision: z.string().default("").description("Revision badge text shown beside the brand name. Empty string hides the badge.")
+});
+/**
+* Resolve a raw config object into a complete {@link BrandTextConfig}.
+*
+* Unknown keys are dropped; missing or wrong-typed keys fall back to
+* the defaults. This runs on every gateway read so the client always
+* sees a well-formed value.
+* @param config - raw config (entry source or settings layer).
+* @returns the resolved config with defaults applied.
+*/
+function resolveConfig(config = {}) {
+	return {
+		name: typeof config.name === "string" ? config.name : DEFAULT.name,
+		revision: typeof config.revision === "string" ? config.revision : DEFAULT.revision
+	};
+}
+/** Defaults used when no config arrives (defensive only). */
+const DEFAULT = {
+	name: "DSH Local Build",
+	revision: ""
+};
+
+//#endregion
+//#region src/settings.ts
+/** Settings namespace under which brand-text config persists. */
+const SETTINGS_NAMESPACE = settingsNamespace("sidebar-brand-text");
+/**
+* Mirror of the dsh-settings internal `isUnloading` guard. The cordis const
+* enum for fiber state is erased at compile time, so the literal states are
+* matched numerically: 4 = DISPOSED, 5 = UNLOADING.
+*/
+function isUnloading(ctx) {
+	const state = ctx.fiber?.state;
+	return state === 4 || state === 5;
+}
+/**
+* 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.
+*/
+function installBrandTextSettings(ctx, entry) {
+	const listeners = /* @__PURE__ */ new Set();
+	let source = () => entry;
+	const notify = () => {
+		for (const listener of [...listeners]) listener();
+	};
+	ctx.inject(["settings"], (sctx) => {
+		let scope;
+		try {
+			scope = sctx.settings.register(SETTINGS_NAMESPACE, Config, { base: entry });
+		} catch (error) {
+			if (!(error instanceof Error) || !error.message.includes("already registered")) throw error;
+			ctx.logger("sidebar-brand-text")?.debug("settings namespace already registered — entry-source fallback");
+			return;
+		}
+		source = () => scope.get();
+		sctx.effect(() => () => {
+			if (isUnloading(ctx)) return;
+			source = () => entry;
+			notify();
+		});
+		notify();
+		scope.watch(() => {
+			if (isUnloading(ctx)) return;
+			notify();
+		});
+	});
+	return {
+		source: () => source(),
+		onChange: (cb) => {
+			listeners.add(cb);
+			return () => {
+				listeners.delete(cb);
+			};
+		}
+	};
+}
+
+//#endregion
+//#region src/gateway.ts
+/** HTTP route prefix owning every sidebar-brand-text API request. */
+const API_PREFIX = "/sbbt/api";
+/** Config keys the `set` endpoint accepts (allow-list; unknown keys are dropped). */
+const ALLOWED_KEYS = new Set(["name", "revision"]);
+/**
+* Register the `/sbbt/api` HTTP route on the host's web server.
+*
+* @param ctx - host context carrying `webServer`.
+* @param bridge - the settings bridge the route reads through.
+*/
+function registerBrandTextGateway(ctx, bridge) {
+	let settings;
+	ctx.inject(["settings"], (sctx) => {
+		settings = sctx.settings;
+		return () => {
+			settings = void 0;
+		};
+	});
+	ctx.effect(() => {
+		const webServer = ctx.webServer;
+		if (!webServer || typeof webServer.register !== "function") return () => {};
+		return webServer.register({
+			kind: "prefix",
+			path: API_PREFIX,
+			handler: async (req, res) => {
+				if ((req.method ?? "") !== "POST") {
+					writeJson(res, 405, envelopeError("method-not-allowed", "POST only"));
+					return;
+				}
+				const origin = req.headers.origin;
+				if (typeof origin === "string" && origin) {
+					let originHost;
+					try {
+						originHost = new URL(origin).host;
+					} catch {
+						writeJson(res, 400, envelopeError("invalid-origin", "invalid Origin header"));
+						return;
+					}
+					const reqHost = req.headers.host;
+					if (typeof reqHost === "string" && originHost !== reqHost) {
+						writeJson(res, 403, envelopeError("origin-not-allowed", "same-origin requests only"));
+						return;
+					}
+				}
+				if (!String(req.headers["content-type"] ?? "").toLowerCase().startsWith("application/json")) {
+					writeJson(res, 415, envelopeError("content-type-not-supported", "application/json required"));
+					return;
+				}
+				const pathname = new URL(req.url ?? "/", "http://dsh.internal").pathname;
+				const method = pathname.startsWith(`${API_PREFIX}/`) ? pathname.slice(`${API_PREFIX}/`.length) : void 0;
+				if (method === void 0 || method.includes("/")) {
+					writeJson(res, 404, envelopeError("not-found", "unknown sidebar-brand-text API method"));
+					return;
+				}
+				try {
+					const body = await readJsonBody(req);
+					if (method === "get") writeJson(res, 200, envelopeOk({ config: resolveConfig(bridge.source()) }));
+					else if (method === "set") writeJson(res, 200, envelopeOk(await handleSet(body, settings, bridge)));
+					else writeJson(res, 404, envelopeError("not-found", `unknown sidebar-brand-text API method "${method}"`));
+				} catch (error) {
+					writeJson(res, 500, envelopeError("internal", error instanceof Error ? error.message : String(error)));
+				}
+			}
+		});
+	}, "sidebar-brand-text: /sbbt/api routes");
+}
+/** Handle the `set` method: validate patch, write user layer, return resolved config. */
+async function handleSet(body, settings, bridge) {
+	const patch = extractPatch(body);
+	if (Object.keys(patch).length === 0) return { config: resolveConfig(bridge.source()) };
+	if (settings === void 0) throw new Error("sidebar-brand-text: settings service is unavailable — configuration cannot be written");
+	await settings.update(SETTINGS_NAMESPACE, patch);
+	return { config: resolveConfig(bridge.source()) };
+}
+/** Extract and validate the patch from the request body. */
+function extractPatch(body) {
+	if (typeof body !== "object" || body === null) return {};
+	const raw = Reflect.get(body, "patch");
+	if (typeof raw !== "object" || raw === null) return {};
+	const normalized = {};
+	for (const [key, value] of Object.entries(raw)) {
+		if (!ALLOWED_KEYS.has(key)) continue;
+		if (value === null || value === void 0) continue;
+		if (typeof value === "string") {
+			if (key === "name") normalized.name = value;
+			else if (key === "revision") normalized.revision = value;
+		}
+	}
+	return normalized;
+}
+/** Read and parse a JSON body from a node:http request. */
+async function readJsonBody(req, maxBytes = 8192) {
+	const chunks = [];
+	let bytes = 0;
+	for await (const chunk of req) {
+		const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+		bytes += buffer.length;
+		if (bytes > maxBytes) throw new Error("request body too large");
+		chunks.push(buffer);
+	}
+	const text = Buffer.concat(chunks).toString("utf8");
+	if (text === "") return {};
+	return JSON.parse(text);
+}
+/** Write a JSON response envelope. */
+function writeJson(res, status, body) {
+	const json = JSON.stringify(body);
+	res.writeHead(status, { "content-type": "application/json" });
+	res.end(json);
+}
+/** Build a success envelope. */
+function envelopeOk(value) {
+	return {
+		ok: true,
+		value
+	};
+}
+/** Build an error envelope. */
+function envelopeError(code, message) {
+	return {
+		ok: false,
+		error: {
+			code,
+			message
+		}
+	};
+}
+
+//#endregion
+//#region src/index.ts
+const name = "sidebar-brand-text";
+/** `webServer` is required for the HTTP gateway that backs the settings card. */
+const inject = ["webServer"];
+/**
+* Plugin body: install the settings bridge and register the HTTP gateway.
+*
+* @param ctx - host context carrying `webServer`.
+* @param config - resolved config (seed values).
+*/
+function apply(ctx, config) {
+	registerBrandTextGateway(ctx, installBrandTextSettings(ctx, resolveConfig(config)));
+}
+
+//#endregion
+export { Config, apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,21 @@
+//#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/client/BrandText.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The `sidebar.brand.name` slot occupant — renders the configured brand
+ * name text and optional revision badge.
+ *
+ * Reads from the shared `BrandTextSettingsController` store via
+ * `useSnapshot`, so a save in the settings card is instantly reflected
+ * here without a DOM event or RPC re-fetch.
+ *
+ * Replaces the shell's fallback (`DSH Local Build` + 7-character
+ * `DSH_CLIENT_COMMIT_HASH` badge). The mark slot (`sidebar.brand.mark`)
+ * is untouched: the fish logo stays unless another plugin (e.g.
+ * `ui-brand-official`) replaces it.
+ *
+ * @module @huanlin/dsh-plugin-sidebar-brand-text/client/BrandText
+ */
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { BrandTextConfig } from '../types.ts';
+/** Inject face: the selector hook bound to the shared controller store. */
+export interface BrandTextInjected {
+    readonly useSnapshot: SnapshotSelectorHook<BrandTextStateShell>;
+}
+/** The slice of state the brand component reads. */
+export interface BrandTextStateShell {
+    draft: BrandTextConfig;
+    available: boolean;
+}
+/** Full props: the slot's runtime share plus the plugin's inject face. */
+export type BrandTextProps = PropsRuntime<'sidebar.brand.name'> & BrandTextInjected;
+/**
+ * Render the configured brand name and optional revision badge.
+ *
+ * While loading or on error, falls back to the shell defaults.
+ * @param props - the `useSnapshot` inject face (plus the slot's runtime share, unused).
+ * @returns the brand-name span and optional revision-badge span.
+ */
+export declare function BrandText({ useSnapshot }: BrandTextProps): import("react").JSX.Element;

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

@@ -0,0 +1,22 @@
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { BrandTextState } from './controller.ts';
+/** Inject face: controller + selector hook. */
+export interface BrandTextCardInjected {
+    readonly controller: {
+        readonly load: () => Promise<void>;
+        readonly edit: (field: 'name' | 'revision', value: string) => void;
+        readonly discard: () => void;
+        readonly save: () => Promise<void>;
+        readonly toggle: () => void;
+    };
+    readonly useSnapshot: SnapshotSelectorHook<BrandTextState>;
+}
+/** Full props: locale seat + inject. */
+export type BrandTextCardProps = PropsLocale<'dsh-plugin-sidebar-brand-text'> & BrandTextCardInjected;
+/**
+ * Render the sidebar-brand-text settings card.
+ * @param props - locale + controller/useSnapshot inject.
+ * @returns a `<li>` card element.
+ */
+export declare function BrandTextCard({ t, controller, useSnapshot }: BrandTextCardProps): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { HostObservable, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+/**
+ * Bind a React selector hook to a {@link HostObservable} snapshot source.
+ * @param source - the observable snapshot store.
+ * @returns a `useSelector(sel, eq?)` hook.
+ */
+export declare function bindSnapshotSelector<T>(source: HostObservable<T>): SnapshotSelectorHook<T>;

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

@@ -0,0 +1,66 @@
+/**
+ * `BrandTextSettingsController` — client-side state store for the
+ * sidebar-brand-text config.
+ *
+ * Loads the config from the host's `/sbbt/api/get` route, stages edits,
+ * and saves via `/sbbt/api/set`. The `sidebar.brand.name` slot occupant
+ * and the `settings.plugin.item` card both read from the same store via
+ * `bindSnapshotSelector`, so a save is instantly reflected in the sidebar
+ * without a DOM event or page reload.
+ *
+ * Mirrors the ego-browser `EgoBrowserSettingsController` pattern.
+ *
+ * @module @huanlin/dsh-plugin-sidebar-brand-text/client/controller
+ */
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import { type BrandTextConfig } from '../types.ts';
+/** The controller's snapshot state. */
+export interface BrandTextState {
+    /** 'idle' | 'loading' | 'ready' */
+    status: 'idle' | 'loading' | 'ready';
+    /** True after a successful `/sbbt/api/get`; false when the route is unreachable. */
+    available: boolean;
+    /** False when the settings service is absent (read-only). */
+    writable: boolean;
+    /** Current draft values (edited by the card, read by the brand slot). */
+    draft: BrandTextConfig;
+    /** True when the draft differs from the last-saved config. */
+    dirty: boolean;
+    /** Apply lifecycle: 'idle' | 'saving' | 'saved' | 'error'. */
+    applyState: {
+        kind: 'idle';
+    } | {
+        kind: 'saving';
+    } | {
+        kind: 'saved';
+    } | {
+        kind: 'error';
+        message: string;
+    };
+    /** Card expand state (toggled by the card header button). */
+    _open: boolean;
+}
+/**
+ * Controller managing the brand-text config lifecycle.
+ *
+ * Constructed once in the client `apply()` and shared between the
+ * `sidebar.brand.name` slot and the `settings.plugin.item` card.
+ */
+export declare class BrandTextSettingsController {
+    readonly store: SnapshotStore<BrandTextState>;
+    loaded: boolean;
+    private generation;
+    constructor();
+    /** Fetch the config from `/sbbt/api/get` and update the store. */
+    load(): Promise<void>;
+    /** Stage an edit to a field (does not save). */
+    edit(field: 'name' | 'revision', value: string): void;
+    /** Discard staged edits and reload from the host. */
+    discard(): void;
+    /** Save the staged draft via `/sbbt/api/set`. */
+    save(): Promise<void>;
+    /** Toggle the card's expand state (mirrors ego-browser `controller.toggle()`). */
+    toggle(): void;
+    /** Mark the store as unavailable (route unreachable or settings service absent). */
+    private markUnavailable;
+}

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

@@ -0,0 +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. */
+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/locales.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Locale dictionaries for the `dsh-plugin-sidebar-brand-text` namespace.
+ *
+ * @module @huanlin/dsh-plugin-sidebar-brand-text/client/locales
+ */
+/** The locale keys the settings card reads. */
+export type BrandTextKey = 'card.title' | 'card.intro' | 'card.unsaved' | 'card.saved' | 'card.saving' | 'card.discard' | 'card.save' | 'card.unavailable' | 'card.retry' | 'field.name.label' | 'field.name.placeholder' | 'field.name.hint' | 'field.revision.label' | 'field.revision.placeholder' | 'field.revision.hint';
+/** The locale namespace name; matches the `locale: NS` passed at slot register. */
+export declare const NS = "dsh-plugin-sidebar-brand-text";
+/** English dictionary. */
+export declare const en: Record<BrandTextKey, string>;
+/** Chinese dictionary. */
+export declare const zh: Record<BrandTextKey, string>;

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

@@ -0,0 +1,21 @@
+/**
+ * One scoped stylesheet injected for the lifetime of the client activation.
+ *
+ * The shell's `sidebar.brand.name` fallback renders two CSS-Module-hashed
+ * spans (`.fallbackBrandName` + `.buildRevision`); those class names are
+ * not stable across builds and not addressable from outside the sidebar
+ * package. This plugin ships its own class names with the same visual
+ * intent, all colors and typography drawn from the shared `--dsw-*`
+ * tokens (never literals) so the badge tracks the active theme.
+ *
+ * The parent `.brandName` span (inline-flex, gap: 6px, font-size: 18px,
+ * font-weight: 600) is owned by the sidebar shell and wraps whatever the
+ * slot occupant returns, so this stylesheet only needs to style the two
+ * child spans.
+ */
+export declare const CSS = "\n.sbbt-brand-name {\n  font-size: 17px;\n  letter-spacing: 0px;\n  white-space: nowrap;\n}\n\n.sbbt-build-revision {\n  display: inline-flex;\n  align-items: center;\n  height: 16px;\n  padding: 0 4px;\n  border-radius: 3px;\n  color: var(--dsw-alias-label-primary-inverted);\n  background: var(--dsw-alias-label-primary);\n  font-family: var(--ds-font-family-code);\n  font-size: 8px;\n  font-weight: 500;\n  line-height: 16px;\n}\n";
+/**
+ * Install the stylesheet and return its disposer.
+ * @returns a cleanup function that removes the injected `<style>` tag.
+ */
+export declare function installStyles(): () => void;

package/lib/types/config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Schemastery schema + resolver for the `sidebar-brand-text` config.
+ *
+ * The composition `Config` (cordis.patch.yml seed) and the settings namespace
+ * schema share the same shape: `name` (brand text) + `revision` (badge text,
+ * empty = hidden). `resolveConfig` applies defaults so a partially-populated
+ * entry or settings layer still yields a complete value.
+ *
+ * @module @huanlin/dsh-plugin-sidebar-brand-text/config
+ */
+import z from '@deepseek-ai/schemastery';
+import type { BrandTextConfig } from './types.ts';
+/** Schemastery schema for the composition entry and the settings namespace. */
+export declare const Config: z<BrandTextConfig>;
+/**
+ * Resolve a raw config object into a complete {@link BrandTextConfig}.
+ *
+ * Unknown keys are dropped; missing or wrong-typed keys fall back to
+ * the defaults. This runs on every gateway read so the client always
+ * sees a well-formed value.
+ * @param config - raw config (entry source or settings layer).
+ * @returns the resolved config with defaults applied.
+ */
+export declare function resolveConfig(config?: Record<string, unknown>): BrandTextConfig;

package/lib/types/gateway.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Host-side HTTP gateway exposing the `sidebar-brand-text` config to the
+ * browser through a self-hosted `/sbbt/api` route.
+ *
+ * Mirrors the ego-browser / better-sidebar / dsh-plugin-interpreters pattern:
+ * `ctx.webServer.register` claims a prefix route, the handler reads/writes
+ * the settings seam in-process (no wire-layer allowlist gate), and the
+ * browser reaches it through `fetch('/sbbt/api/<method>')`.
+ *
+ * Route shape:
+ *   POST /sbbt/api/get  → { ok: true, value: { config } }
+ *   POST /sbbt/api/set  body: { patch: { name?, revision? } }
+ *                        → { ok: true, value: { config } }
+ * Errors carry { ok: false, error: { code, message } }.
+ *
+ * @module @huanlin/dsh-plugin-sidebar-brand-text/gateway
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type BrandTextSettingsBridge } from './settings.ts';
+import type { BrandTextConfig } from './types.ts';
+/** Wire shape for `get` / `set` responses. */
+export interface BrandTextGatewayResponse {
+    config: BrandTextConfig;
+}
+/**
+ * Register the `/sbbt/api` HTTP route on the host's web server.
+ *
+ * @param ctx - host context carrying `webServer`.
+ * @param bridge - the settings bridge the route reads through.
+ */
+export declare function registerBrandTextGateway(ctx: Context, bridge: BrandTextSettingsBridge): void;

package/lib/types/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * sidebar-brand-text — host plugin entry.
+ *
+ * Registers a `sidebar-brand-text` settings namespace (persisted to
+ * `$DSH_HOME/settings.yaml`) and a self-hosted `/sbbt/api` HTTP route
+ * (`get` / `set`). The browser half's settings card reads/writes the
+ * brand name and revision badge through this route; the browser half's
+ * `sidebar.brand.name` slot occupant reads the same values from the
+ * shared `BrandTextSettingsController` store.
+ *
+ * The cordis.yml `config` block is the composition `base` (first-boot
+ * seed); user edits live in settings.yaml under the `sidebar-brand-text`
+ * namespace and take effect on the next gateway read — no restart needed.
+ *
+ * @module @huanlin/dsh-plugin-sidebar-brand-text
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { Config } from './config.ts';
+import type { BrandTextConfig } from './types.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[];
+export type { BrandTextConfig } from './types.ts';
+/** Re-export the schemastery schema for cordis's composition loader. */
+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).
+ */
+export declare function apply(ctx: Context, config: BrandTextConfig): void;