dsh-plugin-update 0.5.7 → 0.6.0

package/dist/panel.d.ts

@@ -1,15 +1,16 @@
 import { type VisibleQueue } from './queue.js';
 import type { BlockedReason, UpdateSnapshot } from './ports.js';
+import { type AppLang, type LocaleOption } from './lang.js';
 /** 摆放形态：默认内嵌，切弹窗走同一参数。 */
 export type UpdatePanelMode = 'embedded' | 'dialog';
-/** 面板主题：默认最小可用样式；`archive` 为档案卷纸面浅色（只换肤，不换 DOM 顺序；`d5-paper` 为旧别名）。 */
+/** 面板主题：默认最小可用样式；`archive` 为档案卷纸面浅色（只换肤，不换 DOM 顺序）。 */
 /**
  * 面板主题：`default` 最小可用深色；`archive` 档案卷纸面浅色（原型敲定的案卷风格，只换肤）。
- * `d5-paper` 是 archive 的旧别名（历史取值），仍可用，渲染逐字相同。
+ * `archive` 是 archive 的旧别名（历史取值），仍可用，渲染逐字相同。
  */
-export type UpdatePanelTheme = 'default' | 'archive' | 'd5-paper';
+export type UpdatePanelTheme = 'default' | 'archive';
 /**
- * 主题归一：archive 为首选名，旧别名 d5-paper 仍收并归到 archive（DOM 属性只出 archive）；
+ * 主题归一：`archive` 挂 `data-theme="archive"`，其余一律回 `default`（DOM 属性只出 `archive`）；
  * 其余一律回 default（纯渲染函数永不抛；挂载/setTheme 的非法值另行抛错）。
  */
 export declare function normalizePanelTheme(value: unknown): 'default' | 'archive';
