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

package/dist/{zip-reader-D7pkpX8K.d.ts → zip-reader-D1105idz.d.ts}

@@ -77,6 +77,11 @@ declare function loadSessionMetadataFromBlob(blob: Blob, maxFileSize?: number):
 interface GpsPathCoord {
   readonly lat: number;
   readonly lng: number;
+  /**
+   * Horizontal accuracy in meters (1σ), if the source GPS event included it.
+   * Used by 2D-map previews to draw a per-event accuracy circle.
+   */
+  readonly accuracy?: number;
 }
 /**
  * Extract GPS coordinates from a recording zip provided as a Blob.
@@ -93,5 +98,37 @@ interface GpsPathCoord {
  * @returns Array of GPS coordinates in chronological order
  */
 declare function loadGpsPathFromBlob(blob: Blob, maxFileSize?: number): Promise<GpsPathCoord[]>;
+/**
+ * A single file pulled out of a contributor-owned subdirectory inside a
+ * recording zip. Returned by {@link loadEntriesFromSubdir}.
+ *
+ * `getText()` is lazy: callers pay the decompression cost only for files they
+ * actually open, so iterating an entire `refPoints/` subdir to harvest a few
+ * entries stays cheap.
+ */
+interface ZipSubdirEntry {
+  /** Filename relative to the subdir (e.g. `'42.json'`, not `'refPoints/42.json'`). */
+  readonly relativePath: string;
+  /** Original full filename inside the ZIP (`'refPoints/42.json'`). */
+  readonly fullPath: string;
+  /** Uncompressed size in bytes. */
+  readonly uncompressedSize: number;
+  /** Lazily decode the entry as UTF-8 text. */
+  getText(): Promise<string>;
+}
+/**
+ * Enumerate every file under a single top-level subdirectory of a recording
+ * zip. Mirrors the writer-side {@link ZipExportContributor} seam so consumers
+ * (typically the recorder) can read back what they wrote without
+ * re-implementing zip enumeration.
+ *
+ * Skips directory entries and files outside `subdir`. Sorts entries by
+ * `relativePath` for deterministic iteration. Returns an empty array when
+ * the subdir is absent (graceful degradation for older zips).
+ *
+ * @param data - The zip file content as a Uint8Array
+ * @param subdir - Top-level subdir to scan (no leading or trailing `/`)
+ */
+declare function loadEntriesFromSubdir(data: Uint8Array, subdir: string): Promise<ZipSubdirEntry[]>;
 //#endregion
