taro-bluetooth-print 2.2.1 → 2.3.1

package/dist/types/adapters/AdapterFactory.d.ts

@@ -1,6 +1,5 @@
 import { IPrinterAdapter } from '../types';
 import { PlatformType } from '../utils/platform';
-
 /**
  * Adapter factory class
  */

package/dist/types/adapters/AlipayAdapter.d.ts

@@ -1,5 +1,4 @@
 import { MiniProgramAdapter, MiniProgramBLEApi } from './BaseAdapter';
-
 /**
  * Alipay Bluetooth Low Energy adapter
  *

package/dist/types/adapters/BaiduAdapter.d.ts

@@ -1,5 +1,4 @@
 import { MiniProgramAdapter, MiniProgramBLEApi } from './BaseAdapter';
-
 /**
  * Baidu Bluetooth Low Energy adapter
  *

package/dist/types/adapters/BaseAdapter.d.ts

@@ -1,5 +1,4 @@
 import { IPrinterAdapter, IAdapterOptions, PrinterState } from '../types';
-
 /**
  * Service information cache entry
  */

package/dist/types/adapters/ByteDanceAdapter.d.ts

@@ -1,5 +1,4 @@
 import { MiniProgramAdapter, MiniProgramBLEApi } from './BaseAdapter';
-
 /**
  * ByteDance Bluetooth Low Energy adapter
  *

package/dist/types/adapters/TaroAdapter.d.ts

@@ -1,5 +1,4 @@
 import { MiniProgramAdapter, MiniProgramBLEApi } from './BaseAdapter';
-
 /**
  * Taro Bluetooth Low Energy adapter
  *

package/dist/types/adapters/WebBluetoothAdapter.d.ts

@@ -1,6 +1,5 @@
 import { IAdapterOptions } from '../types';
 import { BaseAdapter } from './BaseAdapter';
-
 /**
  * Request device options for Web Bluetooth
  */

package/dist/types/config/PrinterConfig.d.ts

@@ -1,5 +1,4 @@
 import { LogLevel } from '../utils/logger';
-
 /**
  * Adapter configuration options
  */

package/dist/types/core/BluetoothPrinter.d.ts

@@ -2,7 +2,6 @@ import { IAdapterOptions, IQrOptions, PrinterState, IPrinterAdapter } from '../t
 import { EventEmitter } from './EventEmitter';
 import { BluetoothPrintError } from '../errors/BluetoothError';
 import { IConnectionManager, IPrintJobManager, ICommandBuilder } from '../services/interfaces';
-
 /**
  * Event types emitted by BluetoothPrinter
  */
