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

package/dist/sensors/index.d.ts

@@ -1,5 +1,5 @@
-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 startOrientationWatch, i as startGpsWatch, n as RawDeviceOrientation, o as stopGpsWatch, r as requestOrientationPermission, s as stopOrientationWatch, t as GpsPosition } from "../gps-CnhYrJCa.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 startAbsoluteOrientationWatch, i as isAbsoluteOrientationAvailable, n as AbsoluteOrientationStatus, o as stopAbsoluteOrientationWatch, r as getLatestAbsoluteOrientation, t as AbsoluteOrientationReading } from "../absolute-orientation-BAxc15J6.js";
-import { a as getGpsErrorMessage, i as createGpsErrorHandler, n as GPS_ERROR_MESSAGES, r as GPS_ERROR_MESSAGE_UNKNOWN, t as GPS_ERROR_CODES } from "../gps-error-handler-C34GQuTu.js";
+import { a as startAbsoluteOrientationWatch, i as isAbsoluteOrientationAvailable, n as AbsoluteOrientationStatus, o as stopAbsoluteOrientationWatch, r as getLatestAbsoluteOrientation, t as AbsoluteOrientationReading } from "../absolute-orientation-Dj1One3y.js";
+import { a as getGpsErrorMessage, i as createGpsErrorHandler, n as GPS_ERROR_MESSAGES, r as GPS_ERROR_MESSAGE_UNKNOWN, t as GPS_ERROR_CODES } from "../gps-error-handler-DjVuLXve.js";
 export { type AbsoluteOrientationReading, type AbsoluteOrientationStatus, GPS_ERROR_CODES, GPS_ERROR_MESSAGES, GPS_ERROR_MESSAGE_UNKNOWN, type GpsPosition, type PermissionCheckResult, type PermissionStatus, type RawDeviceOrientation, checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, createGpsErrorHandler, getGpsErrorMessage, getLatestAbsoluteOrientation, isAbsoluteOrientationAvailable, requestAllPermissions, requestCameraPermission, requestOrientationPermission as requestDeviceOrientationPermission, requestGeolocationPermission, requestOrientationPermission$1 as requestOrientationPermission, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState, startAbsoluteOrientationWatch, startGpsWatch, startOrientationWatch, stopAbsoluteOrientationWatch, stopGpsWatch, stopOrientationWatch };

package/dist/sensors/index.js

@@ -1,5 +1,5 @@
-import { getLatestAbsoluteOrientation, isAbsoluteOrientationAvailable, startAbsoluteOrientationWatch, stopAbsoluteOrientationWatch } from "./absolute-orientation.js";
 import { checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, requestAllPermissions, requestCameraPermission, requestGeolocationPermission, requestOrientationPermission as requestOrientationPermission$1, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState } from "./permission-checker.js";
 import { requestOrientationPermission, startGpsWatch, startOrientationWatch, stopGpsWatch, stopOrientationWatch } from "./gps.js";
+import { getLatestAbsoluteOrientation, isAbsoluteOrientationAvailable, startAbsoluteOrientationWatch, stopAbsoluteOrientationWatch } from "./absolute-orientation.js";
 import { GPS_ERROR_CODES, GPS_ERROR_MESSAGES, GPS_ERROR_MESSAGE_UNKNOWN, createGpsErrorHandler, getGpsErrorMessage } from "./gps-error-handler.js";
 export { GPS_ERROR_CODES, GPS_ERROR_MESSAGES, GPS_ERROR_MESSAGE_UNKNOWN, checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, createGpsErrorHandler, getGpsErrorMessage, getLatestAbsoluteOrientation, isAbsoluteOrientationAvailable, requestAllPermissions, requestCameraPermission, requestOrientationPermission as requestDeviceOrientationPermission, requestGeolocationPermission, requestOrientationPermission$1 as requestOrientationPermission, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState, startAbsoluteOrientationWatch, startGpsWatch, startOrientationWatch, stopAbsoluteOrientationWatch, stopGpsWatch, stopOrientationWatch };

package/dist/sensors/permission-checker.js

@@ -100,17 +100,19 @@ async function checkWebXRSupport() {
 	}
 }
 /**
-* Check geolocation permission status without triggering a prompt.
-* Uses the Permissions API if available, otherwise returns unknown state.
+* Shared Permissions-API status checker (quality-review C-2): probe-free
+* query with the standard supported/granted/denied/prompt mapping. The two
+* former copies (geolocation/camera) differed only in the API guard and the
+* user-facing strings.
 */
