capacitor-camera-view 2.0.1 → 2.1.0

package/android/src/main/java/com/michaelwolz/capacitorcameraview/CameraViewPlugin.kt

@@ -12,12 +12,24 @@ import com.getcapacitor.annotation.CapacitorPlugin
 import com.getcapacitor.annotation.Permission
 import com.getcapacitor.annotation.PermissionCallback
 import com.michaelwolz.capacitorcameraview.model.BarcodeDetectionResult
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.Job
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.cancel
+import kotlinx.coroutines.launch
 
 @CapacitorPlugin(
     name = "CameraView",
     permissions = [Permission(strings = [Manifest.permission.CAMERA], alias = "camera")]
 )
 class CameraViewPlugin : Plugin() {
+    // Coroutine scope for async operations
+    private val pluginScope = CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)
+
+    // Job for barcode event subscription
+    private var barcodeJob: Job? = null
+
     private val implementation by lazy {
         CameraView(this)
     }
@@ -41,26 +53,42 @@ class CameraViewPlugin : Plugin() {
     }
 
     private fun startCamera(call: PluginCall) {
-        implementation.startSession(
-            config = sessionConfigFromPluginCall(call),
-            callback = { error ->
-                if (error != null) {
-                    call.reject("Failed to start camera preview: ${error.localizedMessage}", error)
-                } else {
+        val config = sessionConfigFromPluginCall(call)
+
+        pluginScope.launch {
+            implementation.startSessionAsync(config).fold(
+                onSuccess = {
+                    // Subscribe to barcode events if detection is enabled
+                    if (config.enableBarcodeDetection) {
+                        barcodeJob?.cancel()
+                        barcodeJob = pluginScope.launch {
+                            implementation.barcodeEvents.collect { result ->
+                                notifyBarcodeDetected(result)
+                            }
+                        }
+                    }
                     call.resolve()
+                },
+                onError = { error ->
+                    call.reject("Failed to start camera preview: ${error.localizedMessage}", error)
                 }
-            }
-        )
+            )
+        }
     }
 
     @PluginMethod
     fun stop(call: PluginCall) {
-        implementation.stopSession { error ->
-            if (error != null) {
-                call.reject("Failed to stop camera preview: ${error.localizedMessage}", error)
-            } else {
-                call.resolve()
-            }
+        // Cancel barcode subscription
+        barcodeJob?.cancel()
+        barcodeJob = null
+
+        pluginScope.launch {
+            implementation.stopSessionAsync().fold(
+                onSuccess = { call.resolve() },
+                onError = { error ->
+                    call.reject("Failed to stop camera preview: ${error.localizedMessage}", error)
+                }
+            )
         }
     }
 
@@ -74,7 +102,7 @@ class CameraViewPlugin : Plugin() {
 
     @PluginMethod
     fun capture(call: PluginCall) {
-        val timeStart = System.currentTimeMillis();
+        val timeStart = System.currentTimeMillis()
         val quality = call.getInt("quality") ?: 90
         val saveToFile = call.getBoolean("saveToFile") ?: false
 
@@ -83,19 +111,23 @@ class CameraViewPlugin : Plugin() {
             return
         }
 
-        implementation.capturePhoto(quality, saveToFile) { result, error ->
-            when {
-                error != null -> call.reject("Failed to capture image: ${error.message}", error)
-                result == null -> call.reject("No image data")
-                else -> call.resolve(result)
-            }
-            Log.d(TAG, "capture took ${System.currentTimeMillis() - timeStart}ms")
+        pluginScope.launch {
+            implementation.capturePhotoAsync(quality, saveToFile).fold(
+                onSuccess = { result ->
+                    call.resolve(result)
+                    Log.d(TAG, "capture took ${System.currentTimeMillis() - timeStart}ms")
+                },
+                onError = { error ->
+                    call.reject("Failed to capture image: ${error.message}", error)
+                    Log.d(TAG, "capture failed after ${System.currentTimeMillis() - timeStart}ms")
+                }
+            )
         }
     }
 
     @PluginMethod
     fun captureSample(call: PluginCall) {
-        val timeStart = System.currentTimeMillis();
+        val timeStart = System.currentTimeMillis()
         val quality = call.getInt("quality") ?: 90
         val saveToFile = call.getBoolean("saveToFile") ?: false
 
@@ -104,13 +136,17 @@ class CameraViewPlugin : Plugin() {
             return
         }
 
-        implementation.captureSampleFromPreview(quality, saveToFile) { result, error ->
-            when {
-                error != null -> call.reject("Failed to capture frame: ${error.message}", error)
-                result == null -> call.reject("No frame data")
-                else -> call.resolve(result)
-            }
-            Log.d(TAG, "captureSample took ${System.currentTimeMillis() - timeStart}ms")
+        pluginScope.launch {
+            implementation.captureSampleFromPreviewAsync(quality, saveToFile).fold(
+                onSuccess = { result ->
+                    call.resolve(result)
+                    Log.d(TAG, "captureSample took ${System.currentTimeMillis() - timeStart}ms")
+                },
+                onError = { error ->
+                    call.reject("Failed to capture frame: ${error.message}", error)
+                    Log.d(TAG, "captureSample failed after ${System.currentTimeMillis() - timeStart}ms")
+                }
+            )
         }
     }
 
@@ -268,6 +304,10 @@ class CameraViewPlugin : Plugin() {
     }
 
     override fun handleOnDestroy() {
+        // Cancel barcode subscription and plugin scope
+        barcodeJob?.cancel()
+        pluginScope.cancel()
+
         implementation.cleanup()
         super.handleOnDestroy()
     }

package/android/src/main/java/com/michaelwolz/capacitorcameraview/model/CameraResult.kt

@@ -0,0 +1,47 @@
+package com.michaelwolz.capacitorcameraview.model
+
+/**
+ * A Result type for consistent error handling throughout camera operations.
+ * Provides a functional approach to handling success and error cases.
+ */
+sealed class CameraResult<out T> {
+    data class Success<T>(val value: T) : CameraResult<T>()
+    data class Error(val exception: Exception) : CameraResult<Nothing>()
+
+    /**
+     * Transforms this result using the provided functions.
+     */
+    inline fun <R> fold(
+        onSuccess: (T) -> R,
+        onError: (Exception) -> R
+    ): R = when (this) {
+        is Success -> onSuccess(value)
+        is Error -> onError(exception)
+    }
+
+    /**
+     * Returns the value if Success, null otherwise.
+     */
+    fun getOrNull(): T? = when (this) {
+        is Success -> value
+        is Error -> null
+    }
+
+    /**
+     * Returns the exception if Error, null otherwise.
+     */
+    fun exceptionOrNull(): Exception? = when (this) {
+        is Success -> null
+        is Error -> exception
+    }
+
+    /**
+     * Returns true if this is a Success.
+     */
+    val isSuccess: Boolean get() = this is Success
+
+    /**
+     * Returns true if this is an Error.
+     */
+    val isError: Boolean get() = this is Error
+}

package/android/src/main/java/com/michaelwolz/capacitorcameraview/model/CameraSessionConfiguration.kt

@@ -1,9 +1,19 @@
 package com.michaelwolz.capacitorcameraview.model
 
-/** Configuration for a camera session. */
+/**
+ * Configuration for a camera session.
+ *
+ * @property deviceId Specific device ID to use. Takes precedence over position.
+ * @property enableBarcodeDetection Whether to enable barcode detection.
+ * @property barcodeTypes Optional list of specific barcode format codes to detect.
+ *                        If null, all supported formats are detected.
+ * @property position Camera position to use ("front" or "back").
+ * @property zoomFactor Initial zoom factor.
+ */
 data class CameraSessionConfiguration(
     val deviceId: String? = null,
     val enableBarcodeDetection: Boolean = false,
+    val barcodeTypes: List<Int>? = null,
     val position: String = "back",
     val zoomFactor: Float = 1.0f
 )

package/android/src/main/java/com/michaelwolz/capacitorcameraview/utils.kt

@@ -16,6 +16,49 @@ import com.michaelwolz.capacitorcameraview.model.CameraSessionConfiguration
 import com.michaelwolz.capacitorcameraview.model.WebBoundingRect
 import java.io.ByteArrayOutputStream
 
+/**
+ * Memory-efficient Base64 encoding utilities.
+ * Uses ThreadLocal ByteArrayOutputStream pool to reduce allocation churn.
+ */
+object StreamingBase64Encoder {
+    // Reusable ByteArrayOutputStream to reduce allocation churn (per-thread)
+    private val outputStreamPool = object : ThreadLocal<ByteArrayOutputStream>() {
+        override fun initialValue(): ByteArrayOutputStream {
+            return ByteArrayOutputStream(256 * 1024) // 256KB initial capacity
+        }
+    }
+
+    /**
+     * Encodes a bitmap to Base64 with memory optimization.
+     * Reuses ByteArrayOutputStream to reduce allocations.
+     *
+     * @param bitmap The bitmap to encode
+     * @param quality JPEG compression quality (0-100)
+     * @param format Compression format (default JPEG)
+     * @return Base64 encoded string
+     */
+    fun encodeToBase64(
+        bitmap: Bitmap,
+        quality: Int,
+        format: Bitmap.CompressFormat = Bitmap.CompressFormat.JPEG
+    ): String {
+        val outputStream = outputStreamPool.get()!!
+        outputStream.reset() // Clear previous data
+
+        bitmap.compress(format, quality, outputStream)
+        val byteArray = outputStream.toByteArray()
+
+        return Base64.encodeToString(byteArray, Base64.NO_WRAP)
+    }
+
+    /**
+     * Encodes raw byte array to Base64.
+     */
+    fun encodeToBase64(bytes: ByteArray): String {
+        return Base64.encodeToString(bytes, Base64.NO_WRAP)
+    }
+}
+
 /** Converts a barcode format code to a readable string. */
 fun getBarcodeFormatString(format: Int): String {
     return when (format) {
@@ -36,6 +79,43 @@ fun getBarcodeFormatString(format: Int): String {
     }
 }
 
+/**
+ * Converts a string barcode type from JavaScript to ML Kit Barcode format constant.
+ *
+ * @param stringType The string barcode type from JavaScript.
+ * @return The corresponding ML Kit Barcode format constant, or null if not recognized.
+ */
+fun convertToNativeBarcodeFormat(stringType: String): Int? {
+    return when (stringType) {
+        "qr" -> Barcode.FORMAT_QR_CODE
+        "aztec" -> Barcode.FORMAT_AZTEC
+        "codabar" -> Barcode.FORMAT_CODABAR
+        "code39" -> Barcode.FORMAT_CODE_39
+        "code39Mod43" -> Barcode.FORMAT_CODE_39 // ML Kit doesn't distinguish Mod43
+        "code93" -> Barcode.FORMAT_CODE_93
+        "code128" -> Barcode.FORMAT_CODE_128
+        "dataMatrix" -> Barcode.FORMAT_DATA_MATRIX
+        "ean8" -> Barcode.FORMAT_EAN_8
+        "ean13" -> Barcode.FORMAT_EAN_13
+        "interleaved2of5" -> Barcode.FORMAT_ITF
+        "itf14" -> Barcode.FORMAT_ITF
+        "pdf417" -> Barcode.FORMAT_PDF417
+        "upcA" -> Barcode.FORMAT_UPC_A
+        "upce" -> Barcode.FORMAT_UPC_E
+        else -> null
+    }
+}
+
+/**
+ * Converts an array of string barcode types to ML Kit Barcode format constants.
+ *
+ * @param stringTypes List of string barcode types from JavaScript.
+ * @return List of ML Kit Barcode format constants (invalid types are filtered out).
+ */
+fun convertToNativeBarcodeFormats(stringTypes: List<String>): List<Int> {
+    return stringTypes.mapNotNull { convertToNativeBarcodeFormat(it) }.distinct()
+}
+
 /**
  * Converts the bounding box of a barcode detection result to a [WebBoundingRect]
  * suitable for use in the web view via regular CSS pixels.
@@ -84,9 +164,20 @@ fun calculateTopOffset(webView: View): Int {
 
 /** Maps a Capacitor plugin call to a [CameraSessionConfiguration]. */
 fun sessionConfigFromPluginCall(call: PluginCall): CameraSessionConfiguration {
+    // Parse barcode types if provided
+    val barcodeTypes: List<Int>? = call.getArray("barcodeTypes")?.let { jsonArray ->
+        val stringTypes = mutableListOf<String>()
+        for (i in 0 until jsonArray.length()) {
+            jsonArray.optString(i)?.let { stringTypes.add(it) }
+        }
+        val converted = convertToNativeBarcodeFormats(stringTypes)
+        if (converted.isNotEmpty()) converted else null
+    }
+
     return CameraSessionConfiguration(
         deviceId = call.getString("deviceId"),
         enableBarcodeDetection = call.getBoolean("enableBarcodeDetection") ?: false,
+        barcodeTypes = barcodeTypes,
         position = call.getString("position") ?: "back",
         zoomFactor = call.getFloat("zoomFactor") ?: 1.0f
     )
@@ -126,6 +217,7 @@ fun calculateImageRotationBasedOnDisplayRotation(
 
 /**
  * Converts an ImageProxy to a Base64 encoded string and applies rotation if necessary.
+ * Uses StreamingBase64Encoder for memory-efficient encoding.
  *
  * @param image The ImageProxy to convert.
  * @param quality The JPEG compression quality (0-100).
@@ -152,11 +244,8 @@ fun imageProxyToBase64(image: ImageProxy, quality: Int, rotationDegrees: Int): S
             bitmap = rotatedBitmap
         }
 
-        val outputStream = ByteArrayOutputStream()
-        bitmap.compress(Bitmap.CompressFormat.JPEG, quality, outputStream)
-        val byteArray = outputStream.toByteArray()
-
-        return Base64.encodeToString(byteArray, Base64.NO_WRAP)
+        // Use streaming encoder for memory efficiency
+        return StreamingBase64Encoder.encodeToBase64(bitmap, quality)
     } finally {
         // Ensure bitmap is always recycled
         bitmap.recycle()

package/dist/docs.json

@@ -561,6 +561,28 @@
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "barcodeTypes",
+          "tags": [
+            {
+              "text": "['qr', 'code128'] // Only detect QR codes and Code 128 barcodes",
+              "name": "example"
+            },
+            {
+              "text": "undefined - all supported types are detected",
+              "name": "default"
+            },
+            {
+              "text": "2.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Specific barcode types to detect. If not provided, all supported types are detected.\nSpecifying only the types you need can significantly improve performance and reduce\nbattery consumption, especially on mobile devices.",
+          "complexTypes": [
+            "BarcodeType"
+          ],
+          "type": "BarcodeType[] | undefined"
+        },
         {
           "name": "position",
           "tags": [
@@ -1028,6 +1050,65 @@
   ],
   "enums": [],
   "typeAliases": [
+    {
+      "name": "BarcodeType",
+      "slug": "barcodetype",
+      "docs": "Supported barcode types for detection.\nSpecifying only the barcode types you need can improve performance\nand reduce battery consumption.",
+      "types": [
+        {
+          "text": "'qr'",
+          "complexTypes": []
+        },
+        {
+          "text": "'code128'",
+          "complexTypes": []
+        },
+        {
+          "text": "'code39'",
+          "complexTypes": []
+        },
+        {
+          "text": "'code39Mod43'",
+          "complexTypes": []
+        },
+        {
+          "text": "'code93'",
+          "complexTypes": []
+        },
+        {
+          "text": "'ean8'",
+          "complexTypes": []
+        },
+        {
+          "text": "'ean13'",
+          "complexTypes": []
+        },
+        {
+          "text": "'interleaved2of5'",
+          "complexTypes": []
+        },
+        {
+          "text": "'itf14'",
+          "complexTypes": []
+        },
+        {
+          "text": "'pdf417'",
+          "complexTypes": []
+        },
+        {
+          "text": "'aztec'",
+          "complexTypes": []
+        },
+        {
+          "text": "'dataMatrix'",
+          "complexTypes": []
+        },
+        {
+          "text": "'upce'",
+          "complexTypes": []
+        }
+      ]
+    },
     {
       "name": "CameraPosition",
       "slug": "cameraposition",

package/dist/esm/definitions.d.ts

@@ -268,6 +268,40 @@ export type CameraDeviceType =
  | 'triple'
 /** builtInTrueDepthCamera - front-facing camera with depth sensing */
  | 'trueDepth';
+/**
+ * Supported barcode types for detection.
+ * Specifying only the barcode types you need can improve performance
+ * and reduce battery consumption.
+ *
+ * @since 2.1.0
+ */
+export type BarcodeType = 
+/** QR Code */
+'qr'
+/** Code 128 barcode */
+ | 'code128'
+/** Code 39 barcode */
+ | 'code39'
+/** Code 39 Mod 43 barcode */
+ | 'code39Mod43'
+/** Code 93 barcode */
+ | 'code93'
+/** EAN-8 barcode */
+ | 'ean8'
+/** EAN-13 barcode */
+ | 'ean13'
+/** Interleaved 2 of 5 barcode */
+ | 'interleaved2of5'
+/** ITF-14 barcode */
+ | 'itf14'
+/** PDF417 barcode */
+ | 'pdf417'
+/** Aztec code */
+ | 'aztec'
+/** Data Matrix code */
+ | 'dataMatrix'
+/** UPC-E barcode */
+ | 'upce';
 /**
  * Configuration options for starting a camera session.
  *
@@ -279,6 +313,16 @@ export interface CameraSessionConfiguration {
      * @default false
      */
     enableBarcodeDetection?: boolean;
+    /**
+     * Specific barcode types to detect. If not provided, all supported types are detected.
+     * Specifying only the types you need can significantly improve performance and reduce
+     * battery consumption, especially on mobile devices.
+     *
+     * @example ['qr', 'code128'] // Only detect QR codes and Code 128 barcodes
+     * @default undefined - all supported types are detected
+     * @since 2.1.0
+     */
+    barcodeTypes?: BarcodeType[];
     /**
      * Position of the camera to use
      * @default 'back'

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Main plugin interface for Capacitor Camera View functionality.\n *\n * @since 1.0.0\n */\nexport interface CameraViewPlugin {\n  /**\n   * Start the camera view with optional configuration.\n   *\n   * @param options - Configuration options for the camera session\n   * @returns A promise that resolves when the camera has started\n   *\n   * @since 1.0.0\n   */\n  start(options?: CameraSessionConfiguration): Promise<void>;\n\n  /**\n   * Stop the camera view and release resources.\n   *\n   * @returns A promise that resolves when the camera has stopped\n   *\n   * @since 1.0.0\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Check if the camera view is currently running.\n   *\n   * @returns A promise that resolves with an object containing the running state of the camera\n   *\n   * @since 1.0.0\n   */\n  isRunning(): Promise<IsRunningResponse>;\n\n  /**\n   * Capture a photo using the current camera configuration.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured photo\n   *\n   * @since 1.0.0\n   */\n  capture<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Captures a frame from the current camera preview without using the full camera capture pipeline.\n   *\n   * Unlike `capture()` which may trigger hardware-level photo capture on native platforms,\n   * this method quickly samples the current video stream. This is suitable computer vision or\n   * simple snapshots where high fidelity is not required.\n   *\n   * On web this method does exactly the same as `capture()` as it only captures a frame from the video stream\n   * because unfortunately [ImageCapture API](https://developer.mozilla.org/en-US/docs/Web/API/ImageCapture) is\n   * not yet well supported on the web.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured sample\n   *\n   * @since 1.0.0\n   */\n  captureSample<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Switch between front and back camera.\n   *\n   * @returns A promise that resolves when the camera has been flipped\n   *\n   * @since 1.0.0\n   */\n  flipCamera(): Promise<void>;\n\n  /**\n   * Get available camera devices for capturing photos.\n   *\n   * @returns A promise that resolves with an object containing an array of available capture devices\n   *\n   * @since 1.0.0\n   */\n  getAvailableDevices(): Promise<GetAvailableDevicesResponse>;\n\n  /**\n   * Get current zoom level information and available range.\n   *\n   * @remarks\n   * Make sure the camera is properly initialized before calling this method. Otherwise, this might\n   * lead to returning default values on android.\n   *\n   * @returns A promise that resolves with an object containing min, max and current zoom levels\n   *\n   * @since 1.0.0\n   */\n  getZoom(): Promise<GetZoomResponse>;\n\n  /**\n   * Set the camera zoom level.\n   *\n   * @param options - Zoom configuration options\n   * @param options.level - The zoom level to set\n   * @param options.ramp - Whether to animate the zoom level change, defaults to false (iOS only)\n   * @returns A promise that resolves when the zoom level has been set\n   *\n   * @remarks\n   * On web platforms, zoom functionality may be limited by browser support.\n   * When native zoom is not available, a CSS-based zoom simulation is applied.\n   *\n   * @since 1.0.0\n   */\n  setZoom(options: { level: number; ramp?: boolean }): Promise<void>;\n\n  /**\n   * Get current flash mode setting.\n   *\n   * @returns A promise that resolves with an object containing the current flash mode\n   *\n   * @since 1.0.0\n   */\n  getFlashMode(): Promise<GetFlashModeResponse>;\n\n  /**\n   * Get supported flash modes for the current camera.\n   *\n   * @returns A promise that resolves with an object containing an array of supported flash modes\n   *\n   * @since 1.0.0\n   */\n  getSupportedFlashModes(): Promise<GetSupportedFlashModesResponse>;\n\n  /**\n   * Set the camera flash mode.\n   *\n   * @param options - Flash mode configuration options\n   * @param options.mode - The flash mode to set\n   * @returns A promise that resolves when the flash mode has been set\n   *\n   * @since 1.0.0\n   */\n  setFlashMode(options: { mode: FlashMode }): Promise<void>;\n\n  /**\n   * Check if the device supports torch (flashlight) functionality.\n   *\n   * @remarks\n   * **Important**: You must call this method and verify torch availability before using\n   * `setTorchMode()` or `getTorchMode()`. Calling torch methods on devices without\n   * torch support will throw an exception.\n   *\n   * @returns A promise that resolves with an object containing torch availability status\n   *\n   * @since 1.2.0\n   */\n  isTorchAvailable(): Promise<IsTorchAvailableResponse>;\n\n  /**\n   * Get the current torch (flashlight) state.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * @returns A promise that resolves with an object containing the current torch state\n   *\n   * @since 1.2.0\n   */\n  getTorchMode(): Promise<GetTorchModeResponse>;\n\n  /**\n   * Set the torch (flashlight) mode and intensity.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * The torch provides continuous illumination, unlike flash which only activates during photo capture.\n   * On iOS, you can control the torch intensity level. On Android, the torch is either on or off.\n   *\n   * @param options - Torch configuration options\n   * @param options.enabled - Whether to enable or disable the torch\n   * @param options.level - The torch intensity level (0.0 to 1.0, iOS only). Defaults to 1.0 when enabled\n   * @returns A promise that resolves when the torch mode has been set\n   *\n   * @since 1.2.0\n   */\n  setTorchMode(options: { enabled: boolean; level?: number }): Promise<void>;\n\n  /**\n   * Check camera permission status without requesting permissions.\n   *\n   * @returns A promise that resolves with an object containing the camera permission status\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request camera permission from the user.\n   *\n   * @returns A promise that resolves with an object containing the camera permission status\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Listen for barcode detection events.\n   * This event is emitted when a barcode is detected in the camera preview.\n   *\n   * @param eventName - The name of the event to listen for ('barcodeDetected')\n   * @param listenerFunc - The callback function to execute when a barcode is detected\n   * @returns A promise that resolves with an event subscription\n   *\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'barcodeDetected',\n    listenerFunc: (data: BarcodeDetectionData) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @param eventName - Optional event name to remove listeners for\n   * @returns A promise that resolves when the listeners are removed\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(eventName?: string): Promise<void>;\n}\n\n// ------------------------------------------------------------------------------\n// Camera Configuration Types\n// ------------------------------------------------------------------------------\n\n/**\n * Position options for the camera.\n * - 'front': Front-facing camera\n * - 'back': Rear-facing camera\n *\n * @since 1.0.0\n */\nexport type CameraPosition = 'front' | 'back';\n\n/**\n * Flash mode options for the camera.\n * - 'off': Flash disabled\n * - 'on': Flash always on\n * - 'auto': Flash automatically enabled in low-light conditions\n *\n * @since 1.0.0\n */\nexport type FlashMode = 'off' | 'on' | 'auto';\n\n/**\n * Represents a physical camera device on the device.\n *\n * @since 1.0.0\n */\nexport interface CameraDevice {\n  /** The unique identifier of the camera device */\n  id: string;\n\n  /** The human-readable name of the camera device */\n  name: string;\n\n  /** The position of the camera device (front or back) */\n  position: CameraPosition;\n\n  /** The type of the camera device (e.g., wide, ultra-wide, telephoto) - iOS only */\n  deviceType?: CameraDeviceType;\n}\n\n/**\n * Available camera device types for iOS.\n * Maps to AVCaptureDevice DeviceTypes in iOS.\n *\n * @see https://developer.apple.com/documentation/avfoundation/avcapturedevice/devicetype-swift.struct\n *\n * @since 1.0.0\n */\nexport type CameraDeviceType =\n  /** builtInWideAngleCamera - standard camera */\n  | 'wideAngle'\n  /** builtInUltraWideCamera - 0.5x zoom level */\n  | 'ultraWide'\n  /** builtInTelephotoCamera - 2x/3x zoom level */\n  | 'telephoto'\n  /** builtInDualCamera - wide + telephoto combination */\n  | 'dual'\n  /** builtInDualWideCamera - wide + ultraWide combination */\n  | 'dualWide'\n  /** builtInTripleCamera - wide + ultraWide + telephoto */\n  | 'triple'\n  /** builtInTrueDepthCamera - front-facing camera with depth sensing */\n  | 'trueDepth';\n\n/**\n * Configuration options for starting a camera session.\n *\n * @since 1.0.0\n */\nexport interface CameraSessionConfiguration {\n  /**\n   * Enables the barcode detection functionality\n   * @default false\n   */\n  enableBarcodeDetection?: boolean;\n\n  /**\n   * Position of the camera to use\n   * @default 'back'\n   */\n  position?: CameraPosition;\n\n  /**\n   * Specific device ID of the camera to use\n   * If provided, takes precedence over position\n   */\n  deviceId?: string;\n\n  /**\n   * Whether to use the triple camera if available (iPhone Pro models only)\n   * @default false\n   */\n  useTripleCameraIfAvailable?: boolean;\n\n  /**\n   * Ordered list of preferred camera device types to use (iOS only).\n   * The system will attempt to use the first available camera type in the list.\n   * If position is also provided, the system will use the first available camera type\n   * that matches the position and is in the list.\n   *\n   * This will fallback to the default camera type if none of the preferred types are available.\n   *\n   * @example [CameraDeviceType.WideAngle, CameraDeviceType.UltraWide, CameraDeviceType.Telephoto]\n   * @default undefined - system will decide based on position/deviceId\n   */\n  preferredCameraDeviceTypes?: CameraDeviceType[];\n\n  /**\n   * The initial zoom factor to use\n   * @default 1.0\n   */\n  zoomFactor?: number;\n\n  /**\n   * Optional HTML ID of the container element where the camera view should be rendered.\n   * If not provided, the camera view will be appended to the document body. Web only.\n   * @example 'cameraContainer'\n   */\n  containerElementId?: string;\n}\n\n/**\n * Configuration options for capturing photos and samples.\n *\n * @since 1.1.0\n */\nexport interface CaptureOptions {\n  /**\n   * The JPEG quality of the captured photo/sample on a scale of 0-100\n   * @since 1.1.0\n   */\n  quality: number;\n\n  /**\n   * If true, saves to a temporary file and returns the web path instead of base64.\n   * The web path can be used to set the src attribute of an image for efficient loading and rendering.\n   * This reduces the data that needs to be transferred over the bridge, which can improve performance\n   * especially for high-resolution images.\n   * @default false\n   * @since 1.1.0\n   */\n  saveToFile?: boolean;\n}\n\n// ------------------------------------------------------------------------------\n// Response Interfaces\n// ------------------------------------------------------------------------------\n\n/**\n * Response for checking if the camera view is running.\n *\n * @since 1.0.0\n */\nexport interface IsRunningResponse {\n  /** Indicates if the camera view is currently active and running */\n  isRunning: boolean;\n}\n\n/**\n * Response for capturing a photo\n * This will contain either a base64 encoded string or a web path to the captured photo,\n * depending on the `saveToFile` option in the CaptureOptions.\n * @since 1.0.0\n */\nexport type CaptureResponse<T extends CaptureOptions = CaptureOptions> = T['saveToFile'] extends true\n  ? {\n      /** The web path to the captured photo that can be used to set the src attribute of an image for efficient loading and rendering (when saveToFile is true) */\n      webPath: string;\n    }\n  : {\n      /** The base64 encoded string of the captured photo (when saveToFile is false or undefined) */\n      photo: string;\n    };\n\n/**\n * Response for getting available camera devices.\n *\n * @since 1.0.0\n */\nexport interface GetAvailableDevicesResponse {\n  /** An array of available camera devices */\n  devices: CameraDevice[];\n}\n\n/**\n * Response for getting zoom level information.\n *\n * @since 1.0.0\n */\nexport interface GetZoomResponse {\n  /** The minimum zoom level supported */\n  min: number;\n\n  /** The maximum zoom level supported */\n  max: number;\n\n  /** The current zoom level */\n  current: number;\n}\n\n/**\n * Response for getting the current flash mode.\n *\n * @since 1.0.0\n */\nexport interface GetFlashModeResponse {\n  /** The current flash mode setting */\n  flashMode: FlashMode;\n}\n\n/**\n * Response for getting supported flash modes.\n *\n * @since 1.0.0\n */\nexport interface GetSupportedFlashModesResponse {\n  /** An array of flash modes supported by the current camera */\n  flashModes: FlashMode[];\n}\n\n/**\n * Response for checking torch availability.\n *\n * @since 1.2.0\n */\nexport interface IsTorchAvailableResponse {\n  /** Indicates if the device supports torch (flashlight) functionality */\n  available: boolean;\n}\n\n/**\n * Response for getting the current torch mode.\n *\n * @since 1.2.0\n */\nexport interface GetTorchModeResponse {\n  /** Indicates if the torch is currently enabled */\n  enabled: boolean;\n  /** The current torch intensity level (0.0 to 1.0, iOS only). Always 1.0 on Android when enabled */\n  level: number;\n}\n\n/**\n * Data for a detected barcode.\n *\n * @since 1.0.0\n */\nexport interface BarcodeDetectionData {\n  /** The decoded string value of the barcode */\n  value: string;\n\n  /** The display value of the barcode (may differ from the raw value) */\n  displayValue?: string;\n\n  /** The type/format of the barcode (e.g., 'qr', 'code128', etc.) */\n  type: string;\n\n  /** The bounding rectangle of the barcode in the camera frame. */\n  boundingRect: BoundingRect;\n}\n\n/**\n * Rectangle defining the boundary of the barcode in the camera frame.\n * Coordinates are normalized between 0 and 1 relative to the camera frame.\n *\n * @since 1.0.0\n */\nexport interface BoundingRect {\n  /** X-coordinate of the top-left corner */\n  x: number;\n  /** Y-coordinate of the top-left corner */\n  y: number;\n  /** Width of the bounding rectangle (should match the actual width of the barcode) */\n  width: number;\n  /** Height of the bounding rectangle (should match the actual height of the barcode) */\n  height: number;\n}\n\n/**\n * Response for the camera permission status.\n *\n * @since 1.0.0\n */\nexport interface PermissionStatus {\n  /** The state of the camera permission */\n  camera: PermissionState;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Main plugin interface for Capacitor Camera View functionality.\n *\n * @since 1.0.0\n */\nexport interface CameraViewPlugin {\n  /**\n   * Start the camera view with optional configuration.\n   *\n   * @param options - Configuration options for the camera session\n   * @returns A promise that resolves when the camera has started\n   *\n   * @since 1.0.0\n   */\n  start(options?: CameraSessionConfiguration): Promise<void>;\n\n  /**\n   * Stop the camera view and release resources.\n   *\n   * @returns A promise that resolves when the camera has stopped\n   *\n   * @since 1.0.0\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Check if the camera view is currently running.\n   *\n   * @returns A promise that resolves with an object containing the running state of the camera\n   *\n   * @since 1.0.0\n   */\n  isRunning(): Promise<IsRunningResponse>;\n\n  /**\n   * Capture a photo using the current camera configuration.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured photo\n   *\n   * @since 1.0.0\n   */\n  capture<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Captures a frame from the current camera preview without using the full camera capture pipeline.\n   *\n   * Unlike `capture()` which may trigger hardware-level photo capture on native platforms,\n   * this method quickly samples the current video stream. This is suitable computer vision or\n   * simple snapshots where high fidelity is not required.\n   *\n   * On web this method does exactly the same as `capture()` as it only captures a frame from the video stream\n   * because unfortunately [ImageCapture API](https://developer.mozilla.org/en-US/docs/Web/API/ImageCapture) is\n   * not yet well supported on the web.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured sample\n   *\n   * @since 1.0.0\n   */\n  captureSample<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Switch between front and back camera.\n   *\n   * @returns A promise that resolves when the camera has been flipped\n   *\n   * @since 1.0.0\n   */\n  flipCamera(): Promise<void>;\n\n  /**\n   * Get available camera devices for capturing photos.\n   *\n   * @returns A promise that resolves with an object containing an array of available capture devices\n   *\n   * @since 1.0.0\n   */\n  getAvailableDevices(): Promise<GetAvailableDevicesResponse>;\n\n  /**\n   * Get current zoom level information and available range.\n   *\n   * @remarks\n   * Make sure the camera is properly initialized before calling this method. Otherwise, this might\n   * lead to returning default values on android.\n   *\n   * @returns A promise that resolves with an object containing min, max and current zoom levels\n   *\n   * @since 1.0.0\n   */\n  getZoom(): Promise<GetZoomResponse>;\n\n  /**\n   * Set the camera zoom level.\n   *\n   * @param options - Zoom configuration options\n   * @param options.level - The zoom level to set\n   * @param options.ramp - Whether to animate the zoom level change, defaults to false (iOS only)\n   * @returns A promise that resolves when the zoom level has been set\n   *\n   * @remarks\n   * On web platforms, zoom functionality may be limited by browser support.\n   * When native zoom is not available, a CSS-based zoom simulation is applied.\n   *\n   * @since 1.0.0\n   */\n  setZoom(options: { level: number; ramp?: boolean }): Promise<void>;\n\n  /**\n   * Get current flash mode setting.\n   *\n   * @returns A promise that resolves with an object containing the current flash mode\n   *\n   * @since 1.0.0\n   */\n  getFlashMode(): Promise<GetFlashModeResponse>;\n\n  /**\n   * Get supported flash modes for the current camera.\n   *\n   * @returns A promise that resolves with an object containing an array of supported flash modes\n   *\n   * @since 1.0.0\n   */\n  getSupportedFlashModes(): Promise<GetSupportedFlashModesResponse>;\n\n  /**\n   * Set the camera flash mode.\n   *\n   * @param options - Flash mode configuration options\n   * @param options.mode - The flash mode to set\n   * @returns A promise that resolves when the flash mode has been set\n   *\n   * @since 1.0.0\n   */\n  setFlashMode(options: { mode: FlashMode }): Promise<void>;\n\n  /**\n   * Check if the device supports torch (flashlight) functionality.\n   *\n   * @remarks\n   * **Important**: You must call this method and verify torch availability before using\n   * `setTorchMode()` or `getTorchMode()`. Calling torch methods on devices without\n   * torch support will throw an exception.\n   *\n   * @returns A promise that resolves with an object containing torch availability status\n   *\n   * @since 1.2.0\n   */\n  isTorchAvailable(): Promise<IsTorchAvailableResponse>;\n\n  /**\n   * Get the current torch (flashlight) state.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * @returns A promise that resolves with an object containing the current torch state\n   *\n   * @since 1.2.0\n   */\n  getTorchMode(): Promise<GetTorchModeResponse>;\n\n  /**\n   * Set the torch (flashlight) mode and intensity.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * The torch provides continuous illumination, unlike flash which only activates during photo capture.\n   * On iOS, you can control the torch intensity level. On Android, the torch is either on or off.\n   *\n   * @param options - Torch configuration options\n   * @param options.enabled - Whether to enable or disable the torch\n   * @param options.level - The torch intensity level (0.0 to 1.0, iOS only). Defaults to 1.0 when enabled\n   * @returns A promise that resolves when the torch mode has been set\n   *\n   * @since 1.2.0\n   */\n  setTorchMode(options: { enabled: boolean; level?: number }): Promise<void>;\n\n  /**\n   * Check camera permission status without requesting permissions.\n   *\n   * @returns A promise that resolves with an object containing the camera permission status\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request camera permission from the user.\n   *\n   * @returns A promise that resolves with an object containing the camera permission status\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Listen for barcode detection events.\n   * This event is emitted when a barcode is detected in the camera preview.\n   *\n   * @param eventName - The name of the event to listen for ('barcodeDetected')\n   * @param listenerFunc - The callback function to execute when a barcode is detected\n   * @returns A promise that resolves with an event subscription\n   *\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'barcodeDetected',\n    listenerFunc: (data: BarcodeDetectionData) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @param eventName - Optional event name to remove listeners for\n   * @returns A promise that resolves when the listeners are removed\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(eventName?: string): Promise<void>;\n}\n\n// ------------------------------------------------------------------------------\n// Camera Configuration Types\n// ------------------------------------------------------------------------------\n\n/**\n * Position options for the camera.\n * - 'front': Front-facing camera\n * - 'back': Rear-facing camera\n *\n * @since 1.0.0\n */\nexport type CameraPosition = 'front' | 'back';\n\n/**\n * Flash mode options for the camera.\n * - 'off': Flash disabled\n * - 'on': Flash always on\n * - 'auto': Flash automatically enabled in low-light conditions\n *\n * @since 1.0.0\n */\nexport type FlashMode = 'off' | 'on' | 'auto';\n\n/**\n * Represents a physical camera device on the device.\n *\n * @since 1.0.0\n */\nexport interface CameraDevice {\n  /** The unique identifier of the camera device */\n  id: string;\n\n  /** The human-readable name of the camera device */\n  name: string;\n\n  /** The position of the camera device (front or back) */\n  position: CameraPosition;\n\n  /** The type of the camera device (e.g., wide, ultra-wide, telephoto) - iOS only */\n  deviceType?: CameraDeviceType;\n}\n\n/**\n * Available camera device types for iOS.\n * Maps to AVCaptureDevice DeviceTypes in iOS.\n *\n * @see https://developer.apple.com/documentation/avfoundation/avcapturedevice/devicetype-swift.struct\n *\n * @since 1.0.0\n */\nexport type CameraDeviceType =\n  /** builtInWideAngleCamera - standard camera */\n  | 'wideAngle'\n  /** builtInUltraWideCamera - 0.5x zoom level */\n  | 'ultraWide'\n  /** builtInTelephotoCamera - 2x/3x zoom level */\n  | 'telephoto'\n  /** builtInDualCamera - wide + telephoto combination */\n  | 'dual'\n  /** builtInDualWideCamera - wide + ultraWide combination */\n  | 'dualWide'\n  /** builtInTripleCamera - wide + ultraWide + telephoto */\n  | 'triple'\n  /** builtInTrueDepthCamera - front-facing camera with depth sensing */\n  | 'trueDepth';\n\n/**\n * Supported barcode types for detection.\n * Specifying only the barcode types you need can improve performance\n * and reduce battery consumption.\n *\n * @since 2.1.0\n */\nexport type BarcodeType =\n  /** QR Code */\n  | 'qr'\n  /** Code 128 barcode */\n  | 'code128'\n  /** Code 39 barcode */\n  | 'code39'\n  /** Code 39 Mod 43 barcode */\n  | 'code39Mod43'\n  /** Code 93 barcode */\n  | 'code93'\n  /** EAN-8 barcode */\n  | 'ean8'\n  /** EAN-13 barcode */\n  | 'ean13'\n  /** Interleaved 2 of 5 barcode */\n  | 'interleaved2of5'\n  /** ITF-14 barcode */\n  | 'itf14'\n  /** PDF417 barcode */\n  | 'pdf417'\n  /** Aztec code */\n  | 'aztec'\n  /** Data Matrix code */\n  | 'dataMatrix'\n  /** UPC-E barcode */\n  | 'upce';\n\n/**\n * Configuration options for starting a camera session.\n *\n * @since 1.0.0\n */\nexport interface CameraSessionConfiguration {\n  /**\n   * Enables the barcode detection functionality\n   * @default false\n   */\n  enableBarcodeDetection?: boolean;\n\n  /**\n   * Specific barcode types to detect. If not provided, all supported types are detected.\n   * Specifying only the types you need can significantly improve performance and reduce\n   * battery consumption, especially on mobile devices.\n   *\n   * @example ['qr', 'code128'] // Only detect QR codes and Code 128 barcodes\n   * @default undefined - all supported types are detected\n   * @since 2.1.0\n   */\n  barcodeTypes?: BarcodeType[];\n\n  /**\n   * Position of the camera to use\n   * @default 'back'\n   */\n  position?: CameraPosition;\n\n  /**\n   * Specific device ID of the camera to use\n   * If provided, takes precedence over position\n   */\n  deviceId?: string;\n\n  /**\n   * Whether to use the triple camera if available (iPhone Pro models only)\n   * @default false\n   */\n  useTripleCameraIfAvailable?: boolean;\n\n  /**\n   * Ordered list of preferred camera device types to use (iOS only).\n   * The system will attempt to use the first available camera type in the list.\n   * If position is also provided, the system will use the first available camera type\n   * that matches the position and is in the list.\n   *\n   * This will fallback to the default camera type if none of the preferred types are available.\n   *\n   * @example [CameraDeviceType.WideAngle, CameraDeviceType.UltraWide, CameraDeviceType.Telephoto]\n   * @default undefined - system will decide based on position/deviceId\n   */\n  preferredCameraDeviceTypes?: CameraDeviceType[];\n\n  /**\n   * The initial zoom factor to use\n   * @default 1.0\n   */\n  zoomFactor?: number;\n\n  /**\n   * Optional HTML ID of the container element where the camera view should be rendered.\n   * If not provided, the camera view will be appended to the document body. Web only.\n   * @example 'cameraContainer'\n   */\n  containerElementId?: string;\n}\n\n/**\n * Configuration options for capturing photos and samples.\n *\n * @since 1.1.0\n */\nexport interface CaptureOptions {\n  /**\n   * The JPEG quality of the captured photo/sample on a scale of 0-100\n   * @since 1.1.0\n   */\n  quality: number;\n\n  /**\n   * If true, saves to a temporary file and returns the web path instead of base64.\n   * The web path can be used to set the src attribute of an image for efficient loading and rendering.\n   * This reduces the data that needs to be transferred over the bridge, which can improve performance\n   * especially for high-resolution images.\n   * @default false\n   * @since 1.1.0\n   */\n  saveToFile?: boolean;\n}\n\n// ------------------------------------------------------------------------------\n// Response Interfaces\n// ------------------------------------------------------------------------------\n\n/**\n * Response for checking if the camera view is running.\n *\n * @since 1.0.0\n */\nexport interface IsRunningResponse {\n  /** Indicates if the camera view is currently active and running */\n  isRunning: boolean;\n}\n\n/**\n * Response for capturing a photo\n * This will contain either a base64 encoded string or a web path to the captured photo,\n * depending on the `saveToFile` option in the CaptureOptions.\n * @since 1.0.0\n */\nexport type CaptureResponse<T extends CaptureOptions = CaptureOptions> = T['saveToFile'] extends true\n  ? {\n      /** The web path to the captured photo that can be used to set the src attribute of an image for efficient loading and rendering (when saveToFile is true) */\n      webPath: string;\n    }\n  : {\n      /** The base64 encoded string of the captured photo (when saveToFile is false or undefined) */\n      photo: string;\n    };\n\n/**\n * Response for getting available camera devices.\n *\n * @since 1.0.0\n */\nexport interface GetAvailableDevicesResponse {\n  /** An array of available camera devices */\n  devices: CameraDevice[];\n}\n\n/**\n * Response for getting zoom level information.\n *\n * @since 1.0.0\n */\nexport interface GetZoomResponse {\n  /** The minimum zoom level supported */\n  min: number;\n\n  /** The maximum zoom level supported */\n  max: number;\n\n  /** The current zoom level */\n  current: number;\n}\n\n/**\n * Response for getting the current flash mode.\n *\n * @since 1.0.0\n */\nexport interface GetFlashModeResponse {\n  /** The current flash mode setting */\n  flashMode: FlashMode;\n}\n\n/**\n * Response for getting supported flash modes.\n *\n * @since 1.0.0\n */\nexport interface GetSupportedFlashModesResponse {\n  /** An array of flash modes supported by the current camera */\n  flashModes: FlashMode[];\n}\n\n/**\n * Response for checking torch availability.\n *\n * @since 1.2.0\n */\nexport interface IsTorchAvailableResponse {\n  /** Indicates if the device supports torch (flashlight) functionality */\n  available: boolean;\n}\n\n/**\n * Response for getting the current torch mode.\n *\n * @since 1.2.0\n */\nexport interface GetTorchModeResponse {\n  /** Indicates if the torch is currently enabled */\n  enabled: boolean;\n  /** The current torch intensity level (0.0 to 1.0, iOS only). Always 1.0 on Android when enabled */\n  level: number;\n}\n\n/**\n * Data for a detected barcode.\n *\n * @since 1.0.0\n */\nexport interface BarcodeDetectionData {\n  /** The decoded string value of the barcode */\n  value: string;\n\n  /** The display value of the barcode (may differ from the raw value) */\n  displayValue?: string;\n\n  /** The type/format of the barcode (e.g., 'qr', 'code128', etc.) */\n  type: string;\n\n  /** The bounding rectangle of the barcode in the camera frame. */\n  boundingRect: BoundingRect;\n}\n\n/**\n * Rectangle defining the boundary of the barcode in the camera frame.\n * Coordinates are normalized between 0 and 1 relative to the camera frame.\n *\n * @since 1.0.0\n */\nexport interface BoundingRect {\n  /** X-coordinate of the top-left corner */\n  x: number;\n  /** Y-coordinate of the top-left corner */\n  y: number;\n  /** Width of the bounding rectangle (should match the actual width of the barcode) */\n  width: number;\n  /** Height of the bounding rectangle (should match the actual height of the barcode) */\n  height: number;\n}\n\n/**\n * Response for the camera permission status.\n *\n * @since 1.0.0\n */\nexport interface PermissionStatus {\n  /** The state of the camera permission */\n  camera: PermissionState;\n}\n"]}

package/dist/esm/web.d.ts

@@ -1,5 +1,6 @@
 import { WebPlugin } from '@capacitor/core';
-import type { CameraSessionConfiguration, CameraViewPlugin, GetAvailableDevicesResponse, GetFlashModeResponse, GetSupportedFlashModesResponse, GetTorchModeResponse, GetZoomResponse, IsTorchAvailableResponse, IsRunningResponse, PermissionStatus, CaptureResponse, FlashMode, CaptureOptions } from './definitions';
+import type { CameraSessionConfiguration, CameraViewPlugin, GetAvailableDevicesResponse, GetFlashModeResponse, GetSupportedFlashModesResponse, GetTorchModeResponse, GetZoomResponse, IsTorchAvailableResponse, IsRunningResponse, PermissionStatus, CaptureResponse, FlashMode, CaptureOptions, BarcodeType } from './definitions';
+export declare const BARCODE_TYPE_TO_WEB_FORMAT: Readonly<Record<BarcodeType, BarcodeFormat | null>>;
 /**
  * Web implementation of the CameraViewPlugin.
  * Optimized for performance and battery efficiency.
@@ -101,6 +102,11 @@ export declare class CameraViewWeb extends WebPlugin implements CameraViewPlugin
      * Check if barcode detection is supported in this browser
      */
     private checkBarcodeDetectionSupport;
+    /**
+     * Configure the barcode detector with requested barcode formats.
+     * Unsupported formats are ignored and logged.
+     */
+    private configureBarcodeDetector;
     /**
      * Set up the video element for the camera view
      */