@capgo/camera-preview 7.4.0-beta.1 → 7.4.0-beta.10

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAIA,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":["export type CameraPosition = \"rear\" | \"front\";\n\nexport type FlashMode = CameraPreviewFlashMode;\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   * 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, enables high-resolution image capture.\n   * @platform ios\n   * @default false\n   */\n  enableHighResolution?: boolean;\n  /** \n   * If true, disables the audio stream, preventing audio permission requests.\n   * @default false\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   * If true, enables pinch-to-zoom functionality on the preview.\n   * @platform android\n   * @default false\n   */\n  enableZoom?: boolean;\n  /** \n   * If true, uses the video-optimized preset for the camera session.\n   * @platform ios\n   * @default false\n   */\n  enableVideoMode?: boolean;\n  /** \n   * The `deviceId` of the camera to use. If provided, `position` is ignored.\n   * @platform ios\n   */\n  deviceId?: string;\n}\n\n/**\n * Defines the options for capturing a picture.\n */\nexport interface CameraPreviewPictureOptions {\n  /** The desired height of the picture in pixels. If not provided, the device default is used. */\n  height?: number;\n  /** The desired width of the picture in pixels. If not provided, the device default is used. */\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\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 =\n  | \"off\"\n  | \"on\"\n  | \"auto\"\n  | \"torch\";\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 * 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<void>} A promise that resolves when the camera preview is started.\n   * @since 0.0.1\n   */\n  start(options: CameraPreviewOptions): Promise<void>;\n\n  /**\n   * Stops the camera preview.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera preview is stopped.\n   * @since 0.0.1\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Captures a picture from the camera.\n   *\n   * @param {CameraPreviewPictureOptions} options - The options for capturing the picture.\n   * @returns {Promise<{ value: string }>} A promise that resolves with the captured image data.\n   * The `value` is a base64 encoded string unless `storeToFile` is true, in which case it's a file path.\n   * @since 0.0.1\n   */\n  capture(options: CameraPreviewPictureOptions): Promise<{ value: string }>;\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   * 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: {\n    flashMode: CameraPreviewFlashMode | string;\n  }): 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.\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.4.0\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.4.0\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.4.0\n   */\n  getZoom(): Promise<{ \n    min: number; \n    max: number; \n    current: number;\n    lens: LensInfo;\n  }>;\n\n  /**\n   * Sets the camera's zoom level.\n   *\n   * @param {{ level: number; ramp?: boolean }} options - The desired zoom level. `ramp` is currently unused.\n   * @returns {Promise<void>} A promise that resolves when the zoom level is set.\n   * @since 7.4.0\n   */\n  setZoom(options: { level: number; ramp?: 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.4.0\n   */\n  getFlashMode(): Promise<{ flashMode: FlashMode }>;\n\n  /**\n   * Removes all registered listeners.\n   *\n   * @since 7.4.0\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.4.0\n   */\n  setDeviceId(options: { deviceId: string }): Promise<void>;\n\n  /**\n   * Gets the ID of the currently active camera device.\n   *\n   * @returns {Promise<{ deviceId: string }>} A promise that resolves with the current device ID.\n   * @since 7.4.0\n   */\n  getDeviceId(): Promise<{ deviceId: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAMA,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":["export type CameraPosition = \"rear\" | \"front\";\n\nexport type FlashMode = CameraPreviewFlashMode;\n\nexport type GridMode = \"none\" | \"3x3\" | \"4x4\";\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' | 'fill';\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, enables high-resolution image capture.\n   * @platform ios\n   * @default false\n   */\n  enableHighResolution?: 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   * If true, enables pinch-to-zoom functionality on the preview.\n   * @platform android\n   * @default false\n   */\n  enableZoom?: boolean;\n  /**\n   * If true, uses the video-optimized preset for the camera session.\n   * @platform ios\n   * @default false\n   */\n  enableVideoMode?: boolean;\n  /**\n   * The `deviceId` of the camera to use. If provided, `position` is ignored.\n   * @platform ios\n   */\n  deviceId?: string;\n}\n\n/**\n * Defines the options for capturing a picture.\n */\nexport interface CameraPreviewPictureOptions {\n  /** The desired height of the picture in pixels. If not provided, the device default is used. */\n  height?: number;\n  /** The desired width of the picture in pixels. If not provided, the device default is used. */\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\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 =\n  | \"off\"\n  | \"on\"\n  | \"auto\"\n  | \"torch\";\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 * 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   * @returns {Promise<void>} A promise that resolves when the camera preview is stopped.\n   * @since 0.0.1\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Captures a picture from the camera.\n   *\n   * @param {CameraPreviewPictureOptions} options - The options for capturing the picture.\n   * @returns {Promise<{ value: string }>} A promise that resolves with the captured image data.\n   * The `value` is a base64 encoded string unless `storeToFile` is true, in which case it's a file path.\n   * @since 0.0.1\n   */\n  capture(\n    options: CameraPreviewPictureOptions\n  ): 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.4.0\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.4.0\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   * 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: {\n    flashMode: CameraPreviewFlashMode | string;\n  }): 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.\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.4.0\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.4.0\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.4.0\n   */\n  getZoom(): Promise<{\n    min: number;\n    max: number;\n    current: number;\n    lens: LensInfo;\n  }>;\n\n  /**\n   * Sets the camera's zoom level.\n   *\n   * @param {{ level: number; ramp?: boolean }} options - The desired zoom level. `ramp` is currently unused.\n   * @returns {Promise<void>} A promise that resolves when the zoom level is set.\n   * @since 7.4.0\n   */\n  setZoom(options: { level: number; ramp?: 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.4.0\n   */\n  getFlashMode(): Promise<{ flashMode: FlashMode }>;\n\n  /**\n   * Removes all registered listeners.\n   *\n   * @since 7.4.0\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.4.0\n   */\n  setDeviceId(options: { deviceId: string }): Promise<void>;\n\n  /**\n   * Gets the ID of the currently active camera device.\n   *\n   * @returns {Promise<{ deviceId: string }>} A promise that resolves with the current device ID.\n   * @since 7.4.0\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   */\n  getPreviewSize(): Promise<{x: number, y: number, width: number, height: number}>;\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   */\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"]}

