react-native-image-stitcher 0.14.2 → 0.15.0

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
@@ -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/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

package/dist/camera/PanoramaSettingsBridge.js

@@ -43,8 +43,6 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.panoramaSettingsToNativeConfig = panoramaSettingsToNativeConfig;
-exports.slitscanSettingsToNativeConfig = slitscanSettingsToNativeConfig;
-exports.hybridSettingsToNativeConfig = hybridSettingsToNativeConfig;
 const PanoramaSettings_1 = require("./PanoramaSettings");
 /**
  * Convert a v0.4 PanoramaSettings tree into the flat dict the
@@ -69,6 +67,9 @@ function panoramaSettingsToNativeConfig(s) {
         frameSelectionMode: s.frameSelection.mode,
         keyframeMaxCount: s.frameSelection.maxKeyframes,
         keyframeOverlapThreshold: s.frameSelection.overlapThreshold,
+        // Time-budget force-accept (both strategies).  Native reads
+        // configOverrides["maxKeyframeIntervalMs"] → setMaxKeyframeIntervalMs.
+        maxKeyframeIntervalMs: s.frameSelection.maxKeyframeIntervalMs,
     };
     // Flow strategy knobs — always serialised, regardless of
     // `frameSelection.mode`.  Two reasons:
@@ -105,104 +106,4 @@ function panoramaSettingsToNativeConfig(s) {
     cfg.flowMinDistance = f.minDistance;
     return cfg;
 }
-/**
- * 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)
- */
-function slitscanSettingsToNativeConfig(s) {
-    const cfg = {
-        captureSource: s.captureSource,
-        // The native side reads `engine: 'slitscan-…'` at start time
-        // from a separate top-level field, NOT from configOverrides.
-        // We still serialise the variant here for hosts that want to
-        // round-trip a single settings object through both surfaces.
-        engineVariant: s.variant,
-        // ── Painting ─────────────────────────────────────────────────
-        paintMode: s.painting.paintMode,
-        sliverPosition: s.painting.sliverPosition,
-        firstFrameFullFrame: s.painting.firstFrameFullFrame,
-        // ── Registration (explicit booleans) ─────────────────────────
-        enableTriangulation: s.registration.enableTriangulation,
-        enableTriAccumulator: s.registration.enableTriAccumulator,
-        enableRansacHomography: s.registration.enableRansacHomography,
-        // ── Plane projection ─────────────────────────────────────────
-        planeSource: s.plane.source,
-    };
-    // ── 1D NCC: presence-as-enable ─────────────────────────────────
-    if (s.registration.ncc1d) {
-        cfg.enable1dNcc = true;
-        cfg.nccSearchRadius1d = s.registration.ncc1d.searchRadius;
-    }
-    else {
-        cfg.enable1dNcc = false;
-    }
-    // ── 2D NCC: presence-as-enable + nested optionals ──────────────
-    if (s.registration.ncc2d) {
-        const n2 = s.registration.ncc2d;
-        cfg.enable2dNcc = true;
-        cfg.nccSearchMargin2d = n2.searchMargin;
-        cfg.nccConfidenceThreshold2d = n2.confidenceThreshold;
-        if (n2.emaSmoothing) {
-            cfg.enableNcc2dEmaSmoothing = true;
-            cfg.ncc2dEmaAlpha = n2.emaSmoothing.alpha;
-        }
-        else {
-            cfg.enableNcc2dEmaSmoothing = false;
-        }
-        if (n2.panAxisLock) {
-            cfg.enableNcc2dPanAxisLock = true;
-            cfg.ncc2dCrossAxisLockPx = n2.panAxisLock.crossAxisLockPx;
-        }
-        else {
-            cfg.enableNcc2dPanAxisLock = false;
-        }
-    }
-    else {
-        cfg.enable2dNcc = false;
-    }
-    // ── Plane optionals ────────────────────────────────────────────
-    // Only emit when `source` actually consumes the field.  Native
-    // tolerates unsolicited keys but the modal also walks the dict
-    // to decide which sliders to render — extra keys would mislead.
-    if (s.plane.source !== 'Disabled' && s.plane.projectionStyle !== undefined) {
-        cfg.planeProjectionStyle = s.plane.projectionStyle;
-    }
-    if (s.plane.source === 'Virtual' && s.plane.virtualDepthMeters !== undefined) {
-        cfg.virtualPlaneDepthMeters = s.plane.virtualDepthMeters;
-    }
-    if (s.plane.source === 'ARKitDetected' && s.plane.alignmentThreshold !== undefined) {
-        cfg.arkitPlaneAlignmentThreshold = s.plane.alignmentThreshold;
-    }
-    // ── Advanced motion knobs (only emit if explicitly set) ────────
-    if (s.advanced?.panAxisFractionRect !== undefined) {
-        cfg.kPanAxisFractionRect = s.advanced.panAxisFractionRect;
-    }
-    if (s.advanced?.minAcceptDeltaPx !== undefined) {
-        cfg.kMinAcceptDeltaPx = s.advanced.minAcceptDeltaPx;
-    }
-    return cfg;
-}
-/**
- * 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)
- */
-function hybridSettingsToNativeConfig(s) {
-    return {
-        captureSource: s.captureSource,
-        hybridProjection: s.projection,
-    };
-}
 //# sourceMappingURL=PanoramaSettingsBridge.js.map

