react-native-image-stitcher 0.14.2 → 0.15.0

package/cpp/tests/stitcher_worklet_registry_test.cpp

@@ -1,195 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-//
-// stitcher_worklet_registry_test.cpp — v0.10.0 audit #9A
-//
-// Lifecycle + concurrency coverage for the process-scope native
-// `StitcherWorkletRegistry` introduced in v0.8.0 Phase 4b.  See
-// `cpp/stitcher_worklet_registry.hpp` for the public contract.
-//
-// The registry's production `install(runtime, workletValue)` path
-// constructs an `RNWorklet::WorkletInvoker` from a JSI `Runtime` and
-// `Value`.  Standing up a real worklets-core runtime under gtest would
-// pull in Hermes + JSI + the whole worklets-core library — too heavy
-// for these scope-limited storage tests.  Instead we exercise the
-// equivalent `_installEntryForTests(invoker)` test seam (mirrors
-// `_resetForTests` in pattern) with `nullptr` invokers.  The registry
-// never dereferences the pointer — it only stores the shared_ptr and
-// hands it back via `snapshot` — so nullptr is safe.
-//
-// What this covers (lifting from the production `install`/`uninstall`/
-// `snapshot`/`count` contract):
-//   - shared() returns the same instance across calls
-//   - count/snapshot start empty after _resetForTests
-//   - install assigns monotonically increasing host-N IDs
-//   - count tracks installs / uninstalls
-//   - uninstall of an unknown ID is a no-op (matches JS side)
-//   - snapshot returns an independent copy (mutations after snapshot
-//     don't affect the snapshot's view)
-//   - concurrent installs from many threads serialise correctly and
-//     yield unique IDs (no double-issue under contention)
-
-#include "stitcher_worklet_registry.hpp"
-#include <react-native-worklets-core/WKTJsiWorklet.h>
-
-#include <gtest/gtest.h>
-
-#include <algorithm>
-#include <atomic>
-#include <chrono>
-#include <set>
-#include <string>
-#include <thread>
-#include <vector>
-
-using retailens::StitcherWorkletEntry;
-using retailens::StitcherWorkletRegistry;
-
-namespace {
-
-/// Test fixture — resets the singleton before each test so cases
-/// don't leak state into each other.  Without this every test would
-/// see the cumulative entries from prior tests in the run.
-class StitcherWorkletRegistryTest : public ::testing::Test {
- protected:
-  void SetUp() override {
-    StitcherWorkletRegistry::shared()._resetForTests();
-  }
-  void TearDown() override {
-    StitcherWorkletRegistry::shared()._resetForTests();
-  }
-};
-
-}  // namespace
-
-TEST_F(StitcherWorkletRegistryTest, SharedReturnsSameInstance) {
-  // The singleton invariant is load-bearing for the JS-side mental
-  // model: `useFrameProcessor` mounts on one component and unmounts
-  // from another but the registry stays.
-  StitcherWorkletRegistry& a = StitcherWorkletRegistry::shared();
-  StitcherWorkletRegistry& b = StitcherWorkletRegistry::shared();
-  EXPECT_EQ(&a, &b);
-}
-
-TEST_F(StitcherWorkletRegistryTest, StartsEmptyAfterReset) {
-  auto& r = StitcherWorkletRegistry::shared();
-  EXPECT_EQ(r.count(), 0u);
-  EXPECT_TRUE(r.snapshot().empty());
-}
-
-TEST_F(StitcherWorkletRegistryTest, InstallAssignsHostPrefixedIncrementingIds) {
-  auto& r = StitcherWorkletRegistry::shared();
-  const std::string id0 = r._installEntryForTests(nullptr);
-  const std::string id1 = r._installEntryForTests(nullptr);
-  const std::string id2 = r._installEntryForTests(nullptr);
-
-  // IDs are "host-N" with N monotonically increasing from 0 after a
-  // reset.  The format is part of the public contract — uninstall
-  // callers store these IDs verbatim.
-  EXPECT_EQ(id0, "host-0");
-  EXPECT_EQ(id1, "host-1");
-  EXPECT_EQ(id2, "host-2");
-  EXPECT_EQ(r.count(), 3u);
-}
-
-TEST_F(StitcherWorkletRegistryTest, UninstallRemovesByIdAndUpdatesCount) {
-  auto& r = StitcherWorkletRegistry::shared();
-  const std::string id0 = r._installEntryForTests(nullptr);
-  const std::string id1 = r._installEntryForTests(nullptr);
-  const std::string id2 = r._installEntryForTests(nullptr);
-  EXPECT_EQ(r.count(), 3u);
-
-  r.uninstall(id1);  // remove the middle entry
-  EXPECT_EQ(r.count(), 2u);
-
-  // Snapshot should contain only id0 and id2, in some order — the
-  // contract doesn't promise insertion order survives uninstall
-  // (the erase-remove pattern is stable in practice but we don't
-  // pin that publicly).
-  const auto snap = r.snapshot();
-  std::vector<std::string> remainingIds;
-  remainingIds.reserve(snap.size());
-  for (const auto& entry : snap) {
-    remainingIds.push_back(entry.id);
-  }
-  std::sort(remainingIds.begin(), remainingIds.end());
-  EXPECT_EQ(remainingIds, (std::vector<std::string>{id0, id2}));
-}
-
-TEST_F(StitcherWorkletRegistryTest, UninstallOfUnknownIdIsNoop) {
-  // Matches the JS-side `StitcherWorkletRegistry.uninstall` semantics
-  // (idempotent, no throw on unknown).  Critical because the JS
-  // useEffect cleanup can fire after an unmount/remount race where the
-  // ID has already been removed.
-  auto& r = StitcherWorkletRegistry::shared();
-  r._installEntryForTests(nullptr);
-  EXPECT_EQ(r.count(), 1u);
-  EXPECT_NO_THROW(r.uninstall("host-does-not-exist"));
-  EXPECT_NO_THROW(r.uninstall(""));
-  EXPECT_EQ(r.count(), 1u);  // existing entry untouched
-}
-
-TEST_F(StitcherWorkletRegistryTest, SnapshotIsIndependentOfFutureMutations) {
-  // Per header docstring: "mutations against the registry after
-  // `snapshot` returns do not affect the snapshot."  This matters for
-  // the AR-session dispatch path, which snapshots and then iterates
-  // without holding the registry lock — concurrent uninstall on the
-  // JS thread must NOT invalidate the snapshot.
-  auto& r = StitcherWorkletRegistry::shared();
-  const std::string id0 = r._installEntryForTests(nullptr);
-  const std::string id1 = r._installEntryForTests(nullptr);
-
-  const auto snap = r.snapshot();
-  ASSERT_EQ(snap.size(), 2u);
-
-  r.uninstall(id0);
-  r.uninstall(id1);
-  EXPECT_EQ(r.count(), 0u);
-
-  // Snapshot still has both entries.
-  EXPECT_EQ(snap.size(), 2u);
-  EXPECT_EQ(snap[0].id, id0);
-  EXPECT_EQ(snap[1].id, id1);
-}
-
-TEST_F(StitcherWorkletRegistryTest, ConcurrentInstallsYieldUniqueIds) {
-  // Many threads racing `_installEntryForTests` simultaneously must
-  // not see duplicate IDs (would indicate the mutex around _nextId is
-  // missing or broken).  This is the per-instance equivalent of
-  // TransferredNV21Test's "only one of N concurrent callers wins"
-  // pattern, adapted for "all N callers succeed but produce distinct
-  // IDs".
-  auto& r = StitcherWorkletRegistry::shared();
-  constexpr int kThreads = 16;
-  constexpr int kPerThread = 32;  // 512 total installs
-
-  std::vector<std::thread> workers;
-  workers.reserve(kThreads);
-  std::vector<std::vector<std::string>> idsPerThread(kThreads);
-
-  std::atomic<bool> go{false};
-  for (int t = 0; t < kThreads; ++t) {
-    workers.emplace_back([&, t]() {
-      while (!go.load(std::memory_order_acquire)) {
-        std::this_thread::yield();
-      }
-      for (int i = 0; i < kPerThread; ++i) {
-        idsPerThread[t].push_back(r._installEntryForTests(nullptr));
-      }
-    });
-  }
-  go.store(true, std::memory_order_release);
-  for (auto& w : workers) w.join();
-
-  // Aggregate every ID issued.  Total count = kThreads * kPerThread;
-  // uniqueness = the set size matches.
-  std::set<std::string> allIds;
-  for (const auto& v : idsPerThread) {
-    for (const auto& id : v) {
-      allIds.insert(id);
-    }
-  }
-  EXPECT_EQ(allIds.size(),
-            static_cast<std::size_t>(kThreads * kPerThread));
-  EXPECT_EQ(r.count(),
-            static_cast<std::size_t>(kThreads * kPerThread));
-}

