react-native-image-stitcher 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -16,6 +16,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.3] — 2026-05-21
+
+### Changed
+
+- **Docs / source-comment cleanup.** Removed the leftover
+  pre-extraction RetaiLens-monorepo framing from the README — this repo
+  is now the canonical, self-contained source of `react-native-image-
+  stitcher`, not a downstream subtree of anything.  Source-file path
+  comments and iOS GCD queue labels now use the canonical
+  `io.imagestitcher.*` namespace and `react-native-image-stitcher/`
+  repo path instead of the leftover `com.retailens.*` /
+  `retailens-capture-sdk/` references that survived the 0.1.0 rename.
+  GCD label change affects: `RNSARSession.poseLogQueue`,
+  `IncrementalStitcher.workQueue`, `IncrementalStitcher.refineQueue` —
+  labels are diagnostic-only (Instruments / crash-report symbolication),
+  no public-API or behaviour impact.  The CHANGELOG.md migration table
+  for [0.1.0] retains the historical `com.retailens.capturesdk` name
+  intentionally — it documents the rename that shipped, not the
+  current state.
+- **CHANGELOG.** Added compare-links for [0.1.1] and [0.1.2] and fixed
+  the [Unreleased] compare base.  Annotated the [0.1.0] "Deliberately
+  NOT exported" section with a header note explaining that most of
+  those entries were promoted to public in [0.1.1] — see the 0.1.1
+  *Added* list for the current public surface.
+
 ## [0.1.2] — 2026-05-20
 
 ### Added
@@ -160,6 +185,16 @@ The following are intentionally internal so the public surface stays
 small.  If you have a real use-case for any of these, please open an
 issue describing it.
 
+> [!NOTE]
+> **This list reflects the v0.1.0 surface as shipped.**  Most of the
+> entries below — the layer-2 hooks, views, UI components, and
+> incremental-engine primitives — were subsequently promoted to public
+> in [0.1.1].  See the 0.1.1 *Added* section for the current public
+> surface; only a few items below remain internal in later releases
+> (`CameraShutter`, `PanoramaConfirmModal`, `IncrementalStitcherView`,
+> `stitchFrames`, `StitchNotImplementedError`, `runQualityCheck`,
+> `normaliseOrientation`).
+
 - `useCapture`, `useDeviceOrientation` — internal hooks `<Camera>`
   composes; expose these only after we have a story for what their
   separate-from-`<Camera>` use-case looks like.
@@ -206,5 +241,8 @@ Native module names also changed:
 - iOS pod: `RetaiLensCaptureSDK` → `RNImageStitcher`
 - iOS xcframework: shipped as `opencv2.xcframework` (linked from `RNImageStitcher.podspec`)
 
-[Unreleased]: https://github.com/bhargavkanda/react-native-image-stitcher/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/bhargavkanda/react-native-image-stitcher/compare/v0.1.3...HEAD
+[0.1.3]: https://github.com/bhargavkanda/react-native-image-stitcher/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/bhargavkanda/react-native-image-stitcher/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/bhargavkanda/react-native-image-stitcher/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/bhargavkanda/react-native-image-stitcher/releases/tag/v0.1.0

package/README.md

@@ -4,15 +4,6 @@
 One `<Camera>` component, both tap-to-photo and hold-to-pan modes, both
 AR-backed and IMU-fallback capture paths.
 