package/dist/camera/PanoramaSettingsModal.js

@@ -187,6 +187,12 @@ function PanoramaSettingsModal({ visible, settings, onChange, onClose, }) {
                         react_1.default.createElement(SegmentedControl, { options: ['20%', '30%', '40%', '50%', '60%'], value: `${Math.round(settings.frameSelection.overlapThreshold * 100)}%`, onChange: (v) => updateFrameSelection({
                                 overlapThreshold: parseInt(v, 10) / 100,
                             }), caption: "Required NEW-content fraction.  20% (default): generous, ~5\u20136 keyframes for a 90\u00B0 pan.  Native clamps to [10%, 80%]." }),
+                        react_1.default.createElement(SectionHeader, { title: "Keyframe interval (time-budget force-accept)" }),
+                        react_1.default.createElement(SegmentedControl, { options: ['off', '1s', '2s', '3s', '5s'], value: settings.frameSelection.maxKeyframeIntervalMs === 0
+                                ? 'off'
+                                : `${settings.frameSelection.maxKeyframeIntervalMs / 1000}s`, onChange: (v) => updateFrameSelection({
+                                maxKeyframeIntervalMs: v === 'off' ? 0 : parseInt(v, 10) * 1000,
+                            }), caption: "Force-accept a keyframe at least this often even if novelty is low, so slow / static pans don't leave gaps.  Counts toward the keyframe cap.  off = disabled.  2s (default).  Applies to AR + non-AR." }),
                         showFlowTunables && (react_1.default.createElement(react_native_1.View, { style: styles.nested },
                             react_1.default.createElement(react_native_1.Text, { style: styles.nestedLabel }, "Flow tuning"),
                             react_1.default.createElement(SectionHeader, { title: "Max corners (Shi-Tomasi)" }),
@@ -233,7 +239,7 @@ function PanoramaSettingsModal({ visible, settings, onChange, onClose, }) {
                         react_1.default.createElement(SectionHeader, { title: "Inscribed-rect crop" }),
                         react_1.default.createElement(SegmentedControl, { options: ['off', 'on'], value: settings.stitcher.enableMaxInscribedRectCrop ? 'on' : 'off', onChange: (v) => updateStitcher({
                                 enableMaxInscribedRectCrop: v === 'on',
-                            }), caption: "off (default): crop to cv::boundingRect of non-black pixels \u2014 preserves all stitched content; may leave black corners.  on: run MaxInscribedRectFromMask + column-projection second-pass for a clean rectangle (can shrink output if mask is lopsided)." })),
+                            }), caption: "off (default): crop to cv::boundingRect of non-black pixels \u2014 preserves all stitched content; may leave black corners.  on: run MaxInscribedRectFromMask + column-projection second-pass for a clean rectangle (can shrink output a lot if mask is lopsided / ultra-wide)." })),
                     react_1.default.createElement(react_native_1.Pressable, { onPress: () => onChange(PanoramaSettings_1.DEFAULT_PANORAMA_SETTINGS), style: styles.resetBtn, accessibilityRole: "button", accessibilityLabel: "Reset to defaults" },
                         react_1.default.createElement(react_native_1.Text, { style: styles.resetText }, "Reset to defaults")))))));
 }

package/dist/camera/buildPanoramaInitialSettings.d.ts

@@ -50,6 +50,17 @@ export interface PanoramaPropOverrides {
     defaultFlowMaxTranslationCm?: number;
     defaultKeyframeMaxCount?: number;
     defaultKeyframeOverlapThreshold?: number;
+    /**
+     * Initial value for `frameSelection.maxKeyframeIntervalMs` — the
+     * time-budget force-accept (ms).  `0` disables it.  Default 2000.
+     */
+    defaultMaxKeyframeIntervalMs?: number;
+    /**
+     * v0.15 — initial value for `stitcher.enableMaxInscribedRectCrop`.
+     * Maps from the standalone `maxInscribedRectCrop` <Camera> prop.
+     * Omitted ⇒ the stitcher default (false = bounding-rect crop).
+     */
+    maxInscribedRectCrop?: boolean;
 }
 /**
  * Whether this device is low-memory enough to benefit from the

package/dist/camera/buildPanoramaInitialSettings.js

@@ -76,12 +76,16 @@ function buildPanoramaInitialSettings(overrides, isLowMemDevice) {
             warperType: overrides.defaultWarper ?? stitcherDefaults.warperType,
             blenderType: overrides.defaultBlender ?? stitcherDefaults.blenderType,
             seamFinderType: overrides.defaultSeamFinder ?? stitcherDefaults.seamFinderType,
+            enableMaxInscribedRectCrop: overrides.maxInscribedRectCrop
+                ?? stitcherDefaults.enableMaxInscribedRectCrop,
         },
         frameSelection: {
             ...base.frameSelection,
             maxKeyframes: overrides.defaultKeyframeMaxCount ?? base.frameSelection.maxKeyframes,
             overlapThreshold: overrides.defaultKeyframeOverlapThreshold
                 ?? base.frameSelection.overlapThreshold,
+            maxKeyframeIntervalMs: overrides.defaultMaxKeyframeIntervalMs
+                ?? base.frameSelection.maxKeyframeIntervalMs,
             flow: {
                 ...flowDefaults,
                 noveltyPercentile: overrides.defaultFlowNoveltyPercentile