taro-bluetooth-print 2.3.0 → 2.3.1

package/src/encoding/gbk-table.ts

@@ -1,98 +1,120 @@
 /**
- * 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 个字符映射
  */
 
-import { GBK_DATA, BIG5_DATA } from './gbk-data';
+import { binarySearchGbk, isInCommonRange } from './gbk-lite';
 
-/**
- * Unicode to GBK mapping table
- * Maps Unicode code points to GBK byte pairs
- */
+// 懒加载完整编码数据
+let GBK_DATA: number[] | null = null;
+let BIG5_DATA: number[] | null = null;
+
+function loadFullData() {
+  if (!GBK_DATA) {
+    const data = require('./gbk-data');
+    GBK_DATA = data.GBK_DATA;
+    BIG5_DATA = data.BIG5_DATA;
+  }
+  return { GBK_DATA: GBK_DATA!, BIG5_DATA: BIG5_DATA! };
+}
+
+// Unicode to GBK mapping table
 export const unicodeToGbk: Map<number, number> = new Map();
 
-/**
- * GBK to Unicode mapping table
- * Maps GBK byte pairs to Unicode code points
- */
+// GBK to Unicode mapping table  
 export const gbkToUnicode: Map<number, number> = new Map();
 
-/**
- * Unicode to Big5 mapping table
- */
+// Unicode to Big5 mapping table
 export const unicodeToBig5: Map<number, number> = new Map();
 
-/**
- * Big5 to Unicode mapping table
- */
+// Big5 to Unicode mapping table
 export const big5ToUnicode: Map<number, number> = new Map();
 
