gps-plus-slam-app-framework 1.8.0 → 1.9.1

package/dist/{app-selectors-JqydaUMN.d.ts → app-selectors-BbAiCRUT.d.ts}

@@ -1,4 +1,4 @@
-import { N as CombinedRootState, r as SlamAppRootState } from "./create-slam-app-store-D3nzh9Wb.js";
+import { N as CombinedRootState, r as SlamAppRootState } from "./create-slam-app-store-D1QSMuKu.js";
 import * as _$gps_plus_slam_js0 from "gps-plus-slam-js";
 import { ArImageCapture, GpsPoint, LatLong, Matrix4, Quaternion, Vector3 } from "gps-plus-slam-js";
 import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";

package/dist/ar/enable-gps-ar.d.ts

@@ -1,2 +1,2 @@
-import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "../enable-gps-ar-DvGzBOrp.js";
+import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "../enable-gps-ar-BBtRO2FJ.js";
 export { EnableGpsArConfig, EnableGpsArController, EnableGpsArDeps, EnableGpsArResult, EnableGpsArState, EnableGpsArStatus, createEnableGpsArController };

package/dist/ar/index.d.ts

@@ -11,8 +11,8 @@ import { a as ImageCaptureCallbacks, c as MIN_VALID_IMAGE_BYTES, i as FrameQuali
 import { _ as solveQrPose, a as QrPoseSolution, c as SolveQrPoseInput, d as intrinsicsFromProjection, f as invertPose, g as signedQuadArea, h as reprojectionErrorPx, i as Pose, l as buildObjectPoints, m as qrInCameraFromOpenCv, n as OpenCvPnpResult, o as QuadValidation, p as projectViewPoint, r as Point2, s as SolvePnpSquare, t as CameraIntrinsics, u as composePose, v as transformPoint, y as validateQuad } from "../qr-pose-y3vaEd6x.js";
 import { a as QrFrontEnd, c as createBarcodeDetectorFrontEnd, i as QrDetection, n as BarcodeDetectorLike, o as RgbaImage, r as DetectedBarcodeLike, s as ToImageBitmapSource, t as BarcodeDetectorFrontEnd } from "../qr-frontend-BPURlh3S.js";
 import { i as acquireCameraTexture, n as RendererLike, r as XRCameraLike, t as CameraTextureResult } from "../xr-camera-texture-q0eIDSRg.js";
-import { $ as stopImageCapture, B as setImageQualityAnalyzer, C as getImageCaptureFrameCount, D as initAR, H as setSessionEndCallback, I as setCameraFrameCallback, J as startCameraFrameCapture, K as setTrackingStore, L as setDepthCaptureCallback, Q as stopDepthCapture, R as setFrameCallback, S as getDepthSampleCount, T as getScene, U as setTrackingCallbacks, W as setTrackingLostCallback, X as startImageCapture, Y as startDepthCapture, Z as stopCameraFrameCapture, _ as getCamera, b as getCurrentArPose, f as endARSession, g as getArWorldGroup, i as CameraFrameCaptureConfig, o as SessionEndInfo, s as SessionFeatureOptions, w as getLiveCss3dManager, x as getDepthInfoFromFrame, y as getCameraFrameCount, z as setImageCaptureCallback } from "../webxr-session-cRG2SYAQ.js";
-import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "../enable-gps-ar-DvGzBOrp.js";
+import { $ as stopImageCapture, B as setImageQualityAnalyzer, C as getImageCaptureFrameCount, D as initAR, H as setSessionEndCallback, I as setCameraFrameCallback, J as startCameraFrameCapture, K as setTrackingStore, L as setDepthCaptureCallback, Q as stopDepthCapture, R as setFrameCallback, S as getDepthSampleCount, T as getScene, U as setTrackingCallbacks, W as setTrackingLostCallback, X as startImageCapture, Y as startDepthCapture, Z as stopCameraFrameCapture, _ as getCamera, b as getCurrentArPose, f as endARSession, g as getArWorldGroup, i as CameraFrameCaptureConfig, o as SessionEndInfo, s as SessionFeatureOptions, w as getLiveCss3dManager, x as getDepthInfoFromFrame, y as getCameraFrameCount, z as setImageCaptureCallback } from "../webxr-session-BWCpGd-2.js";
+import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "../enable-gps-ar-BBtRO2FJ.js";
 import { r as registerFrameUpdate, t as FrameUpdate } from "../frame-loop-7GBMBu68.js";
 import { c as QrSizeAccumulatorOptions, d as QrSizeStatus, f as createQrSizeAccumulator, i as QrSizeMeasurer, l as QrSizeEstimate, n as QrSizeDepthContext, o as createQrSizeMeasurer, p as estimateQrSizeFromDepth, r as QrSizeMeasurement, s as QrSizeAccumulator, t as ImageSize, u as QrSizeObservation } from "../qr-size-measurer-DxiMqRUw.js";
 import { t as createQrSizeDepthContext } from "../qr-size-depth-context-apAOmbrZ.js";

package/dist/ar/webxr-session.d.ts

@@ -1,4 +1,4 @@
 import { i as DepthSample, t as ARPose } from "../ar-types-Cc5yvBwn.js";
 import { n as CapturedImage } from "../image-capture-Bp6Pd4Md.js";
-import { $ as stopImageCapture, A as nuePositionToWebXR, B as setImageQualityAnalyzer, C as getImageCaptureFrameCount, D as initAR, E as getXrCameraFromPose, F as setCamera, G as setTrackingRecoveredCallback, H as setSessionEndCallback, I as setCameraFrameCallback, J as startCameraFrameCapture, K as setTrackingStore, L as setDepthCaptureCallback, M as resetWebXRState, N as setArPose, O as isWebXRSupported, P as setArWorldGroup, Q as stopDepthCapture, R as setFrameCallback, S as getDepthSampleCount, T as getScene, U as setTrackingCallbacks, V as setScene, W as setTrackingLostCallback, X as startImageCapture, Y as startDepthCapture, Z as stopCameraFrameCapture, _ as getCamera, a as DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, b as getCurrentArPose, c as TrackingSubscribableStore, d as createSceneHierarchy, f as endARSession, g as getArWorldGroup, h as getArPose, i as CameraFrameCaptureConfig, j as nueQuaternionToWebXR, k as isXRCameraLike, l as applyAlignmentMatrix, m as extractResetTransformData, n as AR_CAMERA_FOV, o as SessionEndInfo, p as extractPoseFromViewer, q as shouldLogCameraAccessDiagnostic, r as AR_CAMERA_NEAR, s as SessionFeatureOptions, t as AR_CAMERA_FAR, u as buildSessionOptions, v as getCameraFrameCaptureSize, w as getLiveCss3dManager, x as getDepthInfoFromFrame, y as getCameraFrameCount, z as setImageCaptureCallback } from "../webxr-session-cRG2SYAQ.js";
+import { $ as stopImageCapture, A as nuePositionToWebXR, B as setImageQualityAnalyzer, C as getImageCaptureFrameCount, D as initAR, E as getXrCameraFromPose, F as setCamera, G as setTrackingRecoveredCallback, H as setSessionEndCallback, I as setCameraFrameCallback, J as startCameraFrameCapture, K as setTrackingStore, L as setDepthCaptureCallback, M as resetWebXRState, N as setArPose, O as isWebXRSupported, P as setArWorldGroup, Q as stopDepthCapture, R as setFrameCallback, S as getDepthSampleCount, T as getScene, U as setTrackingCallbacks, V as setScene, W as setTrackingLostCallback, X as startImageCapture, Y as startDepthCapture, Z as stopCameraFrameCapture, _ as getCamera, a as DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, b as getCurrentArPose, c as TrackingSubscribableStore, d as createSceneHierarchy, f as endARSession, g as getArWorldGroup, h as getArPose, i as CameraFrameCaptureConfig, j as nueQuaternionToWebXR, k as isXRCameraLike, l as applyAlignmentMatrix, m as extractResetTransformData, n as AR_CAMERA_FOV, o as SessionEndInfo, p as extractPoseFromViewer, q as shouldLogCameraAccessDiagnostic, r as AR_CAMERA_NEAR, s as SessionFeatureOptions, t as AR_CAMERA_FAR, u as buildSessionOptions, v as getCameraFrameCaptureSize, w as getLiveCss3dManager, x as getDepthInfoFromFrame, y as getCameraFrameCount, z as setImageCaptureCallback } from "../webxr-session-BWCpGd-2.js";
 export { ARPose, AR_CAMERA_FAR, AR_CAMERA_FOV, AR_CAMERA_NEAR, CameraFrameCaptureConfig, CapturedImage, DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, DepthSample, SessionEndInfo, SessionFeatureOptions, TrackingSubscribableStore, applyAlignmentMatrix, buildSessionOptions, createSceneHierarchy, endARSession, extractPoseFromViewer, extractResetTransformData, getArPose, getArWorldGroup, getCamera, getCameraFrameCaptureSize, getCameraFrameCount, getCurrentArPose, getDepthInfoFromFrame, getDepthSampleCount, getImageCaptureFrameCount, getLiveCss3dManager, getScene, getXrCameraFromPose, initAR, isWebXRSupported, isXRCameraLike, nuePositionToWebXR, nueQuaternionToWebXR, resetWebXRState, setArPose, setArWorldGroup, setCamera, setCameraFrameCallback, setDepthCaptureCallback, setFrameCallback, setImageCaptureCallback, setImageQualityAnalyzer, setScene, setSessionEndCallback, setTrackingCallbacks, setTrackingLostCallback, setTrackingRecoveredCallback, setTrackingStore, shouldLogCameraAccessDiagnostic, startCameraFrameCapture, startDepthCapture, startImageCapture, stopCameraFrameCapture, stopDepthCapture, stopImageCapture };

package/dist/{ar-world-group-alignment-BlvGcIAk.d.ts → ar-world-group-alignment-Cfg0trC3.d.ts}

@@ -1,4 +1,4 @@
-import { t as SubscribableStore } from "./subscribe-to-selector-B9ylM5Oh.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-dQV8SpsO.js";
 import * as THREE from "three";
 
 //#region ../src/visualization/ar-world-group-alignment.d.ts

package/dist/core/index.d.ts

@@ -1,2 +1,2 @@
-import { _ as odometryTrackingRestarted, a as LibraryRootState, c as RootState, d as bearingDeltaDeg, f as calcGpsCoords, g as magneticHeadingFromEnuQuat, h as isIdentityMatrix4, i as LatLongAlt, l as Vector3, m as createGpsSlamStore, n as GpsPoint, o as Matrix4, p as calcRelativeCoordsInMeters, r as LatLong, s as Quaternion, t as ArImageCapture, u as arNorthBearingDeg, v as validateLicenseKey, y as webxrToNUE } from "../index-D4vrgV4b.js";
-export { ArImageCapture, GpsPoint, LatLong, LatLongAlt, LibraryRootState, Matrix4, Quaternion, RootState, Vector3, arNorthBearingDeg, bearingDeltaDeg, calcGpsCoords, calcRelativeCoordsInMeters, createGpsSlamStore, isIdentityMatrix4, magneticHeadingFromEnuQuat, odometryTrackingRestarted, validateLicenseKey, webxrToNUE };
+import { S as webxrToNUE, _ as createLoopClosureHandler, a as LibraryRootState, b as odometryTrackingRestarted, c as Matrix4, d as Vector3, f as arNorthBearingDeg, g as createGpsSlamStore, h as calcRelativeCoordsInMeters, i as LatLongAlt, l as Quaternion, m as calcGpsCoords, n as GpsPoint, o as LoopClosureHandler, p as bearingDeltaDeg, r as LatLong, s as LoopClosureHandlerConfig, t as ArImageCapture, u as RootState, v as isIdentityMatrix4, x as validateLicenseKey, y as magneticHeadingFromEnuQuat } from "../index-DXPVzOpP.js";
+export { ArImageCapture, GpsPoint, LatLong, LatLongAlt, LibraryRootState, LoopClosureHandler, LoopClosureHandlerConfig, Matrix4, Quaternion, RootState, Vector3, arNorthBearingDeg, bearingDeltaDeg, calcGpsCoords, calcRelativeCoordsInMeters, createGpsSlamStore, createLoopClosureHandler, isIdentityMatrix4, magneticHeadingFromEnuQuat, odometryTrackingRestarted, validateLicenseKey, webxrToNUE };

package/dist/core/index.js

@@ -1,2 +1,2 @@
-import { arNorthBearingDeg, bearingDeltaDeg, calcGpsCoords, calcRelativeCoordsInMeters, createGpsSlamStore, isIdentityMatrix4, magneticHeadingFromEnuQuat, odometryTrackingRestarted, validateLicenseKey, webxrToNUE } from "gps-plus-slam-js";
-export { arNorthBearingDeg, bearingDeltaDeg, calcGpsCoords, calcRelativeCoordsInMeters, createGpsSlamStore, isIdentityMatrix4, magneticHeadingFromEnuQuat, odometryTrackingRestarted, validateLicenseKey, webxrToNUE };
+import { arNorthBearingDeg, bearingDeltaDeg, calcGpsCoords, calcRelativeCoordsInMeters, createGpsSlamStore, createLoopClosureHandler, isIdentityMatrix4, magneticHeadingFromEnuQuat, odometryTrackingRestarted, validateLicenseKey, webxrToNUE } from "gps-plus-slam-js";
+export { arNorthBearingDeg, bearingDeltaDeg, calcGpsCoords, calcRelativeCoordsInMeters, createGpsSlamStore, createLoopClosureHandler, isIdentityMatrix4, magneticHeadingFromEnuQuat, odometryTrackingRestarted, validateLicenseKey, webxrToNUE };

package/dist/{create-slam-app-store-D3nzh9Wb.d.ts → create-slam-app-store-D1QSMuKu.d.ts}

@@ -1,5 +1,5 @@
 import { a as TrackingSliceState } from "./tracking-slice-DMkHlbny.js";
-import { t as RecordingState } from "./recording-slice-DTUtSVgd.js";
+import { t as RecordingState } from "./recording-slice-BW8SiLo1.js";
 import { n as SessionMetadata } from "./opfs-storage-CTkxvxN4.js";
 import { n as StorageBackend } from "./storage-backend-sEtmM4yW.js";
 import { GpsPoint, LatLong, Matrix4, RootState, Vector3 } from "gps-plus-slam-js";
@@ -138,11 +138,10 @@ declare function computeConvergence(snapshots: readonly AlignmentSnapshot[], opt
  * compute the Euclidean distance.
  *
  * This is the **single shared kernel** for the AppFramework reporter and
- * the Investigation harness (see §11 (a) of the tracking-quality plan).
- * `GpsPlusSlamJs_Investigation/src/investigation-helpers.ts` re-exports
- * `computeStabilityDelta` as a thin wrapper around this function so the
- * §6.1 corpus sweep and the runtime convergence score share one numeric
- * definition.
+ * the downstream corpus-analysis harness (see §11 (a) of the
+ * tracking-quality plan), which re-exports it as `computeStabilityDelta` —
+ * a thin wrapper around this function — so the §6.1 corpus sweep and the
+ * runtime convergence score share one numeric definition.
  */
 declare function matrixDelta(prev: readonly number[], curr: readonly number[]): {
   rotationDeltaDeg: number;

package/dist/{enable-gps-ar-DvGzBOrp.d.ts → enable-gps-ar-BBtRO2FJ.d.ts}

@@ -1,7 +1,7 @@
-import { t as ArCrashIsolationOptions } from "./recording-options-vASCFzc5.js";
+import { t as ArCrashIsolationOptions } from "./recording-options-DYKWVI93.js";
 import { n as RawDeviceOrientation, t as GpsPosition } from "./gps-CDKDQokE.js";
 import { n as PermissionStatus } from "./permission-checker-B-VtjnBA.js";
-import { s as SessionFeatureOptions } from "./webxr-session-cRG2SYAQ.js";
+import { s as SessionFeatureOptions } from "./webxr-session-BWCpGd-2.js";
 
 //#region ../src/ar/enable-gps-ar.d.ts
 /**

package/dist/{frame-conversions-C4bnNOEY.d.ts → frame-conversions-DDcNHkTb.d.ts}

@@ -1,4 +1,4 @@
-import { i as LatLongAlt, r as LatLong } from "./index-D4vrgV4b.js";
+import { i as LatLongAlt, r as LatLong } from "./index-DXPVzOpP.js";
 import * as THREE from "three";
 
 //#region ../src/visualization/frame-conversions.d.ts

package/dist/{gps-anchor-BjECcYnD.d.ts → gps-anchor-CEjGqEVD.d.ts}

@@ -1,4 +1,4 @@
-import { i as LatLongAlt, r as LatLong } from "./index-D4vrgV4b.js";
+import { i as LatLongAlt, r as LatLong } from "./index-DXPVzOpP.js";
 import * as THREE from "three";
 
 //#region ../src/visualization/gps-anchor.d.ts

package/dist/{gps-event-coordinator-CHtIkhb7.d.ts → gps-event-coordinator-BWpgBrHq.d.ts}

@@ -1,7 +1,7 @@
 import { t as ARPose } from "./ar-types-Cc5yvBwn.js";
 import { n as RawDeviceOrientation, t as GpsPosition } from "./gps-CDKDQokE.js";
 import { t as AbsoluteOrientationReading } from "./absolute-orientation-BAxc15J6.js";
-import { i as SlamAppStore } from "./create-slam-app-store-D3nzh9Wb.js";
+import { i as SlamAppStore } from "./create-slam-app-store-D1QSMuKu.js";
 import { Quaternion, RawAbsoluteOrientation, RawGpsPoint, RecordGpsEventPayload, Vector3, eulerToQuaternion } from "gps-plus-slam-js";
 import { ReducersMapObject } from "@reduxjs/toolkit";
 

package/dist/{index-DlsOo2IB.d.ts → index-B6iBnO_K.d.ts}

@@ -1,4 +1,4 @@
-import { N as CombinedRootState, m as TrackingQualityReport } from "./create-slam-app-store-D3nzh9Wb.js";
+import { N as CombinedRootState, m as TrackingQualityReport } from "./create-slam-app-store-D1QSMuKu.js";
 import { Add2dImagePayload, GpsPoint as GpsPoint$1, LatLong as LatLong$1, RawDeviceOrientation, RawGpsPoint as RawGpsPoint$1, RecordGpsEventPayload as RecordGpsEventPayload$1, add2dImage, calcRelativeCoordsInMeters, recordGpsEvent as recordGpsEvent$1, setZeroPos as setZeroPos$1 } from "gps-plus-slam-js";
 
 //#region ../src/state/onboarding-guidance.d.ts

package/dist/index-DXPVzOpP.d.ts

@@ -0,0 +1,2 @@
+import { ArImageCapture as ArImageCapture$1, GpsPoint as GpsPoint$1, LatLong as LatLong$1, LatLongAlt, LoopClosureHandler, LoopClosureHandlerConfig, Matrix4 as Matrix4$1, Quaternion as Quaternion$1, RootState as LibraryRootState, RootState as RootState$1, Vector3 as Vector3$1, arNorthBearingDeg, bearingDeltaDeg, calcGpsCoords as calcGpsCoords$1, calcRelativeCoordsInMeters, createGpsSlamStore, createLoopClosureHandler, isIdentityMatrix4, magneticHeadingFromEnuQuat, odometryTrackingRestarted, validateLicenseKey as validateLicenseKey$1, webxrToNUE } from "gps-plus-slam-js";
+export { webxrToNUE as S, createLoopClosureHandler as _, LibraryRootState as a, odometryTrackingRestarted as b, Matrix4$1 as c, Vector3$1 as d, arNorthBearingDeg as f, createGpsSlamStore as g, calcRelativeCoordsInMeters as h, LatLongAlt as i, Quaternion$1 as l, calcGpsCoords$1 as m, GpsPoint$1 as n, LoopClosureHandler as o, bearingDeltaDeg as p, LatLong$1 as r, LoopClosureHandlerConfig as s, ArImageCapture$1 as t, RootState$1 as u, isIdentityMatrix4 as v, validateLicenseKey$1 as x, magneticHeadingFromEnuQuat as y };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { n as createDepthGridLookup, t as DepthGridLookup } from "./depth-grid-l
 import { a as wrapXRDepthInfo, i as DepthSamplerConfig, n as DepthSampler, r as DepthSamplerCallbacks, t as DepthInfo } from "./depth-sampler-CwObAwEA.js";
 import { n as createDepthUnprojector, r as unprojectDepthPoint, t as DepthUnprojector } from "./depth-unprojection-DRdBU90S.js";
 import { a as QualityFilterConfig, c as meanLuminance, i as ImageQualityGate, l as rgbaToGrayscale, n as DEFAULT_SHARPNESS_HISTORY_SIZE, o as QualityRejectReason, r as DEFAULT_SHARPNESS_MIN_SAMPLES, s as QualityVerdict, t as DEFAULT_QUALITY_FILTER, u as sharpnessScore } from "./image-quality-BMx2ko9-.js";
-import { A as validateImageOptions, C as loadRecordingOptions, F as validateRecordingOptions, O as validateDepthOptions, S as cloneRecordingOptions, T as saveRecordingOptions, a as DepthCaptureOptions, b as STORAGE_KEY, c as IMAGE_CONSTRAINTS, i as DEPTH_CONSTRAINTS, l as ImageCaptureOptions, r as DEFAULT_RECORDING_OPTIONS, w as resetRecordingOptions, y as RecordingOptionsInput } from "./recording-options-vASCFzc5.js";
+import { C as cloneRecordingOptions, E as saveRecordingOptions, L as validateRecordingOptions, T as resetRecordingOptions, a as DepthCaptureOptions, b as RecordingOptionsInput, c as IMAGE_CONSTRAINTS, i as DEPTH_CONSTRAINTS, j as validateImageOptions, k as validateDepthOptions, l as ImageCaptureOptions, r as DEFAULT_RECORDING_OPTIONS, w as loadRecordingOptions, x as STORAGE_KEY } from "./recording-options-DYKWVI93.js";
 import { a as startOrientationWatch, i as startGpsWatch, n as RawDeviceOrientation, o as stopGpsWatch, r as requestOrientationPermission, s as stopOrientationWatch, t as GpsPosition } from "./gps-CDKDQokE.js";
 import { a as checkCameraPermission, c as checkOrientationPermission, d as requestCameraPermission, f as requestGeolocationPermission, g as setFileSystemState, h as resetFileSystemState, i as checkAllPermissions, l as checkWebXRSupport, m as requestWebXRWithDepthPermission, n as PermissionStatus, o as checkFileSystemPermission, p as requestOrientationPermission$1, s as checkGeolocationPermission, t as PermissionCheckResult, u as requestAllPermissions } from "./permission-checker-B-VtjnBA.js";
 import { a as ImageCaptureCallbacks, c as MIN_VALID_IMAGE_BYTES, i as FrameQualityVerdict, n as CapturedImage, o as ImageCaptureConfig, r as DEFAULT_CAPTURE_CONFIG, s as ImageCaptureManager, t as CapturedFrame } from "./image-capture-Bp6Pd4Md.js";
@@ -17,8 +17,8 @@ import { _ as solveQrPose, a as QrPoseSolution, c as SolveQrPoseInput, d as intr
 import { a as QrFrontEnd, c as createBarcodeDetectorFrontEnd, i as QrDetection, n as BarcodeDetectorLike, o as RgbaImage, r as DetectedBarcodeLike, s as ToImageBitmapSource, t as BarcodeDetectorFrontEnd } from "./qr-frontend-BPURlh3S.js";
 import { n as createCss3dRendererManager, t as Css3dRendererManager } from "./css3d-renderer-manager-CPpVtvgs.js";
 import { i as acquireCameraTexture, n as RendererLike, r as XRCameraLike, t as CameraTextureResult } from "./xr-camera-texture-q0eIDSRg.js";
-import { $ as stopImageCapture, B as setImageQualityAnalyzer, C as getImageCaptureFrameCount, D as initAR, H as setSessionEndCallback, I as setCameraFrameCallback, J as startCameraFrameCapture, K as setTrackingStore, L as setDepthCaptureCallback, Q as stopDepthCapture, R as setFrameCallback, S as getDepthSampleCount, T as getScene, U as setTrackingCallbacks, W as setTrackingLostCallback, X as startImageCapture, Y as startDepthCapture, Z as stopCameraFrameCapture, _ as getCamera, b as getCurrentArPose, f as endARSession, g as getArWorldGroup, i as CameraFrameCaptureConfig, o as SessionEndInfo, s as SessionFeatureOptions, w as getLiveCss3dManager, x as getDepthInfoFromFrame, y as getCameraFrameCount, z as setImageCaptureCallback } from "./webxr-session-cRG2SYAQ.js";
-import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "./enable-gps-ar-DvGzBOrp.js";
+import { $ as stopImageCapture, B as setImageQualityAnalyzer, C as getImageCaptureFrameCount, D as initAR, H as setSessionEndCallback, I as setCameraFrameCallback, J as startCameraFrameCapture, K as setTrackingStore, L as setDepthCaptureCallback, Q as stopDepthCapture, R as setFrameCallback, S as getDepthSampleCount, T as getScene, U as setTrackingCallbacks, W as setTrackingLostCallback, X as startImageCapture, Y as startDepthCapture, Z as stopCameraFrameCapture, _ as getCamera, b as getCurrentArPose, f as endARSession, g as getArWorldGroup, i as CameraFrameCaptureConfig, o as SessionEndInfo, s as SessionFeatureOptions, w as getLiveCss3dManager, x as getDepthInfoFromFrame, y as getCameraFrameCount, z as setImageCaptureCallback } from "./webxr-session-BWCpGd-2.js";
+import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "./enable-gps-ar-BBtRO2FJ.js";
 import { r as registerFrameUpdate, t as FrameUpdate } from "./frame-loop-7GBMBu68.js";
 import { c as QrSizeAccumulatorOptions, d as QrSizeStatus, f as createQrSizeAccumulator, i as QrSizeMeasurer, l as QrSizeEstimate, n as QrSizeDepthContext, o as createQrSizeMeasurer, p as estimateQrSizeFromDepth, r as QrSizeMeasurement, s as QrSizeAccumulator, t as ImageSize, u as QrSizeObservation } from "./qr-size-measurer-DxiMqRUw.js";
 import { t as createQrSizeDepthContext } from "./qr-size-depth-context-apAOmbrZ.js";
@@ -48,34 +48,34 @@ import { n as mapWithConcurrencyLimit } from "./concurrency-DPeGBH0X.js";
 import { t as geodesicAngleRad } from "./index-D74JTX4I.js";
 import { t as formatFileSize } from "./format-file-size-DxN-EBLc.js";
 import { t as listFormatter } from "./list-formatter-DLFDnS70.js";
-import { a as recordWriteFailure, i as recordDepthSample, o as recordingReducer, r as endSession, s as startSession, t as RecordingState } from "./recording-slice-DTUtSVgd.js";
+import { a as recordWriteFailure, i as recordDepthSample, o as recordingReducer, r as endSession, s as startSession, t as RecordingState } from "./recording-slice-BW8SiLo1.js";
 import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, i as createSession, l as listSessions, o as getSessionHandle, r as checkStorageQuota, s as getSessionsRootHandle, u as resetOpfsStorage } from "./opfs-storage-CTkxvxN4.js";
 import { n as StorageBackend, t as CreateSessionResult } from "./storage-backend-sEtmM4yW.js";
-import { A as snapshotPushed, C as createTrackingQualityListenerMiddleware, D as resetTrackingQuality, E as reportUpdated, M as trackingQualityReducer, O as selectRecentAlignments, S as computeTrackingQualityReport, T as matrixDelta, _ as computeConvergence, a as SlamAppStoreOptions, b as computeGpsVsFusedDivergence, g as TrackingQualityState, h as TrackingQualitySliceState, i as SlamAppStore, j as snapshotsTrimmed, k as selectTrackingQuality, m as TrackingQualityReport, n as SlamAppMiddleware, o as createSlamAppStore, p as TrackingQualityOptions, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, u as DEFAULT_TRACKING_QUALITY_OPTIONS, v as computeCoverage, x as computeResidualConsensus, y as computeGpsAccuracy } from "./create-slam-app-store-D3nzh9Wb.js";
-import { a as eulerToQuaternion, c as getLastDeviceOrientation, d as updateDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig } from "./gps-event-coordinator-CHtIkhb7.js";
-import { a as ZipActionEntry, d as loadSessionMetadataFromBlob, f as readZipEntries, i as RecordedAction, l as loadGpsPathFromBlob, n as GpsPathCoord, r as MAX_ACTION_FILE_SIZE, s as loadActionsFromZip } from "./zip-reader-CvruaGvD.js";
-import { n as replayRecording } from "./recording-replayer-D0V9WkmY.js";
-import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "./replay-engine-xdrUgWJi.js";
-import { n as MapDataInput, r as buildMapData, t as MapData } from "./map-data-PNfGKGWx.js";
-import { t as SubscribableStore } from "./subscribe-to-selector-B9ylM5Oh.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "./store-subscribers-DScA7tdT.js";
-import { c as calcRelativeCoordsInMeters, d as OnboardingGuidance, f as OnboardingPhase, l as recordGpsEvent, m as selectOnboardingGuidance, p as computeOnboardingGuidance, s as add2dImage, u as setZeroPos } from "./index-DlsOo2IB.js";
+import { A as snapshotPushed, C as createTrackingQualityListenerMiddleware, D as resetTrackingQuality, E as reportUpdated, M as trackingQualityReducer, O as selectRecentAlignments, S as computeTrackingQualityReport, T as matrixDelta, _ as computeConvergence, a as SlamAppStoreOptions, b as computeGpsVsFusedDivergence, g as TrackingQualityState, h as TrackingQualitySliceState, i as SlamAppStore, j as snapshotsTrimmed, k as selectTrackingQuality, m as TrackingQualityReport, n as SlamAppMiddleware, o as createSlamAppStore, p as TrackingQualityOptions, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, u as DEFAULT_TRACKING_QUALITY_OPTIONS, v as computeCoverage, x as computeResidualConsensus, y as computeGpsAccuracy } from "./create-slam-app-store-D1QSMuKu.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, d as updateDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig } from "./gps-event-coordinator-BWpgBrHq.js";
+import { a as ZipActionEntry, c as loadActionsFromZip, f as loadSessionMetadataFromBlob, i as RecordedAction, n as GpsPathCoord, p as readZipEntries, r as MAX_ACTION_FILE_SIZE, u as loadGpsPathFromBlob } from "./zip-reader-BzENzMH6.js";
+import { n as replayRecording } from "./recording-replayer-BJ8Lf0QY.js";
+import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "./replay-engine-DmCAc7WM.js";
+import { n as MapDataInput, r as buildMapData, t as MapData } from "./map-data-CUnTzRIC.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-dQV8SpsO.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "./store-subscribers-DJUErW-o.js";
+import { c as calcRelativeCoordsInMeters, d as OnboardingGuidance, f as OnboardingPhase, l as recordGpsEvent, m as selectOnboardingGuidance, p as computeOnboardingGuidance, s as add2dImage, u as setZeroPos } from "./index-B6iBnO_K.js";
 import { t as NullStorageBackend } from "./null-storage-backend-B1-jlpin.js";
 import { t as OpfsStorageBackend } from "./opfs-storage-backend-D6Z03fML.js";
 import { a as formatTimestamp, i as formatFrameFilename, r as formatActionFilename } from "./file-system-utils-DueXHxo9.js";
 import { a as downloadZip, c as syncToExternalZip, i as ZipExportResult, n as ZipContributorAddFile, o as exportSessionAsZip, r as ZipExportContributor, s as exportSessionHandleAsZip, t as ExportSessionAsZipOptions } from "./zip-export-CtiUnAlJ.js";
-import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "./ar-world-group-alignment-BlvGcIAk.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "./ar-world-group-alignment-Cfg0trC3.js";
 import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "./gps-compass-cubes-1mooS3BS.js";
 import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "./frustum-visibility-CokkgS_i.js";
-import { n as worldNueToGps, t as nueToArLocal } from "./frame-conversions-C4bnNOEY.js";
+import { n as worldNueToGps, t as nueToArLocal } from "./frame-conversions-DDcNHkTb.js";
 import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "./hit-test-reticle-CaQbrhbk.js";
-import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "./gps-anchor-BjECcYnD.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "./gps-anchor-CEjGqEVD.js";
 import { n as GpsEventVisualizer, r as gpsEventVisualizer } from "./gps-event-markers-Di2nBzx-.js";
-import { n as OcclusionMesh, r as OcclusionMeshOptions } from "./occlusion-mesh-b28lRJ6S.js";
-import { a as DEFAULT_Z_OFFSET, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions } from "./leaflet-map-overlay-BOZFW5kT.js";
+import { n as OcclusionMesh, r as OcclusionMeshOptions } from "./occlusion-mesh-kXCQ2FM1.js";
+import { a as DEFAULT_Z_OFFSET, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions } from "./leaflet-map-overlay-C8GS4cUy.js";
 import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "./lerp-utils-Qs8OhumS.js";
 import { a as addAccuracyCircles, i as AccuracyCircleSample, n as ACCURACY_CIRCLE_STROKE_OPACITY, r as ACCURACY_CIRCLE_WEIGHT, t as ACCURACY_CIRCLE_FILL_OPACITY } from "./accuracy-circles-DkWBkF5g.js";
-import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "./map-overlay-draw-DiroaJed.js";
+import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "./map-overlay-draw-6WJeq0Kg.js";
 import { a as MapOverlayOptions, c as tileXYToLatLon, i as MapOverlay, n as DEFAULT_MAP_SIZE, o as TextureLoaderInterface, r as DEFAULT_ZOOM, s as latLonToTileXY, t as DEFAULT_HEIGHT_OFFSET } from "./map-overlay-BCQgvIgU.js";
 import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "./three-dispose-BMOAmPhb.js";
 import { t as VIS_COLORS } from "./vis-colors-C7HI0u9_.js";

package/dist/index.js

@@ -63,7 +63,7 @@ import { DEFAULT_TRACKING_QUALITY_OPTIONS, computeConvergence, computeCoverage,
 import { t as createSlamAppStore } from "./create-slam-app-store-DXiAnJwR.js";
 import { replayRecording } from "./state/recording-replayer.js";
 import { DEFAULT_MAX_DELAY_MS, ReplayEngine, computeInterActionDelay, extractActionTimestamp } from "./state/replay-engine.js";
-import { t as buildMapData } from "./map-data-D7rpMC6f.js";
+import { t as buildMapData } from "./map-data-1tF5gcYV.js";
 import { wireStoreSubscribers } from "./state/store-subscribers.js";
 import { a as computeOnboardingGuidance, i as setZeroPos, n as calcRelativeCoordsInMeters, o as selectOnboardingGuidance, r as recordGpsEvent, t as add2dImage } from "./state-BeKvn4B-.js";
 import { checkStorageQuota, createSession, getAppRootHandle, getSessionHandle, getSessionsRootHandle, initOpfsStorage, listSessions, resetOpfsStorage, resetSessionHandles } from "./storage/opfs-storage.js";

package/dist/{leaflet-map-overlay-BOZFW5kT.d.ts → leaflet-map-overlay-C8GS4cUy.d.ts}

@@ -1,4 +1,4 @@
-import { t as MapData } from "./map-data-PNfGKGWx.js";
+import { t as MapData } from "./map-data-CUnTzRIC.js";
 import * as THREE from "three";
 import { LatLong } from "gps-plus-slam-js";
 import L from "leaflet";

package/dist/{map-data-D7rpMC6f.js → map-data-1tF5gcYV.js}

@@ -99,8 +99,12 @@ function buildMapData(input) {
 		alignmentMatrix: input.alignmentMatrix ?? null,
 		zeroRef: input.zeroRef ?? null
 	});
+	const lastFused = fusedPath[fusedPath.length - 1];
 	const lastRaw = rawGpsPath[rawGpsPath.length - 1];
-	const userPosition = input.userPosition !== void 0 ? input.userPosition : lastRaw ? {
+	const userPosition = input.userPosition !== void 0 ? input.userPosition : lastFused ? {
+		lat: lastFused.lat,
+		lng: lastFused.lng
+	} : lastRaw ? {
 		lat: lastRaw.lat,
 		lng: lastRaw.lng
 	} : null;

package/dist/{map-data-PNfGKGWx.d.ts → map-data-CUnTzRIC.d.ts}

@@ -4,7 +4,14 @@ import { LatLong, Matrix4, Quaternion, Vector3 } from "gps-plus-slam-js";
 //#region ../src/visualization/map-data.d.ts
 /** Fully-resolved trajectory data ready to be drawn onto a Leaflet map. */
 interface MapData {
-  /** Latest user GPS position (blue dot), or null when unknown. */
+  /**
+   * User position for the blue dot, or null when unknown/hidden. Unless the
+   * caller provided an explicit value, this is the latest FUSED pose
+   * (GPS-converted tip of `fusedPath`), so the dot keeps moving indoors where
+   * the raw fix freezes; the last raw GPS fix is only the pre-alignment
+   * fallback. See
+   * gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-07-06-recorder-live-map-user-dot-fused-pose-user-feedback.md.
+   */
   userPosition: GpsCoord | null;
   /** Raw GPS samples (yellow polyline + per-event accuracy circles). */
   rawGpsPath: RawGpsSample[];
@@ -49,8 +56,10 @@ interface MapDataInput {
   /** Alignment-snapshot GPS positions. */
   alignmentSnapshots?: readonly GpsCoord[];
   /**
-   * Explicit user position. When omitted, defaults to the last entry of
-   * `rawGpsPath` (or null when there is none).
+   * Explicit user position — including `null` to hide the dot (summary map).
+   * When omitted, defaults to the last `fusedPath` point when the fused path
+   * is non-empty, else the last `rawGpsPath` entry, else null (2026-07-06
+   * fused-dot feedback).
    */
   userPosition?: GpsCoord | null;
 }

package/dist/{map-overlay-draw-DiroaJed.d.ts → map-overlay-draw-6WJeq0Kg.d.ts}

@@ -1,4 +1,4 @@
-import { t as MapData } from "./map-data-PNfGKGWx.js";
+import { t as MapData } from "./map-data-CUnTzRIC.js";
 import L from "leaflet";
 
 //#region ../src/visualization/map-overlay-draw.d.ts

package/dist/{occlusion-mesh-b28lRJ6S.d.ts → occlusion-mesh-kXCQ2FM1.d.ts}

@@ -1,5 +1,5 @@
 import { t as GridCell } from "./bresenham3d-DGc4nIb-.js";
-import { f as OccluderDebugStyle } from "./recording-options-vASCFzc5.js";
+import { p as OccluderDebugStyle } from "./recording-options-DYKWVI93.js";
 import { n as MeshMode, t as Aabb } from "./occupancy-mesher-C2ecWhNp.js";
 import * as THREE from "three";
 import { Vector3 } from "gps-plus-slam-js";

package/dist/{recording-options-vASCFzc5.d.ts → recording-options-DYKWVI93.d.ts}

@@ -15,6 +15,7 @@ interface RecordingOptionsInput {
   visualization?: Partial<VisualizationOptions>;
   qr?: Partial<QrCaptureOptions>;
   compassDebug?: Partial<CompassDebugOptions>;
+  loopClosureDebug?: Partial<LoopClosureDebugOptions>;
 }
 /**
  * Toggles for the library's Phase-4 compass alignment features (closed/internal
@@ -43,6 +44,23 @@ interface CompassDebugOptions {
   /** GPS-free compass↔WebXR consistency gate (`setCompassWebXRConsistencyEnabled`). */
   webXRConsistency: boolean;
 }
+/**
+ * Live loop-closure capture toggles (experimental, default OFF).
+ *
+ * When `detectorEnabled` is on, the recorder feeds every AR frame's raw WebXR
+ * pose into the library's `createLoopClosureHandler`, so an AR relocalization
+ * jump (>1 m between consecutive frames) dispatches `arLoopClosureDetected`
+ * into the session store — and therefore into the recording. This is the
+ * missing producer that has kept the whole corpus loop-closure-free (the
+ * pair-refresh T5 verdict is blocked on such recordings). It also changes the
+ * LIVE alignment (each closure Bézier-deforms the stored trajectory), which is
+ * why it stays an operator opt-in. See
+ * GpsPlusSlamJs_Docs/docs/2026-07-06-recorder-loop-closure-detector-wiring-plan.md.
+ */
+interface LoopClosureDebugOptions {
+  /** Wire the live loop-closure handler into the AR frame loop. Default OFF. */
+  detectorEnabled: boolean;
+}
 /**
  * Diagnostic flags for isolating pre-recording AR startup crashes.
  * These gates affect XR session negotiation and frame-loop behavior,
@@ -394,6 +412,8 @@ interface RecordingOptions {
   qr: QrCaptureOptions;
   /** Compass alignment debug toggles (Stage 0 / Stage C / consistency gate) */
   compassDebug: CompassDebugOptions;
+  /** Live loop-closure capture toggles (experimental, default OFF) */
+  loopClosureDebug: LoopClosureDebugOptions;
 }
 /**
  * localStorage key for persisted options.
@@ -580,6 +600,12 @@ declare function validateArCrashIsolationOptions(options: Partial<ArCrashIsolati
  * so a bad persisted value can never silently turn an alignment override ON.
  */
 declare function validateCompassDebugOptions(options: Partial<CompassDebugOptions>): CompassDebugOptions;
+/**
+ * Validate and normalize the loop-closure capture toggles. Boolean-or-default
+ * per field; a missing/corrupted/pre-feature value falls back to the OFF
+ * default so a bad persisted value can never silently wire the detector in.
+ */
+declare function validateLoopClosureDebugOptions(options: Partial<LoopClosureDebugOptions>): LoopClosureDebugOptions;
 /**
  * Validate and normalize the live debug-overlay visibility toggles.
  * Each field is boolean-or-default (same policy as the AR-crash-isolation
@@ -664,4 +690,4 @@ declare function resetRecordingOptions(storageKey?: string): RecordingOptions;
  */
 declare function cloneRecordingOptions(options: RecordingOptions): RecordingOptions;
 //#endregion
-export { validateImageOptions as A, loadRecordingOptions as C, validateCompassDebugOptions as D, validateArCrashIsolationOptions as E, validateRecordingOptions as F, validateVisualizationOptions as I, validateOccupancyOptions as M, validateQrOptions as N, validateDepthOptions as O, validateQualityFilterOptions as P, cloneRecordingOptions as S, saveRecordingOptions as T, QrCaptureOptions as _, DepthCaptureOptions as a, STORAGE_KEY as b, IMAGE_CONSTRAINTS as c, OCCUPANCY_CONSTRAINTS as d, OccluderDebugStyle as f, QUALITY_FILTER_CONSTRAINTS as g, QR_CONSTRAINTS as h, DEPTH_CONSTRAINTS as i, validateMotionFilterOptions as j, validateFrameTileDisplayOptions as k, ImageCaptureOptions as l, OccupancyOptions as m, CompassDebugOptions as n, FRAME_TILE_DISPLAY_CONSTRAINTS as o, OccluderMeshMode as p, DEFAULT_RECORDING_OPTIONS as r, FrameTileDisplayOptions as s, ArCrashIsolationOptions as t, MOTION_FILTER_CONSTRAINTS as u, RecordingOptions as v, resetRecordingOptions as w, VisualizationOptions as x, RecordingOptionsInput as y };
+export { validateFrameTileDisplayOptions as A, cloneRecordingOptions as C, validateArCrashIsolationOptions as D, saveRecordingOptions as E, validateQrOptions as F, validateQualityFilterOptions as I, validateRecordingOptions as L, validateLoopClosureDebugOptions as M, validateMotionFilterOptions as N, validateCompassDebugOptions as O, validateOccupancyOptions as P, validateVisualizationOptions as R, VisualizationOptions as S, resetRecordingOptions as T, QUALITY_FILTER_CONSTRAINTS as _, DepthCaptureOptions as a, RecordingOptionsInput as b, IMAGE_CONSTRAINTS as c, MOTION_FILTER_CONSTRAINTS as d, OCCUPANCY_CONSTRAINTS as f, QR_CONSTRAINTS as g, OccupancyOptions as h, DEPTH_CONSTRAINTS as i, validateImageOptions as j, validateDepthOptions as k, ImageCaptureOptions as l, OccluderMeshMode as m, CompassDebugOptions as n, FRAME_TILE_DISPLAY_CONSTRAINTS as o, OccluderDebugStyle as p, DEFAULT_RECORDING_OPTIONS as r, FrameTileDisplayOptions as s, ArCrashIsolationOptions as t, LoopClosureDebugOptions as u, QrCaptureOptions as v, loadRecordingOptions as w, STORAGE_KEY as x, RecordingOptions as y };

package/dist/{recording-replayer-D0V9WkmY.d.ts → recording-replayer-BJ8Lf0QY.d.ts}

@@ -1,5 +1,5 @@
-import { N as CombinedRootState } from "./create-slam-app-store-D3nzh9Wb.js";
-import { i as RecordedAction } from "./zip-reader-CvruaGvD.js";
+import { N as CombinedRootState } from "./create-slam-app-store-D1QSMuKu.js";
+import { i as RecordedAction } from "./zip-reader-BzENzMH6.js";
 
 //#region ../src/state/recording-replayer.d.ts
 /**

package/dist/{recording-slice-DTUtSVgd.d.ts → recording-slice-BW8SiLo1.d.ts}

@@ -1,5 +1,5 @@
 import { i as DepthSample } from "./ar-types-Cc5yvBwn.js";
-import { v as RecordingOptions } from "./recording-options-vASCFzc5.js";
+import { y as RecordingOptions } from "./recording-options-DYKWVI93.js";
 import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
 
 //#region ../src/state/recording-slice.d.ts

package/dist/{replay-engine-xdrUgWJi.d.ts → replay-engine-DmCAc7WM.d.ts}

@@ -1,4 +1,4 @@
-import { i as SlamAppStore } from "./create-slam-app-store-D3nzh9Wb.js";
+import { i as SlamAppStore } from "./create-slam-app-store-D1QSMuKu.js";
 import { ReducersMapObject } from "@reduxjs/toolkit";
 
 //#region ../src/state/replay-engine.d.ts

package/dist/state/app-selectors.d.ts

@@ -1,2 +1,2 @@
-import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-JqydaUMN.js";
+import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-BbAiCRUT.js";
 export { selectAlignmentMatrix, selectFrameTilesInWebXR, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectZeroReference };

package/dist/state/combined-root-state.d.ts

@@ -1,2 +1,2 @@
-import { N as CombinedRootState } from "../create-slam-app-store-D3nzh9Wb.js";
+import { N as CombinedRootState } from "../create-slam-app-store-D1QSMuKu.js";
 export { CombinedRootState };

package/dist/state/create-slam-app-store.d.ts

@@ -1,2 +1,2 @@
-import { a as SlamAppStoreOptions, i as SlamAppStore, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, t as SlamAppCombinedState } from "../create-slam-app-store-D3nzh9Wb.js";
+import { a as SlamAppStoreOptions, i as SlamAppStore, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, t as SlamAppCombinedState } from "../create-slam-app-store-D1QSMuKu.js";
 export { SlamAppCombinedState, SlamAppMiddleware, SlamAppRootState, SlamAppStore, SlamAppStoreOptions, createSlamAppStore };

package/dist/state/gps-ar-pose-sampler.d.ts

@@ -1,4 +1,4 @@
 import { t as ARPose } from "../ar-types-Cc5yvBwn.js";
-import { o as extractOdomPosition, s as extractOdomRotation } from "../gps-event-coordinator-CHtIkhb7.js";
+import { o as extractOdomPosition, s as extractOdomRotation } from "../gps-event-coordinator-BWpgBrHq.js";
 import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-DEGNk2CI.js";
 export { ARPose, CaptureGpsAnchorSampleOptions, GpsAnchorSample, GpsAnchorSampleGpsPoint, captureGpsAnchorSample, extractOdomPosition, extractOdomRotation };

package/dist/state/gps-event-coordinator.d.ts

@@ -1,2 +1,2 @@
-import { a as eulerToQuaternion, c as getLastDeviceOrientation, d as updateDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as toRawAbsoluteOrientation } from "../gps-event-coordinator-CHtIkhb7.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, d as updateDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as toRawAbsoluteOrientation } from "../gps-event-coordinator-BWpgBrHq.js";
 export { RecordingCoordinatorConfig, buildRawGpsPoint, buildRecordGpsEventPayload, createGpsPositionHandler, eulerToQuaternion, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, resetCoordinatorState, toRawAbsoluteOrientation, updateDeviceOrientation };

package/dist/state/index.d.ts

@@ -1,20 +1,20 @@
 import { i as DepthSample, r as DepthPoint } from "../ar-types-Cc5yvBwn.js";
-import { A as validateImageOptions, C as loadRecordingOptions, F as validateRecordingOptions, O as validateDepthOptions, S as cloneRecordingOptions, T as saveRecordingOptions, a as DepthCaptureOptions, b as STORAGE_KEY, c as IMAGE_CONSTRAINTS, i as DEPTH_CONSTRAINTS, l as ImageCaptureOptions, r as DEFAULT_RECORDING_OPTIONS, w as resetRecordingOptions, y as RecordingOptionsInput } from "../recording-options-vASCFzc5.js";
+import { C as cloneRecordingOptions, E as saveRecordingOptions, L as validateRecordingOptions, T as resetRecordingOptions, a as DepthCaptureOptions, b as RecordingOptionsInput, c as IMAGE_CONSTRAINTS, i as DEPTH_CONSTRAINTS, j as validateImageOptions, k as validateDepthOptions, l as ImageCaptureOptions, r as DEFAULT_RECORDING_OPTIONS, w as loadRecordingOptions, x as STORAGE_KEY } from "../recording-options-DYKWVI93.js";
 import { a as TrackingSliceState, c as poseLost, d as selectLastRestartedPayload, f as selectLastSensorOrientation, g as trackingReducer, h as selectTrackingPhase, i as TrackingPhase, l as poseReceived, m as selectLostFrameCount, n as PoseReceivedPayload, o as clearLastRestartedPayload, p as selectLastValidPose, r as ResetTransformData, s as originReset, t as DeviceOrientation, u as resetTracking } from "../tracking-slice-DMkHlbny.js";
 import { d as QrSizeStatus, l as QrSizeEstimate } from "../qr-size-measurer-DxiMqRUw.js";
 import { a as QrPoseStability, o as QrPoseStabilityOptions, s as QrPoseStabilityStatus } from "../qr-pose-aggregation-CypnmjA-.js";
-import { a as recordWriteFailure, i as recordDepthSample, n as SessionMetadata$1, o as recordingReducer, r as endSession, s as startSession, t as RecordingState } from "../recording-slice-DTUtSVgd.js";
+import { a as recordWriteFailure, i as recordDepthSample, n as SessionMetadata$1, o as recordingReducer, r as endSession, s as startSession, t as RecordingState } from "../recording-slice-BW8SiLo1.js";
 import { C as setQrMaxHistory, S as selectStableQrPose, _ as selectQrPoseStability, a as RootWithQrDetected, b as selectResolvedQrSizeM, c as medianQrPosition, d as recordQrDetection, f as recordQrSizeEstimate, g as selectQrMarkers, h as selectQrMarker, i as QrMarkerState, l as pruneQrDetections, m as selectLatestQrDetection, n as QrDetectedState, o as clearAllQrMarkers, p as selectDerivedQrPlacement, r as QrDetectionEntry, s as clearQrMarker, t as DEFAULT_QR_MAX_HISTORY, u as qrDetectedReducer, v as selectQrRawObservations, x as selectSolvedQrPose, y as selectQrSize } from "../qr-detected-slice-TzVb8bij.js";
 import { n as SessionMetadata } from "../opfs-storage-CTkxvxN4.js";
 import { n as StorageBackend } from "../storage-backend-sEtmM4yW.js";
-import { A as snapshotPushed, C as createTrackingQualityListenerMiddleware, D as resetTrackingQuality, E as reportUpdated, M as trackingQualityReducer, O as selectRecentAlignments, S as computeTrackingQualityReport, T as matrixDelta, _ as computeConvergence, a as SlamAppStoreOptions, b as computeGpsVsFusedDivergence, g as TrackingQualityState, h as TrackingQualitySliceState, i as SlamAppStore, j as snapshotsTrimmed, k as selectTrackingQuality, m as TrackingQualityReport, n as SlamAppMiddleware, o as createSlamAppStore, p as TrackingQualityOptions, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, u as DEFAULT_TRACKING_QUALITY_OPTIONS, v as computeCoverage, w as degradedCountUpdated, x as computeResidualConsensus, y as computeGpsAccuracy } from "../create-slam-app-store-D3nzh9Wb.js";
-import { a as eulerToQuaternion, c as getLastDeviceOrientation, d as updateDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig } from "../gps-event-coordinator-CHtIkhb7.js";
+import { A as snapshotPushed, C as createTrackingQualityListenerMiddleware, D as resetTrackingQuality, E as reportUpdated, M as trackingQualityReducer, O as selectRecentAlignments, S as computeTrackingQualityReport, T as matrixDelta, _ as computeConvergence, a as SlamAppStoreOptions, b as computeGpsVsFusedDivergence, g as TrackingQualityState, h as TrackingQualitySliceState, i as SlamAppStore, j as snapshotsTrimmed, k as selectTrackingQuality, m as TrackingQualityReport, n as SlamAppMiddleware, o as createSlamAppStore, p as TrackingQualityOptions, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, u as DEFAULT_TRACKING_QUALITY_OPTIONS, v as computeCoverage, w as degradedCountUpdated, x as computeResidualConsensus, y as computeGpsAccuracy } from "../create-slam-app-store-D1QSMuKu.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, d as updateDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig } from "../gps-event-coordinator-BWpgBrHq.js";
 import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-DEGNk2CI.js";
-import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-D0V9WkmY.js";
+import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-BJ8Lf0QY.js";
 import { n as createPersistenceMiddleware, r as slicePrefixOf, t as PersistenceMiddlewareOptions } from "../persistence-middleware-CG-t08X4.js";
-import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-xdrUgWJi.js";
-import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector-B9ylM5Oh.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-DScA7tdT.js";
-import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-JqydaUMN.js";
-import { a as RawGpsPoint, c as calcRelativeCoordsInMeters, d as OnboardingGuidance, f as OnboardingPhase, i as RawDeviceOrientation, l as recordGpsEvent, m as selectOnboardingGuidance, n as GpsPoint, o as RecordGpsEventPayload, p as computeOnboardingGuidance, r as LatLong, s as add2dImage, t as Add2dImagePayload, u as setZeroPos } from "../index-DlsOo2IB.js";
+import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-DmCAc7WM.js";
+import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector-dQV8SpsO.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-DJUErW-o.js";
+import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-BbAiCRUT.js";
+import { a as RawGpsPoint, c as calcRelativeCoordsInMeters, d as OnboardingGuidance, f as OnboardingPhase, i as RawDeviceOrientation, l as recordGpsEvent, m as selectOnboardingGuidance, n as GpsPoint, o as RecordGpsEventPayload, p as computeOnboardingGuidance, r as LatLong, s as add2dImage, t as Add2dImagePayload, u as setZeroPos } from "../index-B6iBnO_K.js";
 export { Add2dImagePayload, AlignmentSnapshot, CaptureGpsAnchorSampleOptions, CompleteCallback, DEFAULT_MAX_DELAY_MS, DEFAULT_QR_MAX_HISTORY, DEFAULT_RECORDING_OPTIONS, DEFAULT_TRACKING_QUALITY_OPTIONS, DEPTH_CONSTRAINTS, DepthCaptureOptions, DepthPoint, DepthSample, DeviceOrientation, ErrorCallback, GpsAnchorSample, GpsAnchorSampleGpsPoint, GpsPoint, IMAGE_CONSTRAINTS, ImageCaptureOptions, LatLong, OnboardingGuidance, OnboardingPhase, SessionMetadata as OpfsSessionMetadata, PersistenceMiddlewareOptions, PoseReceivedPayload, ProgressCallback, QrDetectedState, QrDetectionEntry, QrMarkerState, QrPoseStability, QrPoseStabilityOptions, QrPoseStabilityStatus, QrSizeEstimate, QrSizeStatus, RawDeviceOrientation, RawGpsPoint, RecordGpsEventPayload, RecordingCoordinatorConfig, RecordingOptionsInput, RecordingState, ReplayAction, ReplayEngine, ReplayRecordingOptions, ReplayState, ResetTransformData, RootWithQrDetected, STORAGE_KEY, SessionMetadata$1 as SessionMetadata, SlamAppCombinedState, SlamAppMiddleware, SlamAppRootState, SlamAppStore, SlamAppStoreOptions, StorageBackend, StoreSubscriberDeps, SubscribableStore, TrackingPhase, TrackingQualityOptions, TrackingQualityReport, TrackingQualitySliceState, TrackingQualityState, TrackingSliceState, add2dImage, buildRawGpsPoint, buildRecordGpsEventPayload, calcRelativeCoordsInMeters, captureGpsAnchorSample, clearAllQrMarkers, clearLastRestartedPayload, clearQrMarker, cloneRecordingOptions, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeInterActionDelay, computeOnboardingGuidance, computeResidualConsensus, computeTrackingQualityReport, createGpsPositionHandler, createPersistenceMiddleware, createSlamAppStore, createTrackingQualityListenerMiddleware, degradedCountUpdated, endSession, eulerToQuaternion, extractActionTimestamp, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, loadRecordingOptions, matrixDelta, medianQrPosition, originReset, poseLost, poseReceived, pruneQrDetections, qrDetectedReducer, recordDepthSample, recordGpsEvent, recordQrDetection, recordQrSizeEstimate, recordWriteFailure, recordingReducer, replayRecording, reportUpdated, resetCoordinatorState, resetRecordingOptions, resetTracking, resetTrackingQuality, saveRecordingOptions, selectAlignmentMatrix, selectDerivedQrPlacement, selectFrameTilesInWebXR, selectGpsPositions, selectLastRestartedPayload, selectLastSensorOrientation, selectLastValidPose, selectLatestQrDetection, selectLostFrameCount, selectOdometryPositions, selectOdometryRotations, selectOnboardingGuidance, selectQrMarker, selectQrMarkers, selectQrPoseStability, selectQrRawObservations, selectQrSize, selectRecentAlignments, selectResolvedQrSizeM, selectSolvedQrPose, selectStableQrPose, selectTrackingPhase, selectTrackingQuality, selectZeroReference, setQrMaxHistory, setZeroPos, slicePrefixOf, snapshotPushed, snapshotsTrimmed, startSession, subscribeToSelector, trackingQualityReducer, trackingReducer, updateDeviceOrientation, validateDepthOptions, validateImageOptions, validateRecordingOptions, wireStoreSubscribers };

package/dist/state/recording-options.d.ts

@@ -1,2 +1,2 @@
-import { A as validateImageOptions, C as loadRecordingOptions, D as validateCompassDebugOptions, E as validateArCrashIsolationOptions, F as validateRecordingOptions, I as validateVisualizationOptions, M as validateOccupancyOptions, N as validateQrOptions, O as validateDepthOptions, P as validateQualityFilterOptions, S as cloneRecordingOptions, T as saveRecordingOptions, _ as QrCaptureOptions, a as DepthCaptureOptions, b as STORAGE_KEY, c as IMAGE_CONSTRAINTS, d as OCCUPANCY_CONSTRAINTS, f as OccluderDebugStyle, g as QUALITY_FILTER_CONSTRAINTS, h as QR_CONSTRAINTS, i as DEPTH_CONSTRAINTS, j as validateMotionFilterOptions, k as validateFrameTileDisplayOptions, l as ImageCaptureOptions, m as OccupancyOptions, n as CompassDebugOptions, o as FRAME_TILE_DISPLAY_CONSTRAINTS, p as OccluderMeshMode, r as DEFAULT_RECORDING_OPTIONS, s as FrameTileDisplayOptions, t as ArCrashIsolationOptions, u as MOTION_FILTER_CONSTRAINTS, v as RecordingOptions, w as resetRecordingOptions, x as VisualizationOptions, y as RecordingOptionsInput } from "../recording-options-vASCFzc5.js";
-export { ArCrashIsolationOptions, CompassDebugOptions, DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, DepthCaptureOptions, FRAME_TILE_DISPLAY_CONSTRAINTS, FrameTileDisplayOptions, IMAGE_CONSTRAINTS, ImageCaptureOptions, MOTION_FILTER_CONSTRAINTS, OCCUPANCY_CONSTRAINTS, OccluderDebugStyle, OccluderMeshMode, OccupancyOptions, QR_CONSTRAINTS, QUALITY_FILTER_CONSTRAINTS, QrCaptureOptions, RecordingOptions, RecordingOptionsInput, STORAGE_KEY, VisualizationOptions, cloneRecordingOptions, loadRecordingOptions, resetRecordingOptions, saveRecordingOptions, validateArCrashIsolationOptions, validateCompassDebugOptions, validateDepthOptions, validateFrameTileDisplayOptions, validateImageOptions, validateMotionFilterOptions, validateOccupancyOptions, validateQrOptions, validateQualityFilterOptions, validateRecordingOptions, validateVisualizationOptions };
+import { A as validateFrameTileDisplayOptions, C as cloneRecordingOptions, D as validateArCrashIsolationOptions, E as saveRecordingOptions, F as validateQrOptions, I as validateQualityFilterOptions, L as validateRecordingOptions, M as validateLoopClosureDebugOptions, N as validateMotionFilterOptions, O as validateCompassDebugOptions, P as validateOccupancyOptions, R as validateVisualizationOptions, S as VisualizationOptions, T as resetRecordingOptions, _ as QUALITY_FILTER_CONSTRAINTS, a as DepthCaptureOptions, b as RecordingOptionsInput, c as IMAGE_CONSTRAINTS, d as MOTION_FILTER_CONSTRAINTS, f as OCCUPANCY_CONSTRAINTS, g as QR_CONSTRAINTS, h as OccupancyOptions, i as DEPTH_CONSTRAINTS, j as validateImageOptions, k as validateDepthOptions, l as ImageCaptureOptions, m as OccluderMeshMode, n as CompassDebugOptions, o as FRAME_TILE_DISPLAY_CONSTRAINTS, p as OccluderDebugStyle, r as DEFAULT_RECORDING_OPTIONS, s as FrameTileDisplayOptions, t as ArCrashIsolationOptions, u as LoopClosureDebugOptions, v as QrCaptureOptions, w as loadRecordingOptions, x as STORAGE_KEY, y as RecordingOptions } from "../recording-options-DYKWVI93.js";
+export { ArCrashIsolationOptions, CompassDebugOptions, DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, DepthCaptureOptions, FRAME_TILE_DISPLAY_CONSTRAINTS, FrameTileDisplayOptions, IMAGE_CONSTRAINTS, ImageCaptureOptions, LoopClosureDebugOptions, MOTION_FILTER_CONSTRAINTS, OCCUPANCY_CONSTRAINTS, OccluderDebugStyle, OccluderMeshMode, OccupancyOptions, QR_CONSTRAINTS, QUALITY_FILTER_CONSTRAINTS, QrCaptureOptions, RecordingOptions, RecordingOptionsInput, STORAGE_KEY, VisualizationOptions, cloneRecordingOptions, loadRecordingOptions, resetRecordingOptions, saveRecordingOptions, validateArCrashIsolationOptions, validateCompassDebugOptions, validateDepthOptions, validateFrameTileDisplayOptions, validateImageOptions, validateLoopClosureDebugOptions, validateMotionFilterOptions, validateOccupancyOptions, validateQrOptions, validateQualityFilterOptions, validateRecordingOptions, validateVisualizationOptions };

package/dist/state/recording-options.js

@@ -124,7 +124,8 @@ const DEFAULT_RECORDING_OPTIONS = {
 		coldStartOverride: true,
 		rotationPrior: false,
 		webXRConsistency: false
-	}
+	},
+	loopClosureDebug: { detectorEnabled: false }
 };
 /** Validation constraints for depth options */
 const DEPTH_CONSTRAINTS = {
@@ -317,6 +318,15 @@ function validateCompassDebugOptions(options) {
 	};
 }
 /**
+* Validate and normalize the loop-closure capture toggles. Boolean-or-default
+* per field; a missing/corrupted/pre-feature value falls back to the OFF
+* default so a bad persisted value can never silently wire the detector in.
+*/
+function validateLoopClosureDebugOptions(options) {
+	const defaults = DEFAULT_RECORDING_OPTIONS.loopClosureDebug;
+	return { detectorEnabled: typeof options.detectorEnabled === "boolean" ? options.detectorEnabled : defaults.detectorEnabled };
+}
+/**
 * Validate and normalize the live debug-overlay visibility toggles.
 * Each field is boolean-or-default (same policy as the AR-crash-isolation
 * flags): a missing, corrupted, or pre-feature persisted value falls back to
@@ -504,7 +514,8 @@ function validateRecordingOptions(options) {
 		frameTileDisplay: validateFrameTileDisplayOptions(options.frameTileDisplay ?? {}),
 		visualization: validateVisualizationOptions(options.visualization ?? {}),
 		qr: validateQrOptions(options.qr ?? {}),
-		compassDebug: validateCompassDebugOptions(options.compassDebug ?? {})
+		compassDebug: validateCompassDebugOptions(options.compassDebug ?? {}),
+		loopClosureDebug: validateLoopClosureDebugOptions(options.loopClosureDebug ?? {})
 	};
 }
 /**
@@ -572,8 +583,9 @@ function cloneRecordingOptions(options) {
 		frameTileDisplay: { ...options.frameTileDisplay },
 		visualization: { ...options.visualization },
 		qr: { ...options.qr },
-		compassDebug: { ...options.compassDebug }
+		compassDebug: { ...options.compassDebug },
+		loopClosureDebug: { ...options.loopClosureDebug }
 	};
 }
 //#endregion
-export { DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, FRAME_TILE_DISPLAY_CONSTRAINTS, IMAGE_CONSTRAINTS, MOTION_FILTER_CONSTRAINTS, OCCUPANCY_CONSTRAINTS, QR_CONSTRAINTS, QUALITY_FILTER_CONSTRAINTS, STORAGE_KEY, cloneRecordingOptions, loadRecordingOptions, resetRecordingOptions, saveRecordingOptions, validateArCrashIsolationOptions, validateCompassDebugOptions, validateDepthOptions, validateFrameTileDisplayOptions, validateImageOptions, validateMotionFilterOptions, validateOccupancyOptions, validateQrOptions, validateQualityFilterOptions, validateRecordingOptions, validateVisualizationOptions };
+export { DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, FRAME_TILE_DISPLAY_CONSTRAINTS, IMAGE_CONSTRAINTS, MOTION_FILTER_CONSTRAINTS, OCCUPANCY_CONSTRAINTS, QR_CONSTRAINTS, QUALITY_FILTER_CONSTRAINTS, STORAGE_KEY, cloneRecordingOptions, loadRecordingOptions, resetRecordingOptions, saveRecordingOptions, validateArCrashIsolationOptions, validateCompassDebugOptions, validateDepthOptions, validateFrameTileDisplayOptions, validateImageOptions, validateLoopClosureDebugOptions, validateMotionFilterOptions, validateOccupancyOptions, validateQrOptions, validateQualityFilterOptions, validateRecordingOptions, validateVisualizationOptions };

package/dist/state/recording-replayer.d.ts

@@ -1,3 +1,3 @@
-import { N as CombinedRootState } from "../create-slam-app-store-D3nzh9Wb.js";
-import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-D0V9WkmY.js";
+import { N as CombinedRootState } from "../create-slam-app-store-D1QSMuKu.js";
+import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-BJ8Lf0QY.js";
 export { CombinedRootState, ReplayRecordingOptions, replayRecording };

package/dist/state/recording-slice.d.ts

@@ -1,2 +1,2 @@
-import { a as recordWriteFailure, i as recordDepthSample, n as SessionMetadata, o as recordingReducer, r as endSession, s as startSession, t as RecordingState } from "../recording-slice-DTUtSVgd.js";
+import { a as recordWriteFailure, i as recordDepthSample, n as SessionMetadata, o as recordingReducer, r as endSession, s as startSession, t as RecordingState } from "../recording-slice-BW8SiLo1.js";
 export { RecordingState, SessionMetadata, endSession, recordDepthSample, recordWriteFailure, recordingReducer, startSession };

package/dist/state/replay-engine.d.ts

@@ -1,2 +1,2 @@
-import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-xdrUgWJi.js";
+import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-DmCAc7WM.js";
 export { CompleteCallback, DEFAULT_MAX_DELAY_MS, ErrorCallback, ProgressCallback, ReplayAction, ReplayEngine, ReplayState, computeInterActionDelay, extractActionTimestamp };

package/dist/state/store-subscribers.d.ts

@@ -1,3 +1,3 @@
-import { t as SubscribableStore } from "../subscribe-to-selector-B9ylM5Oh.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-DScA7tdT.js";
+import { t as SubscribableStore } from "../subscribe-to-selector-dQV8SpsO.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-DJUErW-o.js";
 export { StoreSubscriberDeps, SubscribableStore, wireStoreSubscribers };

package/dist/state/store-subscribers.js

@@ -1,9 +1,11 @@
+import { createLogger } from "../utils/logger.js";
 import { selectAlignmentMatrix, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectZeroReference } from "./app-selectors.js";
-import { t as buildMapData } from "../map-data-D7rpMC6f.js";
+import { t as buildMapData } from "../map-data-1tF5gcYV.js";
 import { subscribeToSelector } from "./subscribe-to-selector.js";
 import { calcGpsCoords } from "gps-plus-slam-js";
 import { mat4, vec3 } from "gl-matrix";
 //#region ../src/state/store-subscribers.ts
+const log = createLogger("StoreSubscribers");
 /**
 * Wire store state-change subscriptions to visualization dependencies.
 *
@@ -34,23 +36,33 @@ function wireStoreSubscribers(store, deps) {
 	* positions change — the change-gated subscriptions below provide the
 	* throttling, so no extra debouncing is needed. The fused path is always
 	* recomputed from the latest matrix inside `buildMapData` (D2).
+	*
+	* Returns the rendered `MapData` so the GPS subscription can center the map
+	* on the SAME coordinate the dot shows (fused when available — 2026-07-06
+	* fused-dot feedback, Slice B), or `null` when there is no overlay or it
+	* has no `render` (the minimal `setGpsPosition`-only dep shape).
 	*/
 	function rebuildMap() {
-		if (!deps.mapOverlay?.render) return;
+		if (!deps.mapOverlay?.render) return null;
 		const state = store.getState();
-		const rawGpsPath = selectGpsPositions(state).map((p) => ({
-			lat: p.latitude,
-			lng: p.longitude,
-			accuracy: p.latLongAccuracy
-		}));
-		deps.mapOverlay.render(buildMapData({
-			rawGpsPath,
+		const data = buildMapData({
+			rawGpsPath: selectGpsPositions(state).map((p) => ({
+				lat: p.latitude,
+				lng: p.longitude,
+				accuracy: p.latLongAccuracy
+			})),
 			odometryPositions: selectOdometryPositions(state),
 			odometryRotations: selectOdometryRotations(state),
 			alignmentMatrix: selectAlignmentMatrix(state),
 			zeroRef: selectZeroReference(state),
 			alignmentSnapshots: alignmentSnapshotGps
-		}));
+		});
+		try {
+			deps.mapOverlay.render(data);
+		} catch (err) {
+			log.warn("Map overlay render failed; continuing with centering:", err);
+		}
+		return data;
 	}
 	unsubs.push(subscribeToSelector(store, selectAlignmentMatrix, (matrix) => {
 		if (!matrix) return;
@@ -102,11 +114,12 @@ function wireStoreSubscribers(store, deps) {
 				if (odomRot) deps.onNewOdomPose?.(odomPos, odomRot);
 			}
 		}
-		if (deps.mapOverlay && gpsPositions.length > 0) {
+		const mapData = rebuildMap();
+		if (deps.mapOverlay && gpsPositions.length > 0) if (mapData?.userPosition) deps.mapOverlay.setGpsPosition(mapData.userPosition.lat, mapData.userPosition.lng);
+		else {
 			const lastGpsPoint = gpsPositions[gpsPositions.length - 1];
 			deps.mapOverlay.setGpsPosition(lastGpsPoint.latitude, lastGpsPoint.longitude);
 		}
-		rebuildMap();
 	}));
 	return () => {
 		for (const unsub of unsubs) unsub();

package/dist/state/subscribe-to-selector.d.ts

@@ -1,2 +1,2 @@
-import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector-B9ylM5Oh.js";
+import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector-dQV8SpsO.js";
 export { SubscribableStore, subscribeToSelector };

package/dist/state/tracking-quality.d.ts

@@ -1,2 +1,2 @@
-import { A as snapshotPushed, C as createTrackingQualityListenerMiddleware, D as resetTrackingQuality, E as reportUpdated, M as trackingQualityReducer, O as selectRecentAlignments, S as computeTrackingQualityReport, T as matrixDelta, _ as computeConvergence, b as computeGpsVsFusedDivergence, c as ConvergenceResult, d as GpsAccuracyResult, f as ResidualConsensusResult, g as TrackingQualityState, h as TrackingQualitySliceState, j as snapshotsTrimmed, k as selectTrackingQuality, l as CoverageResult, m as TrackingQualityReport, p as TrackingQualityOptions, s as AlignmentSnapshot, u as DEFAULT_TRACKING_QUALITY_OPTIONS, v as computeCoverage, w as degradedCountUpdated, x as computeResidualConsensus, y as computeGpsAccuracy } from "../create-slam-app-store-D3nzh9Wb.js";
+import { A as snapshotPushed, C as createTrackingQualityListenerMiddleware, D as resetTrackingQuality, E as reportUpdated, M as trackingQualityReducer, O as selectRecentAlignments, S as computeTrackingQualityReport, T as matrixDelta, _ as computeConvergence, b as computeGpsVsFusedDivergence, c as ConvergenceResult, d as GpsAccuracyResult, f as ResidualConsensusResult, g as TrackingQualityState, h as TrackingQualitySliceState, j as snapshotsTrimmed, k as selectTrackingQuality, l as CoverageResult, m as TrackingQualityReport, p as TrackingQualityOptions, s as AlignmentSnapshot, u as DEFAULT_TRACKING_QUALITY_OPTIONS, v as computeCoverage, w as degradedCountUpdated, x as computeResidualConsensus, y as computeGpsAccuracy } from "../create-slam-app-store-D1QSMuKu.js";
 export { AlignmentSnapshot, ConvergenceResult, CoverageResult, DEFAULT_TRACKING_QUALITY_OPTIONS, GpsAccuracyResult, ResidualConsensusResult, TrackingQualityOptions, TrackingQualityReport, TrackingQualitySliceState, TrackingQualityState, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeResidualConsensus, computeTrackingQualityReport, createTrackingQualityListenerMiddleware, degradedCountUpdated, matrixDelta, reportUpdated, resetTrackingQuality, selectRecentAlignments, selectTrackingQuality, snapshotPushed, snapshotsTrimmed, trackingQualityReducer };

package/dist/state/tracking-quality.js

@@ -157,11 +157,10 @@ function computeConvergence(snapshots, options = {}) {
 * compute the Euclidean distance.
 *
 * This is the **single shared kernel** for the AppFramework reporter and
-* the Investigation harness (see §11 (a) of the tracking-quality plan).
-* `GpsPlusSlamJs_Investigation/src/investigation-helpers.ts` re-exports
-* `computeStabilityDelta` as a thin wrapper around this function so the
-* §6.1 corpus sweep and the runtime convergence score share one numeric
-* definition.
+* the downstream corpus-analysis harness (see §11 (a) of the
+* tracking-quality plan), which re-exports it as `computeStabilityDelta` —
+* a thin wrapper around this function — so the §6.1 corpus sweep and the
+* runtime convergence score share one numeric definition.
 */
 function matrixDelta(prev, curr) {
 	if (prev.length !== 16 || curr.length !== 16) return {

package/dist/storage/index.d.ts

@@ -1,6 +1,6 @@
 import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, h as writeSessionMetadata, i as createSession, l as listSessions, n as SessionMetadata, o as getSessionHandle, r as checkStorageQuota, s as getSessionsRootHandle, u as resetOpfsStorage } from "../opfs-storage-CTkxvxN4.js";
 import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-sEtmM4yW.js";
-import { a as ZipActionEntry, c as loadEntriesFromSubdir, d as loadSessionMetadataFromBlob, f as readZipEntries, i as RecordedAction, l as loadGpsPathFromBlob, n as GpsPathCoord, o as ZipSubdirEntry, r as MAX_ACTION_FILE_SIZE, s as loadActionsFromZip, t as Entry, u as loadSessionMetadata } from "../zip-reader-CvruaGvD.js";
+import { a as ZipActionEntry, c as loadActionsFromZip, d as loadSessionMetadata, f as loadSessionMetadataFromBlob, i as RecordedAction, l as loadEntriesFromSubdir, n as GpsPathCoord, p as readZipEntries, r as MAX_ACTION_FILE_SIZE, s as ZipSubdirEntry, t as Entry, u as loadGpsPathFromBlob } from "../zip-reader-BzENzMH6.js";
 import { t as NullStorageBackend } from "../null-storage-backend-B1-jlpin.js";
 import { t as OpfsStorageBackend } from "../opfs-storage-backend-D6Z03fML.js";
 import { a as formatTimestamp, i as formatFrameFilename, r as formatActionFilename } from "../file-system-utils-DueXHxo9.js";

package/dist/storage/opfs-storage.js

@@ -89,16 +89,21 @@ function getAppRootHandle() {
 	return gpsPlusSlamDir;
 }
 /**
-* True when a session directory named `name` already exists under `dir`.
-* Used by {@link createSession} to avoid silently reusing a directory when two
-* recordings start within the same (second-resolution) timestamp.
+* True when the name `name` is already taken under `dir` (by a session
+* directory — or by a file, which the follow-up `{ create: true }` call could
+* not replace either). Used by {@link createSession} to avoid silently reusing
+* a directory when two recordings start within the same (second-resolution)
+* timestamp. Rethrows unexpected probe errors (storage failures) so the caller
+* fails loudly instead of mislabeling the name.
 */
 async function sessionDirExists(dir, name) {
 	try {
 		await dir.getDirectoryHandle(name, { create: false });
 		return true;
-	} catch {
-		return false;
+	} catch (err) {
+		if (err instanceof DOMException && err.name === "NotFoundError") return false;
+		if (err instanceof DOMException && err.name === "TypeMismatchError") return true;
+		throw err;
 	}
 }
 /**

package/dist/storage/zip-reader.d.ts

@@ -1,2 +1,2 @@
-import { a as ZipActionEntry, c as loadEntriesFromSubdir, d as loadSessionMetadataFromBlob, f as readZipEntries, i as RecordedAction, l as loadGpsPathFromBlob, n as GpsPathCoord, o as ZipSubdirEntry, r as MAX_ACTION_FILE_SIZE, s as loadActionsFromZip, t as Entry, u as loadSessionMetadata } from "../zip-reader-CvruaGvD.js";
-export { Entry, GpsPathCoord, MAX_ACTION_FILE_SIZE, RecordedAction, ZipActionEntry, ZipSubdirEntry, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries };
+import { a as ZipActionEntry, c as loadActionsFromZip, d as loadSessionMetadata, f as loadSessionMetadataFromBlob, i as RecordedAction, l as loadEntriesFromSubdir, m as toZipReader, n as GpsPathCoord, o as ZipSource, p as readZipEntries, r as MAX_ACTION_FILE_SIZE, s as ZipSubdirEntry, t as Entry, u as loadGpsPathFromBlob } from "../zip-reader-BzENzMH6.js";
+export { Entry, GpsPathCoord, MAX_ACTION_FILE_SIZE, RecordedAction, ZipActionEntry, ZipSource, ZipSubdirEntry, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries, toZipReader };

package/dist/storage/zip-reader.js

@@ -18,6 +18,19 @@ import { BlobReader, TextWriter, Uint8ArrayReader, ZipReader } from "@zip.js/zip
 */
 const log = createLogger("ZipReader");
 /**
+* Wrap a {@link ZipSource} in a fresh zip.js ZipReader.
+*
+* Exported deliberately: consumers outside this workspace resolve this
+* module from the published dist at runtime and probe
+* `typeof toZipReader === 'function'` as the capability marker for lazy
+* Reader support before passing anything other than Uint8Array (older
+* published versions accept only Uint8Array). Do not rename or remove
+* without treating it as a breaking API change.
+*/
+function toZipReader(source) {
+	return new ZipReader(source instanceof Uint8Array ? new Uint8ArrayReader(source) : source);
+}
+/**
 * Maximum allowed uncompressed size (in bytes) for a single action or
 * metadata JSON file inside a recording zip. Entries exceeding this limit
 * are rejected before decompression to prevent out-of-memory conditions
@@ -29,11 +42,11 @@ const MAX_ACTION_FILE_SIZE = 1048576;
 /**
 * Read all entries from a zip file.
 *
-* @param data - The zip file content as a Uint8Array
+* @param data - The zip content as a Uint8Array, or a zip.js Reader for lazy access
 * @returns Array of zip entries (directories and files)
 */
 async function readZipEntries(data) {
-	const reader = new ZipReader(new Uint8ArrayReader(data));
+	const reader = toZipReader(data);
 	try {
 		return await reader.getEntries();
 	} finally {
@@ -57,7 +70,7 @@ function extractActionIndex(filename) {
 * Filters for JSON files in the actions/ directory, parses them, and returns
 * them sorted by their filename index (chronological order for replay).
 *
-* @param data - The zip file content as a Uint8Array
+* @param data - The zip content as a Uint8Array, or a zip.js Reader for lazy access
 * @param maxFileSize - Maximum allowed uncompressed size per entry (defaults to MAX_ACTION_FILE_SIZE)
 * @returns Array of action entries sorted by index
 */
@@ -116,12 +129,12 @@ async function extractSessionMetadataFromReader(reader, maxFileSize) {
 * Returns null if session.json is absent (graceful degradation for
 * recordings created before the metadata writing bug was fixed).
 *
-* @param data - The zip file content as a Uint8Array
+* @param data - The zip content as a Uint8Array, or a zip.js Reader for lazy access
 * @param maxFileSize - Maximum allowed uncompressed size per entry (defaults to MAX_ACTION_FILE_SIZE)
 * @returns Parsed session metadata, or null if not found
 */
 async function loadSessionMetadata(data, maxFileSize = MAX_ACTION_FILE_SIZE) {
-	return extractSessionMetadataFromReader(new ZipReader(new Uint8ArrayReader(data)), maxFileSize);
+	return extractSessionMetadataFromReader(toZipReader(data), maxFileSize);
 }
 /**
 * Load session metadata from session.json in a zip file provided as a Blob.
@@ -200,7 +213,7 @@ async function loadGpsPathFromBlob(blob, maxFileSize = MAX_ACTION_FILE_SIZE) {
 * `relativePath` for deterministic iteration. Returns an empty array when
 * the subdir is absent (graceful degradation for older zips).
 *
-* @param data - The zip file content as a Uint8Array
+* @param data - The zip content as a Uint8Array, or a zip.js Reader for lazy access
 * @param subdir - Top-level subdir to scan (no leading or trailing `/`)
 */
 async function loadEntriesFromSubdir(data, subdir) {
@@ -214,4 +227,4 @@ async function loadEntriesFromSubdir(data, subdir) {
 	}));
 }
 //#endregion
-export { MAX_ACTION_FILE_SIZE, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries };
+export { MAX_ACTION_FILE_SIZE, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries, toZipReader };

package/dist/{store-subscribers-DScA7tdT.d.ts → store-subscribers-DJUErW-o.d.ts}

@@ -1,5 +1,5 @@
-import { t as MapData } from "./map-data-PNfGKGWx.js";
-import { t as SubscribableStore } from "./subscribe-to-selector-B9ylM5Oh.js";
+import { t as MapData } from "./map-data-CUnTzRIC.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-dQV8SpsO.js";
 import { LatLong, Matrix4, Quaternion, Vector3 } from "gps-plus-slam-js";
 
 //#region ../src/state/store-subscribers.d.ts
@@ -24,7 +24,10 @@ interface StoreSubscriberDeps {
    * Map overlay — renders the shared trajectory snapshot. Nullable (not
    * present in all modes).
    *
-   * `setGpsPosition` centers the map on the latest fix; `render` draws the
+   * `setGpsPosition` centers the map on the same coordinate the blue dot
+   * shows — the rebuilt `MapData.userPosition` (fused tip when aligned, raw
+   * fix before the first solve; raw also for a render-less overlay, which
+   * has no rebuilt snapshot to follow); `render` draws the
    * full {@link MapData} snapshot (raw GPS + accuracy circles, fused path,
    * alignment snapshots, user dot) via the shared `drawMapData` routine — the
    * SAME one the 2D session-summary map uses, so the live and summary maps

package/dist/{subscribe-to-selector-B9ylM5Oh.d.ts → subscribe-to-selector-dQV8SpsO.d.ts}

@@ -1,4 +1,4 @@
-import { N as CombinedRootState } from "./create-slam-app-store-D3nzh9Wb.js";
+import { N as CombinedRootState } from "./create-slam-app-store-D1QSMuKu.js";
 
 //#region ../src/state/subscribe-to-selector.d.ts
 /**

package/dist/test-utils/browser-mocks.js

@@ -424,6 +424,7 @@ var MockOPFSDirectoryHandle = class MockOPFSDirectoryHandle {
 	getDirectoryHandle(name, options) {
 		const handle = this.contents.get(name);
 		if (handle && handle.kind === "directory") return Promise.resolve(handle);
+		if (handle) return Promise.reject(new DOMException(`${name} is not a directory`, "TypeMismatchError"));
 		if (options?.create) {
 			const newHandle = new MockOPFSDirectoryHandle(name);
 			this.contents.set(name, newHandle);
@@ -434,6 +435,7 @@ var MockOPFSDirectoryHandle = class MockOPFSDirectoryHandle {
 	getFileHandle(name, options) {
 		const handle = this.contents.get(name);
 		if (handle && handle.kind === "file") return Promise.resolve(handle);
+		if (handle) return Promise.reject(new DOMException(`${name} is not a file`, "TypeMismatchError"));
 		if (options?.create) {
 			const newHandle = new MockOPFSFileHandle(name, this, name);
 			this.contents.set(name, newHandle);

package/dist/test-utils/zip-round-trip-helpers.d.ts

@@ -1,4 +1,4 @@
-import { i as RecordedAction } from "../zip-reader-CvruaGvD.js";
+import { i as RecordedAction } from "../zip-reader-BzENzMH6.js";
 import { LatLong } from "gps-plus-slam-js";
 
 //#region ../src/test-utils/zip-round-trip-helpers.d.ts

package/dist/visualization/ar-world-group-alignment.d.ts

@@ -1,2 +1,2 @@
-import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-BlvGcIAk.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-Cfg0trC3.js";
 export { ArWorldGroupAlignmentHandle, ArWorldGroupAlignmentOptions, enableArWorldGroupAlignment };

package/dist/visualization/frame-conversions.d.ts

@@ -1,2 +1,2 @@
-import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-C4bnNOEY.js";
+import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-DDcNHkTb.js";
 export { nueToArLocal, worldNueToGps };

package/dist/visualization/gps-anchor.d.ts

@@ -1,2 +1,2 @@
-import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-BjECcYnD.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-CEjGqEVD.js";
 export { GpsAnchor, GpsAnchorMode, GpsAnchorOptions, GpsAnchorPhase, GpsAnchorSamplePoint, createGpsAnchor };

package/dist/visualization/index.d.ts

@@ -1,19 +1,19 @@
 import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-CPpVtvgs.js";
 import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-DfBm2J5i.js";
 import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-gD70k7Fq.js";
-import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-PNfGKGWx.js";
-import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-BlvGcIAk.js";
+import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-CUnTzRIC.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-Cfg0trC3.js";
 import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-1mooS3BS.js";
 import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-CokkgS_i.js";
-import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-C4bnNOEY.js";
+import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-DDcNHkTb.js";
 import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-CaQbrhbk.js";
-import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-BjECcYnD.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-CEjGqEVD.js";
 import { n as GpsEventVisualizer, r as gpsEventVisualizer } from "../gps-event-markers-Di2nBzx-.js";
-import { n as OcclusionMesh, r as OcclusionMeshOptions } from "../occlusion-mesh-b28lRJ6S.js";
-import { a as DEFAULT_Z_OFFSET, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions } from "../leaflet-map-overlay-BOZFW5kT.js";
+import { n as OcclusionMesh, r as OcclusionMeshOptions } from "../occlusion-mesh-kXCQ2FM1.js";
+import { a as DEFAULT_Z_OFFSET, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions } from "../leaflet-map-overlay-C8GS4cUy.js";
 import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-Qs8OhumS.js";
 import { a as addAccuracyCircles, i as AccuracyCircleSample, n as ACCURACY_CIRCLE_STROKE_OPACITY, r as ACCURACY_CIRCLE_WEIGHT, t as ACCURACY_CIRCLE_FILL_OPACITY } from "../accuracy-circles-DkWBkF5g.js";
-import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-DiroaJed.js";
+import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-6WJeq0Kg.js";
 import { a as MapOverlayOptions, c as tileXYToLatLon, i as MapOverlay, n as DEFAULT_MAP_SIZE, o as TextureLoaderInterface, r as DEFAULT_ZOOM, s as latLonToTileXY, t as DEFAULT_HEIGHT_OFFSET } from "../map-overlay-BCQgvIgU.js";
 import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-BMOAmPhb.js";
 import { t as VIS_COLORS } from "../vis-colors-C7HI0u9_.js";

package/dist/visualization/index.js

@@ -5,7 +5,7 @@ import { createCameraFollower } from "./camera-follower.js";
 import { createAlignmentLerper } from "./alignment-lerper.js";
 import { VIS_COLORS } from "./vis-colors.js";
 import { COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, createGpsCompassCubes } from "./gps-compass-cubes.js";
-import { t as buildMapData } from "../map-data-D7rpMC6f.js";
+import { t as buildMapData } from "../map-data-1tF5gcYV.js";
 import { enableArWorldGroupAlignment } from "./ar-world-group-alignment.js";
 import { buildCameraFrustum, isObjectInCameraFrustum, isPointInCameraFrustum, isSphereInCameraFrustum } from "./frustum-visibility.js";
 import { nueToArLocal, worldNueToGps } from "./frame-conversions.js";

package/dist/visualization/leaflet-map-overlay.d.ts

@@ -1,2 +1,2 @@
-import { a as DEFAULT_Z_OFFSET, i as DEFAULT_ZOOM, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions, t as DEFAULT_HEIGHT_OFFSET } from "../leaflet-map-overlay-BOZFW5kT.js";
+import { a as DEFAULT_Z_OFFSET, i as DEFAULT_ZOOM, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions, t as DEFAULT_HEIGHT_OFFSET } from "../leaflet-map-overlay-C8GS4cUy.js";
 export { DEFAULT_HEIGHT_OFFSET, DEFAULT_LEAFLET_MAP_SIZE_PX, DEFAULT_WORLD_SIZE, DEFAULT_ZOOM, DEFAULT_Z_OFFSET, LeafletMapOverlay, LeafletMapOverlayOptions };

package/dist/visualization/map-data.d.ts

@@ -1,2 +1,2 @@
-import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-PNfGKGWx.js";
+import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-CUnTzRIC.js";
 export { MapData, MapDataInput, buildMapData };

package/dist/visualization/map-data.js

@@ -1,2 +1,2 @@
-import { t as buildMapData } from "../map-data-D7rpMC6f.js";
+import { t as buildMapData } from "../map-data-1tF5gcYV.js";
 export { buildMapData };

package/dist/visualization/map-overlay-draw.d.ts

@@ -1,2 +1,2 @@
-import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-DiroaJed.js";
+import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-6WJeq0Kg.js";
 export { ALIGNMENT_SNAPSHOT_COLOR, DrawMapDataOptions, DrawnMapData, FUSED_PATH_COLOR, MAP_PATH_POLYLINE_OPACITY, MAP_PATH_POLYLINE_WEIGHT, RAW_GPS_COLOR, USER_POSITION_COLOR, drawMapData };

package/dist/visualization/occlusion-mesh.d.ts

@@ -1,2 +1,2 @@
-import { a as occluderDepthFade, i as buildOccluderDepthShadeSnippet, n as OcclusionMesh, o as occluderFresnelRim, r as OcclusionMeshOptions, t as OCCLUDER_DEPTH_SHADE } from "../occlusion-mesh-b28lRJ6S.js";
+import { a as occluderDepthFade, i as buildOccluderDepthShadeSnippet, n as OcclusionMesh, o as occluderFresnelRim, r as OcclusionMeshOptions, t as OCCLUDER_DEPTH_SHADE } from "../occlusion-mesh-kXCQ2FM1.js";
 export { OCCLUDER_DEPTH_SHADE, OcclusionMesh, OcclusionMeshOptions, buildOccluderDepthShadeSnippet, occluderDepthFade, occluderFresnelRim };

package/dist/{webxr-session-cRG2SYAQ.d.ts → webxr-session-BWCpGd-2.d.ts}

@@ -1,6 +1,6 @@
 import { i as DepthSample, t as ARPose } from "./ar-types-Cc5yvBwn.js";
 import { i as DepthSamplerConfig, t as DepthInfo } from "./depth-sampler-CwObAwEA.js";
-import { t as ArCrashIsolationOptions } from "./recording-options-vASCFzc5.js";
+import { t as ArCrashIsolationOptions } from "./recording-options-DYKWVI93.js";
 import { i as FrameQualityVerdict, n as CapturedImage, o as ImageCaptureConfig, t as CapturedFrame } from "./image-capture-Bp6Pd4Md.js";
 import { a as TrackingSliceState, r as ResetTransformData } from "./tracking-slice-DMkHlbny.js";
 import { o as RgbaImage } from "./qr-frontend-BPURlh3S.js";

package/dist/{zip-reader-CvruaGvD.d.ts → zip-reader-BzENzMH6.d.ts}

@@ -1,6 +1,32 @@
-import { Entry, Entry as Entry$1 } from "@zip.js/zip.js";
+import { Entry, Entry as Entry$1, Reader, ZipReader } from "@zip.js/zip.js";
 
 //#region ../src/storage/zip-reader.d.ts
+/**
+ * Input accepted by the zip-reading helpers: either the full zip bytes
+ * (the original behavior) or any zip.js {@link Reader} — e.g. a ranged
+ * reader over a file descriptor — so callers scanning many large archives
+ * can read only the central directory + the entries they open instead of
+ * loading whole files into memory.
+ *
+ * Reader contract: a single Reader instance may back several helper calls
+ * concurrently (see `loadRecording` in gps-plus-slam-recorder, which fans
+ * out over three helpers via Promise.all), so `init()` must be idempotent
+ * and `readUint8Array(index, length)` must support interleaved ranged reads.
+ * The caller owns the underlying resource lifecycle (helpers close their
+ * ZipReader wrappers, never the Reader's resource).
+ */
+type ZipSource = Uint8Array | Reader<unknown>;
+/**
+ * Wrap a {@link ZipSource} in a fresh zip.js ZipReader.
+ *
+ * Exported deliberately: consumers outside this workspace resolve this
+ * module from the published dist at runtime and probe
+ * `typeof toZipReader === 'function'` as the capability marker for lazy
+ * Reader support before passing anything other than Uint8Array (older
+ * published versions accept only Uint8Array). Do not rename or remove
+ * without treating it as a breaking API change.
+ */
+declare function toZipReader(source: ZipSource): ZipReader<unknown>;
 /**
  * Maximum allowed uncompressed size (in bytes) for a single action or
  * metadata JSON file inside a recording zip. Entries exceeding this limit
@@ -29,32 +55,32 @@ interface ZipActionEntry {
 /**
  * Read all entries from a zip file.
  *
- * @param data - The zip file content as a Uint8Array
+ * @param data - The zip content as a Uint8Array, or a zip.js Reader for lazy access
  * @returns Array of zip entries (directories and files)
  */
-declare function readZipEntries(data: Uint8Array): Promise<Entry[]>;
+declare function readZipEntries(data: ZipSource): Promise<Entry[]>;
 /**
  * Load all recorded Redux actions from a zip file.
  *
  * Filters for JSON files in the actions/ directory, parses them, and returns
  * them sorted by their filename index (chronological order for replay).
  *
- * @param data - The zip file content as a Uint8Array
+ * @param data - The zip content as a Uint8Array, or a zip.js Reader for lazy access
  * @param maxFileSize - Maximum allowed uncompressed size per entry (defaults to MAX_ACTION_FILE_SIZE)
  * @returns Array of action entries sorted by index
  */
-declare function loadActionsFromZip(data: Uint8Array, maxFileSize?: number): Promise<ZipActionEntry[]>;
+declare function loadActionsFromZip(data: ZipSource, maxFileSize?: number): Promise<ZipActionEntry[]>;
 /**
  * Load session metadata from session.json in the zip file.
  *
  * Returns null if session.json is absent (graceful degradation for
  * recordings created before the metadata writing bug was fixed).
  *
- * @param data - The zip file content as a Uint8Array
+ * @param data - The zip content as a Uint8Array, or a zip.js Reader for lazy access
  * @param maxFileSize - Maximum allowed uncompressed size per entry (defaults to MAX_ACTION_FILE_SIZE)
  * @returns Parsed session metadata, or null if not found
  */
-declare function loadSessionMetadata(data: Uint8Array, maxFileSize?: number): Promise<Record<string, unknown> | null>;
+declare function loadSessionMetadata(data: ZipSource, maxFileSize?: number): Promise<Record<string, unknown> | null>;
 /**
  * Load session metadata from session.json in a zip file provided as a Blob.
  *
@@ -126,9 +152,9 @@ interface ZipSubdirEntry {
  * `relativePath` for deterministic iteration. Returns an empty array when
  * the subdir is absent (graceful degradation for older zips).
  *
- * @param data - The zip file content as a Uint8Array
+ * @param data - The zip content as a Uint8Array, or a zip.js Reader for lazy access
  * @param subdir - Top-level subdir to scan (no leading or trailing `/`)
  */
-declare function loadEntriesFromSubdir(data: Uint8Array, subdir: string): Promise<ZipSubdirEntry[]>;
+declare function loadEntriesFromSubdir(data: ZipSource, subdir: string): Promise<ZipSubdirEntry[]>;
 //#endregion
-export { ZipActionEntry as a, loadEntriesFromSubdir as c, loadSessionMetadataFromBlob as d, readZipEntries as f, RecordedAction as i, loadGpsPathFromBlob as l, GpsPathCoord as n, ZipSubdirEntry as o, MAX_ACTION_FILE_SIZE as r, loadActionsFromZip as s, Entry$1 as t, loadSessionMetadata as u };
+export { ZipActionEntry as a, loadActionsFromZip as c, loadSessionMetadata as d, loadSessionMetadataFromBlob as f, RecordedAction as i, loadEntriesFromSubdir as l, toZipReader as m, GpsPathCoord as n, ZipSource as o, readZipEntries as p, MAX_ACTION_FILE_SIZE as r, ZipSubdirEntry as s, Entry$1 as t, loadGpsPathFromBlob as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gps-plus-slam-app-framework",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "description": "Reusable AR+GPS app framework layer — WebXR session management, Three.js visualization, GPS sensors, storage abstractions, replay engine, and store wiring for gps-plus-slam-js.",
   "type": "module",
   "files": [
@@ -31,12 +31,12 @@
   },
   "types": "./dist/index.d.ts",
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=22.14.0"
   },
   "dependencies": {
     "@reduxjs/toolkit": "^2.11.2",
     "gl-matrix": "3.4.4",
-    "gps-plus-slam-js": "^1.8.0"
+    "gps-plus-slam-js": "^1.9.1"
   },
   "peerDependencies": {
     "@sentry/browser": ">=10.0.0",
@@ -58,6 +58,7 @@
     "@sentry/browser": "^10.53.1",
     "@types/leaflet": "^1.9.21",
     "@types/node": "^25.7.0",
+    "@types/qrcode": "^1.5.6",
     "@types/three": "^0.184.1",
     "@vitest/coverage-v8": "^4.1.6",
     "@vitest/eslint-plugin": "^1.6.17",
@@ -71,6 +72,7 @@
     "jsdom": "^29.1.1",
     "leaflet": "^1.9.4",
     "prettier": "^3.8.3",
+    "qrcode": "^1.5.4",
     "three": "^0.184.0",
     "tsdown": "^0.22.0",
     "typescript": "^6.0.3",
@@ -109,6 +111,8 @@
     "typecheck:tests": "tsc -p tsconfig.vitest.json --noEmit",
     "lint": "eslint . --config config/eslint.config.mjs --max-warnings 37",
     "test:watch": "vitest --config config/vitest.config.ts",
+    "bench": "vitest bench --run --config config/vitest.bench.config.ts",
+    "bench:watch": "vitest bench --config config/vitest.bench.config.ts",
     "check:cycles": "dpdm -T --exit-code circular:1 --no-warning --no-tree ./src/index.ts",
     "setup": "bash ./scripts/setup.sh"
   }

package/dist/index-D4vrgV4b.d.ts

@@ -1,2 +0,0 @@
-import { ArImageCapture as ArImageCapture$1, GpsPoint as GpsPoint$1, LatLong as LatLong$1, LatLongAlt, Matrix4 as Matrix4$1, Quaternion as Quaternion$1, RootState as LibraryRootState, RootState as RootState$1, Vector3 as Vector3$1, arNorthBearingDeg, bearingDeltaDeg, calcGpsCoords as calcGpsCoords$1, calcRelativeCoordsInMeters, createGpsSlamStore, isIdentityMatrix4, magneticHeadingFromEnuQuat, odometryTrackingRestarted, validateLicenseKey as validateLicenseKey$1, webxrToNUE } from "gps-plus-slam-js";
-export { odometryTrackingRestarted as _, LibraryRootState as a, RootState$1 as c, bearingDeltaDeg as d, calcGpsCoords$1 as f, magneticHeadingFromEnuQuat as g, isIdentityMatrix4 as h, LatLongAlt as i, Vector3$1 as l, createGpsSlamStore as m, GpsPoint$1 as n, Matrix4$1 as o, calcRelativeCoordsInMeters as p, LatLong$1 as r, Quaternion$1 as s, ArImageCapture$1 as t, arNorthBearingDeg as u, validateLicenseKey$1 as v, webxrToNUE as y };