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

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

@@ -0,0 +1,88 @@
+import { r as OccupancyGrid } from "../occupancy-grid-DKzIdCSZ.js";
+import { i as SlamAppStore } from "../create-slam-app-store-HNe1PBtx.js";
+import { a as ReplayAction, s as ReplayState } from "../replay-engine-D-cbT0Fw.js";
+import { i as OcclusionMesh } from "../occlusion-mesh-BY2aMej3.js";
+import { t as OccupancyCubesVisualizer } from "../occupancy-cubes-visualizer-soN0Sizd.js";
+import * as THREE from "three";
+
+//#region ../src/state/replay-session.d.ts
+/** Occupancy-reconstruction options for a replay session. */
+interface ReplayOccupancyConfig {
+  /** Build the occupancy grid + visualizers at all. Default `true`. */
+  readonly enabled?: boolean;
+  /** Voxel edge length in metres. Default 0.15. */
+  readonly cellSizeM?: number;
+  /** Minimum observations before a cell is drawn (noise filter). Default 1. */
+  readonly minObservations?: number;
+  /** Show the instanced debug cubes. Default `true`. */
+  readonly showCubes?: boolean;
+  /**
+   * Build the depth-only occlusion mesh (detailed style). Default `true`. Its
+   * visible skin starts `off` (invisible depth-only); a consumer flips it via
+   * {@link ReplaySessionController.getOcclusionMesh}`.setDebugStyle(...)`.
+   */
+  readonly showOcclusionMesh?: boolean;
+  /** Minimum delay between two visualizer refreshes (ms). Default 250. */
+  readonly refreshIntervalMs?: number;
+}
+interface StartReplaySessionOptions {
+  /** The already-loaded recorded action list to replay. */
+  readonly actions: ReplayAction[];
+  /** DOM element that receives the desktop replay canvas. */
+  readonly container: HTMLElement;
+  /**
+   * Store to replay into. Defaults to a fresh framework store with no
+   * persistence (`NullStorageBackend`). Inject one only to add app-specific
+   * slices; it MUST carry the framework recording slice.
+   */
+  readonly store?: SlamAppStore;
+  /** Occupancy reconstruction config (see {@link ReplayOccupancyConfig}). */
+  readonly occupancy?: ReplayOccupancyConfig;
+  /** Called after each action dispatch: (current, total). */
+  readonly onProgress?: (current: number, total: number) => void;
+  /** Called when all actions have been dispatched. */
+  readonly onComplete?: () => void;
+  /** Called when a dispatch throws: (actionIndex, error). */
+  readonly onError?: (actionIndex: number, error: Error) => void;
+}
+/** Handles to the replay scene graph (for adding consumer content). */
+interface ReplaySceneHandles {
+  readonly scene: THREE.Scene;
+  readonly arWorldGroup: THREE.Group;
+  readonly arpose: THREE.Object3D;
+  readonly camera: THREE.PerspectiveCamera;
+  readonly renderer: THREE.WebGLRenderer;
+}
+interface ReplaySessionController {
+  /** Start dispatching actions at the given speed factor (default 1). */
+  play(speedFactor?: number): Promise<void>;
+  /** Pause the replay. */
+  pause(): void;
+  /** Resume from where we paused. */
+  resume(): Promise<void>;
+  /** Change playback speed (takes effect on the next delay). */
+  setSpeed(factor: number): void;
+  /** Current engine state. */
+  getState(): ReplayState;
+  /** The replay store (same instance the subscribers observe). */
+  getStore(): SlamAppStore;
+  /** The replay scene graph handles. */
+  getScene(): ReplaySceneHandles;
+  /** The reconstructed occupancy grid, or `null` when occupancy is disabled. */
+  getOccupancyGrid(): OccupancyGrid | null;
+  /** The cube visualizer, or `null` when disabled/not built (for a live mesh-view toggle). */
+  getCubesVisualizer(): OccupancyCubesVisualizer | null;
+  /** The occlusion mesh, or `null` when disabled/not built. */
+  getOcclusionMesh(): OcclusionMesh | null;
+  /** Total number of loaded actions. */
+  getActionCount(): number;
+  /** Tear down engine, subscribers, visualizers and the scene. */
+  dispose(): void;
+}
+/**
+ * Compose and start a desktop replay session. Synchronous — the caller drives
+ * playback via the returned controller.
+ */
+declare function startReplaySession(options: StartReplaySessionOptions): ReplaySessionController;
+//#endregion
+export { ReplayOccupancyConfig, ReplaySceneHandles, ReplaySessionController, StartReplaySessionOptions, startReplaySession };