package/dist/esm/web.d.ts

@@ -1,5 +1,5 @@
 import { WebPlugin } from "@capacitor/core";
-import type { CameraDevice, CameraOpacityOptions, CameraPreviewFlashMode, CameraPreviewOptions, CameraPreviewPictureOptions, CameraPreviewPlugin, CameraSampleOptions, FlashMode, LensInfo } from "./definitions";
+import type { CameraDevice, CameraOpacityOptions, CameraPreviewFlashMode, CameraPreviewOptions, CameraPreviewPictureOptions, CameraPreviewPlugin, CameraSampleOptions, GridMode, FlashMode, LensInfo } from "./definitions";
 export declare class CameraPreviewWeb extends WebPlugin implements CameraPreviewPlugin {
     /**
      *  track which camera is used based on start options
@@ -7,11 +7,18 @@ export declare class CameraPreviewWeb extends WebPlugin implements CameraPreview
      */
     private isBackCamera;
     private currentDeviceId;
+    private videoElement;
+    private isStarted;
     constructor();
     getSupportedPictureSizes(): Promise<any>;
-    start(options: CameraPreviewOptions): Promise<void>;
+    start(options: CameraPreviewOptions): Promise<{
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+    }>;
     private stopStream;
-    stop(): Promise<any>;
+    stop(): Promise<void>;
     capture(options: CameraPreviewPictureOptions): Promise<any>;
     captureSample(_options: CameraSampleOptions): Promise<any>;
     stopRecordVideo(): Promise<any>;
@@ -52,4 +59,41 @@ export declare class CameraPreviewWeb extends WebPlugin implements CameraPreview
     setDeviceId(options: {
         deviceId: string;
     }): Promise<void>;
+    getAspectRatio(): Promise<{
+        aspectRatio: '4:3' | '16:9';
+    }>;
+    setAspectRatio(options: {
+        aspectRatio: '4:3' | '16:9';
+        x?: number;
+        y?: number;
+    }): Promise<{
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+    }>;
+    private createGridOverlay;
+    setGridMode(options: {
+        gridMode: GridMode;
+    }): Promise<void>;
+    getGridMode(): Promise<{
+        gridMode: GridMode;
+    }>;
+    getPreviewSize(): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    setPreviewSize(options: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): Promise<{
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+    }>;
 }