-export { ZipActionEntry as a, loadSessionMetadata as c, RecordedAction as i, loadSessionMetadataFromBlob as l, GpsPathCoord as n, loadActionsFromZip as o, MAX_ACTION_FILE_SIZE as r, loadGpsPathFromBlob as s, Entry$1 as t, readZipEntries as u };
+export { ZipActionEntry as a, loadEntriesFromSubdir as c, loadSessionMetadataFromBlob as d, readZipEntries as f, RecordedAction as i, loadGpsPathFromBlob as l, GpsPathCoord as n, ZipSubdirEntry as o, MAX_ACTION_FILE_SIZE as r, loadActionsFromZip as s, Entry$1 as t, loadSessionMetadata as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gps-plus-slam-app-framework",
-  "version": "1.0.0",
+  "version": "1.0.7",
   "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": [
@@ -10,14 +10,15 @@
     ".": "./dist/index.js",
     "./ar": "./dist/ar/index.js",
     "./ar/*": "./dist/ar/*.js",
+    "./core": "./dist/core/index.js",
     "./sensors": "./dist/sensors/index.js",
     "./sensors/*": "./dist/sensors/*.js",
     "./state": "./dist/state/index.js",
     "./state/*": "./dist/state/*.js",
     "./storage": "./dist/storage/index.js",
     "./storage/*": "./dist/storage/*.js",
-    "./ref-points": "./dist/ref-points/index.js",
-    "./ref-points/*": "./dist/ref-points/*.js",
+    "./geo": "./dist/geo/index.js",
+    "./geo/*": "./dist/geo/*.js",
     "./visualization": "./dist/visualization/index.js",
     "./visualization/*": "./dist/visualization/*.js",
     "./utils": "./dist/utils/index.js",
@@ -35,7 +36,7 @@
   "dependencies": {
     "@reduxjs/toolkit": "^2.11.2",
     "gl-matrix": "3.4.4",
-    "gps-plus-slam-js": "^1.0.0"
+    "gps-plus-slam-js": "^1.0.7"
   },
   "peerDependencies": {
     "@sentry/browser": ">=10.0.0",
@@ -54,27 +55,27 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@sentry/browser": "^10.49.0",
+    "@sentry/browser": "^10.53.1",
     "@types/leaflet": "^1.9.21",
-    "@types/node": "^25.6.0",
-    "@types/three": "^0.184.0",
-    "@vitest/coverage-v8": "^4.1.5",
-    "@vitest/eslint-plugin": "^1.6.16",
+    "@types/node": "^25.7.0",
+    "@types/three": "^0.184.1",
+    "@vitest/coverage-v8": "^4.1.6",
+    "@vitest/eslint-plugin": "^1.6.17",
     "@zip.js/zip.js": "^2.8.26",
-    "dpdm": "^4.0.1",
-    "eslint": "^10.2.1",
+    "dpdm": "^4.2.0",
+    "eslint": "^10.3.0",
     "eslint-config-prettier": "^10.1.8",
-    "fast-check": "^4.7.0",
-    "globals": "^17.5.0",
+    "fast-check": "^4.8.0",
+    "globals": "^17.6.0",
     "h3-js": "^4.4.0",
-    "jsdom": "^29.0.2",
+    "jsdom": "^29.1.1",
     "leaflet": "^1.9.4",
     "prettier": "^3.8.3",
     "three": "^0.184.0",
-    "tsdown": "^0.21.9",
+    "tsdown": "^0.22.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.0",
-    "vitest": "^4.1.5"
+    "typescript-eslint": "^8.59.3",
+    "vitest": "^4.1.6"
   },
   "keywords": [
     "ar",
@@ -86,6 +87,15 @@
   ],
   "author": "cs-util-com",
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cs-util-com/location-based-webxr.git",
+    "directory": "GpsPlusSlamJs_AppFramework"
+  },
+  "homepage": "https://github.com/cs-util-com/location-based-webxr#readme",
+  "bugs": {
+    "url": "https://github.com/cs-util-com/location-based-webxr/issues"
+  },
   "scripts": {
     "test": "pnpm run test:core",
     "test:core": "pnpm run format && pnpm run lint && pnpm run typecheck && pnpm run typecheck:tests && pnpm run test:unit",
@@ -93,8 +103,9 @@
     "format:check": "prettier --check --ignore-unknown .",
     "build": "tsdown --config config/tsdown.config.ts",
     "verify:pack": "pnpm pack --dry-run",
+    "verify:community-key-lifetime": "node scripts/verify-community-key-lifetime.mjs",
     "test:unit": "vitest run --coverage --config config/vitest.config.ts",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.app.json --noEmit",
     "typecheck:tests": "tsc -p tsconfig.vitest.json --noEmit",
     "lint": "eslint . --config config/eslint.config.mjs",
     "test:watch": "vitest --config config/vitest.config.ts",

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

@@ -1,2 +0,0 @@
-import { a as TrackingStateManager, i as TrackingStateCallbacks, n as ResetTransformData, r as TrackingState, t as DeviceOrientation } from "../tracking-state-B9QfuZCg.js";
-export { DeviceOrientation, ResetTransformData, TrackingState, TrackingStateCallbacks, TrackingStateManager };

package/dist/ar/tracking-state.js

@@ -1,164 +0,0 @@
-import { createLogger } from "../utils/logger.js";
-import { extractOdomPosition } from "../state/recording-coordinator.js";
-//#region ../src/ar/tracking-state.ts
-/**
-* Tracking State Manager
-*
-* Detects AR tracking loss and restart events, maintaining state
-* about the last valid odometry pose for alignment correction.
-*
-* ARCHITECTURE NOTE: See docs/architecture-ar-gps-pose-separation.md
-*
-* When WebXR tracking is lost and restarted, the odometry frame resets
-* to a new origin. To maintain GPS+AR alignment, we need to:
-* 1. Store the last valid pose before tracking was lost
-* 2. Detect when tracking resumes with a new pose
-* 3. Dispatch odometryTrackingRestarted with both poses for offset calculation
-*/
-const log = createLogger("TrackingState");
-/**
-* Possible tracking states
-*/
-let TrackingState = /* @__PURE__ */ function(TrackingState) {
-	/** AR session started but no pose received yet */
-	TrackingState["INITIALIZING"] = "initializing";
-	/** Actively receiving valid poses */
-	TrackingState["TRACKING"] = "tracking";
-	/** Pose became unavailable (tracking lost) */
-	TrackingState["LOST"] = "lost";
-	return TrackingState;
-}({});
-/**
-* Manages AR tracking state and detects loss/restart events.
-*/
-var TrackingStateManager = class {
-	state = "initializing";
-	lastValidPose = null;
-	lastSensorOrientation = null;
-	lostFrameCount = 0;
-	originResetDuringLoss = false;
-	resetTransform = void 0;
-	callbacks;
-	constructor(callbacks) {
-		this.callbacks = callbacks;
-	}
-	/**
-	* Get current tracking state.
-	*/
-	getState() {
-		return this.state;
-	}
-	/**
-	* Get the last valid AR pose (before tracking was lost).
-	*/
-	getLastValidPose() {
-		return this.lastValidPose;
-	}
-	/**
-	* Get count of consecutive frames without pose (during LOST state).
-	*/
-	getLostFrameCount() {
-		return this.lostFrameCount;
-	}
-	/**
-	* Flag that an XRReferenceSpace reset event occurred during tracking loss.
-	* Only meaningful while in LOST state — ignored otherwise.
-	*
-	* @param transform — Serialized XRReferenceSpaceEvent.transform (post-reset
-	*   origin in pre-reset coordinates).  Pass `null` when the event's
-	*   transform property is null (runtime can't determine delta).
-	*   Omit entirely for backwards-compat with callers that don't have it.
-	*/
-	markOriginReset(transform) {
-		if (this.state === "lost") {
-			this.originResetDuringLoss = true;
-			this.resetTransform = transform;
-		}
-	}
-	/**
-	* Called when a valid pose is received from WebXR.
-	*/
-	onPoseReceived(pose) {
-		if (this.state === "lost") this.handleTrackingRestarted(pose);
-		this.state = "tracking";
-		this.lastValidPose = pose;
-		this.lastSensorOrientation = this.callbacks.getDeviceOrientation();
-		this.lostFrameCount = 0;
-	}
-	/**
-	* Called when pose is null/unavailable from WebXR.
-	*/
-	onPoseLost() {
-		this.lostFrameCount++;
-		if (this.state === "tracking") {
-			this.state = "lost";
-			this.callbacks.onTrackingLost();
-			log.warn("AR tracking lost");
-		}
-	}
-	/**
-	* Reset the manager to initial state.
-	* Call this when starting a new session.
-	*/
-	reset() {
-		this.state = "initializing";
-		this.lastValidPose = null;
-		this.lastSensorOrientation = null;
-		this.lostFrameCount = 0;
-		this.originResetDuringLoss = false;
-		this.resetTransform = void 0;
-	}
-	/**
-	* Handle the transition from LOST to TRACKING (restart detected).
-	*/
-	handleTrackingRestarted(newPose) {
-		const hadReset = this.originResetDuringLoss;
-		const savedResetTransform = this.resetTransform;
-		this.originResetDuringLoss = false;
-		this.resetTransform = void 0;
-		if (!hadReset) {
-			log.info("AR tracking recovered (same coordinate frame)");
-			this.callbacks.onTrackingRecovered?.();
-			return;
-		}
-		if (!this.lastValidPose) {
-			log.warn("Tracking restarted but no previous pose available");
-			return;
-		}
-		const currentSensorOrientation = this.callbacks.getDeviceOrientation();
-		const lastOrientation = this.lastSensorOrientation ?? currentSensorOrientation;
-		const payload = {
-			lastValidOdomPos: extractOdomPosition(this.lastValidPose),
-			lastValidOdomRot: [
-				this.lastValidPose.orientation.x,
-				this.lastValidPose.orientation.y,
-				this.lastValidPose.orientation.z,
-				this.lastValidPose.orientation.w
-			],
-			lastSensorOrientation: {
-				alpha: lastOrientation.alpha,
-				beta: lastOrientation.beta,
-				gamma: lastOrientation.gamma,
-				absolute: lastOrientation.absolute
-			},
-			newOdomRot: [
-				newPose.orientation.x,
-				newPose.orientation.y,
-				newPose.orientation.z,
-				newPose.orientation.w
-			],
-			newSensorOrientation: {
-				alpha: currentSensorOrientation.alpha,
-				beta: currentSensorOrientation.beta,
-				gamma: currentSensorOrientation.gamma,
-				absolute: currentSensorOrientation.absolute
-			},
-			newOdomPos: extractOdomPosition(newPose),
-			resetTransform: savedResetTransform
-		};
-		log.info("AR tracking restarted (origin reset), dispatching alignment correction");
-		this.callbacks.onTrackingRestarted(payload);
-	}
-};
-//#endregion
-export { TrackingState, TrackingStateManager };

package/dist/community-license-key-ChZLCJyO.d.ts

@@ -1,21 +0,0 @@
-//#region ../src/licensing/community-license-key.d.ts
-/**
- * Community license key for the gps-plus-slam-js core library.
- *
- * Generated by the core library maintainers and bundled with the open-source
- * `gps-plus-slam-app-framework` package so that every example app (and any
- * downstream app built on the framework) automatically uses a valid license
- * without per-developer registration.
- *
- * The key has a rolling expiration of 12 months. Each release of the
- * open-source packages renews it. Active users who regularly update their
- * dependencies will never be affected by the expiration.
- *
- * For licenses with extended validity beyond the community key's scope,
- * contact support@csutil.com.
- *
- * @see GpsPlusSlamJs/EULA.md §3 — License Key
- */
-declare const COMMUNITY_LICENSE_KEY = "eyJ0eXBlIjoiY29tbXVuaXR5IiwiZXhwIjoxODA4NzcyNDI3fQ.YYNf0IdqniZdMzRXCuvewxsQQ01XNywrKsfL5IpiJotfFJfqtrGg4u9z0QFhXeszPtUhnvgC8_oOnbOkbXPuAw";
-//#endregion
-export { COMMUNITY_LICENSE_KEY as t };

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

@@ -1,128 +0,0 @@
-import { n as ArPoseTuples } from "./ar-types-B-ORgk6Z.js";
-import { n as SessionMetadata } from "./opfs-storage-ChOzF_Wp.js";
-import { LatLongAlt } from "gps-plus-slam-js";
-
-//#region ../src/storage/file-system.d.ts
-/**
- * Reset module state - exported for testing only
- * @internal
- */
-declare function resetStorageState(): void;
-/**
- * Reset session-level state for a new recording.
- *
- * Clears scenario/session names and OPFS session handles, but preserves
- * `storageInitialized` and the OPFS root so `initStorage()` doesn't need
- * to be called again.
- *
- * Used during soft reset for new recordings (Issue 4, 2026-02-06 user feedback).
- */
-declare function resetForNewSession(): void;
-/**
- * Result of write access verification.
- */
-interface WriteAccessResult {
-  /** Whether write access was successfully verified */
-  success: boolean;
-  /** Error message if write verification failed */
-  error?: string;
-}
-/**
- * Verify that we have actual write access to a directory.
- *
- * This probes the directory by creating a test file, writing content,
- * and cleaning up. This catches cases where showDirectoryPicker grants
- * a handle but the underlying file system is read-only.
- *
- * User Feedback Issue #1: Even with mode: 'readwrite', Android can
- * return a handle where getFileHandle({create: true}) succeeds but
- * createWritable() fails with NoModificationAllowedError.
- *
- * @param dirHandle - Directory handle to verify
- * @returns Success status and optional error message
- */
-declare function verifyWriteAccess(dirHandle: FileSystemDirectoryHandle): Promise<WriteAccessResult>;
-/**
- * Initialize storage using OPFS.
- *
- * This replaces the old showDirectoryPicker approach which failed on Android Chrome.
- * OPFS is automatically available and doesn't require user folder selection.
- *
- * @returns List of existing scenario folder names
- * @throws Error if OPFS is not supported
- */
-declare function initStorage(): Promise<string[]>;
-/**
- * Create or open a scenario folder, then create a new session folder.
- *
- * Now uses OPFS backend instead of showDirectoryPicker.
- *
- * @param scenarioName - Name of the scenario
- */
-declare function startSession(scenarioName: string): Promise<{
-  scenarioPath: string;
-  sessionPath: string;
-}>;
-/**
- * Write a Redux action to OPFS as a JSON file.
- */
-declare function writeAction(action: unknown, index: number): Promise<void>;
-/**
- * Write a captured frame image to OPFS.
- */
-declare function writeFrame(blob: Blob, index: number): Promise<void>;
-/**
- * Write session metadata (session.json) to OPFS.
- * Contains timing, counts, and user agent for the recording session.
- */
-declare function writeSessionMetadata(metadata: SessionMetadata): Promise<void>;
-/**
- * Shape of a parsed action file for type safety
- */
-interface ParsedRefPointAction {
-  type: string;
-  payload: {
-    id: string;
-    gpsPosition?: LatLongAlt;
-    arPose?: ArPoseTuples;
-  };
-}
-/**
- * Type guard for reference point actions
- * Exported for testing
- */
-declare function isRefPointAction(action: unknown): action is ParsedRefPointAction;
-/**
- * Load existing reference points from a scenario (across all sessions).
- * Now uses OPFS storage backend.
- */
-declare function loadScenarioRefPoints(scenarioName: string): Promise<RefPointRecord[]>;
-/**
- * Get the current scenario handle (for loading prior sessions).
- * Now delegates to OPFS storage backend.
- */
-declare function getCurrentScenarioHandle(): FileSystemDirectoryHandle | null;
-/**
- * Set the current scenario handle (when user selects a scenario).
- * With OPFS, we just store the name - the actual handle is retrieved when needed.
- */
-declare function setCurrentScenario(scenarioName: string): Promise<FileSystemDirectoryHandle | null>;
-/**
- * Ensure a scenario directory exists in OPFS, creating it if necessary.
- * Used during OPFS recovery when the scenario directory was lost but ZIP
- * data is available for restoration.
- *
- * Unlike setCurrentScenario() which only reads, this creates on demand.
- */
-declare function ensureScenarioDirectory(scenarioName: string): Promise<FileSystemDirectoryHandle | null>;
-/**
- * Reference point record from prior sessions
- */
-interface RefPointRecord {
-  id: string;
-  sessionName: string;
-  gpsPosition?: LatLongAlt;
-  arPose?: ArPoseTuples;
-}
-//#endregion
-export { initStorage as a, resetForNewSession as c, startSession as d, verifyWriteAccess as f, writeSessionMetadata as h, getCurrentScenarioHandle as i, resetStorageState as l, writeFrame as m, WriteAccessResult as n, isRefPointAction as o, writeAction as p, ensureScenarioDirectory as r, loadScenarioRefPoints as s, RefPointRecord as t, setCurrentScenario as u };

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

@@ -1,67 +0,0 @@
-import { LatLong, Vector3 } from "gps-plus-slam-js";
-
-//#region ../src/visualization/gps-event-markers.d.ts
-/**
- * Manager for GPS event visualization
- */
-declare class GpsEventVisualizer {
-  private rawGpsMarkers;
-  private fusedMarkers;
-  private snapshotMarkers;
-  private zeroRef;
-  private eventCounter;
-  private snapshotCounter;
-  /**
-   * Set the GPS zero reference (origin for coordinate conversion).
-   * Must be called before adding GPS events.
-   *
-   * @param zero - GPS coordinates of the origin
-   */
-  setZeroRef(zero: LatLong): void;
-  /**
-   * Get the current zero reference
-   */
-  getZeroRef(): LatLong | null;
-  /**
-   * Add a GPS event to the visualization.
-   * Creates both a raw GPS marker and a fused alignment marker.
-   *
-   * @param gpsCoords - GPS position as [x, y, z] meters from zero reference
-   * @param odomPosition - AR odometry position at the time of GPS reading
-   */
-  addGpsEvent(gpsCoords: Vector3, odomPosition: Vector3): void;
-  /**
-   * Add an alignment snapshot marker at the given NUE position.
-   * Snapshots represent the system's best GPS estimate at each alignment update.
-   * Added to scene root (GPS world space), not arWorldGroup.
-   */
-  addAlignmentSnapshot(nuePosition: Vector3): void;
-  /**
-   * Get the NUE positions of all alignment snapshot markers.
-   * Used at session end to convert to GPS coordinates for the summary map.
-   */
-  getAlignmentSnapshotPositions(): Vector3[];
-  /**
-   * Create a sphere marker mesh with the given color and name.
-   */
-  private createMarkerMesh;
-  /**
-   * Clear all markers from the scene and reset state.
-   */
-  clearAll(): void;
-  /**
-   * Get count of visible markers.
-   */
-  getCounts(): {
-    raw: number;
-    fused: number;
-    snapshots: number;
-  };
-}
-/**
- * Singleton instance for global use.
- * Import this to visualize GPS events.
- */
-declare const gpsEventVisualizer: GpsEventVisualizer;
-//#endregion
-export { gpsEventVisualizer as n, GpsEventVisualizer as t };

package/dist/licensing/community-license-key.d.ts

@@ -1,2 +0,0 @@
-import { t as COMMUNITY_LICENSE_KEY } from "../community-license-key-ChZLCJyO.js";
-export { COMMUNITY_LICENSE_KEY };

package/dist/licensing/community-license-key.js

@@ -1,21 +0,0 @@
-//#region ../src/licensing/community-license-key.ts
-/**
-* Community license key for the gps-plus-slam-js core library.
-*
-* Generated by the core library maintainers and bundled with the open-source
-* `gps-plus-slam-app-framework` package so that every example app (and any
-* downstream app built on the framework) automatically uses a valid license
-* without per-developer registration.
-*
-* The key has a rolling expiration of 12 months. Each release of the
-* open-source packages renews it. Active users who regularly update their
-* dependencies will never be affected by the expiration.
-*
-* For licenses with extended validity beyond the community key's scope,
-* contact support@csutil.com.
-*
-* @see GpsPlusSlamJs/EULA.md §3 — License Key
-*/
-const COMMUNITY_LICENSE_KEY = "eyJ0eXBlIjoiY29tbXVuaXR5IiwiZXhwIjoxODA4NzcyNDI3fQ.YYNf0IdqniZdMzRXCuvewxsQQ01XNywrKsfL5IpiJotfFJfqtrGg4u9z0QFhXeszPtUhnvgC8_oOnbOkbXPuAw";
-//#endregion
-export { COMMUNITY_LICENSE_KEY };

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

@@ -1,11 +0,0 @@
-import { n as SessionMetadata } from "./opfs-storage-ChOzF_Wp.js";
-import { t as StorageBackend } from "./storage-backend-BcEItnFr.js";
-
-//#region ../src/storage/opfs-storage-backend.d.ts
-declare class OpfsStorageBackend implements StorageBackend {
-  writeAction(action: unknown, index: number): Promise<void>;
-  writeFrame(blob: Blob, index: number): Promise<void>;
-  writeSessionMetadata(metadata: SessionMetadata): Promise<void>;
-}
-//#endregion
-export { OpfsStorageBackend as t };

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

@@ -1,31 +0,0 @@
-import { t as StorageBackend } from "./storage-backend-BcEItnFr.js";
-import { Middleware } from "@reduxjs/toolkit";
-
-//#region ../src/state/persistence-middleware.d.ts
-interface PersistenceMiddlewareOptions {
-  /**
-   * StorageBackend to use for action persistence.
-   */
-  storageBackend: StorageBackend;
-  /**
-   * Callback invoked when a write operation fails during persistence.
-   * User Feedback Issue #1 Part B: Used to show toast notifications.
-   */
-  onWriteFailure?: (error: Error) => void;
-}
-/**
- * Create a Redux middleware that persists qualifying actions to storage
- * during active recording sessions.
- *
- * Persistence rules:
- * - Only persists when `state.recorder.isRecording` is true (checked AFTER
- *   the action is reduced, so `startSession` itself is included).
- * - Persists `gpsData/*` and `recorder/*` actions.
- * - Excludes `recorder/recordWriteFailure` to prevent recursive persistence.
- * - Excludes `routing/*`, `refPoints/*`, and any other non-recording actions.
- * - Uses 1-based indexing for action files (000001.json, 000002.json, …).
- * - Each middleware instance maintains its own action index (Bug 10 fix).
- */
-declare function createPersistenceMiddleware(options: PersistenceMiddlewareOptions): Middleware;
-//#endregion
-export { createPersistenceMiddleware as n, PersistenceMiddlewareOptions as t };

package/dist/recorder-slice-fcwAXrsh.d.ts

@@ -1,35 +0,0 @@
-import { i as DepthSample } from "./ar-types-B-ORgk6Z.js";
-import { s as RecordingOptions } from "./recording-options-BYUFX8iU.js";
-import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
-
-//#region ../src/state/recorder-slice.d.ts
-interface SessionMetadata {
-  scenarioName: string;
-  sessionName: string;
-  startTime: number;
-  deviceInfo?: string;
-  notes?: string;
-  /** Recording options used for this session (for replay context) */
-  recordingOptions?: RecordingOptions;
-}
-interface RecorderState {
-  isRecording: boolean;
-  sessionMetadata: SessionMetadata | null;
-  actionCount: number;
-  /**
-   * Count of failed file write operations during this session.
-   * User Feedback Issue #1 Part B: Track write failures for visibility.
-   */
-  failedWriteCount: number;
-  /**
-   * Currently selected scenario name.
-   * Replaces the closure variable in folder-manager.ts so any module
-   * can read it via store.getState().recorder.currentScenarioName.
-   * @see docs/2026-03-26-state-management-audit.md §9.4 Priority 2
-   */
-  currentScenarioName: string;
-}
-declare const startSession: _$_reduxjs_toolkit0.ActionCreatorWithPayload<SessionMetadata, "recorder/startSession">, endSession: _$_reduxjs_toolkit0.ActionCreatorWithoutPayload<"recorder/endSession">, recordDepthSample: _$_reduxjs_toolkit0.ActionCreatorWithPayload<DepthSample, "recorder/recordDepthSample">, recordWriteFailure: _$_reduxjs_toolkit0.ActionCreatorWithPayload<string, "recorder/recordWriteFailure">, setCurrentScenarioName: _$_reduxjs_toolkit0.ActionCreatorWithPayload<string, "recorder/setCurrentScenarioName">;
-declare const recorderReducer: _$_reduxjs_toolkit0.Reducer<RecorderState>;
-//#endregion
-export { recordWriteFailure as a, startSession as c, recordDepthSample as i, SessionMetadata as n, recorderReducer as o, endSession as r, setCurrentScenarioName as s, RecorderState as t };