gps-plus-slam-app-framework 1.10.0 → 1.13.0

package/dist/ar/{qr-derived-pose.js → qr/qr-derived-pose.js}

@@ -1,6 +1,6 @@
-import { t as createQrSizeMeasurer } from "../qr-size-measurer-BVOIg-He.js";
+import { t as createQrSizeMeasurer } from "../../qr-size-measurer-zZB9S1va.js";
 import { intrinsicsFromProjection, solveQrPose } from "./qr-pose.js";
-//#region ../src/ar/qr-derived-pose.ts
+//#region ../src/ar/qr/qr-derived-pose.ts
 /**
 * Replay a marker's observation history through a fresh size measurer (each
 * observation sized against its own as-of depth context) and return the running

package/dist/ar/{qr-detection-controller.d.ts → qr/qr-detection-controller.d.ts}

@@ -1,2 +1,2 @@
-import { a as createQrDetectionController, i as RawObservationSink, n as QrDetectionControllerDeps, r as QrScanStatus, t as QrDetectionController } from "../qr-detection-controller-IcMRpTjV.js";
+import { a as createQrDetectionController, i as RawObservationSink, n as QrDetectionControllerDeps, r as QrScanStatus, t as QrDetectionController } from "../../qr-detection-controller-Dh4Paymb.js";
 export { QrDetectionController, QrDetectionControllerDeps, QrScanStatus, RawObservationSink, createQrDetectionController };

package/dist/ar/qr/qr-detection-controller.js

@@ -0,0 +1,2 @@
+import { t as createQrDetectionController } from "../../qr-detection-controller-DXc1yHRf.js";
+export { createQrDetectionController };

package/dist/ar/{qr-frontend.d.ts → qr/qr-frontend.d.ts}

@@ -1,2 +1,2 @@
-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-61SKPSyU.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-BnLlVjKu.js";
 export { BarcodeDetectorFrontEnd, BarcodeDetectorLike, DetectedBarcodeLike, QrDetection, QrFrontEnd, RgbaImage, ToImageBitmapSource, createBarcodeDetectorFrontEnd };

package/dist/ar/{qr-frontend.js → qr/qr-frontend.js}

@@ -1,4 +1,4 @@
-//#region ../src/ar/qr-frontend.ts
+//#region ../src/ar/qr/qr-frontend.ts
 const defaultToImageData = (image) => new ImageData(new Uint8ClampedArray(image.data), image.width, image.height);
 var BarcodeDetectorFrontEnd = class {
 	kind = "barcode-detector";

package/dist/ar/{qr-pose.d.ts → qr/qr-pose.d.ts}

@@ -1,2 +1,2 @@
-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-CCTF1PP0.js";
+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-_dInl6di.js";
 export { CameraIntrinsics, OpenCvPnpResult, Point2, Pose, QrPoseSolution, QuadValidation, SolvePnpSquare, SolveQrPoseInput, buildObjectPoints, composePose, intrinsicsFromProjection, invertPose, projectViewPoint, qrInCameraFromOpenCv, reprojectionErrorPx, signedQuadArea, solveQrPose, transformPoint, validateQuad };

package/dist/ar/{qr-pose.js → qr/qr-pose.js}

@@ -1,5 +1,5 @@
 import { quat, vec3 } from "gl-matrix";
-//#region ../src/ar/qr-pose.ts
+//#region ../src/ar/qr/qr-pose.ts
 /**
 * QR pose math — Phase 1 of the QR-code detection & 3D-tracking plan.
 *

package/dist/ar/qr/qr-size-depth-context.d.ts

@@ -0,0 +1,3 @@
+import { n as QrSizeDepthContext } from "../../qr-size-measurer-18_W3INY.js";
+import { t as createQrSizeDepthContext } from "../../qr-size-depth-context-Bzbx98nS.js";
+export { QrSizeDepthContext, createQrSizeDepthContext };

package/dist/ar/{qr-size-depth-context.js → qr/qr-size-depth-context.js}

@@ -1,6 +1,6 @@
-import { createDepthUnprojector } from "./depth-unprojection.js";
-import { createDepthGridLookup } from "./depth-grid-lookup.js";
-//#region ../src/ar/qr-size-depth-context.ts
+import { createDepthUnprojector } from "../depth-unprojection.js";
+import { createDepthGridLookup } from "../depth-grid-lookup.js";
+//#region ../src/ar/qr/qr-size-depth-context.ts
 /**
 * `createQrSizeDepthContext` — build a {@link QrSizeDepthContext} (unprojector +
 * bilinear depth-grid lookup) from one {@link DepthSample}.
@@ -16,7 +16,7 @@ import { createDepthGridLookup } from "./depth-grid-lookup.js";
 * consumer composes whatever extra it needs on top (the demo adds `cameraPose` +
 * `projectionMatrix` for the PnP intrinsics).
 *
-* Deep-imported via `…/ar/qr-size-depth-context` (NOT the `…/ar` barrel) so the
+* Deep-imported via `…/ar/qr/qr-size-depth-context` (NOT the `…/ar` barrel) so the
 * Recorder's partially-mocked wiring tests don't pull heavy transitive deps —
 * same rationale as `qr-depth-resolver` / `qr-debug-view`.
 *

package/dist/ar/{qr-size-measurer.d.ts → qr/qr-size-measurer.d.ts}

@@ -1,2 +1,2 @@
-import { a as QrSizeMeasurerOptions, i as QrSizeMeasurer, n as QrSizeDepthContext, o as createQrSizeMeasurer, r as QrSizeMeasurement, t as ImageSize } from "../qr-size-measurer-Bl_i-umk.js";
+import { a as QrSizeMeasurerOptions, i as QrSizeMeasurer, n as QrSizeDepthContext, o as createQrSizeMeasurer, r as QrSizeMeasurement, t as ImageSize } from "../../qr-size-measurer-18_W3INY.js";
 export { ImageSize, QrSizeDepthContext, QrSizeMeasurement, QrSizeMeasurer, QrSizeMeasurerOptions, createQrSizeMeasurer };

package/dist/ar/qr/qr-size-measurer.js

@@ -0,0 +1,2 @@
+import { t as createQrSizeMeasurer } from "../../qr-size-measurer-zZB9S1va.js";
+export { createQrSizeMeasurer };

package/dist/ar/replay-scene.d.ts

@@ -1,2 +1,2 @@
-import { a as getCameraFollower, c as getReplayState, d as updateOrbitTarget, i as getAlignmentLerper, l as initReplayScene, n as ReplaySceneState, o as getCameraMode, r as disposeReplayScene, s as getCss3dManager, t as CameraMode, u as toggleCameraMode } from "../replay-scene-CZdWgcpc.js";
+import { a as getCameraFollower, c as getReplayState, d as updateOrbitTarget, i as getAlignmentLerper, l as initReplayScene, n as ReplaySceneState, o as getCameraMode, r as disposeReplayScene, s as getCss3dManager, t as CameraMode, u as toggleCameraMode } from "../replay-scene-D5qzY0_x.js";
 export { CameraMode, ReplaySceneState, disposeReplayScene, getAlignmentLerper, getCameraFollower, getCameraMode, getCss3dManager, getReplayState, initReplayScene, toggleCameraMode, updateOrbitTarget };

package/dist/ar/replay-scene.js

@@ -1,5 +1,5 @@
 import { createLogger } from "../utils/logger.js";
-import { A as setArWorldGroup, L as setScene, j as setCamera, k as setArPose, s as createSceneHierarchy } from "../webxr-session-DWKUsCN9.js";
+import { i as createSceneHierarchy } from "../webxr-session-BBlgzrqY.js";
 import { createCss3dRendererManager } from "../visualization/css3d-renderer-manager.js";
 import { createCameraFollower } from "../visualization/camera-follower.js";
 import { createAlignmentLerper } from "../visualization/alignment-lerper.js";
@@ -16,8 +16,15 @@ import { OrbitControls } from "three/addons/controls/OrbitControls.js";
 * controls operate in a stable world-space frame, unaffected by the
 * alignment matrix on arWorldGroup or odom pose updates on arpose.
 *
-* Registers the scene objects with webxr-session.ts module-global getters
-* (Risk R1 fix) so existing visualizers work without modification.
+* OWNS its scene objects: the replay scene/arWorldGroup/camera/arpose are
+* exposed via initReplayScene()'s return value and getReplayState(), and are
+* NEVER injected into webxr-session.ts (the historical Risk R1
+* setScene/setArWorldGroup/setCamera/setArPose hack was removed by the
+* 2026-07-11 webxr-session surface-reduction plan, step 2). The live-session
+* getters (getScene() etc.) stay null during replay; replay consumers read
+* this module's accessors instead, and scene-reading visualizers (e.g.
+* gpsEventVisualizer.setSceneSource) are pointed at these references by the
+* replay orchestrator.
 *
 * Camera modes:
 *   - orbit (default): OrbitControls — click-drag orbit + scroll zoom
@@ -70,7 +77,8 @@ function updateFpsMovement(dt) {
 * - Creates the scene hierarchy via createSceneHierarchy()
 * - Reparents camera from arWorldGroup to scene root (Risk R5)
 * - Creates a WebGLRenderer WITHOUT WebXR
-* - Registers scene with module-global getters (Risk R1)
+* - Keeps its own scene/arWorldGroup/arpose/camera references (returned
+*   here and via getReplayState()) — nothing is written into webxr-session
 * - Inserts canvas into the provided container
 * - Starts a requestAnimationFrame render loop
 * - Sets up OrbitControls as default camera mode
@@ -96,10 +104,6 @@ function initReplayScene(container) {
 	renderer.xr.enabled = false;
 	container.appendChild(renderer.domElement);
 	const css3dManager = createCss3dRendererManager(container, width, height);
-	setScene(scene);
-	setArWorldGroup(arWorldGroup);
-	setArPose(arpose);
-	setCamera(camera);
 	const orbitControls = new OrbitControls(camera, renderer.domElement);
 	orbitControls.enableDamping = true;
 	orbitControls.target.set(0, 0, 0);
@@ -109,6 +113,7 @@ function initReplayScene(container) {
 	state = {
 		scene,
 		arWorldGroup,
+		arpose,
 		camera,
 		renderer,
 		orbitControls,
@@ -123,6 +128,7 @@ function initReplayScene(container) {
 	return {
 		scene,
 		arWorldGroup,
+		arpose,
 		camera,
 		renderer
 	};
@@ -134,7 +140,7 @@ function initReplayScene(container) {
 * - Disposes renderer (frees GPU resources)
 * - Disposes camera controls
 * - Removes canvas from DOM
-* - Clears module-global scene references
+* - Clears this module's state (getReplayState() returns null afterwards)
 *
 * Safe to call multiple times (idempotent).
 */
