npm - @capgo/camera-preview - Versions diffs - 8.3.7 → 8.3.8 - Mend

@capgo/camera-preview 8.3.7 → 8.3.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/README.md +40 -35
package/dist/docs.json +35 -10
package/dist/esm/definitions.d.ts +7 -6
package/dist/esm/definitions.js.map +1 -1
package/dist/esm/web.d.ts +4 -3
package/dist/esm/web.js +43 -8
package/dist/esm/web.js.map +1 -1
package/dist/plugin.cjs.js +43 -8
package/dist/plugin.cjs.js.map +1 -1
package/dist/plugin.js +43 -8
package/dist/plugin.js.map +1 -1
package/ios/Sources/CapgoCameraPreviewPlugin/Plugin.swift +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -466,14 +466,14 @@ Gets the flash modes supported by the active camera.
 ### setAspectRatio(...)
 ```typescript
-setAspectRatio(options: { aspectRatio: '4:3' | '16:9'; x?: number; y?: number; }) => Promise<{ width: number; height: number; x: number; y: number; }>
+setAspectRatio(options: { aspectRatio: CameraPreviewAspectRatio; x?: number; y?: number; }) => Promise<{ width: number; height: number; x: number; y: number; }>
 ```
 Set the aspect ratio of the camera preview.
-| Param         | Type                                                                   | Description                                                                                                                                                                                                                                                                                                           |
-| ------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`options`** | <code>{ aspectRatio: '4:3' \| '16:9'; x?: number; y?: number; }</code> | - The desired aspect ratio and optional position. - aspectRatio: The desired aspect ratio ('4:3' or '16:9') - x: Optional x coordinate for positioning. If not provided, view will be auto-centered horizontally. - y: Optional y coordinate for positioning. If not provided, view will be auto-centered vertically. |
+| Param         | Type                                                                                                                    | Description                                                                                                                                                                                                                                                                                                                    |
+| ------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **`options`** | <code>{ aspectRatio: <a href="#camerapreviewaspectratio">CameraPreviewAspectRatio</a>; x?: number; y?: number; }</code> | - The desired aspect ratio and optional position. - aspectRatio: The desired aspect ratio ('4:3', '16:9', or 'fill') - x: Optional x coordinate for positioning. If not provided, view will be auto-centered horizontally. - y: Optional y coordinate for positioning. If not provided, view will be auto-centered vertically. |
 **Returns:** <code>Promise&lt;{ width: number; height: number; x: number; y: number; }&gt;</code>
@@ -485,12 +485,12 @@ Set the aspect ratio of the camera preview.
 ### getAspectRatio()
 ```typescript
-getAspectRatio() => Promise<{ aspectRatio: '4:3' | '16:9'; }>
+getAspectRatio() => Promise<{ aspectRatio: CameraPreviewAspectRatio; }>
 ```
 Gets the current aspect ratio of the camera preview.
-**Returns:** <code>Promise&lt;{ aspectRatio: '4:3' | '16:9'; }&gt;</code>
+**Returns:** <code>Promise&lt;{ aspectRatio: <a href="#camerapreviewaspectratio">CameraPreviewAspectRatio</a>; }&gt;</code>
 **Since:** 7.5.0
@@ -1072,35 +1072,35 @@ Get the native Capacitor plugin version
 Defines the configuration options for starting the camera preview.
