taro-bluetooth-print 2.13.0 → 2.15.0

package/CHANGELOG.md

@@ -1,115 +1,97 @@
 # 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）
+## [2.15.0] - 2026-07-07
 
 ### 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
+- **Professional Documentation Redesign** — Complete visual overhaul of docs site with custom brand identity
+  - 6 new SVG logo variants (primary, mark, dark, wordmark, OG cover, hero banner)
+  - Reimagined docs landing page with hero banner, feature cards, and compatibility matrix
+  - Full Mermaid architecture diagrams (6-layer system, connection sequence, print flow)
+- **Online Documentation Link** — `homepage` and `documentation` fields added to `package.json`
+  - Live docs: https://agions.github.io/taro-bluetooth-print/
 
-- 源代码: 25,828 行 → 24,687 行（-1,141 行，-4.4%）
-- 源文件: 96 个 → 84 个（-12 个）
-- 构建产物: 631 KB（gzip 231 KB）
-
----
+### Changed
 
-## [2.12.0] - 2026-05-25
+- **README.md** — Hero section with brand badges, 4 why-choose cards, architecture mermaid diagram, 8×7 platform compatibility matrix, error handling pattern guide, and plugin ecosystem section (360 → 443 lines)
+- **docs/index.md** — VitePress hero with `hero-banner.svg`, 6 feature cards, full protocol×platform matrix, 6 highlight cards with hover effects (154 → 305 lines)
+- **docs/guide/architecture.md** — Added mermaid `flowchart TD` (6-layer architecture), `sequenceDiagram` (connection flow + print flow), detailed layer responsibility table
+- **docs/.vitepress/config.ts** — Updated SEO meta tags, OG image (`og-cover.svg`), brand theme color (`#6366f1`)
+- **Brand Identity** — Unified design language: indigo → cyan gradient (`#4338ca` → `#6366f1` → `#0891b2`), rounded-receipt motif, Bluetooth waveform arcs, 7×7 QR matrix
 
-### Changed
+### Assets
 
-- **代码质量优化**: 全面消除 ESLint 错误和警告
-- **测试覆盖率提升**: 从 64% 提升至 80.87%
-- **Bug 修复**: sendAudioData 无限循环（catch 块缺少 break）
+| File | Size | Purpose |
+|:---|:---|:---|
+| `docs/public/logo.svg` | 240×240 | Primary logo (gradient plate + receipt + BT arcs) |
+| `docs/public/logo-mark.svg` | 64×64 | Compact icon-only variant |
+| `docs/public/logo-dark.svg` | 240×240 | Dark background variant |
+| `docs/public/wordmark.svg` | 560×96 | Horizontal logo with tagline |
+| `docs/public/og-cover.svg` | 1200×630 | Social sharing card |
+| `docs/public/hero-banner.svg` | 1600×400 | Docs landing page hero |
+| `docs/public/favicon.svg` | 32×32 | Browser tab favicon (redesigned) |
 
-### Testing
+### Documentation
 
-- 434 tests passed
-- coverage: 80.87%
+- All SVG assets are inline-path (0 external dependencies)
+- Docs build time: 19.3s, 0 errors
+- Mermaid diagrams render correctly in VitePress
 
 ---
 
-## [2.11.0] - 2026-05-04
+## [2.14.0] - 2026-07-07
 
 ### 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
+- **核心引擎解耦**: `BluetoothPrinter` 抽出 `handleError()` 与 `resolveConnectionManager()` helper，消除 4 处 try/catch 模板
+- **命令构建器精简**: `CommandBuilder` 抽出 `pushCommands()` helper，消除 7 处 `buffer.push + invalidateCache` 重复
+- **适配器分层**: 5 个 mini-program adapter（Taro / Alipay / Baidu / ByteDance / QQ）精简为薄壳类（-69% 平均）
+- **服务层去重**: `ConnectionManager.classifyConnectError()`、`PrintJobManager.wrapError()` 抽离，消除嵌套三元
+- **错误类去重**: `ConnectionError` / `PrintJobError` 移除冗余 mapping 表（基于字符串值与 `ErrorCode` 完全一致）；`CommandBuildError` 仅保留 DRIVER_ERROR 单条映射
+- **类型黑洞修复**: `PluginManager.executeHook()` 移除 `@ts-expect-error`，改用显式类型守卫
+- **命名规范统一**: 冻结 PascalCase（类文件）/ camelCase（工具文件）/ `I`-prefix（接口）/ 0 下划线前缀 4 条规则
+- **API 表面补完**: `src/index.ts` 新增 `QQAdapter` 导出
 
----
+### Removed
 
-All notable changes to this project will be documented in this file.
+- `src/utils/validation.ts` — deprecated 空 stub，无任何引用
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+### Renamed
 
----
+- `drivers/escPosDriver.ts` → `drivers/EscPosDriver.ts`
+- `drivers/barcode-helpers.ts` → `drivers/BarcodeHelpers.ts`
+- `errors/baseError.ts` → `errors/BaseError.ts`
+- `plugins/types.ts` → `plugins/PluginTypes.ts`
+- `encoding/gbk-{table,lite,data}.ts` → `encoding/Gbk{Table,Lite,Data}.ts`
+- `encoding/korean-japanese.ts` → `encoding/KoreanJapanese.ts`
 
-## [2.10.2] - 2026-05-02
+### Refactoring Metrics
 
-### Fixed
+| 指标 | Before | After | Δ |
+|---|---:|---:|---:|
+| `BluetoothPrinter.ts` | 433 行 | 277 行 | **-36%** |
+| `CommandBuilder.ts` | 315 行 | 158 行 | **-50%** |
+| `PrintJobManager.ts` | 539 行 | 386 行 | **-28%** |
+| 5 mini-program adapters | ~200 行 | ~62 行 | **-69%** |
+| 3 error classes | 225 行 | 142 行 | **-37%** |
+| **Total** | **23,355 行** | **22,567 行** | **-788 / -3.4%** |
 
-- **代码质量优化 — 消除所有 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 残留**
+### Testing
 
----
+- 1,102 tests passed, 38 skipped, 0 regressions
+- type-check: 0 errors (strict + noUncheckedIndexedAccess 全开)
+- eslint: 0 errors / 0 warnings
+- vite build: 22.84s · 230.91 KB gzip（基线 22.25s · 230.58 KB gzip）
+- GitHub Actions CI: ✅ success (Run #28835694715)
+
+### Commits
+
+7 个 conventional commits 落地 (`be2fbdc..06f5ede`)：
+
+- `2fc1f2d` refactor(core): simplify BluetoothPrinter & CommandBuilder
+- `27fdd6a` refactor(services): dedup ConnectionManager + PrintJobManager
+- `c6adaf6` refactor(adapters): deduplicate mini-program adapters and BaseAdapter imports
+- `2bf28f6` refactor: enforce PascalCase file naming for class-bearing modules
+- `6dfe1c5` refactor: remove @ts-expect-error and dead code
+- `8e9193d` refactor(errors): deduplicate error-code mapping tables
+- `06f5ede` chore: update import paths after PascalCase file renames