@smileid/usesmileid 12.0.2 → 12.1.0

package/dist/presentation/screen/use_smile_id_capture_screen.js

@@ -1,640 +1 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
-import { Platform, StatusBar, StyleSheet, View, useWindowDimensions, } from "react-native";
-import { Camera, useCameraDevice, useCameraFormat, useCameraPermission, useFrameProcessor, VisionCameraProxy, } from "react-native-vision-camera";
-import { Worklets } from "react-native-worklets-core";
-import * as ImagePicker from "expo-image-picker";
-import { FrameProcessorPluginNotRegisteredException } from "@smileid/usesmileid_bridge";
-import { CaptureReadyEventKind, DocumentSide, UseSmileIDScanStateType, } from "@smileid/usesmileid_bridge";
-import { CaptureType } from "../../core/models/ml_config";
-import { resampleImportedDocument } from "../../camera/document_image_pipeline";
-import { defaultLightTheme } from "../theme/theme";
-import { UseSmileIDThemeProvider } from "../theme/theme_context";
-import { UseSmileIDCaptureContent, } from "../components/use_smile_id_capture_content";
-import { DEFAULT_DOCUMENT_ASPECT, documentGuideRect, } from "../components/use_smile_id_document_overlay";
-import { UseSmileIDCrashReporting } from "@smileid/usesmileid_bridge";
-import { ForceMaxBrightness } from "../utils/force_max_brightness";
-import { CameraDefaults } from "../../camera/camera_defaults";
-import { DocumentImageOrigin } from "../../metadata/document_image_origin";
-import { DeviceOrientationCollector } from "../../metadata/device_orientation_collector";
-import { useSmileIDFrameStream } from "../../camera/use_smile_id_frame_stream";
-import { orientationToDegrees } from "../../camera/orientation_degrees";
-import { isSessionBoundary, mapCaptureUiState, preCaptureUiState, } from "./helpers/capture_ui_state";
-import { useDebouncedFeedbackKey } from "./helpers/use_debounced_feedback_key";
-import { essTurnHaptic, triggerEssTurnHaptic, } from "./helpers/ess_turn_haptics";
-/**
- * Capture route — owns the camera session, frame streaming, analyzer
- * results, and effects; derives an immutable `UseSmileIDCaptureContentState`
- * per scan-state update and delegates rendering to the stateless
- * `UseSmileIDCaptureContent` (camera preview injected through its slot).
- *
- * Flow: Start → frame processor runs the native plugin per frame
- * (`useSmileIDFrameStream` validates results) → on `finished`, `flush()`
- * then `onCaptureComplete`; on `timeout`, `onCaptureTimeout`.
- */
-export function UseSmileIDCaptureScreen(props) {
-    const theme = props.theme ?? defaultLightTheme;
-    const showAttribution = props.showAttribution ?? true;
-    const enableEnhancedLiveness = props.enableEnhancedLiveness ?? false;
-    const allowAgentMode = props.allowAgentMode ?? false;
-    // Literal union — useCameraDevice takes the lowercase string directly.
-    const cameraFacing = props.captureType === CaptureType.selfie && !allowAgentMode
-        ? "front"
-        : "back";
-    const { hasPermission, requestPermission } = useCameraPermission();
-    const device = useCameraDevice(cameraFacing);
-    // Still-capture handle for the document manual shutter (`takePhoto()`).
-    const cameraRef = useRef(null);
-    // Pin an explicit format: the "highest supported" heuristic can pick 4K,
-    // stalling the frame-processor thread and stuttering the pipeline.
-    // Document capture uses 16:9 so the analysis FOV matches the visible 16:9
-    // preview — keeping the guide-rectangle crop aligned with the framed document
-    // (mirrors the native Android SDK's RATIO_16_9 + 1280×720 pin). Selfie keeps
-    // 4:3: the face geometry + smile heuristic are calibrated on 4:3, and 16:9
-    // skews normalized landmark ratios and shifts every threshold.
-    const isDocumentFormat = props.captureType === CaptureType.document;
-    const format = useCameraFormat(device, [
-        { videoAspectRatio: isDocumentFormat ? 16 / 9 : 4 / 3 },
-        {
-            videoResolution: isDocumentFormat
-                ? {
-                    width: CameraDefaults.documentAnalysisResolution.width,
-                    height: CameraDefaults.documentAnalysisResolution.height,
-                }
-                : {
-                    width: CameraDefaults.analysisTargetResolution.width,
-                    height: CameraDefaults.analysisTargetResolution.height,
-                },
-        },
-        { fps: CameraDefaults.analysisTargetFps },
-    ]);
-    const requestedRef = useRef(false);
-    useEffect(() => {
-        if (!hasPermission && !requestedRef.current) {
-            requestedRef.current = true;
-            void requestPermission();
-        }
-    }, [hasPermission, requestPermission]);
-    // Per-frame scan state drives the overlay + feedback bubble.
-    const [scanState, setScanState] = useState({
-        type: UseSmileIDScanStateType.Initial,
-    });
-    const [streaming, setStreaming] = useState(false);
-    // Bumped on every Start tap to reset the feedback debouncer.
-    const [sessionEpoch, setSessionEpoch] = useState(0);
-    // Overlay stays IDLE (gray) until the first analyzed frame — eagerly
-    // forcing INSTRUCTION here causes a green flash.
-    const [hasAnalyzedFrame, setHasAnalyzedFrame] = useState(false);
-    // Fallback shutter, revealed after activateManualAfterMs. Resets per mount.
-    const [manualShutterRevealed, setManualShutterRevealed] = useState(false);
-    // Set when a document scan times out, so the recovery controls stay on screen
-    // after the scan (and `streaming`) stops. `timedOutRef` keeps the terminal
-    // branch idempotent without latching the one-shot delivery gate.
-    const [captureTimedOut, setCaptureTimedOut] = useState(false);
-    const timedOutRef = useRef(false);
-    // Set when streaming produced no analyzed frame at all, which the analyzer's own timeout cannot report.
-    const [captureStalled, setCaptureStalled] = useState(false);
-    // True while a manual/gallery delivery is in flight — disables the controls.
-    const [deliveringDocument, setDeliveringDocument] = useState(false);
-    // Transient gallery-import error; overrides the live chip, self-clears so the user can re-pick.
-    const [galleryErrorKey, setGalleryErrorKey] = useState(null);
-    useEffect(() => {
-        if (galleryErrorKey === null)
-            return;
-        const timer = setTimeout(() => setGalleryErrorKey(null), 3000);
-        return () => clearTimeout(timer);
-    }, [galleryErrorKey]);
-    // Accumulate events across frames in a ref (not state) so an event
-    // arrival never triggers a re-render; the final onCaptureComplete
-    // payload then carries every event the session emitted.
-    const capturedEventsRef = useRef([]);
-    // Exactly-once latch: a frame can land while flush() is in flight, so
-    // this keeps flush()/onCaptureComplete from firing twice per session.
-    const completedRef = useRef(false);
-    // Raw (not committed) frame state for the session-boundary check, so
-    // transitions the 1% bucketing skips committing are still seen.
-    const previousScanStateRef = useRef(null);
-    // Capture telemetry: wall-clock start (first analyzed frame) and a
-    // rising-edge `unsatisfied` retry counter, surfaced via onCaptureComplete.
-    const captureStartedAtRef = useRef(null);
-    const captureRetriesRef = useRef(0);
-    const wasUnsatisfiedRef = useRef(false);
-    // Accelerometer sampler for device_positions / device_movement_detected, run only
-    // while the live capture loop is streaming.
-    const deviceOrientationRef = useRef(new DeviceOrientationCollector());
-    const captureTelemetry = useCallback(() => ({
-        durationMs: captureStartedAtRef.current === null
-            ? 0
-            : Date.now() - captureStartedAtRef.current,
-        retries: captureRetriesRef.current,
-        devicePositions: deviceOrientationRef.current.devicePositions,
-        deviceMovementDetected: deviceOrientationRef.current.deviceMovementDetected,
-        // Omit (not set to undefined) when unresolved — exactOptionalPropertyTypes.
-        ...(device?.id !== undefined ? { cameraName: device.id } : {}),
-    }), [device]);
-    const onStartCapture = props.onStartCapture;
-    const handleStart = useCallback(() => {
-        if (streaming || completedRef.current)
-            return;
-        onStartCapture?.();
-        setSessionEpoch((epoch) => epoch + 1);
-        // A new session must not compare against the old session's last state.
-        previousScanStateRef.current = null;
-        // Clear the terminal latches so a retry after a timeout or a stall is a fresh session.
-        const wasTerminal = timedOutRef.current;
-        timedOutRef.current = false;
-        setCaptureTimedOut(false);
-        setCaptureStalled(false);
-        setScanState({ type: UseSmileIDScanStateType.Initial });
-        setHasAnalyzedFrame(false);
-        // Frames banked before the abandoned session must not pad this one.
-        capturedEventsRef.current = [];
-        if (wasTerminal) {
-            // A timed-out native session is terminal — stream only after it resets,
-            // or the first retry frame re-reports Timeout and re-latches the error.
-            void props.analyzer
-                .reset()
-                .catch((error) => UseSmileIDCrashReporting.captureException(error))
-                .finally(() => {
-                if (!completedRef.current)
-                    setStreaming(true);
-            });
-        }
-        else {
-            setStreaming(true);
-        }
-    }, [streaming, onStartCapture, props.analyzer]);
-    const analyzer = props.analyzer;
-    const onCaptureComplete = props.onCaptureComplete;
-    const onDocumentOrigin = props.onDocumentOrigin;
-    const onCaptureTimeout = props.onCaptureTimeout;
-    const captureMode = props.captureMode;
-    const allowGalleryUpload = props.allowGalleryUpload ?? false;
-    const documentSide = props.documentSide ?? DocumentSide.Front;
-    const isDocumentCapture = props.captureType === CaptureType.document;
-    // Reset capture telemetry per side so each document side reports its own
-    // duration / retries (the screen instance is reused across the front→back flip).
-    useEffect(() => {
-        captureStartedAtRef.current = null;
-        captureRetriesRef.current = 0;
-        wasUnsatisfiedRef.current = false;
-    }, [documentSide]);
-    // Sample the accelerometer only while the live capture loop streams. start()
-    // clears prior samples, so a retry / side switch begins fresh; cleanup stops it.
-    useEffect(() => {
-        if (streaming) {
-            deviceOrientationRef.current.start();
-        }
-        return () => deviceOrientationRef.current.stop();
-    }, [streaming]);
-    // Reveal the fallback shutter after the delay once streaming begins.
-    // Bound to `streaming`: any capture clears it, tearing this effect down
-    // and clearing the timer, so it can't fire post-capture or leak.
-    const fallbackDelayMs = captureMode?.kind === "autoCaptureWithManualFallback"
-        ? captureMode.activateManualAfterMs
-        : null;
-    useEffect(() => {
-        if (!streaming || fallbackDelayMs === null)
-            return;
-        const timer = setTimeout(() => {
-            setManualShutterRevealed(true);
-        }, fallbackDelayMs);
-        return () => clearTimeout(timer);
-    }, [streaming, fallbackDelayMs]);
-    // Manual shutter: capture a still and deliver via the SAME
-    // onCaptureComplete path as auto-capture. completedRef is claimed before
-    // the async work so a concurrent auto-capture is dropped — exactly one delivery.
-    const handleManualShutter = useCallback(() => {
-        if (completedRef.current)
-            return;
-        const camera = cameraRef.current;
-        if (camera === null)
-            return;
-        completedRef.current = true;
-        setStreaming(false);
-        setDeliveringDocument(true);
-        void (async () => {
-            try {
-                const photo = await camera.takePhoto();
-                const sourceUri = photo.path.startsWith("file://")
-                    ? photo.path
-                    : `file://${photo.path}`;
-                const processedUri = await resampleImportedDocument({ uri: sourceUri, width: photo.width, height: photo.height }, documentSide);
-                onDocumentOrigin?.(DocumentImageOrigin.CameraManualCapture);
-                onCaptureComplete?.([
-                    {
-                        kind: CaptureReadyEventKind.Document,
-                        captureIndex: 0,
-                        url: processedUri,
-                    },
-                ], captureTelemetry());
-            }
-            catch (error) {
-                UseSmileIDCrashReporting.captureException(error instanceof Error ? error : new Error(String(error)));
-                // Release the gate so the user can retry, and resume auto-capture.
-                completedRef.current = false;
-                setDeliveringDocument(false);
-                setStreaming(true);
-            }
-        })();
-    }, [onCaptureComplete, onDocumentOrigin, documentSide]);
-    // Gallery upload: pause auto-capture while the picker is open (so it can't
-    // settle behind the modal), import via the same resample + delivery path.
-    // Cancel / permission-denial resumes auto-capture.
-    const handleGalleryPick = useCallback(() => {
-        if (completedRef.current)
-            return;
-        setStreaming(false);
-        setDeliveringDocument(true);
-        void (async () => {
-            try {
-                const permission = await ImagePicker.requestMediaLibraryPermissionsAsync();
-                if (!permission.granted) {
-                    setDeliveringDocument(false);
-                    // Don't resume if a concurrent auto-capture already claimed delivery.
-                    if (!completedRef.current)
-                        setStreaming(true);
-                    return;
-                }
-                const result = await ImagePicker.launchImageLibraryAsync({
-                    mediaTypes: ["images"],
-                    allowsMultipleSelection: false,
-                    quality: 1,
-                });
-                const asset = result.canceled ? undefined : result.assets[0];
-                if (asset === undefined) {
-                    setDeliveringDocument(false);
-                    // Don't resume if a concurrent auto-capture already claimed delivery.
-                    if (!completedRef.current)
-                        setStreaming(true);
-                    return;
-                }
-                // Reject too-small images before claiming the latch — upscaling them
-                // yields unreadable documents. Show a chip and resume auto-capture.
-                if (asset.width !== undefined &&
-                    asset.height !== undefined &&
-                    Math.min(asset.width, asset.height) <
-                        CameraDefaults.minGalleryDocumentDimensionPx) {
-                    setGalleryErrorKey("si_document_gallery_image_too_small");
-                    setDeliveringDocument(false);
-                    // Don't resume if a concurrent auto-capture already claimed delivery.
-                    if (!completedRef.current)
-                        setStreaming(true);
-                    return;
-                }
-                if (completedRef.current)
-                    return; // auto-capture won the race
-                completedRef.current = true;
-                const processedUri = await resampleImportedDocument({ uri: asset.uri, width: asset.width, height: asset.height }, documentSide);
-                onDocumentOrigin?.(DocumentImageOrigin.Gallery);
-                onCaptureComplete?.([
-                    {
-                        kind: CaptureReadyEventKind.Document,
-                        captureIndex: 0,
-                        url: processedUri,
-                    },
-                ], captureTelemetry());
-            }
-            catch (error) {
-                UseSmileIDCrashReporting.captureException(error instanceof Error ? error : new Error(String(error)));
-                setGalleryErrorKey("si_document_gallery_image_failed");
-                completedRef.current = false;
-                setDeliveringDocument(false);
-                setStreaming(true);
-            }
-        })();
-    }, [onCaptureComplete, onDocumentOrigin, documentSide]);
-    // Auto-start document capture (document idle has no Start button; selfie
-    // keeps its). Fires once per mount, so each side / retake auto-starts.
-    const autoStartedRef = useRef(false);
-    // Latest-ref so a new `handleStart` identity (it depends on `streaming`)
-    // doesn't re-run this effect; auto-start fires once per mount.
-    const handleStartRef = useRef(handleStart);
-    handleStartRef.current = handleStart;
-    useEffect(() => {
-        if (!isDocumentCapture || autoStartedRef.current || completedRef.current) {
-            return;
-        }
-        autoStartedRef.current = true;
-        handleStartRef.current();
-    }, [isDocumentCapture]);
-    // useSmileIDFrameStream overloads on FaceAnalyzer vs DocumentAnalyzer;
-    // the cast routes through the FaceAnalyzer overload — sound because the
-    // DocumentAnalyzer shape produces an identical wire surface, and the
-    // runtime pairing is guaranteed by captureType.
-    const frameStream = useSmileIDFrameStream((streaming ? analyzer : null), (result) => {
-        // A session boundary resets the debouncer so suppressed guidance can re-surface.
-        const previousScanState = previousScanStateRef.current;
-        if (previousScanState !== null &&
-            isSessionBoundary(previousScanState, result.state)) {
-            setSessionEpoch((epoch) => epoch + 1);
-        }
-        // Haptic on a completed head turn (light between, success on the
-        // final, never on reset). Driven off the raw per-frame transition
-        // so 1% bucketing can't drop it; fired imperatively (no re-render).
-        if (previousScanState !== null) {
-            const haptic = essTurnHaptic(previousScanState, result.state);
-            if (haptic !== null)
-                triggerEssTurnHaptic(haptic);
-        }
-        previousScanStateRef.current = result.state;
-        // Unsatisfied = native session reset; drop accumulated events so it
-        // can't leak stale liveness frames. `else` so a reset frame can't
-        // re-add its own stale events on the same pass.
-        // Capture telemetry: anchor the start clock on the first analyzed frame,
-        // and count rising edges of `unsatisfied` as retries.
-        if (captureStartedAtRef.current === null) {
-            captureStartedAtRef.current = Date.now();
-        }
-        const isUnsatisfied = result.state.type === UseSmileIDScanStateType.Unsatisfied;
-        if (isUnsatisfied && !wasUnsatisfiedRef.current) {
-            captureRetriesRef.current += 1;
-        }
-        wasUnsatisfiedRef.current = isUnsatisfied;
-        if (result.state.type === UseSmileIDScanStateType.Unsatisfied) {
-            capturedEventsRef.current = [];
-        }
-        else if (result.capturedEvents.length > 0) {
-            capturedEventsRef.current = [
-                ...capturedEventsRef.current,
-                ...result.capturedEvents,
-            ];
-        }
-        // Camera-rate results are mostly identical — commit only
-        // render-relevant changes, progress bucketed to 1% for smooth fill.
-        setScanState((previous) => previous.type === result.state.type &&
-            previous.feedback === result.state.feedback &&
-            previous.reason === result.state.reason &&
-            previous.currentDirection === result.state.currentDirection &&
-            (previous.poseMatched ?? false) ===
-                (result.state.poseMatched ?? false) &&
-            Math.round((previous.captureProgress ?? 0) * 100) ===
-                Math.round((result.state.captureProgress ?? 0) * 100)
-            ? previous
-            : result.state);
-        setHasAnalyzedFrame(true);
-        // Terminal states: finished → flush + complete; timeout → failure
-        // without flushing (no captured artifacts to wait on).
-        if (result.state.type === UseSmileIDScanStateType.Finished) {
-            // `timedOutRef` too: stopping the stream is async, so a frame queued before the timeout can still land here.
-            if (completedRef.current || timedOutRef.current)
-                return;
-            completedRef.current = true;
-            setStreaming(false);
-            // flush() waits for every emitted JPG to land on disk before we
-            // hand URLs to the partner, so onCaptureComplete never returns a
-            // partial-write path.
-            void analyzer
-                .flush()
-                .catch((error) => {
-                UseSmileIDCrashReporting.captureException(error);
-            })
-                .finally(() => {
-                // No-op for selfie (callback unset).
-                onDocumentOrigin?.(DocumentImageOrigin.CameraAutoCapture);
-                onCaptureComplete?.(capturedEventsRef.current, captureTelemetry());
-            });
-        }
-        else if (result.state.type === UseSmileIDScanStateType.Timeout) {
-            if (completedRef.current || timedOutRef.current)
-                return;
-            setStreaming(false);
-            // The terminal state rides on `timedOutRef`, not the one-shot delivery gate, so the shutter and Start button stay usable.
-            timedOutRef.current = true;
-            setCaptureTimedOut(true);
-            onCaptureTimeout?.(result.state);
-        }
-    }, {
-        onError: (error) => {
-            // Native analyzer errors (model load, decode). Reported, but not
-            // terminal — the next frame is still attempted.
-            UseSmileIDCrashReporting.captureException(error);
-        },
-    });
-    const uiState = hasAnalyzedFrame
-        ? mapCaptureUiState(scanState, props.captureType, enableEnhancedLiveness)
-        : preCaptureUiState(props.captureType, enableEnhancedLiveness);
-    // Only the guidance copy is debounced; rim, fill, and direction stay real-time.
-    const settledFeedbackKey = useDebouncedFeedbackKey(uiState.feedbackKey, sessionEpoch);
-    const isInstructionState = scanState.type === UseSmileIDScanStateType.Initial && !streaming;
-    // A selfie timeout leaves `scanState` on Timeout, so the instruction predicate alone would hide the only way to retry.
-    const showStartButton = (isInstructionState || captureTimedOut) && !isDocumentCapture;
-    const canStart = !streaming && !completedRef.current;
-    const previewReady = hasPermission && device != null;
-    // Resolve the native frame processor plugin once per name.
-    const plugin = useMemo(() => VisionCameraProxy.initFrameProcessorPlugin(analyzer.frameProcessorPluginName, {}) ?? null, [analyzer.frameProcessorPluginName]);
-    // Every terminal signal arrives inside a frame result, so a camera that delivers no frame at all would sit on the initial state forever.
-    // Latest-ref, not a dep: an inline `onCaptureTimeout` prop is a fresh identity every render, which would restart the wall clock.
-    const onCaptureTimeoutRef = useRef(onCaptureTimeout);
-    onCaptureTimeoutRef.current = onCaptureTimeout;
-    useEffect(() => {
-        if (!streaming || hasAnalyzedFrame)
-            return;
-        const timer = setTimeout(() => {
-            if (completedRef.current || timedOutRef.current)
-                return;
-            timedOutRef.current = true;
-            setCaptureStalled(true);
-            setCaptureTimedOut(true);
-            setStreaming(false);
-            onCaptureTimeoutRef.current?.({ type: UseSmileIDScanStateType.Timeout });
-        }, CameraDefaults.firstFrameTimeoutMs);
-        return () => clearTimeout(timer);
-    }, [streaming, hasAnalyzedFrame]);
-    // A frame disproves the stall; document capture has no Start button to clear it by hand.
-    useEffect(() => {
-        if (hasAnalyzedFrame)
-            setCaptureStalled(false);
-    }, [hasAnalyzedFrame]);
-    // A missing plugin means no frame ever produces a result — report once
-    // on capture start rather than sitting silently on the initial state.
-    const pluginErrorReportedRef = useRef(false);
-    useEffect(() => {
-        if (!streaming || plugin !== null || pluginErrorReportedRef.current) {
-            return;
-        }
-        pluginErrorReportedRef.current = true;
-        UseSmileIDCrashReporting.captureException(new FrameProcessorPluginNotRegisteredException({
-            pluginName: analyzer.frameProcessorPluginName,
-        }));
-    }, [streaming, plugin, analyzer.frameProcessorPluginName]);
-    // Posts results to JS without blocking the worklet. Backpressure is
-    // native: the plugin blocks the frame-processor thread per scan, so
-    // mid-scan frames are dropped before reaching JS.
-    const onFrameResult = frameStream.onFrameResult;
-    const onFrameResultRunOnJS = useMemo(() => {
-        return Worklets.createRunOnJS((rawResult) => {
-            onFrameResult(rawResult);
-        });
-    }, [onFrameResult]);
-    // Physical device tilt (0 = portrait) for the native upright validator /
-    // head-pose math; gravity-sourced, never from `frame.orientation`.
-    const [deviceOrientationDegrees, setDeviceOrientationDegrees] = useState(0);
-    // Locked INTERFACE orientation (0/90/270) — the axis the preview and guide are
-    // drawn against, from VisionCamera's preview orientation, NOT device gravity
-    // (the document screen locks the interface while the phone is held flat, so
-    // gravity disagrees). iOS uprights the saved document to this axis.
-    const [previewOrientationDegrees, setPreviewOrientationDegrees] = useState(0);
-    // VisionCamera derives its iOS preview orientation from the interface
-    // orientation but only refreshes it on a PHYSICAL rotation — a programmatic
-    // lock (the document landscape lock) never fires that, so the preview stays
-    // portrait in the rotated UI. Remounting <Camera> when the interface flips
-    // forces a re-read. iOS only — Android's preview already tracks the lock.
-    const { width: windowWidth, height: windowHeight } = useWindowDimensions();
-    const cameraOrientationKey = Platform.OS === "ios"
-        ? windowWidth > windowHeight
-            ? "landscape"
-            : "portrait"
-        : "camera";
-    // Camera viewport size, reported by the capture content on layout. Drives the
-    // document crop region so the saved capture matches the on-screen frame.
-    const [viewport, setViewport] = useState({ width: 0, height: 0 });
-    const handleViewportLayout = useCallback((size) => {
-        setViewport((previous) => previous.width === size.width && previous.height === size.height
-            ? previous
-            : size);
-    }, []);
-    // The document guide rectangle as a native crop region — viewport fractions +
-    // size + cover scale — derived from the SAME geometry the overlay draws
-    // (documentGuideRect), so the native side crops the saved document to exactly
-    // the framed rectangle. undefined for selfie or before the viewport is known.
-    const documentCropRegion = useMemo(() => {
-        if (!isDocumentCapture || viewport.width <= 0 || viewport.height <= 0) {
-            return undefined;
-        }
-        const aspect = props.knownIdAspectRatio ?? DEFAULT_DOCUMENT_ASPECT;
-        const rect = documentGuideRect(aspect, viewport.width, viewport.height);
-        return {
-            left: rect.left / viewport.width,
-            top: rect.top / viewport.height,
-            width: rect.width / viewport.width,
-            height: rect.height / viewport.height,
-            viewportWidthPx: Math.round(viewport.width),
-            viewportHeightPx: Math.round(viewport.height),
-        };
-    }, [isDocumentCapture, viewport, props.knownIdAspectRatio]);
-    const frameProcessor = useFrameProcessor((frame) => {
-        "worklet";
-        if (!plugin)
-            return;
-        // Crop region passed as FLAT numeric args — frame-processor arguments
-        // don't reliably accept nested objects. cropWidth <= 0 signals "no region"
-        // (selfie, or before the viewport is measured), leaving it uncropped.
-        //
-        // The saved document uprights to the LOCKED INTERFACE axis (what the
-        // preview and guide are drawn against), never device gravity (the phone is
-        // held flat): iOS uprights to `viewportOrientation`, Android via its
-        // display-tracking `rotationDegrees`. `rotation` stays the RAW gravity
-        // tilt the native upright validator needs.
-        const rawResult = plugin.call(frame, {
-            rotation: deviceOrientationDegrees,
-            viewportOrientation: previewOrientationDegrees,
-            cropLeft: documentCropRegion ? documentCropRegion.left : 0,
-            cropTop: documentCropRegion ? documentCropRegion.top : 0,
-            cropWidth: documentCropRegion ? documentCropRegion.width : 0,
-            cropHeight: documentCropRegion ? documentCropRegion.height : 0,
-            cropViewportWidth: documentCropRegion
-                ? documentCropRegion.viewportWidthPx
-                : 0,
-            cropViewportHeight: documentCropRegion
-                ? documentCropRegion.viewportHeightPx
-                : 0,
-        });
-        onFrameResultRunOnJS(rawResult);
-    }, [
-        plugin,
-        onFrameResultRunOnJS,
-        deviceOrientationDegrees,
-        previewOrientationDegrees,
-        documentCropRegion,
-    ]);
-    // Document controls — live capture only (after Start). Manual shutter
-    // follows the capture mode + fallback timer; gallery follows
-    // allowGalleryUpload. Renderer also hides both during CAPTURING/PROCESSING.
-    // A timeout offers the shutter in every capture mode — it is the recovery
-    // affordance, so it outranks `captureMode` and survives `streaming` going
-    // false with the scan.
-    const manualShutterAvailable = isDocumentCapture &&
-        (captureTimedOut ||
-            (streaming &&
-                (captureMode?.kind === "manualCapture" ||
-                    (captureMode?.kind === "autoCaptureWithManualFallback" &&
-                        manualShutterRevealed))));
-    const galleryAvailable = isDocumentCapture && (streaming || captureTimedOut) && allowGalleryUpload;
-    // Deps are scalar fields (mapCaptureUiState returns a fresh object per
-    // render). captureProgress intentionally stays a separate per-frame prop.
-    const contentState = useMemo(() => ({
-        captureType: props.captureType,
-        overlayState: uiState.overlayState,
-        enableEnhancedLiveness,
-        animationDirection: uiState.animationDirection,
-        poseMatched: uiState.poseMatched,
-        // A stalled camera, then a transient gallery-import error, preempt the live feedback chip.
-        feedbackKey: captureStalled
-            ? "si_capture_camera_unavailable"
-            : (galleryErrorKey ?? settledFeedbackKey),
-        // Documents auto-start (no Start button); selfie keeps its.
-        showCaptureButton: showStartButton,
-        showManualShutter: manualShutterAvailable,
-        showGalleryUpload: galleryAvailable,
-        isBackSide: documentSide === DocumentSide.Back,
-        ...(props.knownIdAspectRatio !== undefined
-            ? { knownIdAspectRatio: props.knownIdAspectRatio }
-            : {}),
-        ...(props.documentTypeKind !== undefined
-            ? { documentTypeKind: props.documentTypeKind }
-            : {}),
-    }), [
-        props.captureType,
-        uiState.overlayState,
-        enableEnhancedLiveness,
-        uiState.animationDirection,
-        uiState.poseMatched,
-        settledFeedbackKey,
-        galleryErrorKey,
-        captureStalled,
-        showStartButton,
-        isDocumentCapture,
-        manualShutterAvailable,
-        galleryAvailable,
-        documentSide,
-        props.knownIdAspectRatio,
-        props.documentTypeKind,
-    ]);
-    // Stable element so the camera tree survives unrelated state updates.
-    const cameraPreview = useMemo(() => (_jsxs(_Fragment, { children: [_jsx(ForceMaxBrightness, {}), previewReady ? (_jsx(Camera, { ref: cameraRef, style: StyleSheet.absoluteFill, device: device, isActive: true, ...(format ? { format } : {}), ...(props.captureType === CaptureType.document
-                    ? { photo: true }
-                    : {}), 
-                // Gravity-based — keeps reporting tilt even when UI orientation is locked to portrait.
-                outputOrientation: "device", onOutputOrientationChanged: (orientation) => {
-                    setDeviceOrientationDegrees(orientationToDegrees(orientation));
-                }, 
-                // The LOCKED interface orientation (follows the screen even under a
-                // programmatic lock) — the axis the saved document uprights to.
-                onPreviewOrientationChanged: (orientation) => {
-                    setPreviewOrientationDegrees(orientationToDegrees(orientation));
-                }, ...(streaming ? { frameProcessor } : {}), testID: "si_capture_camera_preview" }, cameraOrientationKey)) : (_jsx(View, { style: [
-                    StyleSheet.absoluteFill,
-                    { backgroundColor: theme.colors.offBlack },
-                ], testID: "si_capture_camera_placeholder" }))] })), 
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- setDeviceOrientationDegrees is a state setter (stable)
-    [
-        props.captureType,
-        previewReady,
-        device,
-        format,
-        streaming,
-        frameProcessor,
-        theme.colors.offBlack,
-        cameraOrientationKey,
-    ]);
-    return (_jsxs(UseSmileIDThemeProvider, { value: theme, children: [_jsx(StatusBar, { translucent: true, backgroundColor: "transparent", barStyle: "dark-content" }), _jsx(UseSmileIDCaptureContent, { state: contentState, captureProgress: uiState.captureProgress, cameraPreview: cameraPreview, onStartCapture: handleStart, startCaptureEnabled: canStart, onBack: props.onBack, showAttribution: showAttribution, startButton: props.startButton, onViewportLayout: handleViewportLayout, ...(isDocumentCapture
-                    ? {
-                        onManualShutter: handleManualShutter,
-                        onGalleryUpload: handleGalleryPick,
-                        documentControlsEnabled: !deliveringDocument,
-                        ...(props.onClose ? { onClose: props.onClose } : {}),
-                    }
-                    : {}), theme: theme })] }));
-}
-//# sourceMappingURL=use_smile_id_capture_screen.js.map
+"use strict";import{jsx as I,Fragment as Ge,jsxs as Se}from"react/jsx-runtime";import{useCallback as R,useEffect as d,useMemo as K,useRef as u,useState as f}from"react";import{StatusBar as We,StyleSheet as ge,View as He}from"react-native";import*as we from"expo-image-picker";import{CaptureReadyEventKind as Ce,DocumentSide as Te,UseSmileIDScanStateType as y}from"@smileid/usesmileid_bridge";import{CaptureType as De}from"../../core/models/ml_config";import{resampleImportedDocument as ve}from"../../camera/document_image_pipeline";import{defaultLightTheme as Ve}from"../theme/theme";import{UseSmileIDThemeProvider as ze}from"../theme/theme_context";import{UseSmileIDCaptureContent as je}from"../components/use_smile_id_capture_content";import{DEFAULT_DOCUMENT_ASPECT as qe,documentGuideRect as Ne}from"../components/use_smile_id_document_overlay";import{UseSmileIDCrashReporting as C}from"@smileid/usesmileid_bridge";import{ForceMaxBrightness as Ye}from"../utils/force_max_brightness";import{CameraDefaults as ke}from"../../camera/camera_defaults";import{DocumentImageOrigin as J}from"../../metadata/document_image_origin";import{DeviceOrientationCollector as $e}from"../../metadata/device_orientation_collector";import{useSmileIDFrameStream as Je}from"../../camera/use_smile_id_frame_stream";import{CameraLens as B}from"../../camera/camera_lens";import{UseSmileIDKameraCameraSystem as Qe}from"../../camera/use_smile_id_kamera_camera_system";import{UseSmileIDKameraPreview as Xe}from"../../camera/use_smile_id_kamera_preview";import{useDeviceTiltDegrees as Ze,useLockedInterfaceOrientationDegrees as et}from"../../camera/use_kamera_orientation";import{useKameraCameraPermission as tt}from"../../camera/use_kamera_camera_permission";import{isTerminalKameraError as rt}from"../../camera/kamera_error_mapping";import{isSessionBoundary as nt,mapCaptureUiState as at,preCaptureUiState as it}from"./helpers/capture_ui_state";import{useDebouncedFeedbackKey as ot}from"./helpers/use_debounced_feedback_key";import{essTurnHaptic as ct,triggerEssTurnHaptic as st}from"./helpers/ess_turn_haptics";const ut=33;export function UseSmileIDCaptureScreen(t){const A=t.theme??Ve,Ee=t.showAttribution??!0,_=t.enableEnhancedLiveness??!1,Me=t.allowAgentMode??!1,L=t.captureType===De.selfie&&!Me?"front":"back",{hasPermission:T,requestPermission:Q}=tt(),h=K(()=>new Qe(L==="front"?B.front:B.back,t.createCameraSession),[]),X=u(!1);d(()=>{!T&&!X.current&&(X.current=!0,Q())},[T,Q]);const Z=t.onCameraError;d(()=>{if(!T)return;const e=h.addEventListener(r=>{r.type==="error"&&rt(r.code)&&Z?.(r.code,r.message)});return h.configure({captureType:t.captureType,lens:L==="front"?B.front:B.back}),h.start().catch(r=>{C.captureException(r instanceof Error?r:new Error(String(r)))}),()=>{e(),h.release()}},[T,h,L,t.captureType,Z]);const[ee,te]=f({type:y.Initial}),[i,s]=f(!1),[be,re]=f(0),[D,ne]=f(!1),[Ie,Re]=f(!1),[O,G]=f(!1),S=u(!1),[ae,W]=f(!1),[Ae,g]=f(!1),[P,H]=f(null);d(()=>{if(P===null)return;const e=setTimeout(()=>H(null),3e3);return()=>clearTimeout(e)},[P]);const v=u([]),n=u(!1),V=u(null),k=u(null),z=u(0),j=u(!1),F=u(new $e),q=R(()=>({durationMs:k.current===null?0:Date.now()-k.current,retries:z.current,devicePositions:F.current.devicePositions,deviceMovementDetected:F.current.deviceMovementDetected}),[]),ie=t.onStartCapture,N=R(()=>{if(i||n.current)return;ie?.(),re(r=>r+1),V.current=null;const e=S.current;S.current=!1,G(!1),W(!1),te({type:y.Initial}),ne(!1),v.current=[],e?t.analyzer.reset().catch(r=>C.captureException(r)).finally(()=>{n.current||s(!0)}):s(!0)},[i,ie,t.analyzer]),U=t.analyzer,E=t.onCaptureComplete,M=t.onDocumentOrigin,Y=t.onCaptureTimeout,x=t.captureMode,_e=t.allowGalleryUpload??!1,w=t.documentSide??Te.Front,m=t.captureType===De.document;d(()=>{k.current=null,z.current=0,j.current=!1},[w]),d(()=>(i&&F.current.start(),()=>F.current.stop()),[i]);const $=x?.kind==="autoCaptureWithManualFallback"?x.activateManualAfterMs:null;d(()=>{if(!i||$===null)return;const e=setTimeout(()=>{Re(!0)},$);return()=>clearTimeout(e)},[i,$]);const Pe=R(()=>{n.current||(n.current=!0,s(!1),g(!0),(async()=>{try{const e=await h.capture(),r=e.filePath.startsWith("file://")?e.filePath:`file://${e.filePath}`,o=await ve({uri:r,width:e.width,height:e.height},w);M?.(J.CameraManualCapture),E?.([{kind:Ce.Document,captureIndex:0,url:o}],q())}catch(e){C.captureException(e instanceof Error?e:new Error(String(e))),n.current=!1,g(!1),s(!0)}})())},[E,M,w]),Fe=R(()=>{n.current||(s(!1),g(!0),(async()=>{try{if(!(await we.requestMediaLibraryPermissionsAsync()).granted){g(!1),n.current||s(!0);return}const r=await we.launchImageLibraryAsync({mediaTypes:["images"],allowsMultipleSelection:!1,quality:1}),o=r.canceled?void 0:r.assets[0];if(o===void 0){g(!1),n.current||s(!0);return}if(o.width!==void 0&&o.height!==void 0&&Math.min(o.width,o.height)<ke.minGalleryDocumentDimensionPx){H("si_document_gallery_image_too_small"),g(!1),n.current||s(!0);return}if(n.current)return;n.current=!0;const a=await ve({uri:o.uri,width:o.width,height:o.height},w);M?.(J.Gallery),E?.([{kind:Ce.Document,captureIndex:0,url:a}],q())}catch(e){C.captureException(e instanceof Error?e:new Error(String(e))),H("si_document_gallery_image_failed"),n.current=!1,g(!1),s(!0)}})())},[E,M,w]),oe=u(!1),ce=u(N);ce.current=N,d(()=>{!m||oe.current||n.current||(oe.current=!0,ce.current())},[m]);const Ue=Je(i?U:null,e=>{const r=V.current;if(r!==null&&nt(r,e.state)&&re(a=>a+1),r!==null){const a=ct(r,e.state);a!==null&&st(a)}V.current=e.state,k.current===null&&(k.current=Date.now());const o=e.state.type===y.Unsatisfied;if(o&&!j.current&&(z.current+=1),j.current=o,e.state.type===y.Unsatisfied?v.current=[]:e.capturedEvents.length>0&&(v.current=[...v.current,...e.capturedEvents]),te(a=>a.type===e.state.type&&a.feedback===e.state.feedback&&a.reason===e.state.reason&&a.currentDirection===e.state.currentDirection&&(a.poseMatched??!1)===(e.state.poseMatched??!1)&&Math.round((a.captureProgress??0)*100)===Math.round((e.state.captureProgress??0)*100)?a:e.state),ne(!0),e.state.type===y.Finished){if(n.current||S.current)return;n.current=!0,s(!1),U.flush().catch(a=>{C.captureException(a)}).finally(()=>{M?.(J.CameraAutoCapture),E?.(v.current,q())})}else if(e.state.type===y.Timeout){if(n.current||S.current)return;s(!1),S.current=!0,G(!0),Y?.(e.state)}},{onError:e=>{C.captureException(e)}}),p=D?at(ee,t.captureType,_):it(t.captureType,_),se=ot(p.feedbackKey,be),ue=(ee.type===y.Initial&&!i||O)&&!m,xe=!i&&!n.current,le=T,me=u(Y);me.current=Y,d(()=>{if(!i||D)return;const e=setTimeout(()=>{n.current||S.current||(S.current=!0,W(!0),G(!0),s(!1),me.current?.({type:y.Timeout}))},ke.firstFrameTimeoutMs);return()=>clearTimeout(e)},[i,D]),d(()=>{D&&W(!1)},[D]);const de=Ue.onFrameResult,fe=Ze({retainWhenFlat:m}),he=et(),[l,Ke]=f({width:0,height:0}),Be=R(e=>{Ke(r=>r.width===e.width&&r.height===e.height?r:e)},[]),c=K(()=>{if(!m||l.width<=0||l.height<=0)return;const e=t.knownIdAspectRatio??qe,r=Ne(e,l.width,l.height);return{left:r.left/l.width,top:r.top/l.height,width:r.width/l.width,height:r.height/l.height,viewportWidthPx:Math.round(l.width),viewportHeightPx:Math.round(l.height)}},[m,l,t.knownIdAspectRatio]);d(()=>{if(!i)return;let e=!1,r=!1;const a=setInterval(()=>{e||r||(e=!0,U.analyzeKameraFrame({rotation:fe,viewportOrientation:he,cropLeft:c?c.left:0,cropTop:c?c.top:0,cropWidth:c?c.width:0,cropHeight:c?c.height:0,cropViewportWidth:c?c.viewportWidthPx:0,cropViewportHeight:c?c.viewportHeightPx:0}).then(b=>{r||de(b)}).catch(b=>{C.captureException(b instanceof Error?b:new Error(String(b)))}).finally(()=>{e=!1}))},ut);return()=>{r=!0,clearInterval(a)}},[i,U,de,fe,he,c]);const pe=m&&(O||i&&(x?.kind==="manualCapture"||x?.kind==="autoCaptureWithManualFallback"&&Ie)),ye=m&&(i||O)&&_e,Le=K(()=>({captureType:t.captureType,overlayState:p.overlayState,enableEnhancedLiveness:_,animationDirection:p.animationDirection,poseMatched:p.poseMatched,feedbackKey:ae?"si_capture_camera_unavailable":P??se,showCaptureButton:ue,showManualShutter:pe,showGalleryUpload:ye,isBackSide:w===Te.Back,...t.knownIdAspectRatio!==void 0?{knownIdAspectRatio:t.knownIdAspectRatio}:{},...t.documentTypeKind!==void 0?{documentTypeKind:t.documentTypeKind}:{}}),[t.captureType,p.overlayState,_,p.animationDirection,p.poseMatched,se,P,ae,ue,m,pe,ye,w,t.knownIdAspectRatio,t.documentTypeKind]),Oe=K(()=>Se(Ge,{children:[I(Ye,{}),le?I(Xe,{cameraSystem:h,style:ge.absoluteFill,testID:"si_capture_camera_preview"}):I(He,{style:[ge.absoluteFill,{backgroundColor:A.colors.offBlack}],testID:"si_capture_camera_placeholder"})]}),[le,h,A.colors.offBlack]);return Se(ze,{value:A,children:[I(We,{translucent:!0,backgroundColor:"transparent",barStyle:"dark-content"}),I(je,{state:Le,captureProgress:p.captureProgress,cameraPreview:Oe,onStartCapture:N,startCaptureEnabled:xe,onBack:t.onBack,showAttribution:Ee,startButton:t.startButton,onViewportLayout:Be,...m?{onManualShutter:Pe,onGalleryUpload:Fe,documentControlsEnabled:!Ae,...t.onClose?{onClose:t.onClose}:{}}:{},theme:A})]})}

package/dist/presentation/screen/use_smile_id_consent_screen.d.ts

@@ -60,4 +60,3 @@ export type UseSmileIDConsentScreenProps = {
  * the layout reflow without code edits.
  */
 export declare function UseSmileIDConsentScreen(props: UseSmileIDConsentScreenProps): import("react").JSX.Element;
-//# sourceMappingURL=use_smile_id_consent_screen.d.ts.map