taro-bluetooth-print 2.3.0 → 2.3.1

package/dist/types/drivers/ZplDriver.d.ts

@@ -0,0 +1,325 @@
+/**
+ * ZPL Driver
+ * Zebra Printer Language driver for Zebra label printers
+ *
+ * ZPL is the industry standard for industrial label printing
+ */
+/**
+ * ZPL Label size configuration
+ */
+export interface ZplLabelSize {
+    /** Label width in dots */
+    width: number;
+    /** Label height in dots */
+    height: number;
+    /** Label gap in dots (default: 0) */
+    gap?: number;
+}
+/**
+ * Text format options
+ */
+export interface ZplTextOptions {
+    /** X position in dots */
+    x: number;
+    /** Y position in dots */
+    y: number;
+    /** Font name (default: 0 for built-in) */
+    font?: string;
+    /** Font rotation: N=0, R=90, I=270, B=180 (default: N) */
+    rotation?: 'N' | 'R' | 'I' | 'B';
+    /** Horizontal magnification (1-10, default: 1) */
+    xMultiplier?: number;
+    /** Vertical magnification (1-10, default: 1) */
+    yMultiplier?: number;
+    /** Field orientation: N=normal, R=rotated, I=inverted, B=bottom-up */
+    orientation?: 'N' | 'R' | 'I' | 'B';
+}
+/**
+ * Barcode options
+ */
+export interface ZplBarcodeOptions {
+    /** X position in dots */
+    x: number;
+    /** Y position in dots */
+    y: number;
+    /** Barcode type: 128, 39, 93, EAN13, EAN8, UPCE, CODE51, etc. */
+    type: '128' | '39' | '93' | 'EAN13' | 'EAN8' | 'UPCA' | 'UPCE' | 'CODE51' | 'MSI' | 'PLESSEY';
+    /** Barcode height in dots (default: 50) */
+    height?: number;
+    /** Show human-readable text (default: Y) */
+    showText?: 'Y' | 'N';
+    /** Check digit: Y=validate, N=no check (default: Y) */
+    checkDigit?: 'Y' | 'N';
+    /** Interpretation line: Y=print, N=omit (default: Y) */
+    interpretLine?: 'Y' | 'N';
+    /** Interpretation line above: Y=above, N=below (default: N) */
+    interpretLineAbove?: 'Y' | 'N';
+}
+/**
+ * QR Code options
+ */
+export interface ZplQRCodeOptions {
+    /** X position in dots */
+    x: number;
+    /** Y position in dots */
+    y: number;
+    /** Model: 2 (default) or 1 */
+    model?: 1 | 2;
+    /** Magnification factor 1-10 (default: 4) */
+    magnification?: number;
+    /** Error correction level: L(~7%), M(~15%), Q(~25%), H(~30%) */
+    errorCorrection?: 'L' | 'M' | 'Q' | 'H';
+}
+/**
+ * Box/Rectangle options
+ */
+export interface ZplBoxOptions {
+    /** X position in dots */
+    x: number;
+    /** Y position in dots */
+    y: number;
+    /** Width in dots */
+    width: number;
+    /** Height in dots */
+    height: number;
+    /** Border thickness (default: 2) */
+    borderThickness?: number;
+    /** Corner rounding (0-10, default: 0) */
+    cornerRounding?: number;
+}
+/**
+ * ZPL Driver for Zebra label printers
+ *
+ * @example
+ * ```typescript
+ * const zpl = new ZplDriver();
+ *
+ * const commands = zpl
+ *   .startFormat()
+ *   .labelHome(10, 10)
+ *   .text('Product Name', { x: 50, y: 50 })
+ *   .barcode('1234567890', { x: 50, y: 150, type: '128' })
+ *   .qrcode('https://example.com', { x: 300, y: 50 })
+ *   .print()
+ *   .getCommands();
+ * ```
+ */
+export declare class ZplDriver {
+    private commands;
+    private readonly logger;
+    /**
+     * Initialize ZPL driver with default settings
+     */
+    constructor();
+    /**
+     * Start label format (^XA)
+     */
+    startFormat(): this;
+    /**
+     * End label format (^XZ)
+     */
+    endFormat(): this;
+    /**
+     * Set label home position
+     * @param x - X position in dots
+     * @param y - Y position in dots
+     */
+    labelHome(x: number, y: number): this;
+    /**
+     * Set field data (^FD)
+     * @param content - Field content
+     */
+    fieldData(content: string): this;
+    /**
+     * Set field origin
+     * @param x - X position in dots
+     * @param y - Y position in dots
+     */
+    fieldOrigin(x: number, y: number): this;
+    /**
+     * Set print width
+     * @param width - Width in dots
+     */
+    printWidth(width: number): this;
+    /**
+     * Set label length
+     * @param length - Length in dots
+     */
+    labelLength(length: number): this;
+    /**
+     * Set label gap
+     * @param gap - Gap in dots
+     */
+    labelGap(gap: number): this;
+    /**
+     * Set print quantity
+     * @param quantity - Number of labels
+     */
+    quantity(quantity: number): this;
+    /**
+     * Add text to label
+     * @param content - Text content
+     * @param options - Text options
+     */
+    text(content: string, options?: ZplTextOptions): this;
+    /**
+     * Add text with explicit field origin
+     * @param content - Text content
+     * @param x - X position
+     * @param y - Y position
+     * @param font - Font name (default: 0)
+     * @param rotation - Rotation
+     */
+    textAt(content: string, x: number, y: number, font?: string, rotation?: 'N' | 'R' | 'I' | 'B'): this;
+    /**
+     * Use built-in font
+     * @param content - Text content
+     * @param x - X position
+     * @param y - Y position
+     * @param height - Character height (40-400)
+     * @param width - Character width (30-300)
+     */
+    font(content: string, x: number, y: number, height?: number, width?: number): this;
+    /**
+     * Add scalable font
+     * @param content - Text content
+     * @param x - X position
+     * @param y - Y position
+     * @param fontName - Font name (e.g., "0" for built-in, or loaded font name)
+     * @param fontHeight - Height multiplier
+     * @param fontWidth - Width multiplier
+     */
+    scalableText(content: string, x: number, y: number, fontName?: string, fontHeight?: number, fontWidth?: number): this;
+    /**
+     * Add barcode
+     * @param content - Barcode content
+     * @param options - Barcode options
+     */
+    barcode(content: string, options: ZplBarcodeOptions): this;
+    /**
+     * Add Code 128 barcode
+     * @param content - Barcode content
+     * @param x - X position
+     * @param y - Y position
+     * @param height - Barcode height
+     */
+    code128(content: string, x?: number, y?: number, height?: number): this;
+    /**
+     * Add Code 39 barcode
+     * @param content - Barcode content
+     * @param x - X position
+     * @param y - Y position
+     * @param height - Barcode height
+     */
+    code39(content: string, x?: number, y?: number, height?: number): this;
+    /**
+     * Add EAN-13 barcode
+     * @param content - Barcode content (12 or 13 digits)
+     * @param x - X position
+     * @param y - Y position
+     * @param height - Barcode height
+     */
+    ean13(content: string, x?: number, y?: number, height?: number): this;
+    /**
+     * Add QR code
+     * @param content - QR code content
+     * @param options - QR code options
+     */
+    qrcode(content: string, options?: ZplQRCodeOptions): this;
+    /**
+     * Add rectangle/border
+     * @param options - Box options
+     */
+    box(options: ZplBoxOptions): this;
+    /**
+     * Add line
+     * @param x1 - Start X
+     * @param y1 - Start Y
+     * @param x2 - End X
+     * @param y2 - End Y
+     * @param thickness - Line thickness
+     */
+    line(x1: number, y1: number, x2: number, y2: number, thickness?: number): this;
+    /**
+     * Add circle
+     * @param x - Center X
+     * @param y - Center Y
+     * @param diameter - Diameter in dots
+     * @param borderThickness - Border thickness
+     */
+    circle(x: number, y: number, diameter: number, borderThickness?: number): this;
+    /**
+     * Add diagonal line
+     * @param x - Start X
+     * @param y - Start Y
+     * @param width - Width
+     * @param height - Height
+     * @param thickness - Line thickness
+     */
+    diagonal(x: number, y: number, width: number, height: number, thickness?: number): this;
+    /**
+     * Add ellipse
+     * @param x - Center X
+     * @param y - Center Y
+     * @param width - Width
+     * @param height - Height
+     * @param borderThickness - Border thickness
+     */
+    ellipse(x: number, y: number, width: number, height: number, borderThickness?: number): this;
+    /**
+     * Add image from raw bitmap
+     * Note: For best results, use pre-processed images. This is a placeholder for future implementation.
+     * @param _x - X position (placeholder)
+     * @param _y - Y position (placeholder)
+     * @param _width - Image width (placeholder)
+     * @param _height - Image height (placeholder)
+     * @param _bitmap - Binary bitmap data (placeholder)
+     */
+    image(_x: number, _y: number, _width: number, _height: number, _bitmap: Uint8Array): this;
+    /**
+     * Set darkness/print density
+     * @param value - Darkness value (0-30, default: 15)
+     */
+    setDarkness(value?: number): this;
+    /**
+     * Set print speed
+     * @param speed - Speed: 1=slowest, 2-5=medium, 6-13=fast, 14=max
+     */
+    setSpeed(speed: number): this;
+    /**
+     * Print configuration label (useful for testing)
+     */
+    printConfigLabel(): this;
+    /**
+     * Calibrate sensors
+     */
+    calibrate(): this;
+    /**
+     * Reset printer
+     */
+    reset(): this;
+    /**
+     * Get all commands as string
+     */
+    getCommands(): string;
+    /**
+     * Get commands as buffer for sending to printer
+     */
+    getBuffer(): Uint8Array;
+    /**
+     * Get raw command list
+     */
+    getCommandList(): string[];
+    /**
+     * Clear all commands
+     */
+    resetCommands(): this;
+    /**
+     * Print label (end format)
+     */
+    print(quantity?: number): this;
+    /**
+     * Escape special characters in field data
+     */
+    private escapeField;
+}

