dsh-plugin-update 0.5.7 → 0.6.0

package/dist/lang.js

@@ -0,0 +1,150 @@
+// AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/lang.ts
+function normalizeLangTag(tag) {
+  if (typeof tag !== "string") return "zh";
+  const s = tag.trim().toLowerCase().replace(/_/g, "-");
+  if (!s) return "zh";
+  if (s === "zh" || s.startsWith("zh-")) return "zh";
+  if (s === "en" || s.startsWith("en-")) return "en";
+  if (/^[a-z]{2,3}(-[a-z0-9]+)*$/.test(s)) return "en";
+  return "zh";
+}
+function readDocumentLang() {
+  try {
+    const g = globalThis;
+    const v = g.document?.documentElement?.lang;
+    if (typeof v === "string" && v.trim()) return v;
+  } catch {
+  }
+  return null;
+}
+function readNavigatorLangs() {
+  try {
+    const g = globalThis;
+    const nav = g.navigator;
+    if (!nav) return [];
+    const out = [];
+    if (Array.isArray(nav.languages)) {
+      for (const c of nav.languages) {
+        if (typeof c === "string" && c.trim()) out.push(c);
+      }
+    }
+    if (typeof nav.language === "string" && nav.language.trim()) out.push(nav.language);
+    return out;
+  } catch {
+    return [];
+  }
+}
+function resolveLang(override) {
+  if (override !== null && typeof override === "object") {
+    try {
+      const fn = override.getActive;
+      if (typeof fn === "function") {
+        const v = fn.call(override);
+        if (typeof v === "string" && v.trim()) return normalizeLangTag(v);
+      }
+    } catch {
+    }
+  } else if (typeof override === "string" && override.trim()) {
+    return normalizeLangTag(override);
+  }
+  const docLang = readDocumentLang();
+  if (docLang !== null) return normalizeLangTag(docLang);
+  const navs = readNavigatorLangs();
+  for (const c of navs) {
+    return normalizeLangTag(c);
+  }
+  return "zh";
+}
+const entries = /* @__PURE__ */ new Set();
+let mo = null;
+function ensureGlobalObserver() {
+  if (mo !== null) return;
+  try {
+    const g = globalThis;
+    const docEl = g.document?.documentElement;
+    const MO = g.MutationObserver;
+    if (!docEl || typeof MO !== "function") return;
+    const obs = new MO(() => {
+      notifyAll();
+    });
+    obs.observe(docEl, { attributes: true, attributeFilter: ["lang"] });
+    mo = obs;
+  } catch {
+    mo = null;
+  }
+}
+function notifyAll() {
+  for (const e of [...entries]) {
+    try {
+      const next = resolveLang(e.override);
+      if (next !== e.last) {
+        e.last = next;
+        e.cb(next);
+      }
+    } catch {
+    }
+  }
+}
+function subscribeLang(cb, override) {
+  if (typeof cb !== "function") throw new Error("[dsh-plugin-update] subscribeLang needs a function");
+  const entry = { cb, override: override ?? void 0, last: resolveLang(override), serviceUnsub: null };
+  entries.add(entry);
+  ensureGlobalObserver();
+  try {
+    if (entry.override !== null && typeof entry.override === "object") {
+      const sub = entry.override.subscribe;
+      if (typeof sub === "function") {
+        const un = sub.call(entry.override, () => {
+          try {
+            const next = resolveLang(entry.override);
+            if (next !== entry.last) {
+              entry.last = next;
+              entry.cb(next);
+            }
+          } catch {
+          }
+        });
+        if (typeof un === "function") entry.serviceUnsub = un;
+      }
+    }
+  } catch {
+  }
+  let done = false;
+  return () => {
+    if (done) return;
+    done = true;
+    entries.delete(entry);
+    try {
+      entry.serviceUnsub?.();
+    } catch {
+    }
+    entry.serviceUnsub = null;
+    if (entries.size === 0) {
+      try {
+        mo?.disconnect();
+      } catch {
+      }
+      mo = null;
+    }
+  };
+}
+function __resetLangState() {
+  for (const e of [...entries]) {
+    try {
+      e.serviceUnsub?.();
+    } catch {
+    }
+  }
+  entries.clear();
+  try {
+    mo?.disconnect();
+  } catch {
+  }
+  mo = null;
+}
+export {
+  __resetLangState,
+  normalizeLangTag,
+  resolveLang,
+  subscribeLang
+};

