definitions.ts

export type CameraPosition = 'rear' | 'front';
export interface CameraPreviewOptions {
  /** Parent element to attach the video preview element to (applicable to the web platform only) */
  parent?: string;
  /** Class name to add to the video preview element (applicable to the web platform only) */
  className?: string;
  /** The preview width in pixels, default window.screen.width */
  width?: number;
  /** The preview height in pixels, default window.screen.height */
  height?: number;
  /** The x origin, default 0 (applicable to the android and ios platforms only) */
  x?: number;
  /** The y origin, default 0 (applicable to the android and ios platforms only) */
  y?: number;
  /**  Brings your html in front of your preview, default false (applicable to the android only) */
  toBack?: boolean;
  /** The preview bottom padding in pixes. Useful to keep the appropriate preview sizes when orientation changes (applicable to the android and ios platforms only) */
  paddingBottom?: number;
  /** Rotate preview when orientation changes (applicable to the ios platforms only; default value is true) */
  rotateWhenOrientationChanged?: boolean;
  /** Choose the camera to use 'front' or 'rear', default 'front' */
  position?: CameraPosition | string;
  /** Defaults to false - Capture images to a file and return the file path instead of returning base64 encoded data */
  storeToFile?: boolean;
  /** Defaults to false - Android Only - Disable automatic rotation of the image, and let the browser deal with it (keep reading on how to achieve it) */
  disableExifHeaderStripping?: boolean;
  /** Defaults to false - iOS only - Activate high resolution image capture so that output images are from the highest resolution possible on the device **/
  enableHighResolution?: boolean;
  /** Defaults to false - Web only - Disables audio stream to prevent permission requests and output switching */
  disableAudio?: boolean;
  /**  Android Only - Locks device orientation when camera is showing. */
  lockAndroidOrientation?: boolean;
  /** Defaults to false - Android and Web only.  Set if camera preview can change opacity. */
  enableOpacity?: boolean;
  /** Defaults to false - Android only.  Set if camera preview will support pinch to zoom. */
  enableZoom?: boolean;
}
export interface CameraPreviewPictureOptions {
  /** The picture height, optional, default 0 (Device default) */
  height?: number;
  /** The picture width, optional, default 0 (Device default) */
  width?: number;
  /** The picture quality, 0 - 100, default 85 on `iOS/Android`.
   *
   * If left undefined, the `web` implementation will export a PNG, otherwise a JPEG will be generated */
  quality?: number;
}

export interface CameraSampleOptions {
  /** The picture quality, 0 - 100, default 85 */
  quality?: number;
}

export type CameraPreviewFlashMode = 'off' | 'on' | 'auto' | 'red-eye' | 'torch';

export interface CameraOpacityOptions {
  /** The percent opacity to set for camera view, default 1 */
  opacity?: number;
}

export interface CameraZoomOptions {
  /** The zoom factor (1.0 = no zoom, higher = more zoom) */
  zoom: number;
}

export interface CameraSwitchOptions {
  /** Index of rear camera to switch to (0-based). Use getAvailableCameras() to get count. */
  index: number;
}

export interface AvailableCamerasResult {
  /** Number of available rear cameras */
  count: number;
  /** Index of currently active camera */
  currentIndex: number;
}

export interface CameraPreviewPlugin {
  start(options: CameraPreviewOptions): Promise<void>;
  startRecordVideo(options: CameraPreviewOptions): Promise<void>;
  stop(): Promise<void>;
  stopRecordVideo(): Promise<void>;
  capture(options: CameraPreviewPictureOptions): Promise<{ value: string }>;
  captureSample(options: CameraSampleOptions): Promise<{ value: string }>;
  getSupportedFlashModes(): Promise<{
    result: CameraPreviewFlashMode[];
  }>;
  setFlashMode(options: { flashMode: CameraPreviewFlashMode | string }): Promise<void>;
  flip(): Promise<void>;
  setOpacity(options: CameraOpacityOptions): Promise<void>;
  isCameraStarted(): Promise<{ value: boolean }>;
  /**
   * Set the zoom level of the current camera
   * @param options Zoom options with zoom factor
   * @since 6.1.0
   */
  setZoom(options: CameraZoomOptions): Promise<void>;
  /**
   * Switch to a specific rear camera by index.
   * Useful for multi-camera devices where you need to select a specific physical camera.
   * Only available on iOS 13+ devices with multiple rear cameras.
   * @param options Switch options with camera index
   * @since 6.1.0
   */
  switchCamera(options: CameraSwitchOptions): Promise<void>;
  /**
   * Get information about available rear cameras.
   * Returns the count of cameras and current camera index.
   * Only available on iOS.
   * @since 6.1.0
   */
  getAvailableCameras(): Promise<AvailableCamerasResult>;
}