package/dist/types/drivers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Printer Drivers Module
+ * 打印机驱动模块 - 支持多种打印机协议
+ */
+export { EscPos, type EscPosOptions } from './EscPos';
+export { GPrinterDriver, type GPrinterOptions } from './GPrinterDriver';
+export { TsplDriver, type LabelSize, type TextOptions, type BarcodeOptions, type QRCodeOptions, type BoxOptions, type LineOptions, } from './TsplDriver';
+export { ZplDriver, type ZplLabelSize, type ZplTextOptions, type ZplBarcodeOptions, type ZplQRCodeOptions, type ZplBoxOptions, } from './ZplDriver';
+export { CpclDriver, type CPCLPageSize, type CpclTextOptions, type CpclBarcodeOptions, type CpclQRCodeOptions, type CpclLineOptions, type CpclBoxOptions, } from './CpclDriver';

package/dist/types/encoding/gbk-lite.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 精简版 GBK 编码数据
+ * 包含约 3500 个最常用汉字，覆盖 99% 日常使用场景
+ * 使用二分查找，内存占用极低
+ */
+export declare const GBK_LITE: number[];
+export declare function binarySearchGbk(unicode: number): number | null;
+export declare function isInCommonRange(unicode: number): boolean;

package/dist/types/encoding/gbk-table.d.ts

