taro-bluetooth-print 2.3.0 → 2.3.1

package/src/drivers/GPrinterDriver.ts

@@ -0,0 +1,115 @@
+/**
+ * GPrinter (佳博) Driver
+ *
+ * 佳博 (GPrinter) 热敏打印机兼容 ESC/POS 指令集
+ * 大部分命令与标准 ESC/POS 兼容，部分特殊命令需要额外处理
+ */
+
+import { EscPos, type EscPosOptions } from './EscPos';
+
+/**
+ * GPrinter Driver for GiaoBao (佳博) thermal printers
+ *
+ * 佳博打印机基于 ESC/POS 指令集，此驱动扩展了标准 EscPos
+ * 添加了佳博特定的命令支持
+ *
+ * @example
+ * ```typescript
+ * import { GPrinterDriver } from 'taro-bluetooth-print';
+ *
+ * const driver = new GPrinterDriver();
+ * let commands = driver.init();
+ * commands = driver.text('Hello 佳博!', 'GBK');
+ * commands = driver.cut();
+ * ```
+ */
+
+/**
+ * GPrinter options (same as EscPosOptions)
+ */
+export type GPrinterOptions = EscPosOptions;
+
+export class GPrinterDriver extends EscPos {
+  /**
+   * 佳博打印机特定: 打开钱箱
+   * @param pin 钱箱引脚 (0 或 1, 默认 0)
+   */
+  openCashDrawer(pin = 0): Uint8Array[] {
+    // ESC p m t1 t2
+    // m = 0 or 1 (pin)
+    // t1 = 50 (on time)
+    // t2 = 200 (off time)
+    return [new Uint8Array([0x1b, 0x70, pin, 50, 200])];
+  }
+
+  /**
+   * 佳博打印机特定: 发送声响
+   * @param times 次数 (1-9)
+   * @param duration 持续时间
+   */
+  beep(times = 3, duration = 50): Uint8Array[] {
+    // ESC B n t
+    return [new Uint8Array([0x1b, 0x42, times, duration])];
+  }
+
+  /**
+   * 佳博打印机特定: 打印自检页
+   */
+  selfTest(): Uint8Array[] {
+    // ESC i
+    return [new Uint8Array([0x1b, 0x69])];
+  }
+
+  /**
+   * 佳博打印机特定: 获取状态
+   * 返回打印机状态字节
+   */
+  getStatus(): Uint8Array[] {
+    // DLE EOT n (n = 1-4 获取不同状态)
+    // 状态 1: 打印机状态
+    // 状态 2: 脱机状态
+    // 状态 3: 错误状态
+    // 状态 4: 纸张状态
+    const buffers: Uint8Array[] = [];
+    for (let i = 1; i <= 4; i++) {
+      buffers.push(new Uint8Array([0x10, 0x04, i]));
+    }
+    return buffers;
+  }
+
+  /**
+   * 佳博打印机特定: 设置字符代码页
+   * @param codePage 代码页编号
+   */
+  setCodePage(codePage: number): Uint8Array[] {
+    // ESC t n
+    return [new Uint8Array([0x1b, 0x74, codePage])];
+  }
+
+  /**
+   * 佳博打印机特定: 打印并走纸
+   * @param lines 走纸行数
+   */
+  printAndFeed(lines: number): Uint8Array[] {
+    // ESC d n
+    return [new Uint8Array([0x1b, 0x64, lines])];
+  }
+
+  /**
+   * 佳博打印机特定: 设置左边界
+   * @param n 左边界字符数
+   */
+  setLeftMargin(n: number): Uint8Array[] {
+    // ESC l n
+    return [new Uint8Array([0x1b, 0x6c, n])];
+  }
+
+  /**
+   * 佳博打印机特定: 设置打印区域宽度
+   * @param n 宽度 (字符数)
+   */
+  setPrintWidth(n: number): Uint8Array[] {
+    // ESC W n
+    return [new Uint8Array([0x1b, 0x57, n])];
+  }
+}

package/src/drivers/TsplDriver.ts

@@ -1,7 +1,7 @@
 /**
  * TSPL Driver
  * TSC Printer Language driver for label/barcode printers
- * 
+ *
  * TSPL is commonly used in thermal transfer label printers (TSC, Zebra, etc.)
  */
 
@@ -112,11 +112,11 @@ export interface LineOptions {
 
 /**
  * TSPL Driver for label printers
- * 
+ *
  * @example
  * ```typescript
  * const tspl = new TsplDriver();
- * 
+ *
  * const commands = tspl
  *   .size(60, 40)
  *   .gap(3)
@@ -216,14 +216,7 @@ export class TsplDriver {
    * @param options - Text options
    */
   text(content: string, options: TextOptions): this {
-    const {
-      x,
-      y,
-      font = 2,
-      rotation = 0,
-      xMultiplier = 1,
-      yMultiplier = 1,
-    } = options;
+    const { x, y, font = 2, rotation = 0, xMultiplier = 1, yMultiplier = 1 } = options;
 
     // TEXT x, y, "font", rotation, x-mul, y-mul, "content"
     this.commands.push(
@@ -269,14 +262,7 @@ export class TsplDriver {
    * @param options - QR code options
    */
   qrcode(content: string, options: QRCodeOptions): this {
-    const {
-      x,
-      y,
-      eccLevel = 'M',
-      cellWidth = 6,
-      mode = 'A',
-      rotation = 0,
-    } = options;
+    const { x, y, eccLevel = 'M', cellWidth = 6, mode = 'A', rotation = 0 } = options;
 
     // QRCODE x, y, ECC level, cell width, mode, rotation, "content"
     this.commands.push(
@@ -301,7 +287,7 @@ export class TsplDriver {
    */
   line(options: LineOptions): this {
     const { x1, y1, x2, y2, thickness = 2 } = options;
-    
+
     if (x1 === x2 || y1 === y2) {
       // Horizontal or vertical line - use BAR command
       const width = Math.abs(x2 - x1) || thickness;
@@ -309,7 +295,9 @@ export class TsplDriver {
       this.commands.push(`BAR ${Math.min(x1, x2)},${Math.min(y1, y2)},${width},${height}`);
     } else {
       // Diagonal line - use DIAGONAL command if supported
-      this.commands.push(`DIAGONAL ${x1},${y1},${thickness},${Math.sqrt((x2-x1)**2 + (y2-y1)**2)},${Math.atan2(y2-y1, x2-x1) * 180 / Math.PI}`);
+      this.commands.push(
+        `DIAGONAL ${x1},${y1},${thickness},${Math.sqrt((x2 - x1) ** 2 + (y2 - y1) ** 2)},${(Math.atan2(y2 - y1, x2 - x1) * 180) / Math.PI}`
+      );
     }
     return this;
   }