taro-bluetooth-print 2.4.1 → 2.6.0

package/dist/logo.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <!-- Background circle -->
+  <circle cx="32" cy="32" r="30" fill="#10b981" opacity="0.1"/>
+  <circle cx="32" cy="32" r="28" fill="#10b981" opacity="0.2"/>
+  <!-- Printer body -->
+  <rect x="12" y="20" width="40" height="28" rx="4" fill="#10b981"/>
+  <!-- Paper slot -->
+  <rect x="16" y="8" width="32" height="16" rx="2" fill="#ffffff" stroke="#10b981" stroke-width="2"/>
+  <!-- Paper lines -->
+  <line x1="20" y1="14" x2="36" y2="14" stroke="#10b981" stroke-width="2" stroke-linecap="round"/>
+  <line x1="20" y1="18" x2="30" y2="18" stroke="#10b981" stroke-width="2" stroke-linecap="round"/>
+  <!-- Bluetooth symbol -->
+  <path d="M32 26 L36 30 L32 34 L28 30 Z" fill="#ffffff"/>
+  <line x1="32" y1="30" x2="32" y2="38" stroke="#ffffff" stroke-width="2" stroke-linecap="round"/>
+  <!-- Feed button -->
+  <rect x="46" y="36" width="4" height="6" rx="1" fill="#ffffff" opacity="0.6"/>
+</svg>

package/dist/manifest.webmanifest

@@ -0,0 +1,17 @@
+{
+  "name": "taro-bluetooth-print",
+  "short_name": "蓝牙打印",
+  "description": "轻量级、高性能的热敏/标签蓝牙打印库",
+  "start_url": "/taro-bluetooth-print/",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#10b981",
+  "icons": [
+    {
+      "src": "/logo.svg",
+      "sizes": "any",
+      "type": "image/svg+xml"
+    }
+  ],
+  "categories": ["developer tools", "utilities"]
+}

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

@@ -0,0 +1,22 @@
+import { MiniProgramAdapter, MiniProgramBLEApi } from './BaseAdapter';
+/**
+ * QQ Mini Program Bluetooth Low Energy adapter
+ *
+ * Uses the QQ mini-program's BLE APIs (qq.xxx).
+ * All connection, write, and service discovery logic is inherited from MiniProgramAdapter.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new QQAdapter();
+ * await adapter.connect('device-id-123');
+ * await adapter.write('device-id-123', buffer);
+ * await adapter.disconnect('device-id-123');
+ * ```
+ */
+export declare class QQAdapter extends MiniProgramAdapter {
+    /**
+     * Returns the QQ mini-program BLE API object
+     * @returns The qq global object providing BLE capabilities
+     */
+    protected getApi(): MiniProgramBLEApi;
+}

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