@@ -151,10 +157,6 @@ function disposeReplayScene() {
 	restoreTabindex();
 	if (state.renderer.domElement.parentElement) state.renderer.domElement.parentElement.removeChild(state.renderer.domElement);
 	state.renderer.dispose();
-	setScene(null);
-	setArWorldGroup(null);
-	setArPose(null);
-	setCamera(null);
 	state = null;
 	log.info("Replay scene disposed");
 }

package/dist/ar/scene-node-names.d.ts

@@ -1,2 +1,2 @@
-import { t as SCENE_NODE } from "../scene-node-names-DWzhE7Ro.js";
+import { t as SCENE_NODE } from "../scene-node-names-Ct6ATrfM.js";
 export { SCENE_NODE };

package/dist/ar/webxr-nue-basis.d.ts

@@ -1,2 +1,2 @@
-import { t as WEBXR_TO_NUE } from "../webxr-nue-basis-C3vTqkE2.js";
+import { t as WEBXR_TO_NUE } from "../webxr-nue-basis-B8ZEetVb.js";
 export { WEBXR_TO_NUE };

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

@@ -1,4 +1,4 @@
-import { i as DepthSample, t as ARPose } from "../ar-types-CBafnxhE.js";
-import { n as CapturedImage } from "../image-capture-Cr_rljeV.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-CGFZ429B.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 };
+import { i as DepthSample, t as ARPose } from "../ar-types-BprL3nKv.js";
+import { n as CapturedImage } from "../image-capture-BXmx1YvD.js";
+import { A as startCameraFrameCapture, C as isWebXRSupported, D as rebindTrackingStore, E as nueQuaternionToWebXR, F as stopImageCapture, M as startImageCapture, N as stopCameraFrameCapture, O as resetWebXRState, P as stopDepthCapture, S as initAR, T as nuePositionToWebXR, _ as getDepthInfoFromFrame, a as SessionFeatureOptions, b as getScene, c as buildSessionOptions, d as extractPoseFromViewer, f as extractResetTransformData, g as getCurrentArPose, h as getCameraFrameCount, i as SessionEndInfo, j as startDepthCapture, k as shouldLogCameraAccessDiagnostic, l as createSceneHierarchy, m as getCamera, n as CameraFrameCaptureConfig, o as TrackingSubscribableStore, p as getArWorldGroup, r as DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, s as applyAlignmentMatrix, t as ArSessionCallbacks, u as endARSession, v as getDepthSampleCount, w as isXRCameraLike, x as getXrCameraFromPose, y as getImageCaptureFrameCount } from "../webxr-session-DurXRnl_.js";
+export { ARPose, ArSessionCallbacks, CameraFrameCaptureConfig, CapturedImage, DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, DepthSample, SessionEndInfo, SessionFeatureOptions, TrackingSubscribableStore, applyAlignmentMatrix, buildSessionOptions, createSceneHierarchy, endARSession, extractPoseFromViewer, extractResetTransformData, getArWorldGroup, getCamera, getCameraFrameCount, getCurrentArPose, getDepthInfoFromFrame, getDepthSampleCount, getImageCaptureFrameCount, getScene, getXrCameraFromPose, initAR, isWebXRSupported, isXRCameraLike, nuePositionToWebXR, nueQuaternionToWebXR, rebindTrackingStore, resetWebXRState, shouldLogCameraAccessDiagnostic, startCameraFrameCapture, startDepthCapture, startImageCapture, stopCameraFrameCapture, stopDepthCapture, stopImageCapture };

