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

package/dist/{app-selectors-CcZ5UV-8.d.ts → app-selectors-B8VQoMDY.d.ts}

@@ -1,4 +1,4 @@
-import { L as CombinedRootState, r as SlamAppRootState } from "./create-slam-app-store-qNXQ-tq5.js";
+import { L as CombinedRootState, r as SlamAppRootState } from "./create-slam-app-store-BljusOua.js";
 import * as _$gps_plus_slam_js0 from "gps-plus-slam-js";
 import { ArImageCapture, GpsPoint, LatLong, Matrix4, Quaternion, Vector3 } from "gps-plus-slam-js";
 import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";

package/dist/ar/camera-blit-capture.d.ts

@@ -1,2 +1,2 @@
-import { i as computeCaptureSize, n as CameraBlitCaptureConfig, r as DEFAULT_BLIT_CONFIG, t as CameraBlitCapture } from "../camera-blit-capture-D5_mNhla.js";
+import { i as computeCaptureSize, n as CameraBlitCaptureConfig, r as DEFAULT_BLIT_CONFIG, t as CameraBlitCapture } from "../camera-blit-capture-CnxUDbKx.js";
 export { CameraBlitCapture, CameraBlitCaptureConfig, DEFAULT_BLIT_CONFIG, computeCaptureSize };

package/dist/ar/camera-blit-capture.js

@@ -267,6 +267,19 @@ var CameraBlitCapture = class {
 		return true;
 	}
 	/**
+	* Current render-target width in pixels. This is exactly the width of the
+	* JPEG produced by {@link captureToBlob} (the encode canvas is sized to the
+	* render target), so callers can persist it as the captured image's true
+	* pixel width without decoding the blob.
+	*/
+	getWidth() {
+		return this.width;
+	}
+	/** Current render-target height in pixels. See {@link getWidth}. */
+	getHeight() {
+		return this.height;
+	}
+	/**
 	* Dispose GPU resources. Call when AR session ends.
 	*/
 	dispose() {

package/dist/ar/enable-gps-ar.d.ts

@@ -1,2 +1,2 @@
-import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "../enable-gps-ar-CapmADVN.js";
+import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "../enable-gps-ar-BfUJOgpW.js";
 export { EnableGpsArConfig, EnableGpsArController, EnableGpsArDeps, EnableGpsArResult, EnableGpsArState, EnableGpsArStatus, createEnableGpsArController };

package/dist/ar/enable-gps-ar.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger.js";
 import { requestGeolocationPermission, requestOrientationPermission, requestWebXRWithDepthPermission } from "../sensors/permission-checker.js";
 import { startGpsWatch, startOrientationWatch, stopGpsWatch, stopOrientationWatch } from "../sensors/gps.js";
-import { _ as isWebXRSupported, g as initAR, i as endARSession } from "../webxr-session-QhcSSub5.js";
+import { _ as isWebXRSupported, g as initAR, i as endARSession } from "../webxr-session-TIaD883f.js";
 //#region ../src/ar/enable-gps-ar.ts
 const log = createLogger("EnableGpsAr");
 const defaultDeps = {

package/dist/ar/image-capture.d.ts

@@ -1,2 +1,2 @@
-import { a as ImageCaptureManager, i as ImageCaptureConfig, n as DEFAULT_CAPTURE_CONFIG, o as MIN_VALID_IMAGE_BYTES, r as ImageCaptureCallbacks, t as CapturedImage } from "../image-capture-DZ4HFRgS.js";
-export { CapturedImage, DEFAULT_CAPTURE_CONFIG, ImageCaptureCallbacks, ImageCaptureConfig, ImageCaptureManager, MIN_VALID_IMAGE_BYTES };
+import { a as ImageCaptureConfig, i as ImageCaptureCallbacks, n as CapturedImage, o as ImageCaptureManager, r as DEFAULT_CAPTURE_CONFIG, s as MIN_VALID_IMAGE_BYTES, t as CapturedFrame } from "../image-capture-qAZ5Fh5X.js";
+export { CapturedFrame, CapturedImage, DEFAULT_CAPTURE_CONFIG, ImageCaptureCallbacks, ImageCaptureConfig, ImageCaptureManager, MIN_VALID_IMAGE_BYTES };

package/dist/ar/image-capture.js

@@ -103,15 +103,15 @@ var ImageCaptureManager = class {
 				this.captureTimeoutId = null;
 			}
 		}, this.config.captureTimeoutMs);
