@lynn123411/dsh-chat-translate 3.1.0 → 3.3.0

package/lib/types/client/chat/assistant-step.d.ts

@@ -7,9 +7,12 @@
  *    markdown 交给宿主公开基线组件 `MarkdownText` 重渲染：格式保真由官方
  *    渲染器负责，本文件不产生任何自拼 markup。
  * 2. 「已翻译/没译成」是渲染状态：落定、开关开启、进入视口后逐行首跑；成功
- *    的块（包括模型认为原样最好的块）挂译文、左缘蓝线、点击在译文与原文间
- *    切换；失败的块保持原文、左缘挂红实线（悬停报出败因），整块可点=手动
- *    整行补跑，无限次、无自动重试；已登记在途而尚无结果的块显灰脉动。
+ *    的块（包括模型认为原样最好的块）挂译文、左缘蓝线；失败的块保持原文、
+ *    左缘挂红实线；已登记在途而尚无结果的块显灰脉动。
+ * 3. 切换与补跑都在**左缘热区**上，不在正文上：正文整块可点会让「选中一段
+ *    文字复制」与「切换译文/原文」抢同一次点击；热区收成贴着那条线的窄带后，
+ *    正文的单击落字、拖选复制都不再误触。失败块的 ↻ 常驻在红线旁，点它整行
+ *    补跑，无限次、无自动重试。
  *
  * 除正文外的行内容与宿主逐分支等价：reasoning 行走折叠（含 Turn-process
  * 隐藏与 beforematch 揭示）、连续 image 组交回 owner 的 renderMessageImages、

package/lib/types/client/chat/click-guard.d.ts

@@ -1,15 +1,16 @@
 /**
- * 已翻译块的点击守卫：切换只认「落在块空白正文上的裸点击」。
+ * 左缘热区的点击判定：只有「按下与松手都落在热区上」的干净点击才切换/补跑。
  *
- * 块内含链接、代码块复制钮等交互元素——它们的点击归自己，不连带切块；
- * 拖选译文松手产生的 click 同样忽略。纯 DOM 判定，不依赖 React，可独立测试。
+ * 热区没有子元素，所以浏览器派发过来的 click 若 `target === currentTarget`，
+ * 就说明按下与松手都在热区里；反之（在热区按下、往右拖进正文选字再松手）click
+ * 会派发给两者的公共祖先，target 不是热区，天然判为拖选。这不是启发式，是
+ * click 事件的分派语义——正文整块不再是点击目标，误触从根上消失。
+ * 纯 DOM 判定，不依赖 React，可独立测试。
  */
 interface MinimalPointerEvent {
     /** 点击命中的最深元素。 */
-    target: {
-        closest?(selector: string): unknown;
-    } | null;
-    /** 挂了本守卫的已翻译块容器。 */
+    target: unknown;
+    /** 挂了本守卫的热区元素本身。 */
     currentTarget: unknown;
 }
 interface MinimalWindow {
@@ -21,7 +22,7 @@ interface MinimalWindow {
 /**
  * @param event - click 事件（结构面：target/currentTarget）。
  * @param view - 可注入的 window（测试传假对象；运行时传全局 window）。
- * @returns 该点击是否应当触发原文/译文切换。
+ * @returns 该点击是否应当触发切换/补跑。
  */
-export declare function isBareBlockClick(event: MinimalPointerEvent, view: MinimalWindow | undefined): boolean;
+export declare function isCleanHotspotClick(event: MinimalPointerEvent, view: MinimalWindow | undefined): boolean;
 export {};

package/lib/types/client/chat/row-plan.d.ts

@@ -36,7 +36,7 @@ export type RowPlanEntry =
     text: string;
 }
 /**
- * 正文块：mark 即左缘线状态（可点性、重试指引、脉动全由它决定）；
+ * 正文块：mark 即左缘线状态（线型、脉动、热区动作全由它决定）；
  * translated 仅在成功时非 null，供 mark==='translated' 时换源文本渲染；
  * fail 仅在 mark==='failed' 时非 null——服务端的技术一句，Tooltip 悬停
  * 报因用，缺省时只报「翻译失败」。线型不从这里出：失败一律同一条红实线。
@@ -83,7 +83,8 @@ export interface RowPlanInput {
     outcomes?: readonly (BlockOutcome | null)[];
     /** 池里这行的状态：pending 时未落定的块显灰脉动，未登记什么都不显。 */
     rowStatus?: 'pending' | 'settled';
-    /** 用户点了「读原文」的正文块（按条目 key）：把译文态折成 original-view。 */
+    /** 用户点了「读原文」的正文块（按条目 key）：把译文态折成 original-view。
+     *  触发它的是左缘热区上的切换，不是点正文。 */
     originalKeys?: ReadonlySet<number>;
 }
 export declare function planAssistantRow(input: RowPlanInput): RowPlan;

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

