react-native-image-stitcher 0.2.1 → 0.4.0

package/dist/camera/CaptureMemoryPill.js

@@ -0,0 +1,109 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * CaptureMemoryPill — top-right diagnostic pill showing native
+ * process memory footprint in MB, polled at 500 ms.
+ *
+ * Color-coded against the iPhone 16 Pro per-process jetsam limit:
+ *
+ *   - green  <1500 MB   (comfortable)
+ *   - amber  1500–2200  (approaching pressure)
+ *   - red    >2200      (close to limit — capture may be killed)
+ *
+ * Backed by the existing `getMemoryFootprintMB()` native module
+ * (iOS: `task_info phys_footprint`, Android: `Debug.MemoryInfo
+ * getTotalPss * 1024`).  Returns -1 if the native call fails.
+ *
+ * Mount this pill inside a `settings.debug`-gated branch — it
+ * polls native every 500 ms and is unwanted in production builds.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptureMemoryPill = CaptureMemoryPill;
+const react_1 = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const incremental_1 = require("../stitching/incremental");
+function CaptureMemoryPill({ topInset = 0, pollIntervalMs = 500, }) {
+    const [memMB, setMemMB] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        const native = (0, incremental_1.getIncrementalNativeModule)();
+        if (!native?.getMemoryFootprintMB)
+            return undefined;
+        let cancelled = false;
+        const tick = async () => {
+            try {
+                const mb = await native.getMemoryFootprintMB();
+                if (!cancelled)
+                    setMemMB(mb);
+            }
+            catch {
+                // Bridge error — leave the previous reading visible.
+            }
+        };
+        tick();
+        const id = setInterval(tick, pollIntervalMs);
+        return () => {
+            cancelled = true;
+            clearInterval(id);
+        };
+    }, [pollIntervalMs]);
+    if (memMB === null || memMB < 0)
+        return null;
+    const bg = memMB > 2200 ? 'rgba(239, 68, 68, 0.92)' // red
+        : memMB > 1500 ? 'rgba(245, 158, 11, 0.92)' // amber
+            : 'rgba(34, 197, 94, 0.92)'; // green
+    return (react_1.default.createElement(react_native_1.View, { pointerEvents: "none", style: [
+            styles.container,
+            { top: topInset + 56, backgroundColor: bg },
+        ], accessibilityRole: "alert" },
+        react_1.default.createElement(react_native_1.Text, { style: styles.text }, `${Math.round(memMB)} MB`)));
+}
+const styles = react_native_1.StyleSheet.create({
+    container: {
+        position: 'absolute',
+        right: 12,
+        paddingHorizontal: 10,
+        paddingVertical: 5,
+        borderRadius: 999,
+        zIndex: 100,
+    },
+    text: {
+        color: '#fff',
+        fontSize: 12,
+        fontWeight: '700',
+        fontFamily: 'Menlo',
+    },
+});
+//# sourceMappingURL=CaptureMemoryPill.js.map

package/dist/camera/CaptureOrientationPill.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CaptureOrientationPill — diagnostic pill showing the operator's
+ * current hold orientation as detected by the pose-derived hook.
+ *
+ * Useful for diagnosing rotation issues — if the pill says
+ * `landscape-left` but the band overlay is rendering as if it's
+ * `portrait`, there's a mismatch between the JS orientation hook
+ * and the engine's pose-derived isLandscape signal.
+ *
+ * Pinned top-left below the status bar.  Layer-2 hosts can mount
+ * this directly; Layer-1 `<Camera>` mounts it automatically when
+ * `settings.debug = true`.
+ */
+import React from 'react';
+export interface CaptureOrientationPillProps {
+    /** Current device orientation (typically from useDeviceOrientation). */
+    orientation: string;
+    /** Top inset for safe-area placement.  Pill pinned `topInset + 56`. */
+    topInset?: number;
+}
+export declare function CaptureOrientationPill({ orientation, topInset, }: CaptureOrientationPillProps): React.JSX.Element;
+//# sourceMappingURL=CaptureOrientationPill.d.ts.map

package/dist/camera/CaptureOrientationPill.js

