taro-bluetooth-print 2.2.1 → 2.3.1

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

@@ -0,0 +1,251 @@
+/**
+ * TSPL Driver
+ * TSC Printer Language driver for label/barcode printers
+ *
+ * TSPL is commonly used in thermal transfer label printers (TSC, Zebra, etc.)
+ */
+/**
+ * Label size configuration
+ */
+export interface LabelSize {
+    /** Label width in mm */
+    width: number;
+    /** Label height in mm */
+    height: number;
+    /** Gap between labels in mm (default: 3) */
+    gap?: number;
+}
+/**
+ * Text position and style
+ */
+export interface TextOptions {
+    /** X position in dots */
+    x: number;
+    /** Y position in dots */
+    y: number;
+    /** Font size (1-8, default: 2) */
+    font?: number;
+    /** Rotation (0, 90, 180, 270, default: 0) */
+    rotation?: 0 | 90 | 180 | 270;
+    /** Horizontal multiplier (1-10, default: 1) */
+    xMultiplier?: number;
+    /** Vertical multiplier (1-10, default: 1) */
+    yMultiplier?: number;
+}
+/**
+ * Barcode options
+ */
+export interface BarcodeOptions {
+    /** X position in dots */
+    x: number;
+    /** Y position in dots */
+    y: number;
+    /** Barcode type */
+    type: '128' | '39' | 'EAN13' | 'EAN8' | 'UPCA' | 'QRCODE';
+    /** Height in dots (default: 100) */
+    height?: number;
+    /** Narrow bar width (default: 2) */
+    narrow?: number;
+    /** Wide bar width (default: 4) */
+    wide?: number;
+    /** Show human-readable text (default: true) */
+    showText?: boolean;
+    /** Rotation (0, 90, 180, 270, default: 0) */
+    rotation?: 0 | 90 | 180 | 270;
+}
+/**
+ * QR Code options
+ */
+export interface QRCodeOptions {
+    /** X position in dots */
+    x: number;
+    /** Y position in dots */
+    y: number;
+    /** Error correction level (L, M, Q, H, default: M) */
+    eccLevel?: 'L' | 'M' | 'Q' | 'H';
+    /** Cell width (1-10, default: 6) */
+    cellWidth?: number;
+    /** Mode (A=Auto, M=Manual, default: A) */
+    mode?: 'A' | 'M';
+    /** Rotation (0, 90, 180, 270, default: 0) */
+    rotation?: 0 | 90 | 180 | 270;
+}
+/**
+ * Box/Rectangle options
+ */
+export interface BoxOptions {
+    /** X position in dots */
+    x: number;
+    /** Y position in dots */
+    y: number;
+    /** Width in dots */
+    width: number;
+    /** Height in dots */
+    height: number;
+    /** Line thickness (default: 2) */
+    thickness?: number;
+}
+/**
+ * Line options
+ */
+export interface LineOptions {
+    /** Start X position in dots */
+    x1: number;
+    /** Start Y position in dots */
+    y1: number;
+    /** End X position in dots */
+    x2: number;
+    /** End Y position in dots */
+    y2: number;
+    /** Line thickness (default: 2) */
+    thickness?: number;
+}
+/**
+ * TSPL Driver for label printers
+ *
+ * @example
+ * ```typescript
+ * const tspl = new TsplDriver();
+ *
+ * const commands = tspl
+ *   .size(60, 40)
+ *   .gap(3)
+ *   .clear()
+ *   .text('Product Name', { x: 50, y: 50, font: 3 })
+ *   .barcode('1234567890', { x: 50, y: 100, type: '128' })
+ *   .print(1)
+ *   .getBuffer();
+ * ```
+ */
+export declare class TsplDriver {
+    private commands;
+    private readonly logger;
+    private dpi;
+    /**
+     * Set printer DPI (dots per inch)
+     * @param dpi - DPI value (203 or 300)
+     */
+    setDPI(dpi: 203 | 300): this;
+    /**
+     * Convert mm to dots
+     */
+    mmToDots(mm: number): number;
+    /**
+     * Convert dots to mm
+     */
+    dotsToMm(dots: number): number;
+    /**
+     * Set label size
+     * @param width - Label width in mm
+     * @param height - Label height in mm
+     */
+    size(width: number, height: number): this;
+    /**
+     * Set gap between labels
+     * @param gap - Gap size in mm
+     * @param offset - Offset in mm (default: 0)
+     */
+    gap(gap: number, offset?: number): this;
+    /**
+     * Set print speed
+     * @param speed - Speed level (1-10)
+     */
+    speed(speed: number): this;
+    /**
+     * Set print density
+     * @param density - Density level (0-15)
+     */
+    density(density: number): this;
+    /**
+     * Set print direction
+     * @param direction - 0=normal, 1=reversed
+     */
+    direction(direction: 0 | 1): this;
+    /**
+     * Clear image buffer
+     */
+    clear(): this;
+    /**
+     * Add text to label
+     * @param content - Text content
+     * @param options - Text options
+     */
+    text(content: string, options: TextOptions): this;
+    /**
+     * Add barcode to label
+     * @param content - Barcode content
+     * @param options - Barcode options
+     */
+    barcode(content: string, options: BarcodeOptions): this;
+    /**
+     * Add QR code to label
+     * @param content - QR code content
+     * @param options - QR code options
+     */
+    qrcode(content: string, options: QRCodeOptions): this;
+    /**
+     * Draw a box/rectangle
+     * @param options - Box options
+     */
+    box(options: BoxOptions): this;
+    /**
+     * Draw a line
+     * @param options - Line options
+     */
+    line(options: LineOptions): this;
+    /**
+     * Fill a rectangular area
+     * @param x - X position
+     * @param y - Y position
+     * @param width - Width
+     * @param height - Height
+     */
+    bar(x: number, y: number, width: number, height: number): this;
+    /**
+     * Reverse a rectangular area (white becomes black and vice versa)
+     * @param x - X position
+     * @param y - Y position
+     * @param width - Width
+     * @param height - Height
+     */
+    reverse(x: number, y: number, width: number, height: number): this;
+    /**
+     * Print the label
+     * @param copies - Number of copies (default: 1)
+     * @param sets - Number of sets (default: 1)
+     */
+    print(copies?: number, sets?: number): this;
+    /**
+     * Feed labels
+     * @param count - Number of labels to feed
+     */
+    feed(count?: number): this;
+    /**
+     * Cut paper (if cutter available)
+     */
+    cut(): this;
+    /**
+     * Beep the buzzer
+     */
+    beep(): this;
+    /**
+     * Home the print head
+     */
+    home(): this;
+    /**
+     * Escape special characters in string
+     */
+    private escapeString;
+    /**
+     * Get all commands as string
+     */
+    getCommands(): string;
+    /**
+     * Get commands as buffer for sending to printer
+     */
+    getBuffer(): Uint8Array;
+    /**
+     * Clear all commands
+     */
+    reset(): this;
+}

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,20 +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 * 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';
@@ -38,4 +40,7 @@ export { PlatformType, detectPlatform, isPlatformSupported } from './utils/platf
 export { BluetoothPrintError, ErrorCode } from './errors/BluetoothError';
 export { DEFAULT_CONFIG, mergeConfig } from './config/PrinterConfig';
 export type { PrinterConfig, AdapterConfig, DriverConfig, LoggingConfig, } from './config/PrinterConfig';
+export { PluginManager } from './plugins/PluginManager';
+export { createLoggingPlugin, createRetryPlugin } from './plugins';
+export type { Plugin, PluginHooks, PluginOptions, PluginFactory } from './plugins/types';
 export * from './types';