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

package/dist/storage/zip-export.js

@@ -22,9 +22,16 @@ 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-recorder")).getDirectoryHandle("scenarios");
+	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() {
+	return (await (await navigator.storage.getDirectory()).getDirectoryHandle("gps-plus-slam")).getDirectoryHandle("sessions");
 }
 /**
 * Stream all files from a directory recursively into a ZipWriter.
@@ -49,80 +56,66 @@ async function streamDirectoryToZip(dirHandle, zipWriter, basePath = "") {
 	return count;
 }
 /**
-* Filter and stream per-session ref point observations into a ZipWriter.
-*
-* Reads each ref point JSON from the scenario-level refPoints/ directory,
-* keeps only observations where `sessionId` matches `sessionName`, and writes
-* the filtered definition into the ZIP under `refPoints/{h3}.json`.
-*
-* Ref points with no observations for the current session are skipped entirely.
-* If the refPoints/ directory doesn't exist yet (new scenario), returns 0.
-*
-* @returns Number of ref point files added
-*/
-async function streamSessionRefPointsToZip(scenarioHandle, sessionName, zipWriter) {
-	let count = 0;
-	let refPointsHandle;
-	try {
-		refPointsHandle = await scenarioHandle.getDirectoryHandle("refPoints");
-	} catch {
-		return 0;
-	}
-	for await (const [name, handle] of refPointsHandle.entries()) {
-		if (handle.kind !== "file" || !name.endsWith(".json")) continue;
-		try {
-			const text = await (await handle.getFile()).text();
-			const def = JSON.parse(text);
-			if (!Array.isArray(def.observations)) continue;
-			const sessionObs = def.observations.filter((o) => o.sessionId === sessionName);
-			if (sessionObs.length === 0) continue;
-			const filtered = {
-				...def,
-				observations: sessionObs
-			};
-			const blob = new Blob([JSON.stringify(filtered, null, 2)], { type: "application/json" });
-			await zipWriter.add(`refPoints/${name}`, new BlobReader(blob));
-			count++;
-		} catch (err) {
-			log.warn(`Failed to process ref point ${name}:`, err);
-		}
-	}
-	return count;
-}
-/**
 * Export a 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, ...
 * - frames/frame-000001.jpg, frames/frame-000002.jpg, ...
-* - refPoints/{h3}.json (only observations from this session)
+* - refPoints/{h3}.json (only observations from this session, scenario layout only)
 *
 * Uses "store" mode (compression level 0) for fast packaging.
 *
-* @param scenarioName - Name of the scenario
-* @param sessionName - Name of the session folder
+* Supports both flat and scenario-based layouts:
+* - `exportSessionAsZip(sessionName)` — flat layout (sessions/)
+* - `exportSessionAsZip(scenarioName, sessionName)` — scenario layout (scenarios/{name}/)
+*
 * @returns ZIP export result with blob and file count
-* @throws Error if scenario or session not found
+* @throws Error if session not found
 */
-async function exportSessionAsZip(scenarioName, sessionName) {
-	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`);
-	}
+async function exportSessionAsZip(scenarioNameOrSessionName, sessionName, options) {
 	let sessionHandle;
-	try {
-		sessionHandle = await scenarioHandle.getDirectoryHandle(sessionName);
-	} catch {
-		throw new Error(`Session "${sessionName}" not found in scenario "${scenarioName}"`);
+	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`);
+		}
 	}
 	const zipWriter = new ZipWriter(new BlobWriter("application/zip"), { level: 0 });
 	let fileCount = await streamDirectoryToZip(sessionHandle, zipWriter);
