taro-bluetooth-print 2.8.4 → 2.9.1

package/dist/types/providers/ServiceProvider.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Service Provider Module
+ *
+ * 将现有服务层注册到 DI 容器
+ */
+/**
+ * 服务提供者配置选项
+ */
+export interface ServiceProviderOptions {
+    /** 是否启用全局事件总线 */
+    useGlobalEventBus?: boolean;
+    /** 自定义配置 */
+    config?: Record<string, unknown>;
+}
+/**
+ * 注册所有服务到 DI 容器
+ */
+export declare function registerServices(options?: ServiceProviderOptions): void;
+/**
+ * 创建配置好的服务提供者
+ */
+export declare function createServiceProvider(options?: ServiceProviderOptions): {
+    /** 获取连接管理器 */
+    getConnectionManager: () => unknown;
+    /** 获取打印任务管理器 */
+    getPrintJobManager: () => unknown;
+    /** 获取命令构建器 */
+    getCommandBuilder: () => unknown;
+    /** 获取设备管理器 */
+    getDeviceManager: () => unknown;
+    /** 获取打印队列 */
+    getPrintQueue: () => unknown;
+    /** 获取离线缓存 */
+    getOfflineCache: () => unknown;
+    /** 获取配置管理器 */
+    getConfigManager: () => unknown;
+    /** 获取打印机状态服务 */
+    getPrinterStatus: () => unknown;
+    /** 获取打印历史服务 */
+    getPrintHistory: () => unknown;
+    /** 获取打印统计服务 */
+    getPrintStatistics: () => unknown;
+    /** 获取云打印管理器 */
+    getCloudPrintManager: () => unknown;
+    /** 获取定时重试管理器 */
+    getScheduledRetryManager: () => unknown;
+    /** 获取批量打印管理器 */
+    getBatchPrintManager: () => unknown;
+    /** 获取事件总线 */
+    getEventBus: () => unknown;
+    /** 获取插件管理器 */
+    getPluginManager: () => unknown;
+    /** 获取适配器 */
+    getAdapter: () => unknown;
+};
+export type ServiceProvider = ReturnType<typeof createServiceProvider>;

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

@@ -0,0 +1,2 @@
+export { registerServices, createServiceProvider } from './ServiceProvider';
+export type { ServiceProviderOptions, ServiceProvider } from './ServiceProvider';

package/dist/types/services/interfaces/ICommandBuilder.d.ts