@@ -1,53 +1,31 @@
 /**
- * GBK Encoding Table
+ * GBK Encoding Table - 懒加载版本
  *
- * This module provides character mapping tables for GBK, GB2312, and Big5 encodings.
- * GBK is a superset of GB2312 and covers most Chinese characters used in simplified Chinese.
- * Big5 is used for traditional Chinese characters.
+ * 优化策略：
+ * 1. 默认使用精简版编码表 (gbk-lite.ts，约 3500 常用字)
+ * 2. 遇到非常用字时动态加载完整编码表
+ * 3. 二分查找代替 Map，大幅减少内存占用
  *
- * GBK encoding uses double-byte encoding for Chinese characters:
- * - First byte: 0x81-0xFE
- * - Second byte: 0x40-0xFE (excluding 0x7F)
- *
- * 映射数据存储在 gbk-data.ts 中，运行时解码为 Map。
  * GBK: 23940 个字符映射
  * Big5: 13911 个字符映射
  */
-/**
- * Unicode to GBK mapping table
- * Maps Unicode code points to GBK byte pairs
- */
 export declare const unicodeToGbk: Map<number, number>;
-/**
- * GBK to Unicode mapping table
- * Maps GBK byte pairs to Unicode code points
- */
 export declare const gbkToUnicode: Map<number, number>;
-/**
- * Unicode to Big5 mapping table
- */
 export declare const unicodeToBig5: Map<number, number>;
-/**
- * Big5 to Unicode mapping table
- */
 export declare const big5ToUnicode: Map<number, number>;
 /**
  * Get GBK bytes for a Unicode character
- * @param unicode - Unicode code point
- * @returns GBK byte pair [high, low] or null if not found
+ * 先查精简表，查不到再懒加载完整表
  */
 export declare function getGbkBytes(unicode: number): [number, number] | null;
 /**
  * Get Unicode character from GBK bytes
- * @param high - High byte
- * @param low - Low byte
- * @returns Unicode code point or null if not found
+ * 懒加载完整表
  */
 export declare function getUnicodeFromGbk(high: number, low: number): number | null;
 /**
  * Get Big5 bytes for a Unicode character
- * @param unicode - Unicode code point
- * @returns Big5 byte pair or null if not found
+ * 懒加载完整表
  */
 export declare function getBig5Bytes(unicode: number): [number, number] | null;
 /**

package/dist/types/index.d.ts

@@ -1,22 +1,22 @@
 /**
  * Taro Bluetooth Print Library
- * A lightweight, high-performance Bluetooth printing library for Taro
+ * 轻量级、高性能的蓝牙打印库
  *
  * @packageDocumentation
  */
 export { BluetoothPrinter } from './core/BluetoothPrinter';
 export type { PrinterEvents } from './core/BluetoothPrinter';
 export { EventEmitter } from './core/EventEmitter';
