gps-plus-slam-app-framework 1.0.6 → 1.1.0

package/dist/{recording-slice-BiktUIWF.d.ts → recording-slice-Cb888P6d.d.ts}

@@ -1,5 +1,5 @@
-import { i as DepthSample } from "./ar-types-B-ORgk6Z.js";
-import { s as RecordingOptions } from "./recording-options-BYUFX8iU.js";
+import { i as DepthSample } from "./ar-types-isPsQptb.js";
+import { s as RecordingOptions } from "./recording-options-BSFpBSZH.js";
 import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
 
 //#region ../src/state/recording-slice.d.ts

package/dist/{replay-engine-B88Va62x.d.ts → replay-engine-B-5GIZtc.d.ts}

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

package/dist/{replay-scene-DtUm6bsr.d.ts → replay-scene-DkNfldPh.d.ts}

@@ -1,6 +1,6 @@
-import { t as CameraFollower } from "./camera-follower-BMqPddxx.js";
-import { t as AlignmentLerper } from "./alignment-lerper-D9BeDwZX.js";
-import { t as Css3dRendererManager } from "./css3d-renderer-manager-rgLMVAvd.js";
+import { t as Css3dRendererManager } from "./css3d-renderer-manager-EDED3nvg.js";
+import { t as CameraFollower } from "./camera-follower-B-nS1sr6.js";
+import { t as AlignmentLerper } from "./alignment-lerper-CCZJf-Xb.js";
 import * as THREE from "three";
 import { OrbitControls } from "three/addons/controls/OrbitControls.js";
 

package/dist/sensors/gps-error-handler.d.ts

@@ -1,2 +1,2 @@
-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-CH1S528z.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-BLDhUlw5.js";
 export { GPS_ERROR_CODES, GPS_ERROR_MESSAGES, GPS_ERROR_MESSAGE_UNKNOWN, createGpsErrorHandler, getGpsErrorMessage };

package/dist/sensors/gps.d.ts

@@ -1,2 +1,2 @@
-import { a as startOrientationWatch, i as startGpsWatch, n as RawDeviceOrientation, o as stopGpsWatch, r as requestOrientationPermission, s as stopOrientationWatch, t as GpsPosition } from "../gps-GKc6_Cly.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-B7AlMPz5.js";
 export { GpsPosition, RawDeviceOrientation, requestOrientationPermission, startGpsWatch, startOrientationWatch, stopGpsWatch, stopOrientationWatch };

package/dist/sensors/gps.js

@@ -36,8 +36,8 @@ function startGpsWatch(onPosition, onError) {
 		onError?.(err);
 	}, {
 		enableHighAccuracy: true,
-		maximumAge: 0,
-		timeout: 1e4
+		maximumAge: 5e3,
+		timeout: 15e3
 	});
 	log.info("Watch started");
 }

package/dist/sensors/index.d.ts

@@ -1,4 +1,4 @@
-import { a as startOrientationWatch, i as startGpsWatch, n as RawDeviceOrientation, o as stopGpsWatch, r as requestOrientationPermission, s as stopOrientationWatch, t as GpsPosition } from "../gps-GKc6_Cly.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-CH1S528z.js";
-import { a as checkFileSystemPermission, c as checkWebXRSupport, d as requestGeolocationPermission, f as requestOrientationPermission$1, h as setFileSystemState, i as checkCameraPermission, l as requestAllPermissions, m as resetFileSystemState, n as PermissionStatus, o as checkGeolocationPermission, p as requestWebXRWithDepthPermission, r as checkAllPermissions, s as checkOrientationPermission, t as PermissionCheckResult, u as requestCameraPermission } from "../permission-checker-Cu3nbH1S.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-B7AlMPz5.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-CfV7INCa.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-BLDhUlw5.js";
 export { 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, requestAllPermissions, requestCameraPermission, requestOrientationPermission as requestDeviceOrientationPermission, requestGeolocationPermission, requestOrientationPermission$1 as requestOrientationPermission, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState, startGpsWatch, startOrientationWatch, stopGpsWatch, stopOrientationWatch };

package/dist/sensors/index.js

@@ -1,4 +1,4 @@
+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 { GPS_ERROR_CODES, GPS_ERROR_MESSAGES, GPS_ERROR_MESSAGE_UNKNOWN, createGpsErrorHandler, getGpsErrorMessage } from "./gps-error-handler.js";
-import { checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, requestAllPermissions, requestCameraPermission, requestGeolocationPermission, requestOrientationPermission as requestOrientationPermission$1, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState } from "./permission-checker.js";
 export { GPS_ERROR_CODES, GPS_ERROR_MESSAGES, GPS_ERROR_MESSAGE_UNKNOWN, checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, createGpsErrorHandler, getGpsErrorMessage, requestAllPermissions, requestCameraPermission, requestOrientationPermission as requestDeviceOrientationPermission, requestGeolocationPermission, requestOrientationPermission$1 as requestOrientationPermission, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState, startGpsWatch, startOrientationWatch, stopGpsWatch, stopOrientationWatch };

