taro-bluetooth-print 2.2.1 → 2.3.0

package/CHANGELOG.md

@@ -5,6 +5,44 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.0] - 2026-02-11
+
+### Added
+
+- **插件系统 (Plugin System)** - 可扩展的插件架构
+  - `PluginManager` 管理插件生命周期
+  - 支持 beforeConnect/afterConnect/beforePrint/afterPrint 等钩子
+  - 内置 `LoggingPlugin` 详细日志记录
+  - 内置 `RetryPlugin` 自动重试与指数退避
+
+- **TSPL 标签打印驱动 (TsplDriver)** - TSC 打印机语言支持
+  - 标签尺寸、间隙、速度、密度设置
+  - 文本打印（多字体、旋转、缩放）
+  - 条码支持（Code128、Code39、EAN-13/8、UPC-A）
+  - 二维码支持
+  - 图形绘制（矩形、线条、反白）
+
+### Changed
+
+- **升级 Taro 至 v4.x** - 从 3.6.x 升级到 4.1.11
+- **升级 Vite 至 v7.x** - 从 5.x 升级到 7.3.1
+- **测试框架迁移至 Vitest** - 替换 Jest，测试速度提升 ~6x
+- **升级其他依赖**:
+  - vite-plugin-dts: 3.9.1 → 4.5.4
+  - prettier: 3.2.4 → 3.8.1
+  - rimraf: 5.0.0 → 6.1.2
+  - terser: 5.24.0 → 5.46.0
+
+### Fixed
+
+- 修复 TypeScript 测试配置兼容性问题
+- 修复 breakpoint.test.ts 中的类型错误
+- 修复 package.json exports 条件顺序警告
+
+### Removed
+
+- 移除 Jest 相关依赖 (jest, ts-jest, @types/jest, jest-environment-jsdom)
+
 ## [2.2.0] - 2026-01-04
 
 ### Added

package/README.md

@@ -17,7 +17,7 @@
 ## ✨ 特性
 
 - 🚀 **高性能** - 直接字节缓冲区操作，服务缓存优化
-- 📱 **跨平台** - 基于 Taro 蓝牙 API，支持微信小程序、H5、React Native 等
+- 📱 **跨平台** - 基于 Taro 4.x 蓝牙 API，支持微信小程序、H5、React Native 等
 - 🎨 **简洁 API** - 链式调用，易于使用
 - 🖼️ **图片打印** - 内置 Floyd-Steinberg 抖动算法，高质量图片转换
 - 📲 **二维码支持** - 原生 ESC/POS 二维码指令
@@ -31,8 +31,10 @@
 - 🔍 **打印预览** - ESC/POS 命令渲染为图像预览
 - 🌐 **Web Bluetooth** - 支持 H5 环境的 Web Bluetooth API
 - 💓 **连接稳定** - 心跳检测和自动重连机制
+- 🏷️ **标签打印** - TSPL 协议支持，适用于 TSC 等标签打印机 (v2.3+)
+- 🔌 **插件系统** - 可扩展架构，支持自定义钩子 (v2.3+)
 - 🛠️ **TypeScript** - 完整的类型定义和 JSDoc 文档
-- 🧪 **高测试覆盖** - 76%+ 代码覆盖率
+- 🧪 **高测试覆盖** - Vitest 驱动，69+ 测试用例
 
 ## 📦 安装
 
