@succinctlabs/react-native-zcam1 0.2.5

package/lib/typescript/src/NativeZcam1Capture.d.ts

@@ -0,0 +1,280 @@
+import { type TurboModule } from "react-native";
+export type TakeNativePhotoFormat = "jpeg" | "dng";
+export interface TakeNativePhotoOptions {
+    /**
+     * Desired output format. Defaults to "jpeg" if not provided.
+     */
+    format?: TakeNativePhotoFormat;
+    /**
+     * Optional quality hint for JPEG captures (0–1).
+     * Ignored for DNG.
+     */
+    quality?: number;
+}
+export interface TakeNativePhotoResult {
+    /**
+     * Local filesystem path to the captured image file.
+     * This is typically a "file://" URL or absolute path.
+     */
+    filePath: string;
+    /**
+     * The actual format of the captured file.
+     */
+    format: TakeNativePhotoFormat;
+    /**
+     * Optional metadata extracted by the native layer (EXIF, etc).
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Depth data extracted from the captured photo (if available).
+     *
+     * This is only returned when the caller requested it via the `includeDepthData`
+     * parameter on `takeNativePhoto(...)`, and only on devices/capture formats that
+     * support depth delivery.
+     */
+    depthData?: {
+        [key: string]: unknown;
+    } | null;
+}
+export type NativeVideoRecordingFormat = "mov";
+export interface StartNativeVideoRecordingResult {
+    /**
+     * Indicates that recording successfully started.
+     */
+    status: "recording";
+    /**
+     * Local filesystem path to the in-progress movie file.
+     */
+    filePath: string;
+    /**
+     * Container format for the recording.
+     */
+    format: NativeVideoRecordingFormat;
+    /**
+     * Whether audio is included in this recording.
+     * This depends on microphone permission and native session configuration.
+     */
+    hasAudio: boolean;
+}
+export interface StopNativeVideoRecordingResult {
+    /**
+     * Local filesystem path to the finalized movie file.
+     */
+    filePath: string;
+    /**
+     * Container format for the recording.
+     */
+    format: NativeVideoRecordingFormat;
+    /**
+     * Whether audio is included in this recording.
+     */
+    hasAudio: boolean;
+    /**
+     * Device make (if available).
+     */
+    deviceMake: string;
+    /**
+     * Device model (if available).
+     */
+    deviceModel: string;
+    /**
+     * Software version (if available).
+     */
+    softwareVersion: string;
+    /**
+     * Duration of the recorded clip in seconds (if available).
+     */
+    durationSeconds: number;
+    /**
+     * File size in bytes (if available).
+     */
+    fileSizeBytes: number;
+    /**
+     * Video pixel width (rotation-corrected, if available).
+     */
+    width: number;
+    /**
+     * Video pixel height (rotation-corrected, if available).
+     */
+    height: number;
+    /**
+     * Rotation in degrees derived from the video track transform (if available).
+     * Common values: 0, 90, 180, 270.
+     */
+    rotationDegrees: number;
+    /**
+     * Nominal frame rate (fps, if available).
+     */
+    frameRate: number;
+    /**
+     * Video codec FourCC (e.g. "avc1", "hvc1") if available.
+     */
+    videoCodec?: string;
+    /**
+     * Audio codec FourCC (e.g. "aac ") if available.
+     */
+    audioCodec?: string;
+    /**
+     * Audio sample rate in Hz (if available).
+     */
+    audioSampleRate?: number;
+    /**
+     * Audio channel count (if available).
+     */
+    audioChannels?: number;
+}
+export type FlashMode = "off" | "on" | "auto";
+export type AspectRatio = "4:3" | "16:9" | "1:1";
+export type Orientation = "auto" | "portrait" | "landscape";
+/**
+ * Physical device orientation as reported by the accelerometer.
+ * Unlike Orientation (which is a capture setting), this reflects the
+ * actual device position and is emitted via onOrientationChange events.
+ */
+export type DeviceOrientation = "portrait" | "portraitUpsideDown" | "landscapeLeft" | "landscapeRight";
+export interface Spec extends TurboModule {
+    /**
+     * Capture a photo using the native camera stack (Swift/AVFoundation)
+     * without going through react-native-vision-camera.
+     *
+     * The native implementation is responsible for:
+     * - Handling permissions
+     * - Presenting a preview / capture UI as needed
+     * - Writing the resulting JPEG or DNG file and returning its path
+     *
+     * @param includeDepthData When true, native should request depth (+ calibration)
+     * data delivery for this capture (if supported). When false, native should avoid
+     * enabling depth delivery and `depthData` will be omitted from the result.
+     * @param skipPostProcessing When true, returns raw sensor output without cropping
+     * or rotation. Useful for developers who want to handle their own post-processing.
+     */
+    takeNativePhoto(format: TakeNativePhotoFormat, position: "front" | "back", flash: FlashMode, includeDepthData: boolean, aspectRatio: AspectRatio, orientation: Orientation, skipPostProcessing: boolean): Promise<TakeNativePhotoResult>;
+    /**
+     * Start recording a video using the native camera stack.
+     *
+     * The recording is written to a temporary file and continues until
+     * `stopNativeVideoRecording()` is called or the optional duration cap is reached.
+     *
+     * @param position Which camera to use.
+     * @param maxDurationSeconds Maximum recording duration in seconds. The native
+     *   layer will automatically stop recording when this limit is reached. Pass 0
+     *   for unlimited recording.
+     */
+    startNativeVideoRecording(position: "front" | "back", maxDurationSeconds: number): Promise<StartNativeVideoRecordingResult>;
+    /**
+     * Stop an in-progress recording and return the finalized file path + metadata.
+     */
+    stopNativeVideoRecording(): Promise<StopNativeVideoRecordingResult>;
+    /**
+     * Set zoom factor programmatically (instant, no animation).
+     * For virtual devices with ultra-wide, 1.0 is ultra-wide (0.5x user-facing),
+     * 2.0 is wide-angle (1x user-facing), etc.
+     * @param factor Device zoom factor (use getMinZoom/getMaxZoom for valid range)
+     */
+    setZoom(factor: number): void;
+    /**
+     * Set zoom factor with smooth animation (recommended for pinch-to-zoom gestures).
+     * Uses native AVFoundation ramp for smooth transitions across lens switchover boundaries.
+     * @param factor Device zoom factor (use getMinZoom/getMaxZoom for valid range)
+     */
+    setZoomAnimated(factor: number): void;
+    /**
+     * Get the minimum supported zoom factor.
+     * For virtual devices with ultra-wide, this is 1.0 (corresponds to 0.5x user-facing).
+     */
+    getMinZoom(): Promise<number>;
+    /**
+     * Get the maximum supported zoom factor (capped at 15x for UX).
+     */
+    getMaxZoom(): Promise<number>;
+    /**
+     * Get the zoom factors where the device switches between physical lenses.
+     * Returns empty array for single-camera devices.
+     * For triple camera: typically [2.0, 6.0] meaning:
+     * - Below 2.0: ultra-wide lens (0.5x-1x user-facing)
+     * - At 2.0: switches FROM ultra-wide TO wide lens (1x user-facing)
+     * - At 6.0: switches FROM wide TO telephoto lens (3x user-facing)
+     */
+    getSwitchOverZoomFactors(): Promise<number[]>;
+    /**
+     * Check if the current device has an ultra-wide camera.
+     * This is true for builtInTripleCamera and builtInDualWideCamera (iPhone 11+, Pro models).
+     * This is false for builtInDualCamera (Wide + Telephoto, e.g., iPhone X/XS) and single-lens devices.
+     *
+     * Use this to correctly interpret zoom factors:
+     * - If hasUltraWide: minZoom (1.0) = 0.5x user-facing, switchOverFactors[0] (2.0) = 1x user-facing
+     * - If !hasUltraWide: minZoom (1.0) = 1x user-facing, switchOverFactors[0] (2.0) = 2x user-facing (telephoto)
+     */
+    hasUltraWideCamera(): Promise<boolean>;
+    /**
+     * Get the supported exposure compensation range in EV units.
+     * Returns the device's min and max exposure target bias values.
+     */
+    getExposureRange(): Promise<{
+        min: number;
+        max: number;
+    }>;
+    /**
+     * Reset exposure compensation to neutral (0 EV).
+     */
+    resetExposure(): void;
+    /**
+     * Focus at a normalized point in the preview.
+     * Also adjusts exposure point if supported.
+     * @param x Normalized x coordinate (0-1, left to right)
+     * @param y Normalized y coordinate (0-1, top to bottom)
+     */
+    focusAtPoint(x: number, y: number): void;
+    /**
+     * Get diagnostic info about the current camera device for debugging.
+     * Returns device type, supported zoom range, switching behavior, and more.
+     * Useful for debugging zoom issues on different device configurations.
+     */
+    getDeviceDiagnostics(): Promise<{
+        deviceType: string;
+        minZoom: number;
+        maxZoom: number;
+        currentZoom: number;
+        switchOverFactors: number[];
+        switchingBehavior: number;
+        isVirtualDevice: boolean;
+        currentExposureBias: number;
+        minExposureBias: number;
+        maxExposureBias: number;
+        currentISO: number;
+        exposureDuration: number;
+    }>;
+    /**
+     * Check if the current camera device supports depth data capture.
+     * Returns true for dual/triple rear cameras and TrueDepth front camera.
+     * Returns false for single rear cameras (iPhone SE, 16e, Air).
+     */
+    isDepthSupported(): Promise<boolean>;
+    /**
+     * Check if enabling depth would restrict zoom on this device.
+     * Returns true if zoom is limited to discrete levels (min == max in all ranges).
+     * This typically happens on dual-camera devices (iPhone 12-16 base).
+     * Returns false for triple-camera devices (Pro) and TrueDepth front cameras.
+     */
+    hasDepthZoomLimitations(): Promise<boolean>;
+    /**
+     * Get zoom ranges supported when depth data delivery is enabled.
+     * Returns array of [min, max] pairs. If min == max, it's a discrete level.
+     * Empty array means no depth support or no zoom restrictions.
+     *
+     * Example for dual-camera iPhone: [[2.0, 2.0], [4.0, 4.0]] (discrete 1x and 2x only)
+     * Example for triple-camera iPhone: [[1.0, 6.0]] (continuous zoom supported)
+     */
+    getDepthSupportedZoomRanges(): Promise<number[][]>;
+    /**
+     * Present a native full-screen preview for any file using QLPreviewController.
+     * Supports images, videos, PDFs, and other common file types.
+     * @param filePath Absolute filesystem path to the file.
+     */
+    previewFile(filePath: string): Promise<void>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeZcam1Capture.d.ts.map

package/lib/typescript/src/NativeZcam1Capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeZcam1Capture.d.ts","sourceRoot":"","sources":["../../../src/NativeZcam1Capture.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/NativeZcam1Sdk.d.ts

@@ -0,0 +1,8 @@
+import type { TurboModule } from 'react-native';
+export interface Spec extends TurboModule {
+    installRustCrate(): boolean;
+    cleanupRustCrate(): boolean;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeZcam1Sdk.d.ts.map

package/lib/typescript/src/NativeZcam1Sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeZcam1Sdk.d.ts","sourceRoot":"","sources":["../../../src/NativeZcam1Sdk.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,gBAAgB,IAAI,OAAO,CAAC;IAC5B,gBAAgB,IAAI,OAAO,CAAC;CAC7B;;AAED,wBAAkE"}

package/lib/typescript/src/bindings.d.ts

@@ -0,0 +1,14 @@
+export * from './generated/zcam1_c2pa_utils';
+export * from './generated/zcam1_certs_utils';
+export * from './generated/zcam1_verify_utils';
+import * as zcam1_c2pa_utils from './generated/zcam1_c2pa_utils';
+import * as zcam1_certs_utils from './generated/zcam1_certs_utils';
+import * as zcam1_verify_utils from './generated/zcam1_verify_utils';
+export declare function uniffiInitAsync(): Promise<void>;
+declare const _default: {
+    zcam1_c2pa_utils: typeof zcam1_c2pa_utils;
+    zcam1_certs_utils: typeof zcam1_certs_utils;
+    zcam1_verify_utils: typeof zcam1_verify_utils;
+};
+export default _default;
+//# sourceMappingURL=bindings.d.ts.map

package/lib/typescript/src/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../src/bindings.tsx"],"names":[],"mappings":"AAaA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAK/C,OAAO,KAAK,gBAAgB,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,kBAAkB,MAAM,gCAAgC,CAAC;AAgBrE,wBAAsB,eAAe,kBAEpC;;;;;;AAGD,wBAIE"}

package/lib/typescript/src/camera.d.ts

@@ -0,0 +1,300 @@
+import React from "react";
+import { type StyleProp, type ViewStyle } from "react-native";
+import { ExistingCertChain, SelfSignedCertChain } from "./bindings";
+import { type CaptureInfo, ZPhoto } from "./capture";
+import { type AspectRatio, type DeviceOrientation, type FlashMode, type Orientation, type StartNativeVideoRecordingResult, type StopNativeVideoRecordingResult } from "./NativeZcam1Capture";
+export declare const CERT_KEY_TAG = "CERT_KEY_TAG";
+/**
+ * Capture format produced by the native Swift camera.
+ * - "jpeg": standard compressed JPEG file
+ * - "dng": RAW DNG file (original), C2PA-signed JPEG copy is still produced
+ */
+export type CaptureFormat = "jpeg" | "dng";
+/**
+ * Camera film style presets.
+ * - "normal": No film style (default)
+ * - "mellow": Negative Film Gold style - warm, saturated, lifted shadows
+ * - "nostalgic": Kodak Portra 400 style - warm amber, faded, bright
+ * - "bw": Contrasty B&W with warm tint
+ */
+export type CameraFilmStyle = "normal" | "mellow" | "nostalgic" | "bw";
+/** White balance adjustment configuration. */
+export type WhiteBalanceConfig = {
+    /** Color temperature in Kelvin (e.g., 5500 for daylight, 6500 for cloudy). */
+    temperature: number;
+    /** Tint adjustment (-100 to 100, green to magenta). Defaults to 0. */
+    tint?: number;
+};
+/** Highlight and shadow adjustment configuration. */
+export type HighlightShadowConfig = {
+    /** Highlight adjustment (0 = no change, negative = reduce, positive = boost). */
+    highlights: number;
+    /** Shadow adjustment (0 = no change, positive = lift shadows). */
+    shadows: number;
+};
+/** Monochrome (black & white) film style configuration. */
+export type MonochromeConfig = {
+    /** Intensity of the monochrome effect (0 = none, 1 = full B&W). */
+    intensity: number;
+    /** Optional tint color for the monochrome effect. */
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+    };
+};
+/**
+ * Individual film style effect that can be combined into a recipe.
+ * Effects are applied in the order they appear in the recipe array.
+ */
+export type FilmStyleEffect = {
+    type: "whiteBalance";
+    config: WhiteBalanceConfig;
+} | {
+    type: "saturation";
+    value: number;
+} | {
+    type: "contrast";
+    value: number;
+} | {
+    type: "brightness";
+    value: number;
+} | {
+    type: "hue";
+    value: number;
+} | {
+    type: "vibrance";
+    value: number;
+} | {
+    type: "highlightShadow";
+    config: HighlightShadowConfig;
+} | {
+    type: "monochrome";
+    config: MonochromeConfig;
+};
+/**
+ * A film style recipe is an ordered array of film style effects.
+ * Effects are applied sequentially to produce the final look.
+ */
+export type FilmStyleRecipe = FilmStyleEffect[];
+export interface ZCameraProps {
+    /** Which camera to use. Defaults to "back". */
+    position?: "front" | "back";
+    /** Whether the camera is actively running. Defaults to true. */
+    isActive?: boolean;
+    /** Desired capture format. Defaults to "jpeg". */
+    captureFormat?: CaptureFormat;
+    /**
+     * Zoom factor. For back camera devices with ultra-wide lens, 1.0 = ultra-wide (0.5x user-facing),
+     * 2.0 = wide-angle (1x user-facing). Use getMinZoom/getMaxZoom for valid range.
+     * Defaults to 2.0 (1x user-facing) for back camera, 1.0 for front camera (to avoid digital zoom).
+     */
+    zoom?: number;
+    /** Whether torch (flashlight) is enabled during preview. Defaults to false. */
+    torch?: boolean;
+    /** Exposure compensation in EV units. Defaults to 0. */
+    exposure?: number;
+    /** Film style preset to apply to preview and captured photos. Defaults to "normal". */
+    filmStyle?: CameraFilmStyle;
+    /**
+     * Override built-in film style presets with custom recipes.
+     * When a preset name is used with `filmStyle` prop and an override exists,
+     * the custom recipe is applied instead of the built-in preset.
+     */
+    filmStyleOverrides?: Partial<Record<CameraFilmStyle, FilmStyleRecipe>>;
+    /**
+     * Define additional custom film styles referenced by name.
+     * Use with `filmStyle` prop by casting the custom name: `filmStyle={"myStyle" as CameraFilmStyle}`.
+     */
+    customFilmStyles?: Record<string, FilmStyleRecipe>;
+    /**
+     * Enable depth data capture at session level.
+     * When true, depth data can be captured but zoom may be restricted on dual-camera devices.
+     * When false (default), full zoom range is available.
+     * Use isDepthSupported() and hasDepthZoomLimitations() to check device capabilities.
+     * @default false
+     */
+    depthEnabled?: boolean;
+    /**
+     * Callback fired when the device physical orientation changes.
+     * Uses accelerometer data to detect orientation even when iOS orientation lock is enabled.
+     * @param orientation The new physical orientation of the device.
+     */
+    onOrientationChange?: (orientation: DeviceOrientation) => void;
+    /** Capture information used to generate C2PA bindings for each photo. */
+    captureInfo: CaptureInfo;
+    /** Optional certificate chain used to sign the C2PA manifest. */
+    certChain?: SelfSignedCertChain | ExistingCertChain;
+    /** Optional style for the underlying native view. */
+    style?: StyleProp<ViewStyle>;
+}
+/** Options for a single capture call. */
+export interface TakePhotoOptions {
+    format?: CaptureFormat;
+    /** Flash mode for this capture. Defaults to "off". */
+    flash?: FlashMode;
+    /**
+     * Whether to include depth data (if available) in the capture results.
+     * - When true: depth data is embedded into the C2PA metadata.
+     * - When false (default): depth data is omitted.
+     */
+    includeDepthData?: boolean;
+    /** Aspect ratio for the captured photo. Defaults to "4:3". */
+    aspectRatio?: AspectRatio;
+    /** Orientation for the crop. Defaults to "auto". */
+    orientation?: Orientation;
+}
+/**
+ * React wrapper around the native Swift camera.
+ *
+ * Responsibilities:
+ * - Render native camera preview (AVFoundation in Swift).
+ * - Trigger native capture (JPEG / DNG) via the TurboModule `Zcam1Sdk`.
+ * - Run C2PA signing on the captured image and return a `ZPhoto`.
+ *
+ * Exposed API remains compatible with the previous VisionCamera-based
+ * implementation: `cameraRef.current?.takePhoto()`.
+ */
+export declare class ZCamera extends React.PureComponent<ZCameraProps> {
+    /** Reference to the underlying native view (if needed later). */
+    private nativeRef;
+    /** Best-effort JS-side guard; native is the source of truth. */
+    private recordingInProgress;
+    /** Captured for convenience/debugging; cleared after stop. */
+    private lastVideoStartResult;
+    private certChainPem;
+    constructor(props: ZCameraProps);
+    /**
+     * Resolve the current film style info for embedding in capture metadata.
+     * Returns null for "normal" with no overrides (no filter applied).
+     */
+    private resolveFilmStyleInfo;
+    /**
+     * Get the minimum supported zoom factor.
+     * For virtual devices with ultra-wide, this is 1.0 (corresponds to 0.5x user-facing).
+     */
+    getMinZoom(): Promise<number>;
+    /**
+     * Get the maximum supported zoom factor (capped at 15x for UX).
+     */
+    getMaxZoom(): Promise<number>;
+    /**
+     * Get the zoom factors where the device switches between physical lenses.
+     * Returns empty array for single-camera devices.
+     * For triple camera: typically [2.0, 6.0] meaning:
+     * - Below 2.0: ultra-wide lens (0.5x-1x user-facing)
+     * - At 2.0: switches FROM ultra-wide TO wide lens (1x user-facing)
+     * - At 6.0: switches FROM wide TO telephoto lens (3x user-facing)
+     */
+    getSwitchOverZoomFactors(): Promise<number[]>;
+    /**
+     * Check if the current device has an ultra-wide camera.
+     * This is true for builtInTripleCamera and builtInDualWideCamera (iPhone 11+, Pro models).
+     * This is false for builtInDualCamera (Wide + Telephoto, e.g., iPhone X/XS) and single-lens devices.
+     *
+     * Use this to correctly interpret zoom factors:
+     * - If hasUltraWide: minZoom (1.0) = 0.5x user-facing, switchOverFactors[0] (2.0) = 1x user-facing
+     * - If !hasUltraWide: minZoom (1.0) = 1x user-facing, switchOverFactors[0] (2.0) = 2x user-facing (telephoto)
+     */
+    hasUltraWideCamera(): Promise<boolean>;
+    /**
+     * Get the supported exposure compensation range in EV units.
+     * Returns the device's min and max exposure target bias values.
+     * Use this to configure slider bounds for exposure UI controls.
+     */
+    getExposureRange(): Promise<{
+        min: number;
+        max: number;
+    }>;
+    /**
+     * Reset exposure compensation to neutral (0 EV).
+     * Convenience method equivalent to setting the exposure prop to 0.
+     */
+    resetExposure(): void;
+    /**
+     * Focus at a point in the preview. Also adjusts exposure point if supported.
+     * @param x Normalized x coordinate (0-1, left to right)
+     * @param y Normalized y coordinate (0-1, top to bottom)
+     */
+    focusAtPoint(x: number, y: number): void;
+    /**
+     * Set zoom with smooth animation. Recommended for pinch-to-zoom gestures.
+     * Uses native AVFoundation ramp for smooth transitions across lens switchover boundaries.
+     * This method bypasses React re-renders for lowest latency during continuous gestures.
+     * @param factor Device zoom factor (use getMinZoom/getMaxZoom for valid range)
+     */
+    setZoomAnimated(factor: number): void;
+    /**
+     * Get diagnostic info about the current camera device for debugging.
+     * Returns device type, supported zoom range, switching behavior, and more.
+     * Useful for debugging zoom issues on different device configurations.
+     */
+    getDeviceDiagnostics(): Promise<{
+        deviceType: string;
+        minZoom: number;
+        maxZoom: number;
+        currentZoom: number;
+        switchOverFactors: number[];
+        switchingBehavior: number;
+        isVirtualDevice: boolean;
+        currentExposureBias: number;
+        minExposureBias: number;
+        maxExposureBias: number;
+        currentISO: number;
+        exposureDuration: number;
+    }>;
+    /**
+     * Check if the current camera device supports depth data capture.
+     * Returns true for dual/triple rear cameras and TrueDepth front camera.
+     * Returns false for single rear cameras (iPhone SE, 16e, Air).
+     */
+    isDepthSupported(): Promise<boolean>;
+    /**
+     * Check if enabling depth would restrict zoom on this device.
+     * Returns true if zoom is limited to discrete levels (min == max in all ranges).
+     * This typically happens on dual-camera devices (iPhone 12-16 base).
+     * Returns false for triple-camera devices (Pro) and TrueDepth front cameras.
+     */
+    hasDepthZoomLimitations(): Promise<boolean>;
+    /**
+     * Get zoom ranges supported when depth data delivery is enabled.
+     * Returns array of [min, max] pairs. If min == max, it's a discrete level.
+     * Empty array means no depth support or no zoom restrictions.
+     *
+     * Example for dual-camera iPhone: [[2.0, 2.0], [4.0, 4.0]] (discrete 1x and 2x only)
+     * Example for triple-camera iPhone: [[1.0, 6.0]] (continuous zoom supported)
+     */
+    getDepthSupportedZoomRanges(): Promise<number[][]>;
+    /**
+     * Start recording a native video to a temporary `.mov` file.
+     *
+     * Promise resolves once the native recorder reports it has started.
+     *
+     * @param position Which camera to record from.
+     * @param options Optional recording configuration.
+     * @param options.maxDurationSeconds Maximum recording duration in seconds.
+     *   The native layer will automatically stop the recording when this limit is
+     *   reached. Pass 0 or omit for unlimited recording.
+     */
+    startVideoRecording(position?: "front" | "back", options?: {
+        maxDurationSeconds?: number;
+    }): Promise<StartNativeVideoRecordingResult>;
+    /**
+     * Stop the current native video recording and return the finalized file path + metadata.
+     */
+    stopVideoRecording(): Promise<StopNativeVideoRecordingResult>;
+    /**
+     * Capture a photo using the native Swift camera and return a signed `ZPhoto`.
+     *
+     * The native side is expected to expose a `capturePhoto` method on the
+     * `Zcam1Sdk` TurboModule with signature:
+     *
+     *   capturePhoto(options: {
+     *     position?: "front" | "back";
+     *     format?: "jpeg" | "dng";
+     *   }): Promise<{ path: string; metadata?: any }>
+     */
+    takePhoto(options?: TakePhotoOptions): Promise<ZPhoto>;
+    render(): React.ReactNode;
+}
+//# sourceMappingURL=camera.d.ts.map

package/lib/typescript/src/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../src/camera.tsx"],"names":[],"mappings":"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"}