package/dist/sensors/permission-checker.d.ts

@@ -1,2 +1,2 @@
-import { a as checkFileSystemPermission, c as checkWebXRSupport, d as requestGeolocationPermission, f as requestOrientationPermission, h as setFileSystemState, i as checkCameraPermission, l as requestAllPermissions, m as resetFileSystemState, n as PermissionStatus, o as checkGeolocationPermission, p as requestWebXRWithDepthPermission, r as checkAllPermissions, s as checkOrientationPermission, t as PermissionCheckResult, u as requestCameraPermission } from "../permission-checker-Cu3nbH1S.js";
-export { PermissionCheckResult, PermissionStatus, checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, requestAllPermissions, requestCameraPermission, requestGeolocationPermission, requestOrientationPermission, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState };
+import { _ as subscribePermissionChanges, 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, r as PermissionSubscription, s as checkGeolocationPermission, t as PermissionCheckResult, u as requestAllPermissions } from "../permission-checker-CfV7INCa.js";
+export { PermissionCheckResult, PermissionStatus, PermissionSubscription, checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, requestAllPermissions, requestCameraPermission, requestGeolocationPermission, requestOrientationPermission, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState, subscribePermissionChanges };

package/dist/sensors/permission-checker.js

@@ -321,6 +321,84 @@ async function checkAllPermissions() {
 	};
 }
 /**
+* Subscribe to out-of-band permission changes.
+*
+* Today the recorder app only re-runs `checkAllPermissions()` at startup
+* and after the user clicks "Grant Permissions" — so a permission flipped
+* via browser settings (e.g. user denies location, then enables it under
+* "site settings") is only detected after a full page reload.
+*
+* This subscription wires three signals:
+* 1. `navigator.permissions.query(...)` returns a live `PermissionStatus`
+*    for `'geolocation'` and `'camera'`; we keep those references and
+*    attach a `'change'` listener via `addEventListener` so we react
+*    immediately when the browser updates the underlying state.
+* 2. `document.visibilitychange` (only when `visibilityState === 'visible'`)
+*    covers the "user tabbed out to settings, toggled, tabbed back" case
+*    on browsers where the `'change'` event does not fire reliably.
+* 3. `window.focus` covers the same scenario for browsers/standalone
+*    windows where `visibilitychange` is not dispatched on focus return.
+*
+* Each signal triggers a fresh {@link checkAllPermissions} call; the
+* resulting {@link PermissionCheckResult} is passed to `callback`.
+*
+* No periodic polling is performed — the trio above is the complete
+* fallback chain. If a browser supports none of these signals for a given
+* permission, the user can still re-check by clicking the (now permanently
+* visible) "Grant Permissions" button.
+*
+* @param callback - Invoked with the latest {@link PermissionCheckResult}
+*   each time one of the signals fires. The initial state is **not**
+*   delivered; callers are expected to have already rendered it.
+* @returns A handle whose `unsubscribe()` removes every wired listener.
+*/
+function subscribePermissionChanges(callback) {
+	let disposed = false;
+	const cleanups = [];
+	const notify = () => {
+		if (disposed) return;
+		checkAllPermissions().then((result) => {
+			if (!disposed) callback(result);
+		}).catch((err) => {
+			log.warn("subscribePermissionChanges: re-check failed", err);
+		});
+	};
+	if (typeof navigator !== "undefined" && navigator.permissions && typeof navigator.permissions.query === "function") {
+		const wireStatus = (name) => {
+			try {
+				navigator.permissions.query({ name }).then((status) => {
+					if (disposed) return;
+					const handler = () => notify();
+					status.addEventListener("change", handler);
+					cleanups.push(() => status.removeEventListener("change", handler));
+				}, () => {});
+			} catch {}
+		};
+		wireStatus("geolocation");
+		wireStatus("camera");
+	}
+	if (typeof document !== "undefined") {
+		const onVisibility = () => {
+			if (document.visibilityState === "visible") notify();
+		};
+		document.addEventListener("visibilitychange", onVisibility);
+		cleanups.push(() => document.removeEventListener("visibilitychange", onVisibility));
+	}
+	if (typeof window !== "undefined") {
+		const onFocus = () => notify();
+		window.addEventListener("focus", onFocus);
+		cleanups.push(() => window.removeEventListener("focus", onFocus));
+	}
+	return { unsubscribe() {
+		disposed = true;
+		for (const c of cleanups.splice(0)) try {
+			c();
+		} catch (err) {
+			log.warn("subscribePermissionChanges: cleanup failed", err);
+		}
+	} };
+}
+/**
 * Request all mandatory permissions that haven't been granted yet.
 * Shows browser prompts for each permission that needs requesting.
 *
@@ -394,4 +472,4 @@ async function requestWebXRWithDepthPermission() {
 	}
 }
 //#endregion
-export { checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, requestAllPermissions, requestCameraPermission, requestGeolocationPermission, requestOrientationPermission, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState };
+export { checkAllPermissions, checkCameraPermission, checkFileSystemPermission, checkGeolocationPermission, checkOrientationPermission, checkWebXRSupport, requestAllPermissions, requestCameraPermission, requestGeolocationPermission, requestOrientationPermission, requestWebXRWithDepthPermission, resetFileSystemState, setFileSystemState, subscribePermissionChanges };

package/dist/session-disposers-M-oashRH.js

@@ -0,0 +1,57 @@
+import { createLogger } from "./utils/logger.js";
+//#region ../src/ar/session-disposers.ts
+/**
+* Session-scoped disposer registry. Components that allocate a resource tied to
+* a single AR session — a store subscription, an event listener, a lerper —
+* register a teardown function here; the WebXR session's `resetWebXRState()`
+* flushes them on teardown so the resource never outlives the session it
+* belonged to.
+*
+* This is a sibling of `frame-loop.ts` (also a `Set`-based registry) but serves
+* a different need: `frame-loop` holds *per-frame ticks* invoked every frame and
+* wiped by `clearFrameUpdates()`; this registry holds *one-shot teardown* run
+* exactly once on session end. The split keeps each registry's contract crisp.
+*
+* Why it exists: `resetWebXRState()` already clears the frame-update registry,
+* but resources like the store subscription opened by
+* `enableArWorldGroupAlignment` are not per-frame ticks and had no teardown hook
+* — so they leaked across sessions (a dangling subscriber pinning the old
+* `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.
+*/
+const log = createLogger("SessionDisposers");
+const disposers = /* @__PURE__ */ new Set();
+/**
+* Register a session-scoped teardown function. Returns a deregister function
+* (call it when the resource is disposed early, so a later flush won't re-run
+* the teardown).
+*/
+function registerSessionDisposer(dispose) {
+	disposers.add(dispose);
+	return () => {
+		disposers.delete(dispose);
+	};
+}
+/**
+* Run and drop every registered disposer. Called from `resetWebXRState()` on
+* session teardown.
+*
+* The set is snapshotted and **cleared before** running, so (a) a second flush
+* is a no-op rather than re-tearing-down an already-released resource, and (b) a
+* disposer that re-registers during teardown cannot loop. Each disposer runs in
+* its own `try/catch` so one throwing teardown cannot abort the rest — mirroring
+* `runFrameUpdates`.
+*/
+function runSessionDisposers() {
+	const snapshot = Array.from(disposers);
+	disposers.clear();
+	for (const dispose of snapshot) try {
+		dispose();
+	} catch (error) {
+		log.error("A session disposer threw; continuing teardown", error);
+	}
+}
+//#endregion
+export { runSessionDisposers as n, registerSessionDisposer as t };

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

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