package/dist/ar/webxr-session.js

@@ -1,2 +1,2 @@
-import { A as setArWorldGroup, B as setTrackingLostCallback, C as initAR, D as nueQuaternionToWebXR, E as nuePositionToWebXR, F as setImageCaptureCallback, G as startDepthCapture, H as setTrackingStore, I as setImageQualityAnalyzer, J as stopDepthCapture, K as startImageCapture, L as setScene, M as setCameraFrameCallback, N as setDepthCaptureCallback, O as resetWebXRState, P as setFrameCallback, R as setSessionEndCallback, S as getXrCameraFromPose, T as isXRCameraLike, U as shouldLogCameraAccessDiagnostic, V as setTrackingRecoveredCallback, W as startCameraFrameCapture, Y as stopImageCapture, _ as getDepthInfoFromFrame, a as applyAlignmentMatrix, b as getLiveCss3dManager, c as endARSession, d as getArPose, f as getArWorldGroup, g as getCurrentArPose, h as getCameraFrameCount, i as DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, j as setCamera, k as setArPose, l as extractPoseFromViewer, m as getCameraFrameCaptureSize, n as AR_CAMERA_FOV, o as buildSessionOptions, p as getCamera, q as stopCameraFrameCapture, r as AR_CAMERA_NEAR, s as createSceneHierarchy, t as AR_CAMERA_FAR, u as extractResetTransformData, v as getDepthSampleCount, w as isWebXRSupported, x as getScene, y as getImageCaptureFrameCount, z as setTrackingCallbacks } from "../webxr-session-DWKUsCN9.js";
-export { AR_CAMERA_FAR, AR_CAMERA_FOV, AR_CAMERA_NEAR, DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, 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 };
+import { A as stopImageCapture, C as resetWebXRState, D as startImageCapture, E as startDepthCapture, O as stopCameraFrameCapture, S as rebindTrackingStore, T as startCameraFrameCapture, _ as initAR, a as endARSession, b as nuePositionToWebXR, c as getArWorldGroup, d as getCurrentArPose, f as getDepthInfoFromFrame, g as getXrCameraFromPose, h as getScene, i as createSceneHierarchy, k as stopDepthCapture, l as getCamera, m as getImageCaptureFrameCount, n as applyAlignmentMatrix, o as extractPoseFromViewer, p as getDepthSampleCount, r as buildSessionOptions, s as extractResetTransformData, t as DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, u as getCameraFrameCount, v as isWebXRSupported, w as shouldLogCameraAccessDiagnostic, x as nueQuaternionToWebXR, y as isXRCameraLike } from "../webxr-session-BBlgzrqY.js";
+export { DEFAULT_CAMERA_FRAME_CAPTURE_SIZE, applyAlignmentMatrix, buildSessionOptions, createSceneHierarchy, endARSession, extractPoseFromViewer, extractResetTransformData, getArWorldGroup, getCamera, getCameraFrameCount, getCurrentArPose, getDepthInfoFromFrame, getDepthSampleCount, getImageCaptureFrameCount, getScene, getXrCameraFromPose, initAR, isWebXRSupported, isXRCameraLike, nuePositionToWebXR, nueQuaternionToWebXR, rebindTrackingStore, resetWebXRState, shouldLogCameraAccessDiagnostic, startCameraFrameCapture, startDepthCapture, startImageCapture, stopCameraFrameCapture, stopDepthCapture, stopImageCapture };