-	fileCount += await streamSessionRefPointsToZip(scenarioHandle, sessionName, zipWriter);
+	const contributors = options?.contributors ?? [];
+	const seenSubdirs = /* @__PURE__ */ new Set();
+	for (const contributor of contributors) {
+		const subdir = contributor.subdir;
+		if (!subdir || subdir.includes("/") || subdir.startsWith(".")) throw new Error(`ZipExportContributor.subdir must be a non-empty single path segment, got: ${JSON.stringify(subdir)}`);
+		if (seenSubdirs.has(subdir)) throw new Error(`Duplicate ZipExportContributor.subdir registered: ${subdir}`);
+		seenSubdirs.add(subdir);
+		const addFile = async (relativePath, blob) => {
+			if (relativePath.startsWith("/")) throw new Error(`ZipExportContributor relative path must not start with '/' (got ${relativePath})`);
+			if (relativePath.includes("\\")) throw new Error(`ZipExportContributor relative path must not contain '\\' (got ${relativePath})`);
+			if (relativePath.split("/").some((s) => s === ".." || s === ".")) throw new Error(`ZipExportContributor relative path must not contain '.' or '..' segments (got ${relativePath})`);
+			await zipWriter.add(`${subdir}/${relativePath}`, new BlobReader(blob));
+		};
+		fileCount += await contributor.contribute(addFile);
+	}
 	const blob = await zipWriter.close();
 	log.info(`ZIP created: ${blob.size} bytes, ${fileCount} files`);
 	return {
@@ -148,9 +141,9 @@ async function exportSessionAsZip(scenarioName, sessionName) {
 * @returns ZIP export result with blob and file count
 * @throws Error if scenario or session not found
 */
-async function syncToExternalZip(fileHandle, scenarioName, sessionName) {
+async function syncToExternalZip(fileHandle, scenarioName, sessionName, options) {
 	log.info(`Syncing to external ZIP: ${scenarioName}/${sessionName}`);
-	const result = await exportSessionAsZip(scenarioName, sessionName);
+	const result = await exportSessionAsZip(scenarioName, sessionName, options);
 	const writable = await fileHandle.createWritable();
 	await writable.write(result.blob);
 	await writable.close();

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

@@ -1,2 +1,2 @@
-import { a as ZipActionEntry, c as loadSessionMetadata, i as RecordedAction, l as loadSessionMetadataFromBlob, n as GpsPathCoord, o as loadActionsFromZip, r as MAX_ACTION_FILE_SIZE, s as loadGpsPathFromBlob, t as Entry, u as readZipEntries } from "../zip-reader-D7pkpX8K.js";
-export { Entry, GpsPathCoord, MAX_ACTION_FILE_SIZE, RecordedAction, ZipActionEntry, loadActionsFromZip, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries };
+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";
+export { Entry, GpsPathCoord, MAX_ACTION_FILE_SIZE, RecordedAction, ZipActionEntry, ZipSubdirEntry, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries };

package/dist/storage/zip-reader.js

@@ -186,5 +186,28 @@ async function loadGpsPathFromBlob(blob, maxFileSize = MAX_ACTION_FILE_SIZE) {
 		} catch {}
 	}
 }
+/**
+* Enumerate every file under a single top-level subdirectory of a recording
+* zip. Mirrors the writer-side {@link ZipExportContributor} seam so consumers
+* (typically the recorder) can read back what they wrote without
+* re-implementing zip enumeration.
+*
+* Skips directory entries and files outside `subdir`. Sorts entries by
+* `relativePath` for deterministic iteration. Returns an empty array when
+* the subdir is absent (graceful degradation for older zips).
+*
+* @param data - The zip file content as a Uint8Array
+* @param subdir - Top-level subdir to scan (no leading or trailing `/`)
+*/
+async function loadEntriesFromSubdir(data, subdir) {
+	if (!subdir || subdir.includes("/") || subdir.startsWith(".")) throw new Error(`subdir must be a non-empty single path segment, got: ${JSON.stringify(subdir)}`);
+	const prefix = `${subdir}/`;
+	return (await readZipEntries(data)).filter((e) => !e.directory && e.filename.startsWith(prefix) && e.filename !== prefix).sort((a, b) => a.filename.localeCompare(b.filename)).map((entry) => ({
+		relativePath: entry.filename.slice(prefix.length),
+		fullPath: entry.filename,
+		uncompressedSize: entry.uncompressedSize,
+		getText: () => entry.getData(new TextWriter())
+	}));
+}
 //#endregion
-export { MAX_ACTION_FILE_SIZE, loadActionsFromZip, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries };
+export { MAX_ACTION_FILE_SIZE, loadActionsFromZip, loadEntriesFromSubdir, loadGpsPathFromBlob, loadSessionMetadata, loadSessionMetadataFromBlob, readZipEntries };

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

@@ -0,0 +1,28 @@
+import { n as SessionMetadata } from "./opfs-storage-Dlq1I_Gb.js";
+
+//#region ../src/storage/storage-backend.d.ts
+interface CreateSessionResult {
+  sessionName: string;
+}
+/**
+ * Contract for session lifecycle and recording persistence.
+ *
+ * Implementations:
+ * - OpfsStorageBackend: production — flat sessions under OPFS
+ * - NullStorageBackend: tests/replay — silent no-ops
+ * - ScenarioWrappingStorageBackend (recorder): layers scenario hierarchy on top
+ */
+interface StorageBackend {
+  /** Create a new recording session. Returns the session name for reference. */
+  createSession(timestamp: Date, contextTag?: string): Promise<CreateSessionResult>;
+  /** List all session names managed by this backend. */
+  listSessions(): Promise<string[]>;
+  /** Persist a Redux action as a numbered JSON file. */
+  writeAction(action: unknown, index: number): Promise<void>;
+  /** Persist a captured camera frame as a numbered JPEG. */
+  writeFrame(blob: Blob, index: number): Promise<void>;
+  /** Persist session metadata (session.json). */
+  writeSessionMetadata(metadata: SessionMetadata): Promise<void>;
+}
+//#endregion
+export { StorageBackend as n, CreateSessionResult as t };

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

@@ -1,4 +1,4 @@
-import { t as SubscribableStore } from "./subscribe-to-selector-UTZ0KkAc.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-ghDKYtap.js";
 import { LatLong, Matrix4, Quaternion, Vector3 } from "gps-plus-slam-js";
 
 //#region ../src/state/store-subscribers.d.ts
@@ -22,7 +22,6 @@ interface StoreSubscriberDeps {
     addRawGpsPoint?: (lat: number, lon: number) => void;
     addFusedPoint?: (lat: number, lon: number) => void;
     addAlignmentSnapshot?: (lat: number, lon: number) => void;
-    addRefPoint?: (lat: number, lon: number, name: string) => void;
   } | null;
   /**
    * Optional callback invoked with the GPS world-space coordinates of each

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

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

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

@@ -1,4 +1,4 @@
-import { i as RecordedAction } from "../zip-reader-D7pkpX8K.js";
+import { i as RecordedAction } from "../zip-reader-KgJEXbca.js";
 import { LatLong } from "gps-plus-slam-js";
 
 //#region ../src/test-utils/zip-round-trip-helpers.d.ts

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

@@ -65,7 +65,7 @@ async function produceTestZip(opts) {
 	const { cleanup } = installOPFSMocks();
 	try {
 		await initOpfsStorage();
-		const { scenarioName, sessionName } = await createSession(options.scenarioName, options.sessionTimestamp);
+		const { sessionName } = await createSession(options.sessionTimestamp, options.scenarioName);
 		const allActions = [];
 		let actionIndex = 0;
 		/** Increment index, persist to OPFS, and record for later assertions. */
@@ -75,7 +75,7 @@ async function produceTestZip(opts) {
 			allActions.push(action);
 		};
 		await writeAndRecordAction({
-			type: "recorder/startSession",
+			type: "recording/startSession",
 			payload: {
 				scenarioName: options.scenarioName,
 				sessionName,
@@ -174,12 +174,12 @@ async function produceTestZip(opts) {
 			version: 1,
 			startedAt: options.sessionTimestamp.toISOString(),
 			endedAt: new Date(options.sessionTimestamp.getTime() + actionIndex * 1e3 + 5e3).toISOString(),
-			scenarioName: options.scenarioName,
+			contextTag: options.scenarioName,
 			actionCount: actionIndex,
 			frameCount: options.frameCount,
 			userAgent: options.deviceInfo
 		});
-		const { blob } = await exportSessionAsZip(scenarioName, sessionName);
+		const { blob } = await exportSessionAsZip(sessionName);
 		return {
 			zipData: new Uint8Array(await blob.arrayBuffer()),
 			totalActionCount: actionIndex,

package/dist/visualization/gps-anchored-mesh-manager.d.ts

@@ -0,0 +1,2 @@
+import { n as GpsAnchoredMeshManager, r as GpsAnchoredMeshManagerOptions, t as GpsAnchoredItem } from "../gps-anchored-mesh-manager-CovAFK4g.js";
+export { GpsAnchoredItem, GpsAnchoredMeshManager, GpsAnchoredMeshManagerOptions };

package/dist/visualization/gps-anchored-mesh-manager.js

@@ -0,0 +1,128 @@
+import { createLogger } from "../utils/logger.js";
+import { disposeMeshArray } from "./three-dispose.js";
+import { getScene } from "../ar/webxr-session.js";
+import * as THREE from "three";
+import { calcRelativeCoordsInMeters } from "gps-plus-slam-js";
+//#region ../src/visualization/gps-anchored-mesh-manager.ts
+/**
+* GPS-Anchored Mesh Manager
+*
+* Generic mechanism for placing Three.js meshes at GPS coordinates relative
+* to a configured GPS zero reference. This is the recorder-agnostic core
+* that was extracted in Iter 4 from the recorder-flavoured
+* `RefPointVisualizer` (which now lives in the RecorderApp and composes two
+* instances of this manager — prior=green, current=red).
+*
+* The manager is intentionally narrow: it knows how to convert
+* `{ lat, lon, altitude? }` into local meters via the framework's GPS zero
+* reference, allocate a single shared geometry + material per instance, and
+* keep the resulting mesh group in sync with caller-provided items. It does
+* not know anything about ref points, sessions, or recorder semantics.
+*/
+const DEFAULT_RADIUS = .1;
+/**
+* Manages a single colored mesh group anchored to GPS coordinates.
+* One instance == one color/group.
+*/
+var GpsAnchoredMeshManager = class {
+	color;
+	radius;
+	namePrefix;
+	log;
+	meshes = [];
+	zeroRef = null;
+	geometry = null;
+	material = null;
+	constructor(options) {
+		this.color = options.color;
+		this.radius = options.radius ?? DEFAULT_RADIUS;
+		this.namePrefix = options.namePrefix;
+		this.log = createLogger(options.loggerLabel ?? "GpsAnchoredMeshManager");
+	}
+	/** Set the GPS origin used to project items into local meters. */
+	setZeroRef(zero) {
+		this.zeroRef = zero;
+	}
+	getZeroRef() {
+		return this.zeroRef;
+	}
+	/**
+	* Replace the entire mesh group with one mesh per provided item.
+	* Items without GPS or before `setZeroRef` are skipped.
+	*/
+	setItems(items) {
+		if (!this.zeroRef) {
+			this.log.warn("No zero reference set");
+			return;
+		}
+		const scene = getScene();
+		if (!scene) {
+			this.log.warn("Scene not available");
+			return;
+		}
+		this.clear();
+		const geometry = this.geometry ??= new THREE.SphereGeometry(this.radius, 16, 16);
+		const material = this.material ??= new THREE.MeshBasicMaterial({ color: this.color });
+		let visibleCount = 0;
+		for (const item of items) {
+			const coords = calcRelativeCoordsInMeters(this.zeroRef, {
+				lat: item.lat,
+				lon: item.lon
+			}, item.altitude ?? 0, 0);
+			const mesh = new THREE.Mesh(geometry, material);
+			mesh.position.set(coords[0], coords[1], coords[2]);
+			mesh.name = `${this.namePrefix}-${item.id}`;
+			scene.add(mesh);
+			this.meshes.push(mesh);
+			visibleCount++;
+		}
+		this.log.info(`Displayed ${visibleCount}/${items.length} anchored meshes`);
+	}
+	/** Append a single item to the existing mesh group. */
+	addItem(item) {
+		if (!this.zeroRef) {
+			this.log.warn("Cannot add item — no zero reference");
+			return;
+		}
+		const scene = getScene();
+		if (!scene) {
+			this.log.warn("Scene not available");
+			return;
+		}
+		const geometry = this.geometry ??= new THREE.SphereGeometry(this.radius, 16, 16);
+		const material = this.material ??= new THREE.MeshBasicMaterial({ color: this.color });
+		const coords = calcRelativeCoordsInMeters(this.zeroRef, {
+			lat: item.lat,
+			lon: item.lon
+		}, item.altitude ?? 0, 0);
+		const mesh = new THREE.Mesh(geometry, material);
+		mesh.position.set(coords[0], coords[1], coords[2]);
+		mesh.name = `${this.namePrefix}-${item.id}`;
+		scene.add(mesh);
+		this.meshes.push(mesh);
+		this.log.info(`Added anchored mesh: ${item.id}`);
+	}
+	/** Remove all meshes and dispose the shared geometry/material. */
+	clear() {
+		const scene = getScene();
+		disposeMeshArray(this.meshes, scene, {
+			skipGeometry: true,
+			skipMaterial: true
+		});
+		this.geometry?.dispose();
+		this.geometry = null;
+		this.material?.dispose();
+		this.material = null;
+	}
+	/** Number of meshes currently rendered. */
+	getCount() {
+		return this.meshes.length;
+	}
+	/** Convenience: clear and forget the zero reference. */
+	dispose() {
+		this.clear();
+		this.zeroRef = null;
+	}
+};
+//#endregion
+export { GpsAnchoredMeshManager };

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-C-6JEnpR.js";
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-jRIJMOuh.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, t as GpsEventVisualizer } from "../gps-event-markers-DpEy2qRd.js";
+import { n as gpsEventVisualizer, t as GpsEventVisualizer } from "../gps-event-markers-sVyO9utS.js";
 export { GpsEventVisualizer, gpsEventVisualizer };

package/dist/visualization/index.d.ts

@@ -1,12 +1,12 @@
 import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-BMqPddxx.js";
 import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-D9BeDwZX.js";
 import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-rgLMVAvd.js";
-import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-C-6JEnpR.js";
-import { n as gpsEventVisualizer, t as GpsEventVisualizer } from "../gps-event-markers-DpEy2qRd.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-CvfQXTye.js";
-import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-87NWjUOD.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-DuiZuCTx.js";
-import { n as refPointVisualizer, t as RefPointVisualizer } from "../reference-points-CFWy8_wj.js";
-import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-CCBHjE_a.js";
-import { t as VIS_COLORS } from "../vis-colors-Qi2vlRGt.js";
-export { type AlignmentLerper, 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 GpsCompassCubes, GpsEventVisualizer, LeafletMapOverlay, type LeafletMapOverlayOptions, MapOverlay, type MapOverlayOptions, RefPointVisualizer, type TextureLoaderInterface, VIS_COLORS, clampedAlpha, createAlignmentLerper, createCameraFollower, createCss3dRendererManager, createGpsCompassCubes, disposeMeshArray, disposeObject3D, gpsEventVisualizer, latLonToTileXY, refPointVisualizer, tileXYToLatLon };
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-jRIJMOuh.js";
+import { n as gpsEventVisualizer, t as GpsEventVisualizer } from "../gps-event-markers-sVyO9utS.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-CQZcnxbc.js";
+import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-CZgQlrmu.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-C9ifl_4-.js";
+import { n as GpsAnchoredMeshManager, r as GpsAnchoredMeshManagerOptions, t as GpsAnchoredItem } from "../gps-anchored-mesh-manager-CovAFK4g.js";
+import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-qt_r5wR1.js";
+import { t as VIS_COLORS } from "../vis-colors-BKkdTIKb.js";
+export { type AlignmentLerper, 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 GpsAnchoredItem, GpsAnchoredMeshManager, type GpsAnchoredMeshManagerOptions, type GpsCompassCubes, GpsEventVisualizer, LeafletMapOverlay, type LeafletMapOverlayOptions, MapOverlay, type MapOverlayOptions, type TextureLoaderInterface, VIS_COLORS, clampedAlpha, createAlignmentLerper, createCameraFollower, createCss3dRendererManager, createGpsCompassCubes, disposeMeshArray, disposeObject3D, gpsEventVisualizer, latLonToTileXY, tileXYToLatLon };

package/dist/visualization/index.js

@@ -8,5 +8,5 @@ import { COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, createGpsCompassCubes } from
 import { GpsEventVisualizer, gpsEventVisualizer } from "./gps-event-markers.js";
 import { DEFAULT_LEAFLET_MAP_SIZE_PX, DEFAULT_WORLD_SIZE, DEFAULT_Z_OFFSET, LeafletMapOverlay } from "./leaflet-map-overlay.js";
 import { DEFAULT_HEIGHT_OFFSET, DEFAULT_MAP_SIZE, DEFAULT_ZOOM, MapOverlay, latLonToTileXY, tileXYToLatLon } from "./map-overlay.js";
-import { RefPointVisualizer, refPointVisualizer } from "./reference-points.js";
-export { COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, DEFAULT_HEIGHT_OFFSET, DEFAULT_LEAFLET_MAP_SIZE_PX, DEFAULT_LERP_RATE, DEFAULT_MAP_SIZE, DEFAULT_WORLD_SIZE, DEFAULT_ZOOM, DEFAULT_Z_OFFSET, GpsEventVisualizer, LeafletMapOverlay, MapOverlay, RefPointVisualizer, VIS_COLORS, clampedAlpha, createAlignmentLerper, createCameraFollower, createCss3dRendererManager, createGpsCompassCubes, disposeMeshArray, disposeObject3D, gpsEventVisualizer, latLonToTileXY, refPointVisualizer, tileXYToLatLon };
+import { GpsAnchoredMeshManager } from "./gps-anchored-mesh-manager.js";
+export { COMPASS_CUBE_DISTANCE, COMPASS_CUBE_SIZE, DEFAULT_HEIGHT_OFFSET, DEFAULT_LEAFLET_MAP_SIZE_PX, DEFAULT_LERP_RATE, DEFAULT_MAP_SIZE, DEFAULT_WORLD_SIZE, DEFAULT_ZOOM, DEFAULT_Z_OFFSET, GpsAnchoredMeshManager, GpsEventVisualizer, LeafletMapOverlay, MapOverlay, VIS_COLORS, clampedAlpha, createAlignmentLerper, createCameraFollower, createCss3dRendererManager, createGpsCompassCubes, disposeMeshArray, disposeObject3D, gpsEventVisualizer, latLonToTileXY, tileXYToLatLon };

package/dist/visualization/leaflet-map-overlay.d.ts

@@ -1,2 +1,2 @@
-import { a as DEFAULT_Z_OFFSET, i as DEFAULT_ZOOM, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions, t as DEFAULT_HEIGHT_OFFSET } from "../leaflet-map-overlay-CvfQXTye.js";
+import { a as DEFAULT_Z_OFFSET, i as DEFAULT_ZOOM, n as DEFAULT_LEAFLET_MAP_SIZE_PX, o as LeafletMapOverlay, r as DEFAULT_WORLD_SIZE, s as LeafletMapOverlayOptions, t as DEFAULT_HEIGHT_OFFSET } from "../leaflet-map-overlay-CQZcnxbc.js";
 export { DEFAULT_HEIGHT_OFFSET, DEFAULT_LEAFLET_MAP_SIZE_PX, DEFAULT_WORLD_SIZE, DEFAULT_ZOOM, DEFAULT_Z_OFFSET, LeafletMapOverlay, LeafletMapOverlayOptions };

package/dist/visualization/leaflet-map-overlay.js

@@ -38,7 +38,7 @@ var LeafletMapOverlay = class {
 	rawGpsPoints = [];
 	fusedPoints = [];
 	snapshotPoints = [];
-	refPoints = [];
+	namedMarkers = [];
 	userMarker = null;
 	rawGpsPolyline = null;
 	fusedPolyline = null;
@@ -126,9 +126,10 @@ var LeafletMapOverlay = class {
 			this.snapshotPolyline.addLatLng([lat, lon]);
 		}
 	}
-	addRefPoint(lat, lon, name) {
-		const marker = this.leafletMap ? this.createRefPointMarker(lat, lon, name, false) : null;
-		this.refPoints.push({
+	/** Add a "current" named marker (red). Buffered if map is not yet shown. */
+	addCurrentMarker(lat, lon, name) {
+		const marker = this.leafletMap ? this.createNamedMarker(lat, lon, name, false) : null;
+		this.namedMarkers.push({
 			lat,
 			lng: lon,
 			name,
@@ -136,9 +137,10 @@ var LeafletMapOverlay = class {
 			marker
 		});
 	}
-	addPriorRefPoint(lat, lon, name) {
-		const marker = this.leafletMap ? this.createRefPointMarker(lat, lon, name, true) : null;
-		this.refPoints.push({
+	/** Add a "prior" named marker (green, decorated). Buffered if not shown. */
+	addPriorMarker(lat, lon, name) {
+		const marker = this.leafletMap ? this.createNamedMarker(lat, lon, name, true) : null;
+		this.namedMarkers.push({
 			lat,
 			lng: lon,
 			name,
@@ -146,13 +148,15 @@ var LeafletMapOverlay = class {
 			marker
 		});
 	}
-	addPriorRefPoints(refPoints) {
-		for (const rp of refPoints) this.addPriorRefPoint(rp.lat, rp.lon, rp.name);
+	/** Bulk add prior markers. */
+	addPriorMarkers(markers) {
+		for (const m of markers) this.addPriorMarker(m.lat, m.lon, m.name);
 	}
-	clearPriorRefPoints() {
-		this.refPoints = this.refPoints.filter((rp) => {
-			if (rp.isPrior) {
-				rp.marker?.remove();
+	/** Remove all prior markers; current markers are unaffected. */
+	clearPriorMarkers() {
+		this.namedMarkers = this.namedMarkers.filter((m) => {
+			if (m.isPrior) {
+				m.marker?.remove();
 				return false;
 			}
 			return true;
@@ -198,7 +202,7 @@ var LeafletMapOverlay = class {
 		this.rawGpsPoints = [];
 		this.fusedPoints = [];
 		this.snapshotPoints = [];
-		this.refPoints = [];
+		this.namedMarkers = [];
 		this.cssObject = null;
 		log.info("Leaflet map overlay disposed");
 	}
@@ -236,9 +240,9 @@ var LeafletMapOverlay = class {
 		this.fusedPolyline = null;
 		this.snapshotPolyline?.remove();
 		this.snapshotPolyline = null;
-		for (const rp of this.refPoints) {
-			rp.marker?.remove();
-			rp.marker = null;
+		for (const m of this.namedMarkers) {
+			m.marker?.remove();
+			m.marker = null;
 		}
 		if (this.leafletMap) {
 			this.leafletMap.remove();
@@ -285,7 +289,7 @@ var LeafletMapOverlay = class {
 			weight: 3,
 			opacity: .8
 		}).addTo(this.leafletMap);
-		for (const rp of this.refPoints) if (!rp.marker) rp.marker = this.createRefPointMarker(rp.lat, rp.lng, rp.name, rp.isPrior);
+		for (const m of this.namedMarkers) if (!m.marker) m.marker = this.createNamedMarker(m.lat, m.lng, m.name, m.isPrior);
 	}
 	updateUserMarker() {
 		if (!this.gpsPosition || !this.leafletMap) return;
@@ -297,7 +301,7 @@ var LeafletMapOverlay = class {
 			iconAnchor: [7, 7]
 		}) }).addTo(this.leafletMap);
 	}
-	createRefPointMarker(lat, lon, name, isPrior) {
+	createNamedMarker(lat, lon, name, isPrior) {
 		const color = isPrior ? VIS_COLORS.PRIOR_REF_POINT.css : VIS_COLORS.CURRENT_REF_POINT.css;
 		const opacity = isPrior ? "opacity:0.8;" : "";
 		const label = isPrior ? `📌 ${name} (prior)` : name;

package/dist/visualization/lerp-utils.d.ts

@@ -1,2 +1,2 @@
-import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-87NWjUOD.js";
+import { n as clampedAlpha, t as DEFAULT_LERP_RATE } from "../lerp-utils-CZgQlrmu.js";
 export { DEFAULT_LERP_RATE, clampedAlpha };

package/dist/visualization/map-overlay.d.ts

@@ -1,2 +1,2 @@
-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-DuiZuCTx.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-C9ifl_4-.js";
 export { DEFAULT_HEIGHT_OFFSET, DEFAULT_MAP_SIZE, DEFAULT_ZOOM, MapOverlay, MapOverlayOptions, TextureLoaderInterface, latLonToTileXY, tileXYToLatLon };

package/dist/visualization/three-dispose.d.ts

@@ -1,2 +1,2 @@
-import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-CCBHjE_a.js";
+import { n as disposeMeshArray, r as disposeObject3D, t as DisposeOptions } from "../three-dispose-qt_r5wR1.js";
 export { DisposeOptions, disposeMeshArray, disposeObject3D };

package/dist/visualization/vis-colors.d.ts

@@ -1,2 +1,2 @@
-import { t as VIS_COLORS } from "../vis-colors-Qi2vlRGt.js";
+import { t as VIS_COLORS } from "../vis-colors-BKkdTIKb.js";
 export { VIS_COLORS };