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

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

@@ -0,0 +1,2 @@
+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-utCNND8t.js";
+export { DeviceOrientation, PoseReceivedPayload, ResetTransformData, TrackingPhase, TrackingSliceState, clearLastRestartedPayload, originReset, poseLost, poseReceived, resetTracking, selectLastRestartedPayload, selectLastSensorOrientation, selectLastValidPose, selectLostFrameCount, selectTrackingPhase, trackingReducer };

package/dist/state/tracking-slice.js

@@ -0,0 +1,147 @@
+import { createSlice } from "@reduxjs/toolkit";
+//#region ../src/state/tracking-slice.ts
+const initialState = {
+	phase: "initializing",
+	lastValidPose: null,
+	lastSensorOrientation: null,
+	lostFrameCount: 0,
+	originResetDuringLoss: false,
+	resetTransform: void 0,
+	lastRestartedPayload: null
+};
+const trackingSlice = createSlice({
+	name: "tracking",
+	initialState,
+	reducers: {
+		/**
+		* A valid AR pose was received this frame. Drives INITIALIZING|LOST →
+		* TRACKING transitions; on LOST → TRACKING with `originResetDuringLoss`
+		* also populates `lastRestartedPayload` (Case 2 of the manager doc).
+		*/
+		poseReceived(state, action) {
+			const { pose, sensorOrientation } = action.payload;
+			if (state.phase === "lost") {
+				const hadReset = state.originResetDuringLoss;
+				const savedResetTransform = state.resetTransform;
+				state.originResetDuringLoss = false;
+				state.resetTransform = void 0;
+				if (hadReset && state.lastValidPose !== null) {
+					const lastOrientation = state.lastSensorOrientation ?? sensorOrientation;
+					state.lastRestartedPayload = {
+						lastValidOdomPos: [
+							state.lastValidPose.position.x,
+							state.lastValidPose.position.y,
+							state.lastValidPose.position.z
+						],
+						lastValidOdomRot: [
+							state.lastValidPose.orientation.x,
+							state.lastValidPose.orientation.y,
+							state.lastValidPose.orientation.z,
+							state.lastValidPose.orientation.w
+						],
+						lastSensorOrientation: {
+							alpha: lastOrientation.alpha,
+							beta: lastOrientation.beta,
+							gamma: lastOrientation.gamma,
+							absolute: lastOrientation.absolute
+						},
+						newOdomRot: [
+							pose.orientation.x,
+							pose.orientation.y,
+							pose.orientation.z,
+							pose.orientation.w
+						],
+						newSensorOrientation: {
+							alpha: sensorOrientation.alpha,
+							beta: sensorOrientation.beta,
+							gamma: sensorOrientation.gamma,
+							absolute: sensorOrientation.absolute
+						},
+						newOdomPos: [
+							pose.position.x,
+							pose.position.y,
+							pose.position.z
+						],
+						resetTransform: savedResetTransform
+					};
+				}
+			}
+			state.phase = "tracking";
+			state.lastValidPose = pose;
+			state.lastSensorOrientation = sensorOrientation;
+			state.lostFrameCount = 0;
+		},
+		/**
+		* Pose was unavailable this frame. TRACKING → LOST on the first call;
+		* subsequent calls only bump `lostFrameCount`.
+		*/
+		poseLost(state) {
+			state.lostFrameCount += 1;
+			if (state.phase === "tracking") state.phase = "lost";
+		},
+		/**
+		* `XRReferenceSpace` reset event fired. Only meaningful while LOST.
+		* The payload distinguishes three cases:
+		*   - `ResetTransformData` — runtime supplied the transform.
+		*   - `null` — runtime could not determine the delta.
+		*   - `undefined` (action with no payload) — backwards compat for
+		*     callers without an event reference.
+		*/
+		originReset: {
+			reducer(state, action) {
+				if (state.phase !== "lost") return state;
+				return {
+					...state,
+					originResetDuringLoss: true,
+					resetTransform: action.payload
+				};
+			},
+			prepare(transform) {
+				return { payload: transform };
+			}
+		},
+		/**
+		* Drops the manager back to its initial state. Host calls on new XR
+		* session start.
+		*/
+		resetTracking() {
+			return initialState;
+		},
+		/**
+		* Host calls this after firing its `onTrackingRestarted` callback with
+		* the contents of `selectLastRestartedPayload`. Failure to call it would
+		* leave a stale payload; the test matrix locks this in.
+		*/
+		clearLastRestartedPayload(state) {
+			state.lastRestartedPayload = null;
+		}
+	}
+});
+const { poseReceived, poseLost, originReset, resetTracking, clearLastRestartedPayload } = trackingSlice.actions;
+const trackingReducer = trackingSlice.reducer;
+function selectTrackingPhase(state) {
+	return state.tracking.phase;
+}
+function selectLastValidPose(state) {
+	return state.tracking.lastValidPose;
+}
+function selectLostFrameCount(state) {
+	return state.tracking.lostFrameCount;
+}
+function selectLastRestartedPayload(state) {
+	return state.tracking.lastRestartedPayload;
+}
+/**
+* Selector for the last `DeviceOrientation` captured alongside a valid
+* AR pose. Used by the §4.3 compass / alignment heading cross-check in
+* the tracking-quality reporter (see
+* docs/2026-05-16-tracking-quality-metrics-plan.md).
+*
+* Returns `null` before any pose has been received and after
+* `resetTracking` clears the slice.
+*/
+function selectLastSensorOrientation(state) {
+	return state.tracking.lastSensorOrientation;
+}
+//#endregion
+export { clearLastRestartedPayload, originReset, poseLost, poseReceived, resetTracking, selectLastRestartedPayload, selectLastSensorOrientation, selectLastValidPose, selectLostFrameCount, selectTrackingPhase, trackingReducer };