@@ -0,0 +1,111 @@
+import { BaseAdapter } from './BaseAdapter';
+import { IPrinterAdapter, IAdapterOptions } from '../types';
+/**
+ * React Native BLE Manager interface
+ * Compatible with react-native-ble-plx API
+ */
+interface BLEManager {
+    startDeviceScan(serviceUUIDs: string[] | null, options: Record<string, unknown> | null, onDeviceScanned: (error: unknown, device: unknown) => void): void;
+    stopDeviceScan(): void;
+    connectToDevice(deviceIdentifier: string, options: Record<string, unknown>): Promise<unknown>;
+    disconnectFromDevice(deviceIdentifier: string, force?: boolean): Promise<unknown>;
+    discoverAllServicesAndCharacteristicsForDevice(deviceIdentifier: string): Promise<unknown>;
+    writeCharacteristicWithResponseForDevice(deviceIdentifier: string, serviceUUID: string, characteristicUUID: string, value: string, transactionId?: string): Promise<unknown>;
+    writeCharacteristicWithoutResponseForDevice(deviceIdentifier: string, serviceUUID: string, characteristicUUID: string, value: string, transactionId?: string): Promise<unknown>;
+    readCharacteristicForDevice(deviceIdentifier: string, serviceUUID: string, characteristicUUID: string, transactionId?: string): Promise<unknown>;
+    monitorCharacteristicForDevice(deviceIdentifier: string, serviceUUID: string, characteristicUUID: string, onUpdate: (error: unknown, characteristic: unknown) => void, transactionId?: string): {
+        remove: () => void;
+    };
+}
+/**
+ * React Native Bluetooth Low Energy adapter
+ *
+ * Uses react-native-ble-plx for BLE operations on iOS and Android.
+ * This adapter does NOT extend MiniProgramAdapter because React Native
+ * has a fundamentally different BLE API compared to mini-program platforms.
+ *
+ * @example
+ * ```typescript
+ * import BleManager from 'react-native-ble-plx';
+ * import { ReactNativeAdapter } from 'taro-bluetooth-print';
+ *
+ * BleManager.start({ showAlert: false });
+ *
+ * const adapter = new ReactNativeAdapter({ bleManager: BleManager });
+ * await adapter.connect('device-uuid-123');
+ * await adapter.write('device-uuid-123', buffer);
+ * await adapter.disconnect('device-uuid-123');
+ * ```
+ */
+export declare class ReactNativeAdapter extends BaseAdapter implements IPrinterAdapter {
+    private bleManager;
+    private deviceCache;
+    /**
+     * Creates a new ReactNativeAdapter instance
+     *
+     * @param options - Configuration options
+     * @param options.bleManager - BLE Manager instance (e.g., from react-native-ble-plx)
+     * @throws {Error} If bleManager is not provided or not supported
+     */
+    constructor(options: {
+        bleManager: BLEManager;
+    });
+    /**
+     * Connect to a Bluetooth device and discover services
+     *
+     * @param deviceId - Unique identifier (UUID) of the device to connect to
+     * @throws {BluetoothPrintError} When connection fails or device not found
+     */
+    connect(deviceId: string): Promise<void>;
+    /**
+     * Perform the actual BLE connection
+     */
+    private performConnect;
+    /**
+     * Disconnect from a Bluetooth device
+     *
+     * @param deviceId - Unique identifier of the device to disconnect from
+     */
+    disconnect(deviceId: string): Promise<void>;
+    /**
+     * Write data to the Bluetooth device in chunks
+     *
+     * Features:
+     * - Automatic chunk size adjustment
+     * - Dynamic delay for congestion control
+     * - Retry with exponential backoff
+     * - Write timeout per chunk
+     *
+     * @param deviceId - Unique identifier of the connected device
+     * @param buffer - Data to write as ArrayBuffer
+     * @param options - Optional write settings (chunkSize, delay, retries)
+     * @throws {BluetoothPrintError} When write fails after all retries
+     */
+    write(deviceId: string, buffer: ArrayBuffer, options?: IAdapterOptions): Promise<void>;
+    /**
+     * Start discovering nearby Bluetooth devices
+     *
+     * Note: This is optional in IPrinterAdapter. In React Native BLE,
+     * device discovery is typically done via scan events.
+     */
+    startDiscovery?(): Promise<void>;
+    /**
+     * Stop discovering nearby Bluetooth devices
+     */
+    stopDiscovery?(): Promise<void>;
+    /**
+     * Discover services and characteristics for a connected device
+     *
+     * @param deviceId - Device identifier
+     * @param device - Connected device object
+     */
+    private discoverServices;
+    /**
+     * Convert ArrayBuffer to base64 string for react-native-ble-plx
+     *
+     * @param buffer - ArrayBuffer to convert
+     * @returns Base64 encoded string
+     */
+    private arrayBufferToBase64;
+}
+export {};

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

