taro-bluetooth-print 2.4.0 → 2.5.0

package/dist/types/utils/image.d.ts

@@ -2,155 +2,76 @@
  * Image Processing Utilities
  *
  * Provides methods for converting images to printer-compatible formats.
- * Currently supports converting RGBA images to monochrome bitmaps using various dithering algorithms.
+ * Supports multiple dithering algorithms and image preprocessing.
  */
 export declare class ImageProcessing {
+    private static readonly BAYER_MATRIX_2;
+    private static readonly BAYER_MATRIX_4;
+    private static readonly BAYER_MATRIX_8;
+    private static readonly QUALITY_PRESETS;
     /**
      * Convert RGBA data to monochrome bitmap (1 bit per pixel)
      * suitable for ESC/POS GS v 0 command.
-     * Uses Floyd-Steinberg dithering for better quality by default.
-     *
-     * @param data - RGBA pixel data as Uint8Array
-     * @param width - Image width in pixels
-     * @param height - Image height in pixels
-     * @param options - Additional options for image processing
-     * @returns Monochrome bitmap data as Uint8Array
      *
      * @example
      * ```typescript
-     * const imageData = new Uint8Array(width * height * 4); // RGBA
-     * const bitmap = ImageProcessing.toBitmap(imageData, width, height, {
+     * const bitmap = ImageProcessing.toBitmap(rgbaData, width, height, {
      *   targetWidth: 384,
-     *   ditheringAlgorithm: 'atkinson',
+     *   ditheringAlgorithm: 'ordered',
      *   contrast: 1.2,
      *   brightness: 0.1
      * });
      * ```
      */
     static toBitmap(data: Uint8Array, width: number, height: number, options?: {
-        /** Target width for scaling (optional) */
         targetWidth?: number;
-        /** Target height for scaling (optional) */
         targetHeight?: number;
-        /** Whether to use dithering (default: true) */
         useDithering?: boolean;
-        /** Dithering algorithm to use: 'floyd-steinberg' | 'atkinson' (default: 'floyd-steinberg') */
-        ditheringAlgorithm?: 'floyd-steinberg' | 'atkinson';
-        /** Scaling algorithm to use: 'nearest' for nearest neighbor, 'bilinear' for bilinear interpolation (default: 'nearest') */
+        /** 'floyd-steinberg' | 'atkinson' | 'ordered' | 'halftone' | 'sierra' | 'stucki' (default: 'floyd-steinberg') */
+        ditheringAlgorithm?: 'floyd-steinberg' | 'atkinson' | 'ordered' | 'halftone' | 'sierra' | 'stucki';
         scalingAlgorithm?: 'nearest' | 'bilinear';
-        /** Contrast adjustment factor (1.0 = no adjustment) */
         contrast?: number;
-        /** Brightness adjustment factor (0.0 = no adjustment, negative = darker, positive = brighter) */
         brightness?: number;
-        /** Threshold value for binarization (0-255, default: 128) */
         threshold?: number;
+        orderedMatrixSize?: 2 | 4 | 8;
+        halftoneDotType?: 'round' | 'diamond' | 'square';
+        qualityPreset?: 'draft' | 'normal' | 'high';
     }): Uint8Array;
     /**
-     * Convert RGBA data to grayscale using optimized formula
-     *
-     * @param data - RGBA pixel data as Uint8Array
-     * @param width - Image width in pixels
-     * @param height - Image height in pixels
-     * @returns Grayscale image data as Float32Array
+     * Image preprocessing pipeline
+     * @example
+     * ```typescript
+     * const processed = ImageProcessing.preprocessImage(data, w, h, {
+     *   denoise: true,
+     *   sharpen: true,
+     *   gamma: 1.2,
+     *   posterize: 4
+     * });
+     * ```
      */
+    static preprocessImage(data: Uint8Array, width: number, height: number, options?: {
+        denoise?: boolean;
+        sharpen?: boolean;
+        gamma?: number;
+        posterize?: number;
+    }): Uint8Array;
     private static toGrayscale;
-    /**
-     * Adjust contrast and brightness of grayscale image
-     *
-     * @param grayscale - Grayscale image data
-     * @param contrast - Contrast adjustment factor (1.0 = no adjustment)
-     * @param brightness - Brightness adjustment factor (0.0 = no adjustment)
-     * @returns Adjusted grayscale image data
-     */
     private static adjustContrastBrightness;
-    /**
-     * Apply dithering to grayscale image using specified algorithm
-     *
-     * @param grayscale - Grayscale image data
-     * @param width - Image width
-     * @param height - Image height
-     * @param bitmap - Output bitmap buffer
-     * @param bytesPerLine - Number of bytes per line in the bitmap
-     * @param algorithm - Dithering algorithm to use
-     * @param threshold - Threshold value for binarization
-     */
     private static applyDithering;
-    /**
-     * Apply simple thresholding to grayscale image with adjustable threshold
-     *
-     * @param grayscale - Grayscale image data
-     * @param width - Image width
-     * @param height - Image height
-     * @param bitmap - Output bitmap buffer
-     * @param bytesPerLine - Number of bytes per line in the bitmap
-     * @param threshold - Threshold value for binarization (0-255)
-     */
+    private static applyFloydSteinbergDithering;
+    private static applyAtkinsonDithering;
+    private static applyOrderedDithering;
+    private static applyHalftone;
+    private static computeHalftoneThresholds;
+    private static applySierraDithering;
+    private static applyStuckiDithering;
     private static applyThreshold;
-    /**
-     * Scale an image to new dimensions
-     *
-     * @param data - RGBA pixel data as Uint8Array
-     * @param width - Original image width in pixels
-     * @param height - Original image height in pixels
-     * @param targetWidth - Target width in pixels
-     * @param targetHeight - Target height in pixels
-     * @param options - Additional scaling options
-     * @returns Scaled image data and dimensions
-     */
+    private static distributeErr;
     private static scaleImage;
-    /**
-     * Apply nearest neighbor scaling to an image
-     *
-     * @param srcData - Source RGBA pixel data
-     * @param srcWidth - Source image width
-     * @param srcHeight - Source image height
-     * @param destData - Destination RGBA pixel data
-     * @param destWidth - Destination image width
-     * @param destHeight - Destination image height
-     */
     private static applyNearestNeighbor;
-    /**
-     * Apply bilinear interpolation scaling to an image
-     *
-     * @param srcData - Source RGBA pixel data
-     * @param srcWidth - Source image width
-     * @param srcHeight - Source image height
-     * @param destData - Destination RGBA pixel data
-     * @param destWidth - Destination image width
-     * @param destHeight - Destination image height
-     */
     private static applyBilinearInterpolation;
-    /**
-     * Distribute quantization error to neighboring pixels using Floyd-Steinberg algorithm
-     *
-     * @param grayscale - Grayscale image data
-     * @param width - Image width
-     * @param height - Image height
-     * @param x - Current x position
-     * @param y - Current y position
-     * @param error - Quantization error to distribute
-     */
-    private static distributeErrorFloydSteinberg;
-    /**
-     * Distribute quantization error to neighboring pixels using Atkinson algorithm
-     *
-     * @param grayscale - Grayscale image data
-     * @param width - Image width
-     * @param height - Image height
-     * @param x - Current x position
-     * @param y - Current y position
-     * @param error - Quantization error to distribute
-     */
-    private static distributeErrorAtkinson;
-    /**
-     * Distribute error to a single pixel with bounds checking
-     *
-     * @param grayscale - Grayscale image data
-     * @param width - Image width
-     * @param height - Image height
-     * @param nx - New x position
-     * @param ny - New y position
-     * @param error - Error value to distribute
-     */
-    private static distributeErrorPixel;
+    private static applyGammaCorrection;
+    private static applyMedianFilter;
+    private static applyUnsharpMask;
+    private static applyPosterization;
 }