-| Prop                                | Type                                                            | Description                                                                                                                                                                                                                         | Default                | Since  |
-| ----------------------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ------ |
-| **`parent`**                        | <code>string</code>                                             | The parent element to attach the video preview to.                                                                                                                                                                                  |                        |        |
-| **`className`**                     | <code>string</code>                                             | A CSS class name to add to the preview element.                                                                                                                                                                                     |                        |        |
-| **`width`**                         | <code>number</code>                                             | The width of the preview in pixels. Defaults to the screen width.                                                                                                                                                                   |                        |        |
-| **`height`**                        | <code>number</code>                                             | The height of the preview in pixels. Defaults to the screen height.                                                                                                                                                                 |                        |        |
-| **`x`**                             | <code>number</code>                                             | The horizontal origin of the preview, in pixels.                                                                                                                                                                                    |                        |        |
-| **`y`**                             | <code>number</code>                                             | The vertical origin of the preview, in pixels.                                                                                                                                                                                      |                        |        |
-| **`aspectRatio`**                   | <code>'4:3' \| '16:9'</code>                                    | The aspect ratio of the camera preview, '4:3' or '16:9' or 'fill'. Cannot be set if width or height is provided, otherwise the call will be rejected. Use setPreviewSize to adjust size after starting.                             |                        | 2.0.0  |
-| **`aspectMode`**                    | <code>'cover' \| 'contain'</code>                               | Controls how the camera preview fills the available space. - 'contain': Fits the entire preview within the space, may show letterboxing (default). - 'cover': Fills the entire space, may crop edges of the preview.                | <code>"contain"</code> |        |
-| **`gridMode`**                      | <code><a href="#gridmode">GridMode</a></code>                   | The grid overlay to display on the camera preview.                                                                                                                                                                                  | <code>"none"</code>    | 2.1.0  |
-| **`includeSafeAreaInsets`**         | <code>boolean</code>                                            | Adjusts the y-position to account for safe areas (e.g., notches).                                                                                                                                                                   | <code>false</code>     |        |
-| **`toBack`**                        | <code>boolean</code>                                            | If true, places the preview behind the webview.                                                                                                                                                                                     | <code>true</code>      |        |
-| **`paddingBottom`**                 | <code>number</code>                                             | Bottom padding for the preview, in pixels.                                                                                                                                                                                          |                        |        |
-| **`rotateWhenOrientationChanged`**  | <code>boolean</code>                                            | Whether to rotate the preview when the device orientation changes.                                                                                                                                                                  | <code>true</code>      |        |
-| **`position`**                      | <code>string</code>                                             | The camera to use.                                                                                                                                                                                                                  | <code>"rear"</code>    |        |
-| **`storeToFile`**                   | <code>boolean</code>                                            | If true, saves the captured image to a file and returns the file path. If false, returns a base64 encoded string.                                                                                                                   | <code>false</code>     |        |
-| **`disableExifHeaderStripping`**    | <code>boolean</code>                                            | If true, prevents the plugin from rotating the image based on EXIF data.                                                                                                                                                            | <code>false</code>     |        |
-| **`disableAudio`**                  | <code>boolean</code>                                            | If true, disables the audio stream, preventing audio permission requests.                                                                                                                                                           | <code>true</code>      |        |
-| **`lockAndroidOrientation`**        | <code>boolean</code>                                            | If true, locks the device orientation while the camera is active.                                                                                                                                                                   | <code>false</code>     |        |
-| **`enableOpacity`**                 | <code>boolean</code>                                            | If true, allows the camera preview's opacity to be changed.                                                                                                                                                                         | <code>false</code>     |        |
-| **`disableFocusIndicator`**         | <code>boolean</code>                                            | If true, disables the visual focus indicator when tapping to focus.                                                                                                                                                                 | <code>false</code>     |        |
-| **`deviceId`**                      | <code>string</code>                                             | The `deviceId` of the camera to use. If provided, `position` is ignored.                                                                                                                                                            |                        |        |
-| **`enablePhysicalDeviceSelection`** | <code>boolean</code>                                            | On Android, attempts to bind a physical camera directly when `deviceId` refers to a physical lens. Disabled by default because OEM support is inconsistent; when false, Android keeps the current logical-camera fallback behavior. | <code>false</code>     |        |
-| **`initialZoomLevel`**              | <code>number</code>                                             | The initial zoom level when starting the camera preview. If the requested zoom level is not available, the native plugin will reject.                                                                                               | <code>1.0</code>       | 2.2.0  |
-| **`positioning`**                   | <code><a href="#camerapositioning">CameraPositioning</a></code> | The vertical positioning of the camera preview.                                                                                                                                                                                     | <code>"center"</code>  | 2.3.0  |
-| **`enableVideoMode`**               | <code>boolean</code>                                            | If true, enables video capture capabilities when the camera starts.                                                                                                                                                                 | <code>false</code>     | 7.11.0 |
-| **`force`**                         | <code>boolean</code>                                            | If true, forces the camera to start/restart even if it's already running or busy. This will kill the current camera session and start a new one, ignoring all state checks.                                                         | <code>false</code>     |        |
-| **`videoQuality`**                  | <code>'low' \| 'medium' \| 'high'</code>                        | Sets the quality of video for recording. Options: 'low', 'medium', 'high'                                                                                                                                                           | <code>"high"</code>    |        |
+| Prop                                | Type                                                                          | Description                                                                                                                                                                                                                         | Default                | Since  |
+| ----------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ------ |
+| **`parent`**                        | <code>string</code>                                                           | The parent element to attach the video preview to.                                                                                                                                                                                  |                        |        |
+| **`className`**                     | <code>string</code>                                                           | A CSS class name to add to the preview element.                                                                                                                                                                                     |                        |        |
+| **`width`**                         | <code>number</code>                                                           | The width of the preview in pixels. Defaults to the screen width.                                                                                                                                                                   |                        |        |
+| **`height`**                        | <code>number</code>                                                           | The height of the preview in pixels. Defaults to the screen height.                                                                                                                                                                 |                        |        |
+| **`x`**                             | <code>number</code>                                                           | The horizontal origin of the preview, in pixels.                                                                                                                                                                                    |                        |        |
+| **`y`**                             | <code>number</code>                                                           | The vertical origin of the preview, in pixels.                                                                                                                                                                                      |                        |        |
+| **`aspectRatio`**                   | <code><a href="#camerapreviewaspectratio">CameraPreviewAspectRatio</a></code> | The aspect ratio of the camera preview, '4:3' or '16:9' or 'fill'. Cannot be set if width or height is provided, otherwise the call will be rejected. Use setPreviewSize to adjust size after starting.                             |                        | 2.0.0  |
+| **`aspectMode`**                    | <code>'cover' \| 'contain'</code>                                             | Controls how the camera preview fills the available space. - 'contain': Fits the entire preview within the space, may show letterboxing (default). - 'cover': Fills the entire space, may crop edges of the preview.                | <code>"contain"</code> |        |
+| **`gridMode`**                      | <code><a href="#gridmode">GridMode</a></code>                                 | The grid overlay to display on the camera preview.                                                                                                                                                                                  | <code>"none"</code>    | 2.1.0  |
+| **`includeSafeAreaInsets`**         | <code>boolean</code>                                                          | Adjusts the y-position to account for safe areas (e.g., notches).                                                                                                                                                                   | <code>false</code>     |        |
+| **`toBack`**                        | <code>boolean</code>                                                          | If true, places the preview behind the webview.                                                                                                                                                                                     | <code>true</code>      |        |
+| **`paddingBottom`**                 | <code>number</code>                                                           | Bottom padding for the preview, in pixels.                                                                                                                                                                                          |                        |        |
+| **`rotateWhenOrientationChanged`**  | <code>boolean</code>                                                          | Whether to rotate the preview when the device orientation changes.                                                                                                                                                                  | <code>true</code>      |        |
+| **`position`**                      | <code>string</code>                                                           | The camera to use.                                                                                                                                                                                                                  | <code>"rear"</code>    |        |
+| **`storeToFile`**                   | <code>boolean</code>                                                          | If true, saves the captured image to a file and returns the file path. If false, returns a base64 encoded string.                                                                                                                   | <code>false</code>     |        |
+| **`disableExifHeaderStripping`**    | <code>boolean</code>                                                          | If true, prevents the plugin from rotating the image based on EXIF data.                                                                                                                                                            | <code>false</code>     |        |
+| **`disableAudio`**                  | <code>boolean</code>                                                          | If true, disables the audio stream, preventing audio permission requests.                                                                                                                                                           | <code>true</code>      |        |
+| **`lockAndroidOrientation`**        | <code>boolean</code>                                                          | If true, locks the device orientation while the camera is active.                                                                                                                                                                   | <code>false</code>     |        |
+| **`enableOpacity`**                 | <code>boolean</code>                                                          | If true, allows the camera preview's opacity to be changed.                                                                                                                                                                         | <code>false</code>     |        |
+| **`disableFocusIndicator`**         | <code>boolean</code>                                                          | If true, disables the visual focus indicator when tapping to focus.                                                                                                                                                                 | <code>false</code>     |        |
+| **`deviceId`**                      | <code>string</code>                                                           | The `deviceId` of the camera to use. If provided, `position` is ignored.                                                                                                                                                            |                        |        |
+| **`enablePhysicalDeviceSelection`** | <code>boolean</code>                                                          | On Android, attempts to bind a physical camera directly when `deviceId` refers to a physical lens. Disabled by default because OEM support is inconsistent; when false, Android keeps the current logical-camera fallback behavior. | <code>false</code>     |        |
+| **`initialZoomLevel`**              | <code>number</code>                                                           | The initial zoom level when starting the camera preview. If the requested zoom level is not available, the native plugin will reject.                                                                                               | <code>1.0</code>       | 2.2.0  |
+| **`positioning`**                   | <code><a href="#camerapositioning">CameraPositioning</a></code>               | The vertical positioning of the camera preview.                                                                                                                                                                                     | <code>"center"</code>  | 2.3.0  |
+| **`enableVideoMode`**               | <code>boolean</code>                                                          | If true, enables video capture capabilities when the camera starts.                                                                                                                                                                 | <code>false</code>     | 7.11.0 |
+| **`force`**                         | <code>boolean</code>                                                          | If true, forces the camera to start/restart even if it's already running or busy. This will kill the current camera session and start a new one, ignoring all state checks.                                                         | <code>false</code>     |        |
+| **`videoQuality`**                  | <code>'low' \| 'medium' \| 'high'</code>                                      | Sets the quality of video for recording. Options: 'low', 'medium', 'high'                                                                                                                                                           | <code>"high"</code>    |        |
 #### ExifData