@@ -0,0 +1,44 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * CaptureOrientationPill — diagnostic pill showing the operator's
+ * current hold orientation as detected by the pose-derived hook.
+ *
+ * Useful for diagnosing rotation issues — if the pill says
+ * `landscape-left` but the band overlay is rendering as if it's
+ * `portrait`, there's a mismatch between the JS orientation hook
+ * and the engine's pose-derived isLandscape signal.
+ *
+ * Pinned top-left below the status bar.  Layer-2 hosts can mount
+ * this directly; Layer-1 `<Camera>` mounts it automatically when
+ * `settings.debug = true`.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptureOrientationPill = CaptureOrientationPill;
+const react_1 = __importDefault(require("react"));
+const react_native_1 = require("react-native");
+function CaptureOrientationPill({ orientation, topInset = 0, }) {
+    return (react_1.default.createElement(react_native_1.View, { pointerEvents: "none", style: [styles.container, { top: topInset + 56 }], accessibilityRole: "alert" },
+        react_1.default.createElement(react_native_1.Text, { style: styles.text }, `orient: ${orientation}`)));
+}
+const styles = react_native_1.StyleSheet.create({
+    container: {
+        position: 'absolute',
+        left: 12,
+        paddingHorizontal: 10,
+        paddingVertical: 5,
+        borderRadius: 999,
+        backgroundColor: 'rgba(99, 102, 241, 0.92)',
+        zIndex: 100,
+    },
+    text: {
+        color: '#fff',
+        fontSize: 11,
+        fontWeight: '700',
+        fontFamily: 'Menlo',
+    },
+});
+//# sourceMappingURL=CaptureOrientationPill.js.map

package/dist/camera/CaptureStitchStatsToast.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CaptureStitchStatsToast — auto-dismissing toast that shows the
+ * batch-stitcher's leaveBiggestComponent telemetry + the resolved
+ * cv::Stitcher mode after every successful finalize.
+ *
+ * Pattern: top-center capsule, dark translucent background, dismisses
+ * itself after `dismissAfterMs` (default 4500).  Replaces the
+ * Alert.alert blocking modal that used to interrupt the next
+ * capture.  See `useStitchStatsToast` hook for the matching
+ * imperative API.
+ *
+ * Layer-2 hosts can mount this directly + pass their own message;
+ * Layer-1 `<Camera>` mounts it under `settings.debug` and feeds
+ * the formatted message from the finalize result automatically.
+ */
+import React from 'react';
+import type { IncrementalFinalizeResult } from '../stitching/incremental';
+export interface CaptureStitchStatsToastProps {
+    /** Toast message to show.  Pass null to hide. */
+    message: string | null;
+    /** Top inset for safe-area placement.  Toast pinned `topInset + 12`. */
+    topInset?: number;
+}
+export declare function CaptureStitchStatsToast({ message, topInset, }: CaptureStitchStatsToastProps): React.JSX.Element | null;
+/**
+ * Imperative API for showing transient stitch-stats toasts.
+ *
+ * Returns `{ message, showFor, showResult }`:
+ *   - `message`     — current toast text (pass to CaptureStitchStatsToast)
+ *   - `showFor`     — show an arbitrary string, auto-dismiss
+ *   - `showResult`  — format an `IncrementalFinalizeResult` into the
+ *                     standard "Stitch: N/M frames • thresh X.XX •
+ *                     N attempt(s) • mode" line and show it.  Convenience
+ *                     for hosts that just want the canonical format.
+ *
+ * Auto-clears its setTimeout on unmount so callers don't have to
+ * worry about setState-on-unmounted warnings.
+ */
+export interface UseStitchStatsToastReturn {
+    message: string | null;
+    showFor: (msg: string, ms?: number) => void;
+    showResult: (result: IncrementalFinalizeResult, ms?: number) => void;
+}
+export declare function useStitchStatsToast(): UseStitchStatsToastReturn;
+//# sourceMappingURL=CaptureStitchStatsToast.d.ts.map

package/dist/camera/CaptureStitchStatsToast.js

