taro-bluetooth-print 2.3.0 → 2.4.0

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/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[];
+}

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;