@@ -1246,6 +1246,11 @@ iOS: Values are expressed in physical pixels and exclude status bar.
 ### Type Aliases
+#### CameraPreviewAspectRatio
+<code>'4:3' | '16:9' | 'fill'</code>
 #### GridMode
 <code>'none' | '3x3' | '4x4'</code>

package/dist/docs.json CHANGED Viewed

@@ -151,19 +151,19 @@
       },
       {
         "name": "setAspectRatio",
-        "signature": "(options: { aspectRatio: '4:3' | '16:9'; x?: number; y?: number; }) => Promise<{ width: number; height: number; x: number; y: number; }>",
+        "signature": "(options: { aspectRatio: CameraPreviewAspectRatio; x?: number; y?: number; }) => Promise<{ width: number; height: number; x: number; y: number; }>",
         "parameters": [
           {
             "name": "options",
-            "docs": "- The desired aspect ratio and optional position.\n- aspectRatio: The desired aspect ratio ('4:3' or '16:9')\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.",
-            "type": "{ aspectRatio: '4:3' | '16:9'; x?: number | undefined; y?: number | undefined; }"
+            "docs": "- 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.",
+            "type": "{ aspectRatio: CameraPreviewAspectRatio; x?: number | undefined; y?: number | undefined; }"
           }
         ],
         "returns": "Promise<{ width: number; height: number; x: number; y: number; }>",
         "tags": [
           {
             "name": "param",
-            "text": "options - The desired aspect ratio and optional position.\n- aspectRatio: The desired aspect ratio ('4:3' or '16:9')\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."
+            "text": "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."
           },
           {
             "name": "returns",
@@ -179,14 +179,16 @@
           }
         ],
         "docs": "Set the aspect ratio of the camera preview.",
-        "complexTypes": [],
+        "complexTypes": [
+          "CameraPreviewAspectRatio"
+        ],
         "slug": "setaspectratio"
       },
       {
         "name": "getAspectRatio",
-        "signature": "() => Promise<{ aspectRatio: '4:3' | '16:9'; }>",
+        "signature": "() => Promise<{ aspectRatio: CameraPreviewAspectRatio; }>",
         "parameters": [],
-        "returns": "Promise<{ aspectRatio: '4:3' | '16:9'; }>",
+        "returns": "Promise<{ aspectRatio: CameraPreviewAspectRatio; }>",
         "tags": [
           {
             "name": "returns",
@@ -202,7 +204,9 @@
           }
         ],
         "docs": "Gets the current aspect ratio of the camera preview.",
-        "complexTypes": [],
+        "complexTypes": [
+          "CameraPreviewAspectRatio"
+        ],
         "slug": "getaspectratio"
       },
       {
@@ -1177,8 +1181,10 @@
             }
           ],
           "docs": "The aspect ratio of the camera preview, '4:3' or '16:9' or 'fill'.\nCannot be set if width or height is provided, otherwise the call will be rejected.\nUse setPreviewSize to adjust size after starting.",
