taro-bluetooth-print 2.8.3 → 2.9.0

package/src/services/interfaces/index.ts

@@ -2,271 +2,11 @@
  * Service Interfaces
  *
  * Defines the interfaces for the core services used by BluetoothPrinter
- */
-
-import { IAdapterOptions, IQrOptions, PrinterState, IPrinterAdapter } from '@/types';
-import { TextAlign, TextStyle } from '@/formatter';
-import { BarcodeOptions } from '@/barcode';
-
-/**
- * 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;
-}
-
-/**
- * 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
  *
- * 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;
-}
+// Re-export individual interfaces for tree-shaking and clear dependencies
+export type { IConnectionManager } from './IConnectionManager';
+export type { IPrintJobManager } from './IPrintJobManager';
+export type { ICommandBuilder } from './ICommandBuilder';

package/src/utils/image.ts

@@ -199,9 +199,9 @@ export class ImageProcessing {
     const grayscale = new Float32Array(width * height);
     for (let i = 0; i < data.length; i += 4) {
       const idx = i >> 2;
-      const r = data[i];
-      const g = data[i + 1];
-      const b = data[i + 2];
+      const r = data[i]!;
+      const g = data[i + 1]!;
+      const b = data[i + 2]!;
       grayscale[idx] = (r * 299 + g * 587 + b * 114) / 1000;
     }
     return grayscale;
@@ -215,7 +215,7 @@ export class ImageProcessing {
     if (contrast === 1.0 && brightness === 0.0) return grayscale;
     const adjusted = new Float32Array(grayscale);
     for (let i = 0; i < adjusted.length; i++) {
-      const value = adjusted[i];
+      const value = adjusted[i]!;
       adjusted[i] = Math.max(0, Math.min(255, (value - 128) * contrast + 128 + brightness * 255));
     }
     return adjusted;
@@ -292,13 +292,13 @@ export class ImageProcessing {
       for (let x = 0; x < width; x++) {
         const idx = y * width + x;
         const oldPixel = grayscale[idx];
-        const newPixel = oldPixel < threshold ? 0 : 255;
+        const newPixel = oldPixel! < threshold ? 0 : 255;
         if (newPixel === 0) {
           const byteIdx = y * bytesPerLine + Math.floor(x / 8);
           const bitIdx = 7 - (x % 8);
-          bitmap[byteIdx] = bitmap[byteIdx] | (1 << bitIdx);
+          bitmap[byteIdx] = bitmap[byteIdx]! | (1 << bitIdx);
         }
-        const err = oldPixel - newPixel;
+        const err = oldPixel! - newPixel;
         this.distributeErr(grayscale, width, height, x + 1, y, (err * 7) / 16);
         this.distributeErr(grayscale, width, height, x - 1, y + 1, (err * 3) / 16);
         this.distributeErr(grayscale, width, height, x, y + 1, (err * 5) / 16);
@@ -321,13 +321,13 @@ export class ImageProcessing {
       for (let x = 0; x < width; x++) {
         const idx = y * width + x;
         const oldPixel = grayscale[idx];
-        const newPixel = oldPixel < threshold ? 0 : 255;
+        const newPixel = oldPixel! < threshold ? 0 : 255;
         if (newPixel === 0) {
           const byteIdx = y * bytesPerLine + Math.floor(x / 8);
           const bitIdx = 7 - (x % 8);
-          bitmap[byteIdx] = bitmap[byteIdx] | (1 << bitIdx);
+          bitmap[byteIdx] = bitmap[byteIdx]! | (1 << bitIdx);
         }
-        const err = (oldPixel - newPixel) / 8;
+        const err = (oldPixel! - newPixel) / 8;
         this.distributeErr(grayscale, width, height, x + 1, y, err);
         this.distributeErr(grayscale, width, height, x + 2, y, err);
         this.distributeErr(grayscale, width, height, x - 1, y + 1, err);
@@ -364,10 +364,10 @@ export class ImageProcessing {
         const bayerRow = matrix[y % matrixSize] ?? [];
         const bayerVal = bayerRow[x % matrixSize] ?? 0;
         const adjustedThreshold = thresholdOffset + (bayerVal / matrixMax) * 48;
-        if (pixel < adjustedThreshold) {
+        if (pixel! < adjustedThreshold) {
           const byteIdx = y * bytesPerLine + Math.floor(x / 8);
           const bitIdx = 7 - (x % 8);
-          bitmap[byteIdx] = bitmap[byteIdx] | (1 << bitIdx);
+          bitmap[byteIdx] = bitmap[byteIdx]! | (1 << bitIdx);
         }
       }
     }
@@ -394,11 +394,11 @@ export class ImageProcessing {
         const localX = x % cellSize;
         const row = thresholds[localY] ?? [];
         const t = row[localX] ?? 128;
-        const adjusted = t + (pixel < threshold ? -30 : 30);
-        if (pixel < adjusted) {
+        const adjusted = t + (pixel! < threshold ? -30 : 30);
+        if (pixel! < adjusted) {
           const byteIdx = y * bytesPerLine + Math.floor(x / 8);
           const bitIdx = 7 - (x % 8);
-          bitmap[byteIdx] = bitmap[byteIdx] | (1 << bitIdx);
+          bitmap[byteIdx] = bitmap[byteIdx]! | (1 << bitIdx);
         }
       }
     }
@@ -441,13 +441,13 @@ export class ImageProcessing {
       for (let x = 0; x < width; x++) {
         const idx = y * width + x;
         const oldPixel = grayscale[idx];
-        const newPixel = oldPixel < threshold ? 0 : 255;
+        const newPixel = oldPixel! < threshold ? 0 : 255;
         if (newPixel === 0) {
           const byteIdx = y * bytesPerLine + Math.floor(x / 8);
           const bitIdx = 7 - (x % 8);
-          bitmap[byteIdx] = bitmap[byteIdx] | (1 << bitIdx);
+          bitmap[byteIdx] = bitmap[byteIdx]! | (1 << bitIdx);
         }
-        const err = oldPixel - newPixel;
+        const err = oldPixel! - newPixel;
         this.distributeErr(grayscale, width, height, x + 1, y, (err * 5) / 32);
         this.distributeErr(grayscale, width, height, x - 1, y + 1, (err * 3) / 32);
         this.distributeErr(grayscale, width, height, x, y + 1, (err * 5) / 32);
@@ -475,13 +475,13 @@ export class ImageProcessing {
       for (let x = 0; x < width; x++) {
         const idx = y * width + x;
         const oldPixel = grayscale[idx];
-        const newPixel = oldPixel < threshold ? 0 : 255;
+        const newPixel = oldPixel! < threshold ? 0 : 255;
         if (newPixel === 0) {
           const byteIdx = y * bytesPerLine + Math.floor(x / 8);
           const bitIdx = 7 - (x % 8);
-          bitmap[byteIdx] = bitmap[byteIdx] | (1 << bitIdx);
+          bitmap[byteIdx] = bitmap[byteIdx]! | (1 << bitIdx);
         }
-        const err = oldPixel - newPixel;
+        const err = oldPixel! - newPixel;
         this.distributeErr(grayscale, width, height, x + 1, y, (err * 8) / 42);
         this.distributeErr(grayscale, width, height, x + 2, y, (err * 4) / 42);
         this.distributeErr(grayscale, width, height, x - 2, y + 1, (err * 2) / 42);
@@ -512,10 +512,10 @@ export class ImageProcessing {
       for (let x = 0; x < width; x++) {
         const idx = y * width + x;
         const pixel = grayscale[idx];
-        if (pixel < threshold) {
+        if (pixel! < threshold) {
           const byteIdx = y * bytesPerLine + Math.floor(x / 8);
           const bitIdx = 7 - (x % 8);
-          bitmap[byteIdx] = bitmap[byteIdx] | (1 << bitIdx);
+          bitmap[byteIdx] = bitmap[byteIdx]! | (1 << bitIdx);
         }
       }
     }
@@ -534,7 +534,7 @@ export class ImageProcessing {
     if (nx >= 0 && nx < width && ny >= 0 && ny < height) {
       const idx = ny * width + nx;
       const current = grayscale[idx];
-      grayscale[idx] = Math.max(0, Math.min(255, current + error));
+      grayscale[idx] = Math.max(0, Math.min(255, current! + error));
     }
   }
 
@@ -581,10 +581,10 @@ export class ImageProcessing {
         const sjy = Math.min(srcHeight - 1, Math.round(y * sy));
         const si = (sjy * srcWidth + sjx) * 4;
         const di = (y * destWidth + x) * 4;
-        destData[di] = srcData[si];
-        destData[di + 1] = srcData[si + 1];
-        destData[di + 2] = srcData[si + 2];
-        destData[di + 3] = srcData[si + 3];
+        destData[di] = srcData[si]!;
+        destData[di + 1] = srcData[si + 1]!;
+        destData[di + 2] = srcData[si + 2]!;
+        destData[di + 3] = srcData[si + 3]!;
       }
     }
   }
@@ -618,7 +618,8 @@ export class ImageProcessing {
           const ii2 = (y1 * srcWidth + x2) * 4 + c;
           const ii3 = (y2 * srcWidth + x1) * 4 + c;
           const ii4 = (y2 * srcWidth + x2) * 4 + c;
-          const v = srcData[ii1] * w1 + srcData[ii2] * w2 + srcData[ii3] * w3 + srcData[ii4] * w4;
+          const v =
+            srcData[ii1]! * w1 + srcData[ii2]! * w2 + srcData[ii3]! * w3 + srcData[ii4]! * w4;
           destData[(y * destWidth + x) * 4 + c] = Math.round(v);
         }
       }
@@ -636,12 +637,12 @@ export class ImageProcessing {
     const result = new Uint8Array(data.length);
     for (let i = 0; i < data.length; i += 4) {
       // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- lut has 256 entries, data[i] is 0-255
-      result[i] = lut[data[i]]!;
+      result[i] = lut[data[i]!]!;
       // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-      result[i + 1] = lut[data[i + 1]]!;
+      result[i + 1] = lut[data[i + 1]!]!;
       // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-      result[i + 2] = lut[data[i + 2]]!;
-      result[i + 3] = data[i + 3];
+      result[i + 2] = lut[data[i + 2]!]!;
+      result[i + 3] = data[i + 3]!;
     }
     return result;
   }
@@ -658,7 +659,7 @@ export class ImageProcessing {
             const ny2 = Math.max(0, Math.min(height - 1, y + dy));
             const si = (ny2 * width + nx) * 4;
             for (let c = 0; c < 4; c++) {
-              window.push(data[si + c]);
+              window.push(data[si + c]!);
             }
           }
         }
@@ -691,7 +692,7 @@ export class ImageProcessing {
               const ny2 = Math.max(0, Math.min(height - 1, y + ky - kHalf));
               const si = (ny2 * width + nx) * 4 + c;
               const kv = kernel[ky]?.[kx] ?? 0;
-              sum += data[si] * kv;
+              sum += data[si]! * kv;
             }
           }
           result[di + c] = Math.max(0, Math.min(255, Math.round(sum)));
@@ -702,14 +703,15 @@ export class ImageProcessing {
   }
 
   private static applyPosterization(data: Uint8Array, levels: number): Uint8Array {
+    if (data.length < 4) return new Uint8Array(0);
     const lv = Math.max(1, Math.min(8, levels));
     const step = 255 / (Math.pow(2, lv) - 1);
     const result = new Uint8Array(data.length);
     for (let i = 0; i < data.length; i += 4) {
-      result[i] = Math.round(Math.round(data[i] / step) * step);
-      result[i + 1] = Math.round(Math.round(data[i + 1] / step) * step);
-      result[i + 2] = Math.round(Math.round(data[i + 2] / step) * step);
-      result[i + 3] = data[i + 3];
+      result[i] = Math.round(Math.round(data[i]! / step) * step);
+      result[i + 1] = Math.round(Math.round(data[i + 1]! / step) * step);
+      result[i + 2] = Math.round(Math.round(data[i + 2]! / step) * step);
+      result[i + 3] = data[i + 3]!;
     }
     return result;
   }