@scr2em/capacitor-scanner 6.0.31 → 6.0.34

package/README.md

@@ -262,7 +262,7 @@ Set the camera zoom level.
 
 #### StartOptions
 
-<code>{ /** * Barcode formats to detect when barcodeDetection is enabled. */ formats?: BarcodeFormat[]; /** * Camera direction to use. Defaults to 'BACK'. */ cameraDirection?: 'BACK' | 'FRONT'; /** * Enable barcode detection on start. Defaults to false. * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events. */ barcodeDetection?: boolean; /** * Whether to show the highlight overlay for detected barcodes. Defaults to false. * Only applies when barcodeDetection is true. */ barcodeHighlight?: boolean; /** * Enable object detection (business card) on start. Defaults to false. * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events. */ objectDetection?: boolean; /** * Whether to show the highlight overlay for detected business cards. Defaults to true. * Only applies when objectDetection is true. */ objectHighlight?: boolean; /** * Minimum interval in seconds between consecutive 'rectangleDetected' events. * Only applies when objectDetection is true. * Defaults to 0 (no throttling beyond initial stability check). */ rectangleEmitIntervalSeconds?: number; /** * Optional regex pattern to filter scanned barcodes. * If provided, only barcodes matching this pattern will be reported. */ regex?: string; /** * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline). */ regexFlags?: string; /** * Duration in seconds to pause rectangle detection after a barcode is successfully scanned. * When both barcode and object detection are enabled, this gives barcode scanning priority * by temporarily suppressing rectangle detection after a barcode is emitted. * Defaults to 0 (no throttle, both detections run simultaneously). */ detectionThrottleSeconds?: number; }</code>
+<code>{ /** * Barcode formats to detect when barcodeDetection is enabled. */ formats?: BarcodeFormat[]; /** * Camera direction to use. Defaults to 'BACK'. */ cameraDirection?: 'BACK' | 'FRONT'; /** * Enable barcode detection on start. Defaults to false. * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events. */ barcodeDetection?: boolean; /** * Whether to show the highlight overlay for detected barcodes. Defaults to false. * Only applies when barcodeDetection is true. */ barcodeHighlight?: boolean; /** * Enable object detection (business card) on start. Defaults to false. * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events. */ objectDetection?: boolean; /** * Whether to show the highlight overlay for detected business cards. Defaults to true. * Only applies when objectDetection is true. */ objectHighlight?: boolean; /** * Minimum interval in seconds between consecutive 'rectangleDetected' events. * Only applies when objectDetection is true. * Defaults to 0 (no throttling beyond initial stability check). */ rectangleEmitIntervalSeconds?: number; /** * Optional regex pattern to filter scanned barcodes. * If provided, only barcodes matching this pattern will be reported. */ regex?: string; /** * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline). */ regexFlags?: string; /** * Cooldown in seconds after any detection event when both barcode and object detection are enabled. * After a barcode or rectangle is emitted, ALL detection pauses for this duration. * When set, barcode dedup TTL becomes 2x this value and rectangle emit interval becomes 2x this value. * Only applies when both barcodeDetection and objectDetection are true. * Defaults to 0 (no throttle, both detections run simultaneously). */ detectionThrottleSeconds?: number; }</code>
 
 
 #### CapturePhotoOptions

package/android/src/main/java/com/leadliaion/capacitorscanner/CapacitorScannerPlugin.java