@@ -246,6 +248,85 @@ await cache.save({ id: 'job-1', data: printData });
 await cache.sync();
 ```
 
+### TSPL 标签打印 (v2.3+)
+
+```typescript
+import { TsplDriver } from 'taro-bluetooth-print';
+
+const tspl = new TsplDriver();
+
+// 生成标签打印指令
+const buffer = tspl
+  .size(60, 40)           // 标签尺寸 60x40mm
+  .gap(3)                 // 标签间隙 3mm
+  .clear()                // 清除缓冲区
+  .text('商品名称', { x: 50, y: 30, font: 3 })
+  .text('¥99.00', { x: 50, y: 80, font: 4, xMultiplier: 2 })
+  .barcode('6901234567890', { 
+    x: 50, 
+    y: 120, 
+    type: 'EAN13',
+    height: 60 
+  })
+  .qrcode('https://example.com', { 
+    x: 300, 
+    y: 30, 
+    cellWidth: 4 
+  })
+  .print(1)               // 打印1份
+  .getBuffer();
+
+// 发送到打印机
+await printer.connect(deviceId);
+await printer.setOptions({ chunkSize: 100 });
+// 直接发送 TSPL 指令需要自定义适配器
+```
+
+### 插件系统 (v2.3+)
+
+```typescript
+import { 
+  PluginManager, 
+  createLoggingPlugin, 
+  createRetryPlugin 
+} from 'taro-bluetooth-print';
+
+// 创建插件管理器
+const plugins = new PluginManager();
+
+// 注册日志插件
+await plugins.register(createLoggingPlugin({
+  logProgress: true,  // 记录进度
+}));
+
+// 注册重试插件
+await plugins.register(createRetryPlugin({
+  maxRetries: 5,
+  initialDelay: 1000,
+}));
+
+// 自定义插件
+const myPlugin = {
+  name: 'my-plugin',
+  hooks: {
+    beforePrint: (buffer) => {
+      console.log(`即将打印 ${buffer.length} 字节`);
+      return buffer; // 可以修改数据
+    },
+    afterPrint: (bytesSent) => {
+      console.log(`打印完成: ${bytesSent} 字节`);
+    },
+    onError: (error) => {
+      // 上报错误
+      reportError(error);
+      return false; // false = 不抑制错误
+    },
+  },
+};
+
+await plugins.register(myPlugin);
+```
+
 ## 📚 文档
 
 完整文档请访问：**[https://agions.github.io/taro-bluetooth-print/](https://agions.github.io/taro-bluetooth-print/)**
@@ -283,6 +364,35 @@ await cache.sync();
 | `cancel()`                           | 取消打印             | `void`          |
 | `remaining()`                        | 获取剩余字节数       | `number`        |
 
+### TsplDriver (v2.3+)
+
+| 方法                           | 说明               | 返回值       |
+| ------------------------------ | ------------------ | ------------ |
+| `size(width, height)`          | 设置标签尺寸(mm)   | `this`       |
+| `gap(gap, offset?)`            | 设置标签间隙       | `this`       |
+| `speed(speed)`                 | 设置打印速度(1-10) | `this`       |
+| `density(density)`             | 设置打印浓度(0-15) | `this`       |
+| `clear()`                      | 清除图像缓冲区     | `this`       |
+| `text(content, options)`       | 添加文本           | `this`       |
+| `barcode(content, options)`    | 添加条码           | `this`       |
+| `qrcode(content, options)`     | 添加二维码         | `this`       |
+| `box(options)`                 | 绘制矩形框         | `this`       |
+| `line(options)`                | 绘制线条           | `this`       |
+| `print(copies?, sets?)`        | 打印               | `this`       |
+| `getBuffer()`                  | 获取指令缓冲区     | `Uint8Array` |
+| `getCommands()`                | 获取指令字符串     | `string`     |
+
+### PluginManager (v2.3+)
+
+| 方法                        | 说明           | 返回值          |
+| --------------------------- | -------------- | --------------- |
+| `register(plugin, options)` | 注册插件       | `Promise<void>` |
+| `unregister(name)`          | 注销插件       | `Promise<void>` |
+| `get(name)`                 | 获取插件       | `Plugin`        |
+| `has(name)`                 | 检查插件是否存在 | `boolean`     |
+| `getNames()`                | 获取所有插件名 | `string[]`      |
+| `clear()`                   | 清除所有插件   | `Promise<void>` |
+
 ### 事件
 
 | 事件名           | 数据类型              | 说明         |
@@ -324,18 +434,22 @@ interface IQrOptions {
 ## 🏗️ 架构设计
 
 ```
-┌─────────────────────────────────────┐
-│      BluetoothPrinter (Core)        │
-│  - 连接管理                          │
-│  - 打印队列                          │
-│  - 事件系统                          │
-│  - 断点续传                          │
-└────────┬────────────────┬───────────┘
-         │                │
-    ┌────▼─────┐    ┌────▼──────┐
-    │ Adapter  │    │  Driver   │
-    │  层      │    │   层      │
-    └──────────┘    └───────────┘
+┌─────────────────────────────────────────────────┐
+│            BluetoothPrinter (Core)              │
+│  - 连接管理  - 打印队列  - 事件系统  - 断点续传  │
+└──────────┬──────────────────┬───────────────────┘
+           │                  │
+     ┌─────▼──────┐     ┌────▼──────┐
+     │  Adapter   │     │  Driver   │
+     │    层      │     │    层     │
+     └────────────┘     └───────────┘
+           │                  │
+     ┌─────▼──────┐     ┌────▼──────┐     ┌────────────┐
+     │ Taro       │     │ ESC/POS   │     │  Plugin    │
+     │ Web BT     │     │ TSPL      │     │  System    │
+     │ Alipay...  │     │ (ZPL...)  │     │  (v2.3+)   │
+     └────────────┘     └───────────┘     └────────────┘
+```
          │                │
     ┌────▼─────┐    ┌────▼──────┐
     │Taro      │    │ESC/POS    │