-async function checkGeolocationPermission() {
-	if (!navigator.geolocation) return {
+async function checkPermissionViaQuery(options) {
+	if (!options.apiAvailable) return {
 		supported: false,
 		granted: null,
-		error: "Geolocation API not available in this browser."
+		error: options.unsupportedError
 	};
 	if (navigator.permissions) try {
-		const result = await navigator.permissions.query({ name: "geolocation" });
+		const result = await navigator.permissions.query({ name: options.name });
 		if (result.state === "granted") return {
 			supported: true,
 			granted: true
@@ -118,7 +120,7 @@ async function checkGeolocationPermission() {
 		else if (result.state === "denied") return {
 			supported: true,
 			granted: false,
-			error: "Location access denied. Please enable in browser settings."
+			error: options.deniedError
 		};
 		return {
 			supported: true,
@@ -131,6 +133,18 @@ async function checkGeolocationPermission() {
 	};
 }
 /**
+* Check geolocation permission status without triggering a prompt.
+* Uses the Permissions API if available, otherwise returns unknown state.
+*/
+async function checkGeolocationPermission() {
+	return checkPermissionViaQuery({
+		name: "geolocation",
+		apiAvailable: !!navigator.geolocation,
+		unsupportedError: "Geolocation API not available in this browser.",
+		deniedError: "Location access denied. Please enable in browser settings."
+	});
+}
+/**
 * Request geolocation permission by triggering a position request.
 * This will show the browser's permission prompt if not already granted.
 *
@@ -179,31 +193,12 @@ async function requestGeolocationPermission(timeoutMs = 1e4) {
 * Uses the Permissions API if available.
 */
 async function checkCameraPermission() {
-	if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) return {
-		supported: false,
-		granted: null,
-		error: "Camera API not available. Use HTTPS and a modern browser."
-	};
-	if (navigator.permissions) try {
-		const result = await navigator.permissions.query({ name: "camera" });
-		if (result.state === "granted") return {
-			supported: true,
-			granted: true
-		};
-		else if (result.state === "denied") return {
-			supported: true,
-			granted: false,
-			error: "Camera access denied. Please enable in browser settings."
-		};
-		return {
-			supported: true,
-			granted: null
-		};
-	} catch {}
-	return {
-		supported: true,
-		granted: null
-	};
+	return checkPermissionViaQuery({
+		name: "camera",
+		apiAvailable: !!navigator.mediaDevices?.getUserMedia,
+		unsupportedError: "Camera API not available. Use HTTPS and a modern browser.",
+		deniedError: "Camera access denied. Please enable in browser settings."
+	});
 }
 /**
 * Request camera permission by triggering getUserMedia.
@@ -246,16 +241,33 @@ async function requestCameraPermission() {
 	}
 }
 /**
+* DeviceOrientationEvent availability + iOS 13+ permission-API probe
+* (quality-review C-2 — this preamble used to be duplicated between the
+* check and request paths). `available: false` ⇒ no orientation support at
+* all; `requestPermission: null` ⇒ orientation works without a permission.
+* The returned function is bound to `DeviceOrientationEvent` (it is a static
+* method — an unbound call would lose `this`).
+*/
+function getIosOrientationPermissionApi() {
+	if (typeof DeviceOrientationEvent === "undefined") return { available: false };
+	const withPermission = DeviceOrientationEvent;
+	return {
+		available: true,
+		requestPermission: typeof withPermission.requestPermission === "function" ? withPermission.requestPermission.bind(DeviceOrientationEvent) : null
+	};
+}
+/**
 * Check device orientation permission status.
 * On iOS 13+, this requires explicit permission request.
 */
 function checkOrientationPermission() {
-	if (typeof DeviceOrientationEvent === "undefined") return Promise.resolve({
+	const api = getIosOrientationPermissionApi();
+	if (!api.available) return Promise.resolve({
 		supported: false,
 		granted: null,
 		error: "Device orientation not supported."
 	});
-	if (typeof DeviceOrientationEvent.requestPermission === "function") return Promise.resolve({
+	if (api.requestPermission) return Promise.resolve({
 		supported: true,
 		granted: null
 	});
@@ -269,14 +281,14 @@ function checkOrientationPermission() {
 * On other platforms, this is a no-op that returns granted.
 */
 async function requestOrientationPermission() {
-	if (typeof DeviceOrientationEvent === "undefined") return {
+	const api = getIosOrientationPermissionApi();
+	if (!api.available) return {
 		supported: false,
 		granted: null,
 		error: "Device orientation not supported."
 	};
-	const DeviceOrientationEventWithPermission = DeviceOrientationEvent;
-	if (typeof DeviceOrientationEventWithPermission.requestPermission === "function") try {
-		if (await DeviceOrientationEventWithPermission.requestPermission() === "granted") {
+	if (api.requestPermission) try {
+		if (await api.requestPermission() === "granted") {
 			log.info("Orientation permission granted");
 			return {
 				supported: true,
@@ -317,10 +329,29 @@ async function checkAllPermissions() {
 		camera,
 		orientation,
 		fileSystem,
-		allMandatoryReady: webxr.supported && webxr.granted === true && geolocation.supported && geolocation.granted === true && camera.supported && camera.granted === true && fileSystem.supported && fileSystem.granted === true
+		allMandatoryReady: computeAllMandatoryReady({
+			webxr,
+			geolocation,
+			camera,
+			fileSystem
+		})
 	};
 }
 /**
+* The mandatory-set gate, written once (quality-review C-2 — the 8-clause
+* boolean used to be spelled out twice and could drift): WebXR, Geolocation,
+* Camera and FileSystem must all be supported AND granted. Orientation is
+* deliberately not part of the mandatory set.
+*/
+function computeAllMandatoryReady(result) {
+	return [
+		result.webxr,
+		result.geolocation,
+		result.camera,
+		result.fileSystem
+	].every((p) => p.supported && p.granted === true);
+}
+/**
 * Subscribe to out-of-band permission changes.
 *
 * Today the recorder app only re-runs `checkAllPermissions()` at startup
@@ -414,7 +445,7 @@ async function requestAllPermissions() {
 	if (result.orientation.supported && result.orientation.granted !== true) result.orientation = await requestOrientationPermission();
 	if (result.geolocation.supported && result.geolocation.granted !== true) result.geolocation = await requestGeolocationPermission();
 	result.fileSystem = checkFileSystemPermission();
-	result.allMandatoryReady = result.webxr.supported && result.webxr.granted === true && result.geolocation.supported && result.geolocation.granted === true && result.camera.supported && result.camera.granted === true && result.fileSystem.supported && result.fileSystem.granted === true;
+	result.allMandatoryReady = computeAllMandatoryReady(result);
 	return result;
 }
 /**

package/dist/{session-disposers-BPrMplIC.js → session-disposers-B7hUN90w.js}

@@ -19,7 +19,7 @@ import { createLogger } from "./utils/logger.js";
 * `arWorldGroup`). Because `initAR()` throws if a prior session is still live,
 * every restart must pass through `resetWebXRState()`, making it the single
 * chokepoint where flushing these disposers is guaranteed. 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.
 */
 const log = createLogger("SessionDisposers");
 const disposers = /* @__PURE__ */ new Set();

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-BbAiCRUT.js";
+import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-DG0ZqaeI.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-D1QSMuKu.js";
+import { N as CombinedRootState } from "../create-slam-app-store-DFm5K9Ob.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-D1QSMuKu.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-DFm5K9Ob.js";
 export { SlamAppCombinedState, SlamAppMiddleware, SlamAppRootState, SlamAppStore, SlamAppStoreOptions, createSlamAppStore };

package/dist/state/create-slam-app-store.js

@@ -1,2 +1,2 @@
-import { t as createSlamAppStore } from "../create-slam-app-store-DXiAnJwR.js";
+import { t as createSlamAppStore } from "../create-slam-app-store-oK9bnqyI.js";
 export { createSlamAppStore };

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

@@ -1,4 +1,3 @@
-import { t as ARPose } from "../ar-types-Cc5yvBwn.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";
+import { c as extractOdomPosition, l as extractOdomRotation, t as ARPose } from "../ar-types-D6PYS4bc.js";
+import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-BuuUuK-D.js";
 export { ARPose, CaptureGpsAnchorSampleOptions, GpsAnchorSample, GpsAnchorSampleGpsPoint, captureGpsAnchorSample, extractOdomPosition, extractOdomRotation };

package/dist/state/gps-ar-pose-sampler.js

@@ -1,4 +1,4 @@
-import { extractOdomPosition, extractOdomRotation } from "./gps-event-coordinator.js";
+import { extractOdomPosition, extractOdomRotation } from "../types/ar-types.js";
 //#region ../src/state/gps-ar-pose-sampler.ts
 /**
 * Capture a GPS-AR pose snapshot. Extracts `odomPosition`/`odomRotation`

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

@@ -1,2 +1,3 @@
-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";
+import { c as extractOdomPosition, l as extractOdomRotation } from "../ar-types-D6PYS4bc.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as updateDeviceOrientation, n as buildRawGpsPoint, o as resetCoordinatorState, r as buildRecordGpsEventPayload, s as toRawAbsoluteOrientation, t as RecordingCoordinatorConfig } from "../gps-event-coordinator-Cruoe5I-.js";
 export { RecordingCoordinatorConfig, buildRawGpsPoint, buildRecordGpsEventPayload, createGpsPositionHandler, eulerToQuaternion, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, resetCoordinatorState, toRawAbsoluteOrientation, updateDeviceOrientation };

package/dist/state/gps-event-coordinator.js

@@ -1,4 +1,6 @@
 import { createLogger } from "../utils/logger.js";
+import { extractOdomPosition, extractOdomRotation } from "../types/ar-types.js";
+import { n as resetDeviceOrientationCache, r as updateDeviceOrientation, t as getLastDeviceOrientation } from "../device-orientation-cache-j-kLP8he.js";
 import { getLatestAbsoluteOrientation } from "../sensors/absolute-orientation.js";
 import { eulerToQuaternion, getOdometryPositions, getZeroReference, recordGpsEvent, setZeroPos } from "gps-plus-slam-js";
 //#region ../src/state/gps-event-coordinator.ts
@@ -6,57 +8,13 @@ const log = createLogger("RecordingCoordinator");
 /** Counter for generating unique GPS point IDs */
 let gpsEventCounter = 0;
 /**
-* State for device orientation (captured separately from GPS)
-*/
-let lastDeviceOrientation = null;
-/**
-* Update the cached device orientation.
-* Called by orientation watch, used when GPS event arrives.
-*/
-function updateDeviceOrientation(orientation) {
-	lastDeviceOrientation = orientation;
-}
-/**
-* Get the current cached device orientation.
-*/
-function getLastDeviceOrientation() {
-	return lastDeviceOrientation;
-}
-/**
 * Clear cached state (for testing or session reset)
 */
 function resetCoordinatorState() {
-	lastDeviceOrientation = null;
+	resetDeviceOrientationCache();
 	gpsEventCounter = 0;
 }
 /**
-* Extract raw odometry position tuple from ARPose.
-*
-* Returns the raw WebXR position without coordinate conversion.
-* The reducer applies the WebXR→NUE transform when storing into state
-* (raw-storage pattern, see docs/2026-04-09-raw-storage-convert-on-read.md).
-*
-* WebXR local-floor frame: X=East, Y=Up, Z=South (toward viewer / backward).
-*/
-function extractOdomPosition(arPose) {
-	return [
-		arPose.position.x,
-		arPose.position.y,
-		arPose.position.z
-	];
-}
-/**
-* Extract odometry rotation tuple from ARPose.
-*/
-function extractOdomRotation(arPose) {
-	return [
-		arPose.orientation.x,
-		arPose.orientation.y,
-		arPose.orientation.z,
-		arPose.orientation.w
-	];
-}
-/**
 * Build a RawGpsPoint from GPS position data.
 * Returns only raw sensor fields — no derived fields (coordinates, weight,
 * zeroRef). Derived fields are computed by the library reducer when the
@@ -149,7 +107,7 @@ function createGpsPositionHandler(config) {
 			log.error("Failed to get zero reference");
 			return;
 		}
-		const payload = buildRecordGpsEventPayload(position, arPose, lastDeviceOrientation, getLatestAbsoluteOrientation());
+		const payload = buildRecordGpsEventPayload(position, arPose, getLastDeviceOrientation(), getLatestAbsoluteOrientation());
 		store.dispatch(recordGpsEvent(payload));
 		const eventCount = getOdometryPositions(store.getState()).length;
 		log.info(`Recorded GPS event #${eventCount}`);

package/dist/state/index.d.ts

@@ -1,20 +1,19 @@
-import { i as DepthSample, r as DepthPoint } from "../ar-types-Cc5yvBwn.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-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-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-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-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 };
+import { c as extractOdomPosition, i as DepthSample, l as extractOdomRotation, r as DepthPoint } from "../ar-types-D6PYS4bc.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-BAbcZK-Y.js";
+import { d as QrSizeStatus, l as QrSizeEstimate } from "../qr-size-measurer-rVFf4AdM.js";
+import { a as QrPoseStability, o as QrPoseStabilityOptions, s as QrPoseStabilityStatus } from "../qr-pose-aggregation-mABSN0AW.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-DXw5-UvO.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-mfyxD2-M.js";
+import { n as SessionMetadata } from "../opfs-storage-S_odkCk1.js";
+import { n as StorageBackend } from "../storage-backend-BX7egQKi.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-DFm5K9Ob.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as updateDeviceOrientation, n as buildRawGpsPoint, o as resetCoordinatorState, r as buildRecordGpsEventPayload, t as RecordingCoordinatorConfig } from "../gps-event-coordinator-Cruoe5I-.js";
+import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-BuuUuK-D.js";
+import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-qT2EM1Qs.js";
+import { i as slicePrefixOf, n as PersistenceMiddlewareOptions, r as createPersistenceMiddleware } from "../persistence-middleware-Cun4aF5M.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-B1H_kLhK.js";
+import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector-j-eOYybQ.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-CWHToX6N.js";
+import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-DG0ZqaeI.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-ClmnNJ6-.js";
+export { Add2dImagePayload, AlignmentSnapshot, CaptureGpsAnchorSampleOptions, CompleteCallback, DEFAULT_MAX_DELAY_MS, DEFAULT_QR_MAX_HISTORY, DEFAULT_TRACKING_QUALITY_OPTIONS, DepthPoint, DepthSample, DeviceOrientation, ErrorCallback, GpsAnchorSample, GpsAnchorSampleGpsPoint, GpsPoint, LatLong, OnboardingGuidance, OnboardingPhase, SessionMetadata as OpfsSessionMetadata, PersistenceMiddlewareOptions, PoseReceivedPayload, ProgressCallback, QrDetectedState, QrDetectionEntry, QrMarkerState, QrPoseStability, QrPoseStabilityOptions, QrPoseStabilityStatus, QrSizeEstimate, QrSizeStatus, RawDeviceOrientation, RawGpsPoint, RecordGpsEventPayload, RecordingCoordinatorConfig, RecordingState, ReplayAction, ReplayEngine, ReplayRecordingOptions, ReplayState, ResetTransformData, RootWithQrDetected, 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, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeInterActionDelay, computeOnboardingGuidance, computeResidualConsensus, computeTrackingQualityReport, createGpsPositionHandler, createPersistenceMiddleware, createSlamAppStore, createTrackingQualityListenerMiddleware, degradedCountUpdated, endSession, eulerToQuaternion, extractActionTimestamp, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, matrixDelta, medianQrPosition, originReset, poseLost, poseReceived, pruneQrDetections, qrDetectedReducer, recordDepthSample, recordGpsEvent, recordQrDetection, recordQrSizeEstimate, recordWriteFailure, recordingReducer, replayRecording, reportUpdated, resetCoordinatorState, resetTracking, resetTrackingQuality, 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, wireStoreSubscribers };

package/dist/state/index.js

@@ -1,16 +1,17 @@
-import { buildRawGpsPoint, buildRecordGpsEventPayload, createGpsPositionHandler, eulerToQuaternion, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, resetCoordinatorState, updateDeviceOrientation } from "./gps-event-coordinator.js";
+import { extractOdomPosition, extractOdomRotation } from "../types/ar-types.js";
 import { clearLastRestartedPayload, originReset, poseLost, poseReceived, resetTracking, selectLastRestartedPayload, selectLastSensorOrientation, selectLastValidPose, selectLostFrameCount, selectTrackingPhase, trackingReducer } from "./tracking-slice.js";
-import { DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, IMAGE_CONSTRAINTS, STORAGE_KEY, cloneRecordingOptions, loadRecordingOptions, resetRecordingOptions, saveRecordingOptions, validateDepthOptions, validateImageOptions, validateRecordingOptions } from "./recording-options.js";
+import { r as updateDeviceOrientation, t as getLastDeviceOrientation } from "../device-orientation-cache-j-kLP8he.js";
 import { endSession, recordDepthSample, recordWriteFailure, recordingReducer, startSession } from "./recording-slice.js";
 import { DEFAULT_QR_MAX_HISTORY, clearAllQrMarkers, clearQrMarker, medianQrPosition, pruneQrDetections, qrDetectedReducer, recordQrDetection, recordQrSizeEstimate, selectDerivedQrPlacement, selectLatestQrDetection, selectQrMarker, selectQrMarkers, selectQrPoseStability, selectQrRawObservations, selectQrSize, selectResolvedQrSizeM, selectSolvedQrPose, selectStableQrPose, setQrMaxHistory } from "./qr-detected-slice.js";
+import { buildRawGpsPoint, buildRecordGpsEventPayload, createGpsPositionHandler, eulerToQuaternion, resetCoordinatorState } from "./gps-event-coordinator.js";
 import { captureGpsAnchorSample } from "./gps-ar-pose-sampler.js";
 import { selectAlignmentMatrix, selectFrameTilesInWebXR, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectZeroReference } from "./app-selectors.js";
 import { DEFAULT_TRACKING_QUALITY_OPTIONS, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeResidualConsensus, computeTrackingQualityReport, createTrackingQualityListenerMiddleware, degradedCountUpdated, matrixDelta, reportUpdated, resetTrackingQuality, selectRecentAlignments, selectTrackingQuality, snapshotPushed, snapshotsTrimmed, trackingQualityReducer } from "./tracking-quality.js";
 import { createPersistenceMiddleware, slicePrefixOf } from "./persistence-middleware.js";
-import { t as createSlamAppStore } from "../create-slam-app-store-DXiAnJwR.js";
+import { t as createSlamAppStore } from "../create-slam-app-store-oK9bnqyI.js";
 import { replayRecording } from "./recording-replayer.js";
 import { DEFAULT_MAX_DELAY_MS, ReplayEngine, computeInterActionDelay, extractActionTimestamp } from "./replay-engine.js";
 import { subscribeToSelector } from "./subscribe-to-selector.js";
 import { wireStoreSubscribers } from "./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";
-export { DEFAULT_MAX_DELAY_MS, DEFAULT_QR_MAX_HISTORY, DEFAULT_RECORDING_OPTIONS, DEFAULT_TRACKING_QUALITY_OPTIONS, DEPTH_CONSTRAINTS, IMAGE_CONSTRAINTS, ReplayEngine, STORAGE_KEY, 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 };
+import { a as computeOnboardingGuidance, i as setZeroPos, n as calcRelativeCoordsInMeters, o as selectOnboardingGuidance, r as recordGpsEvent, t as add2dImage } from "../state-CDF5LvsO.js";
+export { DEFAULT_MAX_DELAY_MS, DEFAULT_QR_MAX_HISTORY, DEFAULT_TRACKING_QUALITY_OPTIONS, ReplayEngine, add2dImage, buildRawGpsPoint, buildRecordGpsEventPayload, calcRelativeCoordsInMeters, captureGpsAnchorSample, clearAllQrMarkers, clearLastRestartedPayload, clearQrMarker, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeInterActionDelay, computeOnboardingGuidance, computeResidualConsensus, computeTrackingQualityReport, createGpsPositionHandler, createPersistenceMiddleware, createSlamAppStore, createTrackingQualityListenerMiddleware, degradedCountUpdated, endSession, eulerToQuaternion, extractActionTimestamp, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, matrixDelta, medianQrPosition, originReset, poseLost, poseReceived, pruneQrDetections, qrDetectedReducer, recordDepthSample, recordGpsEvent, recordQrDetection, recordQrSizeEstimate, recordWriteFailure, recordingReducer, replayRecording, reportUpdated, resetCoordinatorState, resetTracking, resetTrackingQuality, 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, wireStoreSubscribers };

package/dist/state/persistence-middleware.d.ts

@@ -1,2 +1,2 @@
-import { n as createPersistenceMiddleware, r as slicePrefixOf, t as PersistenceMiddlewareOptions } from "../persistence-middleware-CG-t08X4.js";
-export { PersistenceMiddlewareOptions, createPersistenceMiddleware, slicePrefixOf };
+import { i as slicePrefixOf, n as PersistenceMiddlewareOptions, r as createPersistenceMiddleware, t as PersistenceMiddleware } from "../persistence-middleware-Cun4aF5M.js";
+export { PersistenceMiddleware, PersistenceMiddlewareOptions, createPersistenceMiddleware, slicePrefixOf };

package/dist/state/persistence-middleware.js

@@ -11,10 +11,27 @@ const MAX_CONCURRENT_WRITES = 3;
 var WriteQueue = class {
 	pendingCount = 0;
 	queue = [];
+	flushWaiters = [];
 	enqueue(writeFn) {
 		this.queue.push(writeFn);
 		this.drain();
 	}
+	/**
+	* Resolves once the queue is fully idle — every enqueued write (including
+	* ones still waiting behind the concurrency cap) has settled. Rejected
+	* writes count as settled (the enqueue wrappers handle their errors), so
+	* flush never hangs on a failing backend. Writes enqueued AFTER the queue
+	* went idle again are not waited for.
+	*/
+	flush() {
+		if (this.isIdle()) return Promise.resolve();
+		return new Promise((resolve) => {
+			this.flushWaiters.push(resolve);
+		});
+	}
+	isIdle() {
+		return this.pendingCount === 0 && this.queue.length === 0;
+	}
 	drain() {
 		while (this.pendingCount < MAX_CONCURRENT_WRITES && this.queue.length > 0) {
 			const fn = this.queue.shift();
@@ -24,6 +41,11 @@ var WriteQueue = class {
 				this.drain();
 			});
 		}
+		if (this.isIdle() && this.flushWaiters.length > 0) {
+			const waiters = this.flushWaiters;
+			this.flushWaiters = [];
+			for (const resolve of waiters) resolve();
+		}
 	}
 };
 /**
@@ -58,19 +80,6 @@ function isInPersistableSession(wasRecording, isRecording, actionType) {
 	const isEndSession = actionType === endSession.type;
 	return isRecording || wasRecording && isEndSession;
 }
-/**
-* Create a Redux middleware that persists qualifying actions to storage
-* during active recording sessions.
-*
-* Persistence rules:
-* - Only persists when `state.recording.isRecording` is true (checked AFTER
-*   the action is reduced, so `startSession` itself is included).
-* - Persists actions whose slice prefix is listed in `persistedPrefixes`.
-* - Excludes `recording/recordWriteFailure` to prevent recursive persistence.
-* - Excludes `routing/*` and any other non-whitelisted actions.
-* - Uses 1-based indexing for action files (000001.json, 000002.json, …).
-* - Each middleware instance maintains its own action index (Bug 10 fix).
-*/
 function createPersistenceMiddleware(options) {
 	const { storageBackend, onWriteFailure, persistedPrefixes } = options;
 	const normalizedPrefixes = persistedPrefixes.map((prefix) => prefix.endsWith("/") ? prefix : `${prefix}/`);
@@ -93,7 +102,7 @@ function createPersistenceMiddleware(options) {
 			const index = ++actionIndex;
 			if (dispatchDepth > 1 && !hasWarnedReentrant) {
 				hasWarnedReentrant = true;
-				log.warn(`Persisted action "${actionType}" was dispatched re-entrantly (inside another dispatch's next()). Its recorded order can invert on replay — react to actions via a prepended listener middleware, not a synchronous store.subscribe dispatch. See 2026-06-28-subscriber-dispatch-persistence-ordering-review.md.`);
+				log.warn(`Persisted action "${actionType}" was dispatched re-entrantly (inside another dispatch's next()). Its recorded order can invert on replay — react to actions via a prepended listener middleware, not a synchronous store.subscribe dispatch. See 2026-06-28-0751-subscriber-dispatch-persistence-ordering-review.md.`);
 			}
 			writeQueue.enqueue(async () => {
 				try {
@@ -110,7 +119,7 @@ function createPersistenceMiddleware(options) {
 			dispatchDepth -= 1;
 		}
 	};
-	return middleware;
+	return Object.assign(middleware, { flushPendingWrites: () => writeQueue.flush() });
 }
 //#endregion
 export { createPersistenceMiddleware, slicePrefixOf };

package/dist/state/qr-detected-slice.d.ts

@@ -1,4 +1,4 @@
-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 { 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 { d as QrSizeStatus, l as QrSizeEstimate } from "../qr-size-measurer-rVFf4AdM.js";
+import { a as QrPoseStability, o as QrPoseStabilityOptions, s as QrPoseStabilityStatus } from "../qr-pose-aggregation-mABSN0AW.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-mfyxD2-M.js";
 export { DEFAULT_QR_MAX_HISTORY, QrDetectedState, QrDetectionEntry, QrMarkerState, QrPoseStability, QrPoseStabilityOptions, QrPoseStabilityStatus, QrSizeEstimate, QrSizeStatus, RootWithQrDetected, clearAllQrMarkers, clearQrMarker, medianQrPosition, pruneQrDetections, qrDetectedReducer, recordQrDetection, recordQrSizeEstimate, selectDerivedQrPlacement, selectLatestQrDetection, selectQrMarker, selectQrMarkers, selectQrPoseStability, selectQrRawObservations, selectQrSize, selectResolvedQrSizeM, selectSolvedQrPose, selectStableQrPose, setQrMaxHistory };

package/dist/state/qr-detected-slice.js

@@ -1,10 +1,11 @@
-import { deriveQrPlacement, deriveSolvedQrPose } from "../ar/qr-derived-pose.js";
-import { i as evaluateQrPoseStability } from "../qr-pose-aggregation-DBiaLW0O.js";
+import { n as lowerMedian } from "../median-DDBrZGP0.js";
+import { deriveQrPlacement, deriveSolvedQrPose } from "../ar/qr/qr-derived-pose.js";
+import { i as evaluateQrPoseStability } from "../qr-pose-aggregation-Cp0Mtg_j.js";
 import { createSlice } from "@reduxjs/toolkit";
 //#region ../src/state/qr-detected-slice.ts
 /**
 * `qrDetected` Redux slice — Note 3 of the QR-tracking follow-up plan
-* (docs `2026-06-15-followup-qr-tracking-generalization-overlay-and-north.md`).
+* (docs `2026-06-15-1219-qr-tracking-generalization-overlay-and-north-followup.md`).
 *
 * A detection-agnostic, framework-level store of "what was detected, where, in
 * 3D" that overlay / trigger / anchor consumers subscribe to INDEPENDENTLY of
@@ -30,8 +31,8 @@ import { createSlice } from "@reduxjs/toolkit";
 * { qrDetected: qrDetectedReducer } })`. It is not a built-in of the store
 * factory, so framework consumers that never detect anything pay nothing.
 *
-* @see ../ar/qr-tracking-controller.ts — the producer (dispatches `recordQrDetection`).
-* @see ../ar/qr-pose.ts — `Pose` / `QrPoseSolution` (the per-detection geometry).
+* @see ../ar/qr/qr-tracking-controller.ts — the producer (dispatches `recordQrDetection`).
+* @see ../ar/qr/qr-pose.ts — `Pose` / `QrPoseSolution` (the per-detection geometry).
 */
 /**
 * Default ring-buffer cap per marker. Bounded so an overlay that never prunes
@@ -201,11 +202,6 @@ function selectResolvedQrSizeM(state, text) {
 	const size = state.qrDetected.markers[text]?.size;
 	return size?.status === "estimated" ? size.estimateM : null;
 }
-/** Per-axis median of a numeric list (returns the lower-middle for even n). */
-function medianOf(values) {
-	const sorted = [...values].sort((a, b) => a - b);
-	return sorted[Math.floor((sorted.length - 1) / 2)];
-}
 /**
 * Robust per-axis median of the world positions across a marker's detection
 * window — the "running estimate" the bounded buffer enables (Note 3). Outliers
@@ -220,9 +216,9 @@ function medianQrPosition(entries) {
 	const ys = poses.map((p) => p.position[1]);
 	const zs = poses.map((p) => p.position[2]);
 	return [
-		medianOf(xs),
-		medianOf(ys),
-		medianOf(zs)
+		lowerMedian(xs),
+		lowerMedian(ys),
+		lowerMedian(zs)
 	];
 }
 /**
@@ -230,7 +226,7 @@ function medianQrPosition(entries) {
 * buffer (NOT stored separately — the detections are the source of truth, unlike
 * the depth-measured size which is accumulated outside the buffer). Mirrors the
 * size lifecycle's `unknown → measuring → stable` shape so the HUD can show
-* "converging…" vs "stable". See `ar/qr-pose-aggregation.ts`.
+* "converging…" vs "stable". See `ar/qr/qr-pose-aggregation.ts`.
 */
 function selectQrPoseStability(state, text, options) {
 	const marker = state.qrDetected.markers[text];
@@ -278,7 +274,7 @@ function toRawObservation(entry) {
 * `null` when the marker is unknown, has no raw observations, cannot be sized
 * yet, or PnP rejects the latest quad — the re-test-friendly replacement for the
 * once-stored solved pose. Runs identically live and on replay (only
-* `deps.resolveDepthAt` differs). See `ar/qr-derived-pose.ts`.
+* `deps.resolveDepthAt` differs). See `ar/qr/qr-derived-pose.ts`.
 */
 function selectSolvedQrPose(state, text, deps) {
 	return deriveSolvedQrPose(text, selectQrRawObservations(state, text), deps);

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

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

package/dist/state/recording-replayer.js

@@ -1,6 +1,6 @@
 import { loadActionsFromZip } from "../storage/zip-reader.js";
 import { NullStorageBackend } from "../storage/null-storage-backend.js";
-import { t as createSlamAppStore } from "../create-slam-app-store-DXiAnJwR.js";
+import { t as createSlamAppStore } from "../create-slam-app-store-oK9bnqyI.js";
 //#region ../src/state/recording-replayer.ts
 /**
 * Recording Replayer