@@ -12,6 +12,47 @@ export interface WebBluetoothRequestOptions {
     acceptAllDevices?: boolean;
     /** Optional services to access */
     optionalServices?: string[];
+    /** Minimum RSSI signal strength (dBm) to accept device */
+    minRSSI?: number;
+    /** Filter by device name (exact or partial match) */
+    name?: string;
+    /** Filter by manufacturer data patterns */
+    manufacturerDataFilter?: Array<{
+        companyIdentifier: number;
+        dataPrefix?: Uint8Array;
+    }>;
+}
+/**
+ * Discovered device information
+ */
+export interface DiscoveredDevice {
+    /** Device instance */
+    device: BluetoothDevice;
+    /** Device name */
+    name: string;
+    /** Device ID */
+    deviceId: string;
+    /** RSSI signal strength (dBm) */
+    rssi?: number;
+    /** Timestamp when device was discovered */
+    discoveredAt: number;
+    /** Manufacturer data if available */
+    manufacturerData?: Map<number, Uint8Array>;
+}
+/**
+ * Device filter options for scanning
+ */
+export interface DeviceFilterOptions {
+    /** Minimum RSSI threshold (dBm) */
+    minRSSI?: number;
+    /** Maximum RSSI threshold (dBm) */
+    maxRSSI?: number;
+    /** Name prefix filter */
+    namePrefix?: string;
+    /** Name exact match filter */
+    name?: string;
+    /** Service UUIDs to filter */
+    serviceUUIDs?: string[];
 }
 /**
  * Web Bluetooth adapter for H5 environment
@@ -29,6 +70,8 @@ export interface WebBluetoothRequestOptions {
  */
 export declare class WebBluetoothAdapter extends BaseAdapter {
     private devices;
+    private discoveredDevices;
+    private connectionCleanupTimeout;
     /**
      * Check if Web Bluetooth API is supported in the current browser
      * @returns True if Web Bluetooth is supported
@@ -52,10 +95,12 @@ export declare class WebBluetoothAdapter extends BaseAdapter {
     connect(deviceId: string): Promise<void>;
     /**
      * Disconnect from a Bluetooth device
+     * Enhanced to properly clean up all resources and event listeners
      *
      * @param deviceId - Bluetooth device ID
+     * @param force - If true, force disconnection even if device not found in cache
      */
-    disconnect(deviceId: string): Promise<void>;
+    disconnect(deviceId: string, force?: boolean): void;
     /**
      * Write data to the Bluetooth device
      *
@@ -65,6 +110,42 @@ export declare class WebBluetoothAdapter extends BaseAdapter {
      * @throws {BluetoothPrintError} When write fails
      */
     write(deviceId: string, buffer: ArrayBuffer, options?: IAdapterOptions): Promise<void>;
+    /**
+     * Get device ID from a BluetoothDevice instance
+     * Handles different browser implementations
+     *
+     * @param device - BluetoothDevice instance
+     * @returns Device ID string
+     */
+    getDeviceId(device: BluetoothDevice): string;
+    /**
+     * Get device information including RSSI
+     *
+     * @param deviceId - Bluetooth device ID
+     * @returns Device info object with RSSI and metadata
+     */
+    getDeviceInfo(deviceId: string): {
+        deviceId: string;
+        name: string;
+        rssi?: number;
+        connected: boolean;
+    } | null;
+    /**
+     * Filter discovered devices by criteria
+     *
+     * @param devices - Array of discovered devices
+     * @param filter - Filter criteria
+     * @returns Filtered array of devices
+     */
+    filterDevices(devices: DiscoveredDevice[], filter: DeviceFilterOptions): DiscoveredDevice[];
+    /**
+     * Sort devices by signal strength (RSSI)
+     *
+     * @param devices - Array of discovered devices
+     * @param ascending - Sort in ascending order (weakest first), default false (strongest first)
+     * @returns Sorted array
+     */
+    sortByRSSI(devices: DiscoveredDevice[], ascending?: boolean): DiscoveredDevice[];
     /**
      * Build request options for navigator.bluetooth.requestDevice
      */
@@ -89,4 +170,9 @@ export declare class WebBluetoothAdapter extends BaseAdapter {
      * Clean up device information
      */
     private cleanupDeviceInfo;
+    /**
+     * Generate a fallback device ID when device.id is not available
+     * Uses device name + first seen timestamp as identifier
+     */
+    private generateFallbackDeviceId;
 }

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

@@ -0,0 +1,13 @@
+/**
+ * Adapters barrel export
+ */
+export { BaseAdapter, MiniProgramAdapter } from './BaseAdapter';
+export type { MiniProgramBLEApi, ServiceInfo, BLECharacteristic, BLECharacteristicProperties, } from './BaseAdapter';
+export { TaroAdapter } from './TaroAdapter';
+export { AlipayAdapter } from './AlipayAdapter';
+export { BaiduAdapter } from './BaiduAdapter';
+export { ByteDanceAdapter } from './ByteDanceAdapter';
+export { QQAdapter } from './QQAdapter';
+export { ReactNativeAdapter } from './ReactNativeAdapter';
+export { WebBluetoothAdapter } from './WebBluetoothAdapter';
+export { AdapterFactory } from './AdapterFactory';

package/dist/types/barcode/BarcodeGenerator.d.ts

@@ -1,8 +1,8 @@
 /**
  * Barcode Generator
  *
- * Generates ESC/POS commands for printing 1D barcodes.
- * Supports Code128, Code39, EAN-13, EAN-8, UPC-A, ITF, and CODABAR formats.
+ * Generates ESC/POS commands for printing 1D barcodes and 2D codes.
+ * Supports Code128, Code39, EAN-13, EAN-8, UPC-A, ITF, CODABAR, QR_CODE, and PDF417 formats.
  *
  * @example
  * ```typescript
@@ -31,7 +31,11 @@ export declare enum BarcodeFormat {
     /** ITF (Interleaved 2 of 5) - Even number of digits */
     ITF = "ITF",
     /** CODABAR - Numeric with special start/stop chars */
-    CODABAR = "CODABAR"
+    CODABAR = "CODABAR",
+    /** QR Code - 2D matrix code */
+    QR_CODE = "QR_CODE",
+    /** PDF417 - 2D stacked barcode */
+    PDF417 = "PDF417"
 }
 /**
  * Barcode configuration options
@@ -47,6 +51,16 @@ export interface BarcodeOptions {
     showText?: boolean;
     /** Text position */
     textPosition?: 'above' | 'below' | 'both' | 'none';
