@capgo/camera-preview 8.9.0 → 8.10.0

package/README.md

@@ -1565,15 +1565,17 @@ Defines the options for capturing a picture.
 | **`embedTimestamp`**             | <code>boolean</code>                                    | If true, the plugin will embed a timestamp in the top-right corner of the image.                                                                                                                                                                                                                                                                                                      | <code>false</code>   | 7.17.0 |
 | **`embedLocation`**              | <code>boolean</code>                                    | If true, the plugin will embed the current location in the top-right corner of the image. Requires `withExifLocation` to be enabled.                                                                                                                                                                                                                                                  | <code>false</code>   | 7.18.0 |
 | **`photoQualityPrioritization`** | <code>'speed' \| 'balanced' \| 'quality'</code>         | Sets the priority for photo quality vs. capture speed. - "speed": Prioritizes faster capture times, may reduce image quality. - "balanced": Aims for a balance between quality and speed. - "quality": Prioritizes image quality, may reduce capture speed. See https://developer.apple.com/documentation/avfoundation/avcapturephotosettings/photoqualityprioritization for details. | <code>"speed"</code> | 7.21.0 |
+| **`mirrorFrontCamera`**          | <code>boolean</code>                                    | If true and the front camera is active, horizontally mirror the captured photo so it matches a selfie-style preview. Rear camera captures are never mirrored. Defaults to false to preserve the previous non-mirrored behavior.                                                                                                                                                       | <code>false</code>   | 8.10.0 |
 
 
 #### CameraSampleOptions
 
 Defines the options for capturing a sample frame from the camera preview.
 
-| Prop          | Type                | Description                                        | Default         |
-| ------------- | ------------------- | -------------------------------------------------- | --------------- |
-| **`quality`** | <code>number</code> | The quality of the captured sample, from 0 to 100. | <code>85</code> |
+| Prop                    | Type                 | Description                                                                                                                                                                                                                     | Default            | Since  |
+| ----------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------ |
+| **`quality`**           | <code>number</code>  | The quality of the captured sample, from 0 to 100.                                                                                                                                                                              | <code>85</code>    |        |
+| **`mirrorFrontCamera`** | <code>boolean</code> | If true and the front camera is active, horizontally mirror the captured sample so it matches a selfie-style preview. Rear camera samples are never mirrored. Defaults to false to preserve the previous non-mirrored behavior. | <code>false</code> | 8.10.0 |
 
 
 #### CameraPermissionStatus

package/android/src/main/java/app/capgo/capacitor/camera/preview/CameraPreview.java

@@ -527,8 +527,9 @@ public class CameraPreview extends Plugin implements CameraXView.CameraXViewList
         Integer height = call.getInt("height");
         final boolean embedTimestamp = Boolean.TRUE.equals(call.getBoolean("embedTimestamp"));
         final boolean embedLocation = Boolean.TRUE.equals(call.getBoolean("embedLocation"));
+        final boolean mirrorFrontCamera = Boolean.TRUE.equals(call.getBoolean("mirrorFrontCamera"));
 
-        cameraXView.capturePhoto(quality, saveToGallery, width, height, location, embedTimestamp, embedLocation);
+        cameraXView.capturePhoto(quality, saveToGallery, width, height, location, embedTimestamp, embedLocation, mirrorFrontCamera);
     }
 
     @PluginMethod
@@ -540,7 +541,8 @@ public class CameraPreview extends Plugin implements CameraXView.CameraXViewList
         bridge.saveCall(call);
         sampleCallbackId = call.getCallbackId();
         Integer quality = Objects.requireNonNull(call.getInt("quality", 85));
-        cameraXView.captureSample(quality);
+        final boolean mirrorFrontCamera = Boolean.TRUE.equals(call.getBoolean("mirrorFrontCamera"));
+        cameraXView.captureSample(quality, mirrorFrontCamera);
     }
 
     @PluginMethod

package/android/src/main/java/app/capgo/capacitor/camera/preview/CameraXView.java

@@ -2026,7 +2026,8 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
         Integer height,
         Location location,
         final boolean embedTimestamp,