package/dist/storage/file-system-utils.d.ts

@@ -1,2 +1,2 @@
-import { n as formatFrameFilename, r as formatTimestamp, t as formatActionFilename } from "../file-system-utils-BH8FdyIu.js";
+import { n as formatFrameFilename, r as formatTimestamp, t as formatActionFilename } from "../file-system-utils-CtKiiw27.js";
 export { formatActionFilename, formatFrameFilename, formatTimestamp };

package/dist/storage/file-system.d.ts

@@ -1,2 +1,2 @@
-import { a as listSessions, c as setCurrentScenario, d as writeAction, f as writeFrame, i as initStorage, l as startSession, n as ensureScenarioDirectory, o as resetForNewSession, p as writeSessionMetadata, r as getCurrentScenarioHandle, s as resetStorageState, t as WriteAccessResult, u as verifyWriteAccess } from "../file-system-DD5TczSO.js";
-export { WriteAccessResult, ensureScenarioDirectory, getCurrentScenarioHandle, initStorage, listSessions, resetForNewSession, resetStorageState, setCurrentScenario, startSession, verifyWriteAccess, writeAction, writeFrame, writeSessionMetadata };
+import { a as getCurrentScenarioHandle, c as resetForNewSession, d as startSession, f as verifyWriteAccess, h as writeSessionMetadata, i as ensureScenarioDirectory, l as resetStorageState, m as writeFrame, n as WriteAccessResult, o as initStorage, p as writeAction, r as clearRefPointsCacheForAllScenarios, s as listSessions, t as ClearRefPointsCacheResult, u as setCurrentScenario } from "../file-system-DTApEv_Q.js";
+export { ClearRefPointsCacheResult, WriteAccessResult, clearRefPointsCacheForAllScenarios, ensureScenarioDirectory, getCurrentScenarioHandle, initStorage, listSessions, resetForNewSession, resetStorageState, setCurrentScenario, startSession, verifyWriteAccess, writeAction, writeFrame, writeSessionMetadata };

package/dist/storage/file-system.js

@@ -234,5 +234,56 @@ async function ensureScenarioDirectory(scenarioName) {
 		return null;
 	}
 }