package/dist/ar/xr-camera-texture.d.ts

@@ -1,2 +1,2 @@
-import { i as acquireCameraTexture, n as RendererLike, r as XRCameraLike, t as CameraTextureResult } from "../xr-camera-texture-C6Z4d7RR.js";
+import { i as acquireCameraTexture, n as RendererLike, r as XRCameraLike, t as CameraTextureResult } from "../xr-camera-texture-BA4xiaQ4.js";
 export { CameraTextureResult, RendererLike, XRCameraLike, acquireCameraTexture };

package/dist/ar/xr-error-handler.d.ts

@@ -1,2 +1,2 @@
-import { n as XR_ERROR_MESSAGE_UNKNOWN, r as getXrErrorMessage, t as XR_ERROR_MESSAGES } from "../xr-error-handler-D9y5r8ok.js";
+import { n as XR_ERROR_MESSAGE_UNKNOWN, r as getXrErrorMessage, t as XR_ERROR_MESSAGES } from "../xr-error-handler-BeyxXCE_.js";
 export { XR_ERROR_MESSAGES, XR_ERROR_MESSAGE_UNKNOWN, getXrErrorMessage };

package/dist/ar/xr-frame-loop.d.ts

@@ -1,2 +1,2 @@
-import { a as runXrFrameUpdates, i as registerXrFrameUpdate, n as XrFrameUpdate, r as clearXrFrameUpdates, t as XrFrameContext } from "../xr-frame-loop-25gM4B0K.js";
+import { a as runXrFrameUpdates, i as registerXrFrameUpdate, n as XrFrameUpdate, r as clearXrFrameUpdates, t as XrFrameContext } from "../xr-frame-loop-A1mGDFHI.js";
 export { XrFrameContext, XrFrameUpdate, clearXrFrameUpdates, registerXrFrameUpdate, runXrFrameUpdates };

package/dist/ar/xr-frame-loop.js

@@ -18,7 +18,7 @@ import { createLogger } from "../utils/logger.js";
 * makes correct use the easy path and stashing the awkward one. Do NOT retain
 * `ctx` or its fields beyond the callback's synchronous execution.
 *
-* See `2026-06-03-threejs-arbutton-minimal-ar-example-user-feedback.md`
+* See `2026-06-03-0553-threejs-arbutton-minimal-ar-example-user-feedback.md`
 * §6.2/§6.3 (option H-A2) for the design rationale.
 */
 const log = createLogger("XrFrameLoop");