-        final boolean embedLocation
+        final boolean embedLocation,
+        final boolean mirrorFrontCamera
     ) {
         if (imageCapture == null) {
             if (listener != null) {
@@ -2060,7 +2061,9 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
                 ", embedTimestamp: " +
                 embedTimestamp +
                 ", embedLocation: " +
-                embedLocation
+                embedLocation +
+                ", mirrorFrontCamera: " +
+                mirrorFrontCamera
         );
 
         boolean dispatched = false;
@@ -2116,6 +2119,7 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
                             if (width != null || height != null) {
                                 Bitmap bitmap = BitmapFactory.decodeByteArray(originalCaptureBytes, 0, originalCaptureBytes.length);
                                 bitmap = applyExifOrientation(bitmap, exifInterface);
+                                bitmap = maybeMirrorFrontCameraBitmap(bitmap, mirrorFrontCamera);
                                 Bitmap resizedBitmap = resizeBitmapToMaxDimensions(bitmap, width, height);
                                 if (embedTimestamp || embedLocation) {
                                     resizedBitmap = drawTimestampAndLocationOntoBitmap(
@@ -2144,6 +2148,7 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
                                 // No explicit size/ratio: crop to match current preview content
                                 Bitmap originalBitmap = BitmapFactory.decodeByteArray(originalCaptureBytes, 0, originalCaptureBytes.length);
                                 originalBitmap = applyExifOrientation(originalBitmap, exifInterface);
+                                originalBitmap = maybeMirrorFrontCameraBitmap(originalBitmap, mirrorFrontCamera);
                                 Bitmap previewCropped = cropBitmapToMatchPreview(originalBitmap);
                                 if (embedTimestamp || embedLocation) {
                                     previewCropped = drawTimestampAndLocationOntoBitmap(
@@ -2401,6 +2406,29 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
         }
     }
 
+    private boolean shouldMirrorFrontCamera(boolean mirrorFrontCamera) {
+        return mirrorFrontCamera && sessionConfig != null && "front".equals(sessionConfig.getPosition());
+    }
+
+    private Bitmap maybeMirrorFrontCameraBitmap(Bitmap bitmap, boolean mirrorFrontCamera) {
+        if (bitmap == null || !shouldMirrorFrontCamera(mirrorFrontCamera)) {
+            return bitmap;
+        }
+        return mirrorBitmapHorizontally(bitmap);
+    }
+
+    private Bitmap mirrorBitmapHorizontally(Bitmap bitmap) {
+        Matrix matrix = new Matrix();
+        matrix.preScale(-1.0f, 1.0f);
+        Bitmap mirrored = Bitmap.createBitmap(bitmap, 0, 0, bitmap.getWidth(), bitmap.getHeight(), matrix, true);
+        if (mirrored != bitmap) {
+            try {
+                bitmap.recycle();
+            } catch (Exception ignore) {}
+        }
+        return mirrored;
+    }
+
     private Bitmap applyExifOrientation(Bitmap bitmap, ExifInterface exif) {
         try {
             int orientation = exif.getAttributeInt(ExifInterface.TAG_ORIENTATION, ExifInterface.ORIENTATION_UNDEFINED);
@@ -2763,7 +2791,7 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
     // Note: We avoid temporary files for EXIF writes. When we transform pixels (resize/crop),
     // we recompress JPEG in-memory and update EXIF info only in the returned JSON, not in the bytes.
 
-    public void captureSample(int quality) {
+    public void captureSample(int quality, final boolean mirrorFrontCamera) {
         if (sampleImageCapture == null) {
             if (listener != null) {
                 listener.onSampleTakenError("Camera not ready");
@@ -2775,7 +2803,7 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
             Log.d(TAG, "captureSample: Ignored because stop is pending");
             return;
         }
-        Log.d(TAG, "captureSample: Starting sample capture with quality: " + quality);
+        Log.d(TAG, "captureSample: Starting sample capture with quality: " + quality + ", mirrorFrontCamera: " + mirrorFrontCamera);
 
         boolean dispatched = false;
         try {
@@ -2797,6 +2825,20 @@ public class CameraXView implements LifecycleOwner, LifecycleObserver {
                         try {
                             // Convert ImageProxy to byte array
                             byte[] bytes = imageProxyToByteArray(image);
+                            if (shouldMirrorFrontCamera(mirrorFrontCamera)) {
+                                Bitmap bitmap = BitmapFactory.decodeByteArray(bytes, 0, bytes.length);
+                                if (bitmap != null) {
+                                    Bitmap mirrored = mirrorBitmapHorizontally(bitmap);
+                                    ByteArrayOutputStream stream = new ByteArrayOutputStream();
+                                    mirrored.compress(Bitmap.CompressFormat.JPEG, quality, stream);
+                                    bytes = stream.toByteArray();
+                                    if (mirrored != bitmap) {
+                                        try {
+                                            bitmap.recycle();
+                                        } catch (Exception ignore) {}
+                                    }
+                                }
+                            }
                             String base64 = Base64.encodeToString(bytes, Base64.NO_WRAP);
 
                             if (listener != null) {

package/dist/docs.json

@@ -2343,6 +2343,22 @@
           "docs": "Sets the priority for photo quality vs. capture speed.\n- \"speed\": Prioritizes faster capture times, may reduce image quality.\n- \"balanced\": Aims for a balance between quality and speed.\n- \"quality\": Prioritizes image quality, may reduce capture speed.\nSee https://developer.apple.com/documentation/avfoundation/avcapturephotosettings/photoqualityprioritization for details.",
           "complexTypes": [],
           "type": "'speed' | 'balanced' | 'quality' | undefined"
+        },
+        {
+          "name": "mirrorFrontCamera",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            },
+            {
+              "text": "8.10.0",
+              "name": "since"
+            }
+          ],
+          "docs": "If true and the front camera is active, horizontally mirror the captured photo\nso it matches a selfie-style preview. Rear camera captures are never mirrored.\nDefaults to false to preserve the previous non-mirrored behavior.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ]
     },
@@ -2364,6 +2380,22 @@
           "docs": "The quality of the captured sample, from 0 to 100.",
           "complexTypes": [],
           "type": "number | undefined"
+        },
+        {
+          "name": "mirrorFrontCamera",
+          "tags": [
+            {
+              "text": "false",
+              "name": "default"
+            },
+            {
+              "text": "8.10.0",
+              "name": "since"
+            }
+          ],
+          "docs": "If true and the front camera is active, horizontally mirror the captured sample\nso it matches a selfie-style preview. Rear camera samples are never mirrored.\nDefaults to false to preserve the previous non-mirrored behavior.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ]
     },

package/dist/esm/definitions.d.ts

@@ -411,6 +411,14 @@ export interface CameraPreviewPictureOptions {
      * @default "speed"
      */
     photoQualityPrioritization?: 'speed' | 'balanced' | 'quality';
+    /**
+     * If true and the front camera is active, horizontally mirror the captured photo
+     * so it matches a selfie-style preview. Rear camera captures are never mirrored.
+     * Defaults to false to preserve the previous non-mirrored behavior.
+     * @default false
+     * @since 8.10.0
+     */
+    mirrorFrontCamera?: boolean;
 }
 /** Represents EXIF data extracted from an image. */
 export interface ExifData {
@@ -440,6 +448,14 @@ export interface CameraSampleOptions {
      * @default 85
      */
     quality?: number;
+    /**
+     * If true and the front camera is active, horizontally mirror the captured sample
+     * so it matches a selfie-style preview. Rear camera samples are never mirrored.
+     * Defaults to false to preserve the previous non-mirrored behavior.
+     * @default false
+     * @since 8.10.0
+     */
+    mirrorFrontCamera?: boolean;
 }
 /**
  * The available flash modes for the camera.

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA8EA,MAAM,CAAN,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,sCAAwB,CAAA;IACxB,sCAAwB,CAAA;IACxB,qCAAuB,CAAA;IACvB,sCAAwB,CAAA;IACxB,2BAAa,CAAA;IACb,oCAAsB,CAAA;IACtB,+BAAiB,CAAA;AACnB,CAAC,EARW,UAAU,KAAV,UAAU,QAQrB","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\nexport type CameraPosition = 'rear' | 'front';\n\nexport type FlashMode = CameraPreviewFlashMode;\n\nexport type GridMode = 'none' | '3x3' | '4x4';\n\nexport type CameraPositioning = 'center' | 'top' | 'bottom';\n\nexport type CameraPreviewAspectRatio = '4:3' | '16:9' | 'fill';\n\nexport type BarcodeScannerFormat =\n  | 'aztec'\n  | 'codabar'\n  | 'code_39'\n  | 'code_93'\n  | 'code_128'\n  | 'data_matrix'\n  | 'ean_8'\n  | 'ean_13'\n  | 'itf'\n  | 'pdf417'\n  | 'qr_code'\n  | 'upc_a'\n  | 'upc_e';\n\nexport type BarcodeFormat = BarcodeScannerFormat | 'unknown';\n\nexport interface BarcodeScannerOptions {\n  /**\n   * Restricts detection to the given formats. Leaving this empty scans all supported formats.\n   * Restricting formats can improve scanning speed.\n   */\n  formats?: BarcodeScannerFormat[];\n  /**\n   * Minimum delay between native scan attempts in milliseconds.\n   * Lower values scan more often but use more CPU.\n   * @default 500\n   */\n  detectionInterval?: number;\n}\n\nexport interface BarcodeScanResult {\n  /** Decoded barcode value. */\n  value: string;\n  /** Barcode format. */\n  format: BarcodeFormat;\n  /** Human-readable value when the platform exposes one. */\n  displayValue?: string;\n  /** Base64-encoded raw bytes when the platform exposes them. */\n  rawBytes?: string;\n}\n\nexport interface BarcodeScannedEvent {\n  /** Barcodes decoded from the current frame. */\n  barcodes: BarcodeScanResult[];\n}\n\nexport interface BarcodeScanErrorEvent {\n  /** Native scanner error message. */\n  message: string;\n}\n\nexport interface CameraPermissionStatus {\n  camera: PermissionState;\n  microphone?: PermissionState;\n}\n\nexport interface PermissionRequestOptions {\n  disableAudio?: boolean;\n  showSettingsAlert?: boolean;\n  title?: string;\n  message?: string;\n  openSettingsButtonTitle?: string;\n  cancelButtonTitle?: string;\n}\n\nexport enum DeviceType {\n  ULTRA_WIDE = 'ultraWide',\n  WIDE_ANGLE = 'wideAngle',\n  TELEPHOTO = 'telephoto',\n  TRUE_DEPTH = 'trueDepth',\n  DUAL = 'dual',\n  DUAL_WIDE = 'dualWide',\n  TRIPLE = 'triple',\n}\n\n/**\n * Represents a single camera lens on a device. A {@link CameraDevice} can have multiple lenses.\n */\nexport interface CameraLens {\n  /** A human-readable name for the lens, e.g., \"Ultra-Wide\". */\n  label: string;\n  /** The type of the camera lens. */\n  deviceType: DeviceType;\n  /** The focal length of the lens in millimeters. */\n  focalLength: number;\n  /** The base zoom factor for this lens (e.g., 0.5 for ultra-wide, 1.0 for wide). */\n  baseZoomRatio: number;\n  /** The minimum zoom factor supported by this specific lens. */\n  minZoom: number;\n  /** The maximum zoom factor supported by this specific lens. */\n  maxZoom: number;\n}\n\n/**\n * Represents a physical camera on the device (e.g., the front-facing camera).\n */\nexport interface CameraDevice {\n  /** A unique identifier for the camera device. */\n  deviceId: string;\n  /** A human-readable name for the camera device. */\n  label: string;\n  /** The physical position of the camera on the device. */\n  position: CameraPosition;\n  /** A list of all available lenses for this camera device. */\n  lenses: CameraLens[];\n  /** The overall minimum zoom factor available across all lenses on this device. */\n  minZoom: number;\n  /** The overall maximum zoom factor available across all lenses on this device. */\n  maxZoom: number;\n  /** Identifies whether the device is a logical camera (composed of multiple physical lenses). */\n  isLogical: boolean;\n}\n\n/**\n * Represents the detailed information of the currently active lens.\n */\nexport interface LensInfo {\n  /** The focal length of the active lens in millimeters. */\n  focalLength: number;\n  /** The device type of the active lens. */\n  deviceType: DeviceType;\n  /** The base zoom ratio of the active lens (e.g., 0.5x, 1.0x). */\n  baseZoomRatio: number;\n  /** The current digital zoom factor applied on top of the base zoom. */\n  digitalZoom: number;\n}\n\nexport type VideoQuality = 'low' | 'medium' | 'high' | '2160p' | '1080p' | '720p' | '480p' | '4:3';\n\n/**\n * Video codec identifiers used when recording.\n * - `avc1`: H.264\n * - `hvc1`: HEVC / H.265\n */\nexport type VideoCodec = 'avc1' | 'hvc1' | 'jpeg' | 'apcn' | 'ap4h';\n\n/**\n * Video stabilization modes used when recording.\n *\n * On Android only `off` and `standard` are supported.\n * On iOS all listed modes may be available when the device supports video stabilization.\n */\nexport type VideoStabilizationMode =\n  | 'off'\n  | 'standard'\n  | 'cinematic'\n  | 'cinematicExtended'\n  | 'previewOptimized'\n  | 'cinematicExtendedEnhanced'\n  | 'auto'\n  | 'lowLatency';\n\nexport type RecordingFinishedReason = 'manual' | 'maxDuration' | 'maxFileSize';\n\nexport interface RecordingFinishedEvent {\n  /**\n   * The path to the recorded video file.\n   */\n  videoFilePath: string;\n  /**\n   * Why the recording stopped.\n   */\n  reason: RecordingFinishedReason;\n}\n\n/**\n * Defines the configuration options for starting the camera preview.\n */\nexport interface CameraPreviewOptions {\n  /**\n   * The parent element to attach the video preview to.\n   * @platform web\n   */\n  parent?: string;\n  /**\n   * A CSS class name to add to the preview element.\n   * @platform web\n   */\n  className?: string;\n  /**\n   * The width of the preview in pixels. Defaults to the screen width.\n   * @platform android, ios, web\n   */\n  width?: number;\n  /**\n   * The height of the preview in pixels. Defaults to the screen height.\n   * @platform android, ios, web\n   */\n  height?: number;\n  /**\n   * The horizontal origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  x?: number;\n  /**\n   * The vertical origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  y?: number;\n  /**\n   * The aspect ratio of the camera preview, '4:3' or '16:9' or 'fill'.\n   * Cannot be set if width or height is provided, otherwise the call will be rejected.\n   * Use setPreviewSize to adjust size after starting.\n   *\n   * @since 2.0.0\n   */\n  aspectRatio?: CameraPreviewAspectRatio;\n  /**\n   * Controls how the camera preview fills the available space.\n   * - 'contain': Fits the entire preview within the space, may show letterboxing (default).\n   * - 'cover': Fills the entire space, may crop edges of the preview.\n   * @default \"contain\"\n   * @platform android, ios, web\n   */\n  aspectMode?: 'cover' | 'contain';\n  /**\n   * The grid overlay to display on the camera preview.\n   * @default \"none\"\n   * @since 2.1.0\n   */\n  gridMode?: GridMode;\n  /**\n   * Adjusts the y-position to account for safe areas (e.g., notches).\n   * @platform android, ios\n   * @default false\n   */\n  includeSafeAreaInsets?: boolean;\n  /**\n   * If true, places the preview behind the webview.\n   * @platform android\n   * @default true\n   */\n  toBack?: boolean;\n  /**\n   * Bottom padding for the preview, in pixels.\n   * @platform android, ios\n   */\n  paddingBottom?: number;\n  /**\n   * Whether to rotate the preview when the device orientation changes.\n   * @platform ios\n   * @default true\n   */\n  rotateWhenOrientationChanged?: boolean;\n  /**\n   * The camera to use.\n   * @default \"rear\"\n   */\n  position?: CameraPosition | string;\n  /**\n   * If true, saves the captured image to a file and returns the file path.\n   * If false, returns a base64 encoded string.\n   * @default false\n   */\n  storeToFile?: boolean;\n  /**\n   * If true, prevents the plugin from rotating the image based on EXIF data.\n   * @platform android\n   * @default false\n   */\n  disableExifHeaderStripping?: boolean;\n  /**\n   * If true, disables the audio stream, preventing audio permission requests.\n   * @default true\n   */\n  disableAudio?: boolean;\n  /**\n   * If true, locks the device orientation while the camera is active.\n   * @platform android\n   * @default false\n   */\n  lockAndroidOrientation?: boolean;\n  /**\n   * If true, allows the camera preview's opacity to be changed.\n   * @platform android, web\n   * @default false\n   */\n  enableOpacity?: boolean;\n\n  /**\n   * If true, disables the visual focus indicator when tapping to focus.\n   * @platform android, ios\n   * @default false\n   */\n  disableFocusIndicator?: boolean;\n  /**\n   * The `deviceId` of the camera to use. If provided, `position` is ignored.\n   * @platform ios\n   */\n  deviceId?: string;\n  /**\n   * On Android, attempts to bind a physical camera directly when `deviceId` refers to a physical lens.\n   * Disabled by default because OEM support is inconsistent; when false, Android keeps the current logical-camera fallback behavior.\n   * @default false\n   * @platform android\n   */\n  enablePhysicalDeviceSelection?: boolean;\n  /**\n   * The initial zoom level when starting the camera preview.\n   * If the requested zoom level is not available, the native plugin will reject.\n   * @default 1.0\n   * @platform android, ios\n   * @since 2.2.0\n   */\n  initialZoomLevel?: number;\n  /**\n   * The vertical positioning of the camera preview.\n   * @default \"center\"\n   * @platform android, ios, web\n   * @since 2.3.0\n   */\n  positioning?: CameraPositioning;\n  /**\n   * If true, enables video capture capabilities when the camera starts.\n   * @default false\n   * @platform android, ios\n   * @since 7.11.0\n   */\n  enableVideoMode?: boolean;\n  /**\n   * If true, forces the camera to start/restart even if it's already running or busy.\n   * This will kill the current camera session and start a new one, ignoring all state checks.\n   * @default false\n   * @platform android, ios, web\n   */\n  force?: boolean;\n  /**\n   * Sets the quality of video for recording.\n   * Options: 'low', 'medium', 'high', '2160p', '1080p', '720p', '480p', '4:3'\n   * @note On Android requires 'enableVideoMode' to be true\n   * @note Will affect the entire preview stream for iOS\n   * @platform ios, android\n   * @default \"high\"\n   */\n  videoQuality?: VideoQuality;\n  /**\n   * Maximum recording duration in seconds. Recording stops automatically when reached.\n   * @platform ios, android\n   */\n  maxDuration?: number;\n  /**\n   * Maximum recording file size in bytes. Recording stops automatically when reached.\n   * @platform ios, android\n   */\n  maxFileSize?: number;\n  /**\n   * Preferred video codec for recording.\n   * @platform ios, android\n   * @default \"avc1\"\n   */\n  videoCodec?: VideoCodec;\n  /**\n   * Target video frame rate in frames per second.\n   * Applied when recording starts. Use `getSupportedVideoFrameRates()` to list supported values.\n   * @platform ios, android\n   * @since 8.6.0\n   */\n  frameRate?: number;\n  /**\n   * Preferred video stabilization mode for recording.\n   * @platform ios, android\n   * @default \"off\"\n   */\n  videoStabilizationMode?: VideoStabilizationMode;\n  /**\n   * When `true`, allows haptic feedback and system sounds while recording video with audio.\n   * iOS suppresses haptics during audio input recording unless this is enabled.\n   * Requires `disableAudio: false`.\n   * @platform ios\n   * @default false\n   * @since 8.8.0\n   */\n  allowHapticsAndSystemSoundsDuringRecording?: boolean;\n  /**\n   * Starts barcode scanning together with the camera preview.\n   * Set to `true` or pass options to scan all supported formats.\n   * Omit this option to keep barcode scanning disabled at startup.\n   * @platform android, ios, web\n   * @since 8.8.0\n   */\n  barcodeScanner?: boolean | BarcodeScannerOptions;\n}\n\n/**\n * Defines the options for capturing a picture.\n */\nexport interface CameraPreviewPictureOptions {\n  /**\n   * The maximum height of the picture in pixels. The image will be resized to fit within this height while maintaining aspect ratio.\n   * If not specified the captured image will match the preview's visible area.\n   */\n  height?: number;\n  /**\n   * The maximum width of the picture in pixels. The image will be resized to fit within this width while maintaining aspect ratio.\n   * If not specified the captured image will match the preview's visible area.\n   */\n  width?: number;\n  /**\n   * The quality of the captured image, from 0 to 100.\n   * Does not apply to `png` format.\n   * @default 85\n   */\n  quality?: number;\n  /**\n   * The format of the captured image.\n   * @default \"jpeg\"\n   */\n  format?: PictureFormat;\n  /**\n   * If true, the captured image will be saved to the user's gallery.\n   * @default false\n   * @since 7.5.0\n   */\n  saveToGallery?: boolean;\n  /**\n   * If true, the plugin will attempt to add GPS location data to the image's EXIF metadata.\n   * This may prompt the user for location permissions.\n   * @default false\n   * @since 7.6.0\n   */\n  withExifLocation?: boolean;\n  /**\n   * If true, the plugin will embed a timestamp in the top-right corner of the image.\n   * @default false\n   * @since 7.17.0\n   */\n  embedTimestamp?: boolean;\n  /**\n   * If true, the plugin will embed the current location in the top-right corner of the image.\n   * Requires `withExifLocation` to be enabled.\n   * @default false\n   * @since 7.18.0\n   */\n  embedLocation?: boolean;\n  /**\n   * Sets the priority for photo quality vs. capture speed.\n   * - \"speed\": Prioritizes faster capture times, may reduce image quality.\n   * - \"balanced\": Aims for a balance between quality and speed.\n   * - \"quality\": Prioritizes image quality, may reduce capture speed.\n   * See https://developer.apple.com/documentation/avfoundation/avcapturephotosettings/photoqualityprioritization for details.\n   *\n   * @since 7.21.0\n   * @platform ios\n   * @default \"speed\"\n   */\n  photoQualityPrioritization?: 'speed' | 'balanced' | 'quality';\n}\n\n/** Represents EXIF data extracted from an image. */\nexport interface ExifData {\n  [key: string]: any;\n}\n\nexport type PictureFormat = 'jpeg' | 'png';\n\n/** Defines a standard picture size with width and height. */\nexport interface PictureSize {\n  /** The width of the picture in pixels. */\n  width: number;\n  /** The height of the picture in pixels. */\n  height: number;\n}\n\n/** Represents the supported picture sizes for a camera facing a certain direction. */\nexport interface SupportedPictureSizes {\n  /** The camera direction (\"front\" or \"rear\"). */\n  facing: string;\n  /** A list of supported picture sizes for this camera. */\n  supportedPictureSizes: PictureSize[];\n}\n\n/**\n * Defines the options for capturing a sample frame from the camera preview.\n */\nexport interface CameraSampleOptions {\n  /**\n   * The quality of the captured sample, from 0 to 100.\n   * @default 85\n   */\n  quality?: number;\n}\n\n/**\n * The available flash modes for the camera.\n * 'torch' is a continuous light mode.\n */\nexport type CameraPreviewFlashMode = 'off' | 'on' | 'auto' | 'torch';\n\n/** Reusable exposure mode type for cross-platform support. */\nexport type ExposureMode = 'AUTO' | 'LOCK' | 'CONTINUOUS' | 'CUSTOM';\n\n/**\n * Reusable white-balance mode type for cross-platform support.\n * `CUSTOM` is reserved for a future manual white-balance gains API and is not\n * returned by `getWhiteBalanceModes()` until implemented.\n */\nexport type WhiteBalanceMode = 'AUTO' | 'LOCK' | 'CONTINUOUS' | 'CUSTOM';\n\n/**\n * Defines the options for setting the camera preview's opacity.\n */\nexport interface CameraOpacityOptions {\n  /**\n   * The opacity percentage, from 0.0 (fully transparent) to 1.0 (fully opaque).\n   * @default 1.0\n   */\n  opacity?: number;\n}\n\n/**\n * Represents safe area insets for devices.\n * Android: Values are expressed in logical pixels (dp) to match JS layout units.\n * iOS: Values are expressed in physical pixels and exclude status bar.\n */\nexport interface SafeAreaInsets {\n  /** Current device orientation (1 = portrait, 2 = landscape, 0 = unknown). */\n  orientation: number;\n  /**\n   * Orientation-aware notch/camera cutout inset (excluding status bar).\n   * In portrait mode: returns top inset (notch at top).\n   * In landscape mode: returns left inset (notch at side).\n   * Android: Value in dp, iOS: Value in pixels (status bar excluded).\n   */\n  top: number;\n}\n\n/**\n * Canonical device orientation values across platforms.\n */\nexport type DeviceOrientation = 'portrait' | 'landscape-left' | 'landscape-right' | 'portrait-upside-down' | 'unknown';\n\n/**\n * The main interface for the CameraPreview plugin.\n */\nexport interface CameraPreviewPlugin {\n  /**\n   * Starts the camera preview.\n   *\n   * @param {CameraPreviewOptions} options - The configuration for the camera preview.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the preview dimensions.\n   * @since 0.0.1\n   */\n  start(options: CameraPreviewOptions): Promise<{\n    /** The width of the preview in pixels. */\n    width: number;\n    /** The height of the preview in pixels. */\n    height: number;\n    /** The horizontal origin of the preview, in pixels. */\n    x: number;\n    /** The vertical origin of the preview, in pixels. */\n    y: number;\n  }>;\n\n  /**\n   * Stops the camera preview.\n   *\n   * @param {object} options - Optional configuration for stopping the camera.\n   * @param {boolean} options.force - If true, forces the camera to stop even if busy or capturing. Default: false.\n   * @returns {Promise<void>} A promise that resolves when the camera preview is stopped.\n   * @since 0.0.1\n   */\n  stop(options?: { force?: boolean }): Promise<void>;\n\n  /**\n   * Captures a picture from the camera.\n   *\n   * If `storeToFile` was set to `true` when starting the preview, the returned\n   * `value` will be an absolute file path on the device instead of a base64 string. Use getBase64FromFilePath to get the base64 string from the file path.\n   *\n   * @param {CameraPreviewPictureOptions} options - The options for capturing the picture.\n   * @returns {Promise<{ value: string; exif: ExifData }>} Resolves with:\n   *   - `value`: base64 string, or file path if `storeToFile` is true\n   *   - `exif`: extracted EXIF metadata when available\n   * @since 0.0.1\n   */\n  capture(options: CameraPreviewPictureOptions): Promise<{ value: string; exif: ExifData }>;\n\n  /**\n   * Captures a single frame from the camera preview stream.\n   *\n   * @param {CameraSampleOptions} options - The options for capturing the sample.\n   * @returns {Promise<{ value: string }>} A promise that resolves with the sample image as a base64 encoded string.\n   * @since 0.0.1\n   */\n  captureSample(options: CameraSampleOptions): Promise<{ value: string }>;\n\n  /**\n   * Starts barcode scanning on the active camera preview.\n   *\n   * The scanner reuses the current camera session and emits `barcodeScanned` events.\n   * Call `stopBarcodeScanner()` when scanning is no longer needed.\n   *\n   * Android uses the lightweight Google Play Services ML Kit model. If the model is not installed yet,\n   * first scans may return no result until Google Play Services finishes downloading it.\n   *\n   * @since 8.8.0\n   * @platform android, ios, web\n   */\n  startBarcodeScanner(options?: BarcodeScannerOptions): Promise<void>;\n\n  /**\n   * Stops barcode scanning while keeping the camera preview running.\n   *\n   * @since 8.8.0\n   * @platform android, ios, web\n   */\n  stopBarcodeScanner(): Promise<void>;\n\n  /**\n   * Gets the flash modes supported by the active camera.\n   *\n   * @returns {Promise<{ result: CameraPreviewFlashMode[] }>} A promise that resolves with an array of supported flash modes.\n   * @since 0.0.1\n   */\n  getSupportedFlashModes(): Promise<{\n    result: CameraPreviewFlashMode[];\n  }>;\n\n  /**\n   * Set the aspect ratio of the camera preview.\n   *\n   * @param {{ aspectRatio: CameraPreviewAspectRatio; x?: number; y?: number }} options - The desired aspect ratio and optional position.\n   *   - aspectRatio: The desired aspect ratio ('4:3', '16:9', or 'fill')\n   *   - x: Optional x coordinate for positioning. If not provided, view will be auto-centered horizontally.\n   *   - y: Optional y coordinate for positioning. If not provided, view will be auto-centered vertically.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setAspectRatio(options: { aspectRatio: CameraPreviewAspectRatio; x?: number; y?: number }): Promise<{\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n  }>;\n\n  /**\n   * Gets the current aspect ratio of the camera preview.\n   *\n   * @returns {Promise<{ aspectRatio: CameraPreviewAspectRatio }>} A promise that resolves with the current aspect ratio.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getAspectRatio(): Promise<{ aspectRatio: CameraPreviewAspectRatio }>;\n\n  /**\n   * Sets the grid mode of the camera preview overlay.\n   *\n   * @param {{ gridMode: GridMode }} options - The desired grid mode ('none', '3x3', or '4x4').\n   * @returns {Promise<void>} A promise that resolves when the grid mode is set.\n   * @since 8.0.0\n   */\n  setGridMode(options: { gridMode: GridMode }): Promise<void>;\n\n  /**\n   * Gets the current grid mode of the camera preview overlay.\n   *\n   * @returns {Promise<{ gridMode: GridMode }>} A promise that resolves with the current grid mode.\n   * @since 8.0.0\n   */\n  getGridMode(): Promise<{ gridMode: GridMode }>;\n\n  /**\n   * Checks the current camera (and optionally microphone) permission status without prompting the system dialog.\n   *\n   * @param options Set `disableAudio` to `false` to also include microphone status (defaults to `true`).\n   * @returns {Promise<CameraPermissionStatus>} A promise resolving to the current authorization states.\n   * @since 8.7.0\n   */\n  checkPermissions(options?: Pick<PermissionRequestOptions, 'disableAudio'>): Promise<CameraPermissionStatus>;\n\n  /**\n   * Requests camera (and optional microphone) permissions. If permissions are already granted or denied,\n   * the current status is returned without prompting. When `showSettingsAlert` is true and permissions are denied,\n   * a platform specific alert guiding the user to the app settings will be presented.\n   *\n   * @param {PermissionRequestOptions} options - Configuration for the permission request behaviour.\n   * @returns {Promise<CameraPermissionStatus>} A promise resolving to the final authorization states.\n   * @since 8.7.0\n   */\n  requestPermissions(options?: PermissionRequestOptions): Promise<CameraPermissionStatus>;\n\n  /**\n   * Gets the horizontal field of view (FoV) for the active camera.\n   * Note: This can be an estimate on some devices.\n   *\n   * @returns {Promise<{ result: number }>} A promise that resolves with the horizontal field of view in degrees.\n   * @since 0.0.1\n   */\n  getHorizontalFov(): Promise<{\n    result: number;\n  }>;\n\n  /**\n   * Gets the supported picture sizes for all cameras.\n   *\n   * @returns {Promise<{ supportedPictureSizes: SupportedPictureSizes[] }>} A promise that resolves with the list of supported sizes.\n   * @since 7.4.0\n   */\n  getSupportedPictureSizes(): Promise<{\n    supportedPictureSizes: SupportedPictureSizes[];\n  }>;\n\n  /**\n   * Sets the flash mode for the active camera.\n   *\n   * @param {{ flashMode: CameraPreviewFlashMode | string }} options - The desired flash mode.\n   * @returns {Promise<void>} A promise that resolves when the flash mode is set.\n   * @since 0.0.1\n   */\n  setFlashMode(options: { flashMode: CameraPreviewFlashMode | string }): Promise<void>;\n\n  /**\n   * Toggles between the front and rear cameras.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera is flipped.\n   * @since 0.0.1\n   */\n  flip(): Promise<void>;\n\n  /**\n   * Sets the opacity of the camera preview.\n   *\n   * @param {CameraOpacityOptions} options - The opacity options.\n   * @returns {Promise<void>} A promise that resolves when the opacity is set.\n   * @since 0.0.1\n   */\n  setOpacity(options: CameraOpacityOptions): Promise<void>;\n\n  /**\n   * Stops an ongoing video recording.\n   *\n   * @returns {Promise<RecordingFinishedEvent>} A promise that resolves with the path to the recorded video file.\n   * @since 0.0.1\n   */\n  stopRecordVideo(): Promise<RecordingFinishedEvent>;\n\n  /**\n   * Starts recording a video.\n   *\n   * Supports `frameRate`, `videoCodec`, `videoStabilizationMode`, `maxDuration`, `maxFileSize`, `disableAudio`, and `allowHapticsAndSystemSoundsDuringRecording` on each call.\n   *\n   * @param {CameraPreviewOptions} options - The options for video recording.\n   * @returns {Promise<void>} A promise that resolves when video recording starts.\n   * @since 0.0.1\n   */\n  startRecordVideo(options: CameraPreviewOptions): Promise<void>;\n\n  /**\n   * Sets the video recording quality for the active camera session.\n   *\n   * @param {{ quality: VideoQuality }} options - The desired video quality.\n   * @returns {Promise<void>} A promise that resolves when the quality is set.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  setVideoQuality(options: { quality: VideoQuality }): Promise<void>;\n\n  /**\n   * Gets the current video recording quality.\n   *\n   * @returns {Promise<{ quality: VideoQuality }>} A promise that resolves with the current quality.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  getVideoQuality(): Promise<{ quality: VideoQuality }>;\n\n  /**\n   * Returns the video qualities supported by the active camera.\n   *\n   * @returns {Promise<{ qualities: VideoQuality[] }>} A promise that resolves with supported qualities.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  getSupportedVideoQualities(): Promise<{ qualities: VideoQuality[] }>;\n\n  /**\n   * Sets the video codec used when recording.\n   *\n   * @param {{ codec: VideoCodec }} options - The desired codec.\n   * @returns {Promise<void>} A promise that resolves when the codec is set.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  setVideoCodec(options: { codec: VideoCodec }): Promise<void>;\n\n  /**\n   * Gets the current video codec used for recording.\n   *\n   * @returns {Promise<{ codec: VideoCodec }>} A promise that resolves with the current codec.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  getVideoCodec(): Promise<{ codec: VideoCodec }>;\n\n  /**\n   * Returns the video codecs supported by the active camera.\n   *\n   * @returns {Promise<{ codecs: VideoCodec[] }>} A promise that resolves with supported codecs.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  getSupportedVideoCodecs(): Promise<{ codecs: VideoCodec[] }>;\n\n  /**\n   * Checks whether video stabilization is supported by the active camera.\n   *\n   * @returns {Promise<{ supported: boolean }>} A promise that resolves with the support state.\n   * @since 8.5.2\n   * @platform android, ios\n   */\n  isVideoStabilizationSupported(): Promise<{ supported: boolean }>;\n\n  /**\n   * Returns the video stabilization modes supported by the active camera.\n   *\n   * @returns {Promise<{ modes: VideoStabilizationMode[] }>} A promise that resolves with supported modes.\n   * @since 8.5.2\n   * @platform android, ios\n   */\n  getSupportedVideoStabilizationModes(): Promise<{ modes: VideoStabilizationMode[] }>;\n\n  /**\n   * Gets the current video stabilization mode.\n   *\n   * @returns {Promise<{ mode: VideoStabilizationMode }>} A promise that resolves with the current mode.\n   * @since 8.5.2\n   * @platform android, ios\n   */\n  getVideoStabilizationMode(): Promise<{ mode: VideoStabilizationMode }>;\n\n  /**\n   * Sets the video stabilization mode for recording.\n   * Cannot be changed while a recording is in progress.\n   * You can also pass `videoStabilizationMode` in `startRecordVideo()` options.\n   *\n   * @param {{ mode: VideoStabilizationMode }} options - The desired stabilization mode.\n   * @returns {Promise<void>} A promise that resolves when the mode is set.\n   * @since 8.5.2\n   * @platform android, ios\n   */\n  setVideoStabilizationMode(options: { mode: VideoStabilizationMode }): Promise<void>;\n\n  /**\n   * Checks if the camera preview is currently running.\n   *\n   * @returns {Promise<{ isRunning: boolean }>} A promise that resolves with the running state.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  isRunning(): Promise<{ isRunning: boolean }>;\n\n  /**\n   * Gets all available camera devices.\n   *\n   * @returns {Promise<{ devices: CameraDevice[] }>} A promise that resolves with the list of available camera devices.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getAvailableDevices(): Promise<{ devices: CameraDevice[] }>;\n\n  /**\n   * Gets the current zoom state, including min/max and current lens info.\n   *\n   * @returns {Promise<{ min: number; max: number; current: number; lens: LensInfo }>} A promise that resolves with the zoom state.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getZoom(): Promise<{\n    min: number;\n    max: number;\n    current: number;\n    lens: LensInfo;\n  }>;\n\n  /**\n   * Returns zoom button values for quick switching.\n   * - iOS/Android: includes 0.5 if ultra-wide available; 1 and 2 if wide available; 3 if telephoto available\n   * - Web: unsupported\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getZoomButtonValues(): Promise<{ values: number[] }>;\n\n  /**\n   * Sets the zoom level of the camera.\n   *\n   * @param {{ level: number; ramp?: boolean; autoFocus?: boolean }} options - The desired zoom level. `ramp` is currently unused. `autoFocus` defaults to true.\n   * @returns {Promise<void>} A promise that resolves when the zoom level is set.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setZoom(options: { level: number; ramp?: boolean; autoFocus?: boolean }): Promise<void>;\n\n  /**\n   * Gets the current flash mode.\n   *\n   * @returns {Promise<{ flashMode: FlashMode }>} A promise that resolves with the current flash mode.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getFlashMode(): Promise<{ flashMode: FlashMode }>;\n\n  /**\n   * Removes all registered listeners.\n   *\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Switches the active camera to the one with the specified `deviceId`.\n   *\n   * @param {{ deviceId: string }} options - The ID of the device to switch to.\n   * @returns {Promise<void>} A promise that resolves when the camera is switched.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setDeviceId(options: { deviceId: string }): Promise<void>;\n\n  /**\n   * Gets the ID of the camera device that is currently bound.\n   * On Android, if a physical-lens request falls back to a logical camera, this returns the bound logical camera ID.\n   *\n   * @returns {Promise<{ deviceId: string }>} A promise that resolves with the current device ID.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getDeviceId(): Promise<{ deviceId: string }>;\n\n  /**\n   * Gets the current preview size and position.\n   * @returns {Promise<{x: number, y: number, width: number, height: number}>}\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getPreviewSize(): Promise<{\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n  }>;\n  /**\n   * Sets the preview size and position.\n   * @param options The new position and dimensions.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setPreviewSize(options: { x?: number; y?: number; width: number; height: number }): Promise<{\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n  }>;\n\n  /**\n   * Sets the camera focus to a specific point in the preview.\n   *\n   * Note: The plugin does not attach any native tap-to-focus gesture handlers. Handle taps in\n   * your HTML/JS (e.g., on the overlaying UI), then pass normalized coordinates here.\n   *\n   * @param {Object} options - The focus options.\n   * @param {number} options.x - The x coordinate in the preview view to focus on (0-1 normalized).\n   * @param {number} options.y - The y coordinate in the preview view to focus on (0-1 normalized).\n   * @returns {Promise<void>} A promise that resolves when the focus is set.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setFocus(options: { x: number; y: number }): Promise<void>;\n\n  /**\n   * Adds a listener for screen resize events.\n   * @param {string} eventName - The event name to listen for.\n   * @param {Function} listenerFunc - The function to call when the event is triggered.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves with a handle to the listener.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  addListener(\n    eventName: 'screenResize',\n    listenerFunc: (data: { width: number; height: number; x: number; y: number }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener for orientation change events.\n   * @param {string} eventName - The event name to listen for.\n   * @param {Function} listenerFunc - The function to call when the event is triggered.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves with a handle to the listener.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  addListener(\n    eventName: 'orientationChange',\n    listenerFunc: (data: { orientation: DeviceOrientation }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener for barcode scan results.\n   *\n   * @since 8.8.0\n   * @platform android, ios, web\n   */\n  addListener(\n    eventName: 'barcodeScanned',\n    listenerFunc: (data: BarcodeScannedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener for non-fatal barcode scanner errors.\n   *\n   * @since 8.8.0\n   * @platform android, web\n   */\n  addListener(\n    eventName: 'barcodeScanError',\n    listenerFunc: (data: BarcodeScanErrorEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener fired when a video recording finishes natively, including automatic stops.\n   *\n   * @since 8.4.7\n   * @platform android, ios\n   */\n  addListener(\n    eventName: 'recordingFinished',\n    listenerFunc: (data: RecordingFinishedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Deletes a file at the given absolute path on the device.\n   * Use this to quickly clean up temporary images created with `storeToFile`.\n   * On web, this is not supported and will throw.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  deleteFile(options: { path: string }): Promise<{ success: boolean }>;\n\n  /**\n   * Gets the safe area insets for devices.\n   * Returns the orientation-aware notch/camera cutout inset and the current orientation.\n   * In portrait mode: returns top inset (notch at top).\n   * In landscape mode: returns left inset (notch moved to side).\n   * This specifically targets the cutout area (notch, punch hole, etc.) that all modern phones have.\n   *\n   * Android: Values returned in dp (logical pixels).\n   * iOS: Values returned in physical pixels, excluding status bar (only pure notch/cutout size).\n   *\n   * @platform android, ios\n   */\n  getSafeAreaInsets(): Promise<SafeAreaInsets>;\n\n  /**\n   * Gets the current device orientation in a cross-platform format.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getOrientation(): Promise<{ orientation: DeviceOrientation }>;\n\n  /**\n   * Returns the exposure modes supported by the active camera.\n   * Modes can include: 'locked', 'auto', 'continuous', 'custom'.\n   * @platform android, ios\n   */\n  getExposureModes(): Promise<{ modes: ExposureMode[] }>;\n\n  /**\n   * Returns the current exposure mode.\n   * @platform android, ios\n   */\n  getExposureMode(): Promise<{ mode: ExposureMode }>;\n\n  /**\n   * Sets the exposure mode.\n   * @platform android, ios\n   */\n  setExposureMode(options: { mode: ExposureMode }): Promise<void>;\n\n  /**\n   * Returns the exposure compensation (EV bias) supported range.\n   * @platform ios, android\n   */\n  getExposureCompensationRange(): Promise<{\n    min: number;\n    max: number;\n    step: number;\n  }>;\n\n  /**\n   * Returns the current exposure compensation (EV bias).\n   * @platform ios, android\n   */\n  getExposureCompensation(): Promise<{ value: number }>;\n\n  /**\n   * Sets the exposure compensation (EV bias). Value will be clamped to range.\n   * @platform ios, android\n   */\n  setExposureCompensation(options: { value: number }): Promise<void>;\n\n  /**\n   * Returns the white-balance modes supported by the active camera.\n   * Modes can include: 'AUTO', 'LOCK', 'CONTINUOUS'. `CUSTOM` is not listed\n   * until manual gains support is implemented.\n   * @platform android, ios\n   */\n  getWhiteBalanceModes(): Promise<{ modes: WhiteBalanceMode[] }>;\n\n  /**\n   * Returns the current white-balance mode.\n   * @platform android, ios\n   */\n  getWhiteBalanceMode(): Promise<{ mode: WhiteBalanceMode }>;\n\n  /**\n   * Sets the white-balance mode. `CONTINUOUS` keeps auto white balance running\n   * (recommended; avoids a warm/yellow cast), `LOCK` freezes the current gains,\n   * `AUTO` performs a one-time adjustment. `CUSTOM` is reserved and rejected\n   * until manual gains support is implemented.\n   * @platform android, ios\n   */\n  setWhiteBalanceMode(options: { mode: WhiteBalanceMode }): Promise<void>;\n\n  /**\n   * Lists the video frame rates supported by the active camera for the current format.\n   * Supported values depend on the selected camera, lens, and video quality.\n   *\n   * @platform android, ios\n   * @since 8.6.0\n   */\n  getSupportedVideoFrameRates(): Promise<{\n    frameRates: number[];\n  }>;\n\n  /**\n   * Returns the configured video frame rate for the active camera.\n   * On Android the actual recording frame rate can still vary in low light or under thermal pressure.\n   *\n   * @platform android, ios\n   * @since 8.6.0\n   */\n  getVideoFrameRate(): Promise<{\n    frameRate: number;\n  }>;\n\n  /**\n   * Sets the target video frame rate for the active camera session.\n   * Prefer passing `frameRate` to `startRecordVideo()` when starting a recording.\n   * Rejects unsupported values with a clear error.\n   *\n   * @platform android, ios\n   * @since 8.6.0\n   */\n  setVideoFrameRate(options: { frameRate: number }): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA8EA,MAAM,CAAN,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,sCAAwB,CAAA;IACxB,sCAAwB,CAAA;IACxB,qCAAuB,CAAA;IACvB,sCAAwB,CAAA;IACxB,2BAAa,CAAA;IACb,oCAAsB,CAAA;IACtB,+BAAiB,CAAA;AACnB,CAAC,EARW,UAAU,KAAV,UAAU,QAQrB","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\nexport type CameraPosition = 'rear' | 'front';\n\nexport type FlashMode = CameraPreviewFlashMode;\n\nexport type GridMode = 'none' | '3x3' | '4x4';\n\nexport type CameraPositioning = 'center' | 'top' | 'bottom';\n\nexport type CameraPreviewAspectRatio = '4:3' | '16:9' | 'fill';\n\nexport type BarcodeScannerFormat =\n  | 'aztec'\n  | 'codabar'\n  | 'code_39'\n  | 'code_93'\n  | 'code_128'\n  | 'data_matrix'\n  | 'ean_8'\n  | 'ean_13'\n  | 'itf'\n  | 'pdf417'\n  | 'qr_code'\n  | 'upc_a'\n  | 'upc_e';\n\nexport type BarcodeFormat = BarcodeScannerFormat | 'unknown';\n\nexport interface BarcodeScannerOptions {\n  /**\n   * Restricts detection to the given formats. Leaving this empty scans all supported formats.\n   * Restricting formats can improve scanning speed.\n   */\n  formats?: BarcodeScannerFormat[];\n  /**\n   * Minimum delay between native scan attempts in milliseconds.\n   * Lower values scan more often but use more CPU.\n   * @default 500\n   */\n  detectionInterval?: number;\n}\n\nexport interface BarcodeScanResult {\n  /** Decoded barcode value. */\n  value: string;\n  /** Barcode format. */\n  format: BarcodeFormat;\n  /** Human-readable value when the platform exposes one. */\n  displayValue?: string;\n  /** Base64-encoded raw bytes when the platform exposes them. */\n  rawBytes?: string;\n}\n\nexport interface BarcodeScannedEvent {\n  /** Barcodes decoded from the current frame. */\n  barcodes: BarcodeScanResult[];\n}\n\nexport interface BarcodeScanErrorEvent {\n  /** Native scanner error message. */\n  message: string;\n}\n\nexport interface CameraPermissionStatus {\n  camera: PermissionState;\n  microphone?: PermissionState;\n}\n\nexport interface PermissionRequestOptions {\n  disableAudio?: boolean;\n  showSettingsAlert?: boolean;\n  title?: string;\n  message?: string;\n  openSettingsButtonTitle?: string;\n  cancelButtonTitle?: string;\n}\n\nexport enum DeviceType {\n  ULTRA_WIDE = 'ultraWide',\n  WIDE_ANGLE = 'wideAngle',\n  TELEPHOTO = 'telephoto',\n  TRUE_DEPTH = 'trueDepth',\n  DUAL = 'dual',\n  DUAL_WIDE = 'dualWide',\n  TRIPLE = 'triple',\n}\n\n/**\n * Represents a single camera lens on a device. A {@link CameraDevice} can have multiple lenses.\n */\nexport interface CameraLens {\n  /** A human-readable name for the lens, e.g., \"Ultra-Wide\". */\n  label: string;\n  /** The type of the camera lens. */\n  deviceType: DeviceType;\n  /** The focal length of the lens in millimeters. */\n  focalLength: number;\n  /** The base zoom factor for this lens (e.g., 0.5 for ultra-wide, 1.0 for wide). */\n  baseZoomRatio: number;\n  /** The minimum zoom factor supported by this specific lens. */\n  minZoom: number;\n  /** The maximum zoom factor supported by this specific lens. */\n  maxZoom: number;\n}\n\n/**\n * Represents a physical camera on the device (e.g., the front-facing camera).\n */\nexport interface CameraDevice {\n  /** A unique identifier for the camera device. */\n  deviceId: string;\n  /** A human-readable name for the camera device. */\n  label: string;\n  /** The physical position of the camera on the device. */\n  position: CameraPosition;\n  /** A list of all available lenses for this camera device. */\n  lenses: CameraLens[];\n  /** The overall minimum zoom factor available across all lenses on this device. */\n  minZoom: number;\n  /** The overall maximum zoom factor available across all lenses on this device. */\n  maxZoom: number;\n  /** Identifies whether the device is a logical camera (composed of multiple physical lenses). */\n  isLogical: boolean;\n}\n\n/**\n * Represents the detailed information of the currently active lens.\n */\nexport interface LensInfo {\n  /** The focal length of the active lens in millimeters. */\n  focalLength: number;\n  /** The device type of the active lens. */\n  deviceType: DeviceType;\n  /** The base zoom ratio of the active lens (e.g., 0.5x, 1.0x). */\n  baseZoomRatio: number;\n  /** The current digital zoom factor applied on top of the base zoom. */\n  digitalZoom: number;\n}\n\nexport type VideoQuality = 'low' | 'medium' | 'high' | '2160p' | '1080p' | '720p' | '480p' | '4:3';\n\n/**\n * Video codec identifiers used when recording.\n * - `avc1`: H.264\n * - `hvc1`: HEVC / H.265\n */\nexport type VideoCodec = 'avc1' | 'hvc1' | 'jpeg' | 'apcn' | 'ap4h';\n\n/**\n * Video stabilization modes used when recording.\n *\n * On Android only `off` and `standard` are supported.\n * On iOS all listed modes may be available when the device supports video stabilization.\n */\nexport type VideoStabilizationMode =\n  | 'off'\n  | 'standard'\n  | 'cinematic'\n  | 'cinematicExtended'\n  | 'previewOptimized'\n  | 'cinematicExtendedEnhanced'\n  | 'auto'\n  | 'lowLatency';\n\nexport type RecordingFinishedReason = 'manual' | 'maxDuration' | 'maxFileSize';\n\nexport interface RecordingFinishedEvent {\n  /**\n   * The path to the recorded video file.\n   */\n  videoFilePath: string;\n  /**\n   * Why the recording stopped.\n   */\n  reason: RecordingFinishedReason;\n}\n\n/**\n * Defines the configuration options for starting the camera preview.\n */\nexport interface CameraPreviewOptions {\n  /**\n   * The parent element to attach the video preview to.\n   * @platform web\n   */\n  parent?: string;\n  /**\n   * A CSS class name to add to the preview element.\n   * @platform web\n   */\n  className?: string;\n  /**\n   * The width of the preview in pixels. Defaults to the screen width.\n   * @platform android, ios, web\n   */\n  width?: number;\n  /**\n   * The height of the preview in pixels. Defaults to the screen height.\n   * @platform android, ios, web\n   */\n  height?: number;\n  /**\n   * The horizontal origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  x?: number;\n  /**\n   * The vertical origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  y?: number;\n  /**\n   * The aspect ratio of the camera preview, '4:3' or '16:9' or 'fill'.\n   * Cannot be set if width or height is provided, otherwise the call will be rejected.\n   * Use setPreviewSize to adjust size after starting.\n   *\n   * @since 2.0.0\n   */\n  aspectRatio?: CameraPreviewAspectRatio;\n  /**\n   * Controls how the camera preview fills the available space.\n   * - 'contain': Fits the entire preview within the space, may show letterboxing (default).\n   * - 'cover': Fills the entire space, may crop edges of the preview.\n   * @default \"contain\"\n   * @platform android, ios, web\n   */\n  aspectMode?: 'cover' | 'contain';\n  /**\n   * The grid overlay to display on the camera preview.\n   * @default \"none\"\n   * @since 2.1.0\n   */\n  gridMode?: GridMode;\n  /**\n   * Adjusts the y-position to account for safe areas (e.g., notches).\n   * @platform android, ios\n   * @default false\n   */\n  includeSafeAreaInsets?: boolean;\n  /**\n   * If true, places the preview behind the webview.\n   * @platform android\n   * @default true\n   */\n  toBack?: boolean;\n  /**\n   * Bottom padding for the preview, in pixels.\n   * @platform android, ios\n   */\n  paddingBottom?: number;\n  /**\n   * Whether to rotate the preview when the device orientation changes.\n   * @platform ios\n   * @default true\n   */\n  rotateWhenOrientationChanged?: boolean;\n  /**\n   * The camera to use.\n   * @default \"rear\"\n   */\n  position?: CameraPosition | string;\n  /**\n   * If true, saves the captured image to a file and returns the file path.\n   * If false, returns a base64 encoded string.\n   * @default false\n   */\n  storeToFile?: boolean;\n  /**\n   * If true, prevents the plugin from rotating the image based on EXIF data.\n   * @platform android\n   * @default false\n   */\n  disableExifHeaderStripping?: boolean;\n  /**\n   * If true, disables the audio stream, preventing audio permission requests.\n   * @default true\n   */\n  disableAudio?: boolean;\n  /**\n   * If true, locks the device orientation while the camera is active.\n   * @platform android\n   * @default false\n   */\n  lockAndroidOrientation?: boolean;\n  /**\n   * If true, allows the camera preview's opacity to be changed.\n   * @platform android, web\n   * @default false\n   */\n  enableOpacity?: boolean;\n\n  /**\n   * If true, disables the visual focus indicator when tapping to focus.\n   * @platform android, ios\n   * @default false\n   */\n  disableFocusIndicator?: boolean;\n  /**\n   * The `deviceId` of the camera to use. If provided, `position` is ignored.\n   * @platform ios\n   */\n  deviceId?: string;\n  /**\n   * On Android, attempts to bind a physical camera directly when `deviceId` refers to a physical lens.\n   * Disabled by default because OEM support is inconsistent; when false, Android keeps the current logical-camera fallback behavior.\n   * @default false\n   * @platform android\n   */\n  enablePhysicalDeviceSelection?: boolean;\n  /**\n   * The initial zoom level when starting the camera preview.\n   * If the requested zoom level is not available, the native plugin will reject.\n   * @default 1.0\n   * @platform android, ios\n   * @since 2.2.0\n   */\n  initialZoomLevel?: number;\n  /**\n   * The vertical positioning of the camera preview.\n   * @default \"center\"\n   * @platform android, ios, web\n   * @since 2.3.0\n   */\n  positioning?: CameraPositioning;\n  /**\n   * If true, enables video capture capabilities when the camera starts.\n   * @default false\n   * @platform android, ios\n   * @since 7.11.0\n   */\n  enableVideoMode?: boolean;\n  /**\n   * If true, forces the camera to start/restart even if it's already running or busy.\n   * This will kill the current camera session and start a new one, ignoring all state checks.\n   * @default false\n   * @platform android, ios, web\n   */\n  force?: boolean;\n  /**\n   * Sets the quality of video for recording.\n   * Options: 'low', 'medium', 'high', '2160p', '1080p', '720p', '480p', '4:3'\n   * @note On Android requires 'enableVideoMode' to be true\n   * @note Will affect the entire preview stream for iOS\n   * @platform ios, android\n   * @default \"high\"\n   */\n  videoQuality?: VideoQuality;\n  /**\n   * Maximum recording duration in seconds. Recording stops automatically when reached.\n   * @platform ios, android\n   */\n  maxDuration?: number;\n  /**\n   * Maximum recording file size in bytes. Recording stops automatically when reached.\n   * @platform ios, android\n   */\n  maxFileSize?: number;\n  /**\n   * Preferred video codec for recording.\n   * @platform ios, android\n   * @default \"avc1\"\n   */\n  videoCodec?: VideoCodec;\n  /**\n   * Target video frame rate in frames per second.\n   * Applied when recording starts. Use `getSupportedVideoFrameRates()` to list supported values.\n   * @platform ios, android\n   * @since 8.6.0\n   */\n  frameRate?: number;\n  /**\n   * Preferred video stabilization mode for recording.\n   * @platform ios, android\n   * @default \"off\"\n   */\n  videoStabilizationMode?: VideoStabilizationMode;\n  /**\n   * When `true`, allows haptic feedback and system sounds while recording video with audio.\n   * iOS suppresses haptics during audio input recording unless this is enabled.\n   * Requires `disableAudio: false`.\n   * @platform ios\n   * @default false\n   * @since 8.8.0\n   */\n  allowHapticsAndSystemSoundsDuringRecording?: boolean;\n  /**\n   * Starts barcode scanning together with the camera preview.\n   * Set to `true` or pass options to scan all supported formats.\n   * Omit this option to keep barcode scanning disabled at startup.\n   * @platform android, ios, web\n   * @since 8.8.0\n   */\n  barcodeScanner?: boolean | BarcodeScannerOptions;\n}\n\n/**\n * Defines the options for capturing a picture.\n */\nexport interface CameraPreviewPictureOptions {\n  /**\n   * The maximum height of the picture in pixels. The image will be resized to fit within this height while maintaining aspect ratio.\n   * If not specified the captured image will match the preview's visible area.\n   */\n  height?: number;\n  /**\n   * The maximum width of the picture in pixels. The image will be resized to fit within this width while maintaining aspect ratio.\n   * If not specified the captured image will match the preview's visible area.\n   */\n  width?: number;\n  /**\n   * The quality of the captured image, from 0 to 100.\n   * Does not apply to `png` format.\n   * @default 85\n   */\n  quality?: number;\n  /**\n   * The format of the captured image.\n   * @default \"jpeg\"\n   */\n  format?: PictureFormat;\n  /**\n   * If true, the captured image will be saved to the user's gallery.\n   * @default false\n   * @since 7.5.0\n   */\n  saveToGallery?: boolean;\n  /**\n   * If true, the plugin will attempt to add GPS location data to the image's EXIF metadata.\n   * This may prompt the user for location permissions.\n   * @default false\n   * @since 7.6.0\n   */\n  withExifLocation?: boolean;\n  /**\n   * If true, the plugin will embed a timestamp in the top-right corner of the image.\n   * @default false\n   * @since 7.17.0\n   */\n  embedTimestamp?: boolean;\n  /**\n   * If true, the plugin will embed the current location in the top-right corner of the image.\n   * Requires `withExifLocation` to be enabled.\n   * @default false\n   * @since 7.18.0\n   */\n  embedLocation?: boolean;\n  /**\n   * Sets the priority for photo quality vs. capture speed.\n   * - \"speed\": Prioritizes faster capture times, may reduce image quality.\n   * - \"balanced\": Aims for a balance between quality and speed.\n   * - \"quality\": Prioritizes image quality, may reduce capture speed.\n   * See https://developer.apple.com/documentation/avfoundation/avcapturephotosettings/photoqualityprioritization for details.\n   *\n   * @since 7.21.0\n   * @platform ios\n   * @default \"speed\"\n   */\n  photoQualityPrioritization?: 'speed' | 'balanced' | 'quality';\n  /**\n   * If true and the front camera is active, horizontally mirror the captured photo\n   * so it matches a selfie-style preview. Rear camera captures are never mirrored.\n   * Defaults to false to preserve the previous non-mirrored behavior.\n   * @default false\n   * @since 8.10.0\n   */\n  mirrorFrontCamera?: boolean;\n}\n\n/** Represents EXIF data extracted from an image. */\nexport interface ExifData {\n  [key: string]: any;\n}\n\nexport type PictureFormat = 'jpeg' | 'png';\n\n/** Defines a standard picture size with width and height. */\nexport interface PictureSize {\n  /** The width of the picture in pixels. */\n  width: number;\n  /** The height of the picture in pixels. */\n  height: number;\n}\n\n/** Represents the supported picture sizes for a camera facing a certain direction. */\nexport interface SupportedPictureSizes {\n  /** The camera direction (\"front\" or \"rear\"). */\n  facing: string;\n  /** A list of supported picture sizes for this camera. */\n  supportedPictureSizes: PictureSize[];\n}\n\n/**\n * Defines the options for capturing a sample frame from the camera preview.\n */\nexport interface CameraSampleOptions {\n  /**\n   * The quality of the captured sample, from 0 to 100.\n   * @default 85\n   */\n  quality?: number;\n  /**\n   * If true and the front camera is active, horizontally mirror the captured sample\n   * so it matches a selfie-style preview. Rear camera samples are never mirrored.\n   * Defaults to false to preserve the previous non-mirrored behavior.\n   * @default false\n   * @since 8.10.0\n   */\n  mirrorFrontCamera?: boolean;\n}\n\n/**\n * The available flash modes for the camera.\n * 'torch' is a continuous light mode.\n */\nexport type CameraPreviewFlashMode = 'off' | 'on' | 'auto' | 'torch';\n\n/** Reusable exposure mode type for cross-platform support. */\nexport type ExposureMode = 'AUTO' | 'LOCK' | 'CONTINUOUS' | 'CUSTOM';\n\n/**\n * Reusable white-balance mode type for cross-platform support.\n * `CUSTOM` is reserved for a future manual white-balance gains API and is not\n * returned by `getWhiteBalanceModes()` until implemented.\n */\nexport type WhiteBalanceMode = 'AUTO' | 'LOCK' | 'CONTINUOUS' | 'CUSTOM';\n\n/**\n * Defines the options for setting the camera preview's opacity.\n */\nexport interface CameraOpacityOptions {\n  /**\n   * The opacity percentage, from 0.0 (fully transparent) to 1.0 (fully opaque).\n   * @default 1.0\n   */\n  opacity?: number;\n}\n\n/**\n * Represents safe area insets for devices.\n * Android: Values are expressed in logical pixels (dp) to match JS layout units.\n * iOS: Values are expressed in physical pixels and exclude status bar.\n */\nexport interface SafeAreaInsets {\n  /** Current device orientation (1 = portrait, 2 = landscape, 0 = unknown). */\n  orientation: number;\n  /**\n   * Orientation-aware notch/camera cutout inset (excluding status bar).\n   * In portrait mode: returns top inset (notch at top).\n   * In landscape mode: returns left inset (notch at side).\n   * Android: Value in dp, iOS: Value in pixels (status bar excluded).\n   */\n  top: number;\n}\n\n/**\n * Canonical device orientation values across platforms.\n */\nexport type DeviceOrientation = 'portrait' | 'landscape-left' | 'landscape-right' | 'portrait-upside-down' | 'unknown';\n\n/**\n * The main interface for the CameraPreview plugin.\n */\nexport interface CameraPreviewPlugin {\n  /**\n   * Starts the camera preview.\n   *\n   * @param {CameraPreviewOptions} options - The configuration for the camera preview.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the preview dimensions.\n   * @since 0.0.1\n   */\n  start(options: CameraPreviewOptions): Promise<{\n    /** The width of the preview in pixels. */\n    width: number;\n    /** The height of the preview in pixels. */\n    height: number;\n    /** The horizontal origin of the preview, in pixels. */\n    x: number;\n    /** The vertical origin of the preview, in pixels. */\n    y: number;\n  }>;\n\n  /**\n   * Stops the camera preview.\n   *\n   * @param {object} options - Optional configuration for stopping the camera.\n   * @param {boolean} options.force - If true, forces the camera to stop even if busy or capturing. Default: false.\n   * @returns {Promise<void>} A promise that resolves when the camera preview is stopped.\n   * @since 0.0.1\n   */\n  stop(options?: { force?: boolean }): Promise<void>;\n\n  /**\n   * Captures a picture from the camera.\n   *\n   * If `storeToFile` was set to `true` when starting the preview, the returned\n   * `value` will be an absolute file path on the device instead of a base64 string. Use getBase64FromFilePath to get the base64 string from the file path.\n   *\n   * @param {CameraPreviewPictureOptions} options - The options for capturing the picture.\n   * @returns {Promise<{ value: string; exif: ExifData }>} Resolves with:\n   *   - `value`: base64 string, or file path if `storeToFile` is true\n   *   - `exif`: extracted EXIF metadata when available\n   * @since 0.0.1\n   */\n  capture(options: CameraPreviewPictureOptions): Promise<{ value: string; exif: ExifData }>;\n\n  /**\n   * Captures a single frame from the camera preview stream.\n   *\n   * @param {CameraSampleOptions} options - The options for capturing the sample.\n   * @returns {Promise<{ value: string }>} A promise that resolves with the sample image as a base64 encoded string.\n   * @since 0.0.1\n   */\n  captureSample(options: CameraSampleOptions): Promise<{ value: string }>;\n\n  /**\n   * Starts barcode scanning on the active camera preview.\n   *\n   * The scanner reuses the current camera session and emits `barcodeScanned` events.\n   * Call `stopBarcodeScanner()` when scanning is no longer needed.\n   *\n   * Android uses the lightweight Google Play Services ML Kit model. If the model is not installed yet,\n   * first scans may return no result until Google Play Services finishes downloading it.\n   *\n   * @since 8.8.0\n   * @platform android, ios, web\n   */\n  startBarcodeScanner(options?: BarcodeScannerOptions): Promise<void>;\n\n  /**\n   * Stops barcode scanning while keeping the camera preview running.\n   *\n   * @since 8.8.0\n   * @platform android, ios, web\n   */\n  stopBarcodeScanner(): Promise<void>;\n\n  /**\n   * Gets the flash modes supported by the active camera.\n   *\n   * @returns {Promise<{ result: CameraPreviewFlashMode[] }>} A promise that resolves with an array of supported flash modes.\n   * @since 0.0.1\n   */\n  getSupportedFlashModes(): Promise<{\n    result: CameraPreviewFlashMode[];\n  }>;\n\n  /**\n   * Set the aspect ratio of the camera preview.\n   *\n   * @param {{ aspectRatio: CameraPreviewAspectRatio; x?: number; y?: number }} options - The desired aspect ratio and optional position.\n   *   - aspectRatio: The desired aspect ratio ('4:3', '16:9', or 'fill')\n   *   - x: Optional x coordinate for positioning. If not provided, view will be auto-centered horizontally.\n   *   - y: Optional y coordinate for positioning. If not provided, view will be auto-centered vertically.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setAspectRatio(options: { aspectRatio: CameraPreviewAspectRatio; x?: number; y?: number }): Promise<{\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n  }>;\n\n  /**\n   * Gets the current aspect ratio of the camera preview.\n   *\n   * @returns {Promise<{ aspectRatio: CameraPreviewAspectRatio }>} A promise that resolves with the current aspect ratio.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getAspectRatio(): Promise<{ aspectRatio: CameraPreviewAspectRatio }>;\n\n  /**\n   * Sets the grid mode of the camera preview overlay.\n   *\n   * @param {{ gridMode: GridMode }} options - The desired grid mode ('none', '3x3', or '4x4').\n   * @returns {Promise<void>} A promise that resolves when the grid mode is set.\n   * @since 8.0.0\n   */\n  setGridMode(options: { gridMode: GridMode }): Promise<void>;\n\n  /**\n   * Gets the current grid mode of the camera preview overlay.\n   *\n   * @returns {Promise<{ gridMode: GridMode }>} A promise that resolves with the current grid mode.\n   * @since 8.0.0\n   */\n  getGridMode(): Promise<{ gridMode: GridMode }>;\n\n  /**\n   * Checks the current camera (and optionally microphone) permission status without prompting the system dialog.\n   *\n   * @param options Set `disableAudio` to `false` to also include microphone status (defaults to `true`).\n   * @returns {Promise<CameraPermissionStatus>} A promise resolving to the current authorization states.\n   * @since 8.7.0\n   */\n  checkPermissions(options?: Pick<PermissionRequestOptions, 'disableAudio'>): Promise<CameraPermissionStatus>;\n\n  /**\n   * Requests camera (and optional microphone) permissions. If permissions are already granted or denied,\n   * the current status is returned without prompting. When `showSettingsAlert` is true and permissions are denied,\n   * a platform specific alert guiding the user to the app settings will be presented.\n   *\n   * @param {PermissionRequestOptions} options - Configuration for the permission request behaviour.\n   * @returns {Promise<CameraPermissionStatus>} A promise resolving to the final authorization states.\n   * @since 8.7.0\n   */\n  requestPermissions(options?: PermissionRequestOptions): Promise<CameraPermissionStatus>;\n\n  /**\n   * Gets the horizontal field of view (FoV) for the active camera.\n   * Note: This can be an estimate on some devices.\n   *\n   * @returns {Promise<{ result: number }>} A promise that resolves with the horizontal field of view in degrees.\n   * @since 0.0.1\n   */\n  getHorizontalFov(): Promise<{\n    result: number;\n  }>;\n\n  /**\n   * Gets the supported picture sizes for all cameras.\n   *\n   * @returns {Promise<{ supportedPictureSizes: SupportedPictureSizes[] }>} A promise that resolves with the list of supported sizes.\n   * @since 7.4.0\n   */\n  getSupportedPictureSizes(): Promise<{\n    supportedPictureSizes: SupportedPictureSizes[];\n  }>;\n\n  /**\n   * Sets the flash mode for the active camera.\n   *\n   * @param {{ flashMode: CameraPreviewFlashMode | string }} options - The desired flash mode.\n   * @returns {Promise<void>} A promise that resolves when the flash mode is set.\n   * @since 0.0.1\n   */\n  setFlashMode(options: { flashMode: CameraPreviewFlashMode | string }): Promise<void>;\n\n  /**\n   * Toggles between the front and rear cameras.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera is flipped.\n   * @since 0.0.1\n   */\n  flip(): Promise<void>;\n\n  /**\n   * Sets the opacity of the camera preview.\n   *\n   * @param {CameraOpacityOptions} options - The opacity options.\n   * @returns {Promise<void>} A promise that resolves when the opacity is set.\n   * @since 0.0.1\n   */\n  setOpacity(options: CameraOpacityOptions): Promise<void>;\n\n  /**\n   * Stops an ongoing video recording.\n   *\n   * @returns {Promise<RecordingFinishedEvent>} A promise that resolves with the path to the recorded video file.\n   * @since 0.0.1\n   */\n  stopRecordVideo(): Promise<RecordingFinishedEvent>;\n\n  /**\n   * Starts recording a video.\n   *\n   * Supports `frameRate`, `videoCodec`, `videoStabilizationMode`, `maxDuration`, `maxFileSize`, `disableAudio`, and `allowHapticsAndSystemSoundsDuringRecording` on each call.\n   *\n   * @param {CameraPreviewOptions} options - The options for video recording.\n   * @returns {Promise<void>} A promise that resolves when video recording starts.\n   * @since 0.0.1\n   */\n  startRecordVideo(options: CameraPreviewOptions): Promise<void>;\n\n  /**\n   * Sets the video recording quality for the active camera session.\n   *\n   * @param {{ quality: VideoQuality }} options - The desired video quality.\n   * @returns {Promise<void>} A promise that resolves when the quality is set.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  setVideoQuality(options: { quality: VideoQuality }): Promise<void>;\n\n  /**\n   * Gets the current video recording quality.\n   *\n   * @returns {Promise<{ quality: VideoQuality }>} A promise that resolves with the current quality.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  getVideoQuality(): Promise<{ quality: VideoQuality }>;\n\n  /**\n   * Returns the video qualities supported by the active camera.\n   *\n   * @returns {Promise<{ qualities: VideoQuality[] }>} A promise that resolves with supported qualities.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  getSupportedVideoQualities(): Promise<{ qualities: VideoQuality[] }>;\n\n  /**\n   * Sets the video codec used when recording.\n   *\n   * @param {{ codec: VideoCodec }} options - The desired codec.\n   * @returns {Promise<void>} A promise that resolves when the codec is set.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  setVideoCodec(options: { codec: VideoCodec }): Promise<void>;\n\n  /**\n   * Gets the current video codec used for recording.\n   *\n   * @returns {Promise<{ codec: VideoCodec }>} A promise that resolves with the current codec.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  getVideoCodec(): Promise<{ codec: VideoCodec }>;\n\n  /**\n   * Returns the video codecs supported by the active camera.\n   *\n   * @returns {Promise<{ codecs: VideoCodec[] }>} A promise that resolves with supported codecs.\n   * @since 8.5.0\n   * @platform android, ios\n   */\n  getSupportedVideoCodecs(): Promise<{ codecs: VideoCodec[] }>;\n\n  /**\n   * Checks whether video stabilization is supported by the active camera.\n   *\n   * @returns {Promise<{ supported: boolean }>} A promise that resolves with the support state.\n   * @since 8.5.2\n   * @platform android, ios\n   */\n  isVideoStabilizationSupported(): Promise<{ supported: boolean }>;\n\n  /**\n   * Returns the video stabilization modes supported by the active camera.\n   *\n   * @returns {Promise<{ modes: VideoStabilizationMode[] }>} A promise that resolves with supported modes.\n   * @since 8.5.2\n   * @platform android, ios\n   */\n  getSupportedVideoStabilizationModes(): Promise<{ modes: VideoStabilizationMode[] }>;\n\n  /**\n   * Gets the current video stabilization mode.\n   *\n   * @returns {Promise<{ mode: VideoStabilizationMode }>} A promise that resolves with the current mode.\n   * @since 8.5.2\n   * @platform android, ios\n   */\n  getVideoStabilizationMode(): Promise<{ mode: VideoStabilizationMode }>;\n\n  /**\n   * Sets the video stabilization mode for recording.\n   * Cannot be changed while a recording is in progress.\n   * You can also pass `videoStabilizationMode` in `startRecordVideo()` options.\n   *\n   * @param {{ mode: VideoStabilizationMode }} options - The desired stabilization mode.\n   * @returns {Promise<void>} A promise that resolves when the mode is set.\n   * @since 8.5.2\n   * @platform android, ios\n   */\n  setVideoStabilizationMode(options: { mode: VideoStabilizationMode }): Promise<void>;\n\n  /**\n   * Checks if the camera preview is currently running.\n   *\n   * @returns {Promise<{ isRunning: boolean }>} A promise that resolves with the running state.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  isRunning(): Promise<{ isRunning: boolean }>;\n\n  /**\n   * Gets all available camera devices.\n   *\n   * @returns {Promise<{ devices: CameraDevice[] }>} A promise that resolves with the list of available camera devices.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getAvailableDevices(): Promise<{ devices: CameraDevice[] }>;\n\n  /**\n   * Gets the current zoom state, including min/max and current lens info.\n   *\n   * @returns {Promise<{ min: number; max: number; current: number; lens: LensInfo }>} A promise that resolves with the zoom state.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getZoom(): Promise<{\n    min: number;\n    max: number;\n    current: number;\n    lens: LensInfo;\n  }>;\n\n  /**\n   * Returns zoom button values for quick switching.\n   * - iOS/Android: includes 0.5 if ultra-wide available; 1 and 2 if wide available; 3 if telephoto available\n   * - Web: unsupported\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getZoomButtonValues(): Promise<{ values: number[] }>;\n\n  /**\n   * Sets the zoom level of the camera.\n   *\n   * @param {{ level: number; ramp?: boolean; autoFocus?: boolean }} options - The desired zoom level. `ramp` is currently unused. `autoFocus` defaults to true.\n   * @returns {Promise<void>} A promise that resolves when the zoom level is set.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setZoom(options: { level: number; ramp?: boolean; autoFocus?: boolean }): Promise<void>;\n\n  /**\n   * Gets the current flash mode.\n   *\n   * @returns {Promise<{ flashMode: FlashMode }>} A promise that resolves with the current flash mode.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getFlashMode(): Promise<{ flashMode: FlashMode }>;\n\n  /**\n   * Removes all registered listeners.\n   *\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Switches the active camera to the one with the specified `deviceId`.\n   *\n   * @param {{ deviceId: string }} options - The ID of the device to switch to.\n   * @returns {Promise<void>} A promise that resolves when the camera is switched.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setDeviceId(options: { deviceId: string }): Promise<void>;\n\n  /**\n   * Gets the ID of the camera device that is currently bound.\n   * On Android, if a physical-lens request falls back to a logical camera, this returns the bound logical camera ID.\n   *\n   * @returns {Promise<{ deviceId: string }>} A promise that resolves with the current device ID.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getDeviceId(): Promise<{ deviceId: string }>;\n\n  /**\n   * Gets the current preview size and position.\n   * @returns {Promise<{x: number, y: number, width: number, height: number}>}\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getPreviewSize(): Promise<{\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n  }>;\n  /**\n   * Sets the preview size and position.\n   * @param options The new position and dimensions.\n   * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setPreviewSize(options: { x?: number; y?: number; width: number; height: number }): Promise<{\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n  }>;\n\n  /**\n   * Sets the camera focus to a specific point in the preview.\n   *\n   * Note: The plugin does not attach any native tap-to-focus gesture handlers. Handle taps in\n   * your HTML/JS (e.g., on the overlaying UI), then pass normalized coordinates here.\n   *\n   * @param {Object} options - The focus options.\n   * @param {number} options.x - The x coordinate in the preview view to focus on (0-1 normalized).\n   * @param {number} options.y - The y coordinate in the preview view to focus on (0-1 normalized).\n   * @returns {Promise<void>} A promise that resolves when the focus is set.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  setFocus(options: { x: number; y: number }): Promise<void>;\n\n  /**\n   * Adds a listener for screen resize events.\n   * @param {string} eventName - The event name to listen for.\n   * @param {Function} listenerFunc - The function to call when the event is triggered.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves with a handle to the listener.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  addListener(\n    eventName: 'screenResize',\n    listenerFunc: (data: { width: number; height: number; x: number; y: number }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener for orientation change events.\n   * @param {string} eventName - The event name to listen for.\n   * @param {Function} listenerFunc - The function to call when the event is triggered.\n   * @returns {Promise<PluginListenerHandle>} A promise that resolves with a handle to the listener.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  addListener(\n    eventName: 'orientationChange',\n    listenerFunc: (data: { orientation: DeviceOrientation }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener for barcode scan results.\n   *\n   * @since 8.8.0\n   * @platform android, ios, web\n   */\n  addListener(\n    eventName: 'barcodeScanned',\n    listenerFunc: (data: BarcodeScannedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener for non-fatal barcode scanner errors.\n   *\n   * @since 8.8.0\n   * @platform android, web\n   */\n  addListener(\n    eventName: 'barcodeScanError',\n    listenerFunc: (data: BarcodeScanErrorEvent) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Adds a listener fired when a video recording finishes natively, including automatic stops.\n   *\n   * @since 8.4.7\n   * @platform android, ios\n   */\n  addListener(\n    eventName: 'recordingFinished',\n    listenerFunc: (data: RecordingFinishedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Deletes a file at the given absolute path on the device.\n   * Use this to quickly clean up temporary images created with `storeToFile`.\n   * On web, this is not supported and will throw.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  deleteFile(options: { path: string }): Promise<{ success: boolean }>;\n\n  /**\n   * Gets the safe area insets for devices.\n   * Returns the orientation-aware notch/camera cutout inset and the current orientation.\n   * In portrait mode: returns top inset (notch at top).\n   * In landscape mode: returns left inset (notch moved to side).\n   * This specifically targets the cutout area (notch, punch hole, etc.) that all modern phones have.\n   *\n   * Android: Values returned in dp (logical pixels).\n   * iOS: Values returned in physical pixels, excluding status bar (only pure notch/cutout size).\n   *\n   * @platform android, ios\n   */\n  getSafeAreaInsets(): Promise<SafeAreaInsets>;\n\n  /**\n   * Gets the current device orientation in a cross-platform format.\n   * @since 7.5.0\n   * @platform android, ios\n   */\n  getOrientation(): Promise<{ orientation: DeviceOrientation }>;\n\n  /**\n   * Returns the exposure modes supported by the active camera.\n   * Modes can include: 'locked', 'auto', 'continuous', 'custom'.\n   * @platform android, ios\n   */\n  getExposureModes(): Promise<{ modes: ExposureMode[] }>;\n\n  /**\n   * Returns the current exposure mode.\n   * @platform android, ios\n   */\n  getExposureMode(): Promise<{ mode: ExposureMode }>;\n\n  /**\n   * Sets the exposure mode.\n   * @platform android, ios\n   */\n  setExposureMode(options: { mode: ExposureMode }): Promise<void>;\n\n  /**\n   * Returns the exposure compensation (EV bias) supported range.\n   * @platform ios, android\n   */\n  getExposureCompensationRange(): Promise<{\n    min: number;\n    max: number;\n    step: number;\n  }>;\n\n  /**\n   * Returns the current exposure compensation (EV bias).\n   * @platform ios, android\n   */\n  getExposureCompensation(): Promise<{ value: number }>;\n\n  /**\n   * Sets the exposure compensation (EV bias). Value will be clamped to range.\n   * @platform ios, android\n   */\n  setExposureCompensation(options: { value: number }): Promise<void>;\n\n  /**\n   * Returns the white-balance modes supported by the active camera.\n   * Modes can include: 'AUTO', 'LOCK', 'CONTINUOUS'. `CUSTOM` is not listed\n   * until manual gains support is implemented.\n   * @platform android, ios\n   */\n  getWhiteBalanceModes(): Promise<{ modes: WhiteBalanceMode[] }>;\n\n  /**\n   * Returns the current white-balance mode.\n   * @platform android, ios\n   */\n  getWhiteBalanceMode(): Promise<{ mode: WhiteBalanceMode }>;\n\n  /**\n   * Sets the white-balance mode. `CONTINUOUS` keeps auto white balance running\n   * (recommended; avoids a warm/yellow cast), `LOCK` freezes the current gains,\n   * `AUTO` performs a one-time adjustment. `CUSTOM` is reserved and rejected\n   * until manual gains support is implemented.\n   * @platform android, ios\n   */\n  setWhiteBalanceMode(options: { mode: WhiteBalanceMode }): Promise<void>;\n\n  /**\n   * Lists the video frame rates supported by the active camera for the current format.\n   * Supported values depend on the selected camera, lens, and video quality.\n   *\n   * @platform android, ios\n   * @since 8.6.0\n   */\n  getSupportedVideoFrameRates(): Promise<{\n    frameRates: number[];\n  }>;\n\n  /**\n   * Returns the configured video frame rate for the active camera.\n   * On Android the actual recording frame rate can still vary in low light or under thermal pressure.\n   *\n   * @platform android, ios\n   * @since 8.6.0\n   */\n  getVideoFrameRate(): Promise<{\n    frameRate: number;\n  }>;\n\n  /**\n   * Sets the target video frame rate for the active camera session.\n   * Prefer passing `frameRate` to `startRecordVideo()` when starting a recording.\n   * Rejects unsupported values with a clear error.\n   *\n   * @platform android, ios\n   * @since 8.6.0\n   */\n  setVideoFrameRate(options: { frameRate: number }): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/dist/esm/web.js

@@ -630,8 +630,8 @@ export class CameraPreviewWeb extends WebPlugin {
                 }
                 canvas.width = captureWidth;
                 canvas.height = captureHeight;
-                // flip horizontally back camera isn't used
-                if (!this.isBackCamera) {
+                // Opt-in selfie-style mirror for front camera captures.
+                if (!this.isBackCamera && options.mirrorFrontCamera === true) {
                     context === null || context === void 0 ? void 0 : context.translate(captureWidth, 0);
                     context === null || context === void 0 ? void 0 : context.scale(-1, 1);
                 }