package/dist/state/replay-session.js

@@ -0,0 +1,165 @@
+import { createLogger } from "../utils/logger.js";
+import { b as nuePositionToWebXR, x as nueQuaternionToWebXR } from "../webxr-session-BBlgzrqY.js";
+import { OccupancyGrid } from "../ar/occupancy-grid.js";
+import { disposeReplayScene, getAlignmentLerper, initReplayScene, updateOrbitTarget } from "../ar/replay-scene.js";
+import { NullStorageBackend } from "../storage/null-storage-backend.js";
+import { t as createSlamAppStore } from "../create-slam-app-store-wYN7YkB5.js";
+import { ReplayEngine } from "./replay-engine.js";
+import { wireStoreSubscribers } from "./store-subscribers.js";
+import { gpsEventVisualizer } from "../visualization/gps-event-markers.js";
+import { OcclusionMesh } from "../visualization/occlusion-mesh.js";
+import { OccupancyCubesVisualizer } from "../visualization/occupancy-cubes-visualizer.js";
+import { subscribeReplayOccupancy } from "./replay-occupancy-subscriber.js";
+import * as THREE from "three";
+//#region ../src/state/replay-session.ts
+/**
+* Replay session — the framework-level composer that lets ANY consumer app
+* replay a recorded session on the desktop (no phone, no WebXR) with live mesh
+* reconstruction, in a handful of lines.
+*
+* It wires together the pieces that already exist so a consumer does not have to
+* copy the RecorderApp's `replay/replay-mode.ts` orchestrator:
+*   - a store (a fresh framework store by default, or one the caller injects),
+*   - the non-WebXR desktop scene (`initReplayScene`),
+*   - the shared state→visuals bridge (`wireStoreSubscribers`: alignment lerp +
+*     GPS event markers + the recorded camera trajectory driving `arpose`),
+*   - the occupancy grid → cube visualizer + occlusion mesh path, fed by the
+*     replayed `recordDepthSample` stream (`subscribeReplayOccupancy`),
+*   - a {@link ReplayEngine} driving the recorded action list.
+*
+* The consumer supplies an already-loaded `RecordedAction[]` (the loader stays a
+* consumer concern — the framework does not migrate old-era recordings). For a
+* current-era zip, `loadActionsFromZip` (storage/zip-reader) turns it into the
+* action list with zero recorder-side code.
+*
+* Recorder-specific visualizers (frame tiles, ref-point spheres/markers, stats
+* overlay) are NOT wired here — the RecorderApp injects those into its own
+* orchestrator. This composer ships only the generally-useful defaults every
+* replay consumer wants.
+*
+* @see replay-session.ts.md for the full API and examples.
+* @see 2026-07-15 replay-as-dev-harness Part A design.
+*/
+const log = createLogger("ReplaySession");
+/**
+* Compose and start a desktop replay session. Synchronous — the caller drives
+* playback via the returned controller.
+*/
+function startReplaySession(options) {
+	const { actions, container } = options;
+	const occupancyConfig = options.occupancy ?? {};
+	const occupancyEnabled = occupancyConfig.enabled ?? true;
+	const store = options.store ?? createSlamAppStore({
+		storageBackend: new NullStorageBackend(),
+		enableDevChecks: false
+	});
+	const scene = initReplayScene(container);
+	log.info("Replay scene initialized");
+	gpsEventVisualizer.setSceneSource({
+		getScene: () => scene.scene,
+		getArWorldGroup: () => scene.arWorldGroup
+	});
+	const alignmentLerper = getAlignmentLerper();
+	const snapshotPos = new THREE.Vector3();
+	const unsubscribeStore = wireStoreSubscribers(store, {
+		applyAlignmentMatrix: (matrix) => alignmentLerper?.setTarget(matrix),
+		gpsEventVisualizer,
+		onNewOdomPose: (odomPosition, odomRotation) => {
+			const webxrPos = nuePositionToWebXR(odomPosition);
+			scene.arpose.position.fromArray(webxrPos);
+			const webxrRot = nueQuaternionToWebXR(odomRotation);
+			scene.arpose.quaternion.fromArray(webxrRot);
+		},
+		onAlignmentSnapshot: (nuePosition) => {
+			snapshotPos.fromArray(nuePosition);
+			updateOrbitTarget(snapshotPos);
+		}
+	});
+	const occupancy = occupancyEnabled ? setupOccupancyReconstruction(store, scene.arWorldGroup, occupancyConfig) : null;
+	const engine = new ReplayEngine();
+	if (options.onProgress) engine.onProgress(options.onProgress);
+	if (options.onComplete) engine.onComplete(options.onComplete);
+	if (options.onError) engine.onError(options.onError);
+	let disposed = false;
+	return {
+		play(speedFactor = 1) {
+			if (disposed) return Promise.resolve();
+			return engine.play(actions, store, speedFactor);
+		},
+		pause() {
+			engine.pause();
+		},
+		resume() {
+			if (disposed) return Promise.resolve();
+			return engine.resume();
+		},
+		setSpeed(factor) {
+			engine.setSpeed(factor);
+		},
+		getState() {
+			return engine.getState();
+		},
+		getStore() {
+			return store;
+		},
+		getScene() {
+			return scene;
+		},
+		getOccupancyGrid() {
+			return occupancy?.grid ?? null;
+		},
+		getCubesVisualizer() {
+			return occupancy?.cubes ?? null;
+		},
+		getOcclusionMesh() {
+			return occupancy?.occlusionMesh ?? null;
+		},
+		getActionCount() {
+			return actions.length;
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			engine.dispose();
+			unsubscribeStore();
+			occupancy?.dispose();
+			gpsEventVisualizer.setSceneSource(null);
+			disposeReplayScene();
+			log.info("Replay session disposed");
+		}
+	};
+}
+/**
+* Build the occupancy grid, the (optional) cube visualizer + occlusion mesh, and
+* the depth-sample subscription that refreshes them. Kept out of the main
+* composer so its branches don't inflate that function's complexity.
+*/
+function setupOccupancyReconstruction(store, arWorldGroup, config) {
+	const cellSizeM = config.cellSizeM ?? .15;
+	const minObservations = config.minObservations ?? 1;
+	const grid = new OccupancyGrid({ cellSizeM });
+	const cubes = config.showCubes ?? true ? new OccupancyCubesVisualizer(arWorldGroup, { minObservations }) : null;
+	const occlusionMesh = config.showOcclusionMesh ?? true ? new OcclusionMesh(arWorldGroup) : null;
+	const unsubscribe = subscribeReplayOccupancy({
+		store,
+		grid,
+		refreshIntervalMs: config.refreshIntervalMs,
+		onRefresh: (viewerPose) => {
+			cubes?.refresh(grid, viewerPose);
+			occlusionMesh?.update(grid.getOccupiedCells(minObservations), cellSizeM, (cell) => grid.getCellPoint(cell));
+		},
+		onError: (err) => log.warn("Occupancy refresh failed during replay", err)
+	});
+	return {
+		grid,
+		cubes,
+		occlusionMesh,
+		dispose() {
+			unsubscribe();
+			cubes?.dispose();
+			occlusionMesh?.dispose();
+		}
+	};
+}
+//#endregion
+export { startReplaySession };

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

