@lynn123411/dsh-chat-translate 3.2.0 → 3.3.0

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,8 +7,6 @@ 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 格式重新渲染，表格、列表、加粗与行内代码保持结构。回答还在流式输出时不翻，落定后按阅读顺序逐段出中文。只作用于当前查看的会话，译文不写回会话上下文。输入框下方那一行有同款开关，两处状态同步。";

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.2.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,13 +50,16 @@
       "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"
   ],
@@ -67,16 +72,16 @@
   },
   "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",
@@ -85,15 +90,17 @@
     "jsdom": "^26.1.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
-    "typescript": "^6.0.0"
+    "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 {};