package/dist/stitching/IncrementalStitcherView.d.ts

@@ -1,41 +0,0 @@
-/**
- * IncrementalStitcherView — live preview component for the panorama
- * engine.  Renders the latest snapshot JPEG written by the native
- * side, with confidence + hint overlays.
- *
- * Why <Image> + cache-bust query string instead of a custom native
- * view: per the design doc's open question, the JPEG-write approach
- * is V1; if perf measurements show we're hitting RN's image cache
- * too hard, swap in an `Animated.Image` or a native UIView with
- * an in-memory bitmap.  Until then, the simple path keeps the
- * cross-platform surface tiny.
- */
-import React from 'react';
-import { type ViewStyle } from 'react-native';
-import type { IncrementalState } from './incremental';
-import type { IncrementalHint } from './useIncrementalStitcher';
-export interface IncrementalStitcherViewProps {
-    /** Latest engine state — typically `useIncrementalStitcher().state`. */
-    state: IncrementalState | null;
-    /**
-     * Active hint to surface as a banner overlay.  Pass
-     * `useIncrementalStitcher().hint` directly; the view picks the
-     * right wording.
-     */
-    hint: IncrementalHint;
-    /**
-     * Confidence ring colour driver — typically
-     * `useIncrementalStitcher().confidenceLevel`.
-     */
-    confidenceLevel?: 'high' | 'medium' | null;
-    /** Outer container style (size, position).  Required: the view
-     *  has no intrinsic size since the panorama dimensions vary. */
-    style?: ViewStyle;
-    /**
-     * Optional override for the spinner shown before the first frame
-     * is accepted.  Default is a subtle "Pan to begin" caption.
-     */
-    emptyText?: string;
-}
-export declare function IncrementalStitcherView({ state, hint, confidenceLevel, style, emptyText, }: IncrementalStitcherViewProps): React.JSX.Element;
-//# sourceMappingURL=IncrementalStitcherView.d.ts.map