@@ -1,13 +1,17 @@
 /**
  * 助手行接管所需的样式：与宿主 `AssistantMarkdown` / `ReasoningRow` 逐条对齐
  * 的等价规则（字号、行距、gap、粘性折叠头、running 微光、summary 遮罩等），
- * 加上本插件唯一新增的视觉词汇——正文块左缘的线：
+ * 加上本插件唯一新增的视觉词汇——正文块左缘的线与贴着它的那条热区：
  * 蓝粗线（1px 主色）=正在读译文；灰细线（0.5px 中性）=有译文但正在读原文
  * （再点即切回）；红实线（1px error 色）=翻译失败（通道伤：超时、断流、空
- * 返回），悬停报出细节，点它整行补跑；灰脉动=整行在途、这块尚无结果；
- * 无线=没送过模型（含空白块）或开关关闭。
+ * 返回）；灰脉动=整行在途、这块尚无结果；无线=没送过模型（含空白块）或开关关闭。
  * 译文的结构漂移不再挂红线——由宿主按原文修回、重掷或照收，红线只剩通道伤一种。
  *
+ * 点击不落在正文上：`dsh-ct-hotspot` 是贴着左缘线的窄热区（线左侧 4px + 线
+ * 右侧那 12px 缩进，随块高铺满），切换与补跑都由它承载，正文只做选中/复制。
+ * 悬停不改任何视觉——只有鼠标在热区上变手型；键盘聚焦（且仅键盘聚焦）时线
+ * 加亮，粗细始终只表示译文/原文。失败块的 ↻ 常驻在红线旁，是补跑的可见入口。
+ *
  * 全部颜色与尺寸走 `--dsw-alias-*` / `--dsh-*` 主题别名，中性平边按官方规则
  * 画 0.5px hairline；动画声明尊重 `prefers-reduced-motion`。样式随 bundle 注入
  * 一次（`<style data-plugin-css>`），类名用固定前缀，不依赖宿主哈希类名。
@@ -19,10 +23,42 @@ export declare const ASSISTANT_CSS: string;
  * 失败只有 `failed` 一种：同一条红实线，败因走悬停文案。
  */
 export type ProseMark = 'translated' | 'original-view' | 'failed' | 'inflight' | null;
-/** mark → 点击动作单点：切换、重试、不可点三选一（渲染层照此接线）。 */
+/** mark → 热区动作单点：切换、重试、没有热区三选一（渲染层照此接线）。 */
 export type ProseAction = 'toggle' | 'retry' | null;
+/**
+ * mark → 正文块类名与热区动作的单点表。
+ *
+ * 一张表而不是两个并列 switch：线型（类名）与可点性（动作）从同一行读出来，
+ * 加一种 mark 时不可能只改一处、留下「有线但点不动」或「可点但没有线」的
+ * 半截状态。`action` 为 null 表示没有热区——没线的块（没送过模型、开关关闭、
+ * 通道没配好、空白块）没有可切换的东西。
+ */
+interface ProsePresentation {
+    /** 正文块的状态类名；null 的块只有基础类。 */
+    className: string | null;
+    /** 热区动作：切换、补跑、或没有热区。 */
+    action: ProseAction;
+}
+/** 每个正文块都挂的基础类：定位父级（热区以它为基准绝对定位）。 */
+export declare const PROSE_BASE_CLASS = "dsh-ct-prose";
+export declare function prosePresentation(mark: ProseMark): ProsePresentation;
+/** mark → 热区动作（{@link prosePresentation} 的窄读法，测试与渲染层共用）。 */
 export declare function proseAction(mark: ProseMark): ProseAction;