+/**
+* Clear the cached `refPoints/` directory for every scenario in OPFS.
+*
+* Used by the "Clear Reference Point Cache" maintenance action so that the
+* next scenario load re-imports ref points from the read folder's `*.zip`
+* recordings (see ref-point-recovery in the recorder app).
+*
+* Failures for individual scenarios are collected in `errors` rather than
+* aborting the whole operation — partial progress is still useful.
+*
+* @throws Error if OPFS storage is unavailable (e.g. `initStorage()` not yet
+*   called, or browser does not support OPFS). Surfacing this loudly avoids
+*   reporting a silent "0 scenarios cleared" success that would mask the
+*   real failure to the user.
+*/
+async function clearRefPointsCacheForAllScenarios() {
+	const dir = await ensureScenariosDir();
+	if (!dir) throw new Error("clearRefPointsCacheForAllScenarios: OPFS scenarios directory is unavailable — call initStorage() first or check OPFS support");
+	const errors = [];
+	let scenariosCleared = 0;
+	let scenariosScanned = 0;
+	const scenarios = await listScenarios();
+	for (const scenarioName of scenarios) {
+		scenariosScanned++;
+		try {
+			const handle = await dir.getDirectoryHandle(scenarioName);
+			if (!handle) continue;
+			try {
+				await handle.removeEntry("refPoints", { recursive: true });
+				scenariosCleared++;
+			} catch (err) {
+				if ((err instanceof Error ? err.name : String(err?.name)) === "NotFoundError") continue;
+				errors.push({
+					scenarioName,
+					reason: err instanceof Error ? err.message : String(err)
+				});
+			}
+		} catch (err) {
+			errors.push({
+				scenarioName,
+				reason: err instanceof Error ? err.message : String(err)
+			});
+		}
+	}
+	log.info(`Cleared ref-point cache for ${scenariosCleared}/${scenariosScanned} scenarios (${errors.length} errors)`);
+	return {
+		scenariosCleared,
+		scenariosScanned,
+		errors
+	};
+}
 //#endregion
-export { ensureScenarioDirectory, getCurrentScenarioHandle, initStorage, listSessions, resetForNewSession, resetStorageState, setCurrentScenario, startSession, verifyWriteAccess, writeAction, writeFrame, writeSessionMetadata };
+export { clearRefPointsCacheForAllScenarios, ensureScenarioDirectory, getCurrentScenarioHandle, initStorage, listSessions, resetForNewSession, resetStorageState, setCurrentScenario, startSession, verifyWriteAccess, writeAction, writeFrame, writeSessionMetadata };

package/dist/storage/index.d.ts

@@ -1,9 +1,9 @@
-import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, h as writeSessionMetadata$1, i as createSession, l as listSessions, n as SessionMetadata, o as getSessionHandle, r as checkStorageQuota, s as getSessionsRootHandle, u as resetOpfsStorage } from "../opfs-storage-Dlq1I_Gb.js";
-import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-yVnuWGTr.js";
-import { a as ZipActionEntry, c as loadEntriesFromSubdir, d as loadSessionMetadataFromBlob, f as readZipEntries, i as RecordedAction, l as loadGpsPathFromBlob, n as GpsPathCoord, o as ZipSubdirEntry, r as MAX_ACTION_FILE_SIZE, s as loadActionsFromZip, t as Entry, u as loadSessionMetadata } from "../zip-reader-KgJEXbca.js";
-import { t as NullStorageBackend } from "../null-storage-backend-C0TiwwzQ.js";
-import { t as OpfsStorageBackend } from "../opfs-storage-backend-Gt3rd76D.js";
-import { a as listSessions$1, c as setCurrentScenario, d as writeAction, f as writeFrame, i as initStorage, l as startSession, n as ensureScenarioDirectory, o as resetForNewSession, p as writeSessionMetadata, r as getCurrentScenarioHandle, s as resetStorageState, t as WriteAccessResult, u as verifyWriteAccess } from "../file-system-DD5TczSO.js";
-import { n as formatFrameFilename, r as formatTimestamp, t as formatActionFilename } from "../file-system-utils-BH8FdyIu.js";
-import { a as downloadZip, c as syncToExternalZip, i as ZipExportResult, n as ZipContributorAddFile, o as exportAndDownloadSession, r as ZipExportContributor, s as exportSessionAsZip, t as ExportSessionAsZipOptions } from "../zip-export-BjrQPv0X.js";
+import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, h as writeSessionMetadata$1, i as createSession, l as listSessions, n as SessionMetadata, o as getSessionHandle, r as checkStorageQuota, s as getSessionsRootHandle, u as resetOpfsStorage } from "../opfs-storage-DOPkzgeT.js";
+import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-CT0Il_AB.js";
+import { a as ZipActionEntry, c as loadEntriesFromSubdir, d as loadSessionMetadataFromBlob, f as readZipEntries, i as RecordedAction, l as loadGpsPathFromBlob, n as GpsPathCoord, o as ZipSubdirEntry, r as MAX_ACTION_FILE_SIZE, s as loadActionsFromZip, t as Entry, u as loadSessionMetadata } from "../zip-reader-D1105idz.js";
+import { t as NullStorageBackend } from "../null-storage-backend-BKOS7JpL.js";
+import { t as OpfsStorageBackend } from "../opfs-storage-backend-Cj_7PWoq.js";
+import { a as getCurrentScenarioHandle, c as resetForNewSession, d as startSession, f as verifyWriteAccess, h as writeSessionMetadata, i as ensureScenarioDirectory, l as resetStorageState, m as writeFrame, n as WriteAccessResult, o as initStorage, p as writeAction, s as listSessions$1, u as setCurrentScenario } from "../file-system-DTApEv_Q.js";
+import { n as formatFrameFilename, r as formatTimestamp, t as formatActionFilename } from "../file-system-utils-CtKiiw27.js";
+import { a as downloadZip, c as syncToExternalZip, i as ZipExportResult, n as ZipContributorAddFile, o as exportAndDownloadSession, r as ZipExportContributor, s as exportSessionAsZip, t as ExportSessionAsZipOptions } from "../zip-export-QO4iLIi7.js";
 export { type CreateSessionResult, type Entry, type ExportSessionAsZipOptions, type GpsPathCoord, MAX_ACTION_FILE_SIZE, NullStorageBackend, OpfsStorageBackend, type RecordedAction, type SessionMetadata, type StorageBackend, type WriteAccessResult, type ZipActionEntry, type ZipContributorAddFile, type ZipExportContributor, type ZipExportResult, type ZipSubdirEntry, checkStorageQuota, createSession, downloadZip, ensureScenarioDirectory, exportAndDownloadSession, exportSessionAsZip, formatActionFilename, formatFrameFilename, formatTimestamp, getAppRootHandle, getCurrentScenarioHandle, getSessionHandle, getSessionsRootHandle, initOpfsStorage, initStorage, listSessions, listSessions$1 as listSessionsFromFileSystem, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadataFromBlob, loadSessionMetadata as loadSessionMetadataFromZip, readZipEntries, resetForNewSession, resetOpfsStorage, resetSessionHandles, resetStorageState, setCurrentScenario, startSession as startStorageSession, syncToExternalZip, verifyWriteAccess, writeAction, writeFrame, writeSessionMetadata as writeSessionMeta, writeSessionMetadata$1 as writeSessionMetadata };