@@ -92,7 +92,7 @@ public class CapacitorScannerPlugin extends Plugin {
     private ProcessCameraProvider cameraProvider;
     private BarcodeScanner scanner;
     private RectangleDetector rectangleDetector;
-    private final TTLMap<String, VoteStatus> scannedCodesVotes = new TTLMap<>(5000); // 5 second TTL
+    private TTLMap<String, VoteStatus> scannedCodesVotes = new TTLMap<>(5000); // 5 second TTL
     private final int voteThreshold = 2;
     private final Executor executor = Executors.newSingleThreadExecutor();
     private final AtomicBoolean isScanning = new AtomicBoolean(false);
@@ -143,9 +143,10 @@ public class CapacitorScannerPlugin extends Plugin {
     // Configurable interval between rectangle detection event emissions (in milliseconds)
     private long rectangleEmitIntervalMs = 0; // Default: 0 (no throttling)
 
-    // Detection throttle: pause rectangle detection after a successful barcode scan
+    // Detection throttle: pause ALL detection after any emit (when both types enabled)
     private long detectionThrottleMs = 0; // Default: 0 (no throttle)
-    private long lastSuccessfulBarcodeScanTime = 0;
+    private long lastDetectionEmitTime = 0;
+    private boolean bothDetectionsEnabled = false;
 
     /**
      * Calculates the processing interval in milliseconds based on the desired
@@ -213,39 +214,48 @@ public class CapacitorScannerPlugin extends Plugin {
                 }
             }
 
+            // Read detection throttle
+            if (call.getData().has("detectionThrottleSeconds")) {
+                try {
+                    double throttleSeconds = call.getData().getDouble("detectionThrottleSeconds");
+                    detectionThrottleMs = Math.max(0, (long) (throttleSeconds * 1000));
+                } catch (Exception e) {
+                    detectionThrottleMs = 0;
+                }
+            } else {
+                detectionThrottleMs = 0;
+            }
+            lastDetectionEmitTime = 0;
+            bothDetectionsEnabled = enableBarcodeDetection && enableObjectDetection;
+
             // Enable object detection (businessCard) if requested
             if (enableObjectDetection) {
                 enabledDetectionTypes.add("businessCard");
                 if (enableObjectHighlight) {
                     enabledHighlightTypes.add("businessCard");
                 }
-                // Read rectangleEmitIntervalSeconds if provided
+                // Read rectangleEmitIntervalSeconds: use 2X when both enabled with throttle
+                long emitInterval = 0;
                 if (call.getData().has("rectangleEmitIntervalSeconds")) {
                     try {
                         double intervalSeconds = call.getData().getDouble("rectangleEmitIntervalSeconds");
-                        rectangleEmitIntervalMs = Math.max(0, (long) (intervalSeconds * 1000));
-                        echo("Using custom rectangleEmitIntervalSeconds: " + intervalSeconds + "s (" + rectangleEmitIntervalMs + "ms)");
+                        emitInterval = Math.max(0, (long) (intervalSeconds * 1000));
                     } catch (Exception e) {
-                        echo("Error parsing rectangleEmitIntervalSeconds: " + e.getMessage() + ". Using default 0ms");
-                        rectangleEmitIntervalMs = 0;
+                        emitInterval = 0;
                     }
-                } else {
-                    rectangleEmitIntervalMs = 0;
                 }
+                if (bothDetectionsEnabled && detectionThrottleMs > 0) {
+                    emitInterval = Math.max(emitInterval, detectionThrottleMs * 2);
+                }
+                rectangleEmitIntervalMs = emitInterval;
             }
 
-            // Read detection throttle
-            if (call.getData().has("detectionThrottleSeconds")) {
-                try {
-                    double throttleSeconds = call.getData().getDouble("detectionThrottleSeconds");
-                    detectionThrottleMs = Math.max(0, (long) (throttleSeconds * 1000));
-                } catch (Exception e) {
-                    detectionThrottleMs = 0;
-                }
+            // When both enabled with throttle, set barcode votes TTL to 2X
+            if (bothDetectionsEnabled && detectionThrottleMs > 0) {
+                scannedCodesVotes = new TTLMap<>(detectionThrottleMs * 2);
             } else {
-                detectionThrottleMs = 0;
+                scannedCodesVotes = new TTLMap<>(5000);
             }
-            lastSuccessfulBarcodeScanTime = 0;
 
             try {
                 String cameraDirectionStr = call.getString("cameraDirection", "BACK");
@@ -481,23 +491,18 @@ public class CapacitorScannerPlugin extends Plugin {
             try {
                 InputImage image = InputImage.fromMediaImage(mediaImage, rotationDegrees);
 
-                boolean barcodeEnabled = scanner != null && enabledDetectionTypes.contains("barcode");
-                boolean isRectangleThrottled = detectionThrottleMs > 0
-                        && lastSuccessfulBarcodeScanTime > 0
-                        && (System.currentTimeMillis() - lastSuccessfulBarcodeScanTime) < detectionThrottleMs;
+                // Check if detection is throttled (cooldown after any emit when both types enabled)
+                boolean isThrottled = bothDetectionsEnabled
+                        && detectionThrottleMs > 0
+                        && lastDetectionEmitTime > 0
+                        && (System.currentTimeMillis() - lastDetectionEmitTime) < detectionThrottleMs;
+
+                boolean barcodeEnabled = scanner != null
+                        && enabledDetectionTypes.contains("barcode")
+                        && !isThrottled;
                 boolean rectangleEnabled = rectangleDetector != null
                         && enabledDetectionTypes.contains("businessCard")
-                        && !isRectangleThrottled;
-
-                // Clear rectangle overlay when throttled
-                if (isRectangleThrottled && enabledDetectionTypes.contains("businessCard")) {
-                    getActivity().runOnUiThread(() -> {
-                        synchronized (overlayLock) {
-                            currentRectangleRects.clear();
-                            updateOverlayDetections(currentBarcodeRects, currentRectangleRects);
-                        }
-                    });
-                }
+                        && !isThrottled;
 
                 // Rectangle detection (synchronous) - runs first while imageProxy is still open
                 if (rectangleEnabled) {
@@ -909,8 +914,8 @@ public class CapacitorScannerPlugin extends Plugin {
                     data.put("format", BarcodeFormatHelper.barcodeFormatToString(format));
                     notifyListeners("barcodeScanned", data, true);
 
-                    // Record successful scan time for detection throttle
-                    lastSuccessfulBarcodeScanTime = System.currentTimeMillis();
+                    // Record emit time for detection throttle
+                    lastDetectionEmitTime = System.currentTimeMillis();
 
                     echo("Barcode " + rawValue + " scanned with format: "
                             + BarcodeFormatHelper.barcodeFormatToString(format));
@@ -949,6 +954,8 @@ public class CapacitorScannerPlugin extends Plugin {
 
                 // Update the last notification timestamp
                 lastRectangleNotificationTime = currentTime;
+                // Record emit time for detection throttle
+                lastDetectionEmitTime = currentTime;
             } else {
                 echo("Skipping notification - last one was less than 1 second ago");
             }
@@ -1187,7 +1194,9 @@ public class CapacitorScannerPlugin extends Plugin {
         lastRectangleDetectionTime = 0;
         rectangleEmitIntervalMs = 0;
         detectionThrottleMs = 0;
-        lastSuccessfulBarcodeScanTime = 0;
+        lastDetectionEmitTime = 0;
+        bothDetectionsEnabled = false;
+        scannedCodesVotes = new TTLMap<>(5000);
 
         // Clear detection histories and caches
         enabledDetectionTypes.clear();

package/dist/docs.json

@@ -344,7 +344,7 @@
       "docs": "",
       "types": [
         {
-          "text": "{\n  /**\n   * Barcode formats to detect when barcodeDetection is enabled.\n   */\n  formats?: BarcodeFormat[];\n  /**\n   * Camera direction to use. Defaults to 'BACK'.\n   */\n  cameraDirection?: 'BACK' | 'FRONT';\n  /**\n   * Enable barcode detection on start. Defaults to false.\n   * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events.\n   */\n  barcodeDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected barcodes. Defaults to false.\n   * Only applies when barcodeDetection is true.\n   */\n  barcodeHighlight?: boolean;\n  /**\n   * Enable object detection (business card) on start. Defaults to false.\n   * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events.\n   */\n  objectDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected business cards. Defaults to true.\n   * Only applies when objectDetection is true.\n   */\n  objectHighlight?: boolean;\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * Only applies when objectDetection is true.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  rectangleEmitIntervalSeconds?: number;\n  /**\n   * Optional regex pattern to filter scanned barcodes.\n   * If provided, only barcodes matching this pattern will be reported.\n   */\n  regex?: string;\n  /**\n   * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline).\n   */\n  regexFlags?: string;\n  /**\n   * Duration in seconds to pause rectangle detection after a barcode is successfully scanned.\n   * When both barcode and object detection are enabled, this gives barcode scanning priority\n   * by temporarily suppressing rectangle detection after a barcode is emitted.\n   * Defaults to 0 (no throttle, both detections run simultaneously).\n   */\n  detectionThrottleSeconds?: number;\n}",
+          "text": "{\n  /**\n   * Barcode formats to detect when barcodeDetection is enabled.\n   */\n  formats?: BarcodeFormat[];\n  /**\n   * Camera direction to use. Defaults to 'BACK'.\n   */\n  cameraDirection?: 'BACK' | 'FRONT';\n  /**\n   * Enable barcode detection on start. Defaults to false.\n   * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events.\n   */\n  barcodeDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected barcodes. Defaults to false.\n   * Only applies when barcodeDetection is true.\n   */\n  barcodeHighlight?: boolean;\n  /**\n   * Enable object detection (business card) on start. Defaults to false.\n   * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events.\n   */\n  objectDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected business cards. Defaults to true.\n   * Only applies when objectDetection is true.\n   */\n  objectHighlight?: boolean;\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * Only applies when objectDetection is true.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  rectangleEmitIntervalSeconds?: number;\n  /**\n   * Optional regex pattern to filter scanned barcodes.\n   * If provided, only barcodes matching this pattern will be reported.\n   */\n  regex?: string;\n  /**\n   * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline).\n   */\n  regexFlags?: string;\n  /**\n   * Cooldown in seconds after any detection event when both barcode and object detection are enabled.\n   * After a barcode or rectangle is emitted, ALL detection pauses for this duration.\n   * When set, barcode dedup TTL becomes 2x this value and rectangle emit interval becomes 2x this value.\n   * Only applies when both barcodeDetection and objectDetection are true.\n   * Defaults to 0 (no throttle, both detections run simultaneously).\n   */\n  detectionThrottleSeconds?: number;\n}",
           "complexTypes": [
             "BarcodeFormat"
           ]

package/dist/esm/definitions.d.ts

@@ -115,9 +115,10 @@ export declare type StartOptions = {
      */
     regexFlags?: string;
     /**
-     * Duration in seconds to pause rectangle detection after a barcode is successfully scanned.
-     * When both barcode and object detection are enabled, this gives barcode scanning priority
-     * by temporarily suppressing rectangle detection after a barcode is emitted.
+     * Cooldown in seconds after any detection event when both barcode and object detection are enabled.
+     * After a barcode or rectangle is emitted, ALL detection pauses for this duration.
+     * When set, barcode dedup TTL becomes 2x this value and rectangle emit interval becomes 2x this value.
+     * Only applies when both barcodeDetection and objectDetection are true.
      * Defaults to 0 (no throttle, both detections run simultaneously).
      */
     detectionThrottleSeconds?: number;

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAyKA,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,mCAAkB,CAAA;IAClB,mCAAkB,CAAA;IAClB,qCAAoB,CAAA;IACpB,2CAA0B,CAAA;IAC1B,+BAAc,CAAA;IACd,iCAAgB,CAAA;IAChB,gCAAe,CAAA;IACf,mCAAkB,CAAA;IAClB,mCAAkB,CAAA;IAClB,+BAAc,CAAA;AAChB,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB","sourcesContent":["export interface CapacitorScannerPlugin {\n  /**\n   * Start the camera preview with optional barcode and object detection.\n   * @param options - Configuration options for the camera and detection\n   */\n  start(options?: StartOptions): Promise<void>;\n\n  /**\n   * Stop the camera preview and all detection.\n   */\n  stop(): Promise<void>;\n\n  openSettings(): Promise<void>;\n\n  capturePhoto(options?: CapturePhotoOptions): Promise<CapturePhotoResult>;\n\n  checkPermissions(): Promise<PermissionsResult>;\n\n  requestPermissions(): Promise<PermissionsResult>;\n\n  flipCamera(): Promise<void>;\n\n  toggleFlash(): Promise<FlashResult>;\n\n  addListener(event: 'barcodeScanned', listenerFunc: (result: BarcodeScannedEvent) => void): Promise<void>;\n\n  addListener(event: 'rectangleDetected', listenerFunc: (result: RectangleDetectedEvent) => void): Promise<void>;\n\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Enable object detection (business card). This will start detecting business cards.\n   * @param options - Optional configuration for object detection\n   */\n  enableObjectDetection(options?: ObjectDetectionOptions): Promise<{ enabled: true }>;\n\n  /**\n   * Disable object detection. This will stop detecting business cards.\n   */\n  disableObjectDetection(): Promise<{ enabled: false }>;\n\n  /**\n   * Enable barcode detection. This will start detecting barcodes.\n   * @param options - Optional configuration for barcode detection\n   */\n  enableBarcodeDetection(options?: BarcodeDetectionOptions): Promise<{ enabled: true }>;\n\n  /**\n   * Disable barcode detection. This will stop detecting barcodes and clear cached barcodes.\n   */\n  disableBarcodeDetection(): Promise<{ enabled: false }>;\n\n  /**\n   * Set the camera zoom level.\n   * @param options - The zoom options containing the level (1, 2, or 3)\n   */\n  zoom(options: ZoomOptions): Promise<ZoomResult>;\n}\n\nexport type BarcodeDetectionOptions = {\n  /**\n   * Whether to show the highlight overlay for detected barcodes.\n   * Defaults to false.\n   */\n  showHighlight?: boolean;\n}\n\nexport type ObjectDetectionOptions = {\n  /**\n   * Whether to show the highlight overlay for detected business cards.\n   * Defaults to true.\n   */\n  showHighlight?: boolean,\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * After an event is emitted, no new events will be emitted until this interval passes.\n   * Set to 0 to emit events as soon as stability is detected.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  emitIntervalSeconds?: number\n}\n\nexport type StartOptions = {\n  /**\n   * Barcode formats to detect when barcodeDetection is enabled.\n   */\n  formats?: BarcodeFormat[];\n  /**\n   * Camera direction to use. Defaults to 'BACK'.\n   */\n  cameraDirection?: 'BACK' | 'FRONT';\n  /**\n   * Enable barcode detection on start. Defaults to false.\n   * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events.\n   */\n  barcodeDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected barcodes. Defaults to false.\n   * Only applies when barcodeDetection is true.\n   */\n  barcodeHighlight?: boolean;\n  /**\n   * Enable object detection (business card) on start. Defaults to false.\n   * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events.\n   */\n  objectDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected business cards. Defaults to true.\n   * Only applies when objectDetection is true.\n   */\n  objectHighlight?: boolean;\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * Only applies when objectDetection is true.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  rectangleEmitIntervalSeconds?: number;\n  /**\n   * Optional regex pattern to filter scanned barcodes.\n   * If provided, only barcodes matching this pattern will be reported.\n   */\n  regex?: string;\n  /**\n   * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline).\n   */\n  regexFlags?: string;\n  /**\n   * Duration in seconds to pause rectangle detection after a barcode is successfully scanned.\n   * When both barcode and object detection are enabled, this gives barcode scanning priority\n   * by temporarily suppressing rectangle detection after a barcode is emitted.\n   * Defaults to 0 (no throttle, both detections run simultaneously).\n   */\n  detectionThrottleSeconds?: number;\n};\n\nexport type BarcodeScannedEvent = { scannedCode: string; format: string };\n\n\nexport type RectangleDetectedEvent = {\n  detected: true\n};\n\nexport type CapturePhotoOptions = {\n  /**\n   * The desired quality of the captured image, expressed as a value between 0.0 (lowest quality, smallest file size)\n   * and 1.0 (highest quality, largest file size). Defaults to 1.0.\n   * This parameter directly influences the compression level of the resulting JPEG image.\n   */\n  qualityRatio?: number;\n};\n\nexport type PermissionsResult = { camera: 'prompt' | 'denied' | 'granted' };\n\nexport type CapturePhotoResult = { imageBase64: string };\n\nexport type FlashResult = { enabled: boolean };\n\nexport type ZoomOptions = {\n  /**\n   * The zoom level to set. Must be 1, 2, or 3.\n   * - 1 = 1.0x (no zoom)\n   * - 2 = 2.0x\n   * - 3 = 3.0x\n   */\n  level: 1 | 2 | 3;\n};\n\nexport type ZoomResult = { level: number };\n\nexport enum BarcodeFormat {\n  Aztec = 'AZTEC',\n  Code39 = 'CODE_39',\n  Code93 = 'CODE_93',\n  Code128 = 'CODE_128',\n  DataMatrix = 'DATA_MATRIX',\n  Ean8 = 'EAN_8',\n  Ean13 = 'EAN_13',\n  Itf14 = 'ITF14',\n  Pdf417 = 'PDF_417',\n  QrCode = 'QR_CODE',\n  UpcE = 'UPC_E',\n}\n\ndeclare global {\n  interface PluginRegistry {\n    QRScanner: CapacitorScannerPlugin;\n  }\n}"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA0KA,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,mCAAkB,CAAA;IAClB,mCAAkB,CAAA;IAClB,qCAAoB,CAAA;IACpB,2CAA0B,CAAA;IAC1B,+BAAc,CAAA;IACd,iCAAgB,CAAA;IAChB,gCAAe,CAAA;IACf,mCAAkB,CAAA;IAClB,mCAAkB,CAAA;IAClB,+BAAc,CAAA;AAChB,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB","sourcesContent":["export interface CapacitorScannerPlugin {\n  /**\n   * Start the camera preview with optional barcode and object detection.\n   * @param options - Configuration options for the camera and detection\n   */\n  start(options?: StartOptions): Promise<void>;\n\n  /**\n   * Stop the camera preview and all detection.\n   */\n  stop(): Promise<void>;\n\n  openSettings(): Promise<void>;\n\n  capturePhoto(options?: CapturePhotoOptions): Promise<CapturePhotoResult>;\n\n  checkPermissions(): Promise<PermissionsResult>;\n\n  requestPermissions(): Promise<PermissionsResult>;\n\n  flipCamera(): Promise<void>;\n\n  toggleFlash(): Promise<FlashResult>;\n\n  addListener(event: 'barcodeScanned', listenerFunc: (result: BarcodeScannedEvent) => void): Promise<void>;\n\n  addListener(event: 'rectangleDetected', listenerFunc: (result: RectangleDetectedEvent) => void): Promise<void>;\n\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Enable object detection (business card). This will start detecting business cards.\n   * @param options - Optional configuration for object detection\n   */\n  enableObjectDetection(options?: ObjectDetectionOptions): Promise<{ enabled: true }>;\n\n  /**\n   * Disable object detection. This will stop detecting business cards.\n   */\n  disableObjectDetection(): Promise<{ enabled: false }>;\n\n  /**\n   * Enable barcode detection. This will start detecting barcodes.\n   * @param options - Optional configuration for barcode detection\n   */\n  enableBarcodeDetection(options?: BarcodeDetectionOptions): Promise<{ enabled: true }>;\n\n  /**\n   * Disable barcode detection. This will stop detecting barcodes and clear cached barcodes.\n   */\n  disableBarcodeDetection(): Promise<{ enabled: false }>;\n\n  /**\n   * Set the camera zoom level.\n   * @param options - The zoom options containing the level (1, 2, or 3)\n   */\n  zoom(options: ZoomOptions): Promise<ZoomResult>;\n}\n\nexport type BarcodeDetectionOptions = {\n  /**\n   * Whether to show the highlight overlay for detected barcodes.\n   * Defaults to false.\n   */\n  showHighlight?: boolean;\n}\n\nexport type ObjectDetectionOptions = {\n  /**\n   * Whether to show the highlight overlay for detected business cards.\n   * Defaults to true.\n   */\n  showHighlight?: boolean,\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * After an event is emitted, no new events will be emitted until this interval passes.\n   * Set to 0 to emit events as soon as stability is detected.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  emitIntervalSeconds?: number\n}\n\nexport type StartOptions = {\n  /**\n   * Barcode formats to detect when barcodeDetection is enabled.\n   */\n  formats?: BarcodeFormat[];\n  /**\n   * Camera direction to use. Defaults to 'BACK'.\n   */\n  cameraDirection?: 'BACK' | 'FRONT';\n  /**\n   * Enable barcode detection on start. Defaults to false.\n   * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events.\n   */\n  barcodeDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected barcodes. Defaults to false.\n   * Only applies when barcodeDetection is true.\n   */\n  barcodeHighlight?: boolean;\n  /**\n   * Enable object detection (business card) on start. Defaults to false.\n   * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events.\n   */\n  objectDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected business cards. Defaults to true.\n   * Only applies when objectDetection is true.\n   */\n  objectHighlight?: boolean;\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * Only applies when objectDetection is true.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  rectangleEmitIntervalSeconds?: number;\n  /**\n   * Optional regex pattern to filter scanned barcodes.\n   * If provided, only barcodes matching this pattern will be reported.\n   */\n  regex?: string;\n  /**\n   * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline).\n   */\n  regexFlags?: string;\n  /**\n   * Cooldown in seconds after any detection event when both barcode and object detection are enabled.\n   * After a barcode or rectangle is emitted, ALL detection pauses for this duration.\n   * When set, barcode dedup TTL becomes 2x this value and rectangle emit interval becomes 2x this value.\n   * Only applies when both barcodeDetection and objectDetection are true.\n   * Defaults to 0 (no throttle, both detections run simultaneously).\n   */\n  detectionThrottleSeconds?: number;\n};\n\nexport type BarcodeScannedEvent = { scannedCode: string; format: string };\n\n\nexport type RectangleDetectedEvent = {\n  detected: true\n};\n\nexport type CapturePhotoOptions = {\n  /**\n   * The desired quality of the captured image, expressed as a value between 0.0 (lowest quality, smallest file size)\n   * and 1.0 (highest quality, largest file size). Defaults to 1.0.\n   * This parameter directly influences the compression level of the resulting JPEG image.\n   */\n  qualityRatio?: number;\n};\n\nexport type PermissionsResult = { camera: 'prompt' | 'denied' | 'granted' };\n\nexport type CapturePhotoResult = { imageBase64: string };\n\nexport type FlashResult = { enabled: boolean };\n\nexport type ZoomOptions = {\n  /**\n   * The zoom level to set. Must be 1, 2, or 3.\n   * - 1 = 1.0x (no zoom)\n   * - 2 = 2.0x\n   * - 3 = 3.0x\n   */\n  level: 1 | 2 | 3;\n};\n\nexport type ZoomResult = { level: number };\n\nexport enum BarcodeFormat {\n  Aztec = 'AZTEC',\n  Code39 = 'CODE_39',\n  Code93 = 'CODE_93',\n  Code128 = 'CODE_128',\n  DataMatrix = 'DATA_MATRIX',\n  Ean8 = 'EAN_8',\n  Ean13 = 'EAN_13',\n  Itf14 = 'ITF14',\n  Pdf417 = 'PDF_417',\n  QrCode = 'QR_CODE',\n  UpcE = 'UPC_E',\n}\n\ndeclare global {\n  interface PluginRegistry {\n    QRScanner: CapacitorScannerPlugin;\n  }\n}"]}

package/ios/Sources/CapacitorScannerPlugin/CapacitorScannerPlugin.swift

@@ -51,9 +51,10 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 	private var lastBarcodeDetectionTime: Date?
 	private let barcodeVisibilityTimeout: TimeInterval = 1.0
 
-	// Detection throttle: pause rectangle detection after a successful barcode scan
+	// Detection throttle: pause ALL detection after any emit (when both types enabled)
 	private var detectionThrottleSeconds: TimeInterval = 0
-	private var lastSuccessfulBarcodeScanTime: Date?
+	private var lastDetectionEmitTime: Date?
+	private var bothDetectionsEnabled: Bool = false
 
  // Detection state (controls what detection runs)
  private var enabledDetectionTypes: Set<String> = []
@@ -245,31 +246,24 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 			                                                AVVideoCompressionPropertiesKey: [AVVideoQualityKey: qualityNumber]])
 
 			let maxPrioritization = photoOutput.maxPhotoQualityPrioritization
