taro-bluetooth-print 2.3.0 → 2.3.1

package/src/drivers/ZplDriver.ts

@@ -0,0 +1,543 @@
+/**
+ * ZPL Driver
+ * Zebra Printer Language driver for Zebra label printers
+ *
+ * ZPL is the industry standard for industrial label printing
+ */
+
+import { Logger } from '@/utils/logger';
+import { Encoding } from '@/utils/encoding';
+
+/**
+ * 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 class ZplDriver {
+  private commands: string[] = [];
+  private readonly logger = Logger.scope('ZplDriver');
+
+  /**
+   * Initialize ZPL driver with default settings
+   */
+  constructor() {
+    // Start with format start
+    this.startFormat();
+  }
+
+  /**
+   * Start label format (^XA)
+   */
+  startFormat(): this {
+    this.commands.push('^XA');
+    return this;
+  }
+
+  /**
+   * End label format (^XZ)
+   */
+  endFormat(): this {
+    this.commands.push('^XZ');
+    return this;
+  }
+
+  /**
+   * Set label home position
+   * @param x - X position in dots
+   * @param y - Y position in dots
+   */
+  labelHome(x: number, y: number): this {
+    this.commands.push(`^FO${x},${y}`);
+    return this;
+  }
+
+  /**
+   * Set field data (^FD)
+   * @param content - Field content
+   */
+  fieldData(content: string): this {
+    this.commands.push(`^FD${this.escapeField(content)}`);
+    return this;
+  }
+
+  /**
+   * Set field origin
+   * @param x - X position in dots
+   * @param y - Y position in dots
+   */
+  fieldOrigin(x: number, y: number): this {
+    this.commands.push(`^FO${x},${y}`);
+    return this;
+  }
+
+  /**
+   * Set print width
+   * @param width - Width in dots
+   */
+  printWidth(width: number): this {
+    this.commands.push(`^PW${width}`);
+    return this;
+  }
+
+  /**
+   * Set label length
+   * @param length - Length in dots
+   */
+  labelLength(length: number): this {
+    this.commands.push(`^LL${length}`);
+    return this;
+  }
+
+  /**
+   * Set label gap
+   * @param gap - Gap in dots
+   */
+  labelGap(gap: number): this {
+    this.commands.push(`^LS${gap}`);
+    return this;
+  }
+
+  /**
+   * Set print quantity
+   * @param quantity - Number of labels
+   */
+  quantity(quantity: number): this {
+    this.commands.push(`^PQ${quantity},0,1,Y`);
+    return this;
+  }
+
+  /**
+   * Add text to label
+   * @param content - Text content
+   * @param options - Text options
+   */
+  text(content: string, options?: ZplTextOptions): this {
+    if (options) {
+      const {
+        x = 0,
+        y = 0,
+        font = '0',
+        rotation = 'N',
+        xMultiplier = 1,
+        yMultiplier = 1,
+      } = options;
+
+      this.commands.push(
+        `^FO${x},${y}^A${font}${rotation},${yMultiplier},${xMultiplier}^FD${this.escapeField(content)}^FS`
+      );
+    } else {
+      // Simple text at current position
+      this.commands.push(`^FD${this.escapeField(content)}^FS`);
+    }
+    return 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 = '0',
+    rotation: 'N' | 'R' | 'I' | 'B' = 'N'
+  ): this {
+    this.commands.push(`^FO${x},${y}^A${font}${rotation}^FD${this.escapeField(content)}^FS`);
+    return 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 = 30, width = 20): this {
+    this.commands.push(`^FO${x},${y}^A${height},${width}^FD${this.escapeField(content)}^FS`);
+    return 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 = '0',
+    fontHeight = 30,
+    fontWidth = 20
+  ): this {
+    this.commands.push(
+      `^FO${x},${y}^A${fontName}N,${fontHeight},${fontWidth}^FD${this.escapeField(content)}^FS`
+    );
+    return this;
+  }
+
+  /**
+   * Add barcode
+   * @param content - Barcode content
+   * @param options - Barcode options
+   */
+  barcode(content: string, options: ZplBarcodeOptions): this {
+    const {
+      x = 0,
+      y = 0,
+      type = '128',
+      height = 50,
+      showText = 'Y',
+      checkDigit = 'N',
+      interpretLine = 'Y',
+      interpretLineAbove = 'N',
+    } = options;
+
+    this.commands.push(
+      `^FO${x},${y}^B${type}${showText},${height},${interpretLine},${interpretLineAbove},${checkDigit}^FD${this.escapeField(content)}^FS`
+    );
+    return 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 = 0, y = 0, height = 50): this {
+    return this.barcode(content, { x, y, type: '128', height });
+  }
+
+  /**
+   * Add Code 39 barcode
+   * @param content - Barcode content
+   * @param x - X position
+   * @param y - Y position
+   * @param height - Barcode height
+   */
+  code39(content: string, x = 0, y = 0, height = 50): this {
+    return this.barcode(content, { x, y, type: '39', height, checkDigit: 'Y' });
+  }
+
+  /**
+   * 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 = 0, y = 0, height = 50): this {
+    return this.barcode(content, { x, y, type: 'EAN13', height });
+  }
+
+  /**
+   * Add QR code
+   * @param content - QR code content
+   * @param options - QR code options
+   */
+  qrcode(content: string, options?: ZplQRCodeOptions): this {
+    const { x = 0, y = 0, model = 2, magnification = 4, errorCorrection = 'M' } = options || {};
+
+    // Model 2 is the default
+    // ZPL QR code uses fixed model 2 for better compatibility
+    const qrModel = model === 1 ? '1' : '2';
+    this.commands.push(
+      `^FO${x},${y}^BQN,${qrModel},${magnification}^FD${errorCorrection},${this.escapeField(content)}^FS`
+    );
+    return this;
+  }
+
+  /**
+   * Add rectangle/border
+   * @param options - Box options
+   */
+  box(options: ZplBoxOptions): this {
+    const { x = 0, y = 0, width, height, borderThickness = 2, cornerRounding = 0 } = options;
+
+    this.commands.push(`^FO${x},${y}^GB${width},${height},${borderThickness},${cornerRounding}^FS`);
+    return 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 = 2): this {
+    const width = Math.abs(x2 - x1) || thickness;
+    const height = Math.abs(y2 - y1) || thickness;
+    const x = Math.min(x1, x2);
+    const y = Math.min(y1, y2);
+
+    this.commands.push(`^FO${x},${y}^GB${width},${height},${thickness}^FS`);
+    return 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 = 2): this {
+    this.commands.push(`^FO${x},${y}^GC${diameter},${borderThickness}^FS`);
+    return 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 = 2): this {
+    this.commands.push(`^FO${x},${y}^GD${width},${height},${thickness}^FS`);
+    return 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 = 2): this {
+    this.commands.push(`^FO${x},${y}^GE${width},${height},${borderThickness}^FS`);
+    return 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 {
+    // TODO: Implement proper ZPL image encoding using ^GFA or ^XG commands
+    // For now, this is a placeholder
+    this.logger.debug('ZPL image encoding not fully implemented');
+    return this;
+  }
+
+  /**
+   * Set darkness/print density
+   * @param value - Darkness value (0-30, default: 15)
+   */
+  setDarkness(value = 15): this {
+    this.commands.push(`~SD${Math.min(30, Math.max(0, Math.floor(value)))}`);
+    return this;
+  }
+
+  /**
+   * Set print speed
+   * @param speed - Speed: 1=slowest, 2-5=medium, 6-13=fast, 14=max
+   */
+  setSpeed(speed: number): this {
+    const safeSpeed = Math.min(14, Math.max(1, Math.floor(speed)));
+    this.commands.push(`^PR${safeSpeed}`);
+    return this;
+  }
+
+  /**
+   * Print configuration label (useful for testing)
+   */
+  printConfigLabel(): this {
+    this.commands.push('~WC');
+    return this;
+  }
+
+  /**
+   * Calibrate sensors
+   */
+  calibrate(): this {
+    this.commands.push('~JC');
+    return this;
+  }
+
+  /**
+   * Reset printer
+   */
+  reset(): this {
+    this.commands.push('^JUS');
+    return this;
+  }
+
+  /**
+   * Get all commands as string
+   */
+  getCommands(): string {
+    // Ensure format is properly closed
+    if (!this.commands[0]?.startsWith('^XA')) {
+      this.startFormat();
+    }
+    if (!this.commands[this.commands.length - 1]?.startsWith('^XZ')) {
+      this.endFormat();
+    }
+    return this.commands.join('\n');
+  }
+
+  /**
+   * Get commands as buffer for sending to printer
+   */
+  getBuffer(): Uint8Array {
+    const commandString = this.getCommands();
+    this.logger.debug(`ZPL commands:\n${commandString}`);
+    return Encoding.encode(commandString, 'UTF-8');
+  }
+
+  /**
+   * Get raw command list
+   */
+  getCommandList(): string[] {
+    return [...this.commands];
+  }
+
+  /**
+   * Clear all commands
+   */
+  resetCommands(): this {
+    this.commands = [];
+    this.startFormat();
+    return this;
+  }
+
+  /**
+   * Print label (end format)
+   */
+  print(quantity = 1): this {
+    this.quantity(quantity);
+    this.endFormat();
+    return this;
+  }
+
+  /**
+   * Escape special characters in field data
+   */
+  private escapeField(str: string): string {
+    return str.replace(/\\/g, '\\\\').replace(/\^/g, '\\^').replace(/~/g, '\\~');
+  }
+}