-		if (this.callbacks.captureFrame) this.callbacks.captureFrame(this.config.quality).then((blob) => {
-			this.handleCapturedBlob(blob, timestamp, frameIndex, pose, screenRotation);
+		if (this.callbacks.captureFrame) this.callbacks.captureFrame(this.config.quality).then((frame) => {
+			this.handleCapturedBlob(frame?.blob ?? null, frame?.width, frame?.height, timestamp, frameIndex, pose, screenRotation);
 		}).catch(() => {
 			this.clearCaptureTimeout();
 			this.captureInProgress = false;
 			this.callbacks.onCaptureFailed?.();
 		});
 		else this.canvas.toBlob((blob) => {
-			this.handleCapturedBlob(blob, timestamp, frameIndex, pose, screenRotation);
+			this.handleCapturedBlob(blob, this.canvas.width, this.canvas.height, timestamp, frameIndex, pose, screenRotation);
 		}, "image/jpeg", this.config.quality);
 	}
 	/**
@@ -128,7 +128,7 @@ var ImageCaptureManager = class {
 	* Common handler for captured blobs (from either canvas.toBlob or captureFrame).
 	* Handles null blobs, suspicious image detection, and dispatching onCaptured.
 	*/
-	handleCapturedBlob(blob, timestamp, frameIndex, pose, screenRotation) {
+	handleCapturedBlob(blob, width, height, timestamp, frameIndex, pose, screenRotation) {
 		this.clearCaptureTimeout();
 		this.captureInProgress = false;
 		if (!blob) {
@@ -145,7 +145,9 @@ var ImageCaptureManager = class {
 			frameIndex,
 			position: pose.position,
 			rotation: pose.orientation,
-			screenRotation
+			screenRotation,
+			...width && width > 0 ? { width } : {},
+			...height && height > 0 ? { height } : {}
 		});
 	}
 };

package/dist/ar/index.d.ts

@@ -1,14 +1,14 @@
 import { r as bresenham3d, t as GridCell } from "../bresenham3d-CFfd7n6B.js";
-import { i as computeCaptureSize, n as CameraBlitCaptureConfig, r as DEFAULT_BLIT_CONFIG, t as CameraBlitCapture } from "../camera-blit-capture-D5_mNhla.js";
+import { i as computeCaptureSize, n as CameraBlitCaptureConfig, r as DEFAULT_BLIT_CONFIG, t as CameraBlitCapture } from "../camera-blit-capture-CnxUDbKx.js";
 import { i as isFullySupported, n as CapabilitySupport, r as capabilityMessage, t as CapabilityMessageOptions } from "../capability-checker-CQXJHxXg.js";
 import { a as createCaptureFailureTracker, i as DEFAULT_CAPTURE_TRACKER_CONFIG, n as CaptureFailureTracker, r as CaptureFailureTrackerConfig, t as CAPTURE_FAILURE_WARNING } from "../capture-failure-tracker-CUeU3L_M.js";
 import { a as applyChromiumProjectionLayerWorkaround, i as ChromiumProjectionLayerWorkaroundResult, n as BASELAYER_WINDOW_MIN, o as needsBaseLayerPersistence, r as ChromeVersion, s as parseChromeVersion, t as BASELAYER_WINDOW_MAX } from "../chromium-camera-access-workaround-Jqbn0apH.js";
 import { a as wrapXRDepthInfo, i as DepthSamplerConfig, n as DepthSampler, r as DepthSamplerCallbacks, t as DepthInfo } from "../depth-sampler-Bhanfwla.js";
 import { n as createDepthUnprojector, r as unprojectDepthPoint, t as DepthUnprojector } from "../depth-unprojection-Y6i_mJuT.js";
-import { a as ImageCaptureManager, i as ImageCaptureConfig, n as DEFAULT_CAPTURE_CONFIG, o as MIN_VALID_IMAGE_BYTES, r as ImageCaptureCallbacks, t as CapturedImage } from "../image-capture-DZ4HFRgS.js";
+import { a as ImageCaptureConfig, i as ImageCaptureCallbacks, n as CapturedImage, o as ImageCaptureManager, r as DEFAULT_CAPTURE_CONFIG, s as MIN_VALID_IMAGE_BYTES } from "../image-capture-qAZ5Fh5X.js";
 import { i as acquireCameraTexture, n as RendererLike, r as XRCameraLike, t as CameraTextureResult } from "../xr-camera-texture-DBwCaKTd.js";
-import { D as setDepthCaptureCallback, I as startDepthCapture, L as startImageCapture, M as setTrackingLostCallback, O as setFrameCallback, P as setTrackingStore, R as stopDepthCapture, d as getCamera, f as getCurrentArPose, g as getScene, h as getLiveCss3dManager, j as setTrackingCallbacks, k as setImageCaptureCallback, m as getImageCaptureFrameCount, o as endARSession, p as getDepthSampleCount, t as SessionFeatureOptions, u as getArWorldGroup, v as initAR, z as stopImageCapture } from "../webxr-session-DtAG9srK.js";
-import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "../enable-gps-ar-CapmADVN.js";
+import { D as setDepthCaptureCallback, I as startDepthCapture, L as startImageCapture, M as setTrackingLostCallback, O as setFrameCallback, P as setTrackingStore, R as stopDepthCapture, d as getCamera, f as getCurrentArPose, g as getScene, h as getLiveCss3dManager, j as setTrackingCallbacks, k as setImageCaptureCallback, m as getImageCaptureFrameCount, o as endARSession, p as getDepthSampleCount, t as SessionFeatureOptions, u as getArWorldGroup, v as initAR, z as stopImageCapture } from "../webxr-session-GjZ2BIpS.js";
+import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "../enable-gps-ar-BfUJOgpW.js";
 import { r as registerFrameUpdate, t as FrameUpdate } from "../frame-loop-CMewS8cY.js";
 import { n as OccupancyGridOptions, t as OccupancyGrid } from "../occupancy-grid-BRNRaPyT.js";
 import { i as registerXrFrameUpdate, n as XrFrameUpdate, t as XrFrameContext } from "../xr-frame-loop-BtYytZJg.js";

package/dist/ar/index.js

@@ -10,7 +10,7 @@ import { registerFrameUpdate } from "./frame-loop.js";
 import { registerXrFrameUpdate } from "./xr-frame-loop.js";
 import { WEBXR_TO_NUE } from "./webxr-nue-basis.js";
 import { DEFAULT_CAPTURE_CONFIG, ImageCaptureManager, MIN_VALID_IMAGE_BYTES } from "./image-capture.js";
-import { A as setTrackingLostCallback, D as setImageCaptureCallback, E as setFrameCallback, F as startImageCapture, I as stopDepthCapture, L as stopImageCapture, M as setTrackingStore, P as startDepthCapture, T as setDepthCaptureCallback, c as getArWorldGroup, d as getDepthSampleCount, f as getImageCaptureFrameCount, g as initAR, i as endARSession, k as setTrackingCallbacks, l as getCamera, m as getScene, p as getLiveCss3dManager, u as getCurrentArPose } from "../webxr-session-QhcSSub5.js";
+import { A as setTrackingLostCallback, D as setImageCaptureCallback, E as setFrameCallback, F as startImageCapture, I as stopDepthCapture, L as stopImageCapture, M as setTrackingStore, P as startDepthCapture, T as setDepthCaptureCallback, c as getArWorldGroup, d as getDepthSampleCount, f as getImageCaptureFrameCount, g as initAR, i as endARSession, k as setTrackingCallbacks, l as getCamera, m as getScene, p as getLiveCss3dManager, u as getCurrentArPose } from "../webxr-session-TIaD883f.js";
 import { acquireCameraTexture } from "./xr-camera-texture.js";
 import { SCENE_NODE } from "./scene-node-names.js";
 import { createEnableGpsArController } from "./enable-gps-ar.js";

package/dist/ar/replay-scene.js

@@ -1,5 +1,5 @@
 import { createLogger } from "../utils/logger.js";
-import { C as setArWorldGroup, O as setScene, S as setArPose, r as createSceneHierarchy, w as setCamera } from "../webxr-session-QhcSSub5.js";
+import { C as setArWorldGroup, O as setScene, S as setArPose, r as createSceneHierarchy, w as setCamera } from "../webxr-session-TIaD883f.js";
 import { createCss3dRendererManager } from "../visualization/css3d-renderer-manager.js";
 import { createCameraFollower } from "../visualization/camera-follower.js";
 import { createAlignmentLerper } from "../visualization/alignment-lerper.js";

package/dist/ar/webxr-session.d.ts

@@ -1,4 +1,4 @@
 import { i as DepthSample, t as ARPose } from "../ar-types-Dan1MVTi.js";
-import { t as CapturedImage } from "../image-capture-DZ4HFRgS.js";
-import { A as setScene, C as resetWebXRState, D as setDepthCaptureCallback, E as setCamera, F as shouldLogCameraAccessDiagnostic, I as startDepthCapture, L as startImageCapture, M as setTrackingLostCallback, N as setTrackingRecoveredCallback, O as setFrameCallback, P as setTrackingStore, R as stopDepthCapture, S as nueQuaternionToWebXR, T as setArWorldGroup, _ as getXrCameraFromPose, a as createSceneHierarchy, b as isXRCameraLike, c as extractResetTransformData, d as getCamera, f as getCurrentArPose, g as getScene, h as getLiveCss3dManager, i as buildSessionOptions, j as setTrackingCallbacks, k as setImageCaptureCallback, l as getArPose, m as getImageCaptureFrameCount, n as TrackingSubscribableStore, o as endARSession, p as getDepthSampleCount, r as applyAlignmentMatrix, s as extractPoseFromViewer, t as SessionFeatureOptions, u as getArWorldGroup, v as initAR, w as setArPose, x as nuePositionToWebXR, y as isWebXRSupported, z as stopImageCapture } from "../webxr-session-DtAG9srK.js";
+import { n as CapturedImage } from "../image-capture-qAZ5Fh5X.js";
+import { A as setScene, C as resetWebXRState, D as setDepthCaptureCallback, E as setCamera, F as shouldLogCameraAccessDiagnostic, I as startDepthCapture, L as startImageCapture, M as setTrackingLostCallback, N as setTrackingRecoveredCallback, O as setFrameCallback, P as setTrackingStore, R as stopDepthCapture, S as nueQuaternionToWebXR, T as setArWorldGroup, _ as getXrCameraFromPose, a as createSceneHierarchy, b as isXRCameraLike, c as extractResetTransformData, d as getCamera, f as getCurrentArPose, g as getScene, h as getLiveCss3dManager, i as buildSessionOptions, j as setTrackingCallbacks, k as setImageCaptureCallback, l as getArPose, m as getImageCaptureFrameCount, n as TrackingSubscribableStore, o as endARSession, p as getDepthSampleCount, r as applyAlignmentMatrix, s as extractPoseFromViewer, t as SessionFeatureOptions, u as getArWorldGroup, v as initAR, w as setArPose, x as nuePositionToWebXR, y as isWebXRSupported, z as stopImageCapture } from "../webxr-session-GjZ2BIpS.js";
 export { ARPose, CapturedImage, DepthSample, SessionFeatureOptions, TrackingSubscribableStore, applyAlignmentMatrix, buildSessionOptions, createSceneHierarchy, endARSession, extractPoseFromViewer, extractResetTransformData, getArPose, getArWorldGroup, getCamera, getCurrentArPose, getDepthSampleCount, getImageCaptureFrameCount, getLiveCss3dManager, getScene, getXrCameraFromPose, initAR, isWebXRSupported, isXRCameraLike, nuePositionToWebXR, nueQuaternionToWebXR, resetWebXRState, setArPose, setArWorldGroup, setCamera, setDepthCaptureCallback, setFrameCallback, setImageCaptureCallback, setScene, setTrackingCallbacks, setTrackingLostCallback, setTrackingRecoveredCallback, setTrackingStore, shouldLogCameraAccessDiagnostic, startDepthCapture, startImageCapture, stopDepthCapture, stopImageCapture };

package/dist/ar/webxr-session.js

@@ -1,2 +1,2 @@
-import { A as setTrackingLostCallback, C as setArWorldGroup, D as setImageCaptureCallback, E as setFrameCallback, F as startImageCapture, I as stopDepthCapture, L as stopImageCapture, M as setTrackingStore, N as shouldLogCameraAccessDiagnostic, O as setScene, P as startDepthCapture, S as setArPose, T as setDepthCaptureCallback, _ as isWebXRSupported, a as extractPoseFromViewer, b as nueQuaternionToWebXR, c as getArWorldGroup, d as getDepthSampleCount, f as getImageCaptureFrameCount, g as initAR, h as getXrCameraFromPose, i as endARSession, j as setTrackingRecoveredCallback, k as setTrackingCallbacks, l as getCamera, m as getScene, n as buildSessionOptions, o as extractResetTransformData, p as getLiveCss3dManager, r as createSceneHierarchy, s as getArPose, t as applyAlignmentMatrix, u as getCurrentArPose, v as isXRCameraLike, w as setCamera, x as resetWebXRState, y as nuePositionToWebXR } from "../webxr-session-QhcSSub5.js";
+import { A as setTrackingLostCallback, C as setArWorldGroup, D as setImageCaptureCallback, E as setFrameCallback, F as startImageCapture, I as stopDepthCapture, L as stopImageCapture, M as setTrackingStore, N as shouldLogCameraAccessDiagnostic, O as setScene, P as startDepthCapture, S as setArPose, T as setDepthCaptureCallback, _ as isWebXRSupported, a as extractPoseFromViewer, b as nueQuaternionToWebXR, c as getArWorldGroup, d as getDepthSampleCount, f as getImageCaptureFrameCount, g as initAR, h as getXrCameraFromPose, i as endARSession, j as setTrackingRecoveredCallback, k as setTrackingCallbacks, l as getCamera, m as getScene, n as buildSessionOptions, o as extractResetTransformData, p as getLiveCss3dManager, r as createSceneHierarchy, s as getArPose, t as applyAlignmentMatrix, u as getCurrentArPose, v as isXRCameraLike, w as setCamera, x as resetWebXRState, y as nuePositionToWebXR } from "../webxr-session-TIaD883f.js";
 export { applyAlignmentMatrix, buildSessionOptions, createSceneHierarchy, endARSession, extractPoseFromViewer, extractResetTransformData, getArPose, getArWorldGroup, getCamera, getCurrentArPose, getDepthSampleCount, getImageCaptureFrameCount, getLiveCss3dManager, getScene, getXrCameraFromPose, initAR, isWebXRSupported, isXRCameraLike, nuePositionToWebXR, nueQuaternionToWebXR, resetWebXRState, setArPose, setArWorldGroup, setCamera, setDepthCaptureCallback, setFrameCallback, setImageCaptureCallback, setScene, setTrackingCallbacks, setTrackingLostCallback, setTrackingRecoveredCallback, setTrackingStore, shouldLogCameraAccessDiagnostic, startDepthCapture, startImageCapture, stopDepthCapture, stopImageCapture };

package/dist/{ar-world-group-alignment-ColHB_5A.d.ts → ar-world-group-alignment-C9lwwIyI.d.ts}

@@ -1,4 +1,4 @@
-import { t as SubscribableStore } from "./subscribe-to-selector-CP3BKSbF.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-CZ6k1NFP.js";
 import * as THREE from "three";
 
 //#region ../src/visualization/ar-world-group-alignment.d.ts

package/dist/{camera-blit-capture-D5_mNhla.d.ts → camera-blit-capture-CnxUDbKx.d.ts}

@@ -119,6 +119,15 @@ declare class CameraBlitCapture {
    * @returns true if resources were actually resized
    */
   resizeIfNeeded(newWidth: number, newHeight: number): boolean;
+  /**
+   * Current render-target width in pixels. This is exactly the width of the
+   * JPEG produced by {@link captureToBlob} (the encode canvas is sized to the
+   * render target), so callers can persist it as the captured image's true
+   * pixel width without decoding the blob.
+   */
+  getWidth(): number;
+  /** Current render-target height in pixels. See {@link getWidth}. */
+  getHeight(): number;
   /**
    * Dispose GPU resources. Call when AR session ends.
    */

package/dist/{create-slam-app-store-qNXQ-tq5.d.ts → create-slam-app-store-BljusOua.d.ts}

@@ -1,8 +1,8 @@
 import { t as ARPose } from "./ar-types-Dan1MVTi.js";
 import { a as TrackingSliceState, t as DeviceOrientation } from "./tracking-slice-CdK8c-8P.js";
 import { t as RecordingState } from "./recording-slice-89O07ebs.js";
-import { n as SessionMetadata } from "./opfs-storage-DYm8WHq7.js";
-import { n as StorageBackend } from "./storage-backend-C9HLFtgz.js";
+import { n as SessionMetadata } from "./opfs-storage-D5zAn_lx.js";
+import { n as StorageBackend } from "./storage-backend-Do6YDpNo.js";
 import { GpsPoint, LatLong, Matrix4, RootState, Vector3 } from "gps-plus-slam-js";
 import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
 import { Middleware, Reducer, ReducersMapObject, configureStore } from "@reduxjs/toolkit";

package/dist/{enable-gps-ar-CapmADVN.d.ts → enable-gps-ar-BfUJOgpW.d.ts}

@@ -1,7 +1,7 @@
 import { t as ArCrashIsolationOptions } from "./recording-options-DJBXuMxV.js";
 import { n as RawDeviceOrientation, t as GpsPosition } from "./gps-VuezJWK3.js";
 import { n as PermissionStatus } from "./permission-checker-GpAiSCwd.js";
-import { t as SessionFeatureOptions } from "./webxr-session-DtAG9srK.js";
+import { t as SessionFeatureOptions } from "./webxr-session-GjZ2BIpS.js";
 
 //#region ../src/ar/enable-gps-ar.d.ts
 /**

package/dist/{file-system-C_eqiEA8.d.ts → file-system-CwXTNHmB.d.ts}

@@ -1,4 +1,4 @@
-import { n as SessionMetadata } from "./opfs-storage-DYm8WHq7.js";
+import { n as SessionMetadata } from "./opfs-storage-D5zAn_lx.js";
 
 //#region ../src/storage/file-system.d.ts
 /**

package/dist/file-system-utils-CXIoL-DM.d.ts

@@ -0,0 +1,40 @@
+//#region ../src/storage/file-system-utils.d.ts
+/**
+ * File System Utilities - Pure Functions
+ *
+ * These are extracted from file-system.ts so they can be tested
+ * without mocking browser APIs.
+ */
+/**
+ * Format a Date as a timestamp string for folder names
+ * @example "2025-02-28_14-30-11utc"
+ */
+declare function formatTimestamp(date: Date): string;
+/**
+ * Format an action file index as a zero-padded filename
+ * @example 42 -> "000042.json"
+ */
+declare function formatActionFilename(index: number): string;
+/**
+ * Format a frame index as a zero-padded filename
+ * @example 42 -> "frame-000042.jpg"
+ */
+declare function formatFrameFilename(index: number): string;
+/**
+ * Canonical session subdirectory for captured camera images, written by new
+ * recordings. Renamed from {@link LEGACY_SESSION_IMAGES_DIR} so an exported ZIP
+ * is a textbook COLMAP tree (`images/frame-NNNNNN.jpg` next to `sparse/0/`).
+ * Both the OPFS write path and the recorder's persisted `imageFile` value must
+ * use THIS constant so a recording stays self-consistent (COLMAP export plan
+ * Q5, gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-06-13-colmap-export-plan.md).
+ */
+declare const SESSION_IMAGES_DIR = "images";
+/**
+ * The pre-2026-06 session image subdirectory. Recordings made before the
+ * {@link SESSION_IMAGES_DIR} rename store frames under `frames/` (in both the
+ * on-disk dir and the persisted `imageFile`); readers fall back to this prefix
+ * so old recordings still replay.
+ */
+declare const LEGACY_SESSION_IMAGES_DIR = "frames";
+//#endregion
+export { formatTimestamp as a, formatFrameFilename as i, SESSION_IMAGES_DIR as n, formatActionFilename as r, LEGACY_SESSION_IMAGES_DIR as t };

package/dist/{gps-event-coordinator-BDIQde2x.d.ts → gps-event-coordinator-CWIDOk4U.d.ts}

@@ -1,6 +1,6 @@
 import { t as ARPose } from "./ar-types-Dan1MVTi.js";
 import { n as RawDeviceOrientation, t as GpsPosition } from "./gps-VuezJWK3.js";
-import { i as SlamAppStore } from "./create-slam-app-store-qNXQ-tq5.js";
+import { i as SlamAppStore } from "./create-slam-app-store-BljusOua.js";
 import { Quaternion, RawGpsPoint, RecordGpsEventPayload, Vector3, eulerToQuaternion } from "gps-plus-slam-js";
 import { ReducersMapObject } from "@reduxjs/toolkit";
 

package/dist/{image-capture-DZ4HFRgS.d.ts → image-capture-qAZ5Fh5X.d.ts}

@@ -54,6 +54,30 @@ interface CapturedImage {
   readonly rotation: WebXRQuaternion;
   /** Device screen orientation (0, 90, 180, 270) */
   readonly screenRotation: number;
+  /**
+   * Width of the encoded JPEG in pixels — the blit/canvas dimensions the blob
+   * was produced from, so it equals the decoded image's width. Persisted as
+   * `ArImageCapture.width` so consumers (the 3D frame-tile visualizer) can
+   * render each frame at its true aspect ratio. Always present from the
+   * capture pipeline; optional so the field can be threaded without forcing
+   * every test/caller to supply it.
+   */
+  readonly width?: number;
+  /** Height of the encoded JPEG in pixels. See {@link CapturedImage.width}. */
+  readonly height?: number;
+}
+/**
+ * A captured frame blob together with the pixel dimensions it was encoded at.
+ * Returned by the optional `captureFrame` (blit) callback so the pose-invariant
+ * image size can be persisted as first-class metadata (frame-tile aspect-ratio
+ * fix, D1 of 2026-06-13-frame-tile-rendering-bugs-user-feedback.md). The
+ * dimensions are the blit render-target size — identical to the JPEG's own
+ * width/height — so no decode is needed to learn the aspect ratio.
+ */
+interface CapturedFrame {
+  readonly blob: Blob;
+  readonly width: number;
+  readonly height: number;
 }
 /**
  * Callbacks for image capture integration
@@ -80,10 +104,12 @@ interface ImageCaptureCallbacks {
    * be read directly via canvas.toBlob() (which returns black pixels).
    *
    * @param quality - JPEG quality 0.0-1.0
-   * @returns Promise resolving to a JPEG Blob, or null if capture fails
+   * @returns Promise resolving to the JPEG blob plus the pixel dimensions it
+   *   was encoded at, or null if capture fails. The dimensions flow into the
+   *   persisted `ArImageCapture.width`/`height` for aspect-correct rendering.
    * @see docs/2026-02-06-bug-camera-frames-black.md
    */
-  captureFrame?: (quality: number) => Promise<Blob | null>;
+  captureFrame?: (quality: number) => Promise<CapturedFrame | null>;
 }
 /**
  * Manages periodic image capture from a canvas.
@@ -140,4 +166,4 @@ declare class ImageCaptureManager {
   private handleCapturedBlob;
 }
 //#endregion
-export { ImageCaptureManager as a, ImageCaptureConfig as i, DEFAULT_CAPTURE_CONFIG as n, MIN_VALID_IMAGE_BYTES as o, ImageCaptureCallbacks as r, CapturedImage as t };
+export { ImageCaptureConfig as a, ImageCaptureCallbacks as i, CapturedImage as n, ImageCaptureManager as o, DEFAULT_CAPTURE_CONFIG as r, MIN_VALID_IMAGE_BYTES as s, CapturedFrame as t };

package/dist/{index-KJq2amHF.d.ts → index-BYYUdf9v.d.ts}

@@ -1,4 +1,4 @@
-import { L as CombinedRootState, h as TrackingQualityReport } from "./create-slam-app-store-qNXQ-tq5.js";
+import { L as CombinedRootState, h as TrackingQualityReport } from "./create-slam-app-store-BljusOua.js";
 import { Add2dImagePayload, GpsPoint as GpsPoint$1, LatLong as LatLong$1, RawDeviceOrientation, RawGpsPoint as RawGpsPoint$1, RecordGpsEventPayload as RecordGpsEventPayload$1, add2dImage, calcRelativeCoordsInMeters, recordGpsEvent as recordGpsEvent$1, setZeroPos as setZeroPos$1 } from "gps-plus-slam-js";
 
 //#region ../src/state/onboarding-guidance.d.ts

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { r as bresenham3d, t as GridCell } from "./bresenham3d-CFfd7n6B.js";
-import { i as computeCaptureSize, n as CameraBlitCaptureConfig, r as DEFAULT_BLIT_CONFIG, t as CameraBlitCapture } from "./camera-blit-capture-D5_mNhla.js";
+import { i as computeCaptureSize, n as CameraBlitCaptureConfig, r as DEFAULT_BLIT_CONFIG, t as CameraBlitCapture } from "./camera-blit-capture-CnxUDbKx.js";
 import { i as isFullySupported, n as CapabilitySupport, r as capabilityMessage, t as CapabilityMessageOptions } from "./capability-checker-CQXJHxXg.js";
 import { a as createCaptureFailureTracker, i as DEFAULT_CAPTURE_TRACKER_CONFIG, n as CaptureFailureTracker, r as CaptureFailureTrackerConfig, t as CAPTURE_FAILURE_WARNING } from "./capture-failure-tracker-CUeU3L_M.js";
 import { a as applyChromiumProjectionLayerWorkaround, i as ChromiumProjectionLayerWorkaroundResult, n as BASELAYER_WINDOW_MIN, o as needsBaseLayerPersistence, r as ChromeVersion, s as parseChromeVersion, t as BASELAYER_WINDOW_MAX } from "./chromium-camera-access-workaround-Jqbn0apH.js";
@@ -9,12 +9,12 @@ import { n as createDepthUnprojector, r as unprojectDepthPoint, t as DepthUnproj
 import { _ as validateRecordingOptions, a as IMAGE_CONSTRAINTS, c as RecordingOptionsInput, d as loadRecordingOptions, f as resetRecordingOptions, g as validateImageOptions, h as validateDepthOptions, i as DepthCaptureOptions, l as STORAGE_KEY, n as DEFAULT_RECORDING_OPTIONS, o as ImageCaptureOptions, p as saveRecordingOptions, r as DEPTH_CONSTRAINTS, u as cloneRecordingOptions } from "./recording-options-DJBXuMxV.js";
 import { a as startOrientationWatch, i as startGpsWatch, n as RawDeviceOrientation, o as stopGpsWatch, r as requestOrientationPermission, s as stopOrientationWatch, t as GpsPosition } from "./gps-VuezJWK3.js";
 import { a as checkCameraPermission, c as checkOrientationPermission, d as requestCameraPermission, f as requestGeolocationPermission, g as setFileSystemState, h as resetFileSystemState, i as checkAllPermissions, l as checkWebXRSupport, m as requestWebXRWithDepthPermission, n as PermissionStatus, o as checkFileSystemPermission, p as requestOrientationPermission$1, s as checkGeolocationPermission, t as PermissionCheckResult, u as requestAllPermissions } from "./permission-checker-GpAiSCwd.js";
-import { a as ImageCaptureManager, i as ImageCaptureConfig, n as DEFAULT_CAPTURE_CONFIG, o as MIN_VALID_IMAGE_BYTES, r as ImageCaptureCallbacks, t as CapturedImage } from "./image-capture-DZ4HFRgS.js";
+import { a as ImageCaptureConfig, i as ImageCaptureCallbacks, n as CapturedImage, o as ImageCaptureManager, r as DEFAULT_CAPTURE_CONFIG, s as MIN_VALID_IMAGE_BYTES } from "./image-capture-qAZ5Fh5X.js";
 import { a as TrackingSliceState, c as poseLost, d as selectLastRestartedPayload, f as selectLastSensorOrientation, g as trackingReducer, h as selectTrackingPhase, i as TrackingPhase, l as poseReceived, m as selectLostFrameCount, n as PoseReceivedPayload, o as clearLastRestartedPayload, p as selectLastValidPose, s as originReset, u as resetTracking } from "./tracking-slice-CdK8c-8P.js";
 import { n as createCss3dRendererManager, t as Css3dRendererManager } from "./css3d-renderer-manager-ptu_t3B3.js";
 import { i as acquireCameraTexture, n as RendererLike, r as XRCameraLike, t as CameraTextureResult } from "./xr-camera-texture-DBwCaKTd.js";
-import { D as setDepthCaptureCallback, I as startDepthCapture, L as startImageCapture, M as setTrackingLostCallback, O as setFrameCallback, P as setTrackingStore, R as stopDepthCapture, d as getCamera, f as getCurrentArPose, g as getScene, h as getLiveCss3dManager, j as setTrackingCallbacks, k as setImageCaptureCallback, m as getImageCaptureFrameCount, o as endARSession, p as getDepthSampleCount, t as SessionFeatureOptions, u as getArWorldGroup, v as initAR, z as stopImageCapture } from "./webxr-session-DtAG9srK.js";
-import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "./enable-gps-ar-CapmADVN.js";
+import { D as setDepthCaptureCallback, I as startDepthCapture, L as startImageCapture, M as setTrackingLostCallback, O as setFrameCallback, P as setTrackingStore, R as stopDepthCapture, d as getCamera, f as getCurrentArPose, g as getScene, h as getLiveCss3dManager, j as setTrackingCallbacks, k as setImageCaptureCallback, m as getImageCaptureFrameCount, o as endARSession, p as getDepthSampleCount, t as SessionFeatureOptions, u as getArWorldGroup, v as initAR, z as stopImageCapture } from "./webxr-session-GjZ2BIpS.js";
+import { a as EnableGpsArState, i as EnableGpsArResult, n as EnableGpsArController, o as EnableGpsArStatus, r as EnableGpsArDeps, s as createEnableGpsArController, t as EnableGpsArConfig } from "./enable-gps-ar-BfUJOgpW.js";
 import { r as registerFrameUpdate, t as FrameUpdate } from "./frame-loop-CMewS8cY.js";
 import { n as OccupancyGridOptions, t as OccupancyGrid } from "./occupancy-grid-BRNRaPyT.js";
 import { i as registerXrFrameUpdate, n as XrFrameUpdate, t as XrFrameContext } from "./xr-frame-loop-BtYytZJg.js";
@@ -34,23 +34,23 @@ import { t as mapWithConcurrencyLimit } from "./concurrency-CO1FQvs3.js";
 import { t as formatFileSize } from "./format-file-size-CLCZz3lC.js";
 import { t as listFormatter } from "./list-formatter-RRcBe8Vg.js";
 import { a as recordWriteFailure, i as recordDepthSample, o as recordingReducer, r as endSession, s as startSession, t as RecordingState } from "./recording-slice-89O07ebs.js";
-import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, i as createSession, l as listSessions, o as getSessionHandle, r as checkStorageQuota, s as getSessionsRootHandle, u as resetOpfsStorage } from "./opfs-storage-DYm8WHq7.js";
-import { n as StorageBackend, t as CreateSessionResult } from "./storage-backend-C9HLFtgz.js";
-import { A as resetTrackingQuality, C as computeResidualConsensus, D as firstAgreementReached, F as snapshotsTrimmed, I as trackingQualityReducer, M as selectRecentAlignments, N as selectTrackingQuality, O as matrixDelta, P as snapshotPushed, S as computeGpsVsFusedDivergence, T as createTrackingQualityListenerMiddleware, _ as TrackingQualityState, a as SlamAppStoreOptions, b as computeCoverage, d as DEFAULT_TRACKING_QUALITY_OPTIONS, g as TrackingQualitySliceState, h as TrackingQualityReport, i as SlamAppStore, j as selectFirstAgreementObservationIndex, k as reportUpdated, m as TrackingQualityOptions, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, v as computeCompassAgreement, w as computeTrackingQualityReport, x as computeGpsAccuracy, y as computeConvergence } from "./create-slam-app-store-qNXQ-tq5.js";
-import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as updateDeviceOrientation } from "./gps-event-coordinator-BDIQde2x.js";
+import { a as getAppRootHandle, c as initOpfsStorage, d as resetSessionHandles, i as createSession, l as listSessions, o as getSessionHandle, r as checkStorageQuota, s as getSessionsRootHandle, u as resetOpfsStorage } from "./opfs-storage-D5zAn_lx.js";
+import { n as StorageBackend, t as CreateSessionResult } from "./storage-backend-Do6YDpNo.js";
+import { A as resetTrackingQuality, C as computeResidualConsensus, D as firstAgreementReached, F as snapshotsTrimmed, I as trackingQualityReducer, M as selectRecentAlignments, N as selectTrackingQuality, O as matrixDelta, P as snapshotPushed, S as computeGpsVsFusedDivergence, T as createTrackingQualityListenerMiddleware, _ as TrackingQualityState, a as SlamAppStoreOptions, b as computeCoverage, d as DEFAULT_TRACKING_QUALITY_OPTIONS, g as TrackingQualitySliceState, h as TrackingQualityReport, i as SlamAppStore, j as selectFirstAgreementObservationIndex, k as reportUpdated, m as TrackingQualityOptions, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, v as computeCompassAgreement, w as computeTrackingQualityReport, x as computeGpsAccuracy, y as computeConvergence } from "./create-slam-app-store-BljusOua.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as updateDeviceOrientation } from "./gps-event-coordinator-CWIDOk4U.js";
 import { a as ZipActionEntry, d as loadSessionMetadataFromBlob, f as readZipEntries, i as RecordedAction, l as loadGpsPathFromBlob, n as GpsPathCoord, r as MAX_ACTION_FILE_SIZE, s as loadActionsFromZip } from "./zip-reader-DSEXt7K6.js";
-import { n as replayRecording } from "./recording-replayer-BL-x-7k0.js";
-import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "./replay-engine-BRqszuQ9.js";
+import { n as replayRecording } from "./recording-replayer-r0DZ9ALp.js";
+import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "./replay-engine-XpDa0dy1.js";
 import { n as MapDataInput, r as buildMapData, t as MapData } from "./map-data-CkloBxIl.js";
-import { t as SubscribableStore } from "./subscribe-to-selector-CP3BKSbF.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "./store-subscribers-rrkLkFTt.js";
-import { c as calcRelativeCoordsInMeters, d as OnboardingGuidance, f as OnboardingPhase, l as recordGpsEvent, m as selectOnboardingGuidance, p as computeOnboardingGuidance, s as add2dImage, u as setZeroPos } from "./index-KJq2amHF.js";
-import { t as NullStorageBackend } from "./null-storage-backend-CxEjZHRW.js";
-import { t as OpfsStorageBackend } from "./opfs-storage-backend-CjSAuqg_.js";
-import { c as resetForNewSession, d as startSession$1, f as verifyWriteAccess, l as resetStorageState, m as writeFrame, n as WriteAccessResult, o as initStorage, p as writeAction } from "./file-system-C_eqiEA8.js";
-import { n as formatFrameFilename, r as formatTimestamp, t as formatActionFilename } from "./file-system-utils-DyAmcuvX.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-D_5HAvFz.js";
-import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "./ar-world-group-alignment-ColHB_5A.js";
+import { t as SubscribableStore } from "./subscribe-to-selector-CZ6k1NFP.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "./store-subscribers-0YWyOLvV.js";
+import { c as calcRelativeCoordsInMeters, d as OnboardingGuidance, f as OnboardingPhase, l as recordGpsEvent, m as selectOnboardingGuidance, p as computeOnboardingGuidance, s as add2dImage, u as setZeroPos } from "./index-BYYUdf9v.js";
+import { t as NullStorageBackend } from "./null-storage-backend-uKQE8tl7.js";
+import { t as OpfsStorageBackend } from "./opfs-storage-backend-6aYMUZlJ.js";
+import { c as resetForNewSession, d as startSession$1, f as verifyWriteAccess, l as resetStorageState, m as writeFrame, n as WriteAccessResult, o as initStorage, p as writeAction } from "./file-system-CwXTNHmB.js";
+import { a as formatTimestamp, i as formatFrameFilename, r as formatActionFilename } from "./file-system-utils-CXIoL-DM.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-G14hkSPG.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "./ar-world-group-alignment-C9lwwIyI.js";
 import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "./gps-compass-cubes-BM1uGiYV.js";
 import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "./frustum-visibility-CmI96ESS.js";
 import { n as worldNueToGps, t as nueToArLocal } from "./frame-conversions-BfsafGWR.js";

package/dist/index.js

@@ -17,7 +17,7 @@ import { requestOrientationPermission, startGpsWatch, startOrientationWatch, sto
 import { WEBXR_TO_NUE } from "./ar/webxr-nue-basis.js";
 import { DEFAULT_CAPTURE_CONFIG, ImageCaptureManager, MIN_VALID_IMAGE_BYTES } from "./ar/image-capture.js";
 import { clearLastRestartedPayload, originReset, poseLost, poseReceived, resetTracking, selectLastRestartedPayload, selectLastSensorOrientation, selectLastValidPose, selectLostFrameCount, selectTrackingPhase, trackingReducer } from "./state/tracking-slice.js";
-import { A as setTrackingLostCallback, D as setImageCaptureCallback, E as setFrameCallback, F as startImageCapture, I as stopDepthCapture, L as stopImageCapture, M as setTrackingStore, P as startDepthCapture, T as setDepthCaptureCallback, c as getArWorldGroup, d as getDepthSampleCount, f as getImageCaptureFrameCount, g as initAR, i as endARSession, k as setTrackingCallbacks, l as getCamera, m as getScene, p as getLiveCss3dManager, u as getCurrentArPose } from "./webxr-session-QhcSSub5.js";
+import { A as setTrackingLostCallback, D as setImageCaptureCallback, E as setFrameCallback, F as startImageCapture, I as stopDepthCapture, L as stopImageCapture, M as setTrackingStore, P as startDepthCapture, T as setDepthCaptureCallback, c as getArWorldGroup, d as getDepthSampleCount, f as getImageCaptureFrameCount, g as initAR, i as endARSession, k as setTrackingCallbacks, l as getCamera, m as getScene, p as getLiveCss3dManager, u as getCurrentArPose } from "./webxr-session-TIaD883f.js";
 import { acquireCameraTexture } from "./ar/xr-camera-texture.js";
 import { DEFAULT_RECORDING_OPTIONS, DEPTH_CONSTRAINTS, IMAGE_CONSTRAINTS, STORAGE_KEY, cloneRecordingOptions, loadRecordingOptions, resetRecordingOptions, saveRecordingOptions, validateDepthOptions, validateImageOptions, validateRecordingOptions } from "./state/recording-options.js";
 import { SCENE_NODE } from "./ar/scene-node-names.js";

package/dist/{null-storage-backend-CxEjZHRW.d.ts → null-storage-backend-uKQE8tl7.d.ts}

@@ -1,5 +1,5 @@
-import { n as SessionMetadata } from "./opfs-storage-DYm8WHq7.js";
-import { n as StorageBackend, t as CreateSessionResult } from "./storage-backend-C9HLFtgz.js";
+import { n as SessionMetadata } from "./opfs-storage-D5zAn_lx.js";
+import { n as StorageBackend, t as CreateSessionResult } from "./storage-backend-Do6YDpNo.js";
 
 //#region ../src/storage/null-storage-backend.d.ts
 declare class NullStorageBackend implements StorageBackend {

package/dist/{opfs-storage-DYm8WHq7.d.ts → opfs-storage-D5zAn_lx.d.ts}

@@ -14,7 +14,7 @@
  *       │   ├── actions/
  *       │   │   ├── 000001.json
  *       │   │   └── ...
- *       │   └── frames/
+ *       │   └── images/        (legacy recordings: frames/)
  *       │       ├── frame-000001.jpg
  *       │       └── ...
  *       └── ...
@@ -117,7 +117,7 @@ declare function getAppRootHandle(): FileSystemDirectoryHandle | null;
  * Creates the directory structure:
  * - /gps-plus-slam/sessions/recording-{timestamp}/
  * - /gps-plus-slam/sessions/recording-{timestamp}/actions/
- * - /gps-plus-slam/sessions/recording-{timestamp}/frames/
+ * - /gps-plus-slam/sessions/recording-{timestamp}/images/ (legacy: frames/)
  *
  * @param timestamp - Session start time (used for folder naming)
  * @param _contextTag - Opaque tag; not used by the flat layout but accepted

package/dist/{opfs-storage-backend-CjSAuqg_.d.ts → opfs-storage-backend-6aYMUZlJ.d.ts}

@@ -1,5 +1,5 @@
-import { n as SessionMetadata } from "./opfs-storage-DYm8WHq7.js";
-import { n as StorageBackend, t as CreateSessionResult } from "./storage-backend-C9HLFtgz.js";
+import { n as SessionMetadata } from "./opfs-storage-D5zAn_lx.js";
+import { n as StorageBackend, t as CreateSessionResult } from "./storage-backend-Do6YDpNo.js";
 
 //#region ../src/storage/opfs-storage-backend.d.ts
 declare class OpfsStorageBackend implements StorageBackend {

package/dist/{persistence-middleware-DwyzgfWr.d.ts → persistence-middleware-B9ei4Nhx.d.ts}

@@ -1,4 +1,4 @@
-import { n as StorageBackend } from "./storage-backend-C9HLFtgz.js";
+import { n as StorageBackend } from "./storage-backend-Do6YDpNo.js";
 import { Middleware } from "@reduxjs/toolkit";
 
 //#region ../src/state/persistence-middleware.d.ts

package/dist/{recording-replayer-BL-x-7k0.d.ts → recording-replayer-r0DZ9ALp.d.ts}

@@ -1,4 +1,4 @@
-import { L as CombinedRootState } from "./create-slam-app-store-qNXQ-tq5.js";
+import { L as CombinedRootState } from "./create-slam-app-store-BljusOua.js";
 import { i as RecordedAction } from "./zip-reader-DSEXt7K6.js";
 
 //#region ../src/state/recording-replayer.d.ts

package/dist/{replay-engine-BRqszuQ9.d.ts → replay-engine-XpDa0dy1.d.ts}

@@ -1,4 +1,4 @@
-import { i as SlamAppStore } from "./create-slam-app-store-qNXQ-tq5.js";
+import { i as SlamAppStore } from "./create-slam-app-store-BljusOua.js";
 import { ReducersMapObject } from "@reduxjs/toolkit";
 
 //#region ../src/state/replay-engine.d.ts

package/dist/state/app-selectors.d.ts

@@ -1,2 +1,2 @@
-import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-CcZ5UV-8.js";
+import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-B8VQoMDY.js";
 export { selectAlignmentMatrix, selectFrameTilesInWebXR, selectGpsPositions, selectOdometryPositions, selectOdometryRotations, selectZeroReference };

package/dist/state/app-selectors.js

@@ -58,7 +58,9 @@ const selectFrameTilesInWebXR = createSelector([selectOdometryPathPoints], (poin
 		position: nueToWebXR(p.position),
 		rotation: nueQuaternionToWebXR(p.rotation),
 		screenRotation: p.screenRotation,
-		capturedAt: p.capturedAt
+		capturedAt: p.capturedAt,
+		width: p.width,
+		height: p.height
 	}));
 });
 //#endregion

package/dist/state/combined-root-state.d.ts

@@ -1,2 +1,2 @@
-import { L as CombinedRootState } from "../create-slam-app-store-qNXQ-tq5.js";
+import { L as CombinedRootState } from "../create-slam-app-store-BljusOua.js";
 export { CombinedRootState };

package/dist/state/create-slam-app-store.d.ts

@@ -1,2 +1,2 @@
-import { a as SlamAppStoreOptions, i as SlamAppStore, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, t as SlamAppCombinedState } from "../create-slam-app-store-qNXQ-tq5.js";
+import { a as SlamAppStoreOptions, i as SlamAppStore, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, t as SlamAppCombinedState } from "../create-slam-app-store-BljusOua.js";
 export { SlamAppCombinedState, SlamAppMiddleware, SlamAppRootState, SlamAppStore, SlamAppStoreOptions, createSlamAppStore };

package/dist/state/gps-ar-pose-sampler.d.ts

@@ -1,4 +1,4 @@
 import { t as ARPose } from "../ar-types-Dan1MVTi.js";
-import { o as extractOdomPosition, s as extractOdomRotation } from "../gps-event-coordinator-BDIQde2x.js";
+import { o as extractOdomPosition, s as extractOdomRotation } from "../gps-event-coordinator-CWIDOk4U.js";
 import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-DVb96iOy.js";
 export { ARPose, CaptureGpsAnchorSampleOptions, GpsAnchorSample, GpsAnchorSampleGpsPoint, captureGpsAnchorSample, extractOdomPosition, extractOdomRotation };

package/dist/state/gps-event-coordinator.d.ts

@@ -1,2 +1,2 @@
-import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as updateDeviceOrientation } from "../gps-event-coordinator-BDIQde2x.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as updateDeviceOrientation } from "../gps-event-coordinator-CWIDOk4U.js";
 export { RecordingCoordinatorConfig, buildRawGpsPoint, buildRecordGpsEventPayload, createGpsPositionHandler, eulerToQuaternion, extractOdomPosition, extractOdomRotation, getLastDeviceOrientation, resetCoordinatorState, updateDeviceOrientation };

package/dist/state/index.d.ts

@@ -2,16 +2,16 @@ import { i as DepthSample, r as DepthPoint } from "../ar-types-Dan1MVTi.js";
 import { _ as validateRecordingOptions, a as IMAGE_CONSTRAINTS, c as RecordingOptionsInput, d as loadRecordingOptions, f as resetRecordingOptions, g as validateImageOptions, h as validateDepthOptions, i as DepthCaptureOptions, l as STORAGE_KEY, n as DEFAULT_RECORDING_OPTIONS, o as ImageCaptureOptions, p as saveRecordingOptions, r as DEPTH_CONSTRAINTS, u as cloneRecordingOptions } from "../recording-options-DJBXuMxV.js";
 import { a as TrackingSliceState, c as poseLost, d as selectLastRestartedPayload, f as selectLastSensorOrientation, g as trackingReducer, h as selectTrackingPhase, i as TrackingPhase, l as poseReceived, m as selectLostFrameCount, n as PoseReceivedPayload, o as clearLastRestartedPayload, p as selectLastValidPose, r as ResetTransformData, s as originReset, t as DeviceOrientation, u as resetTracking } from "../tracking-slice-CdK8c-8P.js";
 import { a as recordWriteFailure, i as recordDepthSample, n as SessionMetadata$1, o as recordingReducer, r as endSession, s as startSession, t as RecordingState } from "../recording-slice-89O07ebs.js";
-import { n as SessionMetadata } from "../opfs-storage-DYm8WHq7.js";
-import { n as StorageBackend } from "../storage-backend-C9HLFtgz.js";
-import { A as resetTrackingQuality, C as computeResidualConsensus, D as firstAgreementReached, E as degradedCountUpdated, F as snapshotsTrimmed, I as trackingQualityReducer, M as selectRecentAlignments, N as selectTrackingQuality, O as matrixDelta, P as snapshotPushed, S as computeGpsVsFusedDivergence, T as createTrackingQualityListenerMiddleware, _ as TrackingQualityState, a as SlamAppStoreOptions, b as computeCoverage, d as DEFAULT_TRACKING_QUALITY_OPTIONS, g as TrackingQualitySliceState, h as TrackingQualityReport, i as SlamAppStore, j as selectFirstAgreementObservationIndex, k as reportUpdated, m as TrackingQualityOptions, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, v as computeCompassAgreement, w as computeTrackingQualityReport, x as computeGpsAccuracy, y as computeConvergence } from "../create-slam-app-store-qNXQ-tq5.js";
-import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as updateDeviceOrientation } from "../gps-event-coordinator-BDIQde2x.js";
+import { n as SessionMetadata } from "../opfs-storage-D5zAn_lx.js";
+import { n as StorageBackend } from "../storage-backend-Do6YDpNo.js";
+import { A as resetTrackingQuality, C as computeResidualConsensus, D as firstAgreementReached, E as degradedCountUpdated, F as snapshotsTrimmed, I as trackingQualityReducer, M as selectRecentAlignments, N as selectTrackingQuality, O as matrixDelta, P as snapshotPushed, S as computeGpsVsFusedDivergence, T as createTrackingQualityListenerMiddleware, _ as TrackingQualityState, a as SlamAppStoreOptions, b as computeCoverage, d as DEFAULT_TRACKING_QUALITY_OPTIONS, g as TrackingQualitySliceState, h as TrackingQualityReport, i as SlamAppStore, j as selectFirstAgreementObservationIndex, k as reportUpdated, m as TrackingQualityOptions, n as SlamAppMiddleware, o as createSlamAppStore, r as SlamAppRootState, s as AlignmentSnapshot, t as SlamAppCombinedState, v as computeCompassAgreement, w as computeTrackingQualityReport, x as computeGpsAccuracy, y as computeConvergence } from "../create-slam-app-store-BljusOua.js";
+import { a as eulerToQuaternion, c as getLastDeviceOrientation, i as createGpsPositionHandler, l as resetCoordinatorState, n as buildRawGpsPoint, o as extractOdomPosition, r as buildRecordGpsEventPayload, s as extractOdomRotation, t as RecordingCoordinatorConfig, u as updateDeviceOrientation } from "../gps-event-coordinator-CWIDOk4U.js";
 import { i as captureGpsAnchorSample, n as GpsAnchorSample, r as GpsAnchorSampleGpsPoint, t as CaptureGpsAnchorSampleOptions } from "../gps-ar-pose-sampler-DVb96iOy.js";
-import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-BL-x-7k0.js";
-import { n as createPersistenceMiddleware, r as slicePrefixOf, t as PersistenceMiddlewareOptions } from "../persistence-middleware-DwyzgfWr.js";
-import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-BRqszuQ9.js";
-import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector-CP3BKSbF.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-rrkLkFTt.js";
-import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-CcZ5UV-8.js";
-import { a as RawGpsPoint, c as calcRelativeCoordsInMeters, d as OnboardingGuidance, f as OnboardingPhase, i as RawDeviceOrientation, l as recordGpsEvent, m as selectOnboardingGuidance, n as GpsPoint, o as RecordGpsEventPayload, p as computeOnboardingGuidance, r as LatLong, s as add2dImage, t as Add2dImagePayload, u as setZeroPos } from "../index-KJq2amHF.js";
+import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-r0DZ9ALp.js";
+import { n as createPersistenceMiddleware, r as slicePrefixOf, t as PersistenceMiddlewareOptions } from "../persistence-middleware-B9ei4Nhx.js";
+import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-XpDa0dy1.js";
+import { n as subscribeToSelector, t as SubscribableStore } from "../subscribe-to-selector-CZ6k1NFP.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-0YWyOLvV.js";
+import { a as selectOdometryRotations, i as selectOdometryPositions, n as selectFrameTilesInWebXR, o as selectZeroReference, r as selectGpsPositions, t as selectAlignmentMatrix } from "../app-selectors-B8VQoMDY.js";
+import { a as RawGpsPoint, c as calcRelativeCoordsInMeters, d as OnboardingGuidance, f as OnboardingPhase, i as RawDeviceOrientation, l as recordGpsEvent, m as selectOnboardingGuidance, n as GpsPoint, o as RecordGpsEventPayload, p as computeOnboardingGuidance, r as LatLong, s as add2dImage, t as Add2dImagePayload, u as setZeroPos } from "../index-BYYUdf9v.js";
 export { Add2dImagePayload, AlignmentSnapshot, CaptureGpsAnchorSampleOptions, CompleteCallback, DEFAULT_MAX_DELAY_MS, DEFAULT_RECORDING_OPTIONS, DEFAULT_TRACKING_QUALITY_OPTIONS, DEPTH_CONSTRAINTS, DepthCaptureOptions, DepthPoint, DepthSample, DeviceOrientation, ErrorCallback, GpsAnchorSample, GpsAnchorSampleGpsPoint, GpsPoint, IMAGE_CONSTRAINTS, ImageCaptureOptions, LatLong, OnboardingGuidance, OnboardingPhase, SessionMetadata as OpfsSessionMetadata, PersistenceMiddlewareOptions, PoseReceivedPayload, ProgressCallback, RawDeviceOrientation, RawGpsPoint, RecordGpsEventPayload, RecordingCoordinatorConfig, RecordingOptionsInput, RecordingState, ReplayAction, ReplayEngine, ReplayRecordingOptions, ReplayState, ResetTransformData, STORAGE_KEY, SessionMetadata$1 as SessionMetadata, SlamAppCombinedState, SlamAppMiddleware, SlamAppRootState, SlamAppStore, SlamAppStoreOptions, StorageBackend, StoreSubscriberDeps, SubscribableStore, TrackingPhase, TrackingQualityOptions, TrackingQualityReport, TrackingQualitySliceState, TrackingQualityState, TrackingSliceState, add2dImage, buildRawGpsPoint, buildRecordGpsEventPayload, calcRelativeCoordsInMeters, captureGpsAnchorSample, clearLastRestartedPayload, cloneRecordingOptions, computeCompassAgreement, computeConvergence, computeCoverage, computeGpsAccuracy, computeGpsVsFusedDivergence, computeInterActionDelay, computeOnboardingGuidance, computeResidualConsensus, computeTrackingQualityReport, createGpsPositionHandler, createPersistenceMiddleware, createSlamAppStore, createTrackingQualityListenerMiddleware, degradedCountUpdated, endSession, eulerToQuaternion, extractActionTimestamp, extractOdomPosition, extractOdomRotation, firstAgreementReached, getLastDeviceOrientation, loadRecordingOptions, matrixDelta, originReset, poseLost, poseReceived, recordDepthSample, recordGpsEvent, recordWriteFailure, recordingReducer, replayRecording, reportUpdated, resetCoordinatorState, resetRecordingOptions, resetTracking, resetTrackingQuality, saveRecordingOptions, selectAlignmentMatrix, selectFirstAgreementObservationIndex, selectFrameTilesInWebXR, selectGpsPositions, selectLastRestartedPayload, selectLastSensorOrientation, selectLastValidPose, selectLostFrameCount, selectOdometryPositions, selectOdometryRotations, selectOnboardingGuidance, selectRecentAlignments, selectTrackingPhase, selectTrackingQuality, selectZeroReference, setZeroPos, slicePrefixOf, snapshotPushed, snapshotsTrimmed, startSession, subscribeToSelector, trackingQualityReducer, trackingReducer, updateDeviceOrientation, validateDepthOptions, validateImageOptions, validateRecordingOptions, wireStoreSubscribers };

package/dist/state/persistence-middleware.d.ts

@@ -1,2 +1,2 @@
-import { n as createPersistenceMiddleware, r as slicePrefixOf, t as PersistenceMiddlewareOptions } from "../persistence-middleware-DwyzgfWr.js";
+import { n as createPersistenceMiddleware, r as slicePrefixOf, t as PersistenceMiddlewareOptions } from "../persistence-middleware-B9ei4Nhx.js";
 export { PersistenceMiddlewareOptions, createPersistenceMiddleware, slicePrefixOf };

package/dist/state/recording-replayer.d.ts

@@ -1,3 +1,3 @@
-import { L as CombinedRootState } from "../create-slam-app-store-qNXQ-tq5.js";
-import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-BL-x-7k0.js";
+import { L as CombinedRootState } from "../create-slam-app-store-BljusOua.js";
+import { n as replayRecording, t as ReplayRecordingOptions } from "../recording-replayer-r0DZ9ALp.js";
 export { CombinedRootState, ReplayRecordingOptions, replayRecording };

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

@@ -1,2 +1,2 @@
-import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-BRqszuQ9.js";
+import { a as ReplayAction, c as computeInterActionDelay, i as ProgressCallback, l as extractActionTimestamp, n as DEFAULT_MAX_DELAY_MS, o as ReplayEngine, r as ErrorCallback, s as ReplayState, t as CompleteCallback } from "../replay-engine-XpDa0dy1.js";
 export { CompleteCallback, DEFAULT_MAX_DELAY_MS, ErrorCallback, ProgressCallback, ReplayAction, ReplayEngine, ReplayState, computeInterActionDelay, extractActionTimestamp };

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

@@ -1,3 +1,3 @@
-import { t as SubscribableStore } from "../subscribe-to-selector-CP3BKSbF.js";
-import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-rrkLkFTt.js";
+import { t as SubscribableStore } from "../subscribe-to-selector-CZ6k1NFP.js";
+import { n as wireStoreSubscribers, t as StoreSubscriberDeps } from "../store-subscribers-0YWyOLvV.js";
 export { StoreSubscriberDeps, SubscribableStore, wireStoreSubscribers };

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

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

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

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

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

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

package/dist/storage/file-system-utils.js

@@ -27,5 +27,21 @@ function formatActionFilename(index) {
 function formatFrameFilename(index) {
 	return `frame-${String(index).padStart(6, "0")}.jpg`;
 }
+/**
+* Canonical session subdirectory for captured camera images, written by new
+* recordings. Renamed from {@link LEGACY_SESSION_IMAGES_DIR} so an exported ZIP
+* is a textbook COLMAP tree (`images/frame-NNNNNN.jpg` next to `sparse/0/`).
+* Both the OPFS write path and the recorder's persisted `imageFile` value must
+* use THIS constant so a recording stays self-consistent (COLMAP export plan
+* Q5, gps-plus-slam/GpsPlusSlamJs_Docs/docs/2026-06-13-colmap-export-plan.md).
+*/
+const SESSION_IMAGES_DIR = "images";
+/**
+* The pre-2026-06 session image subdirectory. Recordings made before the
+* {@link SESSION_IMAGES_DIR} rename store frames under `frames/` (in both the
+* on-disk dir and the persisted `imageFile`); readers fall back to this prefix
+* so old recordings still replay.
+*/
+const LEGACY_SESSION_IMAGES_DIR = "frames";
 //#endregion
-export { formatActionFilename, formatFrameFilename, formatTimestamp };
+export { LEGACY_SESSION_IMAGES_DIR, SESSION_IMAGES_DIR, formatActionFilename, formatFrameFilename, formatTimestamp };

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-C_eqiEA8.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-CwXTNHmB.js";
 export { ClearRefPointsCacheResult, WriteAccessResult, clearRefPointsCacheForAllScenarios, ensureScenarioDirectory, getCurrentScenarioHandle, initStorage, listSessions, resetForNewSession, resetStorageState, setCurrentScenario, startSession, verifyWriteAccess, writeAction, writeFrame, writeSessionMetadata };

package/dist/storage/file-system.js

@@ -1,6 +1,6 @@
 import { createLogger } from "../utils/logger.js";
 import { setFileSystemState } from "../sensors/permission-checker.js";
-import { formatTimestamp } from "./file-system-utils.js";
+import { SESSION_IMAGES_DIR, formatTimestamp } from "./file-system-utils.js";
 import { createSession, getAppRootHandle, initOpfsStorage, listSessions as listSessions$1, resetOpfsStorage, resetSessionHandles, setSessionHandles, writeAction as writeAction$1, writeFrame as writeFrame$1, writeSessionMetadata as writeSessionMetadata$1 } from "./opfs-storage.js";
 //#region ../src/storage/file-system.ts
 /**
@@ -137,7 +137,7 @@ async function startSession(scenarioName) {
 		currentScenarioHandle = scenarioHandle;
 		const sessionName = `recording-${formatTimestamp(/* @__PURE__ */ new Date())}`;
 		const sessionHandle = await scenarioHandle.getDirectoryHandle(sessionName, { create: true });
-		setSessionHandles(sessionHandle, await sessionHandle.getDirectoryHandle("actions", { create: true }), await sessionHandle.getDirectoryHandle("frames", { create: true }));
+		setSessionHandles(sessionHandle, await sessionHandle.getDirectoryHandle("actions", { create: true }), await sessionHandle.getDirectoryHandle(SESSION_IMAGES_DIR, { create: true }));
 		_currentScenarioName = scenarioName;
 		log.info("Session started:", `${scenarioName}/${sessionName}`);
 		return {

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-DYm8WHq7.js";
-import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-C9HLFtgz.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-D5zAn_lx.js";
+import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-Do6YDpNo.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-DSEXt7K6.js";
-import { t as NullStorageBackend } from "../null-storage-backend-CxEjZHRW.js";
-import { t as OpfsStorageBackend } from "../opfs-storage-backend-CjSAuqg_.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-C_eqiEA8.js";
-import { n as formatFrameFilename, r as formatTimestamp, t as formatActionFilename } from "../file-system-utils-DyAmcuvX.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-D_5HAvFz.js";
+import { t as NullStorageBackend } from "../null-storage-backend-uKQE8tl7.js";
+import { t as OpfsStorageBackend } from "../opfs-storage-backend-6aYMUZlJ.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-CwXTNHmB.js";
+import { a as formatTimestamp, i as formatFrameFilename, r as formatActionFilename } from "../file-system-utils-CXIoL-DM.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-G14hkSPG.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-CxEjZHRW.js";
+import { t as NullStorageBackend } from "../null-storage-backend-uKQE8tl7.js";
 export { NullStorageBackend };

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

@@ -1,2 +1,2 @@
-import { t as OpfsStorageBackend } from "../opfs-storage-backend-CjSAuqg_.js";
+import { t as OpfsStorageBackend } from "../opfs-storage-backend-6aYMUZlJ.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-DYm8WHq7.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-D5zAn_lx.js";
 export { CreateSessionResult, SessionMetadata, checkStorageQuota, createSession, getAppRootHandle, getSessionHandle, getSessionsRootHandle, initOpfsStorage, listSessions, resetOpfsStorage, resetSessionHandles, setSessionHandles, writeAction, writeFrame, writeSessionMetadata };

package/dist/storage/opfs-storage.js

@@ -1,5 +1,5 @@
 import { createLogger } from "../utils/logger.js";
-import { formatActionFilename, formatFrameFilename, formatTimestamp } from "./file-system-utils.js";
+import { SESSION_IMAGES_DIR, formatActionFilename, formatFrameFilename, formatTimestamp } from "./file-system-utils.js";
 //#region ../src/storage/opfs-storage.ts
 /**
 * OPFS Storage Module
@@ -16,7 +16,7 @@ import { formatActionFilename, formatFrameFilename, formatTimestamp } from "./fi
 *       │   ├── actions/
 *       │   │   ├── 000001.json
 *       │   │   └── ...
-*       │   └── frames/
+*       │   └── images/        (legacy recordings: frames/)
 *       │       ├── frame-000001.jpg
 *       │       └── ...
 *       └── ...
@@ -94,7 +94,7 @@ function getAppRootHandle() {
 * Creates the directory structure:
 * - /gps-plus-slam/sessions/recording-{timestamp}/
 * - /gps-plus-slam/sessions/recording-{timestamp}/actions/
-* - /gps-plus-slam/sessions/recording-{timestamp}/frames/
+* - /gps-plus-slam/sessions/recording-{timestamp}/images/ (legacy: frames/)
 *
 * @param timestamp - Session start time (used for folder naming)
 * @param _contextTag - Opaque tag; not used by the flat layout but accepted
@@ -107,7 +107,7 @@ async function createSession(timestamp, _contextTag) {
 	const sessionName = `recording-${formatTimestamp(timestamp)}`;
 	currentSessionHandle = await sessionsDir.getDirectoryHandle(sessionName, { create: true });
 	actionsHandle = await currentSessionHandle.getDirectoryHandle("actions", { create: true });
-	framesHandle = await currentSessionHandle.getDirectoryHandle("frames", { create: true });
+	framesHandle = await currentSessionHandle.getDirectoryHandle(SESSION_IMAGES_DIR, { create: true });
 	log.info("Session created:", sessionName);
 	return { sessionName };
 }

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

@@ -1,2 +1,2 @@
-import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-C9HLFtgz.js";
+import { n as StorageBackend, t as CreateSessionResult } from "../storage-backend-Do6YDpNo.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-D_5HAvFz.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-G14hkSPG.js";
 export { ExportSessionAsZipOptions, ZipContributorAddFile, ZipExportContributor, ZipExportResult, downloadZip, exportAndDownloadSession, exportSessionAsZip, syncToExternalZip };

package/dist/storage/zip-export.js

@@ -61,7 +61,7 @@ async function streamDirectoryToZip(dirHandle, zipWriter, basePath = "") {
 * 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, ...
+* - images/frame-000001.jpg, images/frame-000002.jpg, ... (legacy: frames/)
 * - refPoints/{h3}.json (only observations from this session, scenario layout only)
 *
 * Uses "store" mode (compression level 0) for fast packaging.

package/dist/storage/zip-reader.js

@@ -13,7 +13,7 @@ import { BlobReader, TextWriter, Uint8ArrayReader, ZipReader } from "@zip.js/zip
 *   actions/000001.json  — Redux action JSON files (1-based, zero-padded)
 *   actions/000002.json
 *   ...
-*   frames/frame-000001.jpg  — captured image frames (optional)
+*   images/frame-000001.jpg  — captured image frames (optional; legacy: frames/)
 *   session.json             — session metadata (optional, see F1 bug)
 */
 const log = createLogger("ZipReader");

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

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

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

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

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

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

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

@@ -1,3 +1,4 @@
+import { SESSION_IMAGES_DIR } from "../storage/file-system-utils.js";
 import { createSession, initOpfsStorage, resetOpfsStorage, writeAction, writeFrame, writeSessionMetadata } from "../storage/opfs-storage.js";
 import { exportSessionAsZip } from "../storage/zip-export.js";
 import { installOPFSMocks } from "./browser-mocks.js";
@@ -86,7 +87,7 @@ async function produceTestZip(opts) {
 		for (let i = 0; i < options.imagesBeforeSetZero; i++) await writeAndRecordAction({
 			type: "gpsData/add2dImage",
 			payload: {
-				imageFile: `frames/frame-${String(actionIndex + 1).padStart(6, "0")}.jpg`,
+				imageFile: `${SESSION_IMAGES_DIR}/frame-${String(actionIndex + 1).padStart(6, "0")}.jpg`,
 				position: [
 					i * .5,
 					0,
@@ -143,7 +144,7 @@ async function produceTestZip(opts) {
 			await writeAndRecordAction({
 				type: "gpsData/add2dImage",
 				payload: {
-					imageFile: `frames/frame-${String(imgIdx).padStart(6, "0")}.jpg`,
+					imageFile: `${SESSION_IMAGES_DIR}/frame-${String(imgIdx).padStart(6, "0")}.jpg`,
 					position: [
 						(i + 1) * 1,
 						(i + 1) * .5,

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-ColHB_5A.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-C9lwwIyI.js";
 export { ArWorldGroupAlignmentHandle, ArWorldGroupAlignmentOptions, enableArWorldGroupAlignment };

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

@@ -1,6 +1,6 @@
 import { createLogger } from "../utils/logger.js";
 import { disposeMeshArray } from "./three-dispose.js";
-import { c as getArWorldGroup, m as getScene } from "../webxr-session-QhcSSub5.js";
+import { c as getArWorldGroup, m as getScene } from "../webxr-session-TIaD883f.js";
 import { VIS_COLORS } from "./vis-colors.js";
 import * as THREE from "three";
 //#region ../src/visualization/gps-event-markers.ts

package/dist/visualization/index.d.ts

@@ -2,7 +2,7 @@ import { n as createCss3dRendererManager, t as Css3dRendererManager } from "../c
 import { n as createCameraFollower, t as CameraFollower } from "../camera-follower-C2mwEn7c.js";
 import { n as createAlignmentLerper, t as AlignmentLerper } from "../alignment-lerper-Dm9G7JJO.js";
 import { n as MapDataInput, r as buildMapData, t as MapData } from "../map-data-CkloBxIl.js";
-import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-ColHB_5A.js";
+import { n as ArWorldGroupAlignmentOptions, r as enableArWorldGroupAlignment, t as ArWorldGroupAlignmentHandle } from "../ar-world-group-alignment-C9lwwIyI.js";
 import { i as createGpsCompassCubes, n as COMPASS_CUBE_SIZE, r as GpsCompassCubes, t as COMPASS_CUBE_DISTANCE } from "../gps-compass-cubes-BM1uGiYV.js";
 import { i as isSphereInCameraFrustum, n as isObjectInCameraFrustum, r as isPointInCameraFrustum, t as buildCameraFrustum } from "../frustum-visibility-CmI96ESS.js";
 import { n as worldNueToGps, t as nueToArLocal } from "../frame-conversions-BfsafGWR.js";

package/dist/{webxr-session-DtAG9srK.d.ts → webxr-session-GjZ2BIpS.d.ts}

@@ -1,7 +1,7 @@
 import { i as DepthSample, t as ARPose } from "./ar-types-Dan1MVTi.js";
 import { i as DepthSamplerConfig } from "./depth-sampler-Bhanfwla.js";
 import { t as ArCrashIsolationOptions } from "./recording-options-DJBXuMxV.js";
-import { i as ImageCaptureConfig, t as CapturedImage } from "./image-capture-DZ4HFRgS.js";
+import { a as ImageCaptureConfig, n as CapturedImage } from "./image-capture-qAZ5Fh5X.js";
 import { a as TrackingSliceState, r as ResetTransformData } from "./tracking-slice-CdK8c-8P.js";
 import { t as Css3dRendererManager } from "./css3d-renderer-manager-ptu_t3B3.js";
 import { r as XRCameraLike } from "./xr-camera-texture-DBwCaKTd.js";

package/dist/{webxr-session-QhcSSub5.js → webxr-session-TIaD883f.js}

@@ -897,14 +897,27 @@ function startImageCapture(config) {
 	const currentRenderer = renderer;
 	const divisor = mergedConfig.resolutionDivisor;
 	callbacks.captureFrame = async (quality) => {
-		if (!blitCapture || !latestCameraTexture) return new Promise((resolve) => {
-			currentRenderer.domElement.toBlob((blob) => resolve(blob), "image/jpeg", quality);
-		});
+		if (!blitCapture || !latestCameraTexture) {
+			const canvas = currentRenderer.domElement;
+			return new Promise((resolve) => {
+				canvas.toBlob((blob) => resolve(blob ? {
+					blob,
+					width: canvas.width,
+					height: canvas.height
+				} : null), "image/jpeg", quality);
+			});
+		}
 		if (latestCameraWidth > 0 && latestCameraHeight > 0) {
 			const target = computeCaptureSize(latestCameraWidth, latestCameraHeight, divisor);
 			blitCapture.resizeIfNeeded(target.width, target.height);
 		}
-		return blitCapture.captureToBlob(currentRenderer, latestCameraTexture, quality);
+		const blob = await blitCapture.captureToBlob(currentRenderer, latestCameraTexture, quality);
+		if (!blob) return null;
+		return {
+			blob,
+			width: blitCapture.getWidth(),
+			height: blitCapture.getHeight()
+		};
 	};
 	log.info(`Blit capture pipeline initialized (resolutionDivisor=${divisor})`);
 	imageCaptureManager = new ImageCaptureManager(renderer.domElement, callbacks, mergedConfig);

package/dist/{zip-export-D_5HAvFz.d.ts → zip-export-G14hkSPG.d.ts}

@@ -83,7 +83,7 @@ interface ExportSessionAsZipOptions {
  * 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, ...
+ * - images/frame-000001.jpg, images/frame-000002.jpg, ... (legacy: frames/)
  * - refPoints/{h3}.json (only observations from this session, scenario layout only)
  *
  * Uses "store" mode (compression level 0) for fast packaging.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gps-plus-slam-app-framework",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Reusable AR+GPS app framework layer — WebXR session management, Three.js visualization, GPS sensors, storage abstractions, replay engine, and store wiring for gps-plus-slam-js.",
   "type": "module",
   "files": [
@@ -36,7 +36,7 @@
   "dependencies": {
     "@reduxjs/toolkit": "^2.11.2",
     "gl-matrix": "3.4.4",
-    "gps-plus-slam-js": "^1.0.7"
+    "gps-plus-slam-js": "^1.3.0"
   },
   "peerDependencies": {
     "@sentry/browser": ">=10.0.0",

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

@@ -1,24 +0,0 @@
-//#region ../src/storage/file-system-utils.d.ts
-/**
- * File System Utilities - Pure Functions
- *
- * These are extracted from file-system.ts so they can be tested
- * without mocking browser APIs.
- */
-/**
- * Format a Date as a timestamp string for folder names
- * @example "2025-02-28_14-30-11utc"
- */
-declare function formatTimestamp(date: Date): string;
-/**
- * Format an action file index as a zero-padded filename
- * @example 42 -> "000042.json"
- */
-declare function formatActionFilename(index: number): string;
-/**
- * Format a frame index as a zero-padded filename
- * @example 42 -> "frame-000042.jpg"
- */
-declare function formatFrameFilename(index: number): string;
-//#endregion
-export { formatFrameFilename as n, formatTimestamp as r, formatActionFilename as t };