@@ -0,0 +1,123 @@
+import { IQrOptions } from '../../types';
+import { TextAlign, TextStyle } from '../../formatter';
+import { BarcodeOptions } from '../../barcode';
+/**
+ * Command Builder Interface
+ *
+ * Builds print commands using the printer driver
+ */
+export interface ICommandBuilder {
+    /**
+     * Adds text to the print queue
+     *
+     * @param content - Text content
+     * @param encoding - Text encoding
+     * @returns this - For method chaining
+     */
+    text(content: string, encoding?: string): this;
+    /**
+     * Adds line feeds to the print queue
+     *
+     * @param lines - Number of lines to feed
+     * @returns this - For method chaining
+     */
+    feed(lines?: number): this;
+    /**
+     * Adds a paper cut command to the print queue
+     *
+     * @returns this - For method chaining
+     */
+    cut(): this;
+    /**
+     * Adds an image to the print queue
+     *
+     * @param data - Image data as Uint8Array
+     * @param width - Image width
+     * @param height - Image height
+     * @returns this - For method chaining
+     */
+    image(data: Uint8Array, width: number, height: number): this;
+    /**
+     * Adds a QR code to the print queue
+     *
+     * @param content - QR code content
+     * @param options - QR code options
+     * @returns this - For method chaining
+     */
+    qr(content: string, options?: IQrOptions): this;
+    /**
+     * Clears the print queue
+     *
+     * @returns this - For method chaining
+     */
+    clear(): this;
+    /**
+     * Sets text alignment
+     *
+     * @param alignment - Text alignment (left, center, right)
+     * @returns this - For method chaining
+     */
+    align(alignment: TextAlign): this;
+    /**
+     * Sets character size (width and height scale)
+     *
+     * @param width - Width scale factor (1-8)
+     * @param height - Height scale factor (1-8)
+     * @returns this - For method chaining
+     */
+    setSize(width: number, height: number): this;
+    /**
+     * Sets bold text mode
+     *
+     * @param enabled - Enable or disable bold
+     * @returns this - For method chaining
+     */
+    setBold(enabled: boolean): this;
+    /**
+     * Sets underline text mode
+     *
+     * @param enabled - Enable or disable underline
+     * @returns this - For method chaining
+     */
+    setUnderline(enabled: boolean): this;
+    /**
+     * Sets inverse printing mode (white on black)
+     *
+     * @param enabled - Enable or disable inverse
+     * @returns this - For method chaining
+     */
+    setInverse(enabled: boolean): this;
+    /**
+     * Sets multiple text style properties at once
+     *
+     * @param style - Text style configuration
+     * @returns this - For method chaining
+     */
+    setStyle(style: TextStyle): this;
+    /**
+     * Resets all text formatting to default
+     *
+     * @returns this - For method chaining
+     */
+    resetStyle(): this;
+    /**
+     * Adds a 1D barcode to the print queue
+     *
+     * @param content - Barcode content/data
+     * @param options - Barcode options
+     * @returns this - For method chaining
+     */
+    barcode(content: string, options: BarcodeOptions): this;
+    /**
+     * Gets the current buffer
+     *
+     * @returns Uint8Array - Current print buffer
+     */
+    getBuffer(): Uint8Array;
+    /**
+     * Gets the total number of bytes in the buffer
+     *
+     * @returns number - Total bytes
+     */
+    getTotalBytes(): number;
+}

package/dist/types/services/interfaces/IConnectionManager.d.ts

@@ -0,0 +1,49 @@
+import { PrinterState, IPrinterAdapter } from '../../types';
+/**
+ * Connection Manager Interface
+ *
+ * Manages Bluetooth device connections
+ */
+export interface IConnectionManager {
+    /**
+     * Connects to a Bluetooth device
+     *
+     * @param deviceId - Bluetooth device ID
+     * @param options - Connection options
+     * @returns Promise<void>
+     */
+    connect(deviceId: string, options?: {
+        retries?: number;
+        timeout?: number;
+    }): Promise<void>;
+    /**
+     * Disconnects from the current device
+     *
+     * @returns Promise<void>
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Checks if a device is connected
+     *
+     * @returns boolean - True if connected, false otherwise
+     */
+    isConnected(): boolean;
+    /**
+     * Gets the current device ID
+     *
+     * @returns string | null - Device ID or null if not connected
+     */
+    getDeviceId(): string | null;
+    /**
+     * Gets the current connection state
+     *
+     * @returns PrinterState - Current state
+     */
+    getState(): PrinterState;
+    /**
+     * Gets the printer adapter instance
+     *
+     * @returns IPrinterAdapter - Printer adapter
+     */
+    getAdapter(): IPrinterAdapter;
+}

package/dist/types/services/interfaces/IPrintJobManager.d.ts