package/dist/stitching/IncrementalStitcherView.js

@@ -1,157 +0,0 @@
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-/**
- * IncrementalStitcherView — live preview component for the panorama
- * engine.  Renders the latest snapshot JPEG written by the native
- * side, with confidence + hint overlays.
- *
- * Why <Image> + cache-bust query string instead of a custom native
- * view: per the design doc's open question, the JPEG-write approach
- * is V1; if perf measurements show we're hitting RN's image cache
- * too hard, swap in an `Animated.Image` or a native UIView with
- * an in-memory bitmap.  Until then, the simple path keeps the
- * cross-platform surface tiny.
- */
-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.IncrementalStitcherView = IncrementalStitcherView;
-const react_1 = __importStar(require("react"));
-const react_native_1 = require("react-native");
-function hintMessage(hint) {
-    switch (hint) {
-        case 'slow-down': return 'Slow down — alignment lost';
-        case 'scene-uniform': return 'Pan to a textured area';
-        case 'alignment-lost': return 'Slow down — re-acquiring alignment';
-        case 'tracking-poor': return 'Hold steady — AR re-acquiring';
-        default: return null;
-    }
-}
-function IncrementalStitcherView({ state, hint, confidenceLevel, style, emptyText = 'Pan to begin capturing', }) {
-    // Cache-bust the panorama URI.  The native side rotates through
-    // 4 filenames so the path itself changes between snapshots, plus
-    // we tag with acceptedCount as belt-and-suspenders since RN's
-    // image cache on iOS sometimes ignores file:// query strings.
-    const imageUri = (0, react_1.useMemo)(() => {
-        if (!state?.panoramaPath)
-            return null;
-        return `file://${state.panoramaPath}?v=${state.acceptedCount}`;
-    }, [state?.panoramaPath, state?.acceptedCount]);
-    // Use the panorama's NATURAL aspect ratio so the strip widens as
-    // the user pans across.  Falls back to 4:3 (a single frame's
-    // shape) before any snapshot has been written.  Without this the
-    // PiP was forced into a 3:1 letterbox, cropping the actual
-    // panorama to a thin slice across the middle.
-    const naturalAspect = state?.width && state?.height && state.height > 0
-        ? state.width / state.height
-        : 4 / 3;
-    const ringColor = confidenceLevel === 'high'
-        ? '#1aaf5d'
-        : confidenceLevel === 'medium'
-            ? '#e6b800'
-            : 'rgba(255,255,255,0.35)';
-    const message = hintMessage(hint);
-    return (react_1.default.createElement(react_native_1.View, { style: [styles.container, { aspectRatio: naturalAspect }, style] },
-        imageUri ? (
-        // `contain` so the FULL panorama is visible inside the
-        // strip, not cropped to a slice.  Background fills the
-        // letterbox edges.  Key={acceptedCount} forces RN to
-        // remount the Image component each accept — the surest
-        // way to defeat the native image cache on file:// URIs.
-        react_1.default.createElement(react_native_1.Image, { key: state?.acceptedCount ?? 0, source: { uri: imageUri }, style: react_native_1.StyleSheet.absoluteFill, resizeMode: "contain", fadeDuration: 0 })) : (react_1.default.createElement(react_native_1.View, { style: styles.empty },
-            react_1.default.createElement(react_native_1.ActivityIndicator, { color: "#fff" }),
-            react_1.default.createElement(react_native_1.Text, { style: styles.emptyText }, emptyText))),
-        react_1.default.createElement(react_native_1.View, { pointerEvents: "none", style: [styles.ring, { borderColor: ringColor }] }),
-        message ? (react_1.default.createElement(react_native_1.View, { pointerEvents: "none", style: styles.hintBanner },
-            react_1.default.createElement(react_native_1.Text, { style: styles.hintText }, message))) : null,
-        state ? (react_1.default.createElement(react_native_1.View, { pointerEvents: "none", style: styles.counterPill },
-            react_1.default.createElement(react_native_1.Text, { style: styles.counterText },
-                state.acceptedCount,
-                " frame",
-                state.acceptedCount === 1 ? '' : 's'))) : null));
-}
-const styles = react_native_1.StyleSheet.create({
-    container: {
-        backgroundColor: 'rgba(0,0,0,0.7)',
-        overflow: 'hidden',
-        borderRadius: 8,
-    },
-    empty: {
-        ...react_native_1.StyleSheet.absoluteFillObject,
-        alignItems: 'center',
-        justifyContent: 'center',
-        gap: 6,
-    },
-    emptyText: {
-        color: '#fff',
-        fontSize: 12,
-        opacity: 0.85,
-    },
-    ring: {
-        ...react_native_1.StyleSheet.absoluteFillObject,
-        borderRadius: 8,
-        borderWidth: 2,
-    },
-    hintBanner: {
-        position: 'absolute',
-        left: 8,
-        right: 8,
-        bottom: 8,
-        paddingVertical: 4,
-        paddingHorizontal: 8,
-        backgroundColor: 'rgba(220, 53, 69, 0.92)',
-        borderRadius: 6,
-    },
-    hintText: {
-        color: '#fff',
-        fontSize: 11,
-        textAlign: 'center',
-        fontWeight: '500',
-    },
-    counterPill: {
-        position: 'absolute',
-        top: 6,
-        right: 6,
-        paddingVertical: 2,
-        paddingHorizontal: 8,
-        backgroundColor: 'rgba(0, 0, 0, 0.55)',
-        borderRadius: 10,
-    },
-    counterText: {
-        color: '#fff',
-        fontSize: 10,
-        fontWeight: '500',
-    },
-});
-//# sourceMappingURL=IncrementalStitcherView.js.map

