dsh-config-manager 0.1.71 → 0.1.73

package/lib/ui/import-wizard.d.ts

@@ -15,12 +15,18 @@ import type { CompatibilityReason, GlobalConflictStrategy, ImportAnalysis, Impor
 import type { SectionId } from '../schema/types.ts';
 import type { ImportPort, ImportPreviewSummary, ImportStep, ProgressListener, WizardSnapshot } from './types.ts';
 import { type SessionFormatDisposition } from './session-format-disposition.ts';
+import { type UiT } from './i18n.ts';
 import { type FlowPhase } from './flow.ts';
 export interface ImportWizardOptions {
     port: ImportPort;
     onProgress?: ProgressListener;
     /** 默认回滚策略（场景 E：true=整体回滚；UI 可在执行前覆盖） */
     defaultRollbackOnError?: boolean;
+    /**
+     * 渲染层翻译器（UiT）。缺省 = **活**翻译器 `liveUiT`（随 DSH 语言变化）——
+     * 绝不是 `zhUiT` 那种加载期快照：英文界面下向导的错误文案不得回落中文。
+     */
+    t?: UiT;
 }
 /**
  * 凭据补录：把**单个 ref 的输入**合并进当前提交集合（UI-06）。
@@ -148,6 +154,7 @@ export declare class ImportWizard {
      * decryptArchive 端点解出明文 ZIP 并返回新 zipPath，后续 analyze/plan/execute 都基于它。
      */
     private unlockedZipPath;
+    private readonly t;
     constructor(opts: ImportWizardOptions);
     /** 当前状态快照（React 绑定 / 测试断言用） */
     snapshot(): WizardSnapshot;

package/lib/ui/import-wizard.js

@@ -1,6 +1,7 @@
 import { DEFAULT_SESSION_FORMAT_DISPOSITION, } from './session-format-disposition.js';
 import { EXECUTING_STAGE, IMPORT_STAGES, ProgressTracker } from './progress.js';
 import { formatActionableError, toActionableError } from './errors.js';
+import { liveUiT } from './i18n.js';
 import { nextFlowPhase } from './flow.js';
 /**
  * 凭据补录：把**单个 ref 的输入**合并进当前提交集合（UI-06）。
@@ -173,11 +174,13 @@ export class ImportWizard {
      * decryptArchive 端点解出明文 ZIP 并返回新 zipPath，后续 analyze/plan/execute 都基于它。
      */
     unlockedZipPath = null;
+    t;
     constructor(opts) {
         this.port = opts.port;
         this.onProgress = opts.onProgress;
         this.tracker = new ProgressTracker(IMPORT_STAGES, this.onProgress);
         this.rollbackOnError = opts.defaultRollbackOnError ?? true;
+        this.t = opts.t ?? liveUiT;
     }
     /** 当前状态快照（React 绑定 / 测试断言用） */
     snapshot() {
@@ -238,8 +241,8 @@ export class ImportWizard {
             this.tracker.emit('checking-compatibility');
             if (!this.analysis.valid) {
                 // 分析失败（完整性/schema/兼容性）：错误进 errors，UI 停在失败态
-                this.errors.push(...this.analysis.errors.map((e) => formatActionableError(toActionableError(new Error(e)))));
-                throw new Error(this.analysis.errors.join('; ') || '备份分析失败');
+                this.errors.push(...this.analysis.errors.map((e) => formatActionableError(toActionableError(new Error(e)), this.t)));
+                throw new Error(this.analysis.errors.join('; ') || this.t('import.analysisFailed'));
             }
             this.step = 'compatibility';
             return this.analysis;
@@ -247,7 +250,7 @@ export class ImportWizard {
         catch (err) {
             // 仅当尚未记录分析错误时才追加（避免重复）
             if (this.errors.length === 0) {
-                this.errors.push(formatActionableError(toActionableError(err)));
+                this.errors.push(formatActionableError(toActionableError(err, { t: this.t }), this.t));
             }
             throw err;
         }
@@ -266,7 +269,7 @@ export class ImportWizard {
     /** 步骤 3→4：用户确认兼容性后进入 Preview（Dry Run：用当前决策生成计划摘要，零写入） */
     async confirmCompatibility() {
         if (this.analysis === null || this.zipPath === null) {
-            throw new Error('尚未完成分析，请先选择备份文件');
+            throw new Error(this.t('import.analysisIncomplete'));
         }
         this.plan = await this.port.createImportPlan(this.resolvedZipPath(), this.decisions, this.planOpts());
         this.step = 'preview';
@@ -339,10 +342,10 @@ export class ImportWizard {
      */
     async execute(opts) {
         if (this.zipPath === null || this.analysis === null) {
-            throw new Error('尚未完成分析，请先选择备份文件');
+            throw new Error(this.t('import.analysisIncomplete'));
         }
         if (opts.confirm !== true) {
-            throw new Error('导入未确认：必须确认后才允许修改任何数据');
+            throw new Error(this.t('import.notConfirmed'));
         }
         const rollbackOnError = opts.rollbackOnError ?? this.rollbackOnError;
         // P0-8：记住执行前的步骤 —— 执行抛错时回到该步骤（确认页/结果页）。
@@ -383,7 +386,7 @@ export class ImportWizard {
             return this.result;
         }
         catch (err) {
-            this.errors.push(formatActionableError(toActionableError(err)));
+            this.errors.push(formatActionableError(toActionableError(err, { t: this.t }), this.t));
             // P0-8：失败回退到执行前步骤（正常是 'preview' = 确认页，那里有重试按钮）；
             // 计划与错误都已保留，用户可直接再次确认执行。
             this.step = previousStep;
@@ -408,12 +411,12 @@ export class ImportWizard {
      */
     async executeRetry(opts) {
         if (this.plan === null || this.result === null) {
-            throw new Error('没有可重试的导入结果');
+            throw new Error(this.t('import.retryNoResult'));
         }
         const retryable = this.retryableIds();
         const subset = this.plan.items.filter((i) => retryable.has(i.id));
         if (subset.length === 0) {
-            throw new Error('没有失败或跳过的项需要重试');
+            throw new Error(this.t('import.retryNothing'));
         }
         const rollbackOnError = opts.rollbackOnError ?? this.rollbackOnError;
         // P0-8：同 execute() —— 重试失败也回退到执行前步骤（结果页），
@@ -438,7 +441,7 @@ export class ImportWizard {
             return this.result;
         }
         catch (err) {
-            this.errors.push(formatActionableError(toActionableError(err)));
+            this.errors.push(formatActionableError(toActionableError(err, { t: this.t }), this.t));
             this.step = previousStep;
             throw err;
         }

package/lib/ui/progress.d.ts

@@ -5,7 +5,7 @@
  * ProgressTracker 供导出/导入控制器在调用 core 前后发出阶段事件（UI 不冻结）。
  */
 import type { ProgressListener } from './types.ts';
-import { type UiT } from './i18n.ts';
+import type { UiT } from './i18n.ts';
 /** 导出阶段文案（规范 §29 Export 示例） */
 export declare const EXPORT_STAGES: readonly string[];
 /** 导入阶段文案（规范 §29 Import 示例 + 快照/回滚阶段） */
@@ -21,7 +21,7 @@ export declare const IMPORT_STAGES: readonly string[];
  */
 export declare const EXECUTING_STAGE: 'executing';
 /** 阶段 id → 用户可读文案（未知阶段回退 id） */
-export declare function stageText(stage: string, t?: UiT): string;
+export declare function stageText(stage: string, t: UiT): string;
 /**
  * 进度追踪器：按给定阶段序列在回调时附带 step/total 序号。
  * 控制器调用 core 前后 emit()，UI 侧渲染进度条/阶段文字。

package/lib/ui/progress.js

@@ -1,4 +1,3 @@
-import { zhUiT } from './i18n.js';
 /** 导出阶段文案（规范 §29 Export 示例） */
 export const EXPORT_STAGES = [
     'analyzing', // Analyzing configuration...
@@ -57,7 +56,7 @@ const STAGE_KEYS = {
     failed: 'progress.failed',
 };
 /** 阶段 id → 用户可读文案（未知阶段回退 id） */
-export function stageText(stage, t = zhUiT) {
+export function stageText(stage, t) {
     const key = STAGE_KEYS[stage];
     return key !== undefined ? t(key) : stage;
 }

package/lib/ui/report.d.ts

@@ -7,13 +7,13 @@
 import type { SectionId } from '../schema/types.ts';
 import type { ExecutedItem, ExportReport, ImportResult, RollbackReport } from '../core/types.ts';
 import type { ImportResultAction, ImportSectionStat } from './types.ts';
-import { type UiT } from './i18n.ts';
+import type { UiT } from './i18n.ts';
 /**
  * 一个分区的 counts → 一行中文计数文本（如「18 个命名空间，3 条说明」）。
  * 空 counts → 空串（调用方按「—」渲染，不要在这里编一个 0）。
  */
-export declare function exportCountsText(counts: Record<string, number>, t?: UiT): string;
-export declare function renderExportReport(report: ExportReport, t?: UiT): string;
+export declare function exportCountsText(counts: Record<string, number>, t: UiT): string;
+export declare function renderExportReport(report: ExportReport, t: UiT): string;
 /** 从 itemId 前缀推断所属分区（与 adapters id 规则对齐；未知归 'other'） */
 export declare function sectionFromItemId(itemId: string): SectionId | 'other';
 /** 按分区聚合执行结果（统计 + 明细） */
@@ -45,10 +45,10 @@ export interface ImportProblem {
  */
 export declare function importProblems(executed: readonly ExecutedItem[]): ImportProblem[];
 /** 导入报告渲染（含回滚状态；§22 动作按钮由 suggestedActions 给出） */
-export declare function renderImportReport(result: ImportResult, t?: UiT): string;
+export declare function renderImportReport(result: ImportResult, t: UiT): string;
 /** 结果页动作按钮（§22）。报告已内联展示全部失败/警告项的原因与回滚详情（§23），
  * 不再提供空操作的 Fix Issues / View Details 按钮——仅保留「完成」。 */
 export declare function suggestedActions(_result: ImportResult): ImportResultAction[];
 /** 回滚报告渲染（full / partial + 人工恢复清单） */
-export declare function renderRollbackReport(rr: RollbackReport, t?: UiT): string;
+export declare function renderRollbackReport(rr: RollbackReport, t: UiT): string;
 export declare function formatBytes(n: number): string;

package/lib/ui/report.js

@@ -1,4 +1,3 @@
-import { zhUiT } from './i18n.js';
 /* ---------------- §21 导出报告 ---------------- */
 /**
  * 分区条目计数的单位词（adapter 的 counts 键 → 字典键）。
@@ -26,7 +25,7 @@ const COUNT_UNIT_KEY = {
  * 一个分区的 counts → 一行中文计数文本（如「18 个命名空间，3 条说明」）。
  * 空 counts → 空串（调用方按「—」渲染，不要在这里编一个 0）。
  */
-export function exportCountsText(counts, t = zhUiT) {
+export function exportCountsText(counts, t) {
     const parts = [];
     for (const [key, value] of Object.entries(counts)) {
         if (typeof value !== 'number' || !Number.isFinite(value))
@@ -34,9 +33,10 @@ export function exportCountsText(counts, t = zhUiT) {
         const unitKey = COUNT_UNIT_KEY[key];
         parts.push(unitKey === undefined ? String(value) + ' ' + key : String(value) + ' ' + t(unitKey));
     }
-    return parts.join('，');
+    // 分隔符也走字典：英文用半角逗号（全角标点在英文界面同样是缺陷）
+    return parts.join(t('report.unitSeparator'));
 }
-export function renderExportReport(report, t = zhUiT) {
+export function renderExportReport(report, t) {
     const lines = [t('report.backupCreated'), ''];
     lines.push(t('report.included'));
     for (const { section, counts } of report.included) {
@@ -155,7 +155,7 @@ export function importProblems(executed) {
     return out;
 }
 /** 导入报告渲染（含回滚状态；§22 动作按钮由 suggestedActions 给出） */
-export function renderImportReport(result, t = zhUiT) {
+export function renderImportReport(result, t) {
     const lines = [result.ok ? t('report.importComplete') : t('report.importFailed'), ''];
     // F4：被删除墓碑过滤的条目提示（用户明确删过、不复活）
     if ((result.skippedTombstoned?.length ?? 0) > 0) {
@@ -202,7 +202,7 @@ export function suggestedActions(_result) {
 }
 /* ---------------- §17 回滚报告 ---------------- */
 /** 回滚报告渲染（full / partial + 人工恢复清单） */
-export function renderRollbackReport(rr, t = zhUiT) {
+export function renderRollbackReport(rr, t) {
     if (rr.full) {
         return t('report.rollbackFull');
     }