package/dist/ar-crash-isolation-BSFw_beO.d.ts

@@ -0,0 +1,52 @@
+//#region ../src/ar/ar-crash-isolation.d.ts
+/**
+ * AR crash isolation flags — diagnostic gates for XR session negotiation.
+ *
+ * Moved out of the recorder settings catalog (2026-07-11 G-1 move,
+ * `2026-07-11-1445-recording-options-altitude-move-plan.md`): the framework itself
+ * consumes these flags in `webxr-session.ts` (session feature requests, frame
+ * loop) and on `enable-gps-ar.ts`'s public param, so the type + defaults +
+ * validator live framework-side. The recorder embeds the group in its own
+ * `RecordingOptions` catalog and re-exports the type.
+ */
+/**
+ * Diagnostic flags for isolating pre-recording AR startup crashes.
+ * These gates affect XR session negotiation and frame-loop behavior,
+ * independently of recording-time image/depth capture.
+ */
+interface ArCrashIsolationOptions {
+  enableDomOverlay: boolean;
+  enableCameraAccess: boolean;
+  enableDepthSensingFeature: boolean;
+  enableCss3dRenderer: boolean;
+  enableCameraTextureAcquisition: boolean;
+  /**
+   * Apply the Chromium WebXR camera-access tab-crash workaround at app
+   * bootstrap. The workaround always deletes
+   * `XRWebGLBinding.prototype.createProjectionLayer` /
+   * `XRRenderState.prototype.layers` (forcing `XRWebGLLayer`) — required on
+   * every affected Chrome build observed on-device, including Chrome 150 — and
+   * additionally persists the `baseLayer` across
+   * `XRSession.prototype.updateRenderState` only for Chrome builds inside the
+   * affected window (148.0.7778.12 up to 149.0.7821).
+   *
+   * Default `true`. Opt-out is offered because forcing `XRWebGLLayer` may break
+   * WebXR on unaffected (e.g. Quest) devices.
+   *
+   * @see GpsPlusSlamJs_AppFramework/src/ar/chromium-camera-access-workaround.ts
+   * @see https://github.com/mrdoob/three.js/issues/33404
+   */
+  applyChromiumProjectionLayerWorkaround: boolean;
+}
+/** Default AR-crash-isolation flags (all features enabled). */
+declare const DEFAULT_AR_CRASH_ISOLATION: ArCrashIsolationOptions;
+/**
+ * Validate and normalize AR crash isolation flags.
+ * Missing or invalid values fall back to defaults. The container itself is as
+ * untrusted as its fields (persisted blobs may lack the key entirely or hold
+ * `null`), so a nullish container yields the full defaults instead of
+ * throwing.
+ */
+declare function validateArCrashIsolationOptions(rawOptions?: Partial<ArCrashIsolationOptions> | null): ArCrashIsolationOptions;
+//#endregion
+export { DEFAULT_AR_CRASH_ISOLATION as n, validateArCrashIsolationOptions as r, ArCrashIsolationOptions as t };

package/dist/{ar-world-group-alignment-B6XiA1cT.d.ts → ar-world-group-alignment-CvvfACfx.d.ts}

@@ -1,4 +1,4 @@
-import { t as SubscribableStore } from "./subscribe-to-selector-Cgo9JTfS.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-B_lm_euO.js";
 import * as THREE from "three";
 
 //#region ../src/visualization/ar-world-group-alignment.d.ts