package/dist/storage/null-storage-backend.d.ts

@@ -1,2 +1,2 @@
-import { t as NullStorageBackend } from "../null-storage-backend-C0TiwwzQ.js";
+import { t as NullStorageBackend } from "../null-storage-backend-BKOS7JpL.js";
 export { NullStorageBackend };

package/dist/storage/opfs-storage-backend.d.ts

@@ -1,2 +1,2 @@
-import { t as OpfsStorageBackend } from "../opfs-storage-backend-Gt3rd76D.js";
+import { t as OpfsStorageBackend } from "../opfs-storage-backend-Cj_7PWoq.js";
 export { OpfsStorageBackend };

package/dist/storage/opfs-storage.d.ts

@@ -1,2 +1,2 @@
-import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, f as setSessionHandles, h as writeSessionMetadata, i as createSession, l as listSessions, m as writeFrame, n as SessionMetadata, o as getSessionHandle, p as writeAction, r as checkStorageQuota, s as getSessionsRootHandle, t as CreateSessionResult, u as resetOpfsStorage } from "../opfs-storage-Dlq1I_Gb.js";
+import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, f as setSessionHandles, h as writeSessionMetadata, i as createSession, l as listSessions, m as writeFrame, n as SessionMetadata, o as getSessionHandle, p as writeAction, r as checkStorageQuota, s as getSessionsRootHandle, t as CreateSessionResult, u as resetOpfsStorage } from "../opfs-storage-DOPkzgeT.js";
 export { CreateSessionResult, SessionMetadata, checkStorageQuota, createSession, getAppRootHandle, getSessionHandle, getSessionsRootHandle, initOpfsStorage, listSessions, resetOpfsStorage, resetSessionHandles, setSessionHandles, writeAction, writeFrame, writeSessionMetadata };

package/dist/storage/storage-backend.d.ts

@@ -1,2 +1,2 @@
-import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-yVnuWGTr.js";
+import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-CT0Il_AB.js";
 export { CreateSessionResult, StorageBackend };

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

@@ -1,2 +1,2 @@
-import { a as downloadZip, c as syncToExternalZip, i as ZipExportResult, n as ZipContributorAddFile, o as exportAndDownloadSession, r as ZipExportContributor, s as exportSessionAsZip, t as ExportSessionAsZipOptions } from "../zip-export-BjrQPv0X.js";
+import { a as downloadZip, c as syncToExternalZip, i as ZipExportResult, n as ZipContributorAddFile, o as exportAndDownloadSession, r as ZipExportContributor, s as exportSessionAsZip, t as ExportSessionAsZipOptions } from "../zip-export-QO4iLIi7.js";
 export { ExportSessionAsZipOptions, ZipContributorAddFile, ZipExportContributor, ZipExportResult, downloadZip, exportAndDownloadSession, exportSessionAsZip, syncToExternalZip };

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

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