package/dist/state/app-selectors.js

@@ -1,3 +1,4 @@
+import { nueQuaternionToWebXR, nueToWebXR } from "gps-plus-slam-js";
 import { createSelector } from "@reduxjs/toolkit";
 //#region ../src/state/app-selectors.ts
 /**
@@ -17,7 +18,7 @@ import { createSelector } from "@reduxjs/toolkit";
 const EMPTY_GPS_POSITIONS = [];
 const EMPTY_ODOM_POSITIONS = [];
 const EMPTY_ODOM_ROTATIONS = [];
-const EMPTY_REF_POINTS = [];
+const EMPTY_FRAME_TILES = [];
 const selectGpsData = (state) => state.gpsData;
 /** Alignment matrix (4×4), or null if not yet computed. */
 const selectAlignmentMatrix = createSelector([selectGpsData], (gpsData) => gpsData?.gpsEvents?.alignmentMatrix ?? null);
@@ -30,6 +31,35 @@ const selectOdometryRotations = createSelector([selectGpsData], (gpsData) => gps
 /** GPS zero reference (origin for coordinate conversion), or null. */
 const selectZeroReference = createSelector([selectGpsData], (gpsData) => gpsData?.zero ?? null);
 /** User-defined reference points for ground truth validation. */
-const selectReferencePoints = createSelector([selectGpsData], (gpsData) => gpsData?.referencePoints ?? EMPTY_REF_POINTS);
+/**
+* Captured AR image frames in WebXR coordinate space.
+*
+* Reads `state.gpsData.odometryPath.points` (which the library reducer
+* stores in NUE convention — see `gpsDataSlice.ts` `add2dImage`) and
+* converts each entry back to WebXR so the live AR scene visualizer can
+* apply the pose directly. This is the source of truth for the
+* frame-tile visualizer; the legacy `framesInScene` slice is a dead
+* mirror scheduled for removal (Step 5 of the 2026-05-27
+* slice-collapse plan).
+*
+* Memoized via createSelector keyed on `odometryPath.points` (NOT the whole
+* `gpsData`). The library reducer uses Immer, so unrelated updates (GPS
+* observations, VIO offsets) produce a new `gpsData` reference while
+* `odometryPath.points` keeps its reference via structural sharing. Keying on
+* the points array therefore preserves referential stability of the output
+* across those dispatches — subscribers like `wireFrameTileSubscribers` only
+* re-run when frames actually change.
+*/
+const selectOdometryPathPoints = (state) => state.gpsData?.odometryPath?.points;
+const selectFrameTilesInWebXR = createSelector([selectOdometryPathPoints], (points) => {
+	if (!points || points.length === 0) return EMPTY_FRAME_TILES;
+	return points.map((p) => ({
+		imageFile: p.imageFile,
+		position: nueToWebXR(p.position),
+		rotation: nueQuaternionToWebXR(p.rotation),
+		screenRotation: p.screenRotation,
+		capturedAt: p.capturedAt
+	}));
+});
 //#endregion
-export { selectAlignmentMatrix, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectReferencePoints, selectZeroReference };
+export { selectAlignmentMatrix, selectFrameTilesInWebXR, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectZeroReference };

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

@@ -0,0 +1,2 @@
+import { L as CombinedRootState } from "../create-slam-app-store-B76AGaI0.js";
+export { CombinedRootState };

package/dist/state/combined-root-state.js

@@ -0,0 +1 @@
+export {};

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-DBm7g2Zd.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-B76AGaI0.js";
 export { SlamAppCombinedState, SlamAppMiddleware, SlamAppRootState, SlamAppStore, SlamAppStoreOptions, createSlamAppStore };

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

@@ -1,6 +1,8 @@
-import { recordingReducer } from "./recording-slice.js";
-import { createPersistenceMiddleware } from "./persistence-middleware.js";
-import { arElementsReducer, gpsDataReducer, gpsElementsReducer, sanitizeForDevTools, validateLicenseKey } from "gps-plus-slam-js";
+import { trackingReducer } from "./tracking-slice.js";
+import { recordWriteFailure, recordingReducer } from "./recording-slice.js";
+import { createTrackingQualityListenerMiddleware, trackingQualityReducer } from "./tracking-quality.js";
+import { createPersistenceMiddleware, slicePrefixOf } from "./persistence-middleware.js";
+import { arElementsReducer, gpsDataReducer, gpsElementsReducer, sanitizeForDevTools, setZeroPos, validateLicenseKey } from "gps-plus-slam-js";
 import { configureStore } from "@reduxjs/toolkit";
 import { COMMUNITY_LICENSE_KEY } from "gps-plus-slam-js/community-license-key";
 //#region ../src/state/create-slam-app-store.ts
@@ -22,27 +24,39 @@ import { COMMUNITY_LICENSE_KEY } from "gps-plus-slam-js/community-license-key";
 * @see docs/2026-05-03-appframework-vs-recorderapp-boundary-analysis.md — Iter 1
 */
 /**
+* Slice prefixes the framework always persists, derived from the actual
+* library / framework action creators (never hand-typed). A rename of the
+* `gpsData` or `recording` slice therefore propagates here automatically
+* instead of silently dropping that slice's actions from recordings.
+*/
+const BUILTIN_PERSISTED_PREFIXES = [slicePrefixOf(setZeroPos.type), slicePrefixOf(recordWriteFailure.type)];
+/**
 * Build a Redux store wired with library + recording slices, persistence
 * middleware, and any caller-supplied extras. See module docstring for the
 * design rationale.
 */
 function createSlamAppStore(options) {
-	const { storageBackend, extraReducers, extraMiddleware, onWriteFailure, enableDevChecks = true, licenseKey = COMMUNITY_LICENSE_KEY } = options;
+	const { storageBackend, extraReducers, extraMiddleware, persistedExtraPrefixes, onWriteFailure, enableDevChecks = true, licenseKey = COMMUNITY_LICENSE_KEY, trackingQualityOptions } = options;
 	validateLicenseKey(licenseKey);
+	const reducer = {
+		gpsData: gpsDataReducer,
+		gpsElements: gpsElementsReducer,
+		arElements: arElementsReducer,
+		recording: recordingReducer,
+		tracking: trackingReducer,
+		trackingQuality: trackingQualityReducer,
+		...extraReducers ?? {}
+	};
+	const trackingQualityMiddleware = createTrackingQualityListenerMiddleware(trackingQualityOptions);
 	const store = configureStore({
-		reducer: {
-			gpsData: gpsDataReducer,
-			gpsElements: gpsElementsReducer,
-			arElements: arElementsReducer,
-			recording: recordingReducer,
-			...extraReducers ?? {}
-		},
+		reducer,
 		middleware: (getDefaultMiddleware) => getDefaultMiddleware({
 			serializableCheck: enableDevChecks,
 			immutableCheck: enableDevChecks
-		}).concat(createPersistenceMiddleware({
+		}).prepend(trackingQualityMiddleware).concat(createPersistenceMiddleware({
 			storageBackend,
-			onWriteFailure
+			onWriteFailure,
+			persistedPrefixes: [...BUILTIN_PERSISTED_PREFIXES, ...persistedExtraPrefixes ?? []]
 		}), ...extraMiddleware ?? []),
 		devTools: {
 			actionSanitizer: sanitizeForDevTools,

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

@@ -1,4 +1,4 @@
-import { t as ARPose } from "../ar-types-B-ORgk6Z.js";
-import { o as extractOdomPosition, s as extractOdomRotation } from "../gps-event-coordinator-fwvmVfku.js";
-import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-D_Zso40V.js";
+import { t as ARPose } from "../ar-types-isPsQptb.js";
+import { o as extractOdomPosition, s as extractOdomRotation } from "../gps-event-coordinator-BKVZbS1M.js";
+import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-BypXZUqC.js";
 export { ARPose, CaptureGpsAnchorSampleOptions, GpsAnchorSample, GpsAnchorSampleGpsPoint, captureGpsAnchorSample, extractOdomPosition, extractOdomRotation };

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

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

package/dist/state/index.d.ts

@@ -1,16 +1,17 @@
-import { i as DepthSample, r as DepthPoint } from "../ar-types-B-ORgk6Z.js";
-import { _ as validateRecordingOptions, a as IMAGE_CONSTRAINTS, c as RecordingOptionsInput, d as loadRecordingOptions, f as resetRecordingOptions, g as validateImageOptions, h as validateDepthOptions, i as DepthCaptureOptions, l as STORAGE_KEY, n as DEFAULT_RECORDING_OPTIONS, o as ImageCaptureOptions, p as saveRecordingOptions, r as DEPTH_CONSTRAINTS, u as cloneRecordingOptions } from "../recording-options-BYUFX8iU.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-BiktUIWF.js";
-import { n as SessionMetadata } from "../opfs-storage-Dlq1I_Gb.js";
-import { n as StorageBackend } from "../storage-backend-yVnuWGTr.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-DBm7g2Zd.js";
-import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as updateDeviceOrientation } from "../gps-event-coordinator-fwvmVfku.js";
-import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-D_Zso40V.js";
-import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-BFhFs7Mc.js";
-import { n as createPersistenceMiddleware, t as PersistenceMiddlewareOptions } from "../persistence-middleware-z-75iisb.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-B88Va62x.js";
-import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector-ghDKYtap.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-DKKHld49.js";
-import { a as selectReferencePoints, i as selectOdometryRotations, n as selectGpsPositions, o as selectZeroReference, r as selectOdometryPositions, t as selectAlignmentMatrix } from "../app-selectors-CHt7DLuq.js";
-import { GpsPoint, LatLong, MarkReferencePointPayload, RawDeviceOrientation, RawGpsPoint, RecordGpsEventPayload, add2dImage, calcRelativeCoordsInMeters, markReferencePoint, recordGpsEvent, setZeroPos } from "gps-plus-slam-js";
-export { type CaptureGpsAnchorSampleOptions, type CompleteCallback, DEFAULT_MAX_DELAY_MS, DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, type DepthCaptureOptions, type DepthPoint, type DepthSample, type ErrorCallback, type GpsAnchorSample, type GpsAnchorSampleGpsPoint, type GpsPoint, IMAGE_CONSTRAINTS, type ImageCaptureOptions, type LatLong, type MarkReferencePointPayload, type SessionMetadata as OpfsSessionMetadata, type PersistenceMiddlewareOptions, type ProgressCallback, type RawDeviceOrientation, type RawGpsPoint, type RecordGpsEventPayload, type RecordingCoordinatorConfig, type RecordingOptionsInput, type RecordingState, type ReplayAction, ReplayEngine, type ReplayRecordingOptions, type ReplayState, STORAGE_KEY, type SessionMetadata$1 as SessionMetadata, type SlamAppCombinedState, type SlamAppMiddleware, type SlamAppRootState, type SlamAppStore, type SlamAppStoreOptions, type StorageBackend, type StoreSubscriberDeps, type SubscribableStore, add2dImage, buildRawGpsPoint, buildRecordGpsEventPayload, calcRelativeCoordsInMeters, captureGpsAnchorSample, cloneRecordingOptions, computeInterActionDelay, createGpsPositionHandler, createPersistenceMiddleware, createSlamAppStore, endSession, eulerToQuaternion, extractActionTimestamp, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, loadRecordingOptions, markReferencePoint, recordDepthSample, recordGpsEvent, recordWriteFailure, recordingReducer, replayRecording, resetCoordinatorState, resetRecordingOptions, saveRecordingOptions, selectAlignmentMatrix, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectReferencePoints, selectZeroReference, setZeroPos, startSession, subscribeToSelector, updateDeviceOrientation, validateDepthOptions, validateImageOptions, validateRecordingOptions, wireStoreSubscribers };
+import { i as DepthSample, r as DepthPoint } from "../ar-types-isPsQptb.js";
+import { _ as validateRecordingOptions, a as IMAGE_CONSTRAINTS, c as RecordingOptionsInput, d as loadRecordingOptions, f as resetRecordingOptions, g as validateImageOptions, h as validateDepthOptions, i as DepthCaptureOptions, l as STORAGE_KEY, n as DEFAULT_RECORDING_OPTIONS, o as ImageCaptureOptions, p as saveRecordingOptions, r as DEPTH_CONSTRAINTS, u as cloneRecordingOptions } from "../recording-options-BSFpBSZH.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-CDREeoZ_.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-Cb888P6d.js";
+import { n as SessionMetadata } from "../opfs-storage-LsLY6VZV.js";
+import { n as StorageBackend } from "../storage-backend-yDSKafAQ.js";
+import { A as resetTrackingQuality, C as computeResidualConsensus, D as firstAgreementReached, E as degradedCountUpdated, F as snapshotsTrimmed, I as trackingQualityReducer, M as selectRecentAlignments, N as selectTrackingQuality, O as matrixDelta, P as snapshotPushed, S as computeGpsVsFusedDivergence, T as createTrackingQualityListenerMiddleware, _ as TrackingQualityState, a as SlamAppStoreOptions, b as computeCoverage, d as DEFAULT_TRACKING_QUALITY_OPTIONS, g as TrackingQualitySliceState, h as TrackingQualityReport, i as SlamAppStore, j as selectFirstAgreementObservationIndex, k as reportUpdated, m as TrackingQualityOptions, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, v as computeCompassAgreement, w as computeTrackingQualityReport, x as computeGpsAccuracy, y as computeConvergence } from "../create-slam-app-store-B76AGaI0.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as updateDeviceOrientation } from "../gps-event-coordinator-BKVZbS1M.js";
+import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-BypXZUqC.js";
+import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-CTL2cUE0.js";
+import { n as createPersistenceMiddleware, r as slicePrefixOf, t as PersistenceMiddlewareOptions } from "../persistence-middleware-xB5sTllJ.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-B-5GIZtc.js";
+import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector--KQpgLXG.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-swlbtg_z.js";
+import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-CR9OWodf.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-BB2KEWbN2.js";
+export { Add2dImagePayload, AlignmentSnapshot, CaptureGpsAnchorSampleOptions, CompleteCallback, DEFAULT_MAX_DELAY_MS, 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, RawDeviceOrientation, RawGpsPoint, RecordGpsEventPayload, RecordingCoordinatorConfig, RecordingOptionsInput, RecordingState, ReplayAction, ReplayEngine, ReplayRecordingOptions, ReplayState, ResetTransformData, 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, clearLastRestartedPayload, cloneRecordingOptions, computeCompassAgreement, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeInterActionDelay, computeOnboardingGuidance, computeResidualConsensus, computeTrackingQualityReport, createGpsPositionHandler, createPersistenceMiddleware, createSlamAppStore, createTrackingQualityListenerMiddleware, degradedCountUpdated, endSession, eulerToQuaternion, extractActionTimestamp, extractOdomPosition, extractOdomRotation, firstAgreementReached, getLastDeviceOrientation, loadRecordingOptions, matrixDelta, originReset, poseLost, poseReceived, recordDepthSample, recordGpsEvent, recordWriteFailure, recordingReducer, replayRecording, reportUpdated, resetCoordinatorState, resetRecordingOptions, resetTracking, resetTrackingQuality, saveRecordingOptions, selectAlignmentMatrix, selectFirstAgreementObservationIndex, selectFrameTilesInWebXR, selectGpsPositions, selectLastRestartedPayload, selectLastSensorOrientation, selectLastValidPose, selectLostFrameCount, selectOdometryPositions, selectOdometryRotations, selectOnboardingGuidance, selectRecentAlignments, selectTrackingPhase, selectTrackingQuality, selectZeroReference, setZeroPos, slicePrefixOf, snapshotPushed, snapshotsTrimmed, startSession, subscribeToSelector, trackingQualityReducer, trackingReducer, updateDeviceOrientation, validateDepthOptions, validateImageOptions, validateRecordingOptions, wireStoreSubscribers };

package/dist/state/index.js

@@ -1,13 +1,15 @@
 import { buildRawGpsPoint, buildRecordGpsEventPayload, createGpsPositionHandler, eulerToQuaternion, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, resetCoordinatorState, updateDeviceOrientation } from "./gps-event-coordinator.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 { endSession, recordDepthSample, recordWriteFailure, recordingReducer, startSession } from "./recording-slice.js";
 import { captureGpsAnchorSample } from "./gps-ar-pose-sampler.js";
-import { createPersistenceMiddleware } from "./persistence-middleware.js";
+import { selectAlignmentMatrix, selectFrameTilesInWebXR, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectZeroReference } from "./app-selectors.js";
+import { DEFAULT_TRACKING_QUALITY_OPTIONS, computeCompassAgreement, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeResidualConsensus, computeTrackingQualityReport, createTrackingQualityListenerMiddleware, degradedCountUpdated, firstAgreementReached, matrixDelta, reportUpdated, resetTrackingQuality, selectFirstAgreementObservationIndex, selectRecentAlignments, selectTrackingQuality, snapshotPushed, snapshotsTrimmed, trackingQualityReducer } from "./tracking-quality.js";
+import { createPersistenceMiddleware, slicePrefixOf } from "./persistence-middleware.js";
 import { createSlamAppStore } from "./create-slam-app-store.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 { selectAlignmentMatrix, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectReferencePoints, selectZeroReference } from "./app-selectors.js";
 import { wireStoreSubscribers } from "./store-subscribers.js";
-import { add2dImage, calcRelativeCoordsInMeters, markReferencePoint, recordGpsEvent, setZeroPos } from "gps-plus-slam-js";
-export { DEFAULT_MAX_DELAY_MS, DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, IMAGE_CONSTRAINTS, ReplayEngine, STORAGE_KEY, add2dImage, buildRawGpsPoint, buildRecordGpsEventPayload, calcRelativeCoordsInMeters, captureGpsAnchorSample, cloneRecordingOptions, computeInterActionDelay, createGpsPositionHandler, createPersistenceMiddleware, createSlamAppStore, endSession, eulerToQuaternion, extractActionTimestamp, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, loadRecordingOptions, markReferencePoint, recordDepthSample, recordGpsEvent, recordWriteFailure, recordingReducer, replayRecording, resetCoordinatorState, resetRecordingOptions, saveRecordingOptions, selectAlignmentMatrix, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectReferencePoints, selectZeroReference, setZeroPos, startSession, subscribeToSelector, 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-BkIfpiyA.js";
+export { DEFAULT_MAX_DELAY_MS, DEFAULT_RECORDING_OPTIONS, DEFAULT_TRACKING_QUALITY_OPTIONS, DEPTH_CONSTRAINTS, IMAGE_CONSTRAINTS, ReplayEngine, STORAGE_KEY, add2dImage, buildRawGpsPoint, buildRecordGpsEventPayload, calcRelativeCoordsInMeters, captureGpsAnchorSample, clearLastRestartedPayload, cloneRecordingOptions, computeCompassAgreement, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeInterActionDelay, computeOnboardingGuidance, computeResidualConsensus, computeTrackingQualityReport, createGpsPositionHandler, createPersistenceMiddleware, createSlamAppStore, createTrackingQualityListenerMiddleware, degradedCountUpdated, endSession, eulerToQuaternion, extractActionTimestamp, extractOdomPosition, extractOdomRotation, firstAgreementReached, getLastDeviceOrientation, loadRecordingOptions, matrixDelta, originReset, poseLost, poseReceived, recordDepthSample, recordGpsEvent, recordWriteFailure, recordingReducer, replayRecording, reportUpdated, resetCoordinatorState, resetRecordingOptions, resetTracking, resetTrackingQuality, saveRecordingOptions, selectAlignmentMatrix, selectFirstAgreementObservationIndex, selectFrameTilesInWebXR, selectGpsPositions, selectLastRestartedPayload, selectLastSensorOrientation, selectLastValidPose, selectLostFrameCount, selectOdometryPositions, selectOdometryRotations, selectOnboardingGuidance, selectRecentAlignments, selectTrackingPhase, selectTrackingQuality, selectZeroReference, setZeroPos, slicePrefixOf, snapshotPushed, snapshotsTrimmed, startSession, subscribeToSelector, trackingQualityReducer, trackingReducer, updateDeviceOrientation, validateDepthOptions, validateImageOptions, validateRecordingOptions, wireStoreSubscribers };

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

@@ -1,2 +1,2 @@
-import { n as createPersistenceMiddleware, t as PersistenceMiddlewareOptions } from "../persistence-middleware-z-75iisb.js";
-export { PersistenceMiddlewareOptions, createPersistenceMiddleware };
+import { n as createPersistenceMiddleware, r as slicePrefixOf, t as PersistenceMiddlewareOptions } from "../persistence-middleware-xB5sTllJ.js";
+export { PersistenceMiddlewareOptions, createPersistenceMiddleware, slicePrefixOf };

package/dist/state/persistence-middleware.js

@@ -1,5 +1,5 @@
 import { createLogger } from "../utils/logger.js";
-import { recordWriteFailure } from "./recording-slice.js";
+import { endSession, recordWriteFailure, startSession } from "./recording-slice.js";
 //#region ../src/state/persistence-middleware.ts
 const log = createLogger("PersistenceMiddleware");
 /** Maximum number of concurrent OPFS write operations. */
@@ -27,31 +27,65 @@ var WriteQueue = class {
 	}
 };
 /**
+* Extract the slice prefix from a namespaced Redux action type.
+*
+* `'gpsData/setZeroPos'` → `'gpsData'`. Returns the whole string when there
+* is no slash (e.g. `'@@INIT'`). This is the single point that turns a
+* slice-owned action type into the value the persistence whitelist matches
+* on, so call sites can derive prefixes from real action creators instead of
+* re-typing literals.
+*/
+function slicePrefixOf(actionType) {
+	const slashIndex = actionType.indexOf("/");
+	return slashIndex === -1 ? actionType : actionType.slice(0, slashIndex);
+}
+/** Read `state.recording.isRecording`, defaulting to false for any shape. */
+function readIsRecording(state) {
+	return state?.recording?.isRecording ?? false;
+}
+/**
+* Decide whether the just-reduced action belongs to a session whose actions
+* must be persisted. True while recording, and also for the `endSession`
+* action that just flipped `isRecording` to false (Issue 5) so the session's
+* final action is still captured.
+*
+* The endSession type is derived from the imported action creator
+* (`endSession.type`) rather than a hand-typed literal, so a rename of the
+* recording slice or its actions propagates here automatically instead of
+* silently breaking final-action persistence.
+*/
+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 `gpsData/*` and `recording/*` actions.
+* - Persists actions whose slice prefix is listed in `persistedPrefixes`.
 * - Excludes `recording/recordWriteFailure` to prevent recursive persistence.
-* - Excludes `routing/*`, `refPoints/*`, and any other non-recording actions.
+* - 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 } = options;
+	const { storageBackend, onWriteFailure, persistedPrefixes } = options;
+	const normalizedPrefixes = persistedPrefixes.map((prefix) => prefix.endsWith("/") ? prefix : `${prefix}/`);
+	const excludedActionType = recordWriteFailure.type;
 	let actionIndex = 0;
 	const writeQueue = new WriteQueue();
 	const middleware = (store) => (next) => (action) => {
 		const typedAction = action;
 		const actionType = typeof typedAction.type === "string" ? typedAction.type : null;
-		const wasRecording = store.getState().recording?.isRecording ?? false;
+		const wasRecording = readIsRecording(store.getState());
 		const result = next(action);
 		if (!actionType) return result;
-		if (actionType === "recording/startSession") actionIndex = 0;
-		if (!((store.getState().recording?.isRecording ?? false) || wasRecording && actionType === "recording/endSession")) return result;
-		if (!(actionType.startsWith("gpsData/") || actionType.startsWith("recording/") && actionType !== "recording/recordWriteFailure")) return result;
+		if (actionType === startSession.type) actionIndex = 0;
+		if (!isInPersistableSession(wasRecording, readIsRecording(store.getState()), actionType)) return result;
+		if (!(actionType !== excludedActionType && normalizedPrefixes.some((prefix) => actionType.startsWith(prefix)))) return result;
 		const index = ++actionIndex;
 		writeQueue.enqueue(async () => {
 			try {
@@ -68,4 +102,4 @@ function createPersistenceMiddleware(options) {
 	return middleware;
 }
 //#endregion
-export { createPersistenceMiddleware };
+export { createPersistenceMiddleware, slicePrefixOf };

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

@@ -1,2 +1,2 @@
-import { _ as validateRecordingOptions, a as IMAGE_CONSTRAINTS, c as RecordingOptionsInput, d as loadRecordingOptions, f as resetRecordingOptions, g as validateImageOptions, h as validateDepthOptions, i as DepthCaptureOptions, l as STORAGE_KEY, m as validateArCrashIsolationOptions, n as DEFAULT_RECORDING_OPTIONS, o as ImageCaptureOptions, p as saveRecordingOptions, r as DEPTH_CONSTRAINTS, s as RecordingOptions, t as ArCrashIsolationOptions, u as cloneRecordingOptions } from "../recording-options-BYUFX8iU.js";
+import { _ as validateRecordingOptions, a as IMAGE_CONSTRAINTS, c as RecordingOptionsInput, d as loadRecordingOptions, f as resetRecordingOptions, g as validateImageOptions, h as validateDepthOptions, i as DepthCaptureOptions, l as STORAGE_KEY, m as validateArCrashIsolationOptions, n as DEFAULT_RECORDING_OPTIONS, o as ImageCaptureOptions, p as saveRecordingOptions, r as DEPTH_CONSTRAINTS, s as RecordingOptions, t as ArCrashIsolationOptions, u as cloneRecordingOptions } from "../recording-options-BSFpBSZH.js";
 export { ArCrashIsolationOptions, DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, DepthCaptureOptions, IMAGE_CONSTRAINTS, ImageCaptureOptions, RecordingOptions, RecordingOptionsInput, STORAGE_KEY, cloneRecordingOptions, loadRecordingOptions, resetRecordingOptions, saveRecordingOptions, validateArCrashIsolationOptions, validateDepthOptions, validateImageOptions, validateRecordingOptions };

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

@@ -1,3 +1,3 @@
-import { t as CombinedRootState } from "../combined-root-state-B3SvPNjU.js";
-import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-BFhFs7Mc.js";
+import { L as CombinedRootState } from "../create-slam-app-store-B76AGaI0.js";
+import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-CTL2cUE0.js";
 export { CombinedRootState, ReplayRecordingOptions, replayRecording };

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

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

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

@@ -1,2 +1,2 @@
-import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-B88Va62x.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-B-5GIZtc.js";
 export { CompleteCallback, DEFAULT_MAX_DELAY_MS, ErrorCallback, ProgressCallback, ReplayAction, ReplayEngine, ReplayState, computeInterActionDelay, extractActionTimestamp };

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

@@ -1,3 +1,3 @@
-import { t as SubscribableStore } from "../subscribe-to-selector-ghDKYtap.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-DKKHld49.js";
+import { t as SubscribableStore } from "../subscribe-to-selector--KQpgLXG.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-swlbtg_z.js";
 export { StoreSubscriberDeps, SubscribableStore, wireStoreSubscribers };