@@ -32,7 +32,7 @@ interface ArWorldGroupAlignmentHandle {
  * handle is still returned for callers that want to stop alignment mid-session,
  * and is idempotent + self-deregistering so a manual `dispose()` and the
  * teardown flush never double-run. See
- * gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-06-08-arworldgroup-alignment-session-scoped-disposal.md.
+ * gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-06-08-2149-arworldgroup-alignment-session-scoped-disposal.md.
  *
  * Double-drive is still the caller's concern: the recorder owns its own lerper
  * and must NOT also call this (it would double-lerp the same group). It does not

package/dist/{capability-checker-DEo-ktWI.d.ts → capability-checker-DrWimJ_t.d.ts}

@@ -8,7 +8,7 @@
  * stays in each app's `main.ts`; only the browser-free decision and the
  * user-facing message live here so they can be unit-tested without a browser.
  *
- * See `2026-06-03-threejs-arbutton-minimal-ar-example-user-feedback.md` §6.4.
+ * See `2026-06-03-0553-threejs-arbutton-minimal-ar-example-user-feedback.md` §6.4.
  */
 /** The two capabilities every GPS+AR demo requires to run. */
 interface CapabilitySupport {

package/dist/capture-motion-gate-C60Qrilh.d.ts

@@ -0,0 +1,120 @@
+//#region ../src/ar/capture-motion-gate.d.ts
+/**
+ * Capture motion gate — the policy that decides whether a *due* capture should
+ * fire on the current frame or be deferred until the device settles.
+ *
+ * Two cohesive pieces, both pure/deterministic and unit-testable in isolation
+ * from `ImageCaptureManager`:
+ *  - {@link decideCapture} — the stateless capture-vs-defer decision over the
+ *    windowed motion maxima, the thresholds, and the time since the capture
+ *    became due (the never-calm safety fallback).
+ *  - {@link MotionWindow} — a tiny fixed-size ring of recent per-frame
+ *    velocities with glitch rejection, so the decision judges "max over the
+ *    last N frames" rather than one lucky-calm sample.
+ *
+ * The window size and glitch ceilings are INTERNAL constants, deliberately not
+ * user-facing config: the user-facing surface is only enabled / maxAngular /
+ * maxLinear / maxWaitMs (plan §5.1). Keeping the stateful policy here (not in a
+ * speculative framework-wide service) matches the plan's §4.1 scope note.
+ *
+ * @see GpsPlusSlamJs_Docs/docs/2026-06-23-2105-blurry-frame-motion-gating-plan.md §4.2-4.4
+ */
+/** Default number of recent frames the gate judges motion over (~50 ms @ 60fps). */
+declare const DEFAULT_MOTION_WINDOW_SIZE = 3;
+/**
+ * User-/consumer-facing motion-filter configuration. Shared by both config
+ * shapes that carry it — `ImageCaptureConfig` (what `ImageCaptureManager`
+ * consumes) and `ImageCaptureOptions` (the persisted recorder options) — so the
+ * one definition cannot drift between them. The window size and glitch ceilings
+ * are deliberately NOT here: they are internal tuning constants, not exposed.
+ */
+interface MotionFilterConfig {
+  /** Master switch for the motion gate. Default `true`. */
+  enabled: boolean;
+  /** Angular-velocity threshold (rad/s); at/below this a frame is "calm". */
+  maxAngularVelocity: number;
+  /** Linear-velocity threshold (m/s); at/below this a frame is "calm". */
+  maxLinearVelocity: number;
+  /**
+   * Never-calm safety fallback: once a due capture has waited this many ms it
+   * fires regardless of motion, so an interval is never silently lost. A
+   * sensible value is ~2× the capture interval.
+   */
+  maxWaitMs: number;
+}
+/**
+ * Default motion-filter configuration. Enabled by default (plan §1).
+ *
+ * `maxLinearVelocity` was raised `0.5 → 2.5` m/s on 2026-07-02 after a
+ * 5-recording field analysis: at 0.5 m/s (~⅓ of a ~1.4 m/s walking pace) the
+ * gate deferred ~90 % of captures to the never-calm `maxWaitMs` fallback,
+ * collapsing the walking capture rate from the configured 0.5 Hz to ~0.17 Hz.
+ * Measured 1 Hz-averaged walking speed was a tight band (median 1.38, max
+ * 1.73 m/s); allowing for higher instantaneous per-frame stride peaks, 2.5 m/s
+ * clears steady and brisk walking while still deferring genuine lunges/jogging
+ * — demoting the (weak-at-scanning-distance) linear signal to a gross-motion
+ * safety net and letting the well-behaved angular gate be the primary blur
+ * selector. See
+ * `GpsPlusSlamJs_Docs/docs/2026-07-02-0117-image-capture-rate-motion-gate-finding.md`.
+ *
+ * `maxAngularVelocity` remains a PLACEHOLDER pending on-device field tuning
+ * (plan §7). `maxWaitMs` of 4000 ms is 2× the default 2000 ms image interval.
+ */
+declare const DEFAULT_MOTION_FILTER: MotionFilterConfig;
+/** Inputs to the stateless capture decision. */
+interface CaptureDecisionInput {
+  /** Max angular velocity (rad/s) over the recent window. `Infinity` if empty. */
+  windowMaxAngular: number;
+  /** Max linear velocity (m/s) over the recent window. `Infinity` if empty. */
+  windowMaxLinear: number;
+  /** Angular-velocity threshold (rad/s); at/below this is "calm". */
+  maxAngularVelocity: number;
+  /** Linear-velocity threshold (m/s); at/below this is "calm". */
+  maxLinearVelocity: number;
+  /** Milliseconds since the capture first became due (interval elapsed). */
+  msSinceDue: number;
+  /** Safety fallback: capture regardless once this many ms have passed. */
+  maxWaitMs: number;
+}
+/**
+ * Decide whether a due capture should fire now or defer to a later frame.
+ *
+ * A frame is "calm" when BOTH windowed maxima are at/below their thresholds —
+ * an empty window reports `Infinity`, so it is never calm (no capture before a
+ * valid sample exists). If not calm, the capture is deferred UNTIL `msSinceDue`
+ * reaches `maxWaitMs`, at which point it fires regardless to guarantee an
+ * interval is never silently lost (worst case: one blurry frame, not a gap).
+ */
+declare function decideCapture(input: CaptureDecisionInput): 'capture' | 'defer';
+/**
+ * Fixed-size ring of the most recent VALID (non-glitch) per-frame velocities.
+ *
+ * `maxAngular()`/`maxLinear()` return the max over the retained samples, or
+ * `Infinity` when empty so "no data yet" reads as not-calm in
+ * {@link decideCapture}. A sample exceeding either glitch ceiling is rejected
+ * outright (`push` returns `false`) and never stored, so a relocalization spike
+ * neither pollutes the window (no spurious defer) nor is treated as motion.
+ */
+declare class MotionWindow {
+  private readonly angularGlitchCeiling;
+  private readonly linearGlitchCeiling;
+  private readonly size;
+  private readonly angular;
+  private readonly linear;
+  constructor(size?: number, angularGlitchCeiling?: number, linearGlitchCeiling?: number);
+  /**
+   * Record a per-frame velocity pair. Returns `false` (and stores nothing) when
+   * the sample exceeds either glitch ceiling, `true` otherwise.
+   */
+  push(angularVel: number, linearVel: number): boolean;
+  /** Whether the window holds at least one valid (non-glitch) sample yet. */
+  hasSamples(): boolean;
+  /** Max angular velocity over the retained window, or `Infinity` if empty. */
+  maxAngular(): number;
+  /** Max linear velocity over the retained window, or `Infinity` if empty. */
+  maxLinear(): number;
+  /** Clear all samples (e.g. on tracking loss / capture restart). */
+  reset(): void;
+}
+//#endregion
+export { MotionWindow as a, MotionFilterConfig as i, DEFAULT_MOTION_FILTER as n, decideCapture as o, DEFAULT_MOTION_WINDOW_SIZE as r, CaptureDecisionInput as t };

package/dist/{cell-key-Bj-eYTLA.js → cell-key-D1b_Ix-p.js}

@@ -40,6 +40,17 @@ function unpackCellKey(key) {
 	];
 }
 /**
+* Per-axis key strides: stepping one cell along an axis moves the packed key
+* by a constant (positional base-2^17 packing) — `packCellKey(x+1, y, z) ===
+* packCellKey(x, y, z) + CELL_KEY_STRIDE_X`, and the z stride is 1. Hot walks
+* (the occupancy grid's fused carve, the smooth mesher's dual-cell corners)
+* maintain keys incrementally with these instead of repacking per cell.
+* DERIVED from the packer itself so they can never drift from the encoding.
+*/
+const CELL_KEY_STRIDE_X = packCellKey(1, 0, 0) - packCellKey(0, 0, 0);
+/** See {@link CELL_KEY_STRIDE_X}. */
+const CELL_KEY_STRIDE_Y = packCellKey(0, 1, 0) - packCellKey(0, 0, 0);
+/**
 * True iff every coordinate is within ±`limit` — the aliasing guard callers
 * must apply before keying untrusted coordinates. Defaults to the full-field
 * {@link CELL_KEY_LIMIT}; the meshers pass {@link HALF_LATTICE_CELL_KEY_LIMIT}.
@@ -48,4 +59,4 @@ function cellCoordsInKeyRange(cell, limit = CELL_KEY_LIMIT) {
 	return Math.abs(cell[0]) <= limit && Math.abs(cell[1]) <= limit && Math.abs(cell[2]) <= limit;
 }
 //#endregion
-export { packCellKey as a, cellKey as i, HALF_LATTICE_CELL_KEY_LIMIT as n, unpackCellCoord as o, cellCoordsInKeyRange as r, unpackCellKey as s, CELL_KEY_LIMIT as t };
+export { cellCoordsInKeyRange as a, unpackCellCoord as c, HALF_LATTICE_CELL_KEY_LIMIT as i, unpackCellKey as l, CELL_KEY_STRIDE_X as n, cellKey as o, CELL_KEY_STRIDE_Y as r, packCellKey as s, CELL_KEY_LIMIT as t };

package/dist/{chromium-camera-access-workaround-DCd8SP2N.d.ts → chromium-camera-access-workaround-BRs6gkI4.d.ts}

@@ -10,7 +10,7 @@
  * added — i.e. it is not specific to this app's session setup. See:
  *
  *   - GpsPlusSlamJs_Docs/docs/2026-04-22-camera-access-reproducer-plan.md
- *   - GpsPlusSlamJs_Docs/docs/2026-06-04-camera-access-crash-regression-chrome-148.md
+ *   - GpsPlusSlamJs_Docs/docs/2026-06-04-0458-camera-access-crash-regression-chrome-148.md
  *   - https://github.com/mrdoob/three.js/issues/33404
  *   - https://issues.chromium.org/issues/507508099 (root-cause, marked Fixed)
  *

package/dist/core/index.d.ts

@@ -1,2 +1,2 @@
-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-CjxbDm8W.js";
+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-T8Fxvzka.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/{create-slam-app-store-CH31erpP.d.ts → create-slam-app-store-HNe1PBtx.d.ts}

@@ -1,10 +1,11 @@
-import { a as TrackingSliceState } from "./tracking-slice-Bt2OEQhA.js";
-import { t as RecordingState } from "./recording-slice-DziOl7P5.js";
-import { n as SessionMetadata } from "./opfs-storage-S_odkCk1.js";
-import { n as StorageBackend } from "./storage-backend-BX7egQKi.js";
+import { a as TrackingSliceState } from "./tracking-slice-D5LDL_y4.js";
+import { t as RecordingState } from "./recording-slice-zMedT0ot.js";
+import { n as SessionMetadata } from "./opfs-storage-CrhVauNL.js";
+import { n as StorageBackend } from "./storage-backend-DCYbOvTw.js";
 import { GpsPoint, LatLong, Matrix4, RootState, Vector3 } from "gps-plus-slam-js";
 import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
 import { Middleware, Reducer, ReducersMapObject, configureStore } from "@reduxjs/toolkit";
+import * as _$redux from "redux";
 
 //#region ../src/state/combined-root-state.d.ts
 type CombinedRootState = SlamAppCombinedState;
@@ -205,7 +206,7 @@ declare function computeGpsVsFusedDivergence(alignmentMatrix: Matrix4 | null, gp
 declare const snapshotPushed: _$_reduxjs_toolkit0.ActionCreatorWithPayload<AlignmentSnapshot, "trackingQuality/snapshotPushed">, snapshotsTrimmed: _$_reduxjs_toolkit0.ActionCreatorWithPayload<{
     size: number;
   }, "trackingQuality/snapshotsTrimmed">, reportUpdated: _$_reduxjs_toolkit0.ActionCreatorWithPayload<TrackingQualityReport | null, "trackingQuality/reportUpdated">, degradedCountUpdated: _$_reduxjs_toolkit0.ActionCreatorWithPayload<number, "trackingQuality/degradedCountUpdated">, resetTrackingQuality: _$_reduxjs_toolkit0.ActionCreatorWithoutPayload<"trackingQuality/resetTrackingQuality">;
-declare const trackingQualityReducer: _$_reduxjs_toolkit0.Reducer<TrackingQualitySliceState>;
+declare const trackingQualityReducer: _$redux.Reducer<TrackingQualitySliceState>;
 interface RootWithTrackingQuality {
   trackingQuality?: TrackingQualitySliceState;
 }
@@ -329,7 +330,7 @@ interface SlamAppStoreOptions<ExtraReducers extends ReducersMapObject = Record<s
    * override on. **For Stage-A/§6a field-calibration recordings, turn this OFF**
    * (recorder settings) so the captured compass behaviour is unmodified.
    *
-   * @see GpsPlusSlamJs_Docs/docs/2026-06-26-stage0-field-collection-and-enablement.md
+   * @see GpsPlusSlamJs_Docs/docs/2026-06-26-0701-stage0-field-collection-and-enablement.md
    */
   enableCompassColdStartOverride?: boolean;
   /**
@@ -348,6 +349,28 @@ interface SlamAppStoreOptions<ExtraReducers extends ReducersMapObject = Record<s
    * `false` ⇒ byte-identical. The action persists into recordings.
    */
   enableCompassWebXRConsistency?: boolean;
+  /**
+   * **Field-test flag (2026-07-19 enablement plan)** — enable the library's
+   * compass EXPERIMENT combo: Stage-C rotation prior + trust tolerance 15°
+   * (the census-backed activating value) + C′ compass-guided pair selection.
+   * Dispatches `setCompassExperimentEnabled(true)` once `gpsData` exists; the
+   * combo itself lives in the library (single boolean crosses the boundary).
+   * Default `false` ⇒ byte-identical. The action persists into recordings, so
+   * replays/censuses can attribute. Keep OFF for §6a calibration recordings.
+   *
+   * @see GpsPlusSlamJs_Docs/docs/2026-07-19-0813-compass-experiment-recorder-enablement-plan.md
+   */
+  enableCompassExperiment?: boolean;
+  /**
+   * **Field-test flag** — enable the library's alternative robust-solver
+   * comparison arm (NOT a compass mechanism — a generic outlier-tolerant
+   * position fit, rejected as a default on the evaluation corpus but exposed
+   * for on-device A/B against the compass experiment; adds run-to-run
+   * variance by nature). Dispatches `setRobustSolverComparisonEnabled(true)`
+   * once `gpsData` exists. Default `false` ⇒ byte-identical. The action
+   * persists into recordings.
+   */
+  enableRobustSolverComparison?: boolean;
 }
 /**
  * Combined root state: the framework's base state plus any caller-supplied
@@ -369,6 +392,14 @@ interface SlamAppStore<ExtraReducers extends ReducersMapObject = Record<string,
   writeFrame: (blob: Blob, index: number) => Promise<void>;
   /** Persist session metadata (`session.json`) via the configured backend. */
   writeSessionMetadata: (metadata: SessionMetadata) => Promise<void>;
+  /**
+   * Resolves once every action write queued by the persistence middleware
+   * has settled. The stop flow MUST await this before anything reads the
+   * session's `actions/` (final sync, ZIP export) — the write queue is
+   * async, so an action dispatched moments before Stop could otherwise
+   * land after the export enumerated the directory and miss the zip.
+   */
+  flushPendingActionWrites: () => Promise<void>;
 }
 /**
  * Build a Redux store wired with library + recording slices, persistence