-/** mark → 类名单点：可点态共用 padding 与光标，线型之间切换不跳字。 */
+/**
+ * mark → 正文块类名单点：只有线型。点击不在这层——正文整块不可点，切换与
+ * 补跑由左缘热区（{@link HOTSPOT_CLASS}）承载，所以这里不再有可点态/光标类。
+ */
 export declare function proseClassNames(mark: ProseMark): string | undefined;
+/**
+ * 缩进单点：能翻译（开关开 + 通道齐备）时所有正文块一律左缩进，与「这块是否
+ * 已挂线」无关——译文落定的那一刻正文不右移，块与块左缘也对齐；关掉开关或
+ * 通道没配好时不缩进，排版回到宿主原样（此时正文会横移一次，是刻意的取舍）。
+ */
+export declare function proseIndentClassName(canTranslate: boolean): string | undefined;
+/** 左缘热区的类名单点：切换/补跑的唯一点击目标。 */
+export declare const HOTSPOT_CLASS = "dsh-ct-hotspot";
+/** 在途热区：仍在，但按下去是空操作，光标不再变手型。 */
+export declare const HOTSPOT_IDLE_ATTR = "data-idle";
 /** 注入接管样式；重复调用是空操作。 */
 export declare function ensureAssistantStyles(): void;
+export {};

package/lib/types/client/chat/translate-store.d.ts