package/dist/panel-batch.d.ts

@@ -54,9 +54,23 @@ export interface BatchPanelOptions {
      * 不传则回退为只停轮询（unmount），DOM 留给调用方处理。入口件打开的 dialog 已内置（收 dialog + 还原按钮）。
      */
     onCloseRequested?: () => void | Promise<void>;
+    /**
+     * 语言覆盖（#59 起消费：新文案走集中字典单语渲染；既有散落文案保持基线不变）。
+     * 形态与入口件一致：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }。
+     */
+    locale?: unknown;
+    /**
+     * 打开面板自动查（#59 D3）：缺省 true。false 即手动挡（行为回今天，只修文案）。
+     * 优先级：用户偏好（prefs.json）> 本选项 > 缺省。
+     */
+    checkOnOpen?: boolean;
+    /**
+     * 自动继续未终态轮次（#59 Q3：与显式按钮并存，常开）。false 可关（测试与特殊集成用）。
+     */
+    autoResume?: boolean;
 }
 /** 面板可点的动作（HTML 上 data-act 一一对应；测试走同一条路）。 */
-export type BatchPanelActionKind = 'check' | 'install' | 'resume' | 'cancel' | 'row-install' | 'row-skip' | 'row-resume-skip' | 'row-cancel-queue' | 'row-copy-manual' | 'row-copy-diag' | 'toggle-details' | 'restart' | 'close';
+export type BatchPanelActionKind = 'check' | 'install' | 'resume' | 'cancel' | 'row-install' | 'row-skip' | 'row-resume-skip' | 'row-cancel-queue' | 'row-copy-manual' | 'row-copy-diag' | 'toggle-details' | 'restart' | 'close' | 'toggle-check-on-open';
 /** 挂载点：只要有 innerHTML 的容器即可（浏览器元素或测试替身都行）。 */
 export interface BatchPanelContainer {
     innerHTML: string;
@@ -71,20 +85,22 @@ export interface BatchPanelController {
     setMode(mode: BatchPanelMode): void;
     unmount(): void;
 }
-/** 批量五个电话名（与宿主侧 MultiHostUpdate.phoneNames 同一形状）。 */
+/** 批量七个电话名（与宿主侧 MultiHostUpdate.phoneNames 同一形状）。 */
 export interface BatchPhoneNames {
     status: string;
     check: string;
     install: string;
     resume: string;
     cancel: string;
+    prefs: string;
+    prefsSave: string;
 }
 /** 批量面板轮询口径（默认 1.5 秒、下限 250 毫秒，与单插件面板同一套下限）。 */
 export declare const BATCH_PANEL_POLL: {
     readonly defaultMs: 1500;
     readonly minMs: 250;
 };
-/** 批量电话名拼法：前缀 + 五个固定动作名（前缀形状校验与单插件面板同一套）。 */
+/** 批量电话名拼法：前缀 + 七个固定动作名（前缀形状校验与单插件面板同一套）。 */
 export declare function buildBatchPhoneNames(prefix: string): BatchPhoneNames;
 export interface BatchLedgerCounts {
     /** phase=ready：有新版、还没安装。 */
@@ -109,20 +125,37 @@ export interface BatchLedgerCounts {
  * 宿主忙时先写占位再回 update-busy，面板把它翻回「可更新」，免得总账把它报成失败。
  */
 export declare function batchLedgerCounts(rows: readonly BatchRowView[]): BatchLedgerCounts;
-/** 分类计数 → 一句话总账（只出现非零档，顺序固定：可更新 · 安装中 · 待查 · 待重启 · 失败 · 已跳过 · 已最新）。 */
-export declare function batchLedgerText(counts: BatchLedgerCounts): string;
+/** 分类计数 → 一句话总账（只出现非零档，顺序固定：可更新 · 安装中 · 待查 · 待重启 · 失败 · 已跳过 · 已最新；#64 单语：缺省 zh 零回归）。 */
+export declare function batchLedgerText(counts: BatchLedgerCounts, lang?: unknown): string;
 /**
  * 排队中的状态词：只回答「还要等多久」。位置从该行的队列视图来。
  * queue.ts 的 position 是 waiting 顺位（队首为 1、0 = 自己正在装），而正在装的那一家也压在这一家前面，
  * 所以「前方 N 个」= position N（队首那家前方正好 1 个：正在装的拥有者）。
  * 位置取不到（宿主只记了忙、没给占位读数）就说「等前面安装完」，不猜数字。
  */
-export declare function batchQueuedStatus(position: number | null): string;
+export declare function batchQueuedStatus(position: number | null, lang?: unknown): string;
+/** 知识账本里的一行（只做展示，不参与安装决策）。 */
+export interface BatchKnowledgeEntry {
+    lastCheckedAt: number;
+    installedVersion: string | null;
+    latestVersion: string | null;
+    canInstall: boolean | null;
+    error: string | null;
+}
+/** 有未终态行（控制区出现条件：盘上有没做完的一轮）。 */
+export declare function hasUnfinishedRows(rows: readonly BatchRowView[], session?: unknown): boolean;
+export declare function unfinishedCount(rows: readonly BatchRowView[], session?: unknown): number;
 /**
  * 一行的状态词：只回答一个问题——这家的**下一步**是什么。
  * 中文可执行，不写相位英文（相位只留在 data-phase 属性上，给人看的这句永远是动作）。
+ * （#59 D2：调用方在无轮次 + 有知识时优先用 batchRowKnowledgeText；本函数语义冻结，旧快照不动。）
+ */
+export declare function batchRowStatus(row: BatchRowView, skippedVersion?: string | null, lang?: unknown): string;
+/**
+ * 无轮次时的知识行（#59 D2）：pending + 有知识即按知识展示；有轮次未做完仍走执行态。
+ * 无知识（从没查过）回 null，调用方回退旧 pending 文案。
  */
-export declare function batchRowStatus(row: BatchRowView, skippedVersion?: string | null): string;
+export declare function batchRowKnowledgeText(row: BatchRowView, entry: BatchKnowledgeEntry | null, lang?: unknown): string | null;
 export interface BatchPanelRenderInput {
     rows?: readonly BatchRowView[];
     theme?: UpdatePanelTheme;
@@ -146,15 +179,23 @@ export interface BatchPanelRenderInput {
     noticeKey?: string | null;
     /** 键 -> 该行已取到的日志全文（只传有文本的；取不到与没展开即中性提示，不挡安装）。 */
     changelogs?: Record<string, string | null>;
+    /** 轮次会话（有未终态行才画控制区；不传按行相位回退旧口径，兼容旧快照）。 */
+    session?: unknown;
+    /** 知识账本（无轮次时行按知识展示；只做展示，不参与安装决策）。 */
+    inventory?: unknown;
+    /** 偏好（底部勾选的受控状态；不传不画勾选）。 */
+    prefs?: unknown;
+    /** 语言（单语渲染新文案用；不传跟随全局信号）。 */
+    lang?: unknown;
 }
 /** 整面板 HTML（含样式；重绘即整体替换 innerHTML，故每次都带 style 也只留一份）。 */
 export declare function renderBatchPanelHTML(input: BatchPanelRenderInput): string;
 export declare const UPDATE_BATCH_PANEL_CSS: string;
 /**
- * 批量面板的 D5 皮肤（#20 同一套口径：只换颜色/字体/间距，不改顺序、不藏东西）。
+ * 批量面板的 Archive 皮肤（#20 同一套口径：只换颜色/字体/间距，不改顺序、不藏东西）。
  * 卷宗抬头右侧给大印章留 120px（与单插件面板档案头同一处理）。
  */
-export declare const UPDATE_BATCH_PANEL_D5_CSS: string;
+export declare const UPDATE_BATCH_PANEL_ARCHIVE_CSS: string;
 /**
  * 挂批量面板（调用方一行即跑）：
  * ```js