package/dist/stitching/StitcherWorkletRegistry.d.ts

@@ -1,117 +0,0 @@
-import type { StitcherFrameProcessor } from './StitcherFrame';
-/**
- * v0.8.0 Phase 4a — process-scope registry of host-supplied worklets
- * that the v0.8.0 `useFrameProcessor` hook registers into.
- *
- * ## What this is (Phase 4a)
- *
- * A plain JS singleton holding an ordered list of registered
- * worklets.  Hosts mount the `useFrameProcessor` hook (in this
- * directory); the hook registers its worklet into this singleton
- * on mount and unregisters on unmount.  Each entry carries:
- *
- *   - `id`: stable identifier issued by `register`; passed to
- *     `unregister`.
- *   - `worklet`: the host's `StitcherFrameProcessor` function.
- *     MUST be `'worklet'`-prefixed at the call site (TS can't
- *     enforce that — convention).
- *   - `isFirstParty`: `false` for host-supplied worklets;
- *     reserved for the lib's own first-party stitching path which
- *     today is wired natively (not through this registry).
- *
- * Order is stable: first-party entries (none in Phase 4a) come
- * first, then host entries by registration order.  Re-registration
- * of the same worklet by identity yields a new entry — hosts that
- * re-render and call `register` again ARE responsible for calling
- * `unregister` first.  The `useFrameProcessor` hook handles this
- * via its `deps` dependency array.
- *
- * ## What this is NOT (Phase 4b)
- *
- * **The native AR worklet runtime does NOT yet read this registry.**
- * Worklets registered here for AR-mode captures will not fire
- * until Phase 4b lands the cross-runtime handoff (a
- * worklets-core `SharedValue` mirror that `RNSARWorkletRuntime`
- * reads on each `dispatchFrame:pose:` call; the runtime then
- * constructs a `StitcherFrameHostObject` + invokes each
- * registered worklet via `RNWorklet::WorkletInvoker::call`).
- *
- * In non-AR mode the host-supplied worklet IS invoked, but via
- * vision-camera's Frame Processor runtime directly (the
- * `useFrameProcessor` hook returns vc's processor object which
- * `<Camera>` passes to vision-camera).  So Phase 4a's public API
- * is fully functional for non-AR; AR is API-stable but
- * runtime-deferred.
- *
- * ## Singleton lifetime
- *
- * The registry is a module-level instance.  It lives for the
- * lifetime of the JS runtime (= until app reload).  Entries
- * accumulate only via `register` and shed only via `unregister`
- * — no GC / weak-ref logic.  Hosts that mount `useFrameProcessor`
- * inside React components MUST rely on the hook's effect cleanup
- * to unregister on unmount, or they'll leak entries until
- * reload.  The hook handles this correctly today.
- *
- * ## Why a singleton (vs context provider)
- *
- * The native AR worklet runtime is itself a process-scope
- * singleton (`RNSARWorkletRuntime`, `StitcherWorkletRuntime`).
- * The Phase 4b handoff between TS and native is necessarily
- * process-scope.  Wrapping the registry in a React context
- * would force every consumer to be in the same provider tree
- * which is friction for layer-2 hosts that compose
- * `<ARCameraView>` / `useIncrementalStitcher` themselves.  The
- * singleton is the right shape; the React-level ergonomics are
- * provided by the `useFrameProcessor` hook.
- */
-export interface StitcherWorkletEntry {
-    readonly id: string;
-    readonly worklet: StitcherFrameProcessor;
-    readonly isFirstParty: boolean;
-}
-declare class Registry {
-    private entries;
-    private nextHostCounter;
-    /**
-     * Register a worklet.  Returns a stable ID for `unregister`.
-     *
-     * Entries are appended in registration order; first-party
-     * entries (if any are added in future) sort to the front.
-     */
-    register(opts: {
-        worklet: StitcherFrameProcessor;
-        isFirstParty?: boolean;
-    }): string;
-    /**
-     * Remove a previously-registered worklet by ID.  No-op if the ID
-     * isn't found.  Hosts call this in their effect's cleanup.
-     */
-    unregister(id: string): void;
-    /**
-     * Snapshot the current entries.  Returned array is a copy —
-     * mutations don't affect the registry.  Phase 4b's native
-     * handoff will read a `SharedValue` mirror of this list so the
-     * AR runtime doesn't need a JS-thread hop on the hot per-frame
-     * path; for Phase 4a this method is the JS-side accessor.
-     */
-    getEntries(): readonly StitcherWorkletEntry[];
-    /**
-     * Total number of registered worklets (first-party + host).
-     * Useful for diagnostics + tests.
-     */
-    get count(): number;
-    /**
-     * Test-only — clear all entries.  NOT exported from
-     * `src/index.ts`.  Used in unit tests to reset state between
-     * cases.
-     */
-    _resetForTests(): void;
-}
-/**
- * Process-scope singleton.  Imported by `useFrameProcessor` (in
- * this directory) + by the Phase 4b native-handoff code (TBD).
- */
-export declare const StitcherWorkletRegistry: Registry;
-export {};
-//# sourceMappingURL=StitcherWorkletRegistry.d.ts.map