@@ -1,3 +1,3 @@
-import { t as SubscribableStore } from "../subscribe-to-selector-j-eOYybQ.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-CWHToX6N.js";
+import { t as SubscribableStore } from "../subscribe-to-selector-B_lm_euO.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-BbRW35u5.js";
 export { StoreSubscriberDeps, SubscribableStore, wireStoreSubscribers };

package/dist/state/store-subscribers.js

@@ -1,6 +1,6 @@
 import { createLogger } from "../utils/logger.js";
 import { selectAlignmentMatrix, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectZeroReference } from "./app-selectors.js";
-import { t as buildMapData } from "../map-data-DkhsYDGM.js";
+import { t as buildMapData } from "../map-data-vL8jb5Z9.js";
 import { subscribeToSelector } from "./subscribe-to-selector.js";
 import { mat4, vec3 } from "gl-matrix";
 import { calcGpsCoords } from "gps-plus-slam-js";

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

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

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

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

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

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

package/dist/{state-CDF5LvsO.js → state-DxL3T1Id.js}

@@ -5,7 +5,7 @@ import "./state/gps-event-coordinator.js";
 import "./state/app-selectors.js";
 import { selectTrackingQuality } from "./state/tracking-quality.js";
 import "./state/persistence-middleware.js";
-import "./create-slam-app-store-oK9bnqyI.js";
+import "./create-slam-app-store-wYN7YkB5.js";
 import "./state/recording-replayer.js";
 import "./state/store-subscribers.js";
 import { add2dImage, calcRelativeCoordsInMeters, recordGpsEvent as recordGpsEvent$1, setZeroPos as setZeroPos$1 } from "gps-plus-slam-js";

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