-			// Compare the raw values to determine which prioritization to use
-			if maxPrioritization.rawValue >= AVCapturePhotoOutput.QualityPrioritization.balanced.rawValue {
-				// Device supports .balanced prioritization
+			if maxPrioritization.rawValue >= AVCapturePhotoOutput.QualityPrioritization.quality.rawValue {
+				photoSettings.photoQualityPrioritization = .quality
+			} else if maxPrioritization.rawValue >= AVCapturePhotoOutput.QualityPrioritization.balanced.rawValue {
 				photoSettings.photoQualityPrioritization = .balanced
 			} else {
-				// Use the lowest prioritization (.speed)
 				photoSettings.photoQualityPrioritization = .speed
 			}
 
+			// Enable high-resolution capture for sharper photos
+			photoSettings.isHighResolutionPhotoEnabled = true
+
 		} else {
 			print("JPEG codec not supported for photo capture. Using default settings.")
 			// photoSettings remains the default initialized one
 		}
 
 		self.capturePhotoCall = call
-
-		// If business card detection is enabled, wait for 1 second before capturing
-		if self.enabledDetectionTypes.contains("businessCard") {
-			DispatchQueue.main.asyncAfter(deadline: .now() + 0.6) {
-				photoOutput.capturePhoto(with: photoSettings, delegate: self)
-			}
-		} else {
-			// Otherwise capture immediately
-			photoOutput.capturePhoto(with: photoSettings, delegate: self)
-		}
+		photoOutput.capturePhoto(with: photoSettings, delegate: self)
 	}
 
 	public func photoOutput(_ output: AVCapturePhotoOutput, didFinishProcessingPhoto photo: AVCapturePhoto, error: Error?) {
@@ -296,37 +290,22 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 		if self.enabledDetectionTypes.contains("businessCard"),
 		   isRectangleCurrentlyDetected,
 		   let detectedRect = self.rectangleDetector?.lastDetectedRectangle {
-			// If we have a snapshot from the detection, use it directly
-			if let snapshot = detectedRect.snapshot {
-				if let croppedImage = self.cropImage(snapshot, toRectangle: detectedRect.observation) {
-					guard let croppedImageData = croppedImage.jpegData(compressionQuality: 0.9) else {
-						self.capturePhotoCall?.reject("Unable to convert cropped image to data")
-						return
-					}
-					let base64String = croppedImageData.base64EncodedString()
-					self.capturePhotoCall?.resolve(["imageBase64": "data:image/jpeg;base64, \(base64String)"])
-				} else {
-					let base64String = imageData.base64EncodedString()
-					self.capturePhotoCall?.resolve(["imageBase64": "data:image/jpeg;base64, \(base64String)"])
-				}
-			} else {
-				// Use the captured photo if no snapshot available
-				guard let image = UIImage(data: imageData) else {
-					self.capturePhotoCall?.reject("Unable to create image from data")
-					return
-				}
+			// Always use the high-resolution captured photo for cropping (not the video frame snapshot)
+			guard let image = UIImage(data: imageData) else {
+				self.capturePhotoCall?.reject("Unable to create image from data")
+				return
+			}
 
-				if let croppedImage = self.cropImage(image, toRectangle: detectedRect.observation) {
-					guard let croppedImageData = croppedImage.jpegData(compressionQuality: 0.9) else {
-						self.capturePhotoCall?.reject("Unable to convert cropped image to data")
-						return
-					}
-					let base64String = croppedImageData.base64EncodedString()
-					self.capturePhotoCall?.resolve(["imageBase64": "data:image/jpeg;base64, \(base64String)"])
-				} else {
-					let base64String = imageData.base64EncodedString()
-					self.capturePhotoCall?.resolve(["imageBase64": "data:image/jpeg;base64, \(base64String)"])
+			if let croppedImage = self.cropImage(image, toRectangle: detectedRect) {
+				guard let croppedImageData = croppedImage.jpegData(compressionQuality: 0.9) else {
+					self.capturePhotoCall?.reject("Unable to convert cropped image to data")
+					return
 				}
+				let base64String = croppedImageData.base64EncodedString()
+				self.capturePhotoCall?.resolve(["imageBase64": "data:image/jpeg;base64, \(base64String)"])
+			} else {
+				let base64String = imageData.base64EncodedString()
+				self.capturePhotoCall?.resolve(["imageBase64": "data:image/jpeg;base64, \(base64String)"])
 			}
 		} else {
 			// No rectangle detected, return original image
@@ -451,6 +430,11 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 				}
 			}
 
+			// Read detection throttle
+			self.detectionThrottleSeconds = call.getDouble("detectionThrottleSeconds") ?? 0
+			self.lastDetectionEmitTime = nil
+			self.bothDetectionsEnabled = enableBarcodeDetection && enableObjectDetection
+
 			// Enable object detection (businessCard) if requested
 			if enableObjectDetection {
 				self.enabledDetectionTypes.insert("businessCard")
@@ -463,14 +447,18 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 				if enableObjectHighlight {
 					self.rectangleDetector?.isHighlightEnabled = true
 				}
-				// Set emit interval if provided
-				let emitInterval = call.getDouble("rectangleEmitIntervalSeconds") ?? 0
+				// Set emit interval: use 2X when both enabled with throttle, otherwise use provided value
+				var emitInterval = call.getDouble("rectangleEmitIntervalSeconds") ?? 0
+				if self.bothDetectionsEnabled && self.detectionThrottleSeconds > 0 {
+					emitInterval = max(emitInterval, self.detectionThrottleSeconds * 2)
+				}
 				self.rectangleDetector?.setEmitInterval(emitInterval)
 			}
 
-			// Read detection throttle
-			self.detectionThrottleSeconds = call.getDouble("detectionThrottleSeconds") ?? 0
-			self.lastSuccessfulBarcodeScanTime = nil
+			// When both enabled with throttle, set barcode votes TTL to 2X
+			if self.bothDetectionsEnabled && self.detectionThrottleSeconds > 0 {
+				self.scannedCodesVotes = TTLMap<String, VoteStatus>(ttlSeconds: self.detectionThrottleSeconds * 2)
+			}
 
 			// Handle Regex Filter
 			if let pattern = call.getString("regex") {
@@ -530,6 +518,8 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 			self.photoOutput = photoOutput
 			if captureSession.canAddOutput(photoOutput) {
 				captureSession.addOutput(photoOutput)
+				photoOutput.maxPhotoQualityPrioritization = .quality
+				photoOutput.isHighResolutionCaptureEnabled = true
 			} else {
 				call.reject("Unable to add photo output to capture session")
 				return
@@ -604,8 +594,10 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 		self.enabledDetectionTypes.removeAll()
 		self.enabledHighlightTypes.removeAll()
 		self.lastBarcodeDetectionTime = nil
-		self.lastSuccessfulBarcodeScanTime = nil
+		self.lastDetectionEmitTime = nil
 		self.detectionThrottleSeconds = 0
+		self.bothDetectionsEnabled = false
+		self.scannedCodesVotes = TTLMap<String, VoteStatus>(ttlSeconds: 5)
 		self.removeOrientationChangeObserver()
 	}
 
@@ -821,11 +813,14 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 						"format": CapacitorScannerHelpers.convertBarcodeScannerFormatToString(bestObservation.symbology),
 					])
 
-					// Record successful scan time for detection throttle
-					self.lastSuccessfulBarcodeScanTime = Date()
+					// Record emit time for detection throttle
+					self.lastDetectionEmitTime = Date()
 
-					// Reset votes after successful scan
-					self.scannedCodesVotes.clear()
+					// When both enabled: keep done flag for dedup (TTL handles expiry)
+					// When barcode only: clear to allow immediate re-voting
+					if !self.bothDetectionsEnabled {
+						self.scannedCodesVotes.clear()
+					}
 				}
 			}
 
