react-native-image-stitcher 0.14.2 → 0.15.1

package/dist/camera/Camera.js

@@ -265,6 +265,8 @@ function extractPanoramaOverrides(props) {
         defaultFlowMaxTranslationCm: props.defaultFlowMaxTranslationCm,
         defaultKeyframeMaxCount: props.defaultKeyframeMaxCount,
         defaultKeyframeOverlapThreshold: props.defaultKeyframeOverlapThreshold,
+        defaultMaxKeyframeIntervalMs: props.defaultMaxKeyframeIntervalMs,
+        maxInscribedRectCrop: props.maxInscribedRectCrop,
     };
 }
 // `toFileUri` (used to be an inline `toFileUri` here) lives in
@@ -279,7 +281,7 @@ function extractPanoramaOverrides(props) {
  * The public `<Camera>` component.
  */
 function Camera(props) {
-    const { defaultCaptureSource = 'ar', defaultLens = '1x', captureSources = 'both', enablePhotoMode = true, enablePanoramaMode = true, showSettingsButton = false, style, outputDir, onCapture, onCaptureSourceChange, onLensChange, onFramesDropped, onError, onCaptureAbandoned, flash: controlledFlash, onFlashChange, showFlashButton = true, headerTitle, onHeaderBack, headerBackLabel, headerGuidance, headerColors, thumbnails, thumbnailsMin, thumbnailsMax, onThumbnailPress, capturePreview, capturePreviewActions, onCapturePreviewClose, frameProcessor: hostFrameProcessor, engine = 'batch-keyframe', } = props;
+    const { defaultCaptureSource = 'non-ar', defaultLens = '1x', captureSources = 'both', enablePhotoMode = true, enablePanoramaMode = true, showSettingsButton = false, style, outputDir, onCapture, onCaptureSourceChange, onLensChange, onFramesDropped, onError, onCaptureAbandoned, flash: controlledFlash, onFlashChange, showFlashButton = true, headerTitle, onHeaderBack, headerBackLabel, headerGuidance, headerColors, thumbnails, thumbnailsMin, thumbnailsMax, onThumbnailPress, capturePreview, capturePreviewActions, onCapturePreviewClose, frameProcessor: hostFrameProcessor, engine = 'batch-keyframe', } = props;
     // v0.13.2 — capture-source constraint (default 'both').  Derives which
     // sources are permitted; `captureSources` overrides any conflicting
     // `defaultCaptureSource`.  Used to constrain the initial AR preference
@@ -871,7 +873,8 @@ function Camera(props) {
             // reconstruction.  Only meaningful in non-AR mode (in AR the
             // native side uses pose-derived translation and ignores this).
             const imuTotalTranslationM = isNonAR ? imuGate.getTotalAbsMetres() : 0;
-            const result = await incremental.finalize(panoOutputPath, 90, deviceOrientation, imuTotalTranslationM);
+            const result = await incremental.finalize(panoOutputPath, 90, // default JPEG quality
+            deviceOrientation, imuTotalTranslationM);
             if (typeof result.framesRequested === 'number'
                 && typeof result.framesIncluded === 'number'
                 && result.framesIncluded < result.framesRequested) {
@@ -904,7 +907,12 @@ function Camera(props) {
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            const code = /need more images/i.test(message) ? 'STITCH_NEED_MORE_IMGS'
+            const code = 
+            // Insufficient overlap surfaces two ways: cv::Stitcher's
+            // ERR_NEED_MORE_IMGS ("need more images") and the manual
+            // pipeline's "0 valid pairwise matches / frames may not overlap
+            // enough" — both are the same recoverable "pan more slowly" case.
+            /need more images|pairwise match|overlap enough/i.test(message) ? 'STITCH_NEED_MORE_IMGS'
                 : /homography/i.test(message) ? 'STITCH_HOMOGRAPHY_FAIL'
                     : /camera params/i.test(message) ? 'STITCH_CAMERA_PARAMS_FAIL'
                         : /out of memory|oom/i.test(message) ? 'STITCH_OOM'

package/dist/camera/CameraView.js

@@ -92,12 +92,73 @@ exports.CameraView = (0, react_1.forwardRef)(function CameraView({ device, flash
     // Internal ref so we can both attach to <Camera> and forward outward.
     const innerRef = (0, react_1.useRef)(null);
     (0, react_1.useImperativeHandle)(ref, () => innerRef.current);
+    // ── WYSIWYG letterboxing ────────────────────────────────────────
+    //
+    // Pin BOTH the photo and the preview (video) stream to a 4:3 aspect
+    // ratio so the viewport shows exactly what gets captured.  Without a
+    // pinned format, vision-camera picks the device default for each —
+    // commonly a 4:3 photo but a 16:9 preview — so the preview and the
+    // saved frame frame different scenes.  4:3 is the native still
+    // aspect on essentially every phone camera (incl. ultra-wide), so a
+    // matching format is virtually always available; `useCameraFormat`
+    // returns the closest match and never throws.
+    const format = (0, react_native_vision_camera_1.useCameraFormat)(device ?? undefined, [
+        { photoAspectRatio: 4 / 3 },
+        { videoAspectRatio: 4 / 3 },
+    ]);
+    // Measured size of our container, so we can size the <Camera> view to
+    // the largest box of the capture's aspect ratio that fits inside it
+    // (the rest becomes the black letterbox).  We deliberately size the
+    // VIEW rather than relying on vision-camera's `resizeMode` alone:
+    // resizeMode maps to PreviewView.ScaleType on Android, which several
+    // devices ignore under the default SurfaceView compositor — so the
+    // preview kept filling the screen.  When the view's own aspect ratio
+    // equals the feed's, there is nothing left to crop on any platform.
+    const [size, setSize] = (0, react_1.useState)(null);
+    const onRootLayout = (0, react_1.useCallback)((e) => {
+        const { width, height } = e.nativeEvent.layout;
+        setSize((prev) => prev && prev.w === width && prev.h === height
+            ? prev
+            : { w: width, h: height });
+    }, []);
     if (!device) {
         return (react_1.default.createElement(react_native_1.View, { style: [styles.placeholder, style], accessibilityLabel: "Camera initialising" },
             react_1.default.createElement(react_native_1.Text, { style: styles.placeholderText }, "Initialising camera\u2026")));
     }
-    return (react_1.default.createElement(react_native_1.View, { style: [styles.root, style] },
-        react_1.default.createElement(react_native_vision_camera_1.Camera, { ref: innerRef, style: react_native_1.StyleSheet.absoluteFill, device: device, isActive: isActive, photo: true, video: video, ...(zoom != null ? { zoom } : {}), 
+    // Capture aspect ratio (W÷H) in the sensor's native landscape
+    // orientation (so > 1).  Falls back to 4:3 until the format resolves.
+    const sensorAspect = format && format.photoWidth > 0 && format.photoHeight > 0
+        ? format.photoWidth / format.photoHeight
+        : 4 / 3;
+    // With outputOrientation="device", a portrait device displays the
+    // scene rotated, so the on-screen content aspect is the inverse of
+    // the landscape sensor aspect.  Detect portrait from the measured
+    // container — robust across devices, split-screen and rotation.
+    const isPortrait = size != null ? size.h >= size.w : true;
+    const contentAspect = isPortrait ? 1 / sensorAspect : sensorAspect;
+    // Largest box of `contentAspect` that fits the container, centred by
+    // styles.root.  The remaining area is the black letterbox.  Before the
+    // first onLayout we fill the container so the camera session mounts
+    // immediately; the exact box snaps in ~1 frame later.
+    let cameraStyle;
+    if (size == null || size.w === 0 || size.h === 0) {
+        cameraStyle = react_native_1.StyleSheet.absoluteFillObject;
+    }
+    else {
+        const heightIfFullWidth = size.w / contentAspect;
+        cameraStyle =
+            heightIfFullWidth <= size.h
+                ? { width: size.w, height: heightIfFullWidth }
+                : { width: size.h * contentAspect, height: size.h };
+    }
+    return (react_1.default.createElement(react_native_1.View, { style: [styles.root, style], onLayout: onRootLayout },
+        react_1.default.createElement(react_native_vision_camera_1.Camera, { ref: innerRef, 
+            // Sized to the letterboxed box (capture aspect ratio) so the
+            // preview never crops; styles.root centres it and paints the
+            // surrounding bars black.  See the cameraStyle computation above.
+            style: cameraStyle, device: device, isActive: isActive, photo: true, video: video, 
+            // Pin preview + photo to the same 4:3 format (WYSIWYG capture).
+            format: format, ...(zoom != null ? { zoom } : {}), 
             // Bake the device orientation into the captured pixels.
             // Without this, vision-camera writes the file in the camera
             // sensor's native landscape and relies on EXIF metadata to
@@ -107,7 +168,26 @@ exports.CameraView = (0, react_1.forwardRef)(function CameraView({ device, flash
             // `outputOrientation="device"` rotates the pixels to match
             // how the user is holding the phone, so the saved JPEG is
             // "what you see is what was taken".
-            outputOrientation: "device", torch: flash === 'on' ? 'on' : 'off', onError: handleVcError, ...cameraProps }),
+            outputOrientation: "device", 
+            // Show the full camera FOV — no cropping.  'contain' maps to
+            // AVLayerVideoGravity.resizeAspect on iOS and the equivalent
+            // on Android, letterboxing the preview to the sensor's exact
+            // aspect ratio.  Without this the default 'cover' crops
+            // ~19% off each horizontal edge in portrait mode (4:3 sensor
+            // in a 9:21 viewport), so the stitcher receives frames the
+            // user never saw.  Black bars fill the remainder; backgroundColor
+            // on styles.root ensures they are always black.
+            resizeMode: "contain", 
+            // Android: force TextureView rendering so that FIT_CENTER
+            // (the Android equivalent of resizeMode="contain") actually
+            // produces visible letterboxing.  The default SurfaceView mode
+            // composes at the hardware layer below the View hierarchy and
+            // on many devices ignores FIT_CENTER, filling the full surface
+            // instead.  TextureView is part of the regular View hierarchy
+            // so the matrix transform for FIT_CENTER works correctly —
+            // the bars outside the letterboxed area are transparent,
+            // revealing the parent's black backgroundColor.
+            androidPreviewViewType: "texture-view", torch: flash === 'on' ? 'on' : 'off', onError: handleVcError, ...cameraProps }),
         guidance ? (react_1.default.createElement(react_native_1.View, { style: styles.guidance, pointerEvents: "none", accessible: true, accessibilityRole: "text" },
             react_1.default.createElement(react_native_1.Text, { style: styles.guidanceText, numberOfLines: 2 }, guidance))) : null));
 });
@@ -115,6 +195,16 @@ const styles = react_native_1.StyleSheet.create({
     root: {
         flex: 1,
         overflow: 'hidden',
+        // Centre the letterboxed <Camera> box so the black bars are
+        // symmetric on both sides (top/bottom in portrait, left/right in
+        // landscape).
+        alignItems: 'center',
+        justifyContent: 'center',
+        // Black bars when the camera's aspect ratio doesn't fill the
+        // container (e.g. 4:3 sensor in a 9:21 portrait viewport).  Without
+        // this the bars are transparent, revealing whatever is behind the
+        // component.
+        backgroundColor: '#000',
     },
     placeholder: {
         flex: 1,

package/dist/camera/CaptureStitchStatsToast.d.ts

@@ -18,10 +18,21 @@ import type { IncrementalFinalizeResult } from '../stitching/incremental';
 export interface CaptureStitchStatsToastProps {
     /** Toast message to show.  Pass null to hide. */
     message: string | null;
+    /**
+     * Optional bold title rendered above the message (e.g. an action ask
+     * like "Pan more slowly").  Omit for a plain single-line toast.
+     */
+    title?: string | null;
     /** Top inset for safe-area placement.  Toast pinned `topInset + 12`. */
     topInset?: number;
+    /**
+     * Vertical placement.  'top' (default) pins it `topInset + 12` from the
+     * top; 'center' vertically centers it — more prominent, and dodges the
+     * notch / Dynamic Island entirely.
+     */
+    placement?: 'top' | 'center';
 }
-export declare function CaptureStitchStatsToast({ message, topInset, }: CaptureStitchStatsToastProps): React.JSX.Element | null;
+export declare function CaptureStitchStatsToast({ message, title, topInset, placement, }: CaptureStitchStatsToastProps): React.JSX.Element | null;
 /**
  * Imperative API for showing transient stitch-stats toasts.
  *
@@ -38,7 +49,9 @@ export declare function CaptureStitchStatsToast({ message, topInset, }: CaptureS
  */
 export interface UseStitchStatsToastReturn {
     message: string | null;
-    showFor: (msg: string, ms?: number) => void;
+    /** Optional bold title shown above `message` (pass to the toast). */
+    title: string | null;
+    showFor: (msg: string, ms?: number, title?: string) => void;
     showResult: (result: IncrementalFinalizeResult, ms?: number) => void;
 }
 export declare function useStitchStatsToast(): UseStitchStatsToastReturn;

package/dist/camera/CaptureStitchStatsToast.js

@@ -53,14 +53,14 @@ exports.CaptureStitchStatsToast = CaptureStitchStatsToast;
 exports.useStitchStatsToast = useStitchStatsToast;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
-function CaptureStitchStatsToast({ message, topInset = 0, }) {
+function CaptureStitchStatsToast({ message, title = null, topInset = 0, placement = 'top', }) {
     if (message === null)
         return null;
-    return (react_1.default.createElement(react_native_1.View, { pointerEvents: "none", style: [
-            styles.wrap,
-            { top: topInset + 12 },
-        ] },
+    return (react_1.default.createElement(react_native_1.View, { pointerEvents: "none", style: placement === 'center'
+            ? styles.wrapCenter
+            : [styles.wrap, { top: topInset + 12 }] },
         react_1.default.createElement(react_native_1.View, { style: styles.capsule, accessibilityRole: "alert", accessibilityLiveRegion: "polite" },
+            title ? (react_1.default.createElement(react_native_1.Text, { style: styles.title, numberOfLines: 2 }, title)) : null,
             react_1.default.createElement(react_native_1.Text, { style: styles.text, numberOfLines: 3 }, message))));
 }
 const styles = react_native_1.StyleSheet.create({
@@ -71,6 +71,16 @@ const styles = react_native_1.StyleSheet.create({
         alignItems: 'center',
         zIndex: 110,
     },
+    wrapCenter: {
+        position: 'absolute',
+        top: 0,
+        bottom: 0,
+        left: 24,
+        right: 24,
+        alignItems: 'center',
+        justifyContent: 'center',
+        zIndex: 110,
+    },
     capsule: {
         paddingHorizontal: 16,
         paddingVertical: 10,
@@ -78,6 +88,13 @@ const styles = react_native_1.StyleSheet.create({
         backgroundColor: 'rgba(15, 23, 42, 0.92)',
         maxWidth: '100%',
     },
+    title: {
+        color: '#ffffff',
+        fontSize: 14,
+        fontWeight: '700',
+        textAlign: 'center',
+        marginBottom: 3,
+    },
     text: {
         color: '#ffffff',
         fontSize: 13,
@@ -88,13 +105,16 @@ const styles = react_native_1.StyleSheet.create({
 const DEFAULT_DISMISS_MS = 4500;
 function useStitchStatsToast() {
     const [message, setMessage] = (0, react_1.useState)(null);
+    const [title, setTitle] = (0, react_1.useState)(null);
     const timerRef = (0, react_1.useRef)(null);
-    const showFor = (0, react_1.useCallback)((msg, ms = DEFAULT_DISMISS_MS) => {
+    const showFor = (0, react_1.useCallback)((msg, ms = DEFAULT_DISMISS_MS, titleText) => {
         if (timerRef.current)
             clearTimeout(timerRef.current);
+        setTitle(titleText ?? null);
         setMessage(msg);
         timerRef.current = setTimeout(() => {
             setMessage(null);
+            setTitle(null);
             timerRef.current = null;
         }, ms);
     }, []);
@@ -128,6 +148,6 @@ function useStitchStatsToast() {
         if (timerRef.current)
             clearTimeout(timerRef.current);
     }, []);
-    return { message, showFor, showResult };
+    return { message, title, showFor, showResult };
 }
 //# sourceMappingURL=CaptureStitchStatsToast.js.map

package/dist/camera/PanoramaSettings.d.ts

@@ -175,6 +175,16 @@ export interface FrameSelectionSettings {
      * (`IncrementalStitcher.swift:962`).
      */
     overlapThreshold: number;
+    /**
+     * Time-budget force-accept (BOTH strategies, AR + non-AR).  When > 0,
+     * the gate accepts a keyframe whenever this many milliseconds have
+     * elapsed since the last accepted keyframe — even if the novelty /
+     * overlap threshold wasn't met — so a slow or static pan never goes
+     * longer than this without a keyframe.  Counts toward `maxKeyframes`
+     * (the cap still finalises the capture).  `0` disables it.  Default
+     * `2000` (2 s).  Maps to the native gate's `setMaxKeyframeIntervalMs`.
+     */
+    maxKeyframeIntervalMs: number;
     /**
      * Sparse-optical-flow strategy tunables.  Consulted only when
      * `mode === 'flow-based'`; safe to omit otherwise.  Defaults
@@ -252,227 +262,4 @@ export interface FlowGateSettings {
  */
 export declare const DEFAULT_FLOW_GATE_SETTINGS: FlowGateSettings;
 export declare const DEFAULT_PANORAMA_SETTINGS: PanoramaSettings;
-/**
- * Settings for slit-scan stitching engines (`slitscan-rotate`,
- * `slitscan-both`, `firstwins-rectilinear`).  Reached via
- * `incremental.start({ engine: '<variant>', config: { ... } })`,
- * NOT via <Camera> (which always uses batch-keyframe).  Each
- * sub-tree corresponds to a section of the native `RLISStitcherConfig`
- * the slit-scan engine reads at start.
- *
- * Field-by-field native consumer references are documented in
- * `OpenCVSlitScanStitcher.mm` / `OpenCVIncrementalStitcher.h`.
- */
-export interface SlitscanSettings extends CaptureBaseSettings {
-    /**
-     * Which slit-scan variant the engine runs.  All three share the
-     * same painting + registration + plane configuration; they differ
-     * in their internal motion model (rotation-only vs combined
-     * translation+rotation, and slit position).
-     *
-     *   • `'slitscan-rotate'`         — preferred name; rotation-only
-     *     motion model.
-     *   • `'slitscan-both'`           — combined translation + rotation
-     *     motion model.
-     *   • `'firstwins-rectilinear'`   — legacy alias of
-     *     `'slitscan-rotate'` (V13.0a naming).  Accepted natively
-     *     but new code should prefer the canonical name.
-     */
-    variant: 'slitscan-rotate' | 'slitscan-both' | 'firstwins-rectilinear';
-    /** Where the per-accept slit is taken from + how it's blended. */
-    painting: SlitscanPaintingSettings;
-    /** Frame-to-frame registration (NCC + RANSAC + triangulation). */
-    registration: SlitscanRegistrationSettings;
-    /** Plane projection (ARKit-detected, virtual, or disabled). */
-    plane: PlaneProjectionSettings;
-    /**
-     * Advanced motion-tuning knobs that the v0.3 modal never exposed.
-     * Both are read by the native side
-     * (`IncrementalStitcher.swift:1074, 1077`) and have sensible
-     * defaults; most consumers can leave this field undefined.
-     */
-    advanced?: SlitscanAdvancedSettings;
-}
-export interface SlitscanAdvancedSettings {
-    /**
-     * Fraction of the pan-axis sensor extent used to compute the
-     * per-frame slit width.  Range `[0.05, 0.90]`, default 0.70
-     * (engine internal).  Higher = wider slits = fewer accepts per
-     * pan.  Set this only if you know what the slit-scan motion
-     * model needs for your specific capture geometry.
-     * Native key: `kPanAxisFractionRect`.
-     */
-    panAxisFractionRect?: number;
-    /**
-     * Minimum pan-axis delta (in canvas pixels) between consecutive
-     * accepted strips.  Acts as a hard floor below which subsequent
-     * frames are rejected regardless of NCC scores.  Range
-     * `[0, 500]`, default 0 (no floor).  Native key:
-     * `kMinAcceptDeltaPx`.
-     */
-    minAcceptDeltaPx?: number;
-}
-export interface SlitscanPaintingSettings {
-    /**
-     * How new strips are blended into already-painted canvas pixels.
-     *
-     *   • `'FirstPaintedWins'` (default) — preserve the first frame's
-     *     content at any pixel; later strips don't overwrite.
-     *   • `'FeatherBlend'`               — alpha-blend new strips into
-     *     already-painted areas at slit boundaries.  Smooths visible
-     *     seams when many narrow slits stack.
-     */
-    paintMode: 'FirstPaintedWins' | 'FeatherBlend';
-    /**
-     * Where on the camera frame the per-accept slit is sampled from.
-     * For a typical landscape vertical pan tilting DOWN, the leading
-     * edge (new content) is at the BOTTOM of the camera frame; for
-     * upward tilt, it's at the TOP.  `'Center'` is the V13.x default.
-     */
-    sliverPosition: 'Center' | 'Bottom' | 'Top';
-    /**
-     * When `true`, the very first frame's FULL frame is painted onto
-     * the canvas (not just the configured slit clip).  Default
-     * `true` — gives the panorama a wider initial anchor that
-     * subsequent slits extend from.  Set false if you want strict
-     * slit-only behaviour even on the first frame.
-     */
-    firstFrameFullFrame: boolean;
-}
-export interface SlitscanRegistrationSettings {
-    /**
-     * 3D triangulation step.  Cross-references features across
-     * multiple frames to estimate scene depth.  Default `false` (off);
-     * adds latency, useful for parallax-heavy captures.
-     */
-    enableTriangulation: boolean;
-    /**
-     * Triangulation accumulator — when `enableTriangulation` is on,
-     * keeps a running pose graph across the whole capture.  Default
-     * `false` (off); needed for multi-shot fusion.
-     */
-    enableTriAccumulator: boolean;
-    /**
-     * RANSAC homography fit per pair.  Adds robustness to feature
-     * matching at the cost of a few ms per frame.  Default `false`.
-     */
-    enableRansacHomography: boolean;
-    /**
-     * 1D NCC strip alignment.  Present iff enabled.  Default
-     * undefined (disabled); engine uses pure feature matching.
-     */
-    ncc1d?: Ncc1dSettings;
-    /**
-     * 2D NCC strip alignment.  Present iff enabled.  More expensive
-     * than 1D NCC; needed for shelf-scan captures with vertical
-     * misalignment.  Default undefined (disabled).
-     */
-    ncc2d?: Ncc2dSettings;
-}
-export interface Ncc1dSettings {
-    /**
-     * Search radius in working-resolution pixels (along the pan axis).
-     * Clamped to `[5, 60]`.  Default 15 when the field is set.
-     */
-    searchRadius: number;
-}
-export interface Ncc2dSettings {
-    /**
-     * 2D search margin in pixels (rectangular region around the
-     * predicted strip position).  Clamped to `[4, 60]`.  Default 12.
-     */
-    searchMargin: number;
-    /**
-     * Minimum NCC score to accept a match.  Below this the engine
-     * falls back to the predicted (pose-only) position.  Clamped
-     * to `[0.30, 0.99]`.  Default 0.99 (only accept very strong
-     * matches; the canvas falls back to pose-only quickly).
-     */
-    confidenceThreshold: number;
-    /**
-     * EMA smoothing of the NCC-derived offset across consecutive
-     * strips.  Present iff enabled.  Default undefined.  Useful
-     * for jittery captures.
-     */
-    emaSmoothing?: {
-        alpha: number;
-    };
-    /**
-     * Pan-axis-lock — when enabled, the NCC offset is constrained
-     * to the dominant pan axis (cross-axis movement bounded by
-     * `crossAxisLockPx`).  Useful when the operator's hand wobble
-     * introduces unwanted cross-axis motion.  Present iff enabled.
-     */
-    panAxisLock?: {
-        crossAxisLockPx: number;
-    };
-}
-export interface PlaneProjectionSettings {
-    /**
-     * Where the plane the slit-scan projects onto comes from.
-     *
-     *   • `'Disabled'`       — no plane projection; engine runs
-     *                          its baseline slit-scan path.
-     *   • `'ARKitDetected'`  — use the first vertical plane that
-     *                          ARKit/ARCore finds AND whose normal
-     *                          aligns with the camera (filtered by
-     *                          `alignmentThreshold`).  Requires
-     *                          `captureSource === 'ar'`.
-     *   • `'Virtual'`        — synthesise a plane at a fixed depth
-     *                          (`virtualDepthMeters`) in front of the
-     *                          camera at first-frame pose.  No
-     *                          ARKit dependency.
-     */
-    source: 'Disabled' | 'ARKitDetected' | 'Virtual';
-    /**
-     * How frames are warped onto the plane.  Only consulted when
-     * `source !== 'Disabled'`.  Default `'Rectified'` for slit-scan.
-     */
-    projectionStyle?: 'Trapezoidal' | 'Rectified';
-    /**
-     * Depth in metres for `source === 'Virtual'`.  Range `[0.3, 5.0]`,
-     * default 1.5.  Set close to the actual shelf distance for the
-     * cleanest projection.
-     */
-    virtualDepthMeters?: number;
-    /**
-     * Minimum `|planeNormal · cameraForward|` for an ARKit-detected
-     * plane to be accepted (when `source === 'ARKitDetected'`).
-     * Range `[0, 1]`, default 0.6 (≈ 53° max off-axis).  Higher =
-     * stricter, only accept very-on-axis planes.
-     */
-    alignmentThreshold?: number;
-}
-export declare const DEFAULT_SLITSCAN_SETTINGS: SlitscanSettings;
-/**
- * Settings for the hybrid live-compositing engine
- * (`incremental.start({ engine: 'hybrid', ... })`).  Most consumers
- * won't touch this — the hybrid engine is RetaiLens-specific and
- * the public lib's batch-keyframe pipeline is a better fit for
- * general-purpose captures.  Exported here for completeness.
- *
- * Important: the hybrid engine has internal preset paths
- * (`OpenCVIncrementalStitcher.mm:139-180`) that hard-set
- * `enableTriangulation`, `enable2dNcc`, `enableRansacHomography`,
- * `planeSource = Disabled`, etc.  Code-reviewer flagged that
- * exposing those fields would be misleading — the engine clobbers
- * any overrides.  So this type is intentionally minimal: only
- * `projection` is reliably operator-tunable.  Hosts that need to
- * reach deeper-level hybrid knobs can pass a raw config dict to
- * `incremental.start()` directly (Layer 2 escape hatch).
- */
-export interface HybridSettings extends CaptureBaseSettings {
-    /**
-     * Internal projection during real-time compositing.  Independent
-     * from the panorama-stitcher's warperType (which doesn't apply
-     * to the hybrid engine — its output is the live canvas directly).
-     *
-     * Note: only effective in the rotation-only preset path (hybrid
-     * preset 1).  In the other hybrid presets the engine forces
-     * Planar internally regardless of this setting.  Native source:
-     * `OpenCVIncrementalStitcher.mm:146,161,180`.
-     */
-    projection: 'Cylindrical' | 'Planar';
-}
-export declare const DEFAULT_HYBRID_SETTINGS: HybridSettings;
 //# sourceMappingURL=PanoramaSettings.d.ts.map

package/dist/camera/PanoramaSettings.js

@@ -47,7 +47,7 @@
  * by-field mapping.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_HYBRID_SETTINGS = exports.DEFAULT_SLITSCAN_SETTINGS = exports.DEFAULT_PANORAMA_SETTINGS = exports.DEFAULT_FLOW_GATE_SETTINGS = void 0;
+exports.DEFAULT_PANORAMA_SETTINGS = exports.DEFAULT_FLOW_GATE_SETTINGS = void 0;
 /**
  * Canonical FlowGateSettings defaults, exported as a standalone
  * constant so consumers (the bridge, the modal, prop translators)
@@ -81,40 +81,18 @@ exports.DEFAULT_PANORAMA_SETTINGS = {
         warperType: 'plane',
         blenderType: 'multiband',
         seamFinderType: 'graphcut',
+        // v0.15 — inscribed-rect crop is OFF by default (bbox crop keeps all
+        // stitched content).  Opt in with `maxInscribedRectCrop={true}` (or toggle
+        // it on in settings) for a clean-cornered rectangle — but it can shrink the
+        // output a lot on lopsided / ultra-wide masks, which is why it's opt-in.
         enableMaxInscribedRectCrop: false,
     },
     frameSelection: {
         mode: 'flow-based',
         maxKeyframes: 6,
         overlapThreshold: 0.20,
+        maxKeyframeIntervalMs: 2000,
         flow: exports.DEFAULT_FLOW_GATE_SETTINGS,
     },
 };
-exports.DEFAULT_SLITSCAN_SETTINGS = {
-    captureSource: 'ar',
-    debug: false,
-    variant: 'slitscan-rotate',
-    painting: {
-        paintMode: 'FirstPaintedWins',
-        sliverPosition: 'Bottom',
-        firstFrameFullFrame: true,
-    },
-    registration: {
-        enableTriangulation: false,
-        enableTriAccumulator: false,
-        enableRansacHomography: false,
-        // ncc1d / ncc2d omitted — both disabled by default.
-    },
-    plane: {
-        source: 'ARKitDetected',
-        projectionStyle: 'Rectified',
-        virtualDepthMeters: 1.5,
-        alignmentThreshold: 0.6,
-    },
-};
-exports.DEFAULT_HYBRID_SETTINGS = {
-    captureSource: 'ar',
-    debug: false,
-    projection: 'Planar',
-};
 //# sourceMappingURL=PanoramaSettings.js.map

package/dist/camera/PanoramaSettingsBridge.d.ts

@@ -39,7 +39,7 @@
  * SlitscanSettings or HybridSettings call the matching adapter
  * before reaching `incremental.start()`.
  */
-import { type PanoramaSettings, type SlitscanSettings, type HybridSettings } from './PanoramaSettings';
+import { type PanoramaSettings } from './PanoramaSettings';
 /**
  * Flat config dictionary type — what the native bridges expect.
  * Indexed by the native-side key name; values are platform-
@@ -58,27 +58,4 @@ export type NativeConfigDict = Record<string, boolean | number | string>;
  *   - Android `IncrementalStitcher.kt:280-430` (batch path)
  */
 export declare function panoramaSettingsToNativeConfig(s: PanoramaSettings): NativeConfigDict;
-/**
- * Convert a v0.4 SlitscanSettings tree into the flat dict the
- * slit-scan / firstwins native engines read.  Handles the
- * "presence-as-enable" boolean expansion: a non-undefined
- * `registration.ncc1d` means `enable1dNcc: true` on the wire,
- * with the sub-object's `searchRadius` carried alongside.
- *
- * Verified against:
- *   - iOS  `IncrementalStitcher.swift:1006-1100` (applyConfigOverrides)
- *   - iOS  `OpenCVSlitScanStitcher.mm` (all numbered references in
- *          the audit ground-truth matrix)
- */
-export declare function slitscanSettingsToNativeConfig(s: SlitscanSettings): NativeConfigDict;
-/**
- * Convert a v0.4 HybridSettings tree into the flat dict the hybrid
- * engine reads.  Minimal surface — hybrid presets internally clobber
- * almost everything; see HybridSettings JSDoc for context.
- *
- * Verified against:
- *   - iOS  `OpenCVIncrementalStitcher.mm:139-180` (preset paths)
- *   - iOS  `IncrementalStitcher.swift:1034-1040` (hybridProjection override)
- */
-export declare function hybridSettingsToNativeConfig(s: HybridSettings): NativeConfigDict;
 //# sourceMappingURL=PanoramaSettingsBridge.d.ts.map