-export { EscPos } from './drivers/EscPos';
-export { TsplDriver } from './drivers/TsplDriver';
-export type { LabelSize, TextOptions as TsplTextOptions, BarcodeOptions as TsplBarcodeOptions, QRCodeOptions as TsplQRCodeOptions, BoxOptions, LineOptions, } from './drivers/TsplDriver';
+export * from './drivers';
 export { TaroAdapter } from './adapters/TaroAdapter';
+export { AlipayAdapter } from './adapters/AlipayAdapter';
+export { BaiduAdapter } from './adapters/BaiduAdapter';
+export { ByteDanceAdapter } from './adapters/ByteDanceAdapter';
+export { WebBluetoothAdapter } from './adapters/WebBluetoothAdapter';
 export { AdapterFactory } from './adapters/AdapterFactory';
 export { BaseAdapter } from './adapters/BaseAdapter';
-export { WebBluetoothAdapter } from './adapters/WebBluetoothAdapter';
 export type { WebBluetoothRequestOptions } from './adapters/WebBluetoothAdapter';
-export { ConnectionManager } from './services/ConnectionManager';
-export type { ConnectionManagerConfig, ConnectionManagerEvents, } from './services/ConnectionManager';
+export * from './services';
 export { DeviceManager } from './device/DeviceManager';
 export type { BluetoothDevice, ScanOptions, DeviceManagerEvents } from './device/DeviceManager';
 export { PrintQueue } from './queue/PrintQueue';

package/dist/types/services/ConnectionManager.d.ts

@@ -54,7 +54,7 @@ export declare class ConnectionManager extends EventEmitter<ConnectionManagerEve
     private adapter;
     private deviceId;
     private state;
-    private readonly logger;
+    private readonly connLogger;
     private readonly config;
     private heartbeatTimer;
     private reconnectAttempts;

package/dist/types/services/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Services Module
+ * 服务模块 - 提供连接管理、命令构建、任务管理等功能
+ */
+export { ConnectionManager, type ConnectionManagerConfig, type ConnectionManagerEvents, } from './ConnectionManager';
+export { CommandBuilder } from './CommandBuilder';
+export { PrintJobManager } from './PrintJobManager';
+export * from './interfaces';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taro-bluetooth-print",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Taro 蓝牙打印库 v2.3 - 轻量级、高性能、跨平台支持微信、支付宝、百度、字节跳动小程序及H5 Web Bluetooth",
   "type": "module",
   "main": "dist/index.cjs.js",
@@ -13,6 +13,18 @@
       "require": "./dist/index.cjs.js",
       "default": "./dist/index.umd.js"
     },
+    "./core": {
+      "types": "./dist/types/core/index.d.ts",
+      "import": "./dist/core/index.es.js"
+    },
+    "./drivers": {
+      "types": "./dist/types/drivers/index.d.ts",
+      "import": "./dist/drivers/index.es.js"
+    },
+    "./adapters": {
+      "types": "./dist/types/adapters/index.d.ts",
+      "import": "./dist/adapters/index.es.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -49,13 +61,19 @@
   ],
   "author": "Agions",
   "license": "MIT",