@@ -1,2 +1,2 @@
-import { a as formatTimestamp, i as formatFrameFilename, n as SESSION_IMAGES_DIR, r as formatActionFilename, t as LEGACY_SESSION_IMAGES_DIR } from "../file-system-utils-BHI0rXr9.js";
+import { a as formatTimestamp, i as formatFrameFilename, n as SESSION_IMAGES_DIR, r as formatActionFilename, t as LEGACY_SESSION_IMAGES_DIR } from "../file-system-utils-DE3BViuq.js";
 export { LEGACY_SESSION_IMAGES_DIR, SESSION_IMAGES_DIR, formatActionFilename, formatFrameFilename, formatTimestamp };

package/dist/storage/index.d.ts

@@ -1,9 +1,9 @@
-import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, h as writeSessionMetadata, i as createSession, l as listSessions, n as SessionMetadata, o as getSessionHandle, r as checkStorageQuota, s as getSessionsRootHandle, u as resetOpfsStorage } from "../opfs-storage-S_odkCk1.js";
-import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-BX7egQKi.js";
-import { a as ZipActionEntry, c as loadActionsFromZip, d as loadSessionMetadata, f as loadSessionMetadataFromBlob, i as RecordedAction, l as loadEntriesFromSubdir, n as GpsPathCoord, p as readZipEntries, r as MAX_ACTION_FILE_SIZE, s as ZipSubdirEntry, t as Entry, u as loadGpsPathFromBlob } from "../zip-reader-BHc_b_iA.js";
-import { t as NullStorageBackend } from "../null-storage-backend-DXXuwG8T.js";
-import { t as OpfsStorageBackend } from "../opfs-storage-backend-D1ZpeNEL.js";
-import { a as formatTimestamp, i as formatFrameFilename, r as formatActionFilename } from "../file-system-utils-BHI0rXr9.js";
-import { a as downloadZip, c as syncToExternalZip, i as ZipExportResult, n as ZipContributorAddFile, o as exportSessionAsZip, r as ZipExportContributor, s as exportSessionHandleAsZip, t as ExportSessionAsZipOptions } from "../zip-export-CuBimX1J.js";
-import { t as embedCoverageInSessionJson } from "../zip-coverage-embed-CyoX7XL7.js";
+import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, h as writeSessionMetadata, i as createSession, l as listSessions, n as SessionMetadata, o as getSessionHandle, r as checkStorageQuota, s as getSessionsRootHandle, u as resetOpfsStorage } from "../opfs-storage-CrhVauNL.js";
+import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-DCYbOvTw.js";
+import { a as ZipActionEntry, c as loadActionsFromZip, d as loadSessionMetadata, f as loadSessionMetadataFromBlob, i as RecordedAction, l as loadEntriesFromSubdir, n as GpsPathCoord, p as readZipEntries, r as MAX_ACTION_FILE_SIZE, s as ZipSubdirEntry, t as Entry, u as loadGpsPathFromBlob } from "../zip-reader-DwkuvlGo.js";
+import { t as NullStorageBackend } from "../null-storage-backend-Dtn3TBfT.js";
+import { t as OpfsStorageBackend } from "../opfs-storage-backend-CZ-ECudx.js";
+import { a as formatTimestamp, i as formatFrameFilename, r as formatActionFilename } from "../file-system-utils-DE3BViuq.js";
+import { a as downloadZip, c as syncToExternalZip, i as ZipExportResult, n as ZipContributorAddFile, o as exportSessionAsZip, r as ZipExportContributor, s as exportSessionHandleAsZip, t as ExportSessionAsZipOptions } from "../zip-export-Cfl_kNQ7.js";
+import { t as embedCoverageInSessionJson } from "../zip-coverage-embed-BC3O2-8b.js";
 export { type CreateSessionResult, type Entry, type ExportSessionAsZipOptions, type GpsPathCoord, MAX_ACTION_FILE_SIZE, NullStorageBackend, OpfsStorageBackend, type RecordedAction, type SessionMetadata, type StorageBackend, type ZipActionEntry, type ZipContributorAddFile, type ZipExportContributor, type ZipExportResult, type ZipSubdirEntry, checkStorageQuota, createSession, downloadZip, embedCoverageInSessionJson, exportSessionAsZip, exportSessionHandleAsZip, formatActionFilename, formatFrameFilename, formatTimestamp, getAppRootHandle, getSessionHandle, getSessionsRootHandle, initOpfsStorage, listSessions, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadataFromBlob, loadSessionMetadata as loadSessionMetadataFromZip, readZipEntries, resetOpfsStorage, resetSessionHandles, syncToExternalZip, writeSessionMetadata };

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

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

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