package/dist/esm/web.js

@@ -1,5 +1,6 @@
 import { WebPlugin } from "@capacitor/core";
 import { DeviceType } from "./definitions";
+const DEFAULT_VIDEO_ID = "capgo_video";
 export class CameraPreviewWeb extends WebPlugin {
     constructor() {
         super();
@@ -9,87 +10,100 @@ export class CameraPreviewWeb extends WebPlugin {
          */
         this.isBackCamera = false;
         this.currentDeviceId = null;
+        this.videoElement = null;
+        this.isStarted = false;
     }
     async getSupportedPictureSizes() {
         throw new Error("getSupportedPictureSizes not supported under the web platform");
     }
     async start(options) {
-        var _a;
-        await navigator.mediaDevices
-            .getUserMedia({
-            audio: !options.disableAudio,
-            video: true,
-        })
-            .then((stream) => {
-            // Stop any existing stream so we can request media with different constraints based on user input
-            stream.getTracks().forEach((track) => track.stop());
-        })
-            .catch((error) => {
-            Promise.reject(error);
-        });
-        const video = document.getElementById("video");
+        if (options.aspectRatio && (options.width || options.height)) {
+            throw new Error("Cannot set both aspectRatio and size (width/height). Use setPreviewSize after start.");
+        }
+        if (this.isStarted) {
+            throw new Error("camera already started");
+        }
+        this.isBackCamera = true;
+        this.isStarted = false;
         const parent = document.getElementById((options === null || options === void 0 ? void 0 : options.parent) || "");
-        if (!video) {
-            const videoElement = document.createElement("video");
-            videoElement.id = "video";
-            videoElement.setAttribute("class", (options === null || options === void 0 ? void 0 : options.className) || "");
-            // Don't flip video feed if camera is rear facing
-            if (options.position !== "rear") {
-                videoElement.setAttribute("style", "-webkit-transform: scaleX(-1); transform: scaleX(-1);");
-            }
-            const userAgent = navigator.userAgent.toLowerCase();
-            const isSafari = userAgent.includes("safari") && !userAgent.includes("chrome");
-            // Safari on iOS needs to have the autoplay, muted and playsinline attributes set for video.play() to be successful
-            // Without these attributes videoElement.play() will throw a NotAllowedError
-            // https://developer.apple.com/documentation/webkit/delivering_video_content_for_safari
-            if (isSafari) {
-                videoElement.setAttribute("autoplay", "true");
-                videoElement.setAttribute("muted", "true");
-                videoElement.setAttribute("playsinline", "true");
+        const gridMode = (options === null || options === void 0 ? void 0 : options.gridMode) || "none";
+        if (options.position) {
+            this.isBackCamera = options.position === "rear";
+        }
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
+        if (video) {
+            video.remove();
+        }
+        const container = options.parent ? document.getElementById(options.parent) : document.body;
+        if (!container) {
+            throw new Error("container not found");
+        }
+        this.videoElement = document.createElement("video");
+        this.videoElement.id = DEFAULT_VIDEO_ID;
+        this.videoElement.className = options.className || "";
+        this.videoElement.playsInline = true;
+        this.videoElement.muted = true;
+        this.videoElement.autoplay = true;
+        container.appendChild(this.videoElement);
+        if (options.toBack) {
+            this.videoElement.style.zIndex = "-1";
+        }
+        if (options.width) {
+            this.videoElement.width = options.width;
+        }
+        if (options.height) {
+            this.videoElement.height = options.height;
+        }
+        if (options.x) {
+            this.videoElement.style.left = `${options.x}px`;
+        }
+        // Create and add grid overlay if needed
+        if (gridMode !== "none") {
+            const gridOverlay = this.createGridOverlay(gridMode);
+            gridOverlay.id = "camera-grid-overlay";
+            parent === null || parent === void 0 ? void 0 : parent.appendChild(gridOverlay);
+        }
+        if (options.y) {
+            this.videoElement.style.top = `${options.y}px`;
+        }
+        if (options.aspectRatio) {
+            const [widthRatio, heightRatio] = options.aspectRatio.split(':').map(Number);
+            const ratio = widthRatio / heightRatio;
+            if (options.width) {
+                this.videoElement.height = options.width / ratio;
             }
-            parent === null || parent === void 0 ? void 0 : parent.appendChild(videoElement);
-            if ((_a = navigator === null || navigator === void 0 ? void 0 : navigator.mediaDevices) === null || _a === void 0 ? void 0 : _a.getUserMedia) {
-                const constraints = {
-                    video: {
-                        width: { ideal: options.width },
-                        height: { ideal: options.height },
-                    },
-                };
-                if (options.deviceId) {
-                    constraints.video.deviceId = { exact: options.deviceId };
-                    this.currentDeviceId = options.deviceId;
-                    // Try to determine camera position from device
-                    const devices = await navigator.mediaDevices.enumerateDevices();
-                    const device = devices.find(d => d.deviceId === options.deviceId);
-                    this.isBackCamera = (device === null || device === void 0 ? void 0 : device.label.toLowerCase().includes('back')) || (device === null || device === void 0 ? void 0 : device.label.toLowerCase().includes('rear')) || false;
-                }
-                else if (options.position === "rear") {
-                    constraints.video.facingMode = "environment";
-                    this.isBackCamera = true;
-                }
-                else {
-                    this.isBackCamera = false;
-                }
-                const self = this;
-                await navigator.mediaDevices.getUserMedia(constraints).then((stream) => {
-                    if (document.getElementById("video")) {
-                        // video.src = window.URL.createObjectURL(stream);
-                        videoElement.srcObject = stream;
-                        videoElement.play();
-                        Promise.resolve({});
-                    }
-                    else {
-                        self.stopStream(stream);
-                        Promise.reject(new Error("camera already stopped"));
-                    }
-                }, (err) => {
-                    Promise.reject(new Error(err));
-                });
+            else if (options.height) {
+                this.videoElement.width = options.height * ratio;
             }
         }
         else {
-            Promise.reject(new Error("camera already started"));
+            this.videoElement.style.objectFit = 'cover';
+        }
+        const constraints = {
+            video: {
+                width: { ideal: this.videoElement.width || 640 },
+                height: { ideal: this.videoElement.height || window.innerHeight },
+                facingMode: this.isBackCamera ? "environment" : "user",
+            },
+        };
+        const stream = await navigator.mediaDevices.getUserMedia(constraints);
+        if (!stream) {
+            throw new Error("could not acquire stream");
         }
+        if (!this.videoElement) {
+            throw new Error("video element not found");
+        }
+        this.videoElement.srcObject = stream;
+        if (!this.isBackCamera) {
+            this.videoElement.style.transform = "scaleX(-1)";
+        }
+        this.isStarted = true;
+        return {
+            width: this.videoElement.width,
+            height: this.videoElement.height,
+            x: this.videoElement.getBoundingClientRect().x,
+            y: this.videoElement.getBoundingClientRect().y,
+        };
     }
     stopStream(stream) {
         if (stream) {
@@ -99,16 +113,20 @@ export class CameraPreviewWeb extends WebPlugin {
         }
     }
     async stop() {
-        const video = document.getElementById("video");
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
         if (video) {
             video.pause();
             this.stopStream(video.srcObject);
             video.remove();
+            this.isStarted = false;
         }
+        // Remove grid overlay if it exists
+        const gridOverlay = document.getElementById("camera-grid-overlay");
+        gridOverlay === null || gridOverlay === void 0 ? void 0 : gridOverlay.remove();
     }
     async capture(options) {
         return new Promise((resolve, reject) => {
-            const video = document.getElementById("video");
+            const video = document.getElementById(DEFAULT_VIDEO_ID);
             if (!(video === null || video === void 0 ? void 0 : video.srcObject)) {
                 reject(new Error("camera is not running"));
                 return;
@@ -126,6 +144,12 @@ export class CameraPreviewWeb extends WebPlugin {
                     context === null || context === void 0 ? void 0 : context.scale(-1, 1);
                 }
                 context === null || context === void 0 ? void 0 : context.drawImage(video, 0, 0, video.videoWidth, video.videoHeight);
+                if (options.saveToGallery) {
+                    // saveToGallery is not supported on web
+                }
+                if (options.withExifLocation) {
+                    // withExifLocation is not supported on web
+                }
                 if ((options.format || "jpeg") === "jpeg") {
                     base64EncodedImage = canvas
                         .toDataURL("image/jpeg", (options.quality || 85) / 100.0)
@@ -139,6 +163,7 @@ export class CameraPreviewWeb extends WebPlugin {
             }
             resolve({
                 value: base64EncodedImage,
+                exif: {},
             });
         });
     }
@@ -162,7 +187,7 @@ export class CameraPreviewWeb extends WebPlugin {
         throw new Error(`setFlashMode not supported under the web platform${_options}`);
     }
     async flip() {
-        const video = document.getElementById("video");
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
         if (!(video === null || video === void 0 ? void 0 : video.srcObject)) {
             throw new Error("camera is not running");
         }
@@ -202,12 +227,12 @@ export class CameraPreviewWeb extends WebPlugin {
         }
     }
     async setOpacity(_options) {
-        const video = document.getElementById("video");
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
         if (!!video && !!_options.opacity)
             video.style.setProperty("opacity", _options.opacity.toString());
     }
     async isRunning() {
-        const video = document.getElementById("video");
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
         return { isRunning: !!video && !!video.srcObject };
     }
     async getAvailableDevices() {
@@ -281,7 +306,7 @@ export class CameraPreviewWeb extends WebPlugin {
         return { devices: result };
     }
     async getZoom() {
-        const video = document.getElementById("video");
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
         if (!(video === null || video === void 0 ? void 0 : video.srcObject)) {
             throw new Error("camera is not running");
         }
@@ -332,7 +357,7 @@ export class CameraPreviewWeb extends WebPlugin {
         };
     }
     async setZoom(options) {
-        const video = document.getElementById("video");
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
         if (!(video === null || video === void 0 ? void 0 : video.srcObject)) {
             throw new Error("camera is not running");
         }
@@ -362,7 +387,7 @@ export class CameraPreviewWeb extends WebPlugin {
         return { deviceId: this.currentDeviceId || "" };
     }
     async setDeviceId(options) {
-        const video = document.getElementById("video");
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
         if (!(video === null || video === void 0 ? void 0 : video.srcObject)) {
             throw new Error("camera is not running");
         }
@@ -400,5 +425,164 @@ export class CameraPreviewWeb extends WebPlugin {
             throw new Error(`Failed to swap to device ${options.deviceId}: ${error}`);
         }
     }
+    async getAspectRatio() {
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
+        if (!video) {
+            throw new Error("camera is not running");
+        }
+        const width = video.offsetWidth;
+        const height = video.offsetHeight;
+        if (width && height) {
+            const ratio = width / height;
+            // Check for portrait camera ratios: 4:3 -> 3:4, 16:9 -> 9:16
+            if (Math.abs(ratio - (3 / 4)) < 0.01) {
+                return { aspectRatio: '4:3' };
+            }
+            if (Math.abs(ratio - (9 / 16)) < 0.01) {
+                return { aspectRatio: '16:9' };
+            }
+        }
+        // Default to 4:3 if no specific aspect ratio is matched
+        return { aspectRatio: '4:3' };
+    }
+    async setAspectRatio(options) {
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
+        if (!video) {
+            throw new Error("camera is not running");
+        }
+        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
+            const ratio = heightRatio / widthRatio;
+            // Get current position and size
+            const rect = video.getBoundingClientRect();
+            const currentWidth = rect.width;
+            const currentHeight = rect.height;
+            const currentRatio = currentWidth / currentHeight;
+            let newWidth;
+            let newHeight;
+            if (currentRatio > ratio) {
+                // Width is larger, fit by height and center horizontally
+                newWidth = currentHeight * ratio;
+                newHeight = currentHeight;
+            }
+            else {
+                // Height is larger, fit by width and center vertically
+                newWidth = currentWidth;
+                newHeight = currentWidth / ratio;
+            }
+            // Calculate position
+            let x, y;
+            if (options.x !== undefined && options.y !== undefined) {
+                // Use provided coordinates, ensuring they stay within screen boundaries
+                x = Math.max(0, Math.min(options.x, window.innerWidth - newWidth));
+                y = Math.max(0, Math.min(options.y, window.innerHeight - newHeight));
+            }
+            else {
+                // Auto-center the view
+                x = (window.innerWidth - newWidth) / 2;
+                y = (window.innerHeight - newHeight) / 2;
+            }
+            video.style.width = `${newWidth}px`;
+            video.style.height = `${newHeight}px`;
+            video.style.left = `${x}px`;
+            video.style.top = `${y}px`;
+            video.style.position = 'absolute';
+            return {
+                width: Math.round(newWidth),
+                height: Math.round(newHeight),
+                x: Math.round(x),
+                y: Math.round(y)
+            };
+        }
+        else {
+            video.style.objectFit = 'cover';
+            const rect = video.getBoundingClientRect();
+            return {
+                width: Math.round(rect.width),
+                height: Math.round(rect.height),
+                x: Math.round(rect.left),
+                y: Math.round(rect.top)
+            };
+        }
+    }
+    createGridOverlay(gridMode) {
+        const overlay = document.createElement("div");
+        overlay.style.position = "absolute";
+        overlay.style.top = "0";
+        overlay.style.left = "0";
+        overlay.style.width = "100%";
+        overlay.style.height = "100%";
+        overlay.style.pointerEvents = "none";
+        overlay.style.zIndex = "10";
+        const divisions = gridMode === "3x3" ? 3 : 4;
+        // Create SVG for grid lines
+        const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+        svg.style.width = "100%";
+        svg.style.height = "100%";
+        svg.style.position = "absolute";
+        svg.style.top = "0";
+        svg.style.left = "0";
+        // Create grid lines
+        for (let i = 1; i < divisions; i++) {
+            // Vertical lines
+            const verticalLine = document.createElementNS("http://www.w3.org/2000/svg", "line");
+            verticalLine.setAttribute("x1", `${(i / divisions) * 100}%`);
+            verticalLine.setAttribute("y1", "0%");
+            verticalLine.setAttribute("x2", `${(i / divisions) * 100}%`);
+            verticalLine.setAttribute("y2", "100%");
+            verticalLine.setAttribute("stroke", "rgba(255, 255, 255, 0.5)");
+            verticalLine.setAttribute("stroke-width", "1");
+            svg.appendChild(verticalLine);
+            // Horizontal lines
+            const horizontalLine = document.createElementNS("http://www.w3.org/2000/svg", "line");
+            horizontalLine.setAttribute("x1", "0%");
+            horizontalLine.setAttribute("y1", `${(i / divisions) * 100}%`);
+            horizontalLine.setAttribute("x2", "100%");
+            horizontalLine.setAttribute("y2", `${(i / divisions) * 100}%`);
+            horizontalLine.setAttribute("stroke", "rgba(255, 255, 255, 0.5)");
+            horizontalLine.setAttribute("stroke-width", "1");
+            svg.appendChild(horizontalLine);
+        }
+        overlay.appendChild(svg);
+        return overlay;
+    }
+    async setGridMode(options) {
+        // Web implementation of grid mode would need to be implemented
+        // For now, just resolve as a no-op
+        console.warn(`Grid mode '${options.gridMode}' is not yet implemented for web platform`);
+    }
+    async getGridMode() {
+        // Web implementation - default to none
+        return { gridMode: 'none' };
+    }
+    async getPreviewSize() {
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
+        if (!video) {
+            throw new Error("camera is not running");
+        }
+        return {
+            x: video.offsetLeft,
+            y: video.offsetTop,
+            width: video.width,
+            height: video.height
+        };
+    }
+    async setPreviewSize(options) {
+        const video = document.getElementById(DEFAULT_VIDEO_ID);
+        if (!video) {
+            throw new Error("camera is not running");
+        }
+        video.style.left = `${options.x}px`;
+        video.style.top = `${options.y}px`;
+        video.width = options.width;
+        video.height = options.height;
+        return {
+            width: options.width,
+            height: options.height,
+            x: options.x,
+            y: options.y
+        };
+    }
 }
 //# sourceMappingURL=web.js.map