package/dist/storage/zip-reader.js

@@ -172,10 +172,14 @@ async function loadGpsPathFromBlob(blob, maxFileSize = MAX_ACTION_FILE_SIZE) {
 				continue;
 			}
 			const gps = action.payload?.rawGpsPoint ?? action.payload?.gpsPoint;
-			if (action.type === "gpsData/recordGpsEvent" && gps && typeof gps.latitude === "number" && typeof gps.longitude === "number") coords.push({
-				lat: gps.latitude,
-				lng: gps.longitude
-			});
+			if (action.type === "gpsData/recordGpsEvent" && gps && typeof gps.latitude === "number" && typeof gps.longitude === "number") {
+				const accuracy = typeof gps.latLongAccuracy === "number" && gps.latLongAccuracy > 0 ? gps.latLongAccuracy : void 0;
+				coords.push({
+					lat: gps.latitude,
+					lng: gps.longitude,
+					...accuracy !== void 0 ? { accuracy } : {}
+				});
+			}
 		}
 		return coords;
 	} catch {

package/dist/{storage-backend-yVnuWGTr.d.ts → storage-backend-CT0Il_AB.d.ts}

@@ -1,4 +1,4 @@
-import { n as SessionMetadata } from "./opfs-storage-Dlq1I_Gb.js";
+import { n as SessionMetadata } from "./opfs-storage-DOPkzgeT.js";
 
 //#region ../src/storage/storage-backend.d.ts
 interface CreateSessionResult {

package/dist/{store-subscribers-DKKHld49.d.ts → store-subscribers-Dce_CoJF.d.ts}

@@ -1,4 +1,5 @@
-import { t as SubscribableStore } from "./subscribe-to-selector-ghDKYtap.js";
+import { t as MapData } from "./map-data-sih4g64v.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-DIHm3BRZ.js";
 import { LatLong, Matrix4, Quaternion, Vector3 } from "gps-plus-slam-js";
 
 //#region ../src/state/store-subscribers.d.ts
@@ -13,15 +14,28 @@ interface StoreSubscriberDeps {
   gpsEventVisualizer: {
     getZeroRef: () => LatLong | null;
     setZeroRef: (zero: LatLong) => void;
-    addGpsEvent: (gpsCoords: Vector3, odomPosition: Vector3) => void;
+    addGpsEvent: (gpsCoords: Vector3, odomPosition: Vector3, accuracy?: {
+      horizontal?: number;
+      vertical?: number;
+    }) => void;
     addAlignmentSnapshot: (nuePosition: Vector3) => void;
   };
-  /** Map overlay — updates the 2D map position. Nullable (not present in all modes). */
+  /**
+   * Map overlay — renders the shared trajectory snapshot. Nullable (not
+   * present in all modes).
+   *
+   * `setGpsPosition` centers the map on the latest fix; `render` draws the
+   * full {@link MapData} snapshot (raw GPS + accuracy circles, fused path,
+   * alignment snapshots, user dot) via the shared `drawMapData` routine — the
+   * SAME one the 2D session-summary map uses, so the live and summary maps
+   * stay identical (unified-trajectory-map Phase 3). The previous incremental
+   * `addRawGpsPoint` / `addFusedPoint` / `addAlignmentSnapshot` API is gone:
+   * the fused path now recomputes from the latest matrix on every rebuild
+   * (D2), so the live polyline "snaps" as alignment improves.
+   */
   mapOverlay?: {
     setGpsPosition: (lat: number, lon: number) => void;
-    addRawGpsPoint?: (lat: number, lon: number) => void;
-    addFusedPoint?: (lat: number, lon: number) => void;
-    addAlignmentSnapshot?: (lat: number, lon: number) => void;
+    render?: (data: MapData) => void;
   } | null;
   /**
    * Optional callback invoked with the GPS world-space coordinates of each
@@ -51,6 +65,17 @@ interface StoreSubscriberDeps {
    * for dynamic button label updates.
    */
   onNewGpsLatLng?: (lat: number, lng: number) => void;
+  /**
+   * When `true`, the recorded GPS 1σ accuracies (`latLongAccuracy`,
+   * `altitudeAccuracy`) on each `GpsPoint` are forwarded to `addGpsEvent`
+   * so the raw-GPS marker renders as a non-uniform-scaled ellipsoid (see
+   * `gps-event-markers.ts` §3). When `false` (the default) the accuracies
+   * are dropped and the legacy fixed 8 cm sphere is used.
+   *
+   * Live recording leaves this `false` (large ellipsoids would distract the
+   * operator). Replay mode sets it to `true` so the diagnostic is visible.
+   */
+  showAccuracySpheres?: boolean;
 }
 /**
  * Wire store state-change subscriptions to visualization dependencies.

package/dist/{subscribe-to-selector-ghDKYtap.d.ts → subscribe-to-selector-DIHm3BRZ.d.ts}

@@ -1,4 +1,4 @@
-import { t as CombinedRootState } from "./combined-root-state-B3SvPNjU.js";
+import { L as CombinedRootState } from "./create-slam-app-store-CNsZ3rcX.js";
 
 //#region ../src/state/subscribe-to-selector.d.ts
 /**

package/dist/test-utils/browser-mocks.d.ts

@@ -1,4 +1,4 @@
-import { a as WebXRQuaternion, o as WebXRVec3 } from "../ar-types-B-ORgk6Z.js";
+import { a as WebXRQuaternion, o as WebXRVec3 } from "../ar-types-Ck8LEq8k.js";
 import { Mock } from "vitest";
 
 //#region ../src/test-utils/browser-mocks.d.ts

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

@@ -1,4 +1,4 @@
-import { i as RecordedAction } from "../zip-reader-KgJEXbca.js";
+import { i as RecordedAction } from "../zip-reader-D1105idz.js";
 import { LatLong } from "gps-plus-slam-js";
 
 //#region ../src/test-utils/zip-round-trip-helpers.d.ts
@@ -12,6 +12,12 @@ interface ProduceTestZipOptions {
   frameCount: number;
   deviceInfo: string;
   zeroPos: LatLong;
+  /**
+   * Optional horizontal accuracy (meters) stamped onto every produced
+   * `recordGpsEvent` action's `rawGpsPoint.latLongAccuracy`. When omitted,
+   * the field is left off — matching pre-accuracy recordings.
+   */
+  gpsAccuracy?: number;
 }
 /** Result of producing a test zip, with all metadata needed for assertions. */
 interface TestZipResult {

package/dist/test-utils/zip-round-trip-helpers.js

@@ -131,7 +131,8 @@ async function produceTestZip(opts) {
 						id: `gps-event-${i + 1}`,
 						latitude: options.zeroPos.lat + (i + 1) * 1e-4,
 						longitude: options.zeroPos.lon + (i + 1) * 1e-4,
-						timestamp: t
+						timestamp: t,
+						...typeof options.gpsAccuracy === "number" ? { latLongAccuracy: options.gpsAccuracy } : {}
 					}
 				}
 			});

