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

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

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

package/dist/storage/index.d.ts

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

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

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

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

@@ -1,2 +1,2 @@
-import { t as OpfsStorageBackend } from "../opfs-storage-backend-Cj_7PWoq.js";
+import { t as OpfsStorageBackend } from "../opfs-storage-backend-u4QKvgvP.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-DOPkzgeT.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-LsLY6VZV.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-CT0Il_AB.js";
+import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-yDSKafAQ.js";
 export { CreateSessionResult, StorageBackend };

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/{tracking-slice-utCNND8t.d.ts → tracking-slice-CDREeoZ_.d.ts}

@@ -1,4 +1,4 @@
-import { t as ARPose } from "./ar-types-Ck8LEq8k.js";
+import { t as ARPose } from "./ar-types-isPsQptb.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 WebXRQuaternion, i as DepthSample, n as ArPoseTuples, o as WebXRVec3, r as DepthPoint, t as ARPose } from "../ar-types-Ck8LEq8k.js";
+import { a as WebXRQuaternion, i as DepthSample, n as ArPoseTuples, o as WebXRVec3, r as DepthPoint, t as ARPose } from "../ar-types-isPsQptb.js";
 export { ARPose, ArPoseTuples, DepthPoint, DepthSample, 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-CTuF23gG.js";
+import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-clgzl8b5.js";
 export { GpsCoord, RawGpsSample, RefPointMarker };

package/dist/types/index.d.ts

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

package/dist/utils/concurrency.d.ts

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

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

@@ -1,2 +1,2 @@
-import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-DnHXOIRa.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-D7ELffm0.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-BTS5H62-.js";
+import { t as formatFileSize } from "../format-file-size-B7gJb3Md.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-CB4DwWOG.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-BdVHmDW9.js";
 export { FusedPathInput, computeFusedPath, fusedGpsFromOdom };

package/dist/utils/index.d.ts

@@ -1,7 +1,7 @@
-import { a as createLogger, c as setGlobalLogLevel, i as clearLogBuffer, l as subscribeToLogs, n as LogLevel, o as getGlobalLogLevel, r as Logger, s as getLogBuffer, t as LogEntry } from "../logger-C9vugiQb.js";
-import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-CB4DwWOG.js";
-import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-DnHXOIRa.js";
-import { t as mapWithConcurrencyLimit } from "../concurrency-CMw8pSaG.js";
-import { t as formatFileSize } from "../format-file-size-BTS5H62-.js";
-import { t as listFormatter } from "../list-formatter-CNqi-E2j.js";
+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-BZ44Dhd3.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-BdVHmDW9.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-D7ELffm0.js";
+import { t as mapWithConcurrencyLimit } from "../concurrency-Bsmv53qw.js";
+import { t as formatFileSize } from "../format-file-size-B7gJb3Md.js";
+import { t as listFormatter } from "../list-formatter-CsqcU4v5.js";
 export { type FailureTracker, type FailureTrackerConfig, type FusedPathInput, type LogEntry, LogLevel, type Logger, clearLogBuffer, computeFusedPath, createFailureTracker, createLogger, formatFileSize, fusedGpsFromOdom, getGlobalLogLevel, getLogBuffer, listFormatter, mapWithConcurrencyLimit, setGlobalLogLevel, subscribeToLogs };

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

@@ -1,2 +1,2 @@
-import { t as listFormatter } from "../list-formatter-CNqi-E2j.js";
+import { t as listFormatter } from "../list-formatter-CsqcU4v5.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-C9vugiQb.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-BZ44Dhd3.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-CsxE_7x1.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-DEKr0Hoh.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-L1RbWHQ4.js";
+import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-CCZJf-Xb.js";
 export { AlignmentLerper, createAlignmentLerper };

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

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

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

@@ -0,0 +1,51 @@
+import { registerFrameUpdate } from "../ar/frame-loop.js";
+import { t as registerSessionDisposer } from "../session-disposers-M-oashRH.js";
+import { createAlignmentLerper } from "./alignment-lerper.js";
+import { selectAlignmentMatrix } from "../state/app-selectors.js";
+import { subscribeToSelector } from "../state/subscribe-to-selector.js";
+//#region ../src/visualization/ar-world-group-alignment.ts
+/**
+* Begin applying the store's (lerped) alignment to `arWorldGroup`. Returns a
+* handle whose `dispose()` removes both the store subscription and the
+* per-frame update.
+*
+* Disposal is tied to the AR session lifecycle: the binding registers itself
+* with the session-disposer registry that `resetWebXRState()` flushes on
+* teardown, so a caller can `enableArWorldGroupAlignment(...)` once and never
+* hold the handle — the binding cannot outlive the session (which is what two
+* apps independently leaked: the store subscription survives a teardown because
+* `clearFrameUpdates` only drops the per-frame tick). Because `initAR()` throws
+* while a prior session is live, every restart passes through that flush. The
+* handle is still returned for callers that want to stop alignment mid-session,
+* and is idempotent + self-deregistering so a manual `dispose()` and the
+* teardown flush never double-run. See
+* gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-06-08-arworldgroup-alignment-session-scoped-disposal.md.
+*
+* Double-drive is still the caller's concern: the recorder owns its own lerper
+* and must NOT also call this (it would double-lerp the same group). It does not
+* call this helper, so flushing the registry on teardown never affects it.
+*/
+function enableArWorldGroupAlignment(options) {
+	const lerper = createAlignmentLerper(options.arWorldGroup, options.lerpRate);
+	const current = selectAlignmentMatrix(options.store.getState());
+	if (current !== null && current !== void 0) lerper.setTarget(current);
+	const unsubscribe = subscribeToSelector(options.store, selectAlignmentMatrix, (matrix) => {
+		if (matrix !== null && matrix !== void 0) lerper.setTarget(matrix);
+	});
+	const unregister = registerFrameUpdate((dt) => {
+		lerper.update(dt);
+	});
+	let disposed = false;
+	const handle = { dispose() {
+		if (disposed) return;
+		disposed = true;
+		unsubscribe();
+		unregister();
+		lerper.dispose();
+		deregisterSessionDisposer();
+	} };
+	const deregisterSessionDisposer = registerSessionDisposer(() => handle.dispose());
+	return handle;
+}
+//#endregion
+export { enableArWorldGroupAlignment };

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

@@ -1,2 +1,2 @@
-import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-1k8mnw5J.js";
+import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-B-nS1sr6.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-CkjCb2HW.js";
+import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-EDED3nvg.js";
 export { Css3dRendererManager, createCss3dRendererManager };

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

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

package/dist/visualization/frame-conversions.js

@@ -0,0 +1,88 @@
+import { calcGpsCoords } from "../core/index.js";
+import * as THREE from "three";
+//#region ../src/visualization/frame-conversions.ts
+/**
+* `frame-conversions` — small, pure coordinate-frame helpers for the AR scene
+* graph. Currently a single function, `nueToArLocal`, that converts a
+* GPS-world NUE point into the AR-odometry local frame of `arWorldGroup`.
+*
+* Background: the scene root is GPS-world NUE; `arWorldGroup.matrix` IS the
+* alignment matrix, which maps **AR-odometry NUE → GPS-world NUE**. So a
+* direct child of `arWorldGroup` whose WORLD position must equal a GPS-world
+* point `nue` has to store `alignment⁻¹ · nue` as its LOCAL position —
+* writing raw `nue` double-applies the alignment. Getting this wrong was the
+* alignment-frame bug
+* (gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-05-31-gps-anchor-alignment-frame-bug.md);
+* this helper centralises the conversion behind one tested, well-named seam.
+*
+* Design (see the plan
+* gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-05-31-nue-to-ar-local-helper-plan.md):
+*  - **Takes the explicit alignment matrix array**, NOT `Object3D.worldToLocal`.
+*    `worldToLocal` would read the live, mid-lerp `matrixWorld` and break
+*    replay determinism; the explicit target matrix keeps the result a pure
+*    function of its inputs. Full rationale in the review doc
+*    (gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-05-31-worldtolocal-frame-helper-review.md).
+*  - **Positions only.** No pose/quaternion variant exists until a caller
+*    needs one (YAGNI). No caller currently sets a GPS-world rotation.
+*/
+const scratchMatrix = new THREE.Matrix4();
+/**
+* Convert a GPS-world NUE point into the AR-local position to write into a
+* direct child of `arWorldGroup`, given the current alignment matrix.
+*
+* Computes `alignment⁻¹ · nue`. When the result is later composed back by the
+* group's matrix (the same `alignment`), the child's WORLD position equals
+* `nue` exactly.
+*
+* @param alignment - The alignment matrix as a 16-element **column-major**
+*   array (AR-odometry NUE → GPS-world NUE), e.g. from `getAlignmentMatrix()`
+*   or `THREE.Matrix4.toArray()`. Not mutated.
+* @param nue - The GPS-world NUE point `[north, up, east]` in metres. Not
+*   mutated.
+* @param out - Optional target vector to write into and return (pass a reused
+*   scratch to avoid allocation on hot paths). Defaults to a fresh
+*   `THREE.Vector3`.
+* @returns `out`, set to the AR-local position.
+*/
+function nueToArLocal(alignment, nue, out = new THREE.Vector3()) {
+	scratchMatrix.fromArray(alignment).invert();
+	return out.set(nue[0], nue[1], nue[2]).applyMatrix4(scratchMatrix);
+}
+/**
+* Convert an object's **GPS-world NUE world position** back into a GPS
+* coordinate, for the GPS-anchor bootstrap that medians where an object was
+* actually placed (mirrors the C# `DetermineAndStoreGpsWorldPose`, which
+* medians the object's world pose and converts via `zero.CalcGpsCoordsOf`).
+*
+* Precondition: `worldNue` must already be in GPS-world NUE — i.e. the object
+* lives under an `arWorldGroup` whose `.matrix` carries the alignment (see
+* `enableArWorldGroupAlignment`), so `object3D.getWorldPosition()` is the
+* GPS-world position. Sampling a pure-VIO (identity-`arWorldGroup`) world
+* position would yield a wrong GPS coordinate.
+*
+* Altitude round-trip: `calcGpsCoords` returns only `lat`/`lon` (it derives
+* them from the North/East axes and ignores Up). The Up axis (`worldNue.y`,
+* NUE index 1) is carried through verbatim as `altitude`, so a later
+* `calcRelativeCoordsInMeters(zero, result, result.altitude, 0)` reproduces the
+* same Up value — keeping the steady-state vertical target consistent with
+* where the object was sampled.
+*
+* @param worldNue - The object's world position in GPS-world NUE metres
+*   (`x = North`, `y = Up`, `z = East`). A `THREE.Vector3` satisfies this.
+* @param zero - The GPS zero reference (origin for the conversion).
+* @returns The GPS coordinate of `worldNue`, with `altitude = worldNue.y`.
+*/
+function worldNueToGps(worldNue, zero) {
+	const gps = calcGpsCoords(zero, [
+		worldNue.x,
+		worldNue.y,
+		worldNue.z
+	]);
+	return {
+		lat: gps.lat,
+		lon: gps.lon,
+		altitude: worldNue.y
+	};
+}
+//#endregion
+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-BHnFrSKQ.js";
+import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-DGnJqls0.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-CnWY61XK.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-CISLPQIb.js";
 export { GpsAnchor, GpsAnchorMode, GpsAnchorOptions, GpsAnchorPhase, GpsAnchorSamplePoint, createGpsAnchor };

package/dist/visualization/gps-anchor.js

@@ -1,2 +1,217 @@
-import { t as createGpsAnchor } from "../gps-anchor-DjC_3MoT.js";
+import { registerFrameUpdate } from "../ar/frame-loop.js";
+import { isObjectInCameraFrustum } from "./frustum-visibility.js";
+import { calcRelativeCoordsInMeters } from "../core/index.js";
+import { nueToArLocal } from "./frame-conversions.js";
+import * as THREE from "three";
+//#region ../src/visualization/gps-anchor.ts
+/**
+* `createGpsAnchor` — GPS-anchored placement of a single `THREE.Object3D`.
+*
+* See the colocated sidecar (`gps-anchor.ts.md`) and the port plan at
+* `gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-05-13-gps-anchor-port-plan.md`
+* for the full design, state machine, and test matrix.
+*
+* This file implements sub-steps 2 (bootstrap phase), 3 (steady-state
+* `'snap-every-tick'` + distance-scaled threshold gate), and 4
+* (`'snap-when-offscreen'` mode gate, with a one-time initial-placement
+* exemption for `skipBootstrap` anchors). Floor-Y correction is sub-step
+* 6 and remains deferred.
+*/
+/**
+* Module-level registry of objects currently owned by a `GpsAnchor`.
+* Used to detect nested anchors (parent + child both anchored) which
+* we explicitly forbid; mirrors the C# invariant.
+*/
+const anchoredObjects = /* @__PURE__ */ new WeakSet();
+function isObjectInAnchoredChain(object) {
+	let cursor = object;
+	while (cursor) {
+		if (anchoredObjects.has(cursor)) return true;
+		cursor = cursor.parent;
+	}
+	return false;
+}
+/**
+* Returns true iff `object` is `arWorldGroup` itself or a descendant of it.
+* The anchor's `object3D` MUST satisfy this: only then does it ride the
+* alignment applied to `arWorldGroup.matrix` (the node the camera also lives
+* under) via scene-graph propagation. An anchor parented to the scene root
+* instead never receives the alignment, so each steady-state re-registration
+* snaps the full alignment delta and the object visibly slides as the user
+* moves — the exact instability the anchor exists to prevent.
+*/
+function isDescendantOf(object, arWorldGroup) {
+	let cursor = object;
+	while (cursor) {
+		if (cursor === arWorldGroup) return true;
+		cursor = cursor.parent;
+	}
+	return false;
+}
+function median(values) {
+	const sorted = [...values].sort((a, b) => a - b);
+	const mid = Math.floor(sorted.length / 2);
+	if (sorted.length % 2 === 0) return (sorted[mid - 1] + sorted[mid]) / 2;
+	return sorted[mid];
+}
+function medianPoint(samples) {
+	const lat = median(samples.map((s) => s.lat));
+	const lon = median(samples.map((s) => s.lon));
+	const alts = samples.map((s) => "altitude" in s ? s.altitude : void 0).filter((a) => typeof a === "number");
+	if (alts.length > 0) return {
+		lat,
+		lon,
+		altitude: median(alts)
+	};
+	return {
+		lat,
+		lon
+	};
+}
+function createGpsAnchor(options) {
+	if (isObjectInAnchoredChain(options.object3D)) throw new Error("createGpsAnchor: nested GpsAnchors are not supported — the supplied object3D is already inside an anchored parent chain.");
+	if (!isDescendantOf(options.object3D, options.arWorldGroup)) throw new Error("createGpsAnchor: object3D must be a descendant of arWorldGroup (the alignment-bearing node the camera lives under); parenting an anchor to the scene root defeats AR stability.");
+	anchoredObjects.add(options.object3D);
+	const sampleCount = options.secondsToAccumulateGpsPose ?? 7;
+	if (sampleCount < 1) {
+		anchoredObjects.delete(options.object3D);
+		throw new Error("createGpsAnchor: secondsToAccumulateGpsPose must be >= 1 — use skipBootstrap:true to bypass the accumulation phase.");
+	}
+	const settlingSeconds = options.settlingSeconds ?? 0;
+	const distanceThreshold = options.distanceThreshold ?? 2;
+	options.angleThresholdInDegrees;
+	const mode = options.mode ?? "snap-when-offscreen";
+	const scratchTarget = new THREE.Vector3();
+	const scratchCamWorld = new THREE.Vector3();
+	const scratchObjWorld = new THREE.Vector3();
+	let phase = options.skipBootstrap === true ? "anchored" : "bootstrap";
+	let isFullyAnchored = phase === "anchored";
+	let gpsPoint = options.gpsPoint;
+	let phaseEnteredAtElapsed = null;
+	let lastSampleAtElapsed = null;
+	const samples = [];
+	/**
+	* The one-time "initial placement" exemption from the `snap-when-offscreen`
+	* frustum gate. A `skipBootstrap` anchor is `anchored` from frame one but its
+	* `object3D` still sits at the AR origin (local 0,0,0 — "inside the user")
+	* until its first steady-state commit. That first commit MUST land even while
+	* the object is on-screen, otherwise the marker stays stuck at the origin
+	* until the user happens to look away. A fresh appearance is not a "jump", so
+	* it is exempt. Consumed (set false) by the first committed correction; never
+	* re-armed (a re-bootstrap moves an already-placed object, so its later
+	* corrections are normal gated snaps). Anchors that bootstrap are placed at
+	* their seed pose by the host, so they never need this exemption — hence it is
+	* armed only for `skipBootstrap`.
+	*/
+	let firstCommitPending = options.skipBootstrap === true;
+	const enterBootstrap = () => {
+		phase = "bootstrap";
+		isFullyAnchored = false;
+		phaseEnteredAtElapsed = null;
+		lastSampleAtElapsed = null;
+		samples.length = 0;
+	};
+	const commitMedian = () => {
+		gpsPoint = medianPoint(samples);
+		phase = "anchored";
+		isFullyAnchored = true;
+		samples.length = 0;
+		options.onBootstrapComplete?.(gpsPoint);
+	};
+	/**
+	* Steady-state: compute the GPS-world NUE target from the stored
+	* `gpsPoint` and the current `zeroRef`, map it into `arWorldGroup`'s
+	* AR-local frame via the inverse alignment matrix, and commit it to
+	* `object3D.position` iff the (AR-local) position delta exceeds the
+	* distance-scaled threshold AND the mode gate allows it.
+	*
+	* Mode gate: in `'snap-when-offscreen'` a correction is suppressed while the
+	* object is inside the camera frustum — corrections only land when the user
+	* is not looking, so the anchor never visibly jumps. The whole AR frame
+	* (camera + every anchor) rides one lerped `arWorldGroup.matrix`
+	* (`enableArWorldGroupAlignment`), so an on-screen alignment change is
+	* absorbed smoothly for the entire view and never needs a per-anchor
+	* on-screen snap. The one exception is the first placement of a `skipBootstrap`
+	* anchor (see `firstCommitPending`), which must escape the origin even while
+	* on-screen. See
+	* `gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-06-06-anchor-starter-cachehit-jump-investigation.md`.
+	*
+	* Frame note: `arWorldGroup.matrix` IS the alignment matrix, which maps
+	* **AR-odometry NUE → GPS-world NUE**. `object3D.position` is a *local*
+	* transform in that AR-odometry frame. To make the object's *world*
+	* position equal the GPS-world `nue`, the local target must be
+	* `alignment⁻¹ · nue` — writing raw `nue` would double-apply the
+	* alignment (world = `alignment · nue`). See
+	* `gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-05-31-gps-anchor-alignment-frame-bug.md`.
+	*
+	* Returns silently on missing inputs (no `zeroRef`, or no alignment
+	* matrix yet — an AR-local object cannot be placed without knowing the
+	* AR↔NUE transform).
+	*/
+	const maybeCommitSteadyState = () => {
+		const zero = options.getGpsZeroRef();
+		if (zero === null || zero === void 0) return;
+		const currentAlignment = options.getAlignmentMatrix();
+		if (currentAlignment === null || currentAlignment === void 0) return;
+		const targetAlt = "altitude" in gpsPoint && typeof gpsPoint.altitude === "number" ? gpsPoint.altitude : 0;
+		const nue = calcRelativeCoordsInMeters(zero, gpsPoint, targetAlt, 0);
+		nueToArLocal(currentAlignment, [
+			nue[0],
+			nue[1],
+			nue[2]
+		], scratchTarget);
+		options.camera.getWorldPosition(scratchCamWorld);
+		options.object3D.getWorldPosition(scratchObjWorld);
+		const scale = 1 + 10 * scratchCamWorld.distanceTo(scratchObjWorld) / 100;
+		if (options.object3D.position.distanceTo(scratchTarget) >= distanceThreshold * scale) {
+			if (!(mode === "snap-when-offscreen" && !firstCommitPending && isObjectInCameraFrustum(options.camera, options.object3D))) {
+				options.object3D.position.copy(scratchTarget);
+				firstCommitPending = false;
+			}
+		}
+	};
+	const tick = (_dt, elapsed) => {
+		if (phase === "anchored") {
+			maybeCommitSteadyState();
+			return;
+		}
+		if (phaseEnteredAtElapsed === null) {
+			phaseEnteredAtElapsed = elapsed;
+			lastSampleAtElapsed = elapsed - 1;
+		}
+		if (elapsed - phaseEnteredAtElapsed < settlingSeconds) return;
+		if (lastSampleAtElapsed !== null && elapsed - lastSampleAtElapsed < 1) return;
+		const sample = options.getCurrentGpsPoint();
+		if (sample === null || sample === void 0) return;
+		samples.push(sample);
+		lastSampleAtElapsed = elapsed;
+		if (samples.length >= sampleCount) commitMedian();
+	};
+	const unregister = registerFrameUpdate(tick);
+	return {
+		get phase() {
+			return phase;
+		},
+		get isFullyAnchored() {
+			return isFullyAnchored;
+		},
+		get gpsPoint() {
+			return gpsPoint;
+		},
+		markMovedExternally() {
+			enterBootstrap();
+		},
+		setGpsPoint(point) {
+			gpsPoint = point;
+		},
+		dispose() {
+			unregister();
+			anchoredObjects.delete(options.object3D);
+		},
+		__tickForTests(dt, elapsed) {
+			tick(dt, elapsed);
+		}
+	};
+}
+//#endregion
 export { 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-CsLtFv4B.js";
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-Ys6Hf1nc.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-BGr-iLvi.js";
+import { n as GpsEventVisualizer, r as gpsEventVisualizer, t as GpsEventAccuracy } from "../gps-event-markers-BlHq3jYV.js";
 export { GpsEventAccuracy, GpsEventVisualizer, gpsEventVisualizer };

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

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