@@ -57,7 +57,7 @@ export declare class ChatTranslateStore {
     getState(rowKey: string): RowState | undefined;
     /**
      * 确保该行按当前文本被翻译。
-     * @param manual - 用户点击失败块发起的补跑：已落定的同代行只有这条路会重发。
+     * @param manual - 用户点击失败块的左缘热区发起的补跑：已落定的同代行只有这条路会重发。
      * @returns 是否发出了新的请求。
      */
     ensure(rowKey: string, texts: readonly string[], manual?: boolean): boolean;

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

@@ -1,16 +1,15 @@
 /** Client plugin name, shared with the browser bundle id. */
 export declare const name = "dsh-chat-translate";
 /**
- * Declared services: slots for the keyed assistant-row takeover, the shared
- * 「阅读体验」 settings page (page claim plus the card registration) and the
- * composer dock pill; configForms for this plugin's own configuration form
- * plus the host `ui-chat` entry whose `transcriptView` field drives the
- * reasoning-row presentation policy; the remote + remote.credentials pair for
- * the credentials Remote namespace; and locale for the card's own dictionary.
- * The runtime withholds any service not declared here; `locale` is declared
- * rather than sampled because `ctx.get('locale')` at apply time can beat the
- * locale plugin's `provide`, which silently left the card's dictionary
- * unregistered.
+ * Declared services: slots for the keyed assistant-row takeover, this plugin's
+ * configuration page on the **Plugins** page, and the composer dock pill;
+ * configForms for this plugin's own configuration form plus the host `ui-chat`
+ * entry whose `transcriptView` field drives the reasoning-row presentation
+ * policy; the remote + remote.credentials pair for the credentials Remote
+ * namespace; and locale for the card's own dictionary. The runtime withholds
+ * any service not declared here; `locale` is declared rather than sampled
+ * because `ctx.get('locale')` at apply time can beat the locale plugin's
+ * `provide`, which silently left the card's dictionary unregistered.
  */
 export declare const inject: string[];
 interface ClientContext {
@@ -30,8 +29,8 @@ interface ClientContext {
 }
 /**
  * Mount the assistant-row takeover (keyed `conversation.chat.node` /
- * `assistant-step`), the settings UI card inside the shared reading-settings
- * page, and the translation toggle in the composer dock.
+ * `assistant-step`), this plugin's configuration page on the **Plugins** page,
+ * and the translation toggle in the composer dock.
  * @param ctx - DSH browser client context.
  */
 export declare function apply(ctx: ClientContext): void;

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

@@ -1,4 +1,4 @@
-/** Locale bundles for the chat-translate card inside the shared 「阅读体验」 page. */
+/** Locale bundles for the chat-translate card on the DSH Plugins page. */
 /** Dictionary namespace owned by this plugin's settings card. */
 export declare const NS = "settings.chatTranslate";
 /**
@@ -7,11 +7,9 @@ export declare const NS = "settings.chatTranslate";
  * inline technical samples rendered by `withSamples` at the call site.
  */
 export declare const zh: {
-    readonly pageNav: "阅读体验";
-    readonly title: "正文翻译";
     readonly masterTitle: "翻译总开关";
     readonly enableTranslation: "启用翻译";
-    readonly masterDesc: "自动把助手回答正文翻成中文（如 {example}）：折叠块里的过程正文与最终汇总一视同仁，整段中文的块也照送，由模型一并改写成自然中文、顺掉机器腔。Think 卡与工具调用行不翻，代码块原样保留。正文块的左缘一条竖线报出状态：正在读译文是蓝线，备着译文正读原文是灰细线，没译成是红实线（鼠标悬停报出通道细节——超时、断流或空返回；译文的结构漂移由宿主自动修回或重掷，不再因格式问题挂红线），正在请求是灰脉动线，没送过模型或开关关闭没有线。点击已翻译的块在译文与原文间切换——模型认为原样最好、返回一模一样的文字时同样算翻译过、同样可切；点击挂红线的块则整行重新翻译，已成功的块保持显示不打扰。通道失败不自动重试，恢复后由你的点击救活。译文按原 markdown 格式重新渲染，表格、列表、加粗与行内代码保持结构。回答还在流式输出时不翻，落定后按阅读顺序逐段出中文。只作用于当前查看的会话，译文不写回会话上下文。输入框下方那一行有同款开关，两处状态同步。";
+    readonly masterDesc: "自动把助手回答正文翻成中文（如 {example}）：折叠块里的过程正文与最终汇总一视同仁，整段中文的块也照送，由模型一并改写成自然中文、顺掉机器腔。Think 卡与工具调用行不翻，代码块原样保留。正文块的左缘一条竖线报出状态：正在读译文是蓝线，备着译文正读原文是灰细线，没译成是红实线（鼠标悬停热区报出通道细节——超时、断流或空返回；译文的结构漂移由宿主自动修回或重掷，不再因格式问题挂红线），正在请求是灰脉动线，没送过模型或开关关闭没有线。切换不在正文上：贴着那条线的窄带才是操作区，鼠标移到它上面变手型，点一下在译文与原文间切换——正文整块不再响应点击，选字、拖选复制都不会误触；模型认为原样最好、返回一模一样的文字时同样算翻译过、同样可切。挂红线的块右侧常驻一个小 ↻，点那条窄带即整行重新翻译，已成功的块保持显示不打扰。通道失败不自动重试，恢复后由你点那条窄带救活。译文按原 markdown 格式重新渲染，表格、列表、加粗与行内代码保持结构。回答还在流式输出时不翻，落定后按阅读顺序逐段出中文。只作用于当前查看的会话，译文不写回会话上下文。输入框下方那一行有同款开关，两处状态同步。";
     readonly aiTitle: "AI 翻译（OpenAI 兼容协议）";
     readonly aiRule: "只有这一条通道：Key / Base URL / 模型齐备才会翻译，缺任何一项都保持原文。";
     readonly badgeConfigured: "已配置";
@@ -41,7 +39,10 @@ export declare const zh: {
     readonly dockOn: "正文翻译已开启，点击关闭";
     readonly dockOff: "正文翻译已关闭，点击开启";
     readonly failTitle: "翻译失败";
-    readonly retryAria: "翻译失败，按 Enter 重试";
+    readonly retryAria: "翻译失败，点左缘那条窄带可按 Enter 重试";
+    readonly toggleToOriginalAria: "查看原文";
+    readonly toggleToTranslatedAria: "查看译文";
+    readonly inflightAria: "翻译中，此处暂无动作";
 };
 /** Locale keys this plugin renders. */
 export type ChatTranslateLocaleKey = keyof typeof zh;
@@ -57,6 +58,11 @@ export declare function bindRowCopy(locale: {
 } | null | undefined): void;
 export declare function rowCopy(): {
     retryAria: string;
+    /** 热区动作的读屏标签：读译文时提示可切回原文，反之亦然。 */
+    toggleToOriginalAria: string;
+    toggleToTranslatedAria: string;
+    /** 在途热区的读屏标签：说清此刻按下去没有动作。 */
+    inflightAria: string;
     /** 失败块悬停文案：本地化标签 + 服务端原样带来的技术一句（通道伤）。 */
     failTitle: (detail?: string | null) => string;
 };

package/lib/types/client/settings/plugin-page.d.ts

@@ -0,0 +1,18 @@
+/** The Plugins page slot a bundle's own configuration registers into. */
+export declare const BUNDLE_CONFIG_SLOT = "plugins.bundle.config";
+/** This plugin's own config key: the bundle's package name. */
+export declare const BUNDLE_CONFIG_KEY = "@lynn123411/dsh-chat-translate";
+/** Services this registration needs from the browser runtime. */
+interface PluginPageSlots {
+    inject(name: string, callback: () => unknown): () => void;
+}
+/**
+ * Contribute this plugin's configuration page to the Plugins page.
+ * @param slots - the client slot registry.
+ * @param register - registers the page component; returns its disposer.
+ * @returns A disposer releasing the contribution, or a no-op when the browser
+ * runtime hands no slot registry at all (the plugin's other seats stay mounted
+ * either way). A throwing `inject` is a real contract violation and propagates.
+ */
+export declare function setupPluginPage(slots: PluginPageSlots | null | undefined, register: () => () => void): () => void;
+export {};

package/lib/types/client/settings/ui.d.ts

@@ -2,19 +2,22 @@ import * as React from 'react';
 import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { NS } from '../locales.ts';
 /**
- * Chat-translate's card inside the shared 「阅读体验」 settings page. The card
- * keeps its own chrome (title rows, switches, credential form); the shared page
- * only stacks the participants' cards.
- * @param props - renderer-bound seat of the `reading.settings.item` slot plus
- * the `t` seat its `locale: NS` registration injects.
+ * Chat-translate's own configuration page inside the DSH **Plugins** page.
+ *
+ * The host's Plugins page owns per-plugin configuration: it draws the icon, the
+ * title and the crumb, and renders a `plugins.bundle.config` entry ON the
+ * bundle's own page, under its description and above its rows. The card keeps
+ * its own chrome — the switches, the credential form, the section order — so the
+ * move from the Settings page changed where it is reached from, not what it does.
+ * @param props - renderer-bound seat of the `plugins.bundle.config` slot: the
+ * `view` asked for plus the `t` seat its `locale: NS` registration injects.
  * @returns The card element.
  */
-export declare function TidySettingsPanel(props: PropsRuntime<'reading.settings.item'> & PropsLocale<typeof NS>): React.ReactElement;
+export declare function TidySettingsPanel(props: PropsRuntime<'plugins.bundle.config'> & PropsLocale<typeof NS>): React.ReactElement;
 /**
  * Bind the settings store to this plugin's own configuration form and the
- * credentials Remote API, then join the shared 「阅读体验」 settings page:
- * whichever participant activates first claims the page, everyone registers a
- * card into its child slot.
+ * credentials Remote API, then contribute this plugin's configuration page to
+ * the DSH **Plugins** page.
  * @param ctx - DSH browser client context.
  */
 export declare function setupSettingsUi(ctx: any): void;

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Chat translate",
+    "description": "Rewrites assistant reply prose into natural Simplified Chinese, leaving code blocks and thinking chains untouched."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "聊天翻译",
+    "description": "把助手回答的正文自动改写成自然简体中文，代码块与思考链原样保留。"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynn123411/dsh-chat-translate",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "description": "Assistant reply-body translation for the DeepSeek Harness Web UI (OpenAI-compatible channel)",
   "license": "MIT",
   "author": "lynn123411",
@@ -38,6 +38,8 @@
       "default": "./lib/client.js"
     },
     "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/en.json": "./locale/en.json",
+    "./locale/zh.json": "./locale/zh.json",
     "./package.json": "./package.json"
   },
   "dsh": {
@@ -48,50 +50,57 @@
       "platform": "web",
       "immediately": true,
       "inject": [
-        "@deepseek-ai/dsh-client-ui-primitives"
+        "@deepseek-ai/dsh-client-ui-primitives",
+        "@deepseek-ai/dsh-client-ui-plugin-manager"
       ]
     }
   },
   "files": [
     "lib",
     "docs",
+    "assets",
+    "locale",
     "cordis.patch.yml",
     "README.md"
   ],
   "scripts": {
     "build": "node build.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node scripts/test-client-wiring.mjs && node scripts/test-chat-translate.mjs && node scripts/test-regression-suite.mjs && node scripts/test-channel-logic.mjs && node scripts/test-store.mjs && node scripts/test-reply-pipeline.mjs",
+    "test": "node scripts/test-client-wiring.mjs && node scripts/test-render.mjs && node scripts/test-chat-translate.mjs && node scripts/test-regression-suite.mjs && node scripts/test-channel-logic.mjs && node scripts/test-store.mjs && node scripts/test-reply-pipeline.mjs",
     "assert:lib-untracked": "node scripts/assert-lib-untracked.mjs",
     "check": "pnpm typecheck && pnpm build && pnpm test && pnpm assert:lib-untracked"
   },
   "engines": {
     "node": "^22.19 || >=24",
-    "dsh": ">=0.1.7-rc.2"
+    "dsh": ">=0.2.0-rc.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-client-connection": ">=0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.2",
-    "@deepseek-ai/dsh-home-paths": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-home-paths": ">=0.2.0-rc.2",
     "@deepseek-ai/schemastery": "^3.18.4",
     "@eslint/js": "^9.30.0",
     "@types/node": "^22.19.0",
     "@types/react": "^19.2.18",
     "esbuild": "^0.25.0",
     "jsdom": "^26.1.0",
-    "typescript": "^6.0.0"
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^6.0.0",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": ">=0.2.0-rc.2"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-rc.2",
-    "@deepseek-ai/dsh-home-paths": ">=0.1.7-rc.2"
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-home-paths": ">=0.2.0-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-client-ui-primitives": {
       "optional": true
     }