@@ -1,2 +1,2 @@
-import { t as OpfsStorageBackend } from "../opfs-storage-backend-D1ZpeNEL.js";
+import { t as OpfsStorageBackend } from "../opfs-storage-backend-CZ-ECudx.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-S_odkCk1.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-CrhVauNL.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-BX7egQKi.js";
+import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-DCYbOvTw.js";
 export { CreateSessionResult, StorageBackend };

package/dist/storage/zip-coverage-embed.d.ts

@@ -1,2 +1,2 @@
-import { t as embedCoverageInSessionJson } from "../zip-coverage-embed-CyoX7XL7.js";
+import { t as embedCoverageInSessionJson } from "../zip-coverage-embed-BC3O2-8b.js";
 export { embedCoverageInSessionJson };

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 exportSessionAsZip, r as ZipExportContributor, s as exportSessionHandleAsZip, t as ExportSessionAsZipOptions } from "../zip-export-CuBimX1J.js";
+import { a as downloadZip, c as syncToExternalZip, i as ZipExportResult, n as ZipContributorAddFile, o as exportSessionAsZip, r as ZipExportContributor, s as exportSessionHandleAsZip, t as ExportSessionAsZipOptions } from "../zip-export-Cfl_kNQ7.js";
 export { ExportSessionAsZipOptions, ZipContributorAddFile, ZipExportContributor, ZipExportResult, downloadZip, exportSessionAsZip, exportSessionHandleAsZip, syncToExternalZip };

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

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

