gps-plus-slam-app-framework 1.9.0 → 1.10.0

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

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

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

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

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

@@ -1,2 +1,2 @@
-import { t as embedCoverageInSessionJson } from "../zip-coverage-embed-ncVbaZAz.js";
+import { t as embedCoverageInSessionJson } from "../zip-coverage-embed-BrodRLq0.js";
 export { embedCoverageInSessionJson };

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

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

package/dist/storage/zip-export.js

@@ -1,4 +1,5 @@
 import { createLogger } from "../utils/logger.js";
+import { getSessionsRootHandle } from "./opfs-storage.js";
 import { BlobReader, BlobWriter, ZipWriter } from "@zip.js/zip.js";
 //#region ../src/storage/zip-export.ts
 /**
@@ -20,10 +21,15 @@ import { BlobReader, BlobWriter, ZipWriter } from "@zip.js/zip.js";
 */
 const log = createLogger("ZipExport");
 /**
-* Get the OPFS sessions directory handle (flat layout).
+* Get the OPFS sessions directory handle from the layout owner
+* (quality-review G-9 — this used to re-derive the
+* `'gps-plus-slam'/'sessions'` path itself, so a root re-nesting in
+* `opfs-storage.ts` would have silently broken export only).
 */
-async function getSessionsHandle() {
-	return (await (await navigator.storage.getDirectory()).getDirectoryHandle("gps-plus-slam")).getDirectoryHandle("sessions");
+function getSessionsHandle() {
+	const sessions = getSessionsRootHandle();
+	if (!sessions) throw new Error("OPFS storage not initialized — call initOpfsStorage() before exporting");
+	return sessions;
 }
 /**
 * Stream all files from a directory recursively into a ZipWriter.
@@ -65,7 +71,7 @@ async function streamDirectoryToZip(dirHandle, zipWriter, basePath = "") {
 */
 async function exportSessionAsZip(sessionName, options) {
 	log.info(`Exporting session: ${sessionName}`);
-	const sessionsDir = await getSessionsHandle();
+	const sessionsDir = getSessionsHandle();
 	let sessionHandle;
 	try {
 		sessionHandle = await sessionsDir.getDirectoryHandle(sessionName);

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

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

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

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

package/dist/{store-subscribers-DJUErW-o.d.ts → store-subscribers-DtwakLrQ.d.ts}

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

package/dist/{subscribe-to-selector-dQV8SpsO.d.ts → subscribe-to-selector-Cgo9JTfS.d.ts}

@@ -1,4 +1,4 @@
-import { N as CombinedRootState } from "./create-slam-app-store-D1QSMuKu.js";
+import { N as CombinedRootState } from "./create-slam-app-store-CH31erpP.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-Cc5yvBwn.js";
+import { o as WebXRQuaternion, s as WebXRVec3 } from "../ar-types-CBafnxhE.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-BzENzMH6.js";
+import { i as RecordedAction } from "../zip-reader-BHc_b_iA.js";
 import { LatLong } from "gps-plus-slam-js";
 
 //#region ../src/test-utils/zip-round-trip-helpers.d.ts

package/dist/{tracking-slice-DMkHlbny.d.ts → tracking-slice-Bt2OEQhA.d.ts}

@@ -1,4 +1,4 @@
-import { t as ARPose } from "./ar-types-Cc5yvBwn.js";
+import { t as ARPose } from "./ar-types-CBafnxhE.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-Cc5yvBwn.js";
-export { ARPose, ArPoseTuples, DepthPoint, DepthSample, RgbTuple, WebXRQuaternion, WebXRVec3 };
+import { a as RgbTuple, c as extractOdomPosition, i as DepthSample, l as extractOdomRotation, n as ArPoseTuples, o as WebXRQuaternion, r as DepthPoint, s as WebXRVec3, t as ARPose } from "../ar-types-CBafnxhE.js";
+export { ARPose, ArPoseTuples, DepthPoint, DepthSample, RgbTuple, WebXRQuaternion, WebXRVec3, extractOdomPosition, extractOdomRotation };

package/dist/types/ar-types.js

@@ -1 +1,31 @@
-export {};
+//#region ../src/types/ar-types.ts
+/**
+* Extract the raw odometry position tuple from an {@link ARPose}.
+*
+* Returns the raw WebXR position without coordinate conversion — the reducer
+* applies the WebXR→NUE transform when storing into state (raw-storage
+* pattern, see docs/2026-04-09-raw-storage-convert-on-read.md).
+* WebXR local-floor frame: X=East, Y=Up, Z=South (toward viewer / backward).
+*
+* Lives next to the type (quality-review G-8 — it used to sit in
+* `state/gps-event-coordinator.ts`, forcing an ar→state import in
+* `ar/depth-sampler.ts`).
+*/
+function extractOdomPosition(arPose) {
+	return [
+		arPose.position.x,
+		arPose.position.y,
+		arPose.position.z
+	];
+}
+/** Extract the raw odometry rotation tuple from an {@link ARPose}. */
+function extractOdomRotation(arPose) {
+	return [
+		arPose.orientation.x,
+		arPose.orientation.y,
+		arPose.orientation.z,
+		arPose.orientation.w
+	];
+}
+//#endregion
+export { extractOdomPosition, extractOdomRotation };

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

@@ -1,2 +1,2 @@
-import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-DrGVu8nS.js";
+import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-BfDK8kJu.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-Cc5yvBwn.js";
-import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-DrGVu8nS.js";
-export { ARPose, ArPoseTuples, DepthPoint, DepthSample, GpsCoord, RawGpsSample, RefPointMarker, RgbTuple, WebXRQuaternion, WebXRVec3 };
+import { a as RgbTuple, c as extractOdomPosition, i as DepthSample, l as extractOdomRotation, n as ArPoseTuples, o as WebXRQuaternion, r as DepthPoint, s as WebXRVec3, t as ARPose } from "../ar-types-CBafnxhE.js";
+import { n as RawGpsSample, r as RefPointMarker, t as GpsCoord } from "../geo-types-BfDK8kJu.js";
+export { ARPose, ArPoseTuples, DepthPoint, DepthSample, GpsCoord, RawGpsSample, RefPointMarker, RgbTuple, WebXRQuaternion, WebXRVec3, extractOdomPosition, extractOdomRotation };

package/dist/types/index.js

@@ -1 +1,2 @@
-export {};
+import { extractOdomPosition, extractOdomRotation } from "./ar-types.js";
+export { extractOdomPosition, extractOdomRotation };

package/dist/utils/concurrency.d.ts

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

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

@@ -1,2 +1,2 @@
-import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-CeKf5HIc.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-B7fzPfZo.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-DxN-EBLc.js";
+import { t as formatFileSize } from "../format-file-size-Da8rZgfs.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-C5pp0PJU.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-DOKzVMiO.js";
 export { FusedPathInput, computeFusedPath, fusedGpsFromOdom };

package/dist/utils/fused-path.js

@@ -1,5 +1,5 @@
-import { calcGpsCoords, fusedGpsFromOdom } from "gps-plus-slam-js";
 import { mat4, vec3 } from "gl-matrix";
+import { calcGpsCoords, fusedGpsFromOdom } from "gps-plus-slam-js";
 //#region ../src/utils/fused-path.ts
 /**
 * Fused Path Calculation

package/dist/utils/index.d.ts

@@ -1,8 +1,8 @@
-import { a as createLogger, c as setGlobalLogLevel, i as clearLogBuffer, l as subscribeToLogs, n as LogLevel, o as getGlobalLogLevel, r as Logger, s as getLogBuffer, t as LogEntry } from "../logger-CqTd5Kpk.js";
-import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-C5pp0PJU.js";
-import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-CeKf5HIc.js";
-import { n as mapWithConcurrencyLimit } from "../concurrency-DPeGBH0X.js";
-import { t as geodesicAngleRad } from "../index-D74JTX4I.js";
-import { t as formatFileSize } from "../format-file-size-DxN-EBLc.js";
-import { t as listFormatter } from "../list-formatter-DLFDnS70.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-B4StJUDb.js";
+import { n as computeFusedPath, r as fusedGpsFromOdom, t as FusedPathInput } from "../fused-path-DOKzVMiO.js";
+import { n as FailureTrackerConfig, r as createFailureTracker, t as FailureTracker } from "../failure-tracker-B7fzPfZo.js";
+import { n as mapWithConcurrencyLimit } from "../concurrency-DW0jQo3G.js";
+import { t as geodesicAngleRad } from "../index-Nr3qg4IH.js";
+import { t as formatFileSize } from "../format-file-size-Da8rZgfs.js";
+import { t as listFormatter } from "../list-formatter-1ttG18MQ.js";
 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,6 +1,6 @@
 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 { t as geodesicAngleRad } from "../geodesic-angle-HXBWiXiI.js";
 import { computeFusedPath, fusedGpsFromOdom } from "./fused-path.js";
 import { mapWithConcurrencyLimit } from "./concurrency.js";
 import { formatFileSize } from "./format-file-size.js";

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

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

package/dist/utils/logger.js

@@ -93,10 +93,17 @@ function serializeArg(arg) {
 	return safeStringify(arg);
 }
 /**
+* Serialize a log call's arguments once (quality-review C-5 — the buffer,
+* breadcrumb, and Sentry-message paths each used to re-serialize the same
+* args, i.e. 2–3× per log call). All downstream consumers take the string.
+*/
+function serializeArgs(args) {
+	return args.map((arg) => serializeArg(arg)).join(" ");
+}
+/**
 * Add an entry to the log buffer and notify subscribers
 */
-function addToBuffer(level, tag, args) {
-	const message = args.map((arg) => serializeArg(arg)).join(" ");
+function addToBuffer(level, tag, message) {
 	const entry = {
 		timestamp: Date.now(),
 		level,
@@ -177,8 +184,8 @@ function toSentryLevel(level) {
 * Add a Sentry breadcrumb for debugging context.
 * Breadcrumbs are attached to future exceptions, helping trace what happened before an error.
 */
-function addSentryBreadcrumb(level, tag, args) {
-	const message = `[${tag}] ${args.map((arg) => serializeArg(arg)).join(" ")}`;
+function addSentryBreadcrumb(level, tag, body) {
+	const message = `[${tag}] ${body}`;
 	Sentry.addBreadcrumb({
 		category: "log",
 		level: toSentryLevel(level),
@@ -213,8 +220,7 @@ function toFingerprintTemplate(body) {
 * messages from the same tag remain distinct Issues (see
 * {@link toFingerprintTemplate}).
 */
-function captureLogMessage(level, tag, args) {
-	const body = args.map((arg) => serializeArg(arg)).join(" ");
+function captureLogMessage(level, tag, body) {
 	const message = `[${tag}] ${body}`;
 	Sentry.captureMessage(message, {
 		level,
@@ -231,8 +237,8 @@ function captureLogMessage(level, tag, args) {
 * Called for log.warn() so warnings are independently visible in the
 * Sentry dashboard, not only as breadcrumbs attached to later exceptions.
 */
-function reportWarningToSentry(tag, args) {
-	captureLogMessage("warning", tag, args);
+function reportWarningToSentry(tag, body) {
+	captureLogMessage("warning", tag, body);
 }
 /**
 * Report log.error() arguments to Sentry as standalone Issues.
@@ -247,37 +253,41 @@ function reportWarningToSentry(tag, args) {
 * Issues when an Error is present, and groups via the same normalized template
 * fingerprint as warnings (see {@link captureLogMessage}).
 */
-function reportErrorsToSentry(tag, args) {
+function reportErrorsToSentry(tag, args, body) {
 	let capturedError = false;
 	for (const arg of args) if (arg instanceof Error) {
 		Sentry.captureException(arg);
 		capturedError = true;
 	}
-	if (!capturedError) captureLogMessage("error", tag, args);
+	if (!capturedError) captureLogMessage("error", tag, body);
 }
 function createLogger(tag) {
 	const prefix = `[${tag}]`;
 	return {
 		debug: (...args) => {
-			addToBuffer(0, tag, args);
-			addSentryBreadcrumb(0, tag, args);
+			const body = serializeArgs(args);
+			addToBuffer(0, tag, body);
+			addSentryBreadcrumb(0, tag, body);
 			if (globalLogLevel <= 0) console.log(prefix, ...args);
 		},
 		info: (...args) => {
-			addToBuffer(1, tag, args);
-			addSentryBreadcrumb(1, tag, args);
+			const body = serializeArgs(args);
+			addToBuffer(1, tag, body);
+			addSentryBreadcrumb(1, tag, body);
 			if (globalLogLevel <= 1) console.log(prefix, ...args);
 		},
 		warn: (...args) => {
-			addToBuffer(2, tag, args);
-			addSentryBreadcrumb(2, tag, args);
-			reportWarningToSentry(tag, args);
+			const body = serializeArgs(args);
+			addToBuffer(2, tag, body);
+			addSentryBreadcrumb(2, tag, body);
+			reportWarningToSentry(tag, body);
 			if (globalLogLevel <= 2) console.warn(prefix, ...args);
 		},
 		error: (...args) => {
-			addToBuffer(3, tag, args);
-			addSentryBreadcrumb(3, tag, args);
-			reportErrorsToSentry(tag, args);
+			const body = serializeArgs(args);
+			addToBuffer(3, tag, body);
+			addSentryBreadcrumb(3, tag, body);
+			reportErrorsToSentry(tag, args, body);
 			if (globalLogLevel <= 3) console.error(prefix, ...args);
 		}
 	};

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-DkWBkF5g.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-BE7tbvYV.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-gD70k7Fq.js";
+import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-B4COh_0p.js";
 export { AlignmentLerper, createAlignmentLerper };

package/dist/visualization/alignment-lerper.js

@@ -28,27 +28,37 @@ new THREE.Vector3();
 * @param arWorldGroup The group whose matrix is interpolated.
 * @param lerpRate     Lerp speed multiplier (default 8).
 */
+const CONVERGED_POS_EPSILON_SQ = 1e-4 * 1e-4;
+const CONVERGED_QUAT_DOT = .99999999;
+const CONVERGED_SCALE_EPSILON_SQ = 1e-6 * 1e-6;
 function createAlignmentLerper(arWorldGroup, lerpRate = 8) {
 	let hasTarget = false;
 	let isFirstTarget = true;
+	let converged = false;
 	const storedTargetPos = new THREE.Vector3();
 	const storedTargetQuat = new THREE.Quaternion();
 	const storedTargetScale = new THREE.Vector3(1, 1, 1);
 	const _matrix = new THREE.Matrix4();
+	/** Write the exact stored target and refresh the subtree. */
+	const applyTargetExactly = () => {
+		_matrix.compose(storedTargetPos, storedTargetQuat, storedTargetScale);
+		arWorldGroup.matrix.copy(_matrix);
+		arWorldGroup.matrixAutoUpdate = false;
+		arWorldGroup.updateMatrixWorld(true);
+	};
 	return {
 		setTarget(matrix) {
 			_matrix.fromArray(matrix);
 			_matrix.decompose(storedTargetPos, storedTargetQuat, storedTargetScale);
 			hasTarget = true;
+			converged = false;
 		},
 		update(dt) {
-			if (!hasTarget) return;
+			if (!hasTarget || converged) return;
 			if (isFirstTarget) {
-				_matrix.compose(storedTargetPos, storedTargetQuat, storedTargetScale);
-				arWorldGroup.matrix.copy(_matrix);
-				arWorldGroup.matrixAutoUpdate = false;
-				arWorldGroup.updateMatrixWorld(true);
+				applyTargetExactly();
 				isFirstTarget = false;
+				converged = true;
 				return;
 			}
 			arWorldGroup.matrix.decompose(_currentPos, _currentQuat, _currentScale);
@@ -56,6 +66,11 @@ function createAlignmentLerper(arWorldGroup, lerpRate = 8) {
 			_currentPos.lerp(storedTargetPos, alpha);
 			_currentQuat.slerp(storedTargetQuat, alpha);
 			_currentScale.lerp(storedTargetScale, alpha);
+			if (_currentPos.distanceToSquared(storedTargetPos) < CONVERGED_POS_EPSILON_SQ && Math.abs(_currentQuat.dot(storedTargetQuat)) > CONVERGED_QUAT_DOT && _currentScale.distanceToSquared(storedTargetScale) < CONVERGED_SCALE_EPSILON_SQ) {
+				applyTargetExactly();
+				converged = true;
+				return;
+			}
 			_matrix.compose(_currentPos, _currentQuat, _currentScale);
 			arWorldGroup.matrix.copy(_matrix);
 			arWorldGroup.matrixAutoUpdate = false;

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-Cfg0trC3.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-B6XiA1cT.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-BPrMplIC.js";
+import { t as registerSessionDisposer } from "../session-disposers-BZS-hi8u.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-DfBm2J5i.js";
+import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-B6zA3dy9.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-CPpVtvgs.js";
+import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../css3d-renderer-manager-DbrSY7Mh.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-DDcNHkTb.js";
+import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-CH7E2Iv_.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-CokkgS_i.js";
+import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-COPfzruF.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-CEjGqEVD.js";
+import { a as GpsAnchorSamplePoint, i as GpsAnchorPhase, n as GpsAnchorMode, o as createGpsAnchor, r as GpsAnchorOptions, t as GpsAnchor } from "../gps-anchor-BaqyRsPC.js";
 export { GpsAnchor, GpsAnchorMode, GpsAnchorOptions, GpsAnchorPhase, GpsAnchorSamplePoint, createGpsAnchor };

package/dist/visualization/gps-anchor.js

@@ -1,7 +1,8 @@
+import { t as interpolatingMedian } from "../median-Bla_W50f.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 { nueToArLocal, worldNueToGps } from "./frame-conversions.js";
 import * as THREE from "three";
 //#region ../src/visualization/gps-anchor.ts
 /**
@@ -18,6 +19,27 @@ import * as THREE from "three";
 * 6 and remains deferred.
 */
 /**
+* Built-in "object-pose" bootstrap source (quality-review G-6): samples the
+* object's world pose converted to GPS. Requires a GPS-world frame — the
+* world position is GPS-world NUE only once an alignment exists (via
+* `enableArWorldGroupAlignment`), so ticks are skipped until zero AND
+* alignment are available (mirrors "no fix yet").
+*/
+function createObjectPoseSampler(options) {
+	const scratch = new THREE.Vector3();
+	return () => {
+		const zero = options.getGpsZeroRef();
+		if (zero === null || zero === void 0) return null;
+		const alignment = options.getAlignmentMatrix();
+		if (alignment === null || alignment === void 0) return null;
+		return worldNueToGps(options.object3D.getWorldPosition(scratch), zero);
+	};
+}
+/** A caller-provided bootstrap reader wins; otherwise the built-in object-pose source. */
+function resolveBootstrapSampler(options) {
+	return options.getCurrentGpsPoint ?? createObjectPoseSampler(options);
+}
+/**
 * 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.
@@ -48,20 +70,14 @@ function isDescendantOf(object, arWorldGroup) {
 	}
 	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 lat = interpolatingMedian(samples.map((s) => s.lat));
+	const lon = interpolatingMedian(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)
+		altitude: interpolatingMedian(alts)
 	};
 	return {
 		lat,
@@ -82,6 +98,7 @@ function createGpsAnchor(options) {
 	options.angleThresholdInDegrees;
 	const mode = options.mode ?? "snap-when-offscreen";
 	const scratchTarget = new THREE.Vector3();
+	const getCurrentGpsPoint = resolveBootstrapSampler(options);
 	const scratchCamWorld = new THREE.Vector3();
 	const scratchObjWorld = new THREE.Vector3();
 	let phase = options.skipBootstrap === true ? "anchored" : "bootstrap";
@@ -148,18 +165,26 @@ function createGpsAnchor(options) {
 	* matrix yet — an AR-local object cannot be placed without knowing the
 	* AR↔NUE transform).
 	*/
+	let lastTargetZeroRef = null;
+	let lastTargetAlignmentRef = null;
+	let lastTargetGpsPointRef = null;
 	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);
+		if (zero !== lastTargetZeroRef || currentAlignment !== lastTargetAlignmentRef || gpsPoint !== lastTargetGpsPointRef) {
+			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);
+			lastTargetZeroRef = zero;
+			lastTargetAlignmentRef = currentAlignment;
+			lastTargetGpsPointRef = gpsPoint;
+		}
 		options.camera.getWorldPosition(scratchCamWorld);
 		options.object3D.getWorldPosition(scratchObjWorld);
 		const scale = 1 + 10 * scratchCamWorld.distanceTo(scratchObjWorld) / 100;
@@ -181,7 +206,7 @@ function createGpsAnchor(options) {
 		}
 		if (elapsed - phaseEnteredAtElapsed < settlingSeconds) return;
 		if (lastSampleAtElapsed !== null && elapsed - lastSampleAtElapsed < 1) return;
-		const sample = options.getCurrentGpsPoint();
+		const sample = getCurrentGpsPoint();
 		if (sample === null || sample === void 0) return;
 		samples.push(sample);
 		lastSampleAtElapsed = elapsed;

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-1mooS3BS.js";
+import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-CT3TWctJ.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-Di2nBzx-.js";
+import { n as GpsEventVisualizer, r as gpsEventVisualizer, t as GpsEventAccuracy } from "../gps-event-markers-BsC2Ynlh.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 { f as getArWorldGroup, x as getScene } from "../webxr-session-BCP2XK7k.js";
+import { f as getArWorldGroup, x as getScene } from "../webxr-session-DWKUsCN9.js";
 import { VIS_COLORS } from "./vis-colors.js";
 import * as THREE from "three";
 //#region ../src/visualization/gps-event-markers.ts

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-CaQbrhbk.js";
+import { n as createReticleMesh, r as updateReticle, t as HitMatrix } from "../hit-test-reticle-DhnCMOsc.js";
 export { HitMatrix, createReticleMesh, updateReticle };