react-native-image-stitcher 0.14.1 → 0.15.0

package/dist/camera/Camera.d.ts

@@ -144,6 +144,11 @@ export interface CameraProps {
     defaultFlowMaxTranslationCm?: number;
     defaultKeyframeMaxCount?: number;
     defaultKeyframeOverlapThreshold?: number;
+    /** Time-budget force-accept (ms) for the keyframe gate — accept a
+     *  keyframe at least this often during a pan even if novelty is low,
+     *  so slow / static pans don't leave temporal gaps.  `0` disables it.
+     *  Default 2000 (2 s).  Applies to both AR and non-AR captures. */
+    defaultMaxKeyframeIntervalMs?: number;
     /** Forward-looking — wires through to cv::Stitcher's compositingResol
      *  once PanoramaSettings exposes the field (currently a no-op). */
     defaultCompositingResolMP?: number;
@@ -151,6 +156,26 @@ export interface CameraProps {
     defaultRegistrationResolMP?: number;
     /** Forward-looking — see above. */
     defaultSeamEstimationResolMP?: number;
+    /**
+     * Crop strategy for the stitched panorama. `false` (default) keeps the
+     * bounding-rect of non-black pixels, which preserves all stitched
+     * content but may leave black corners. `true` crops to the maximum
+     * axis-aligned rectangle inscribed in the coverage mask — clean edges,
+     * no black corners (slightly more CPU at finalize) — but it can shrink
+     * the output substantially on lopsided / ultra-wide masks, which is why
+     * it's opt-in.
+     *
+     * Implemented as a start-time stitcher config (like the other
+     * stitcher settings), so this value is read once at mount to seed the
+     * initial setting; the in-app settings modal can override it at
+     * runtime. It changes image geometry (the crop), not encoding.
+     *
+     * Since the default is `false`, only pass this prop to opt in:
+     * @example
+     * // Crop to a clean inscribed rectangle (no black corners):
+     * <Camera maxInscribedRectCrop={true} />
+     */
+    maxInscribedRectCrop?: boolean;
     enablePhotoMode?: boolean;
     enablePanoramaMode?: boolean;
     showSettingsButton?: boolean;
@@ -169,23 +194,13 @@ export interface CameraProps {
     captureSources?: CaptureSourcesMode;
     style?: StyleProp<ViewStyle>;
     /**
-     * Which incremental stitcher engine to drive.  Default
-     * `'batch-keyframe'` — collects accepted JPEGs and runs
-     * `cv::Stitcher` once at finalize time.  This is the v0.4+
-     * production default and what the v0.5 Frame Processor migration
-     * exercises.
-     *
-     * Switch to a live engine (`'firstwins-rectilinear'` or
-     * `'hybrid'`) for low-latency in-flight stitching.  Live engines
-     * exercise the F8.6 pixel-buffer ingest path (skipping the JPEG
-     * encode/decode round-trip; ~30–50 ms saved per accept) when the
-     * Frame Processor driver is active.
-     *
-     * See `docs/f8-frame-processor-plan.md` and the v0.5.0
-     * CHANGELOG for the trade-offs between batch-keyframe and live
-     * engines.
+     * Which stitcher engine to drive.  Only `'batch-keyframe'` is
+     * supported (and the default): it collects accepted keyframe JPEGs
+     * during the hold-pan-release capture and runs the stitch once at
+     * finalize.  The live engines (hybrid / slit-scan / firstwins) were
+     * archived in the batch-keyframe cleanup — see `archive/`.
      */
-    engine?: 'batch-keyframe' | 'hybrid' | 'slitscan-rotate' | 'slitscan-both' | 'firstwins' | 'firstwins-zoomed' | 'firstwins-rectilinear' | 'slitscan';
+    engine?: 'batch-keyframe';
     /**
      * Optional destination directory for captures.  When set, the lib
      * lands tap-photos at `${outputDir}/photo-${ts}.jpg` and panoramas

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
@@ -328,10 +330,25 @@ function Camera(props) {
     // (older iPhones, ARCore-less Androids, simulators) stay `false`
     // forever, which forces non-AR capture everywhere and hides the
     // AR toggle in the bottom bar (see JSX below).
-    const { isAvailable: isARSupportedOnDevice } = (0, useARSession_1.useARSession)();
+    const { isAvailable: isARSupportedOnDevice, supportProbed: isARSupportProbed } = (0, useARSession_1.useARSession)();
     const effectiveCaptureSource = deriveEffectiveCaptureSource(arPreference, lens, isARSupportedOnDevice);
     const isAR = effectiveCaptureSource === 'ar';
     const isNonAR = !isAR;
+    // v0.14.2 — camera-handoff race guard.  While AR is the preferred
+    // source but the one-shot `isSupported()` probe hasn't resolved yet,
+    // `deriveEffectiveCaptureSource` returns 'non-ar' (because
+    // `isARSupportedOnDevice` is still false), which would mount
+    // <CameraView> and let vision-camera's AVCaptureSession grab the
+    // camera.  The switch to AR ~200-500ms later then fails with ARKit
+    // "Required sensor failed" (ARKit and AVCaptureSession can't share the
+    // camera), leaving a blank AR preview — intermittent and timing-
+    // dependent.  Defer the initial mount until the probe settles: while
+    // pending we render the "Switching camera…" placeholder instead of any
+    // camera, so vision-camera never contends for the device when AR is the
+    // intent.  Conditions mirror deriveEffectiveCaptureSource's own
+    // non-support gates (arPreference, lens) so this is true in exactly the
+    // cases that resolve to AR once support is confirmed.
+    const arSupportPending = arPreference && lens !== '0.5x' && !isARSupportProbed;
     const deviceOrientation = (0, useDeviceOrientation_1.useDeviceOrientation)();
     // v0.13.1 — counter-rotation for control CONTENT (AR toggle, lens
     // pill, flash icon, thumbnails) so their labels read upright relative
@@ -856,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) {
@@ -889,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'
@@ -970,7 +993,7 @@ function Camera(props) {
             : insets.top + 8;
     // ── JSX ─────────────────────────────────────────────────────────
     return (react_1.default.createElement(react_native_1.View, { style: [styles.container, style] },
-        inFlightTransition ? (react_1.default.createElement(react_native_1.View, { style: [react_native_1.StyleSheet.absoluteFill, styles.transitionPlaceholder] },
+        inFlightTransition || arSupportPending ? (react_1.default.createElement(react_native_1.View, { style: [react_native_1.StyleSheet.absoluteFill, styles.transitionPlaceholder] },
             react_1.default.createElement(react_native_1.Text, { style: styles.transitionLabel }, "Switching camera\u2026"))) : isAR ? (react_1.default.createElement(ARCameraView_1.ARCameraView, { ref: arViewRef, style: react_native_1.StyleSheet.absoluteFill })) : (react_1.default.createElement(CameraView_1.CameraView, { ref: visionCameraRef, device: capture.device, isActive: true, 
             // `video={true}` is REQUIRED for takeSnapshot to work on iOS.
             // vision-camera v4's iOS implementation of takeSnapshot waits

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