@@ -0,0 +1,67 @@
+import { IAdapterOptions } from '../../types';
+/**
+ * Print Job Manager Interface
+ *
+ * Manages print jobs, including pause/resume/cancel functionality
+ */
+export interface IPrintJobManager {
+    /**
+     * Starts a print job
+     *
+     * @param buffer - Print data buffer
+     * @returns Promise<void>
+     */
+    start(buffer: Uint8Array, options?: {
+        jobId?: string;
+    }): Promise<void>;
+    /**
+     * Pauses the current print job
+     */
+    pause(): void;
+    /**
+     * Resumes a paused print job
+     *
+     * @returns Promise<void>
+     */
+    resume(jobId?: string): Promise<void>;
+    /**
+     * Cancels the current print job
+     */
+    cancel(): void;
+    /**
+     * Gets the number of bytes remaining to print
+     *
+     * @returns number - Bytes remaining
+     */
+    remaining(): number;
+    /**
+     * Checks if the print job is paused
+     *
+     * @returns boolean - True if paused, false otherwise
+     */
+    isPaused(): boolean;
+    /**
+     * Checks if a print job is in progress
+     *
+     * @returns boolean - True if in progress, false otherwise
+     */
+    isInProgress(): boolean;
+    /**
+     * Sets adapter options for write operations
+     *
+     * @param options - Adapter options
+     */
+    setOptions(options: IAdapterOptions): void;
+    /**
+     * Sets the progress callback
+     *
+     * @param callback - Progress callback function
+     */
+    setProgressCallback(callback?: (sent: number, total: number) => void): void;
+    /**
+     * Sets the job state change callback
+     *
+     * @param callback - Job state change callback function
+     */
+    setJobStateCallback(callback?: (state: 'in-progress' | 'paused' | 'completed' | 'cancelled') => void): void;
+}

package/dist/types/services/interfaces/index.d.ts

@@ -1,237 +1,10 @@
-import { IAdapterOptions, IQrOptions, PrinterState, IPrinterAdapter } from '../../types';
-import { TextAlign, TextStyle } from '../../formatter';
-import { BarcodeOptions } from '../../barcode';
 /**
- * Connection Manager Interface
+ * Service Interfaces
  *
- * Manages Bluetooth device connections
- */
-export interface IConnectionManager {
-    /**
-     * Connects to a Bluetooth device
-     *
-     * @param deviceId - Bluetooth device ID
-     * @param options - Connection options
-     * @returns Promise<void>
-     */
-    connect(deviceId: string, options?: {
-        retries?: number;
-        timeout?: number;
-    }): Promise<void>;
-    /**
-     * Disconnects from the current device
-     *
-     * @returns Promise<void>
-     */
-    disconnect(): Promise<void>;
-    /**
-     * Checks if a device is connected
-     *
-     * @returns boolean - True if connected, false otherwise
-     */
-    isConnected(): boolean;
-    /**
-     * Gets the current device ID
-     *
-     * @returns string | null - Device ID or null if not connected
-     */
-    getDeviceId(): string | null;
-    /**
-     * Gets the current connection state
-     *
-     * @returns PrinterState - Current state
-     */
-    getState(): PrinterState;
-    /**
-     * Gets the printer adapter instance
-     *
-     * @returns IPrinterAdapter - Printer adapter
-     */
-    getAdapter(): IPrinterAdapter;
-}
-/**
- * Print Job Manager Interface
- *
- * Manages print jobs, including pause/resume/cancel functionality
- */
-export interface IPrintJobManager {
-    /**
-     * Starts a print job
-     *
-     * @param buffer - Print data buffer
-     * @returns Promise<void>
-     */
-    start(buffer: Uint8Array, options?: {
-        jobId?: string;
-    }): Promise<void>;
-    /**
-     * Pauses the current print job
-     */
-    pause(): void;
-    /**
-     * Resumes a paused print job
-     *
-     * @returns Promise<void>
-     */
-    resume(jobId?: string): Promise<void>;
-    /**
-     * Cancels the current print job
-     */
-    cancel(): void;
-    /**
-     * Gets the number of bytes remaining to print
-     *
-     * @returns number - Bytes remaining
-     */
-    remaining(): number;
-    /**
-     * Checks if the print job is paused
-     *
-     * @returns boolean - True if paused, false otherwise
-     */
-    isPaused(): boolean;
-    /**
-     * Checks if a print job is in progress
-     *
-     * @returns boolean - True if in progress, false otherwise
-     */
-    isInProgress(): boolean;
-    /**
-     * Sets adapter options for write operations
-     *
-     * @param options - Adapter options
-     */
-    setOptions(options: IAdapterOptions): void;
-    /**
-     * Sets the progress callback
-     *
-     * @param callback - Progress callback function
-     */
-    setProgressCallback(callback?: (sent: number, total: number) => void): void;
-    /**
-     * Sets the job state change callback
-     *
-     * @param callback - Job state change callback function
-     */
-    setJobStateCallback(callback?: (state: 'in-progress' | 'paused' | 'completed' | 'cancelled') => void): void;
-}
-/**
- * Command Builder Interface
+ * Defines the interfaces for the core services used by BluetoothPrinter
  *
- * Builds print commands using the printer driver
+ * @packageDocumentation
  */