package/dist/{storage-backend-BX7egQKi.d.ts → storage-backend-DCYbOvTw.d.ts}

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

package/dist/{store-subscribers-CWHToX6N.d.ts → store-subscribers-BbRW35u5.d.ts}

@@ -1,5 +1,5 @@
-import { t as MapData } from "./map-data-D8cCqpOM.js";
-import { t as SubscribableStore } from "./subscribe-to-selector-j-eOYybQ.js";
+import { t as MapData } from "./map-data-BQXPtRz7.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-B_lm_euO.js";
 import { LatLong, Matrix4, Quaternion, Vector3 } from "gps-plus-slam-js";
 
 //#region ../src/state/store-subscribers.d.ts

package/dist/{subscribe-to-selector-j-eOYybQ.d.ts → subscribe-to-selector-B_lm_euO.d.ts}

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

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

@@ -1,4 +1,4 @@
-import { o as WebXRQuaternion, s as WebXRVec3 } from "../ar-types-D6PYS4bc.js";
+import { o as WebXRQuaternion, s as WebXRVec3 } from "../ar-types-BprL3nKv.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-BHc_b_iA.js";
+import { i as RecordedAction } from "../zip-reader-DwkuvlGo.js";
 import { LatLong } from "gps-plus-slam-js";
 
 //#region ../src/test-utils/zip-round-trip-helpers.d.ts

package/dist/text-sprite-C6VcC2mo.d.ts

@@ -0,0 +1,53 @@
+import * as THREE from "three";
+
+//#region ../src/visualization/text-sprite.d.ts
+interface TextSpriteOptions {
+  /** Initial label text. Defaults to ''. */
+  text?: string;
+  /** Canvas backing-store width in px. Defaults to 64. */
+  canvasWidth?: number;
+  /** Canvas backing-store height in px. Defaults to 64. */
+  canvasHeight?: number;
+  /** CSS font shorthand used for the label. Defaults to 'bold 48px sans-serif'. */
+  font?: string;
+  /** Fill style for the text. Defaults to '#ffffff'. */
+  textColor?: string;
+  /**
+   * Background painted behind the text on every redraw.
+   * 'none' keeps the canvas transparent; 'pill' draws a rounded
+   * semi-transparent black capsule for contrast against AR video.
+   */
+  background?: 'none' | 'pill';
+  /** SpriteMaterial.depthWrite. Defaults to the three.js material default. */
+  depthWrite?: boolean;
+  /** SpriteMaterial.transparent. Defaults to the three.js material default. */
+  transparent?: boolean;
+  /** Use LinearFilter for min/mag (crisper animated text). Defaults to false. */
+  linearFilters?: boolean;
+  /** Sprite.renderOrder. Defaults to 0. */
+  renderOrder?: number;
+  /** Initial sprite scale. Defaults to the three.js sprite default (1,1,1). */
+  scale?: {
+    x: number;
+    y: number;
+    z: number;
+  };
+}
+interface TextSprite {
+  /** The renderable sprite — attach it to the scene graph yourself. */
+  readonly sprite: THREE.Sprite;
+  /** Redraw the label. No-op (no redraw, no texture upload) when unchanged. */
+  setText(text: string): void;
+  /** Dispose the sprite material and its canvas texture. */
+  dispose(): void;
+}
+/**
+ * Create a text sprite backed by an off-screen canvas texture.
+ *
+ * Tolerates a null 2D context (headless test environments without a canvas
+ * backend): the sprite is still created and setText()/dispose() stay safe;
+ * only the pixels are skipped.
+ */
+declare function createTextSprite(options?: TextSpriteOptions): TextSprite;
+//#endregion
+export { TextSpriteOptions as n, createTextSprite as r, TextSprite as t };