@@ -26,7 +27,7 @@ export interface UpdatePanelOptions {
     prefix?: string;
     /** 摆放形态：默认内嵌。 */
     mode?: UpdatePanelMode;
-    /** 面板主题：默认 `default`（最小可用样式，一字不动）；传 `archive` 切档案卷（`d5-paper` 为旧别名）。 */
+    /** 面板主题：默认 `default`（最小可用样式，一字不动）；传 `archive` 切档案卷。 */
     theme?: UpdatePanelTheme;
     /** 是否看他人排队明细：默认只看自己的（他人仅露正忙占位，位置照给）。 */
     showOthers?: boolean;
@@ -68,6 +69,11 @@ export interface UpdatePanelOptions {
      * 不传则回退为只停轮询（unmount），DOM 留给调用方处理。入口件打开的 dialog 已内置（收 dialog + 还原按钮）。
      */
     onCloseRequested?: () => void | Promise<void>;
+    /**
+     * 语言覆盖（#61 起消费：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }，不传即跟随全局信号）。
+     * 与入口件同一口径：显式覆盖 > html[lang] > navigator > zh。
+     */
+    locale?: LocaleOption;
 }
 /** 挂载点：只要有 innerHTML 的容器即可（浏览器元素或测试替身都行）。 */
 export interface UpdatePanelContainer {
@@ -107,8 +113,8 @@ export interface BlockedCopy {
     title: string;
     action: string;
 }
-/** 装不了的原因 → 中文一句话（能装传 null 即回 null，不猜）。 */
-export declare function blockedCopy(reason: BlockedReason | null): BlockedCopy | null;
+/** 装不了的原因 → 单语一句话（能装传 null 即回 null，不猜；lang 缺省 zh，零回归）。 */
+export declare function blockedCopy(reason: BlockedReason | null, lang?: AppLang | string | null): BlockedCopy | null;
 export interface FailureCopy {
     zh: string;
     act: string;
@@ -116,10 +122,10 @@ export interface FailureCopy {
 /** 14 码全表是否包含该码（8 阻塞 + 5 电话 + internal；未来码不在此列，走兜底）。 */
 export declare function isKnownFailureCode(code: unknown): boolean;
 /**
- * 稳定码 → 中文一句话（14 码全覆盖；未知码回未来兜底，空码回 null）。
- * 8 阻塞行复用 BLOCKED_COPY 原文，不另起措辞；面板分支只认返回值，不碰 diag。
+ * 稳定码 → 单语一句话（14 码全覆盖；未知码回未来兜底，空码回 null；lang 缺省 zh，零回归）。
+ * 8 阻塞行复用 blocked 行原文，不另起措辞；面板分支只认返回值，不碰 diag。
  */
-export declare function failureCopy(code: unknown): FailureCopy | null;
+export declare function failureCopy(code: unknown, lang?: AppLang | string | null): FailureCopy | null;
 /**
  * 失败回包取稳定码：只认 errorKind，error 仅作回退（#22 验收：errorKind=internal 时
  * 不许误判为查新版失败；包内已把未知码收敛为 error=check-failed/errorKind=internal，
@@ -153,9 +159,11 @@ export interface PanelDiagnosticInput {
     /** 显式来源（diag 没有时用；有 diag 时显式优先，缺省仍说人话，不留白）。 */
     route?: string | null;
     checkId?: string | null;
+    /** 渲染语言（#63 单语：缺省 zh 零回归；挂载态传 currentLang，纯函数直调可显式传 en/zh）。 */
+    lang?: AppLang | string | null;
 }
-/** 组出一段自包含诊断（调用方直接拿去粘工单/issue；粘之前已脱敏，不必手检）。 */
-export declare function buildDiagnosticText(input: PanelDiagnosticInput): string;
+/** 组出一段自包含诊断（调用方直接拿去粘工单/issue；粘之前已脱敏，不必手检；#63 入字典单语，lang 缺省 zh 零回归）。 */
+export declare function buildDiagnosticText(input: PanelDiagnosticInput, langOverride?: AppLang | string | null): string;
 export type DiagCopyFormat = 'block' | 'line';
 export interface TolerantDiag {
     stage: string | null;
@@ -187,8 +195,11 @@ export interface UpdateDiagCopyInput extends PanelDiagnosticInput {
  * 第一性：顺序码→摘要→来源（#18 定），怎么办是面板页脚放最后，不插断三元组；
  * 缺省即省略（#18）：路由/请求/检查/阶段等缺失即不出现，不占位“未知”；
  * 插件/版本/宿主/使用范围/队列恒显（面板侧显式值兜底），摘要缺省给人话，源缺省给人话（省略本身即信息，人读不懂所以必须说）。
+ * #63 入字典单语（§3.4 22 项，队列 3 复用旧块）：标签跟随语言，变量与自由文本、两种复制形态与字段顺序冻结不动；
+ * 机读 tag [update-diag]/code=/·/— 冻结在代码里不进字典（非人类语言），人类标签（摘要/来源/怎么办/插件=…）走字典；
+ * lang 缺省 zh 零回归，detail/变量/占位符不译（v2 非目标，英文界面出现中文正文属正常）。
  */
-export declare function buildUpdateDiagCopy(input: UpdateDiagCopyInput): string;
+export declare function buildUpdateDiagCopy(input: UpdateDiagCopyInput, langOverride?: AppLang | string | null): string;
 export declare function createMemorySkipStore(now?: () => number): PanelSkipStore;
 /** 浏览器跳过存储（localStorage 形状即可；没有或写坏退内存，绝不因跳过挡住更新）。 */
 export declare function createBrowserSkipStore(pluginId: string, storage?: unknown, now?: () => number): PanelSkipStore;
@@ -205,7 +216,7 @@ export interface PanelView {
     showManual: boolean;
     showReset: boolean;
     queueNote: string | null;
-    /** 大印章（状态词）与小印章（一字）：取值与原型 `d5-paper.html:431-432` 的状态映射一一对应。 */
+    /** 大印章（状态词）与小印章（一字）：取值与原型 `archive.html:431-432` 的状态映射一一对应。 */
     seal: PanelSeal;
 }
 /** 印章色调：与原型 `seal-ink / seal-green / seal-yellow / seal-red` 四个类同名同义。 */
@@ -217,6 +228,8 @@ export interface PanelSeal {
     mini: string;
     tone: PanelSealTone;
 }
+/** 状态 → 单语印章（lang 缺省 zh，零回归；tone 与原型同名同义，不入字典）。 */
+export declare function panelSealFor(kind: PanelBanner['kind'], lang?: AppLang | string | null): PanelSeal;
 export interface PanelViewInput {
     snapshot: UpdateSnapshot | null;
     manual: string | null;
@@ -231,15 +244,17 @@ export interface PanelViewInput {
      */
     changelogMarkdown?: string | null;
 }
-export declare function panelViewModel(input: PanelViewInput): PanelView;
+export declare function panelViewModel(input: PanelViewInput, lang?: AppLang | string | null): PanelView;
 export declare const UPDATE_PANEL_CSS: string;
-export declare const UPDATE_PANEL_D5_CSS: string;
+export declare const UPDATE_PANEL_ARCHIVE_CSS: string;
 export interface PanelRenderInput extends PanelViewInput {
     mode: UpdatePanelMode;
     showOthers: boolean;
     pluginId: string;
     copyNotice: string | null;
-    /** 可选主题：不传即默认（输出与旧版一字不差）；`archive` 切档案卷（旧别名 `d5-paper` 仍收）。 */
+    /** 渲染语言（#61 单语：缺省 zh；挂载态传 currentLang，纯函数直调可显式传 en/zh）。 */
+    lang?: AppLang | string | null;
+    /** 可选主题：不传即默认（输出与旧版一字不差）；`archive` 切档案卷。 */
     theme?: UpdatePanelTheme;
     /** 使用范围名（profile）：面板「使用范围」一栏的唯一来源，缺省显示“未知”，不猜。 */
     profileName?: string | null;
@@ -274,12 +289,12 @@ export interface PanelFailureRef {
     source: 'check' | 'install' | null;
     volatile: boolean;
 }
-/** 锁存时刻 → 本地 HH:MM:SS（失败档案“失败于”用；非法值回 null，不画时间）。 */
-export declare function formatLatchTime(atMs: unknown): string | null;
-/** 内核 HTML（双形态行为等价的根：同一视图产出同一内核，只换外层）。 */
-export declare function renderUpdatePanelKernel(input: PanelRenderInput, view: PanelView): string;
+/** 锁存时刻 → 本地 HH:MM:SS（失败档案“失败于”用；非法值回 null，不画时间；#62 跟随宿主 locale）。 */
+export declare function formatLatchTime(atMs: unknown, lang?: AppLang | string | null): string | null;
+/** 内核 HTML（双形态行为等价的根：同一视图产出同一内核，只换外层；#62 按 lang 单语，缺省 zh 零回归）。 */
+export declare function renderUpdatePanelKernel(input: PanelRenderInput, view: PanelView, lang?: AppLang | string | null): string;
 /** 整面板 HTML（含样式；重绘即整体替换 innerHTML，故每次都带 style 也只留一份）。 */
-export declare function renderUpdatePanelHTML(input: PanelRenderInput): string;
+export declare function renderUpdatePanelHTML(input: PanelRenderInput, lang?: AppLang | string | null): string;
 /**
  * mount 自动查抑制谓词（#48：#46 结论固化，纯函数）：
  * 仅当快照任务态为 installing/verifying，或已有查/装在途动作时不发起；