Changelog

[2.13.0] - 2026-05-27

Changed

• 架构精简: 移除过度工程的 DI 容器系统（Container、Tokens、ServiceProvider、di-factory），约 1,048 行冗余代码
• 事件系统统一: 移除冗余的 EventBus，统一使用类型安全的 EventEmitter
• 插件系统统一: 移除冗余的 core/plugin PluginManager，保留 plugins/PluginManager
• 代码重复消除: 重复率从 0.57% 降至 0%（8 个克隆 → 0 个）
  • TemplateRenderer 提取 buildTableSeparatorLine 和 renderFillLines 辅助方法
  • CpclDriver/ZplDriver 提取 barcode-helpers.ts mixin 模式
  • BaseAdapter 统一重导出共享依赖，消除 ReactNativeAdapter 重复导入
  • PreviewRenderer 合并 handleESC/handleGS 为 handleControlSequence
  • gbk-lite.ts 数据去重（582 → 106 条目，减少 81.8%）
• 类型安全提升: 类型断言从 124 处降至 73 处
  • EventEmitter 内部存储改用映射类型，消除 10+ 类型断言
  • 消除所有 as 类型转换中的不必要断言
• 错误处理改进: 修复 6 处空 catch 块，所有异常均记录日志
  • CloudPrintManager、QRCodeDiscoveryService、PrinterStatus、PrintScheduler
• 魔法数字提取: 8 个硬编码数字提取为命名常量
  • DEFAULT_HEARTBEAT_INTERVAL、DEFAULT_RECONNECT_INTERVAL、DEFAULT_CONNECTION_TIMEOUT
  • DEFAULT_RETRY_BASE_DELAY、DEFAULT_RETRY_MAX_DELAY、MAX_TIMEOUT_MS
• 工厂模式简化: 移除 PrinterFactory 对象包装，保留 createBluetoothPrinter 和 createWebBluetoothPrinter 函数

Removed

• 删除 src/core/di/ 目录（Container.ts、Tokens.ts、index.ts）
• 删除 src/core/event/ 目录（EventBus.ts、index.ts）
• 删除 src/core/plugin/ 目录（PluginManager.ts、index.ts）
• 删除 src/providers/ 目录（ServiceProvider.ts、index.ts）
• 删除 src/factory/di-factory.ts
• 删除 5 个对应的测试文件
• 删除根目录多余报告文档（ARCHITECTURE_ANALYSIS.md、CODE_DUPLICATION_REPORT.md、RELEASE_v2.9.6.md）

Added

• 新增 src/drivers/barcode-helpers.ts — 条码便捷方法 mixin
• BaseAdapter 新增共享依赖重导出

Testing

• 1,102 tests passed, 38 skipped, 0 regressions
• type-check: 0 errors
• build: 通过
• 代码重复率: 0%（jscpd 检测）

Performance

• 源代码: 25,828 行 → 24,687 行（-1,141 行，-4.4%）
• 源文件: 96 个 → 84 个（-12 个）
• 构建产物: 631 KB（gzip 231 KB）

---

[2.12.0] - 2026-05-25

Changed

• 代码质量优化: 全面消除 ESLint 错误和警告
• 测试覆盖率提升: 从 64% 提升至 80.87%
• Bug 修复: sendAudioData 无限循环（catch 块缺少 break）

Testing

• 434 tests passed
• coverage: 80.87%

---

[2.11.0] - 2026-05-04

Changed

• 错误体系统一: 将 14 处 throw new Error() 迁移为 BluetoothPrintError + ErrorCode，覆盖 ReactNativeAdapter、DeviceManager、PrinterConfigManager、PrinterFactory、PreviewRenderer、PrintQueue、CloudPrintManager、PrintJobManager、PrintScheduler、image.ts
• DiscoveryService.ts: 移除顶部 3 条 eslint-disable 规则，清理注释代码
• TemplateRenderer.ts: itemData: any → Record<string, unknown>，移除 3 处行内 eslint-disable
• outputLimiter.ts: batchProcess 错误处理规范化（instanceof Error 守卫 + message 输出）
• 魔数提取: ChunkWriteStrategy 提取 7 个常量（CHUNK_SIZE_STEP、DELAY_BACKOFF_FACTOR 等），PrintHistory 提取 DEFAULT_MAX_ENTRIES，TemplateRenderer/TemplateEngine 提取 DEFAULT_PAPER_WIDTH

Added

• 新增 ErrorCode: QUEUE_FULL、QUEUE_JOB_NOT_FOUND、PREVIEW_FAILED

Testing

• 985 tests passed, 38 skipped, 0 regressions
• type-check: 0 errors
• lint: 0 errors

---

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

---

[2.10.2] - 2026-05-02

Fixed

• 代码质量优化 — 消除所有 ESLint 错误 (#37 → 0)
  • 移除 3 个文件顶部 eslint-disable（共 18 条规则绕过）
  • 修复所有非空断言 (!) — Uint8Array[i]!、parts[x]!、job.nextRunTime! 等
  • 修复所有 any 类型绕过 — as string 改为 typeof 运行时检查
  • JSON.parse 结果改用 as Record<string, unknown> + 类型守卫访问
  • 异步方法 void → await，消除 require-await 错误
  • Record<string, any> → Record<string, unknown>
  • 消除 no-base-to-string：String(value) → JSON.stringify(value)
  • 消除 no-unused-vars：废弃变量改为 void timeout
• 零 ESLint 警告/错误、零非空断言、零行内 eslint-disable 残留

---