@@ -51,7 +50,7 @@ export interface PrinterEvents {
  * ```
  */
 export declare class BluetoothPrinter extends EventEmitter<PrinterEvents> {
-    private readonly logger;
+    private readonly printerLogger;
     /** Current printer state */
     state: PrinterState;
     /** Connection manager instance */

package/dist/types/core/EventEmitter.d.ts

@@ -1,32 +1,12 @@
-/**
- * Type-safe event emitter for pub/sub pattern
- *
- * @template T - Event map type with event names as keys and payload types as values
- *
- * @example
- * ```typescript
- * interface MyEvents {
- *   'connected': { deviceId: string };
- *   'error': Error;
- *   'progress': { current: number; total: number };
- *   'ready': void;
- * }
- *
- * class MyClass extends EventEmitter<MyEvents> {
- *   connect() {
- *     this.emit('connected', { deviceId: '123' });
- *   }
- * }
- *
- * const instance = new MyClass();
- * const unsubscribe = instance.on('connected', (data) => {
- *   console.log('Connected to:', data.deviceId);
- * });
- * ```
- */
 export declare class EventEmitter<T> {
     private listeners;
     private debugMode;
+    protected readonly logger: {
+        debug: (message: string, ...args: unknown[]) => void;
+        info: (message: string, ...args: unknown[]) => void;
+        warn: (message: string, ...args: unknown[]) => void;
+        error: (message: string, ...args: unknown[]) => void;
+    };
     /**
      * Subscribe to an event
      *

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

@@ -0,0 +1,6 @@
+/**
+ * Core Module - 核心模块
+ */
+export { BluetoothPrinter } from './BluetoothPrinter';
+export type { PrinterEvents } from './BluetoothPrinter';
+export { EventEmitter } from './EventEmitter';

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

@@ -0,0 +1,304 @@
+/**
+ * CPCL Driver
+ * PCL commands for Compact Print Language - HP/Honeywell/Toddler printers
+ *
+ * CPCL is commonly used in mobile/portable thermal printers
+ */
+/**
+ * CPCL page size presets
+ */
+export type CPCLPageSize = 'A4' | 'A5' | 'LETTER' | '4X6' | '4X2' | '4X4' | '2.25X1.25' | 'CUSTOM';
+/**
+ * CPCL Text options
+ */
+export interface CpclTextOptions {
+    /** X position in dots */
+    x?: number;
+    /** Y position in dots */
+    y?: number;
+    /** Font type: 0-6 (0=OCR, 1=OCR-B, 2=CG Triumvirate, etc.) */
+    font?: number;
+    /** Horizontal multiplier (1-8) */
+    xMulti?: number;
+    /** Vertical multiplier (1-8) */
+    yMulti?: number;
+    /** Rotation: 0, 90, 180, 270 */
+    rotation?: 0 | 90 | 180 | 270;
+}
+/**
+ * CPCL Barcode options
+ */
+export interface CpclBarcodeOptions {
+    /** X position in dots */
+    x?: number;
+    /** Y position in dots */
+    y?: number;
+    /** Barcode type */
+    type: '128' | '39' | 'EAN13' | 'EAN8' | 'UPCA' | 'UPCE' | 'MSI' | 'PLESSEY' | 'PDF417' | 'DATAMATRIX' | 'QR';
+    /** Barcode height in dots (default: 50) */
+    height?: number;
+    /** Wide bar width for 39 (default: 2) */
+    wide?: number;
+    /** Narrow bar width (default: 1) */
+    narrow?: number;
+    /** Show human-readable text (default: true) */
+    readable?: boolean;
+}
+/**
+ * CPCL QR Code options
+ */
+export interface CpclQRCodeOptions {
+    /** X position in dots */
+    x?: number;
+    /** Y position in dots */
+    y?: number;
+    /** Model (default: 2) */
+    model?: 1 | 2;
+    /** Error correction level: L, M, Q, H */
+    errorCorrection?: 'L' | 'M' | 'Q' | 'H';
+    /** Cell size (default: 4) */
+    cellSize?: number;
+}
+/**
+ * CPCL Line options
+ */
+export interface CpclLineOptions {
+    /** Start X position */
+    x1: number;
+    /** Start Y position */
+    y1: number;
+    /** End X position */
+    x2: number;
+    /** End Y position */
+    y2: number;
+    /** Line width/thickness */
+    width?: number;
+}
+/**
+ * CPCL Box options
+ */
+export interface CpclBoxOptions {
+    /** X position */
+    x: number;
+    /** Y position */
+    y: number;
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+    /** Border thickness */
+    thickness?: number;
+}
+/**
+ * CPCL Driver for HP, Honeywell, and Toddler portable printers
+ *
+ * @example
+ * ```typescript
+ * const cpcl = new CpclDriver();
+ *
+ * const commands = cpcl
+ *   .pageStart()
+ *   .text('Hello World!', { x: 50, y: 50 })
+ *   .barcode('1234567890', { x: 50, y: 150, type: '128' })
+ *   .qrcode('https://example.com', { x: 300, y: 50 })
+ *   .pageEnd()
+ *   .getCommands();
+ * ```
+ */
+export declare class CpclDriver {
+    private commands;
+    private readonly logger;
+    private pageWidth;
+    private pageHeight;
+    /**
+     * Initialize CPCL driver
+     * @param width - Page width in dots
+     * @param height - Page height in dots (0 = continuous)
+     */
+    constructor(width?: number, height?: number);
+    /**
+     * Set page size
+     * @param width - Width in dots
+     * @param height - Height in dots (0 = continuous)
+     */
+    setPageSize(width: number, height?: number): this;
+    /**
+     * Use standard page size
+     * @param size - Preset size name
+     */
+    usePageSize(size: CPCLPageSize): this;
+    /**
+     * Start a new page
+     */
+    pageStart(): this;
+    /**
+     * End current page
+     */
+    pageEnd(): this;
+    /**
+     * Form feed to next label
+     */
+    formFeed(): this;
+    /**
+     * Set line print mode
+     * @param font - Font number (0-6)
+     * @param xMulti - Horizontal multiplier
+     * @param yMulti - Vertical multiplier
+     */
+    setLinePrint(font?: number, xMulti?: number, yMulti?: number): this;
+    /**
+     * Set text font
+     * @param font - Font: 0=OCR, 1=OCR-B, 2=CG Triumvirate Bold, 3-6=Various sizes
+     * @param xMulti - Horizontal multiplier (1-8)
+     * @param yMulti - Vertical multiplier (1-8)
+     * @param rotation - Rotation angle
+     */
+    setFont(font?: number, xMulti?: number, yMulti?: number, rotation?: 0 | 90 | 180 | 270): this;
+    /**
+     * Add text at current position
+     * @param content - Text content
+     */
+    text(content: string): this;
+    /**
+     * Add positioned text
+     * @param content - Text content
+     * @param options - Text options
+     */
+    textAt(content: string, options: CpclTextOptions): this;
+    /**
+     * Add text using legacy command
+     * @param content - Text content
+     * @param x - X position
+     * @param y - Y position
+     * @param font - Font number
+     */
+    legacyText(content: string, x: number, y: number, font?: number): this;
+    /**
+     * Add barcode at position
+     * @param content - Barcode content
+     * @param options - Barcode options
+     */
+    barcode(content: string, options: CpclBarcodeOptions): this;
+    /**
+     * Add Code 128 barcode (most common)
+     * @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 QR code
+     * @param content - QR code content
+     * @param options - QR options
+     */
+    qrcode(content: string, options?: CpclQRCodeOptions): this;
+    /**
+     * Add 2D barcode (PDF417 or DataMatrix)
+     * @param content - Content
+     * @param type - Type: PDF417 or DATAMATRIX
+     * @param x - X position
+     * @param y - Y position
+     * @param height - Height
+     */
+    twoDBarcode(content: string, type: 'PDF417' | 'DATAMATRIX', x?: number, y?: number, height?: number): this;
+    /**
+     * Add line
+     * @param options - Line options
+     */
+    line(options: CpclLineOptions): this;
+    /**
+     * Add box/rectangle
+     * @param options - Box options
+     */
+    box(options: CpclBoxOptions): this;
+    /**
+     * Add inverse area (white on black)
+     * @param x - X position
+     * @param y - Y position
+     * @param width - Width
+     * @param height - Height
+     */
+    inverse(x: number, y: number, width: number, height: number): this;
+    /**
+     * Set print density
+     * @param density - Density value (-50 to +50)
+     */
+    setDensity(density: number): this;
+    /**
+     * Set speed
+     * @param speed - Speed: 2-6 (2=50%, 3=75%, 4=100%, 5=125%, 6=150%)
+     */
+    setSpeed(speed: number): this;
+    /**
+     * Cut paper (if cutter installed)
+     */
+    cut(): this;
+    /**
+     * Partial cut
+     */
+    partialCut(): this;
+    /**
+     * Feed and cut
+     */
+    feedCut(): this;
+    /**
+     * Sound beep
+     * @param count - Number of beeps
+     * @param duration - Duration in 10ms units
+     */
+    beep(count?: number, duration?: number): this;
+    /**
+     * Add logo/image
+     * @param x - X position
+     * @param y - Y position
+     * @param logoName - Stored logo name
+     */
+    logo(x: number, y: number, logoName: string): this;
+    /**
+     * Download logo to printer (store in memory)
+     * Note: This is a placeholder for future implementation
+     * @param logoName - Name to store logo as
+     * @param _bitmap - Logo bitmap data (placeholder)
+     */
+    downloadLogo(logoName: string, _bitmap: Uint8Array): this;
+    /**
+     * Print stored logo
+     * @param logoName - Logo name
+     * @param x - X position
+     * @param y - Y position
+     */
+    printLogo(logoName: string, x?: number, y?: number): 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
+     */
+    reset(): this;
+    /**
+     * Get page width
+     */
+    getPageWidth(): number;
+    /**
+     * Escape special characters in text
+     */
+    private escapeText;
+}

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

@@ -1,5 +1,4 @@
 import { IPrinterDriver, IQrOptions } from '../types';
-
 /**
  * ESC/POS driver options
  */

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

@@ -0,0 +1,63 @@
+import { EscPos, 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 declare class GPrinterDriver extends EscPos {
+    /**
+     * 佳博打印机特定: 打开钱箱
+     * @param pin 钱箱引脚 (0 或 1, 默认 0)
+     */
+    openCashDrawer(pin?: number): Uint8Array[];
+    /**
+     * 佳博打印机特定: 发送声响
+     * @param times 次数 (1-9)
+     * @param duration 持续时间
+     */
+    beep(times?: number, duration?: number): Uint8Array[];
+    /**
+     * 佳博打印机特定: 打印自检页
+     */
+    selfTest(): Uint8Array[];
+    /**
+     * 佳博打印机特定: 获取状态
+     * 返回打印机状态字节
+     */
+    getStatus(): Uint8Array[];
+    /**
+     * 佳博打印机特定: 设置字符代码页
+     * @param codePage 代码页编号
+     */
+    setCodePage(codePage: number): Uint8Array[];
+    /**
+     * 佳博打印机特定: 打印并走纸
+     * @param lines 走纸行数
+     */
+    printAndFeed(lines: number): Uint8Array[];
+    /**
+     * 佳博打印机特定: 设置左边界
+     * @param n 左边界字符数
+     */
+    setLeftMargin(n: number): Uint8Array[];
+    /**
+     * 佳博打印机特定: 设置打印区域宽度
+     * @param n 宽度 (字符数)
+     */
+    setPrintWidth(n: number): Uint8Array[];
+}