-  }
+  },
+  "icon": "./assets/icon.svg"
 }

package/lib/types/client/reading-settings-page.d.ts

@@ -1,92 +0,0 @@
-/**
- * The shared 「阅读体验」 settings page.
- *
- * Several plugins contribute their configuration to ONE settings page, but the
- * kernel cannot declare that page jointly: `settings.section` is a list slot
- * that rejects a duplicate `id` at the same priority ("already has an entry
- * with id"), and a child slot may be declared exactly once ("slot … is already
- * declared"). Composing several cards into one page therefore takes one
- * declarer, so every participating plugin carries this same shell and the
- * FIRST one to activate claims the page; the others register their card into
- * {@link READING_ITEM_SLOT} and wait for the winner's declaration through
- * `slots.inject`. Uninstalling the winner promotes another participant on the
- * next boot, so no participant is a fixed owner.
- *
- * The page renders ONE TAB PER REGISTERED CARD: the tab roster comes from the
- * child slot's own registrations (id + `label` + `order`, the same shape the
- * kernel's own Plugins page uses for its tabs), and each panel dispatches
- * through `renderSlot(READING_ITEM_SLOT, {}, { only: id })`. Every panel stays
- * mounted but hidden, so a card's local state survives a tab switch.
- *
- * Keep this file identical across the participating plugins
- * (`dsh-smooth-stream`, `dsh-chat-translate`).
- * Participants own their own card component, locale dictionaries, settings
- * namespace and Host half — only the page shell below is shared, because
- * cross-plugin value imports are forbidden by the client bundle purity gate.
- * It imports nothing but `react` plus type-only DSH packages on purpose, so
- * every participant's build configuration compiles it unchanged.
- *
- * Settings storage belongs to the card, not to this shell: since 0.1.7 a
- * participant reads and writes its own Config through
- * `ctx.configForms.get(<profile entry id>)` and gates the registration on
- * `ctx.configForms.whileServed(...)`. The shell only stacks cards — it holds no
- * settings service of its own, which is why it needs nothing beyond
- * `ctx.slots` and the optional `locale`.
- */
-import type { Context as ClientContext } from '@deepseek-ai/cordis';
-import type { InjectFace, LocaleNamespaceMap, PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
-/** Page id claimed by the first participating plugin to activate. */
-export declare const READING_PAGE_ID = "reading";
-/** Sidebar position of the shared page; own plugins start at 110. */
-export declare const READING_PAGE_ORDER = 110;
-/** The page's one child slot: every participant's card registers here. */
-export declare const READING_ITEM_SLOT = "reading.settings.item";
-declare module '@deepseek-ai/dsh-client-ui-slots' {
-    interface SlotMap {
-        /** One participating plugin's card inside the shared reading page. */
-        'reading.settings.item': {
-            kind: 'list';
-            scope: 'root';
-        };
-    }
-}
-/** One participant's tab, derived from its card registration. */
-export interface ReadingTab {
-    /** Registration id — the participant's Host settings namespace. */
-    id: string;
-    /** Registration order, ascending in the tab bar. */
-    order: number;
-    /** Registration label, already resolved for the active locale. */
-    label: string;
-}
-/** Live tab roster handed to the page component through its inject face. */
-export interface ReadingTabsFace {
-    getSnapshot(): readonly ReadingTab[];
-    subscribe(listener: () => void): () => void;
-}
-/** Inject face of the shared page. */
-export interface ReadingPageFace {
-    readingTabs: ReadingTabsFace;
-}
-type ReadingPageProps = PropsRuntime<'settings.section'> & PropsRenderSlots<typeof READING_ITEM_SLOT> & InjectFace<ReadingPageFace>;
-/**
- * Page body: one tab per registered card, plus the selected card's panel.
- * The shell supplies the section's own seats and `renderSlot` bound to the
- * child slot declared at registration time.
- */
-export declare function ReadingSettingsSection({ renderSlot, readingTabs }: ReadingPageProps): import("react").DetailedReactHTMLElement<import("react").HTMLAttributes<HTMLElement>, HTMLElement> | null;
-/** Whether a participant already holds the shared page. */
-export declare function readingPageClaimed(ctx: ClientContext): boolean;
-/**
- * Claim the shared page when no participant holds it yet. Call inside
- * `ctx.slots.inject('settings.section', …)`: injection order decides the
- * winner, and the losers stay silent instead of colliding with the kernel's
- * duplicate-id and duplicate-declaration guards.
- * @param ctx - browser context carrying the slot registry.
- * @param label - page label, re-read by the shell on every projection.
- * @param locale - locale namespace the label thunk translates through.
- * @returns The page registration's disposer, or a no-op when another
- * participant already holds the page.
- */
-export declare function claimReadingSettingsPage(ctx: ClientContext, label: () => string, locale: keyof LocaleNamespaceMap & string): () => void;
-export {};