@@ -0,0 +1,133 @@
+"use strict";
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * CaptureStitchStatsToast — auto-dismissing toast that shows the
+ * batch-stitcher's leaveBiggestComponent telemetry + the resolved
+ * cv::Stitcher mode after every successful finalize.
+ *
+ * Pattern: top-center capsule, dark translucent background, dismisses
+ * itself after `dismissAfterMs` (default 4500).  Replaces the
+ * Alert.alert blocking modal that used to interrupt the next
+ * capture.  See `useStitchStatsToast` hook for the matching
+ * imperative API.
+ *
+ * Layer-2 hosts can mount this directly + pass their own message;
+ * Layer-1 `<Camera>` mounts it under `settings.debug` and feeds
+ * the formatted message from the finalize result automatically.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptureStitchStatsToast = CaptureStitchStatsToast;
+exports.useStitchStatsToast = useStitchStatsToast;
+const react_1 = __importStar(require("react"));
+const react_native_1 = require("react-native");
+function CaptureStitchStatsToast({ message, topInset = 0, }) {
+    if (message === null)
+        return null;
+    return (react_1.default.createElement(react_native_1.View, { pointerEvents: "none", style: [
+            styles.wrap,
+            { top: topInset + 12 },
+        ] },
+        react_1.default.createElement(react_native_1.View, { style: styles.capsule, accessibilityRole: "alert", accessibilityLiveRegion: "polite" },
+            react_1.default.createElement(react_native_1.Text, { style: styles.text, numberOfLines: 3 }, message))));
+}
+const styles = react_native_1.StyleSheet.create({
+    wrap: {
+        position: 'absolute',
+        left: 24,
+        right: 24,
+        alignItems: 'center',
+        zIndex: 110,
+    },
+    capsule: {
+        paddingHorizontal: 16,
+        paddingVertical: 10,
+        borderRadius: 16,
+        backgroundColor: 'rgba(15, 23, 42, 0.92)',
+        maxWidth: '100%',
+    },
+    text: {
+        color: '#ffffff',
+        fontSize: 13,
+        fontWeight: '600',
+        textAlign: 'center',
+    },
+});
+const DEFAULT_DISMISS_MS = 4500;
+function useStitchStatsToast() {
+    const [message, setMessage] = (0, react_1.useState)(null);
+    const timerRef = (0, react_1.useRef)(null);
+    const showFor = (0, react_1.useCallback)((msg, ms = DEFAULT_DISMISS_MS) => {
+        if (timerRef.current)
+            clearTimeout(timerRef.current);
+        setMessage(msg);
+        timerRef.current = setTimeout(() => {
+            setMessage(null);
+            timerRef.current = null;
+        }, ms);
+    }, []);
+    const showResult = (0, react_1.useCallback)((result, ms = DEFAULT_DISMISS_MS) => {
+        // Format mirrors the RetaiLens debug toast that operators
+        // already recognise.  Includes the new (audit F2g) resolved
+        // stitchMode as a fourth segment when present.
+        const requested = result.framesRequested;
+        const included = result.framesIncluded;
+        const thresh = result.finalConfidenceThresh;
+        const mode = result.stitchModeResolved;
+        // The retry-attempt count is derived deterministically from
+        // the threshold used on the successful attempt (1.0→1, 0.5→2,
+        // 0.3→3) per cpp/stitcher.cpp's retry loop.
+        const attempts = typeof thresh === 'number'
+            ? thresh >= 0.99 ? 1
+                : thresh >= 0.49 ? 2
+                    : thresh >= 0.29 ? 3
+                        : null
+            : null;
+        const reqStr = typeof requested === 'number' ? requested : '?';
+        const incStr = typeof included === 'number' ? included : '?';
+        const threshStr = typeof thresh === 'number' && thresh >= 0
+            ? thresh.toFixed(2)
+            : 'n/a';
+        const attStr = attempts !== null ? `${attempts} attempt${attempts > 1 ? 's' : ''}` : '? attempts';
+        const modeStr = mode ? ` • ${mode}` : '';
+        showFor(`Stitch: ${incStr}/${reqStr} frames • thresh ${threshStr} • ${attStr}${modeStr}`, ms);
+    }, [showFor]);
+    (0, react_1.useEffect)(() => () => {
+        if (timerRef.current)
+            clearTimeout(timerRef.current);
+    }, []);
+    return { message, showFor, showResult };
+}
+//# sourceMappingURL=CaptureStitchStatsToast.js.map