package/dist/{tracking-slice-BAbcZK-Y.d.ts → tracking-slice-D5LDL_y4.d.ts}

@@ -1,4 +1,4 @@
-import { t as ARPose } from "./ar-types-D6PYS4bc.js";
+import { t as ARPose } from "./ar-types-BprL3nKv.js";
 import { OdometryTrackingRestartedPayload, Quaternion, Vector3 } from "gps-plus-slam-js";
 import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
 import * as _$redux from "redux";

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

@@ -1,2 +1,2 @@
-import { a as RgbTuple, c as extractOdomPosition, i as DepthSample, l as extractOdomRotation, n as ArPoseTuples, o as WebXRQuaternion, r as DepthPoint, s as WebXRVec3, t as ARPose } from "../ar-types-D6PYS4bc.js";
+import { a as RgbTuple, c as extractOdomPosition, i as DepthSample, l as extractOdomRotation, n as ArPoseTuples, o as WebXRQuaternion, r as DepthPoint, s as WebXRVec3, t as ARPose } from "../ar-types-BprL3nKv.js";
 export { ARPose, ArPoseTuples, DepthPoint, DepthSample, RgbTuple, WebXRQuaternion, WebXRVec3, extractOdomPosition, extractOdomRotation };

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

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

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
-import { a as RgbTuple, c as extractOdomPosition, i as DepthSample, l as extractOdomRotation, n as ArPoseTuples, o as WebXRQuaternion, r as DepthPoint, s as WebXRVec3, t as ARPose } from "../ar-types-D6PYS4bc.js";
-import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-BfDK8kJu.js";
+import { a as RgbTuple, c as extractOdomPosition, i as DepthSample, l as extractOdomRotation, n as ArPoseTuples, o as WebXRQuaternion, r as DepthPoint, s as WebXRVec3, t as ARPose } from "../ar-types-BprL3nKv.js";
+import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-DGe5UKgx.js";
 export { ARPose, ArPoseTuples, DepthPoint, DepthSample, GpsCoord, RawGpsSample, RefPointMarker, RgbTuple, WebXRQuaternion, WebXRVec3, extractOdomPosition, extractOdomRotation };

package/dist/utils/concurrency.d.ts