package/dist/stitching/StitcherWorkletRegistry.js

@@ -1,78 +0,0 @@
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StitcherWorkletRegistry = void 0;
-class Registry {
-    constructor() {
-        this.entries = [];
-        this.nextHostCounter = 0;
-    }
-    /**
-     * Register a worklet.  Returns a stable ID for `unregister`.
-     *
-     * Entries are appended in registration order; first-party
-     * entries (if any are added in future) sort to the front.
-     */
-    register(opts) {
-        const isFirstParty = opts.isFirstParty ?? false;
-        const id = isFirstParty
-            ? `fp-${this.nextHostCounter++}`
-            : `host-${this.nextHostCounter++}`;
-        const entry = {
-            id,
-            worklet: opts.worklet,
-            isFirstParty,
-        };
-        this.entries.push(entry);
-        // Re-sort so first-party always runs before host entries.
-        // Stable sort: registration order is preserved within each
-        // partition.  Single-pass O(n log n) is fine — registration
-        // is rare (per-`<Camera>`-mount, not per-frame).
-        this.entries.sort((a, b) => {
-            if (a.isFirstParty !== b.isFirstParty) {
-                return a.isFirstParty ? -1 : 1;
-            }
-            return 0;
-        });
-        return id;
-    }
-    /**
-     * Remove a previously-registered worklet by ID.  No-op if the ID
-     * isn't found.  Hosts call this in their effect's cleanup.
-     */
-    unregister(id) {
-        this.entries = this.entries.filter((e) => e.id !== id);
-    }
-    /**
-     * Snapshot the current entries.  Returned array is a copy —
-     * mutations don't affect the registry.  Phase 4b's native
-     * handoff will read a `SharedValue` mirror of this list so the
-     * AR runtime doesn't need a JS-thread hop on the hot per-frame
-     * path; for Phase 4a this method is the JS-side accessor.
-     */
-    getEntries() {
-        return [...this.entries];
-    }
-    /**
-     * Total number of registered worklets (first-party + host).
-     * Useful for diagnostics + tests.
-     */
-    get count() {
-        return this.entries.length;
-    }
-    /**
-     * Test-only — clear all entries.  NOT exported from
-     * `src/index.ts`.  Used in unit tests to reset state between
-     * cases.
-     */
-    _resetForTests() {
-        this.entries = [];
-        this.nextHostCounter = 0;
-    }
-}
-/**
- * Process-scope singleton.  Imported by `useFrameProcessor` (in
- * this directory) + by the Phase 4b native-handoff code (TBD).
- */
-exports.StitcherWorkletRegistry = new Registry();
-//# sourceMappingURL=StitcherWorkletRegistry.js.map