-  "dependencies": {
-    "@tarojs/taro": "^4.1.11"
+  "peerDependencies": {
+    "@tarojs/taro": "^3.6.22"
+  },
+  "peerDependenciesMeta": {
+    "@tarojs/taro": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^20.14.8",
-    "@typescript-eslint/eslint-plugin": "^6.19.0",
-    "@typescript-eslint/parser": "^6.19.0",
+    "@types/web-bluetooth": "^0.0.21",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^8.56.0",
     "eslint-config-prettier": "^9.1.0",
@@ -67,7 +85,7 @@
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
-    "vitepress": "^1.0.0",
+    "vitepress": "^1.6.4",
     "vitest": "^4.0.18"
   },
   "sideEffects": false

package/src/adapters/BaseAdapter.ts

@@ -242,15 +242,13 @@ export abstract class MiniProgramAdapter extends BaseAdapter {
       this.logger.info('Device connected successfully');
 
       // Listen for connection state changes
-      this.getApi().onBLEConnectionStateChange(
-        (res: { deviceId: string; connected: boolean }) => {
-          if (res.deviceId === deviceId && !res.connected) {
-            this.logger.warn('Device disconnected unexpectedly');
-            this.updateState(PrinterState.DISCONNECTED);
-            this.cleanupDevice(deviceId);
-          }
+      this.getApi().onBLEConnectionStateChange((res: { deviceId: string; connected: boolean }) => {
+        if (res.deviceId === deviceId && !res.connected) {
+          this.logger.warn('Device disconnected unexpectedly');
+          this.updateState(PrinterState.DISCONNECTED);
+          this.cleanupDevice(deviceId);
         }
-      );
+      });
     } catch (error) {
       this.updateState(PrinterState.DISCONNECTED);
       this.logger.error('Connection failed:', error);

package/src/core/BluetoothPrinter.ts

@@ -60,7 +60,7 @@ export interface PrinterEvents {
  * ```
  */
 export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
-  private readonly logger = Logger.scope('BluetoothPrinter');
+  private readonly printerLogger = Logger.scope('BluetoothPrinter');
 
   /** Current printer state */
   public state: PrinterState = PrinterState.DISCONNECTED;
@@ -155,7 +155,7 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
     }
 
     this.emit('state-change', this.state);
-    this.logger.debug('State updated:', this.state);
+    this.printerLogger.debug('State updated:', this.state);
   }
 
   /**
@@ -171,13 +171,13 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
    * ```
    */
   async connect(deviceId: string): Promise<this> {
-    this.logger.info('Connecting to device:', deviceId);
+    this.printerLogger.info('Connecting to device:', deviceId);
 
     try {
       await this.connectionManager.connect(deviceId);
       this.updateState();
       this.emit('connected', deviceId);
-      this.logger.info('Connected successfully');
+      this.printerLogger.info('Connected successfully');
 
       return this;
     } catch (error) {
@@ -208,18 +208,18 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
   async disconnect(): Promise<void> {
     const deviceId = this.connectionManager.getDeviceId();
     if (!deviceId) {
-      this.logger.warn('Disconnect called but no device connected');
+      this.printerLogger.warn('Disconnect called but no device connected');
       return;
     }
 
-    this.logger.info('Disconnecting from device:', deviceId);
+    this.printerLogger.info('Disconnecting from device:', deviceId);
 
     try {
       await this.connectionManager.disconnect();
       this.printJobManager.cancel();
       this.updateState();
       this.emit('disconnected', deviceId);
-      this.logger.info('Disconnected successfully');
+      this.printerLogger.info('Disconnected successfully');
     } catch (error) {
       const printError = new BluetoothPrintError(
         ErrorCode.DEVICE_DISCONNECTED,
@@ -346,7 +346,7 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
   pause(): void {
     this.printJobManager.pause();
     this.updateState();
-    this.logger.info('Print job paused');
+    this.printerLogger.info('Print job paused');
   }
 
   /**
@@ -360,12 +360,12 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
    * ```
    */
   async resume(): Promise<void> {
-    this.logger.info('Resuming print job');
+    this.printerLogger.info('Resuming print job');
 
     try {
       await this.printJobManager.resume();
       this.updateState();
-      this.logger.info('Print job resumed');
+      this.printerLogger.info('Print job resumed');
     } catch (error) {
       const printError = new BluetoothPrintError(
         ErrorCode.PRINT_JOB_FAILED,
@@ -390,7 +390,7 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
     this.printJobManager.cancel();
     this.commandBuilder.clear();
     this.updateState();
-    this.logger.info('Print job cancelled');
+    this.printerLogger.info('Print job cancelled');
   }
 
   /**
@@ -439,7 +439,7 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
     }
 
     const buffer = this.commandBuilder.getBuffer();
-    this.logger.info(`Starting print job: ${buffer.length} bytes`);
+    this.printerLogger.info(`Starting print job: ${buffer.length} bytes`);
 
     // Clear the command buffer after getting the buffer for printing
     this.commandBuilder.clear();
@@ -462,14 +462,14 @@ export class BluetoothPrinter extends EventEmitter<PrinterEvents> {
 
       if (isPaused) {
         // Print job was paused
-        this.logger.info('Print job paused');
+        this.printerLogger.info('Print job paused');
       } else {
         // Print job completed successfully
         this.emit('print-complete');
-        this.logger.info('Print job completed successfully');
+        this.printerLogger.info('Print job completed successfully');
       }
     } catch (error) {
-      this.logger.error('Print job failed with error:', error);
+      this.printerLogger.error('Print job failed with error:', error);
       const printError =
         error instanceof BluetoothPrintError
           ? error