package/dist/tracking-slice-utCNND8t.d.ts

@@ -0,0 +1,86 @@
+import { t as ARPose } from "./ar-types-Ck8LEq8k.js";
+import { OdometryTrackingRestartedPayload, Quaternion, Vector3 } from "gps-plus-slam-js";
+import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
+
+//#region ../src/state/tracking-slice.d.ts
+/**
+ * AR tracking phase. String-literal union (not a TS enum) so action payloads
+ * and replay JSON stay structurally compatible with non-TS consumers.
+ */
+type TrackingPhase = 'initializing' | 'tracking' | 'lost';
+/**
+ * Raw `DeviceOrientationEvent` snapshot captured alongside an AR pose.
+ *
+ * Identical shape to `RawDeviceOrientation` from `gps-plus-slam-js`, but
+ * with non-nullable fields — sensors are required to have resolved for the
+ * AR math that consumes this snapshot.
+ */
+interface DeviceOrientation {
+  /** Compass heading (0–360). */
+  alpha: number;
+  /** Pitch (-180 to 180). */
+  beta: number;
+  /** Roll (-90 to 90). */
+  gamma: number;
+  /** Whether alpha is relative to magnetic north. */
+  absolute: boolean;
+}
+/**
+ * Serialized `XRReferenceSpaceEvent.transform`.
+ *
+ * `null` when the XR runtime cannot determine the delta between old and new
+ * coordinate systems; `undefined` when no transform was captured (older
+ * browsers / no event).
+ */
+interface ResetTransformData {
+  position: Vector3;
+  orientation: Quaternion;
+}
+interface TrackingSliceState {
+  phase: TrackingPhase;
+  lastValidPose: ARPose | null;
+  lastSensorOrientation: DeviceOrientation | null;
+  lostFrameCount: number;
+  originResetDuringLoss: boolean;
+  /**
+   * Distinguishes "reset flagged with no transform yet" from "no reset flagged".
+   * `undefined` is the default; once `originReset(...)` is dispatched the value
+   * is the supplied transform (which may itself be `null`).
+   */
+  resetTransform: ResetTransformData | null | undefined;
+  /**
+   * Transient payload set by the LOST → TRACKING transition when an origin
+   * reset was flagged during the loss. Host consumes it via the matching
+   * selector and then dispatches `clearLastRestartedPayload`.
+   */
+  lastRestartedPayload: OdometryTrackingRestartedPayload | null;
+}
+interface PoseReceivedPayload {
+  pose: ARPose;
+  sensorOrientation: DeviceOrientation;
+}
+declare const poseReceived: _$_reduxjs_toolkit0.ActionCreatorWithPayload<PoseReceivedPayload, "tracking/poseReceived">, poseLost: _$_reduxjs_toolkit0.ActionCreatorWithoutPayload<"tracking/poseLost">, originReset: _$_reduxjs_toolkit0.ActionCreatorWithPreparedPayload<[transform?: ResetTransformData | null | undefined], ResetTransformData | null | undefined, "tracking/originReset", never, never>, resetTracking: _$_reduxjs_toolkit0.ActionCreatorWithoutPayload<"tracking/resetTracking">, clearLastRestartedPayload: _$_reduxjs_toolkit0.ActionCreatorWithoutPayload<"tracking/clearLastRestartedPayload">;
+declare const trackingReducer: _$_reduxjs_toolkit0.Reducer<TrackingSliceState>;
+/**
+ * Minimal root-state shape needed by the selectors. Avoids a hard import
+ * cycle through `SlamAppRootState`.
+ */
+interface RootWithTracking {
+  tracking: TrackingSliceState;
+}
+declare function selectTrackingPhase(state: RootWithTracking): TrackingPhase;
+declare function selectLastValidPose(state: RootWithTracking): ARPose | null;
+declare function selectLostFrameCount(state: RootWithTracking): number;
+declare function selectLastRestartedPayload(state: RootWithTracking): OdometryTrackingRestartedPayload | null;
+/**
+ * Selector for the last `DeviceOrientation` captured alongside a valid
+ * AR pose. Used by the §4.3 compass / alignment heading cross-check in
+ * the tracking-quality reporter (see
+ * docs/2026-05-16-tracking-quality-metrics-plan.md).
+ *
+ * Returns `null` before any pose has been received and after
+ * `resetTracking` clears the slice.
+ */
+declare function selectLastSensorOrientation(state: RootWithTracking): DeviceOrientation | null;
+//#endregion
+export { TrackingSliceState as a, poseLost as c, selectLastRestartedPayload as d, selectLastSensorOrientation as f, trackingReducer as g, selectTrackingPhase as h, TrackingPhase as i, poseReceived as l, selectLostFrameCount as m, PoseReceivedPayload as n, clearLastRestartedPayload as o, selectLastValidPose as p, ResetTransformData as r, originReset as s, DeviceOrientation as t, resetTracking as u };