-export interface ICommandBuilder {
-    /**
-     * Adds text to the print queue
-     *
-     * @param content - Text content
-     * @param encoding - Text encoding
-     * @returns this - For method chaining
-     */
-    text(content: string, encoding?: string): this;
-    /**
-     * Adds line feeds to the print queue
-     *
-     * @param lines - Number of lines to feed
-     * @returns this - For method chaining
-     */
-    feed(lines?: number): this;
-    /**
-     * Adds a paper cut command to the print queue
-     *
-     * @returns this - For method chaining
-     */
-    cut(): this;
-    /**
-     * Adds an image to the print queue
-     *
-     * @param data - Image data as Uint8Array
-     * @param width - Image width
-     * @param height - Image height
-     * @returns this - For method chaining
-     */
-    image(data: Uint8Array, width: number, height: number): this;
-    /**
-     * Adds a QR code to the print queue
-     *
-     * @param content - QR code content
-     * @param options - QR code options
-     * @returns this - For method chaining
-     */
-    qr(content: string, options?: IQrOptions): this;
-    /**
-     * Clears the print queue
-     *
-     * @returns this - For method chaining
-     */
-    clear(): this;
-    /**
-     * Sets text alignment
-     *
-     * @param alignment - Text alignment (left, center, right)
-     * @returns this - For method chaining
-     */
-    align(alignment: TextAlign): this;
-    /**
-     * Sets character size (width and height scale)
-     *
-     * @param width - Width scale factor (1-8)
-     * @param height - Height scale factor (1-8)
-     * @returns this - For method chaining
-     */
-    setSize(width: number, height: number): this;
-    /**
-     * Sets bold text mode
-     *
-     * @param enabled - Enable or disable bold
-     * @returns this - For method chaining
-     */
-    setBold(enabled: boolean): this;
-    /**
-     * Sets underline text mode
-     *
-     * @param enabled - Enable or disable underline
-     * @returns this - For method chaining
-     */
-    setUnderline(enabled: boolean): this;
-    /**
-     * Sets inverse printing mode (white on black)
-     *
-     * @param enabled - Enable or disable inverse
-     * @returns this - For method chaining
-     */
-    setInverse(enabled: boolean): this;
-    /**
-     * Sets multiple text style properties at once
-     *
-     * @param style - Text style configuration
-     * @returns this - For method chaining
-     */
-    setStyle(style: TextStyle): this;
-    /**
-     * Resets all text formatting to default
-     *
-     * @returns this - For method chaining
-     */
-    resetStyle(): this;
-    /**
-     * Adds a 1D barcode to the print queue
-     *
-     * @param content - Barcode content/data
-     * @param options - Barcode options
-     * @returns this - For method chaining
-     */
-    barcode(content: string, options: BarcodeOptions): this;
-    /**
-     * Gets the current buffer
-     *
-     * @returns Uint8Array - Current print buffer
-     */
-    getBuffer(): Uint8Array;
-    /**
-     * Gets the total number of bytes in the buffer
-     *
-     * @returns number - Total bytes
-     */
-    getTotalBytes(): number;
-}
+export type { IConnectionManager } from './IConnectionManager';
+export type { IPrintJobManager } from './IPrintJobManager';
+export type { ICommandBuilder } from './ICommandBuilder';