-/**
- * Decode flat array mapping data into forward and reverse maps.
- * Array format: [unicode1, encoded1, unicode2, encoded2, ...]
- */
-function decodeMappings(
-  data: number[],
-  forwardMap: Map<number, number>,
-  reverseMap: Map<number, number>
-): void {
-  for (let i = 0; i < data.length; i += 2) {
-    const unicode = data[i]!;
-    const encoded = data[i + 1]!;
-    forwardMap.set(unicode, encoded);
-    reverseMap.set(encoded, unicode);
-  }
-}
-
-// Initialize mappings at module load time
-decodeMappings(GBK_DATA, unicodeToGbk, gbkToUnicode);
-decodeMappings(BIG5_DATA, unicodeToBig5, big5ToUnicode);
-
 /**
  * Get GBK bytes for a Unicode character
- * @param unicode - Unicode code point
- * @returns GBK byte pair [high, low] or null if not found
+ * 先查精简表，查不到再懒加载完整表
  */
 export function getGbkBytes(unicode: number): [number, number] | null {
-  const gbk = unicodeToGbk.get(unicode);
-  if (gbk !== undefined) {
+  // ASCII 直接返回
+  if (unicode >= 0x20 && unicode <= 0x7E) {
+    return [0, unicode];
+  }
+  
+  // 先查精简表
+  const gbk = binarySearchGbk(unicode);
+  if (gbk !== null) {
     return [(gbk >> 8) & 0xff, gbk & 0xff];
   }
+  
+  // 非常用字，懒加载完整表
+  if (isInCommonRange(unicode)) {
+    const { GBK_DATA } = loadFullData();
+    for (let i = 0; i < GBK_DATA.length; i += 2) {
+      if (GBK_DATA[i] === unicode) {
+        const gbkValue = GBK_DATA[i + 1];
+        if (gbkValue !== undefined) {
+          return [(gbkValue >> 8) & 0xff, gbkValue & 0xff];
+        }
+      }
+    }
+  }
+  
   return 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 function getUnicodeFromGbk(high: number, low: number): number | null {
   const gbk = (high << 8) | low;
-  return gbkToUnicode.get(gbk) ?? null;
+  
+  // 先查缓存
+  const cached = gbkToUnicode.get(gbk);
+  if (cached !== undefined) return cached;
+  
+  // 懒加载完整表
+  const { GBK_DATA } = loadFullData();
+  for (let i = 0; i < GBK_DATA.length; i += 2) {
+    if (GBK_DATA[i + 1] === gbk) {
+      const result = GBK_DATA[i];
+      return result ?? null;
+    }
+  }
+  
+  return null;
 }
 
 /**
  * Get Big5 bytes for a Unicode character
- * @param unicode - Unicode code point
- * @returns Big5 byte pair or null if not found
+ * 懒加载完整表
  */
 export function getBig5Bytes(unicode: number): [number, number] | null {
-  const big5 = unicodeToBig5.get(unicode);
-  if (big5 !== undefined) {
-    return [(big5 >> 8) & 0xff, big5 & 0xff];
+  // 先查缓存
+  const cached = unicodeToBig5.get(unicode);
+  if (cached !== undefined) {
+    const cachedValue = cached;
+    return [(cachedValue >> 8) & 0xff, cachedValue & 0xff];
+  }
+  
+  // 懒加载完整表
+  const { BIG5_DATA } = loadFullData();
+  for (let i = 0; i < BIG5_DATA.length; i += 2) {
+    if (BIG5_DATA[i] === unicode) {
+      const big5 = BIG5_DATA[i + 1];
+      if (big5 !== undefined) {
+        return [(big5 >> 8) & 0xff, big5 & 0xff];
+      }
+    }
   }
+  
   return null;
 }
 

package/src/index.ts

@@ -1,6 +1,6 @@
 /**
  * Taro Bluetooth Print Library
- * A lightweight, high-performance Bluetooth printing library for Taro
+ * 轻量级、高性能的蓝牙打印库
  *
  * @packageDocumentation
  */
@@ -10,37 +10,27 @@ export { BluetoothPrinter } from './core/BluetoothPrinter';
 export type { PrinterEvents } from './core/BluetoothPrinter';
 export { EventEmitter } from './core/EventEmitter';
 
-// Drivers
-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';
-
-// Adapters
+// Drivers - 打印机驱动
+export * from './drivers';
+
+// Adapters - 平台适配器
 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';
 
-// Services
-export { ConnectionManager } from './services/ConnectionManager';
-export type {
-  ConnectionManagerConfig,
-  ConnectionManagerEvents,
-} from './services/ConnectionManager';
+// Services - 服务层
+export * from './services';
 
-// Device Management
+// Device Management - 设备管理
 export { DeviceManager } from './device/DeviceManager';
 export type { BluetoothDevice, ScanOptions, DeviceManagerEvents } from './device/DeviceManager';
 
-// Print Queue
+// Print Queue - 打印队列
 export { PrintQueue } from './queue/PrintQueue';
 export type {
   PrintJob,
@@ -50,11 +40,11 @@ export type {
   PrintQueueEvents,
 } from './queue/PrintQueue';
 
-// Offline Cache
+// Offline Cache - 离线缓存
 export { OfflineCache } from './cache/OfflineCache';
 export type { CachedJob, CacheConfig, CacheStats } from './cache/OfflineCache';
 
-// Template Engine
+// Template Engine - 模板引擎
 export { TemplateEngine } from './template/TemplateEngine';
 export type {
   TemplateType,
@@ -65,32 +55,32 @@ export type {
   ValidationResult,
 } from './template/TemplateEngine';
 
-// Barcode Generator
+// Barcode Generator - 条码生成
 export { BarcodeGenerator, BarcodeFormat } from './barcode/BarcodeGenerator';
 export type { BarcodeOptions } from './barcode/BarcodeGenerator';
 
-// Text Formatter
+// Text Formatter - 文本格式化
 export { TextFormatter, TextAlign } from './formatter/TextFormatter';
 export type { TextStyle } from './formatter/TextFormatter';
 
-// Preview Renderer
+// Preview Renderer - 打印预览
 export { PreviewRenderer } from './preview/PreviewRenderer';
 export type { PreviewOptions, PreviewResult } from './preview/PreviewRenderer';
 
-// Encoding Service
+// Encoding - 编码服务
 export { EncodingService } from './encoding/EncodingService';
 export type { EncodingConfig } from './encoding/EncodingService';
 
-// Utilities
+// Utilities - 工具函数
 export { Logger, LogLevel } from './utils/logger';
 export { Encoding } from './utils/encoding';
 export { ImageProcessing } from './utils/image';
 export { PlatformType, detectPlatform, isPlatformSupported } from './utils/platform';
 
-// Error handling
+// Error handling - 错误处理
 export { BluetoothPrintError, ErrorCode } from './errors/BluetoothError';
 
-// Configuration
+// Configuration - 配置
 export { DEFAULT_CONFIG, mergeConfig } from './config/PrinterConfig';
 export type {
   PrinterConfig,
@@ -99,10 +89,10 @@ export type {
   LoggingConfig,
 } from './config/PrinterConfig';
 
-// Plugin System
+// Plugin System - 插件系统
 export { PluginManager } from './plugins/PluginManager';
 export { createLoggingPlugin, createRetryPlugin } from './plugins';
 export type { Plugin, PluginHooks, PluginOptions, PluginFactory } from './plugins/types';
 
-// Types
+// Types - 类型定义
 export * from './types';

package/src/plugins/PluginManager.ts

@@ -29,7 +29,9 @@ export class PluginManager {
       );
     }
 
-    this.logger.info(`Registering plugin: ${plugin.name}${plugin.version ? ` v${plugin.version}` : ''}`);
+    this.logger.info(
+      `Registering plugin: ${plugin.name}${plugin.version ? ` v${plugin.version}` : ''}`
+    );
 
     if (plugin.init) {
       await plugin.init(options);

package/src/plugins/builtin/LoggingPlugin.ts

@@ -65,10 +65,12 @@ export const createLoggingPlugin: PluginFactory = (options?: LoggingPluginOption
       afterPrint: (bytesSent: number) => {
         const elapsed = Date.now() - startTime;
         const speed = ((bytesSent / elapsed) * 1000).toFixed(2);
-        logger.info(`${formatTime()}Print complete: ${bytesSent} bytes in ${elapsed}ms (${speed} B/s)`);
+        logger.info(
+          `${formatTime()}Print complete: ${bytesSent} bytes in ${elapsed}ms (${speed} B/s)`
+        );
       },
 
-      onError: (error) => {
+      onError: error => {
         logger.error(`${formatTime()}Error [${error.code}]: ${error.message}`);
         return false; // Don't suppress the error
       },

package/src/plugins/builtin/RetryPlugin.ts

@@ -42,10 +42,7 @@ export const createRetryPlugin: PluginFactory = (options?: RetryPluginOptions):
   let currentDelay = opts.initialDelay;
 
   const shouldRetry = (error: BluetoothPrintError): boolean => {
-    return (
-      retryCount < opts.maxRetries &&
-      opts.retryableErrors.includes(error.code)
-    );
+    return retryCount < opts.maxRetries && opts.retryableErrors.includes(error.code);
   };
 
   const sleep = (ms: number): Promise<void> => {
@@ -77,14 +74,11 @@ export const createRetryPlugin: PluginFactory = (options?: RetryPluginOptions):
             `Retryable error occurred (attempt ${retryCount}/${opts.maxRetries}): ${error.code}`
           );
           logger.info(`Waiting ${currentDelay}ms before retry...`);
-          
+
           await sleep(currentDelay);
-          
+
           // Exponential backoff
-          currentDelay = Math.min(
-            currentDelay * opts.backoffMultiplier,
-            opts.maxDelay
-          );
+          currentDelay = Math.min(currentDelay * opts.backoffMultiplier, opts.maxDelay);
 
           // Note: Returning false means error is not suppressed
           // The actual retry logic would need to be implemented in the printer
@@ -93,9 +87,7 @@ export const createRetryPlugin: PluginFactory = (options?: RetryPluginOptions):
         }
 
         if (retryCount > 0) {
-          logger.error(
-            `Failed after ${retryCount} retries: ${error.code} - ${error.message}`
-          );
+          logger.error(`Failed after ${retryCount} retries: ${error.code} - ${error.message}`);
         }
 
         return false;
@@ -103,7 +95,9 @@ export const createRetryPlugin: PluginFactory = (options?: RetryPluginOptions):
     },
 
     init: () => {
-      logger.info(`Retry plugin initialized (max: ${opts.maxRetries}, delay: ${opts.initialDelay}ms)`);
+      logger.info(
+        `Retry plugin initialized (max: ${opts.maxRetries}, delay: ${opts.initialDelay}ms)`
+      );
     },
   };
 };

package/src/services/ConnectionManager.ts

@@ -71,7 +71,7 @@ export class ConnectionManager
   private adapter: IPrinterAdapter;
   private deviceId: string | null = null;
   private state: PrinterState = PrinterState.DISCONNECTED;
-  private readonly logger = Logger.scope('ConnectionManager');
+  private readonly connLogger = Logger.scope('ConnectionManager');
   private readonly config: Required<ConnectionManagerConfig>;
 
   // Heartbeat state
@@ -102,7 +102,7 @@ export class ConnectionManager
   private handleStateChange(newState: PrinterState): void {
     const previousState = this.state;
     this.state = newState;
-    this.logger.debug('State changed:', { from: previousState, to: newState });
+    this.connLogger.debug('State changed:', { from: previousState, to: newState });
     this.emit('state-change', newState);
 
     // Handle unexpected disconnection
@@ -112,7 +112,7 @@ export class ConnectionManager
       this.deviceId &&
       !this.isReconnecting
     ) {
-      this.logger.warn('Unexpected disconnection detected');
+      this.connLogger.warn('Unexpected disconnection detected');
       this.emit('disconnected', this.deviceId);
       this.stopHeartbeat();
 
@@ -127,7 +127,7 @@ export class ConnectionManager
    * Connects to a Bluetooth device
    */
   async connect(deviceId: string, options?: { retries?: number; timeout?: number }): Promise<void> {
-    this.logger.info('Connecting to device:', deviceId);
+    this.connLogger.info('Connecting to device:', deviceId);
 
     const { retries = 0, timeout = this.config.connectionTimeout } = options || {};
     let attempts = 0;
@@ -159,7 +159,7 @@ export class ConnectionManager
         this.state = PrinterState.CONNECTED;
         this.emit('state-change', PrinterState.CONNECTED);
         this.emit('connected', deviceId);
-        this.logger.info('Connected successfully');
+        this.connLogger.info('Connected successfully');
 
         // Start heartbeat if enabled
         if (this.config.heartbeatEnabled) {
@@ -181,11 +181,11 @@ export class ConnectionManager
                   `Connection failed after ${attempts} attempts`,
                   error as Error
                 );
-          this.logger.error('Connection failed:', printError);
+          this.connLogger.error('Connection failed:', printError);
           this.emit('error', printError);
           throw printError;
         }
-        this.logger.warn(`Connection attempt ${attempts}/${retries} failed, retrying...`, error);
+        this.connLogger.warn(`Connection attempt ${attempts}/${retries} failed, retrying...`, error);
         await new Promise(resolve => setTimeout(resolve, 1000));
       }
     }
@@ -200,12 +200,12 @@ export class ConnectionManager
     this.isReconnecting = false;
 
     if (!this.deviceId) {
-      this.logger.warn('Disconnect called but no device connected');
+      this.connLogger.warn('Disconnect called but no device connected');
       return;
     }
 
     const deviceId = this.deviceId;
-    this.logger.info('Disconnecting from device:', deviceId);
+    this.connLogger.info('Disconnecting from device:', deviceId);
 
     try {
       await this.adapter.disconnect(deviceId);
@@ -213,14 +213,14 @@ export class ConnectionManager
       this.state = PrinterState.DISCONNECTED;
       this.emit('state-change', PrinterState.DISCONNECTED);
       this.emit('disconnected', deviceId);
-      this.logger.info('Disconnected successfully');
+      this.connLogger.info('Disconnected successfully');
     } catch (error) {
       const printError = new BluetoothPrintError(
         ErrorCode.DEVICE_DISCONNECTED,
         'Disconnect failed',
         error as Error
       );
-      this.logger.error('Disconnect failed:', printError);
+      this.connLogger.error('Disconnect failed:', printError);
       this.emit('error', printError);
       throw printError;
     }
@@ -236,7 +236,7 @@ export class ConnectionManager
       this.checkHeartbeat();
     }, this.config.heartbeatInterval);
 
-    this.logger.debug('Heartbeat started with interval:', this.config.heartbeatInterval);
+    this.connLogger.debug('Heartbeat started with interval:', this.config.heartbeatInterval);
   }
 
   /**
@@ -246,7 +246,7 @@ export class ConnectionManager
     if (this.heartbeatTimer) {
       clearInterval(this.heartbeatTimer);
       this.heartbeatTimer = null;
-      this.logger.debug('Heartbeat stopped');
+      this.connLogger.debug('Heartbeat stopped');
     }
   }
 
@@ -262,12 +262,12 @@ export class ConnectionManager
       const isConnected = this.isConnected();
 
       if (isConnected) {
-        this.logger.debug('Heartbeat OK');
+        this.connLogger.debug('Heartbeat OK');
       } else {
         this.handleHeartbeatLost();
       }
     } catch (error) {
-      this.logger.warn('Heartbeat check failed:', error);
+      this.connLogger.warn('Heartbeat check failed:', error);
       this.handleHeartbeatLost();
     }
   }
@@ -278,7 +278,7 @@ export class ConnectionManager
   private handleHeartbeatLost(): void {
     if (!this.deviceId) return;
 
-    this.logger.warn('Heartbeat lost for device:', this.deviceId);
+    this.connLogger.warn('Heartbeat lost for device:', this.deviceId);
     this.emit('heartbeat-lost', this.deviceId);
     this.stopHeartbeat();
 
@@ -317,7 +317,7 @@ export class ConnectionManager
     const deviceId = this.deviceId;
 
     if (this.reconnectAttempts > this.config.maxReconnectAttempts) {
-      this.logger.error('Max reconnect attempts reached');
+      this.connLogger.error('Max reconnect attempts reached');
       this.isReconnecting = false;
       this.emit('reconnect-failed', {
         deviceId,
@@ -330,7 +330,7 @@ export class ConnectionManager
       return;
     }
 
-    this.logger.info(
+    this.connLogger.info(
       `Reconnect attempt ${this.reconnectAttempts}/${this.config.maxReconnectAttempts}`
     );
     this.emit('reconnecting', {
@@ -345,7 +345,7 @@ export class ConnectionManager
     this.adapter
       .connect(deviceId)
       .then(() => {
-        this.logger.info('Reconnected successfully');
+        this.connLogger.info('Reconnected successfully');
         this.isReconnecting = false;
         this.reconnectAttempts = 0;
         this.state = PrinterState.CONNECTED;
@@ -357,7 +357,7 @@ export class ConnectionManager
         }
       })
       .catch(error => {
-        this.logger.warn(`Reconnect attempt ${this.reconnectAttempts} failed:`, error);
+        this.connLogger.warn(`Reconnect attempt ${this.reconnectAttempts} failed:`, error);
 
         this.reconnectTimer = setTimeout(() => {
           this.attemptReconnect();
@@ -434,7 +434,7 @@ export class ConnectionManager
     }
 
     if (this.isReconnecting) {
-      this.logger.warn('Reconnect already in progress');
+      this.connLogger.warn('Reconnect already in progress');
       return;
     }
 
@@ -448,7 +448,7 @@ export class ConnectionManager
     this.clearReconnectTimer();
     this.isReconnecting = false;
     this.reconnectAttempts = 0;
-    this.logger.info('Reconnect stopped');
+    this.connLogger.info('Reconnect stopped');
   }
 
   /**

package/src/services/index.ts

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