package/dist/types/ar-types.d.ts

@@ -1,2 +1,2 @@
-import { a as WebXRQuaternion, i as DepthSample, n as ArPoseTuples, o as WebXRVec3, r as DepthPoint, t as ARPose } from "../ar-types-B-ORgk6Z.js";
+import { a as WebXRQuaternion, i as DepthSample, n as ArPoseTuples, o as WebXRVec3, r as DepthPoint, t as ARPose } from "../ar-types-Ck8LEq8k.js";
 export { ARPose, ArPoseTuples, DepthPoint, DepthSample, WebXRQuaternion, WebXRVec3 };

package/dist/types/geo-types.d.ts

@@ -1,2 +1,2 @@
-import { n as RefPointMarker, t as GpsCoord } from "../geo-types-Xx-LVcnw.js";
-export { GpsCoord, RefPointMarker };
+import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-CTuF23gG.js";
+export { GpsCoord, RawGpsSample, RefPointMarker };

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
-import { a as WebXRQuaternion, i as DepthSample, n as ArPoseTuples, o as WebXRVec3, r as DepthPoint, t as ARPose } from "../ar-types-B-ORgk6Z.js";
-import { n as RefPointMarker, t as GpsCoord } from "../geo-types-Xx-LVcnw.js";
-export { ARPose, ArPoseTuples, DepthPoint, DepthSample, GpsCoord, RefPointMarker, WebXRQuaternion, WebXRVec3 };
+import { a as WebXRQuaternion, i as DepthSample, n as ArPoseTuples, o as WebXRVec3, r as DepthPoint, t as ARPose } from "../ar-types-Ck8LEq8k.js";
+import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-CTuF23gG.js";
+export { ARPose, ArPoseTuples, DepthPoint, DepthSample, GpsCoord, RawGpsSample, RefPointMarker, WebXRQuaternion, WebXRVec3 };