-> [!NOTE]
-> This package lives in the [RetaiLens monorepo](https://github.com/bhargav-kanda/RetaiLens)
-> under `retailens-capture-sdk/` during development.  At publication
-> (see [`2026-05-15-react-native-image-stitcher-publication.md`](https://github.com/bhargav-kanda/RetaiLens/blob/main/docs/site-content/design/2026-05-15-react-native-image-stitcher-publication.md))
-> the public subset is `git subtree split` extracted to a standalone
-> repo at `github.com/bhargavkanda/react-native-image-stitcher` and
-> published to npm.  This README describes the **public lib** as it
-> will look post-extraction.
-
 ## What it does
 
 | Feature | Behaviour |

package/android/src/main/cpp/keyframe_gate_jni.cpp

@@ -2,7 +2,7 @@
 //
 // keyframe_gate_jni.cpp — JNI bindings exposing the shared C++
 // retailens::KeyframeGate (in ../../../../cpp/) to the Kotlin side
-// (com.retailens.capturesdk.KeyframeGate).
+// (io.imagestitcher.rn.KeyframeGate).
 //
 // Architecture parity with iOS:
 //   iOS uses an Obj-C++ bridge (KeyframeGateBridge.mm) to wrap the

package/android/src/main/java/io/imagestitcher/rn/BatchStitcher.kt

@@ -50,7 +50,7 @@ class BatchStitcher(reactContext: ReactApplicationContext)
      * JNI bridge to our custom-built OpenCV stitcher.  Mirrors iOS'
      * OpenCVStitcher.stitchFramePaths so the batch-keyframe flow has
      * parity across platforms.  Implementation:
-     *   retailens-capture-sdk/android/src/main/cpp/image_stitcher_jni.cpp
+     *   react-native-image-stitcher/android/src/main/cpp/image_stitcher_jni.cpp
      *
      * @param framePaths  input JPEG paths in capture order (≥2 required)
      * @param outputPath  destination JPEG path

package/android/src/main/java/io/imagestitcher/rn/IncrementalStitcher.kt

@@ -193,7 +193,7 @@ class IncrementalStitcher(
     /// (handleBatchKeyframeFrame above) with the same pose-driven
     /// 40%-new-content algorithm iOS has used since the V16 ship.
     /// Both platforms call into retailens::KeyframeGate (in
-    /// retailens-capture-sdk/cpp/keyframe_gate.cpp) — see that file
+    /// react-native-image-stitcher/cpp/keyframe_gate.cpp) — see that file
     /// for the algorithm.
     ///
     /// Lifetime: owned for the life of the module.  Closed in
@@ -1159,7 +1159,7 @@ class IncrementalStitcher(
     // iOS exposes these on the IncrementalStitcherBridge (NOT on the
     // ARSession module) so the JS code calls
     //   getIncrementalNativeModule().getARPlaneStatus()
-    // (see retailens-capture-sdk/src/stitching/incremental.ts:535).
+    // (see react-native-image-stitcher/src/stitching/incremental.ts:535).
     // Both methods delegate to the AR session singleton — same pattern
     // as iOS' IncrementalStitcherBridge.swift, where the bridge holds
     // the RN @objc surface and the singleton holds the AR algorithm.

package/android/src/main/java/io/imagestitcher/rn/KeyframeGate.kt

@@ -3,7 +3,7 @@ package io.imagestitcher.rn
 
 /**
  * Kotlin facade over the shared C++ KeyframeGate (in
- * retailens-capture-sdk/cpp/keyframe_gate.{hpp,cpp}).
+ * react-native-image-stitcher/cpp/keyframe_gate.{hpp,cpp}).
  *
  * Architecture parity with iOS:
  *   iOS uses an Obj-C++ bridge (KeyframeGateBridge.mm) to wrap the

package/dist/stitching/stitchFrames.d.ts

@@ -5,7 +5,7 @@
  *   - iOS: Swift native module that vendors upstream OpenCV's iOS
  *     framework and calls `cv::Stitcher::SCANS` mode (designed for
  *     translational shelf captures).  Lives in
- *     `retailens-capture-sdk/ios/Sources/RNImageStitcher/`.
+ *     `react-native-image-stitcher/ios/Sources/RNImageStitcher/`.
  *   - Android: deferred to Phase 3 — same OpenCV surface, different
  *     build (NDK + Gradle).  Until that lands, Android calls hit the
  *     `StitchNotImplementedError` path below.

package/dist/stitching/stitchFrames.js

@@ -7,7 +7,7 @@
  *   - iOS: Swift native module that vendors upstream OpenCV's iOS
  *     framework and calls `cv::Stitcher::SCANS` mode (designed for
  *     translational shelf captures).  Lives in
- *     `retailens-capture-sdk/ios/Sources/RNImageStitcher/`.
+ *     `react-native-image-stitcher/ios/Sources/RNImageStitcher/`.
  *   - Android: deferred to Phase 3 — same OpenCV surface, different
  *     build (NDK + Gradle).  Until that lands, Android calls hit the
  *     `StitchNotImplementedError` path below.

package/ios/Package.swift

@@ -16,7 +16,7 @@
 //
 // Run from this directory:
 //
-//   cd retailens-capture-sdk/ios
+//   cd react-native-image-stitcher/ios
 //   swift test
 
 import PackageDescription

package/ios/Sources/RNImageStitcher/IncrementalStitcher.swift

@@ -289,7 +289,7 @@ public final class IncrementalStitcher: NSObject {
     /// fix is non-trivial; deferred until pose-driven stitch work
     /// lands (which will rework the queue topology anyway).
     private let workQueue = DispatchQueue(
-        label: "com.retailens.incremental.stitcher",
+        label: "io.imagestitcher.incremental.stitcher",
         qos: .userInitiated
     )
 
@@ -306,7 +306,7 @@ public final class IncrementalStitcher: NSObject {
     /// is out of scope for this MVP — see prompt's "deliberately out
     /// of scope" list).
     private let refineQueue = DispatchQueue(
-        label: "com.retailens.incremental.refine",
+        label: "io.imagestitcher.incremental.refine",
         qos: .utility
     )
 
@@ -1136,7 +1136,7 @@ public final class IncrementalStitcher: NSObject {
         // Why this matters (RCA from Sentry crashes 2026-05-09
         // 21:59-22:03, all 3 .ips traces):
         //   EXC_BAD_ACCESS at objc_retain+16, frame 1 = closure #1
-        //   in finalize+2648, queue = com.retailens.incremental.
+        //   in finalize+2648, queue = io.imagestitcher.incremental.
         //   stitcher.  +2648 lands inside the os_log call that
         //   bridges self.batchWarperType → NSString via
         //   swift_bridgeObjectRetain → objc_retain.  The retain
@@ -1269,7 +1269,7 @@ public final class IncrementalStitcher: NSObject {
         // under stateLock, closing the visible torn-pointer race.
         // Three Sentry traces post-fix4 still showed the same crash
         // signature (frame 1 = closure #1 in finalize+N, queue =
-        // com.retailens.incremental.stitcher), which per the
+        // io.imagestitcher.incremental.stitcher), which per the
         // systematic-debugging skill (3+ fixes failed on the same
         // symptom = wrong architecture) means the workQueue.async
         // pattern itself is the problem, not any specific captured

package/ios/Sources/RNImageStitcher/KeyframeGate.swift

@@ -4,7 +4,7 @@
 //
 // This file used to BE the algorithm (~545 lines of Swift simd math).
 // As of P3-B of the Android-iOS parity work, the algorithm lives in
-// retailens-capture-sdk/cpp/keyframe_gate.{hpp,cpp} and is shared with
+// react-native-image-stitcher/cpp/keyframe_gate.{hpp,cpp} and is shared with
 // the Android side via JNI.  This Swift class is now a thin facade
 // that:
 //

package/ios/Sources/RNImageStitcher/KeyframeGateBridge.h

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 //
 // KeyframeGateBridge.h — Obj-C++ wrapper exposing the shared C++
-// KeyframeGate (in retailens-capture-sdk/cpp/) to Swift.
+// KeyframeGate (in react-native-image-stitcher/cpp/) to Swift.
 //
 // Why this exists:
 //   The pose-driven keyframe-selection algorithm is the single most

package/ios/Sources/RNImageStitcher/KeyframeGateBridge.mm

@@ -18,7 +18,7 @@
 // Single source of truth for the reason-code → string mapping.  These
 // strings MUST stay 1:1 with the labels emitted by the original
 // KeyframeGate.swift (and read by the JS telemetry layer in
-// retailens-capture-sdk/src/stitching/incremental.ts).  Drift will
+// react-native-image-stitcher/src/stitching/incremental.ts).  Drift will
 // silently break the JS UI's pill text.
 static NSString *kReasonStringFor(retailens::KeyframeGateDecisionReason r) {
     using R = retailens::KeyframeGateDecisionReason;

package/ios/Sources/RNImageStitcher/RNSARSession.swift

@@ -150,7 +150,7 @@ public final class RNSARSession: NSObject, ARSessionDelegate {
     /// recordings.  Phase 5 stitching will query by timestamp.
     private var poseLog: [(TimeInterval, RNSARFramePose)] = []
     private let poseLogQueue = DispatchQueue(
-        label: "com.retailens.arsession.poselog",
+        label: "io.imagestitcher.arsession.poselog",
         attributes: .concurrent
     )
     private static let MAX_POSE_LOG = 600  // ~10 s @ 60Hz

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-image-stitcher",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Pose-aware panorama capture + stitching for React Native. One <Camera> component, both tap-to-photo and hold-to-pan modes, both AR-backed and IMU-fallback capture paths.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/stitching/stitchFrames.ts

@@ -6,7 +6,7 @@
  *   - iOS: Swift native module that vendors upstream OpenCV's iOS
  *     framework and calls `cv::Stitcher::SCANS` mode (designed for
  *     translational shelf captures).  Lives in
- *     `retailens-capture-sdk/ios/Sources/RNImageStitcher/`.
+ *     `react-native-image-stitcher/ios/Sources/RNImageStitcher/`.
  *   - Android: deferred to Phase 3 — same OpenCV surface, different
  *     build (NDK + Gradle).  Until that lands, Android calls hit the
  *     `StitchNotImplementedError` path below.