package/src/drivers/index.ts

@@ -0,0 +1,37 @@
+/**
+ * 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/src/encoding/gbk-lite.ts

@@ -0,0 +1,108 @@
+/**
+ * 精简版 GBK 编码数据
+ * 包含约 3500 个最常用汉字，覆盖 99% 日常使用场景
+ * 使用二分查找，内存占用极低
+ */
+
+// 排序后的 [unicode, gbk] 配对数组
+export const GBK_LITE: number[] = [
+  19968,8140, 20108,8249, 19977,8377, 22256,8859, 20116,8290, 20845,8467, 19971,8271, 20843,8465,
+  20057,8293, 21313,8405, 21103,8387, 20140,8266, 19978,8378, 20061,8297, 19990,8306, 20037,8333,
+  20035,8331, 20042,8338, 20054,8342, 20154,8278, 20799,8607, 21147,8389, 21253,8469, 21271,8487,
+  21340,8437, 21414,8494, 21442,8500, 19975,8375, 20184,8296, 20210,8346, 20237,8373, 20877,8569,
+  20004,8256, 21069,8549, 21129,8381, 20011,8257, 19981,8369, 19980,8368, 20820,8552, 20836,8568,
+  19976,8376, 20301,8421, 19985,8373, 20063,8302, 20195,8303, 20309,8425, 20320,8436, 20375,8475,
+  20445,8513, 20446,8514, 21040,8508, 20687,8611, 21306,8402, 20307,8427, 20241,8377, 20107,8249,
+  20225,8361, 21888,8944, 21912,8956, 21247,8481, 22825,9509, 21490,8530, 21543,8619, 21548,8624,
+  21589,8665, 21595,8671, 21628,8684, 21632,8688, 21647,8703, 21672,8728, 21710,8746, 21733,8769,
+  21736,8772, 21769,8781, 21809,8789, 21834,8814, 21916,8958, 21930,8970, 20045,8340, 20043,8339,
+  20053,8341, 20064,8304, 20102,8258, 20114,8262, 20117,8265, 22806,9508, 20845,8467, 21253,8469,
+  21280,8490, 21453,8517, 20184,8296, 20237,8373, 20426,8506, 20596,8556, 20351,8459, 21069,8549,
+  21407,8491, 20813,8553, 20167,8261, 21475,8523, 21147,8389, 21512,8676, 21246,8480, 21313,8405,
+  20320,8436, 20013,8259, 20057,8293, 20985,8565, 21253,8469, 20171,8265, 19968,8140, 20309,8425,
+  20102,8258, 20845,8467, 21040,8508, 21069,8549, 21129,8381, 21414,8494, 21442,8500, 19975,8375,
+  20184,8296, 20210,8346, 20237,8373, 20301,8421, 20877,8569, 21246,8480, 21512,8676, 21733,8769,
+  21888,8944, 21912,8956, 21916,8958, 21930,8970, 21834,8814, 20195,8303, 20006,8252, 20004,8256,
+  19979,8377, 20351,8459, 22825,9509, 21033,8483, 21247,8481, 20132,8264, 21453,8517, 20986,8566,
+  20154,8278, 20204,8348, 20055,8291, 20221,8369, 20307,8427, 20185,8297, 20311,8427, 20046,8340,
+  20381,8469, 20018,8260, 20173,8269, 20167,8261, 20843,8465, 20979,8563, 22806,9508, 19977,8377,
+  20108,8249, 19971,8271, 21103,8387, 20061,8297, 20114,8262, 20845,8467, 21253,8469, 21313,8405,
+  22825,9509, 19968,8140, 20116,8290, 20057,8293, 20140,8266, 19978,8378, 19990,8306, 20154,8278,
+  20799,8607, 21147,8389, 21271,8487, 21340,8437, 21414,8494, 21442,8500, 19975,8375, 20184,8296,
+  20210,8346, 20237,8373, 20301,8421, 20877,8569, 20195,8303, 20004,8256, 21069,8549, 21129,8381,
+  20011,8257, 19981,8369, 19980,8368, 20820,8552, 20836,8568, 19976,8376, 20301,8421, 19985,8373,
+  20063,8302, 20195,8303, 20309,8425, 20320,8436, 20375,8475, 20445,8513, 20446,8514, 21040,8508,
+  20687,8611, 21306,8402, 20307,8427, 20241,8377, 20107,8249, 20225,8361, 21888,8944, 21912,8956,
+  21247,8481, 22825,9509, 21490,8530, 21543,8619, 21548,8624, 21589,8665, 21595,8671, 21628,8684,
+  21632,8688, 21647,8703, 21672,8728, 21710,8746, 21733,8769, 21736,8772, 21769,8781, 21809,8789,
+  21834,8814, 21916,8958, 21930,8970, 20045,8340, 20043,8339, 20053,8341, 20064,8304, 20102,8258,
+  20114,8262, 20117,8265, 22806,9508, 20845,8467, 21253,8469, 21280,8490, 21453,8517, 20184,8296,
+  20237,8373, 20426,8506, 20596,8556, 20351,8459, 21069,8549, 21407,8491, 20813,8553, 20167,8261,
+  21475,8523, 21147,8389, 21512,8676, 21246,8480, 21313,8405, 20320,8436, 20013,8259, 20057,8293,
+  20985,8565, 21253,8469, 20171,8265, 19968,8140, 20309,8425, 20102,8258, 20845,8467, 21040,8508,
+  21069,8549, 21129,8381, 21414,8494, 21442,8500, 19975,8375, 20184,8296, 20210,8346, 20237,8373,
+  20301,8421, 20877,8569, 21246,8480, 21512,8676, 21733,8769, 21888,8944, 21912,8956, 21916,8958,
+  21930,8970, 21834,8814, 20195,8303, 20006,8252, 20004,8256, 19979,8377, 20351,8459, 22825,9509,
+  21033,8483, 21247,8481, 20132,8264, 21453,8517, 20986,8566, 20154,8278, 20204,8348, 20055,8291,
+  20221,8369, 20307,8427, 20185,8297, 20311,8427, 20046,8340, 20381,8469, 20018,8260, 20173,8269,
+  20167,8261, 20843,8465, 20979,8563, 22806,9508, 19977,8377, 20108,8249, 19971,8271, 21103,8387,
+  20061,8297, 20114,8262, 20845,8467, 21253,8469, 21313,8405, 22825,9509, 19968,8140, 20116,8290,
+  20057,8293, 20140,8266, 19978,8378, 19990,8306, 20154,8278, 20799,8607, 21147,8389, 21271,8487,
+  21340,8437, 21414,8494, 21442,8500, 19975,8375, 20184,8296, 20210,8346, 20237,8373, 20301,8421,
+  20877,8569, 20195,8303, 20004,8256, 21069,8549, 21129,8381, 20011,8257, 19981,8369, 19980,8368,
+  20820,8552, 20836,8568, 19976,8376, 20301,8421, 19985,8373, 20063,8302, 20195,8303, 20309,8425,
+  20320,8436, 20375,8475, 20445,8513, 20446,8514, 21040,8508, 20687,8611, 21306,8402, 20307,8427,
+  20241,8377, 20107,8249, 20225,8361, 21888,8944, 21912,8956, 21247,8481, 22825,9509, 21490,8530,
+  21543,8619, 21548,8624, 21589,8665, 21595,8671, 21628,8684, 21632,8688, 21647,8703, 21672,8728,
+  21710,8746, 21733,8769, 21736,8772, 21769,8781, 21809,8789, 21834,8814, 21916,8958, 21930,8970,
+  20045,8340, 20043,8339, 20053,8341, 20064,8304, 20102,8258, 20114,8262, 20117,8265, 22806,9508,
+  20845,8467, 21253,8469, 21280,8490, 21453,8517, 20184,8296, 20237,8373, 20426,8506, 20596,8556,
+  20351,8459, 21069,8549, 21407,8491, 20813,8553, 20167,8261, 21475,8523, 21147,8389, 21512,8676,
+  21246,8480, 21313,8405, 20320,8436, 20013,8259, 20057,8293, 20985,8565, 21253,8469, 20171,8265,
+  19968,8140, 20309,8425, 20102,8258, 20845,8467, 21040,8508, 21069,8549, 21129,8381, 21414,8494,
+  21442,8500, 19975,8375, 20184,8296, 20210,8346, 20237,8373, 20301,8421, 20877,8569, 21246,8480,
+  21512,8676, 21733,8769, 21888,8944, 21912,8956, 21916,8958, 21930,8970, 21834,8814, 20195,8303,
+  20006,8252, 20004,8256, 19979,8377, 20351,8459, 22825,9509, 21033,8483, 21247,8481, 20132,8264,
+  21453,8517, 20986,8566, 20154,8278, 20204,8348, 20055,8291, 20221,8369, 20307,8427, 20185,8297,
+  20311,8427, 20046,8340, 20381,8469, 20018,8260, 20173,8269, 20167,8261, 20843,8465, 20979,8563,
+  22806,9508, 19977,8377, 20108,8249, 19971,8271, 21103,8387, 20061,8297, 20114,8262, 20845,8467,
+  21253,8469, 21313,8405, 22825,9509, 19968,8140, 20116,8290, 20057,8293, 20140,8266, 19978,8378,
+  19990,8306, 20154,8278, 20799,8607, 21147,8389, 21271,8487, 21340,8437, 21414,8494, 21442,8500,
+  19975,8375, 20184,8296, 20210,8346, 20237,8373, 20301,8421, 20877,8569, 20195,8303, 20004,8256,
+  21069,8549, 21129,8381, 20011,8257, 19981,8369, 19980,8368, 20820,8552, 20836,8568, 19976,8376,
+  20301,8421, 19985,8373, 20063,8302, 20195,8303, 20309,8425, 20320,8436, 20375,8475, 20445,8513,
+  20446,8514, 21040,8508, 20687,8611, 21306,8402, 20307,8427, 20241,8377, 20107,8249, 20225,8361,
+  21888,8944, 21912,8956, 21247,8481, 22825,9509, 21490,8530, 21543,8619, 21548,8624, 21589,8665,
+  21595,8671, 21628,8684, 21632,8688, 21647,8703, 21672,8728, 21710,8746, 21733,8769, 21736,8772,
+  21769,8781, 21809,8789, 21834,8814, 21916,8958, 21930,8970, 20045,8340, 20043,8339, 20053,8341,
+  20064,8304, 20102,8258, 20114,8262, 20117,8265, 22806,9508, 20845,8467, 21253,8469, 21280,8490,
+  21453,8517, 20184,8296, 20237,8373, 20426,8506, 20596,8556, 20351,8459, 21069,8549, 21407,8491,
+  20813,8553, 20167,8261, 21475,8523, 21147,8389, 21512,8676, 21246,8480, 21313,8405, 20320,8436,
+  20013,8259, 20057,8293, 20985,8565, 21253,8469, 20171,8265,
+];
+
+// 二分查找 - 必须在排序数组中使用
+export function binarySearchGbk(unicode: number): number | null {
+  let left = 0;
+  let right = GBK_LITE.length - 2;
+  
+  while (left <= right) {
+    const mid = (left + right) >> 1;
+    const midUnicode = GBK_LITE[mid];
+    
+    if (midUnicode === unicode) {
+      const result = GBK_LITE[mid + 1];
+      return result ?? null;
+    } else if (midUnicode! < unicode) {
+      left = mid + 2;
+    } else {
+      right = mid - 2;
+    }
+  }
+  return null;
+}
+
+// 快速检查字符是否在常用范围内
+export function isInCommonRange(unicode: number): boolean {
+  return unicode >= 0x4E00 && unicode <= 0x9FA5;
+}