package/dist/utils/concurrency.d.ts

@@ -1,2 +1,2 @@
-import { t as mapWithConcurrencyLimit } from "../concurrency-p6gB30fT.js";
+import { t as mapWithConcurrencyLimit } from "../concurrency-CMw8pSaG.js";
 export { mapWithConcurrencyLimit };

package/dist/utils/failure-tracker.d.ts

@@ -1,2 +1,2 @@
-import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-1sQ_Cgyw.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-DnHXOIRa.js";
 export { FailureTracker, FailureTrackerConfig, createFailureTracker };

package/dist/utils/format-file-size.d.ts

@@ -1,2 +1,2 @@
-import { t as formatFileSize } from "../format-file-size-onGq0k1Q.js";
+import { t as formatFileSize } from "../format-file-size-BTS5H62-.js";
 export { formatFileSize };

package/dist/utils/fused-path.d.ts

@@ -1,2 +1,2 @@
-import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-DtqCSqJh.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-CB4DwWOG.js";
 export { FusedPathInput, computeFusedPath, fusedGpsFromOdom };

package/dist/utils/index.d.ts

@@ -1,7 +1,7 @@
-import { a as createLogger, c as setGlobalLogLevel, i as clearLogBuffer, l as subscribeToLogs, n as LogLevel, o as getGlobalLogLevel, r as Logger, s as getLogBuffer, t as LogEntry } from "../logger-B81iwxx0.js";
-import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-DtqCSqJh.js";
-import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-1sQ_Cgyw.js";
-import { t as mapWithConcurrencyLimit } from "../concurrency-p6gB30fT.js";
-import { t as formatFileSize } from "../format-file-size-onGq0k1Q.js";
-import { t as listFormatter } from "../list-formatter-DKQQVLcl.js";
+import { a as createLogger, c as setGlobalLogLevel, i as clearLogBuffer, l as subscribeToLogs, n as LogLevel, o as getGlobalLogLevel, r as Logger, s as getLogBuffer, t as LogEntry } from "../logger-C9vugiQb.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-CB4DwWOG.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-DnHXOIRa.js";
+import { t as mapWithConcurrencyLimit } from "../concurrency-CMw8pSaG.js";
+import { t as formatFileSize } from "../format-file-size-BTS5H62-.js";
+import { t as listFormatter } from "../list-formatter-CNqi-E2j.js";
 export { type FailureTracker, type FailureTrackerConfig, type FusedPathInput, type LogEntry, LogLevel, type Logger, clearLogBuffer, computeFusedPath, createFailureTracker, createLogger, formatFileSize, fusedGpsFromOdom, getGlobalLogLevel, getLogBuffer, listFormatter, mapWithConcurrencyLimit, setGlobalLogLevel, subscribeToLogs };

package/dist/utils/list-formatter.d.ts

@@ -1,2 +1,2 @@
-import { t as listFormatter } from "../list-formatter-DKQQVLcl.js";
+import { t as listFormatter } from "../list-formatter-CNqi-E2j.js";
 export { listFormatter };

package/dist/utils/logger.d.ts

@@ -1,2 +1,2 @@
-import { a as createLogger, c as setGlobalLogLevel, i as clearLogBuffer, l as subscribeToLogs, n as LogLevel, o as getGlobalLogLevel, r as Logger, s as getLogBuffer, t as LogEntry } from "../logger-B81iwxx0.js";
+import { a as createLogger, c as setGlobalLogLevel, i as clearLogBuffer, l as subscribeToLogs, n as LogLevel, o as getGlobalLogLevel, r as Logger, s as getLogBuffer, t as LogEntry } from "../logger-C9vugiQb.js";
 export { LogEntry, LogLevel, Logger, clearLogBuffer, createLogger, getGlobalLogLevel, getLogBuffer, setGlobalLogLevel, subscribeToLogs };