-          "complexTypes": [],
-          "type": "'4:3' | '16:9' | undefined"
+          "complexTypes": [
+            "CameraPreviewAspectRatio"
+          ],
+          "type": "CameraPreviewAspectRatio"
         },
         {
           "name": "aspectMode",
@@ -2062,6 +2068,25 @@
     }
   ],
   "typeAliases": [
+    {
+      "name": "CameraPreviewAspectRatio",
+      "slug": "camerapreviewaspectratio",
+      "docs": "",
+      "types": [
+        {
+          "text": "'4:3'",
+          "complexTypes": []
+        },
+        {
+          "text": "'16:9'",
+          "complexTypes": []
+        },
+        {
+          "text": "'fill'",
+          "complexTypes": []
+        }
+      ]
+    },
     {
       "name": "GridMode",
       "slug": "gridmode",

package/dist/esm/definitions.d.ts CHANGED Viewed

@@ -3,6 +3,7 @@ export type CameraPosition = 'rear' | 'front';
 export type FlashMode = CameraPreviewFlashMode;
 export type GridMode = 'none' | '3x3' | '4x4';
 export type CameraPositioning = 'center' | 'top' | 'bottom';
+export type CameraPreviewAspectRatio = '4:3' | '16:9' | 'fill';
 export interface CameraPermissionStatus {
     camera: PermissionState;
     microphone?: PermissionState;
@@ -114,7 +115,7 @@ export interface CameraPreviewOptions {
      *
      * @since 2.0.0
      */
-    aspectRatio?: '4:3' | '16:9';
+    aspectRatio?: CameraPreviewAspectRatio;
     /**
      * Controls how the camera preview fills the available space.
      * - 'contain': Fits the entire preview within the space, may show letterboxing (default).
@@ -443,8 +444,8 @@ export interface CameraPreviewPlugin {
     /**
      * Set the aspect ratio of the camera preview.
      *
-     * @param {{ aspectRatio: '4:3' | '16:9'; x?: number; y?: number }} options - The desired aspect ratio and optional position.
-     *   - aspectRatio: The desired aspect ratio ('4:3' or '16:9')
+     * @param {{ aspectRatio: CameraPreviewAspectRatio; x?: number; y?: number }} options - The desired aspect ratio and optional position.
+     *   - aspectRatio: The desired aspect ratio ('4:3', '16:9', or 'fill')
      *   - x: Optional x coordinate for positioning. If not provided, view will be auto-centered horizontally.
      *   - y: Optional y coordinate for positioning. If not provided, view will be auto-centered vertically.
      * @returns {Promise<{ width: number; height: number; x: number; y: number }>} A promise that resolves with the actual preview dimensions and position.
@@ -452,7 +453,7 @@ export interface CameraPreviewPlugin {
      * @platform android, ios
      */
     setAspectRatio(options: {
-        aspectRatio: '4:3' | '16:9';
+        aspectRatio: CameraPreviewAspectRatio;
         x?: number;
         y?: number;
     }): Promise<{
@@ -464,12 +465,12 @@ export interface CameraPreviewPlugin {
     /**
      * Gets the current aspect ratio of the camera preview.
      *
-     * @returns {Promise<{ aspectRatio: '4:3' | '16:9' }>} A promise that resolves with the current aspect ratio.
+     * @returns {Promise<{ aspectRatio: CameraPreviewAspectRatio }>} A promise that resolves with the current aspect ratio.
      * @since 7.5.0
      * @platform android, ios
      */
     getAspectRatio(): Promise<{
-        aspectRatio: '4:3' | '16:9';
+        aspectRatio: CameraPreviewAspectRatio;
     }>;
     /**
      * Sets the grid mode of the camera preview overlay.

package/dist/esm/definitions.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAwBA,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 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\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?: '4:3' \| '16:9';\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 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\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'\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?: 'low' \| 'medium' \| 'high';\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 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 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: '4:3' \| '16:9'; x?: number; y?: number }} options - The desired aspect ratio and optional position.\n * - aspectRatio: The desired aspect ratio ('4:3' or '16:9')\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: '4:3' \| '16:9'; 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: '4:3' \| '16:9' }>} A promise that resolves with the current aspect ratio.\n * @since 7.5.0\n * @platform android, ios\n /\n getAspectRatio(): Promise<{ aspectRatio: '4:3' \| '16:9' }>;\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<{ videoFilePath: string }>} A promise that resolves with the path to the recorded video file.\n * @since 0.0.1\n /\n stopRecordVideo(): Promise<{ videoFilePath: string }>;\n\n /\n Starts recording a video.\n \n @param {CameraPreviewOptions} options - The options for video recording. Only iOS.\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 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 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 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"]}
1	+ {"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA0BA,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 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\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 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\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'\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?: 'low' \| 'medium' \| 'high';\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 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 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<{ videoFilePath: string }>} A promise that resolves with the path to the recorded video file.\n * @since 0.0.1\n /\n stopRecordVideo(): Promise<{ videoFilePath: string }>;\n\n /\n Starts recording a video.\n \n @param {CameraPreviewOptions} options - The options for video recording. Only iOS.\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 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 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 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.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import { WebPlugin } from '@capacitor/core';
-import type { CameraDevice, CameraOpacityOptions, CameraPreviewFlashMode, CameraPreviewOptions, CameraPreviewPictureOptions, CameraPreviewPlugin, CameraSampleOptions, CameraPermissionStatus, DeviceOrientation, GridMode, ExposureMode, FlashMode, LensInfo, PermissionRequestOptions, SafeAreaInsets } from './definitions';
+import type { CameraDevice, CameraPreviewAspectRatio, CameraOpacityOptions, CameraPreviewFlashMode, CameraPreviewOptions, CameraPreviewPictureOptions, CameraPreviewPlugin, CameraSampleOptions, CameraPermissionStatus, DeviceOrientation, GridMode, ExposureMode, FlashMode, LensInfo, PermissionRequestOptions, SafeAreaInsets } from './definitions';
 export declare class CameraPreviewWeb extends WebPlugin implements CameraPreviewPlugin {
     /**
      *  track which camera is used based on start options
@@ -12,6 +12,7 @@ export declare class CameraPreviewWeb extends WebPlugin implements CameraPreview
     private orientationListenerBound;
     private mediaRecorder;
     private recordedChunks;
+    private currentAspectRatio;
     constructor();
     checkPermissions(options?: {
         disableAudio?: boolean;
@@ -80,10 +81,10 @@ export declare class CameraPreviewWeb extends WebPlugin implements CameraPreview
         deviceId: string;
     }): Promise<void>;
     getAspectRatio(): Promise<{
-        aspectRatio: '4:3' | '16:9';
+        aspectRatio: CameraPreviewAspectRatio;
     }>;
     setAspectRatio(options: {
-        aspectRatio: '4:3' | '16:9';
+        aspectRatio: CameraPreviewAspectRatio;
         x?: number;
         y?: number;
     }): Promise<{

package/dist/esm/web.js CHANGED Viewed

@@ -15,6 +15,7 @@ export class CameraPreviewWeb extends WebPlugin {
         this.orientationListenerBound = false;
         this.mediaRecorder = null;
         this.recordedChunks = [];
+        this.currentAspectRatio = '4:3';
     }
     async checkPermissions(options) {
         const result = {
@@ -202,6 +203,7 @@ export class CameraPreviewWeb extends WebPlugin {
         // Default to 4:3 if no aspect ratio or size specified
         const useDefaultAspectRatio = !options.aspectRatio && !options.width && !options.height;
         const effectiveAspectRatio = options.aspectRatio || (useDefaultAspectRatio ? '4:3' : null);
+        this.currentAspectRatio = effectiveAspectRatio || '4:3';
         if (options.width) {
             this.videoElement.width = options.width;
             this.videoElement.style.width = `${options.width}px`;
@@ -353,16 +355,24 @@ export class CameraPreviewWeb extends WebPlugin {
             }
             else if (effectiveAspectRatio) {
                 // Aspect ratio specified but no size
-                const [widthRatio, heightRatio] = effectiveAspectRatio.split(':').map(Number);
-                const targetRatio = widthRatio / heightRatio;
                 const viewportWidth = window.innerWidth;
                 const viewportHeight = window.innerHeight;
-                let targetWidth = viewportWidth;
-                let targetHeight = targetWidth / targetRatio;
-                // If height exceeds viewport, fit to height instead
-                if (targetHeight > viewportHeight) {
-                    targetHeight = viewportHeight;
-                    targetWidth = targetHeight * targetRatio;
+                let targetWidth;
+                let targetHeight;
+                if (effectiveAspectRatio === 'fill') {
+                    targetWidth = containerWidth;
+                    targetHeight = containerHeight;
+                }
+                else {
+                    const [widthRatio, heightRatio] = effectiveAspectRatio.split(':').map(Number);
+                    const targetRatio = widthRatio / heightRatio;
+                    targetWidth = viewportWidth;
+                    targetHeight = targetWidth / targetRatio;
+                    // If height exceeds viewport, fit to height instead
+                    if (targetHeight > viewportHeight) {
+                        targetHeight = viewportHeight;
+                        targetWidth = targetHeight * targetRatio;
+                    }
                 }
                 this.videoElement.width = targetWidth;
                 this.videoElement.height = targetHeight;
@@ -916,6 +926,9 @@ export class CameraPreviewWeb extends WebPlugin {
         if (!video) {
             throw new Error('camera is not running');
         }
+        if (this.currentAspectRatio === 'fill') {
+            return { aspectRatio: 'fill' };
+        }
         const width = video.offsetWidth;
         const height = video.offsetHeight;
         if (width && height) {
@@ -932,10 +945,32 @@ export class CameraPreviewWeb extends WebPlugin {
         return { aspectRatio: '4:3' };
     }
     async setAspectRatio(options) {
+        var _a, _b;
         const video = document.getElementById(DEFAULT_VIDEO_ID);
         if (!video) {
             throw new Error('camera is not running');
         }
+        this.currentAspectRatio = options.aspectRatio;
+        if (options.aspectRatio === 'fill') {
+            const parent = video.parentElement || document.body;
+            const targetWidth = parent.clientWidth || window.innerWidth;
+            const targetHeight = parent.clientHeight || window.innerHeight;
+            const x = (_a = options.x) !== null && _a !== void 0 ? _a : 0;
+            const y = (_b = options.y) !== null && _b !== void 0 ? _b : 0;
+            video.style.width = `${targetWidth}px`;
+            video.style.height = `${targetHeight}px`;
+            video.style.left = `${x}px`;
+            video.style.top = `${y}px`;
+            video.style.position = 'absolute';
+            const offsetX = targetWidth / 8;
+            const offsetY = targetHeight / 8;
+            return {
+                width: Math.round(targetWidth),
+                height: Math.round(targetHeight),
+                x: Math.round(x + offsetX),
+                y: Math.round(y + offsetY),
+            };
+        }
         if (options.aspectRatio) {
             const [widthRatio, heightRatio] = options.aspectRatio.split(':').map(Number);
             // For camera, use portrait orientation: 4:3 becomes 3:4, 16:9 becomes 9:16