package/dist/stitching/ensureStitcherProxyInstalled.d.ts

@@ -1,8 +0,0 @@
-export declare function ensureStitcherProxyInstalled(): boolean;
-/**
- * Test-only — reset module-internal state.  Used by jest to allow
- * multiple test cases to re-trigger the install path independently.
- * NOT exported from `src/index.ts`.
- */
-export declare function _resetStitcherProxyInstallStateForTests(): void;
-//# sourceMappingURL=ensureStitcherProxyInstalled.d.ts.map

package/dist/stitching/ensureStitcherProxyInstalled.js

@@ -1,81 +0,0 @@
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ensureStitcherProxyInstalled = ensureStitcherProxyInstalled;
-exports._resetStitcherProxyInstallStateForTests = _resetStitcherProxyInstallStateForTests;
-const react_native_1 = require("react-native");
-/**
- * `__DEV__` is RN's global dev-flag.  Guard the read with `typeof`
- * so the helper works in any environment that imports it without
- * defining __DEV__ (jest, SSR, custom tooling).  Same pattern RN's
- * own debug code uses.
- */
-function isDev() {
-    return typeof __DEV__ !== 'undefined' && __DEV__;
-}
-let installed = false;
-function ensureStitcherProxyInstalled() {
-    if (installed)
-        return true;
-    // Already installed by an earlier hook mount.  Cheap fast-path.
-    if (typeof globalThis.__stitcherProxy !== 'undefined') {
-        installed = true;
-        return true;
-    }
-    const mod = react_native_1.NativeModules
-        .StitcherJsiInstaller;
-    if (mod == null || typeof mod.install !== 'function') {
-        // Module not present — Android until Phase 4b.ii lands, or
-        // an old iOS build.  Surface this once at debug-info level so
-        // the host can see "your worklets are JS-registered only" in
-        // logcat / Console.app without a noisy per-frame warning.
-        if (isDev() && !warnedAboutMissingModule) {
-            warnedAboutMissingModule = true;
-            console.info('[react-native-image-stitcher] StitcherJsiInstaller native ' +
-                'module not found; host worklets registered in JS-side ' +
-                'registry only.  AR-mode dispatch requires the native install ' +
-                '(iOS Phase 4b.i — included in v0.8.0; Android Phase 4b.ii ' +
-                '— follow-up release).');
-        }
-        return false;
-    }
-    try {
-        const ok = mod.install();
-        if (!ok) {
-            // Native module ran but couldn't install (JSI runtime
-            // unreachable).  Same fallback as the missing-module case.
-            if (isDev() && !warnedAboutFailedInstall) {
-                warnedAboutFailedInstall = true;
-                console.info('[react-native-image-stitcher] StitcherJsiInstaller.install() ' +
-                    'returned false (JSI runtime unreachable — remote debug ' +
-                    'mode?).  Falling back to JS-side host worklet registry.');
-            }
-            return false;
-        }
-        installed = true;
-        return true;
-    }
-    catch (err) {
-        if (isDev() && !warnedAboutFailedInstall) {
-            warnedAboutFailedInstall = true;
-            console.info('[react-native-image-stitcher] StitcherJsiInstaller.install() ' +
-                'threw: ' +
-                String(err) +
-                '.  Falling back to JS-side host worklet registry.');
-        }
-        return false;
-    }
-}
-let warnedAboutMissingModule = false;
-let warnedAboutFailedInstall = false;
-/**
- * Test-only — reset module-internal state.  Used by jest to allow
- * multiple test cases to re-trigger the install path independently.
- * NOT exported from `src/index.ts`.
- */
-function _resetStitcherProxyInstallStateForTests() {
-    installed = false;
-    warnedAboutMissingModule = false;
-    warnedAboutFailedInstall = false;
-}
-//# sourceMappingURL=ensureStitcherProxyInstalled.js.map