@@ -842,6 +837,9 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 			"bottomLeft": ["x": corners.bottomLeft.x, "y": corners.bottomLeft.y],
 			"bottomRight": ["x": corners.bottomRight.x, "y": corners.bottomRight.y],
 		])
+
+		// Record emit time for detection throttle
+		self.lastDetectionEmitTime = Date()
 	}
 
 	@objc func flipCamera(_ call: CAPPluginCall) {
@@ -1033,20 +1031,21 @@ extension CapacitorScannerPlugin: AVCaptureVideoDataOutputSampleBufferDelegate {
 		// Prepare detection requests
 		var requests: [VNRequest] = []
 
-		if self.enabledDetectionTypes.contains("barcode") {
+		// Check if detection is throttled (cooldown after any emit when both types enabled)
+		let isThrottled: Bool = {
+			guard self.bothDetectionsEnabled,
+			      self.detectionThrottleSeconds > 0,
+			      let lastEmit = self.lastDetectionEmitTime else { return false }
+			return Date().timeIntervalSince(lastEmit) < self.detectionThrottleSeconds
+		}()
+
+		if !isThrottled, self.enabledDetectionTypes.contains("barcode") {
 			requests.append(self.barcodeDetectionRequest)
 		}
 
-		let isRectangleThrottled: Bool = {
-			guard self.detectionThrottleSeconds > 0,
-			      let lastScan = self.lastSuccessfulBarcodeScanTime else { return false }
-			return Date().timeIntervalSince(lastScan) < self.detectionThrottleSeconds
-		}()
-
-		if !isRectangleThrottled,
+		if !isThrottled,
 		   self.enabledDetectionTypes.contains("businessCard"),
 		   let detector = self.rectangleDetector {
-			detector.updatePixelBuffer(pixelBuffer)
 			requests.append(detector.visionRequest)
 		}
 

package/ios/Sources/CapacitorScannerPlugin/RectangleDetector.swift

@@ -18,14 +18,6 @@ struct RectangleCorners {
 /// Handles rectangle/business card detection using Vision framework
 class RectangleDetector {
 
-    // MARK: - Types
-
-    /// Stores detected rectangle with optional snapshot for cropping
-    struct DetectedRectangle {
-        let observation: VNRectangleObservation
-        let snapshot: UIImage?
-    }
-
     // MARK: - Configuration
 
     private let confidenceThreshold: Float = 0.8
@@ -38,10 +30,8 @@ class RectangleDetector {
 
     // MARK: - State
 
-    private(set) var lastDetectedRectangle: DetectedRectangle?
+    private(set) var lastDetectedRectangle: VNRectangleObservation?
     private(set) var lastDetectionTime: Date?
-    private var currentPixelBuffer: CVPixelBuffer?
-    private let ciContext = CIContext(options: nil)
 
     // Stability tracking
     private var previousCorners: RectangleCorners?
@@ -61,7 +51,7 @@ class RectangleDetector {
         let request = VNDetectRectanglesRequest { [weak self] request, error in
             self?.processDetection(request, error: error)
         }
-        request.maximumObservations = 1
+        request.maximumObservations = 10
         request.minimumAspectRatio = 0.5
         request.maximumAspectRatio = 0.8
         request.minimumSize = 0.2
@@ -100,11 +90,6 @@ class RectangleDetector {
         emitIntervalSeconds = max(0, seconds)
     }
 
-    /// Update the current pixel buffer for snapshot capture
-    func updatePixelBuffer(_ pixelBuffer: CVPixelBuffer) {
-        self.currentPixelBuffer = pixelBuffer
-    }
-
     /// Check for detection timeout and update overlay
     func checkTimeout() {
         smoother?.checkTimeout()
@@ -120,7 +105,6 @@ class RectangleDetector {
     func reset() {
         lastDetectedRectangle = nil
         lastDetectionTime = nil
-        currentPixelBuffer = nil
         previousCorners = nil
         stabilityStartTime = nil
         lastEmitTime = nil
@@ -149,22 +133,16 @@ class RectangleDetector {
             return
         }
 
-        // Find the rectangle with highest confidence
-        guard let bestCandidate = observations.max(by: { $0.confidence < $1.confidence }) else {
-            // Don't reset stability here - let checkTimeout() handle the grace period
-            return
-        }
-
-        // Check if all corners are inside the screen with buffer
-        guard isInsideScreen(bestCandidate) else {
+        // Find the largest rectangle by area
+        guard let bestCandidate = observations
+            .filter({ $0.confidence >= confidenceThreshold && isInsideScreen($0) })
+            .max(by: { area(of: $0) < area(of: $1) }) else {
             // Don't reset stability here - let checkTimeout() handle the grace period
             return
         }
 
-        // Store rectangle if confidence is high enough
-        if bestCandidate.confidence >= confidenceThreshold {
-            captureSnapshot(for: bestCandidate)
-        }
+        // Store rectangle observation for cropping
+        lastDetectedRectangle = bestCandidate
 
         // Update detection time
         lastDetectionTime = Date()
@@ -265,6 +243,17 @@ class RectangleDetector {
         return sqrt(dx * dx + dy * dy)
     }
 
+    /// Approximate area of a rectangle observation using the shoelace formula (normalized coordinates)
+    private func area(of obs: VNRectangleObservation) -> CGFloat {
+        let pts = [obs.topLeft, obs.topRight, obs.bottomRight, obs.bottomLeft]
+        var sum: CGFloat = 0
+        for i in 0..<pts.count {
+            let j = (i + 1) % pts.count
+            sum += pts[i].x * pts[j].y - pts[j].x * pts[i].y
+        }
+        return abs(sum) / 2.0
+    }
+
     private func isInsideScreen(_ observation: VNRectangleObservation) -> Bool {
         let corners = [
             observation.topLeft,
@@ -282,34 +271,4 @@ class RectangleDetector {
         }
     }
 
-    private func captureSnapshot(for observation: VNRectangleObservation) {
-        guard let pixelBuffer = currentPixelBuffer else {
-            lastDetectedRectangle = DetectedRectangle(observation: observation, snapshot: nil)
-            return
-        }
-
-        let ciImage = CIImage(cvPixelBuffer: pixelBuffer)
-
-        guard let cgImage = ciContext.createCGImage(ciImage, from: ciImage.extent) else {
-            lastDetectedRectangle = DetectedRectangle(observation: observation, snapshot: nil)
-            return
-        }
-
-        // Create UIImage with correct orientation
-        let deviceOrientation = UIDevice.current.orientation
-        let uiOrientation: UIImage.Orientation
-        switch deviceOrientation {
-        case .landscapeLeft:
-            uiOrientation = .right
-        case .landscapeRight:
-            uiOrientation = .left
-        case .portraitUpsideDown:
-            uiOrientation = .down
-        default:
-            uiOrientation = .up
-        }
-
-        let snapshot = UIImage(cgImage: cgImage, scale: 1.0, orientation: uiOrientation)
-        lastDetectedRectangle = DetectedRectangle(observation: observation, snapshot: snapshot)
-    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scr2em/capacitor-scanner",
-  "version": "6.0.31",
+  "version": "6.0.34",
   "description": "scan codes",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -29,23 +29,6 @@
     "plugin",
     "native"
   ],
-  "scripts": {
-    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
-    "verify:ios": "xcodebuild -scheme CapacitorScanner -destination generic/platform=iOS",
-    "verify:android": "cd android && ./gradlew clean build test && cd ..",
-    "verify:web": "npm run build",
-    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
-    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
-    "eslint": "eslint . --ext ts",
-    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
-    "swiftlint": "node-swiftlint",
-    "docgen": "docgen --api CapacitorScannerPlugin --output-readme README.md --output-json dist/docs.json",
-    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
-    "clean": "rimraf ./dist",
-    "watch": "tsc --watch",
-    "prepublishOnly": "npm run build",
-    "prepare": "npm run build"
-  },
   "devDependencies": {
     "@capacitor/android": "6.0.0",
     "@capacitor/cli": "6.0.0",
@@ -78,5 +61,20 @@
     "android": {
       "src": "android"
     }
+  },
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme CapacitorScanner -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api CapacitorScannerPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch"
   }
 }