package/dist/types/template/TemplateEngine.d.ts

@@ -1,5 +1,19 @@
-import { TextAlign } from '../formatter';
-import { BarcodeFormat } from '../barcode';
+/**
+ * Template Engine
+ *
+ * Provides template parsing and rendering for receipts and labels.
+ * Supports variable substitution, conditional rendering, loops, and border/table drawing.
+ *
+ * @example
+ * ```typescript
+ * const engine = new TemplateEngine();
+ * const commands = engine.renderReceipt({
+ *   store: { name: 'My Store' },
+ *   items: [{ name: 'Item 1', quantity: 2, price: 10 }],
+ *   payment: { total: 20, method: 'Cash' }
+ * });
+ * ```
+ */
 /**
  * Template type
  */
@@ -64,7 +78,7 @@ export interface LabelData {
     name: string;
     price: number;
     barcode?: string;
-    barcodeFormat?: BarcodeFormat;
+    barcodeFormat?: import('../barcode').BarcodeFormat;
     spec?: string;
     productionDate?: string;
     expiryDate?: string;
@@ -155,9 +169,9 @@ export interface TableColumn {
     /** Width of column in characters */
     width: number;
     /** Text alignment for header */
-    headerAlign?: TextAlign;
+    headerAlign?: import('../formatter').TextAlign;
     /** Text alignment for cells */
-    cellAlign?: TextAlign;
+    cellAlign?: import('../formatter').TextAlign;
 }
 /**
  * Table row data
@@ -186,7 +200,7 @@ export interface TableElement {
 export type TemplateElement = {
     type: 'text';
     content: string;
-    align?: TextAlign;
+    align?: import('../formatter').TextAlign;
     size?: number;
     bold?: boolean;
 } | {
@@ -205,7 +219,7 @@ export type TemplateElement = {
 } | {
     type: 'barcode';
     content: string;
-    format: BarcodeFormat;
+    format: import('../barcode').BarcodeFormat;
     height?: number;
 } | {
     type: 'feed';
@@ -247,15 +261,13 @@ export interface ITemplateEngine {
 }
 /**
  * Template Engine class
- * Renders print templates to ESC/POS commands
+ * Facade for template parsing and rendering
  */
 export declare class TemplateEngine implements ITemplateEngine {
     private readonly logger;
-    private readonly formatter;
-    private readonly barcodeGenerator;
-    private readonly driver;
+    private readonly parser;
+    private readonly renderer;
     private readonly templates;
-    private readonly paperWidth;
     /**
      * Creates a new TemplateEngine instance
      */
@@ -284,61 +296,5 @@ export declare class TemplateEngine implements ITemplateEngine {
      * Validate template data
      */
     validate(template: TemplateDefinition, data: Record<string, unknown>): ValidationResult;
-    /**
-     * Render a single template element
-     */
-    private renderElement;
-    /**
-     * Render a loop element
-     */
-    private renderLoop;
-    /**
-     * Render a condition element
-     */
-    private renderCondition;
-    /**
-     * Evaluate a condition
-     */
-    private evaluateCondition;
-    /**
-     * Render a border element
-     */
-    private renderBorder;
-    /**
-     * Render a table element
-     */
-    private renderTable;
-    /**
-     * Align text within a specified width
-     */
-    private alignText;
-    /**
-     * Render standard elements (text, line, image, qrcode, barcode, feed, variable)
-     */
-    private renderStandardElement;
-    /**
-     * Render a separator line
-     */
-    private renderLine;
-    /**
-     * Format an item line with columns
-     */
-    private formatItemLine;
-    /**
-     * Substitute variables in a string
-     */
-    private substituteVariables;
-    /**
-     * Get nested value from object
-     */
-    private getNestedValue;
-    /**
-     * Format a value with optional format string
-     */
-    private formatValue;
-    /**
-     * Combine multiple command arrays into one
-     */
-    private combineCommands;
 }
 export declare const templateEngine: TemplateEngine;