package/dist/types/utils/platform.d.ts

@@ -15,6 +15,8 @@ export declare enum PlatformType {
     BAIDU = "baidu",
     /** ByteDance Mini Program (Douyin, Toutiao) */
     BYTEDANCE = "bytedance",
+    /** QQ Mini Program */
+    QQ = "qq",
     /** Web platform */
     WEB = "web",
     /** Unknown platform */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taro-bluetooth-print",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Taro 蓝牙打印库 v2.4 - 轻量级、高性能、跨平台支持微信、支付宝、百度、字节跳动小程序及H5 Web Bluetooth",
   "type": "module",
   "main": "dist/index.cjs.js",

package/src/adapters/AdapterFactory.ts

@@ -9,6 +9,7 @@ import { TaroAdapter } from './TaroAdapter';
 import { AlipayAdapter } from './AlipayAdapter';
 import { BaiduAdapter } from './BaiduAdapter';
 import { ByteDanceAdapter } from './ByteDanceAdapter';
+import { QQAdapter } from './QQAdapter';
 import { WebBluetoothAdapter } from './WebBluetoothAdapter';
 import { PlatformType, detectPlatform } from '@/utils/platform';
 import { BluetoothPrintError, ErrorCode } from '@/errors/BluetoothError';
@@ -35,6 +36,8 @@ export class AdapterFactory {
         return new BaiduAdapter();
       case PlatformType.BYTEDANCE:
         return new ByteDanceAdapter();
+      case PlatformType.QQ:
+        return new QQAdapter();
       case PlatformType.WEB:
         if (WebBluetoothAdapter.isSupported()) {
           return new WebBluetoothAdapter();
@@ -68,6 +71,8 @@ export class AdapterFactory {
         return new BaiduAdapter();
       case PlatformType.BYTEDANCE:
         return new ByteDanceAdapter();
+      case PlatformType.QQ:
+        return new QQAdapter();
       case PlatformType.WEB:
         if (WebBluetoothAdapter.isSupported()) {
           return new WebBluetoothAdapter();

package/src/adapters/QQAdapter.ts

@@ -0,0 +1,36 @@
+/**
+ * QQ Mini Program Bluetooth Adapter
+ * Implements the IPrinterAdapter interface for QQ Mini Program
+ */
+
+import { MiniProgramAdapter, MiniProgramBLEApi } from './BaseAdapter';
+
+// Declare QQ global for TypeScript
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+interface QQGlobal extends MiniProgramBLEApi {}
+
+declare const qq: QQGlobal;
+
+/**
+ * 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 class QQAdapter extends MiniProgramAdapter {
+  /**
+   * Returns the QQ mini-program BLE API object
+   * @returns The qq global object providing BLE capabilities
+   */
+  protected getApi(): MiniProgramBLEApi {
+    return qq;
+  }
+}