gps-plus-slam-app-framework 1.3.0 → 1.7.0

package/dist/storage/zip-export.js

@@ -20,14 +20,6 @@ import { BlobReader, BlobWriter, ZipWriter } from "@zip.js/zip.js";
 */
 const log = createLogger("ZipExport");
 /**
-* Get the OPFS scenarios directory handle.
-* Re-acquires from navigator.storage to avoid holding stale references.
-* Creates on demand so it works even when initOpfsStorage only creates sessions/.
-*/
-async function getScenariosHandle() {
-	return (await (await navigator.storage.getDirectory()).getDirectoryHandle("gps-plus-slam")).getDirectoryHandle("scenarios", { create: true });
-}
-/**
 * Get the OPFS sessions directory handle (flat layout).
 */
 async function getSessionsHandle() {
@@ -56,49 +48,48 @@ async function streamDirectoryToZip(dirHandle, zipWriter, basePath = "") {
 	return count;
 }
 /**
-* Export a session from OPFS as a ZIP blob.
+* Export a flat-layout session from OPFS as a ZIP blob.
 *
 * The ZIP structure mirrors the OPFS session structure:
 * - session.json (at root)
 * - actions/000001.json, actions/000002.json, ...
 * - images/frame-000001.jpg, images/frame-000002.jpg, ... (legacy: frames/)
-* - refPoints/{h3}.json (only observations from this session, scenario layout only)
 *
-* Uses "store" mode (compression level 0) for fast packaging.
-*
-* Supports both flat and scenario-based layouts:
-* - `exportSessionAsZip(sessionName)` — flat layout (sessions/)
-* - `exportSessionAsZip(scenarioName, sessionName)` — scenario layout (scenarios/{name}/)
+* Uses "store" mode (compression level 0) for fast packaging. Consumers with a
+* different on-disk layout (one that nests sessions under a named bucket)
+* resolve their own session handle and call {@link exportSessionHandleAsZip}.
 *
+* @param sessionName - Name of the session folder under `sessions/`.
 * @returns ZIP export result with blob and file count
-* @throws Error if session not found
+* @throws Error if the session is not found
 */
-async function exportSessionAsZip(scenarioNameOrSessionName, sessionName, options) {
+async function exportSessionAsZip(sessionName, options) {
+	log.info(`Exporting session: ${sessionName}`);
+	const sessionsDir = await getSessionsHandle();
 	let sessionHandle;
-	if (sessionName) {
-		const scenarioName = scenarioNameOrSessionName;
-		log.info(`Exporting session: ${scenarioName}/${sessionName}`);
-		const scenariosDir = await getScenariosHandle();
-		let scenarioHandle;
-		try {
-			scenarioHandle = await scenariosDir.getDirectoryHandle(scenarioName);
-		} catch {
-			throw new Error(`Scenario "${scenarioName}" not found in OPFS storage`);
-		}
-		try {
-			sessionHandle = await scenarioHandle.getDirectoryHandle(sessionName);
-		} catch {
-			throw new Error(`Session "${sessionName}" not found in scenario "${scenarioName}"`);
-		}
-	} else {
-		log.info(`Exporting session: ${scenarioNameOrSessionName}`);
-		const sessionsDir = await getSessionsHandle();
-		try {
-			sessionHandle = await sessionsDir.getDirectoryHandle(scenarioNameOrSessionName);
-		} catch {
-			throw new Error(`Session "${scenarioNameOrSessionName}" not found in OPFS storage`);
-		}
+	try {
+		sessionHandle = await sessionsDir.getDirectoryHandle(sessionName);
+	} catch {
+		throw new Error(`Session "${sessionName}" not found in OPFS storage`);
 	}
+	return exportSessionHandleAsZip(sessionHandle, options);
+}
+/**
+* Stream an already-resolved session directory handle to a ZIP blob, running
+* any caller-supplied extension {@link ZipExportContributor}s after the
+* framework-owned files.
+*
+* This is the layout-agnostic core of {@link exportSessionAsZip}: consumers
+* that resolve a session directory handle themselves (e.g. an app that nests
+* sessions under its own grouping layer) call this directly so the framework's
+* ZIP schema stays the single source of truth without the framework needing to
+* know how the handle was located.
+*
+* @param sessionHandle - The session directory to package (must contain the
+*   framework-owned `session.json` / `actions/` / `images/` tree).
+* @returns ZIP export result with blob and file count.
+*/
+async function exportSessionHandleAsZip(sessionHandle, options) {
 	const zipWriter = new ZipWriter(new BlobWriter("application/zip"), { level: 0 });
 	let fileCount = await streamDirectoryToZip(sessionHandle, zipWriter);
 	const contributors = options?.contributors ?? [];
@@ -136,14 +127,13 @@ async function exportSessionAsZip(scenarioNameOrSessionName, sessionName, option
 * the last synced ZIP contains all data up to that point.
 *
 * @param fileHandle - File handle from showSaveFilePicker
-* @param scenarioName - Name of the scenario
-* @param sessionName - Name of the session folder
+* @param sessionName - Name of the session folder under `sessions/`
 * @returns ZIP export result with blob and file count
-* @throws Error if scenario or session not found
+* @throws Error if the session is not found
 */
-async function syncToExternalZip(fileHandle, scenarioName, sessionName, options) {
-	log.info(`Syncing to external ZIP: ${scenarioName}/${sessionName}`);
-	const result = await exportSessionAsZip(scenarioName, sessionName, options);
+async function syncToExternalZip(fileHandle, sessionName, options) {
+	log.info(`Syncing to external ZIP: ${sessionName}`);
+	const result = await exportSessionAsZip(sessionName, options);
 	const writable = await fileHandle.createWritable();
 	await writable.write(result.blob);
 	await writable.close();
@@ -191,17 +181,5 @@ async function downloadZip(blob, filename) {
 	setTimeout(() => URL.revokeObjectURL(url), 1e3);
 	log.info(`Download triggered via <a download>: ${filename}`);
 }
-/**
-* Export and download a session in one step.
-*
-* Convenience function combining exportSessionAsZip and downloadZip.
-*
-* @param scenarioName - Name of the scenario
-* @param sessionName - Name of the session folder
-*/
-async function exportAndDownloadSession(scenarioName, sessionName) {
-	const { blob } = await exportSessionAsZip(scenarioName, sessionName);
-	await downloadZip(blob, `${scenarioName}-${sessionName}.zip`);
-}
 //#endregion
-export { downloadZip, exportAndDownloadSession, exportSessionAsZip, syncToExternalZip };
+export { downloadZip, exportSessionAsZip, exportSessionHandleAsZip, 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-DSEXt7K6.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-D9iPQwdQ.js";
 export { Entry, GpsPathCoord, MAX_ACTION_FILE_SIZE, RecordedAction, ZipActionEntry, ZipSubdirEntry, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries };

package/dist/{storage-backend-Do6YDpNo.d.ts → storage-backend-BdVLD0dU.d.ts}

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

package/dist/{store-subscribers-0YWyOLvV.d.ts → store-subscribers-CA6AJH_8.d.ts}

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

package/dist/{subscribe-to-selector-CZ6k1NFP.d.ts → subscribe-to-selector-B6EUmQ3I.d.ts}

@@ -1,4 +1,4 @@
-import { L as CombinedRootState } from "./create-slam-app-store-BljusOua.js";
+import { N as CombinedRootState } from "./create-slam-app-store-n_VF63D5.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-Dan1MVTi.js";
+import { o as WebXRQuaternion, s as WebXRVec3 } from "../ar-types-BFX2r1wk.js";
 import { Mock } from "vitest";
 
 //#region ../src/test-utils/browser-mocks.d.ts
@@ -195,6 +195,9 @@ declare class MockFSDirectoryHandle implements FileSystemDirectoryHandle {
   queryPermission(_descriptor?: {
     mode?: 'read' | 'readwrite';
   }): Promise<PermissionState>;
+  requestPermission(_descriptor?: {
+    mode?: 'read' | 'readwrite';
+  }): Promise<PermissionState>;
 }
 /**
  * Install File System Access API mocks on the global window object.
@@ -251,6 +254,9 @@ declare class MockOPFSDirectoryHandle implements FileSystemDirectoryHandle {
   queryPermission(_descriptor?: {
     mode?: 'read' | 'readwrite';
   }): Promise<PermissionState>;
+  requestPermission(_descriptor?: {
+    mode?: 'read' | 'readwrite';
+  }): Promise<PermissionState>;
 }
 /**
  * Mock OPFS file handle with writable stream support.

package/dist/test-utils/browser-mocks.js

@@ -348,6 +348,9 @@ var MockFSDirectoryHandle = class MockFSDirectoryHandle {
 	queryPermission(_descriptor) {
 		return Promise.resolve("granted");
 	}
+	requestPermission(_descriptor) {
+		return Promise.resolve("granted");
+	}
 };
 /**
 * Install File System Access API mocks on the global window object.
@@ -462,6 +465,9 @@ var MockOPFSDirectoryHandle = class MockOPFSDirectoryHandle {
 	queryPermission(_descriptor) {
 		return Promise.resolve("granted");
 	}
+	requestPermission(_descriptor) {
+		return Promise.resolve("granted");
+	}
 };
 /**
 * Mock OPFS file handle with writable stream support.

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

@@ -1,4 +1,4 @@
-import { i as RecordedAction } from "../zip-reader-DSEXt7K6.js";
+import { i as RecordedAction } from "../zip-reader-D9iPQwdQ.js";
 import { LatLong } from "gps-plus-slam-js";
 
 //#region ../src/test-utils/zip-round-trip-helpers.d.ts
@@ -18,6 +18,14 @@ interface ProduceTestZipOptions {
    * the field is left off — matching pre-accuracy recordings.
    */
   gpsAccuracy?: number;
+  /**
+   * Optional per-tour H3 coverage index written into `session.json`. When
+   * omitted, the fields are left off — matching legacy recordings that predate
+   * the coverage index (so the browser must backfill from the GPS path).
+   * When provided, `h3Resolution` defaults to 11.
+   */
+  h3Cells?: string[];
+  h3Resolution?: number;
 }
 /** Result of producing a test zip, with all metadata needed for assertions. */
 interface TestZipResult {

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

@@ -179,7 +179,11 @@ async function produceTestZip(opts) {
 			contextTag: options.scenarioName,
 			actionCount: actionIndex,
 			frameCount: options.frameCount,
-			userAgent: options.deviceInfo
+			userAgent: options.deviceInfo,
+			...options.h3Cells ? {
+				h3Cells: options.h3Cells,
+				h3Resolution: options.h3Resolution ?? 11
+			} : {}
 		});
 		const { blob } = await exportSessionAsZip(sessionName);
 		return {

package/dist/{tracking-slice-CdK8c-8P.d.ts → tracking-slice-BuAZxXZ5.d.ts}

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

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

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

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

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

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
-import { a as RgbTuple, i as DepthSample, n as ArPoseTuples, o as WebXRQuaternion, r as DepthPoint, s as WebXRVec3, t as ARPose } from "../ar-types-Dan1MVTi.js";
-import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-SaPnIEUM.js";
+import { a as RgbTuple, i as DepthSample, n as ArPoseTuples, o as WebXRQuaternion, r as DepthPoint, s as WebXRVec3, t as ARPose } from "../ar-types-BFX2r1wk.js";
+import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-3Ip1NzVR.js";
 export { ARPose, ArPoseTuples, DepthPoint, DepthSample, GpsCoord, RawGpsSample, RefPointMarker, RgbTuple, WebXRQuaternion, WebXRVec3 };

package/dist/utils/concurrency.d.ts

@@ -1,2 +1,2 @@
-import { t as mapWithConcurrencyLimit } from "../concurrency-CO1FQvs3.js";
-export { mapWithConcurrencyLimit };
+import { n as mapWithConcurrencyLimit, t as forEachWithConcurrencyLimit } from "../concurrency-By0oOTZt.js";
+export { forEachWithConcurrencyLimit, mapWithConcurrencyLimit };

package/dist/utils/concurrency.js

@@ -24,17 +24,81 @@ async function mapWithConcurrencyLimit(items, limit, mapper) {
 	const results = new Array(items.length);
 	if (items.length === 0) return results;
 	let nextIndex = 0;
+	let failed = false;
+	let firstError;
 	const worker = async () => {
 		while (nextIndex < items.length) {
+			if (failed) return;
 			const currentIndex = nextIndex++;
-			results[currentIndex] = await mapper(items[currentIndex], currentIndex);
+			try {
+				results[currentIndex] = await mapper(items[currentIndex], currentIndex);
+			} catch (err) {
+				if (!failed) {
+					failed = true;
+					firstError = err;
+				}
+				return;
+			}
 		}
 	};
 	const workerCount = Math.min(limit, items.length);
 	const workers = [];
 	for (let i = 0; i < workerCount; i++) workers.push(worker());
 	await Promise.all(workers);
+	if (failed) throw firstError;
 	return results;
 }
+/**
+* Run an async worker over each item with a concurrency cap, invoking the worker
+* per item as the pool pulls it (rather than collecting results into an array).
+*
+* Unlike {@link mapWithConcurrencyLimit}, this returns no values — the worker is
+* expected to produce its side effect (e.g. emit a streaming callback) itself.
+* This is the shape progressive consumers need: each item is handled and can be
+* reported as soon as it settles, instead of waiting for the whole batch.
+*
+* Completion order is **not** guaranteed (it depends on which worker finishes
+* first). Each item's worker is invoked exactly once unless the run is aborted.
+*
+* When an `AbortSignal` is supplied, workers stop pulling **new** items as soon
+* as the signal is aborted (checked before each pull). Items already in flight
+* run to completion — the File System Access reads underneath cannot be torn
+* mid-read — but no further items are started, so a destroyed consumer stops
+* accumulating work. If the signal is already aborted, no work starts at all.
+*
+* @param items - Items to process
+* @param limit - Maximum number of concurrent worker invocations (`>= 1`)
+* @param worker - Async side-effecting function applied to each item
+* @param signal - Optional abort signal that halts pulling new items
+* @throws RangeError if `limit < 1`
+* @throws Re-throws the first error from any worker invocation (fail-fast)
+*/
+async function forEachWithConcurrencyLimit(items, limit, worker, signal) {
+	if (limit < 1) throw new RangeError(`Concurrency limit must be >= 1, got ${limit}`);
+	if (items.length === 0) return;
+	let nextIndex = 0;
+	let failed = false;
+	let firstError;
+	const pump = async () => {
+		while (nextIndex < items.length) {
+			if (signal?.aborted || failed) return;
+			const currentIndex = nextIndex++;
+			try {
+				await worker(items[currentIndex], currentIndex);
+			} catch (err) {
+				if (!failed) {
+					failed = true;
+					firstError = err;
+				}
+				return;
+			}
+		}
+	};
+	const workerCount = Math.min(limit, items.length);
+	const workers = [];
+	for (let i = 0; i < workerCount; i++) workers.push(pump());
+	await Promise.all(workers);
+	if (failed) throw firstError;
+}
 //#endregion
-export { mapWithConcurrencyLimit };
+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-Cn8Fo9D4.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-BO7M7jF_.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-CLCZz3lC.js";
+import { t as formatFileSize } from "../format-file-size-Dc98ulzB.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-DJoVu98b.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-v6eOmLl3.js";
 export { FusedPathInput, computeFusedPath, fusedGpsFromOdom };

package/dist/utils/index.d.ts

@@ -1,7 +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-BEHXsnnq.js";
-import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-DJoVu98b.js";
-import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-Cn8Fo9D4.js";
-import { t as mapWithConcurrencyLimit } from "../concurrency-CO1FQvs3.js";
-import { t as formatFileSize } from "../format-file-size-CLCZz3lC.js";
-import { t as listFormatter } from "../list-formatter-RRcBe8Vg.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 };
+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-CLnPrHiD.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-v6eOmLl3.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-BO7M7jF_.js";
+import { n as mapWithConcurrencyLimit } from "../concurrency-By0oOTZt.js";
+import { t as geodesicAngleRad } from "../index-BAPokxMb.js";
+import { t as formatFileSize } from "../format-file-size-Dc98ulzB.js";
+import { t as listFormatter } from "../list-formatter-KNMS0ay2.js";
+export { FailureTracker, FailureTrackerConfig, FusedPathInput, LogEntry, LogLevel, Logger, clearLogBuffer, computeFusedPath, createFailureTracker, createLogger, formatFileSize, fusedGpsFromOdom, geodesicAngleRad, getGlobalLogLevel, getLogBuffer, listFormatter, mapWithConcurrencyLimit, setGlobalLogLevel, subscribeToLogs };

package/dist/utils/index.js

@@ -1,7 +1,8 @@
 import { LogLevel, clearLogBuffer, createLogger, getGlobalLogLevel, getLogBuffer, setGlobalLogLevel, subscribeToLogs } from "./logger.js";
 import { createFailureTracker } from "./failure-tracker.js";
+import { t as geodesicAngleRad } from "../geodesic-angle-BTldfFgs.js";
 import { computeFusedPath, fusedGpsFromOdom } from "./fused-path.js";
 import { mapWithConcurrencyLimit } from "./concurrency.js";
 import { formatFileSize } from "./format-file-size.js";
 import { listFormatter } from "./list-formatter.js";
-export { LogLevel, clearLogBuffer, computeFusedPath, createFailureTracker, createLogger, formatFileSize, fusedGpsFromOdom, getGlobalLogLevel, getLogBuffer, listFormatter, mapWithConcurrencyLimit, setGlobalLogLevel, subscribeToLogs };
+export { LogLevel, 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-RRcBe8Vg.js";
+import { t as listFormatter } from "../list-formatter-KNMS0ay2.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-BEHXsnnq.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-CLnPrHiD.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-BpwWAs8G.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-BtqOP_v1.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-Dm9G7JJO.js";
+import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-Bil6vbVw.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-C9lwwIyI.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-69fgnB39.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-M-oashRH.js";
+import { t as registerSessionDisposer } from "../session-disposers-zv9OGXPB.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-C2mwEn7c.js";
+import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-CqJJ7zRj.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-ptu_t3B3.js";
+import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-B3kGNtcn.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-BfsafGWR.js";
+import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-DObhj8Wf.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-CmI96ESS.js";
+import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-CeoCZchO.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-dYeCvvp5.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-BeFO2RYa.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-BM1uGiYV.js";
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-DSN87L8p.js";
 export { COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, GpsCompassCubes, createGpsCompassCubes };

package/dist/visualization/gps-event-markers.d.ts

@@ -1,2 +1,2 @@
-import { n as GpsEventVisualizer, r as gpsEventVisualizer, t as GpsEventAccuracy } from "../gps-event-markers-Dc9FT-q1.js";
+import { n as GpsEventVisualizer, r as gpsEventVisualizer, t as GpsEventAccuracy } from "../gps-event-markers-Cz9RMA2k.js";
 export { GpsEventAccuracy, GpsEventVisualizer, gpsEventVisualizer };

package/dist/visualization/gps-event-markers.js

@@ -1,6 +1,6 @@
 import { createLogger } from "../utils/logger.js";
 import { disposeMeshArray } from "./three-dispose.js";
-import { c as getArWorldGroup, m as getScene } from "../webxr-session-TIaD883f.js";
+import { _ as getScene, l as getArWorldGroup } from "../webxr-session-DG-eNfny.js";
 import { VIS_COLORS } from "./vis-colors.js";
 import * as THREE from "three";
 //#region ../src/visualization/gps-event-markers.ts
@@ -20,10 +20,20 @@ import * as THREE from "three";
 *   world positions update automatically via Three.js scene-graph propagation.
 */
 const log = createLogger("GpsEventVisualizer");
-/** Sphere radius in meters (8cm - smaller than reference point markers) */
-const GPS_MARKER_RADIUS = .08;
-/** Slightly larger radius for alignment snapshots to stand out */
-const SNAPSHOT_MARKER_RADIUS = .1;
+/**
+* Sphere radius in meters for the raw-GPS / fused debug markers.
+*
+* Halved 0.08 → 0.04 (D5, 2026-06-16 user feedback): these "different colours"
+* tracking spheres were cluttering the AR scene and hiding the ref-point
+* markers. They now shrink while the ref-point marker spheres grow (×2), so the
+* marker the user cares about stands out. This is a framework-level constant
+* rendered in BOTH live recording and replay, so replays of older recordings
+* also show the smaller debug spheres — intended and accepted (requester
+* decision); a plain constant change is correct (no live-vs-replay flag).
+*/
+const GPS_MARKER_RADIUS = .04;
+/** Slightly larger radius for alignment snapshots to stand out (halved 0.1 → 0.05 with the GPS markers, D5). */
+const SNAPSHOT_MARKER_RADIUS = .05;
 /**
 * Default opacity for the yellow raw-GPS sphere when it is rendered at the
 * legacy fixed 8 cm radius (no accuracy passed). Matches the original 30 %
@@ -67,6 +77,14 @@ var GpsEventVisualizer = class {
 	eventCounter = 0;
 	snapshotCounter = 0;
 	/**
+	* Whether the debug markers are drawn. Toggled by {@link setVisible} for the
+	* recorder's `visualization.gpsAlignmentMarkers` opt-out (Finding B). Applied
+	* to every marker at creation so events spawned later by the live
+	* store-subscriber inherit the current state instead of popping into view.
+	* Default `true` — the markers render exactly as before until opted out.
+	*/
+	markersVisible = true;
+	/**
 	* Set the GPS zero reference (origin for coordinate conversion).
 	* Must be called before adding GPS events.
 	*
@@ -167,9 +185,25 @@ var GpsEventVisualizer = class {
 		});
 		const mesh = new THREE.Mesh(geometry, material);
 		mesh.name = `${namePrefix}-${eventId}`;
+		mesh.visible = this.markersVisible;
 		return mesh;
 	}
 	/**
+	* Show or hide ALL debug markers — raw GPS (yellow), fused (cyan), and
+	* alignment-snapshot (red) — and remember the state so markers added later
+	* inherit it. Used by the recorder's `visualization.gpsAlignmentMarkers`
+	* opt-out, read once at Enter-AR (live only; replay keeps markers visible).
+	*
+	* This only changes rendering: capture, GPS-event recording, counts, and the
+	* snapshot positions read back at session end are all unaffected.
+	*/
+	setVisible(visible) {
+		this.markersVisible = visible;
+		for (const mesh of this.rawGpsMarkers) mesh.visible = visible;
+		for (const mesh of this.fusedMarkers) mesh.visible = visible;
+		for (const mesh of this.snapshotMarkers) mesh.visible = visible;
+	}
+	/**
 	* Clear all markers from the scene and reset state.
 	*/
 	clearAll() {
@@ -181,6 +215,7 @@ var GpsEventVisualizer = class {
 		this.zeroRef = null;
 		this.eventCounter = 0;
 		this.snapshotCounter = 0;
+		this.markersVisible = true;
 	}
 	/**
 	* Get count of visible markers.

package/dist/visualization/hit-test-reticle.d.ts

@@ -1,2 +1,2 @@
-import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-BEzEybxZ.js";
+import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-DV-2TpB9.js";
 export { HitMatrix, createReticleMesh, updateReticle };

package/dist/visualization/hit-test-reticle.js

@@ -75,6 +75,7 @@ function updateReticle(reticle, matrix) {
 	}
 	hitPoseMatrix.fromArray(matrix);
 	reticle.matrix.multiplyMatrices(WEBXR_TO_NUE, hitPoseMatrix);
+	reticle.matrixWorldNeedsUpdate = true;
 	reticle.visible = true;
 }
 //#endregion

package/dist/visualization/index.d.ts

@@ -1,19 +1,19 @@
-import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-ptu_t3B3.js";
-import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-C2mwEn7c.js";
-import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-Dm9G7JJO.js";
-import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-CkloBxIl.js";
-import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-C9lwwIyI.js";
-import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-BM1uGiYV.js";
-import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-CmI96ESS.js";
-import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-BfsafGWR.js";
-import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-BEzEybxZ.js";
-import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-dYeCvvp5.js";
-import { n as GpsEventVisualizer, r as gpsEventVisualizer } from "../gps-event-markers-Dc9FT-q1.js";
-import { a as DEFAULT_Z_OFFSET, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions } from "../leaflet-map-overlay-6CJC-E1l.js";
-import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-BpV-0Dtk.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-BpwWAs8G.js";
-import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-krOKwDAq.js";
-import { a as MapOverlayOptions, c as tileXYToLatLon, i as MapOverlay, n as DEFAULT_MAP_SIZE, o as TextureLoaderInterface, r as DEFAULT_ZOOM, s as latLonToTileXY, t as DEFAULT_HEIGHT_OFFSET } from "../map-overlay-bcogY5fK.js";
-import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-D950t71B.js";
-import { t as VIS_COLORS } from "../vis-colors-D6omC64K.js";
+import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-B3kGNtcn.js";
+import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-CqJJ7zRj.js";
+import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-Bil6vbVw.js";
+import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-B4oEehUh.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-69fgnB39.js";
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-DSN87L8p.js";
+import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-CeoCZchO.js";
+import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-DObhj8Wf.js";
+import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-DV-2TpB9.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-BeFO2RYa.js";
+import { n as GpsEventVisualizer, r as gpsEventVisualizer } from "../gps-event-markers-Cz9RMA2k.js";
+import { a as DEFAULT_Z_OFFSET, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions } from "../leaflet-map-overlay-CmIyiE8n.js";
+import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-BLmHhkVe.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-BtqOP_v1.js";
+import { a as MAP_PATH_POLYLINE_OPACITY, c as USER_POSITION_COLOR, i as FUSED_PATH_COLOR, l as drawMapData, n as DrawMapDataOptions, o as MAP_PATH_POLYLINE_WEIGHT, r as DrawnMapData, s as RAW_GPS_COLOR, t as ALIGNMENT_SNAPSHOT_COLOR } from "../map-overlay-draw-ymz1s7fG.js";
+import { a as MapOverlayOptions, c as tileXYToLatLon, i as MapOverlay, n as DEFAULT_MAP_SIZE, o as TextureLoaderInterface, r as DEFAULT_ZOOM, s as latLonToTileXY, t as DEFAULT_HEIGHT_OFFSET } from "../map-overlay-Dh2B97MP.js";
+import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-Bt1k7WKh.js";
+import { t as VIS_COLORS } from "../vis-colors-Obw2pLqT.js";
 export { ACCURACY_CIRCLE_FILL_OPACITY, ACCURACY_CIRCLE_STROKE_OPACITY, ACCURACY_CIRCLE_WEIGHT, ALIGNMENT_SNAPSHOT_COLOR, type AccuracyCircleSample, type AlignmentLerper, type ArWorldGroupAlignmentHandle, type ArWorldGroupAlignmentOptions, COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, type CameraFollower, type Css3dRendererManager, DEFAULT_HEIGHT_OFFSET, DEFAULT_LEAFLET_MAP_SIZE_PX, DEFAULT_LERP_RATE, DEFAULT_MAP_SIZE, DEFAULT_WORLD_SIZE, DEFAULT_ZOOM, DEFAULT_Z_OFFSET, type DisposeOptions, type DrawMapDataOptions, type DrawnMapData, FUSED_PATH_COLOR, type GpsAnchor, type GpsAnchorMode, type GpsAnchorOptions, type GpsAnchorPhase, type GpsAnchorSamplePoint, type GpsCompassCubes, GpsEventVisualizer, type HitMatrix, LeafletMapOverlay, type LeafletMapOverlayOptions, MAP_PATH_POLYLINE_OPACITY, MAP_PATH_POLYLINE_WEIGHT, type MapData, type MapDataInput, MapOverlay, type MapOverlayOptions, RAW_GPS_COLOR, type TextureLoaderInterface, USER_POSITION_COLOR, VIS_COLORS, addAccuracyCircles, buildCameraFrustum, buildMapData, clampedAlpha, createAlignmentLerper, createCameraFollower, createCss3dRendererManager, createGpsAnchor, createGpsCompassCubes, createReticleMesh, disposeMeshArray, disposeObject3D, drawMapData, enableArWorldGroupAlignment, gpsEventVisualizer, isObjectInCameraFrustum, isPointInCameraFrustum, isSphereInCameraFrustum, latLonToTileXY, nueToArLocal, tileXYToLatLon, updateReticle, worldNueToGps };