+    /** QR code error correction level (L/M/Q/H, default: M) */
+    errorCorrection?: 'L' | 'M' | 'Q' | 'H';
+    /** QR code model (1 or 2, default: 2) */
+    qrModel?: 1 | 2;
+    /** PDF417 compression mode (0-3, default: 2) */
+    pdf417Compression?: 0 | 1 | 2 | 3;
+    /** PDF417 security level (0-8, default: 2) */
+    pdf417Security?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+    /** PDF417 columns (1-30, default: 2) */
+    pdf417Columns?: number;
 }
 /**
  * Validation result
@@ -74,7 +88,7 @@ export interface IBarcodeGenerator {
 }
 /**
  * Barcode Generator class
- * Generates ESC/POS commands for 1D barcodes
+ * Generates ESC/POS commands for 1D barcodes and 2D codes
  */
 export declare class BarcodeGenerator implements IBarcodeGenerator {
     /**
@@ -85,6 +99,29 @@ export declare class BarcodeGenerator implements IBarcodeGenerator {
      * @returns Array of ESC/POS command buffers
      */
     generate(content: string, options: BarcodeOptions): Uint8Array[];
+    /**
+     * Generate 1D barcode commands
+     */
+    private generate1DBarcode;
+    /**
+     * Generate QR code commands using ESC/POS GS k 80-83
+     *
+     * @param content - QR code content
+     * @param options - QR code options
+     * @returns Array of ESC/POS command buffers
+     */
+    private generateQRCode;
+    /**
+     * Generate PDF417 commands using ESC/POS GS k 81
+     *
+     * PDF417 is a 2D stacked barcode format supported by many thermal printers.
+     * The printer will handle the actual encoding and generation of the PDF417 symbol.
+     *
+     * @param content - PDF417 content (text data)
+     * @param options - PDF417 options
+     * @returns Array of ESC/POS command buffers
+     */
+    private generatePDF417;
     /**
      * Validate barcode content for the specified format
      *
@@ -93,6 +130,14 @@ export declare class BarcodeGenerator implements IBarcodeGenerator {
      * @returns Validation result
      */
     validate(content: string, format: BarcodeFormat): ValidationResult;
+    /**
+     * Validate QR code content
+     */
+    private validateQRCode;
+    /**
+     * Validate PDF417 content
+     */
+    private validatePDF417;
     /**
      * Get list of supported barcode formats
      *
@@ -139,6 +184,10 @@ export declare class BarcodeGenerator implements IBarcodeGenerator {
      * Encode content for ESC/POS barcode command
      */
     private encodeContent;
+    /**
+     * Encode string to UTF-8 bytes
+     */
+    private encodeUTF8;
     /**
      * Get text position code
      */
@@ -151,5 +200,13 @@ export declare class BarcodeGenerator implements IBarcodeGenerator {
      * Clamp width to valid range (2-6)
      */
     private clampWidth;
+    /**
+     * Clamp QR code size to valid range (1-16)
+     */
+    private clampQRSize;
+    /**
+     * Clamp PDF417 columns to valid range (1-30)
+     */
+    private clampPDF417Columns;
 }
 export declare const barcodeGenerator: BarcodeGenerator;

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

@@ -1,6 +1,6 @@
 /**
  * Barcode Generator Module
- * 条码生成模块 - 负责一维条码生成
+ * 条码生成模块 - 负责一维条码和二维条码生成
  */
 export { BarcodeGenerator, barcodeGenerator, BarcodeFormat } from './BarcodeGenerator';
 export type { BarcodeOptions, ValidationResult, IBarcodeGenerator } from './BarcodeGenerator';

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

@@ -0,0 +1,243 @@
+import { IPrinterDriver, IQrOptions } from '../types';
+/**
+ * Alignment options for text positioning
+ */
+export type Alignment = 'left' | 'center' | 'right';
+/**
+ * Barcode types supported by STAR printers
+ */
+export type BarcodeType = 'CODE39' | 'CODE128' | 'EAN13';
+/**
+ * STAR printer driver options
+ */
+export interface StarPrinterOptions {
+    /** Use the EncodingService for GBK/UTF-8 encoding (default: true) */
+    useEncodingService?: boolean;
+    /** Show warnings for unsupported characters (default: true) */
+    showEncodingWarnings?: boolean;
+    /** Fallback character for unsupported characters (default: '?') */
+    fallbackChar?: string;
+    /** Enable international character mode (default: true) */
+    internationalCharset?: boolean;
+}
+/**
+ * Barcode options for STAR printers
+ */
+export interface StarBarcodeOptions {
+    /** Barcode height in dots (default: 40) */
+    height?: number;
+    /** Barcode width (default: 2) */
+    width?: number;
+    /** HRI text position: 'none' | 'above' | 'below' | 'both' (default: 'below') */
+    hri?: 'none' | 'above' | 'below' | 'both';
+    /** Barcode type: CODE39, CODE128, EAN13 */
+    type?: BarcodeType;
+}
+/**
+ * QR code options for STAR printers
+ */
+export interface StarQrOptions {
+    /** QR code model (default: 2) */
+    model?: 1 | 2;
+    /** QR code cell size in dots (default: 4) */
+    cellSize?: number;
+    /** Error correction level: 'L' | 'M' | 'Q' | 'H' (default: 'M') */
+    errorCorrection?: 'L' | 'M' | 'Q' | 'H';
+}
+/**
+ * Image print options
+ */
+export interface StarImageOptions {
+    /** Enable dithering (default: true) */
+    dithering?: boolean;
+    /** Threshold for binarization 0-255 (default: 128) */
+    threshold?: number;
+    /** Print in greyscale mode (default: false) */
+    greyscale?: boolean;
+}
+/**
+ * STAR TSP/TSP700 series thermal printer driver
+ *
+ * Implements the STAR command set for thermal receipt printers.
+ * Supports text, images, QR codes, barcodes, and paper control.
+ *
+ * @example
+ * ```typescript
+ * const driver = new StarPrinter();
+ * const commands = [
+ *   ...driver.init(),
+ *   ...driver.text('Hello World!'),
+ *   ...driver.feed(3),
+ *   ...driver.cut()
+ * ];
+ * ```
+ */
+export declare class StarPrinter implements IPrinterDriver {
+    private readonly logger;
+    private readonly encodingService;
+    private readonly useEncodingService;
+    private readonly internationalCharset;
+    private _boldEnabled;
+    private _alignment;
+    /**
+     * Creates a new StarPrinter driver instance
+     * @param options - Driver options
+     */
+    constructor(options?: StarPrinterOptions);
+    /**
+     * Initialize the printer to default state
+     * Sends ESC @ to reset printer to power-on defaults
+     *
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * const commands = driver.init();
+     * ```
+     */
+    init(): Uint8Array[];
+    /**
+     * Print text content with specified encoding
+     *
+     * Supports GBK, UTF-8, EUC-KR, Shift-JIS, ISO-2022-JP through EncodingService.
+     * When using ESC/POS compatible mode, text is output as-is with line feed.
+     *
+     * @param content - Text content to print
+     * @param encoding - Text encoding (default: 'GBK')
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * driver.text('Hello World', 'UTF-8');
+     * driver.text('你好世界', 'GBK');
+     * ```
+     */
+    text(content: string, encoding?: string): Uint8Array[];
+    /**
+     * Feed paper by specified number of lines
+     *
+     * @param lines - Number of lines to feed (default: 1, max: 255)
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * driver.feed(3); // Feed 3 lines
+     * ```
+     */
+    feed(lines?: number): Uint8Array[];
+    /**
+     * Cut the paper using the built-in cutter
+     *
+     * Note: Not all STAR printers have a cutter. For printers without cutter,
+     * this will attempt a full paper cut which may result in no action.
+     *
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * driver.cut();
+     * ```
+     */
+    cut(): Uint8Array[];
+    /**
+     * Print a QR code
+     *
+     * Uses STAR's built-in QR code command when available (GS W 01 pattern),
+     * otherwise falls back to printing QR code as a raster image.
+     *
+     * @param content - Content to encode in the QR code
+     * @param options - QR code options (model, cellSize, errorCorrection)
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * driver.qr('https://example.com', { model: 2, cellSize: 6, errorCorrection: 'M' });
+     * ```
+     */
+    qr(content: string, options?: IQrOptions | StarQrOptions): Uint8Array[];
+    /**
+     * Print a barcode
+     *
+     * Supports CODE39, CODE128, and EAN13 barcode types.
+     * HRI (Human Readable Interpretation) text can be positioned above,
+     * below, or both sides of the barcode.
+     *
+     * @param data - Barcode data content
+     * @param options - Barcode options (type, height, width, hri)
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * driver.barcode('123456789012', { type: 'EAN13', height: 60 });
+     * driver.barcode('ABC-1234', { type: 'CODE39', width: 3 });
+     * ```
+     */
+    barcode(data: string, options?: StarBarcodeOptions): Uint8Array[];
+    /**
+     * Print a raster image
+     *
+     * Converts RGBA image data to 1-bit bitmap using dithering and sends
+     * to the printer using STAR's raster image command.
+     *
+     * @param data - RGBA pixel data (Uint8Array, 4 bytes per pixel)
+     * @param width - Image width in pixels
+     * @param height - Image height in pixels
+     * @param options - Image print options (dithering, threshold, greyscale)
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * const imageData = new Uint8Array(width * height * 4); // RGBA
+     * driver.image(imageData, 200, 100, { dithering: true });
+     * ```
+     */
+    image(data: Uint8Array, width: number, height: number, options?: StarImageOptions): Uint8Array[];
+    /**
+     * Sound a beep/buzzer on supported printers
+     *
+     * Sends a command to activate the printer's built-in buzzer.
+     * Useful for alerting operators to print completion or errors.
+     *
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * driver.beep();
+     * ```
+     */
+    beep(): Uint8Array[];
+    /**
+     * Enable or disable bold text
+     *
+     * When bold is enabled, subsequent text will be printed in bold.
+     * This state persists until explicitly disabled.
+     *
+     * @param on - true to enable bold, false to disable
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * driver.bold(true);
+     * driver.text('Bold Text');
+     * driver.bold(false);
+     * ```
+     */
+    bold(on: boolean): Uint8Array[];
+    /**
+     * Set text alignment
+     *
+     * Controls horizontal text alignment for subsequent text.
+     * Alignment persists until explicitly changed.
+     *
+     * @param align - Alignment: 'left' | 'center' | 'right'
+     * @returns Array of command buffers
+     *
+     * @example
+     * ```typescript
+     * driver.align('center');
+     * driver.text('Centered Title');
+     * driver.align('left');
+     * ```
+     */
+    align(align: Alignment): Uint8Array[];
+}

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

@@ -7,3 +7,4 @@ 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';
+export { StarPrinter, type StarPrinterOptions, type Alignment, type BarcodeType, type StarBarcodeOptions, type StarQrOptions, type StarImageOptions, } from './StarPrinter';