@@ -1,2 +1,2 @@
-import { n as mapWithConcurrencyLimit, t as forEachWithConcurrencyLimit } from "../concurrency-DW0jQo3G.js";
+import { n as mapWithConcurrencyLimit, t as forEachWithConcurrencyLimit } from "../concurrency-CMhbkxBk.js";
 export { forEachWithConcurrencyLimit, 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-B7fzPfZo.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-BdaFulDA.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-Da8rZgfs.js";
+import { t as formatFileSize } from "../format-file-size-B2CJdRqD.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-DOKzVMiO.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-CBAttcVm.js";
 export { FusedPathInput, computeFusedPath, fusedGpsFromOdom };

package/dist/utils/index.d.ts

@@ -1,8 +1,8 @@
-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-B4StJUDb.js";
-import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-DOKzVMiO.js";
-import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-B7fzPfZo.js";
-import { n as mapWithConcurrencyLimit } from "../concurrency-DW0jQo3G.js";
-import { t as geodesicAngleRad } from "../index-Nr3qg4IH.js";
-import { t as formatFileSize } from "../format-file-size-Da8rZgfs.js";
-import { t as listFormatter } from "../list-formatter-1ttG18MQ.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-BQGNXi9W.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-CBAttcVm.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-BdaFulDA.js";
+import { n as mapWithConcurrencyLimit } from "../concurrency-CMhbkxBk.js";
+import { t as geodesicAngleRad } from "../index-Y_RNWbQX.js";
+import { t as formatFileSize } from "../format-file-size-B2CJdRqD.js";
+import { t as listFormatter } from "../list-formatter-C45u3Vgv.js";
 export { FailureTracker, FailureTrackerConfig, FusedPathInput, LogEntry, LogLevel, Logger, clearLogBuffer, computeFusedPath, createFailureTracker, createLogger, formatFileSize, fusedGpsFromOdom, geodesicAngleRad, getGlobalLogLevel, getLogBuffer, listFormatter, mapWithConcurrencyLimit, setGlobalLogLevel, subscribeToLogs };

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

@@ -1,2 +1,2 @@
-import { t as listFormatter } from "../list-formatter-1ttG18MQ.js";
+import { t as listFormatter } from "../list-formatter-C45u3Vgv.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-B4StJUDb.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-BQGNXi9W.js";
 export { LogEntry, LogLevel, Logger, clearLogBuffer, createLogger, getGlobalLogLevel, getLogBuffer, setGlobalLogLevel, subscribeToLogs };

package/dist/visualization/accuracy-circles.d.ts

@@ -1,2 +1,2 @@
-import { a as addAccuracyCircles, i as AccuracyCircleSample, n as ACCURACY_CIRCLE_STROKE_OPACITY, r as ACCURACY_CIRCLE_WEIGHT, t as ACCURACY_CIRCLE_FILL_OPACITY } from "../accuracy-circles-BHz7yVIL.js";
+import { a as addAccuracyCircles, i as AccuracyCircleSample, n as ACCURACY_CIRCLE_STROKE_OPACITY, r as ACCURACY_CIRCLE_WEIGHT, t as ACCURACY_CIRCLE_FILL_OPACITY } from "../accuracy-circles-CFnKGfsD.js";
 export { ACCURACY_CIRCLE_FILL_OPACITY, ACCURACY_CIRCLE_STROKE_OPACITY, ACCURACY_CIRCLE_WEIGHT, AccuracyCircleSample, addAccuracyCircles };

package/dist/visualization/alignment-lerper.d.ts

@@ -1,2 +1,2 @@
-import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-DAHicRON.js";
+import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-CK1TYLIL.js";
 export { AlignmentLerper, createAlignmentLerper };

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

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

package/dist/visualization/ar-world-group-alignment.js

@@ -1,5 +1,5 @@
 import { registerFrameUpdate } from "../ar/frame-loop.js";
-import { t as registerSessionDisposer } from "../session-disposers-B7hUN90w.js";
+import { t as registerSessionDisposer } from "../session-disposers-BJM5U62W.js";
 import { createAlignmentLerper } from "./alignment-lerper.js";
 import { selectAlignmentMatrix } from "../state/app-selectors.js";
 import { subscribeToSelector } from "../state/subscribe-to-selector.js";

package/dist/visualization/camera-follower.d.ts

@@ -1,2 +1,2 @@
-import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-CO_ibF2o.js";
+import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-OnnXsbHd.js";
 export { CameraFollower, createCameraFollower };

package/dist/visualization/css3d-renderer-manager.d.ts

@@ -1,2 +1,2 @@
-import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-CJjHtCMT.js";
+import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-CE6xN7XM.js";
 export { Css3dRendererManager, createCss3dRendererManager };

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

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

package/dist/visualization/frustum-visibility.d.ts

@@ -1,2 +1,2 @@
-import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-COPfzruF.js";
+import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-BTx1Sqfo.js";
 export { buildCameraFrustum, isObjectInCameraFrustum, isPointInCameraFrustum, isSphereInCameraFrustum };

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

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

package/dist/visualization/gps-compass-cubes.d.ts

@@ -1,2 +1,2 @@
-import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-CT3TWctJ.js";
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-QQJgpRXR.js";
 export { COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, GpsCompassCubes, createGpsCompassCubes };