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

package/dist/{zip-export-Rtpi75JJ.d.ts → zip-export-BjrQPv0X.d.ts}

@@ -28,6 +28,55 @@ interface ZipExportResult {
   /** Number of files packaged in the ZIP */
   readonly fileCount: number;
 }
+/**
+ * Helper passed to a {@link ZipExportContributor.contribute} callback for
+ * appending blobs to the ZIP under a stable, contributor-owned subdirectory.
+ *
+ * The framework prepends the contributor's `subdir` to the supplied
+ * `relativePath` automatically, so contributors only think in terms of paths
+ * relative to their own subdir (e.g. `'42.json'`, not `'refPoints/42.json'`).
+ */
+type ZipContributorAddFile = (relativePath: string, blob: Blob) => Promise<void>;
+/**
+ * Extension contributor that lets a consumer (typically the recorder)
+ * append app-specific files to a session ZIP without forking the
+ * framework's ZIP writer.
+ *
+ * Each contributor declares a top-level subdirectory it owns inside the
+ * ZIP (e.g. the recorder uses `refPoints/`). The framework calls
+ * {@link contribute} after writing all framework-owned sections.
+ *
+ * Contributors must:
+ *  - Only write files under their declared `subdir` (the framework enforces
+ *    this by routing every `addFile` call through the prefix).
+ *  - Tolerate an empty source (e.g. a session with no ref points) by
+ *    returning `0` instead of throwing.
+ *
+ * @see 2026-05-03-appframework-vs-recorderapp-boundary-analysis.md — Iter 2.
+ */
+interface ZipExportContributor {
+  /** Top-level subdirectory inside the ZIP (no leading or trailing `/`). */
+  readonly subdir: string;
+  /**
+   * Append files for this contributor. Implementations call `addFile`
+   * once per file with a path relative to {@link subdir}.
+   *
+   * @returns Number of files added so the framework's `fileCount` total
+   *   stays accurate for download summaries.
+   */
+  contribute(addFile: ZipContributorAddFile): Promise<number>;
+}
+/**
+ * Options for {@link exportSessionAsZip}.
+ */
+interface ExportSessionAsZipOptions {
+  /**
+   * Optional list of {@link ZipExportContributor}s. Each is invoked after
+   * framework-owned sections have been written. Order is preserved in the
+   * resulting ZIP central directory but has no semantic effect.
+   */
+  readonly contributors?: readonly ZipExportContributor[];
+}
 /**
  * Export a session from OPFS as a ZIP blob.
  *
@@ -35,16 +84,18 @@ interface ZipExportResult {
  * - session.json (at root)
  * - actions/000001.json, actions/000002.json, ...
  * - frames/frame-000001.jpg, frames/frame-000002.jpg, ...
- * - refPoints/{h3}.json (only observations from this session)
+ * - refPoints/{h3}.json (only observations from this session, scenario layout only)
  *
  * Uses "store" mode (compression level 0) for fast packaging.
  *
- * @param scenarioName - Name of the scenario
- * @param sessionName - Name of the session folder
+ * Supports both flat and scenario-based layouts:
+ * - `exportSessionAsZip(sessionName)` — flat layout (sessions/)
+ * - `exportSessionAsZip(scenarioName, sessionName)` — scenario layout (scenarios/{name}/)
+ *
  * @returns ZIP export result with blob and file count
- * @throws Error if scenario or session not found
+ * @throws Error if session not found
  */
-declare function exportSessionAsZip(scenarioName: string, sessionName: string): Promise<ZipExportResult>;
+declare function exportSessionAsZip(scenarioNameOrSessionName: string, sessionName?: string, options?: ExportSessionAsZipOptions): Promise<ZipExportResult>;
 /**
  * Sync current OPFS session data to an external file handle.
  *
@@ -63,7 +114,7 @@ declare function exportSessionAsZip(scenarioName: string, sessionName: string):
  * @returns ZIP export result with blob and file count
  * @throws Error if scenario or session not found
  */
-declare function syncToExternalZip(fileHandle: FileSystemFileHandle, scenarioName: string, sessionName: string): Promise<ZipExportResult>;
+declare function syncToExternalZip(fileHandle: FileSystemFileHandle, scenarioName: string, sessionName: string, options?: ExportSessionAsZipOptions): Promise<ZipExportResult>;
 /**
  * Trigger a file download in the browser.
  *
@@ -84,4 +135,4 @@ declare function downloadZip(blob: Blob, filename: string): Promise<void>;
  */
 declare function exportAndDownloadSession(scenarioName: string, sessionName: string): Promise<void>;
 //#endregion
-export { syncToExternalZip as a, exportSessionAsZip as i, downloadZip as n, exportAndDownloadSession as r, ZipExportResult as t };
+export { downloadZip as a, syncToExternalZip as c, ZipExportResult as i, ZipContributorAddFile as n, exportAndDownloadSession as o, ZipExportContributor as r, exportSessionAsZip as s, ExportSessionAsZipOptions as t };

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

@@ -93,5 +93,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.6",
   "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.6"
   },
   "peerDependencies": {
     "@sentry/browser": ">=10.0.0",
@@ -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,6 +103,7 @@
     "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:tests": "tsc -p tsconfig.vitest.json --noEmit",

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/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/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 };

package/dist/ref-point-importer-B_wn5ABk.d.ts

@@ -1,62 +0,0 @@
-//#region ../src/storage/ref-point-importer.d.ts
-/**
- * Reference Point Importer Module
- *
- * Extracts reference points from ZIP files in a folder, enabling reuse of
- * ref points from previous recording sessions.
- *
- * This module:
- * 1. Enumerates all *.zip files in a folder
- * 2. Opens each ZIP and looks for refPoints/*.json files
- * 3. Parses and validates each ref point definition
- * 4. Merges and deduplicates ref points by ID
- *
- * Uses @zip.js/zip.js for ZIP reading (same library as zip-export.ts).
- */
-/**
- * Simplified reference point for import/suggestion purposes.
- * Contains only the essential data needed for ref point suggestions and display.
- * The `lat`/`lon` are kept for "nearby ref point" proximity suggestions.
- */
-interface ImportedRefPoint {
-  /** Unique identifier — H3 hex index since the March 2026 H3 migration */
-  readonly id: string;
-  /** Human-readable display name entered by the user (e.g., "Bench Corner") */
-  readonly name: string;
-  /** Latitude from first observation (for future proximity-based suggestions) */
-  readonly lat: number;
-  /** Longitude from first observation */
-  readonly lon: number;
-  /** Optional altitude */
-  readonly alt?: number;
-  /** Source ZIP file name for debugging/tracking */
-  readonly sourceZipName: string;
-}
-/**
- * Result from importing reference points from a folder.
- */
-interface RefPointImportResult {
-  /** Whether the import completed (even with some errors) */
-  readonly success: boolean;
-  /** Merged, deduplicated reference points from all ZIPs */
-  readonly refPoints: ImportedRefPoint[];
-  /** Number of ZIP files successfully scanned */
-  readonly zipFilesScanned: number;
-  /** Error messages from failed ZIPs or malformed ref points */
-  readonly errors: string[];
-}
-/**
- * Import reference points from all ZIP files in a folder.
- *
- * Enumerates all *.zip files in the folder, extracts refPoints/*.json from each,
- * and merges them into a deduplicated list.
- *
- * Deduplication: If the same ref point ID appears in multiple ZIPs, the first
- * occurrence is kept (based on iteration order).
- *
- * @param folderHandle - Read-only directory handle from showDirectoryPicker
- * @returns Result containing merged ref points, scan count, and errors
- */
-declare function importRefPointsFromFolder(folderHandle: FileSystemDirectoryHandle): Promise<RefPointImportResult>;
-//#endregion
-export { RefPointImportResult as n, importRefPointsFromFolder as r, ImportedRefPoint as t };

package/dist/ref-point-loader-Pt1smgHS.d.ts

@@ -1,117 +0,0 @@
-import { n as ArPoseTuples } from "./ar-types-B-ORgk6Z.js";
-import { GpsPoint, LatLongAlt, Quaternion, Vector3 } from "gps-plus-slam-js";
-
-//#region ../src/storage/ref-point-loader.d.ts
-/**
- * A single observation of a reference point in one session.
- */
-interface RefPointObservation {
-  /** Session ID (e.g., "recording-2025-02-28_14-30-11utc") */
-  readonly sessionId: string;
-  /** When this observation was made */
-  readonly timestamp: number;
-  /** AR pose at the moment of marking */
-  readonly arPose: ArPoseTuples;
-  /** Full GPS point from library (includes lat/lon, accuracy, etc.) */
-  readonly gpsPoint: GpsPoint;
-  /** Fused GPS from aligned VIO path at mark time (absent in legacy data) */
-  readonly fusedGpsPoint?: {
-    latitude: number;
-    longitude: number;
-    altitude?: number;
-  };
-}
-/**
- * Complete definition of a reference point with all observations.
- */
-interface RefPointDefinition {
-  /** Unique identifier (e.g., "pointA", "benchCorner") */
-  id: string;
-  /** Human-readable name */
-  name: string;
-  /** Timestamp of first observation */
-  createdAt: number;
-  /** All observations across sessions */
-  observations: RefPointObservation[];
-}
-/**
- * Load all reference point definitions from the scenario's refPoints/ directory.
- *
- * @param scenarioHandle - File system handle for the scenario folder
- * @returns Array of all reference point definitions
- */
-declare function loadAllRefPoints(scenarioHandle: FileSystemDirectoryHandle): Promise<RefPointDefinition[]>;
-/**
- * Load a specific reference point by ID.
- *
- * @param scenarioHandle - File system handle for the scenario folder
- * @param pointId - Reference point ID
- * @returns Reference point definition or null if not found
- */
-declare function loadRefPoint(scenarioHandle: FileSystemDirectoryHandle, pointId: string): Promise<RefPointDefinition | null>;
-/**
- * Save or update a reference point observation.
- * Creates the refPoints/ directory if it doesn't exist.
- * If the reference point exists, appends the new observation.
- * If it doesn't exist, creates a new reference point file.
- *
- * @param scenarioHandle - File system handle for the scenario folder
- * @param pointId - Reference point ID
- * @param pointName - Human-readable name for the reference point
- * @param observation - New observation to add
- */
-declare function saveRefPointObservation(scenarioHandle: FileSystemDirectoryHandle, pointId: string, pointName: string, observation: RefPointObservation): Promise<void>;
-/**
- * Write a complete RefPointDefinition to OPFS.
- * Creates the refPoints/ directory if it doesn't exist.
- * Used by the recovery flow to restore definitions extracted from ZIPs.
- *
- * @param scenarioHandle - File system handle for the scenario folder
- * @param definition - Complete ref point definition to write
- */
-declare function writeRefPointDefinition(scenarioHandle: FileSystemDirectoryHandle, definition: RefPointDefinition): Promise<void>;
-/**
- * Get list of all reference point IDs in the scenario.
- * Useful for autocomplete/suggestions.
- *
- * @param scenarioHandle - File system handle for the scenario folder
- * @returns Array of reference point IDs
- */
-declare function listRefPointIds(scenarioHandle: FileSystemDirectoryHandle): Promise<string[]>;
-/**
- * Marker type representing a single observation suitable for visualization.
- * Position/rotation use odometry frame; gpsPosition provides world coordinates.
- */
-interface RefPointMark {
-  id: string;
-  /** Odometry position at the moment of marking */
-  odomPosition: Vector3;
-  /** Odometry rotation at the moment of marking */
-  odomRotation: Quaternion;
-  /** GPS position if available */
-  gpsPosition?: LatLongAlt;
-  timestamp: number;
-}
-/**
- * Flatten an array of RefPointDefinition objects into individual RefPointMark
- * observations suitable for visualization.
- *
- * @param refPointDefs - Array of reference point definitions with observations
- * @returns Flat array of individual marks (one per observation)
- */
-declare function flattenRefPointsToMarks(refPointDefs: RefPointDefinition[]): RefPointMark[];
-/**
- * Compute one averaged GPS position per reference point ID.
- * For each observation, prefers `fusedGpsPoint` (sub-meter accuracy) when
- * available, falling back to raw `gpsPoint`. Returns the centroid (mean
- * lat/lon) across all observations.
- */
-declare function averageGpsPerRefPoint(refPointDefs: RefPointDefinition[]): Array<{
-  id: string;
-  name: string;
-  lat: number;
-  lon: number;
-  alt?: number;
-}>;
-//#endregion
-export { flattenRefPointsToMarks as a, loadRefPoint as c, averageGpsPerRefPoint as i, saveRefPointObservation as l, RefPointMark as n, listRefPointIds as o, RefPointObservation as r, loadAllRefPoints as s, RefPointDefinition as t, writeRefPointDefinition as u };

package/dist/ref-points/h3-ref-point.d.ts

@@ -1,2 +0,0 @@
-import { a as gpsToH3, i as findNearbyRefPoint, n as KnownRefPoint, o as h3RefsMatch, r as approxDistanceMetres, s as isH3Index, t as H3_RESOLUTION } from "../h3-ref-point-CFhayNSZ.js";
-export { H3_RESOLUTION, KnownRefPoint, approxDistanceMetres, findNearbyRefPoint, gpsToH3, h3RefsMatch, isH3Index };

package/dist/ref-points/index.d.ts

@@ -1,2 +0,0 @@
-import { a as gpsToH3, i as findNearbyRefPoint, n as KnownRefPoint, o as h3RefsMatch, r as approxDistanceMetres, s as isH3Index, t as H3_RESOLUTION } from "../h3-ref-point-CFhayNSZ.js";
-export { H3_RESOLUTION, type KnownRefPoint, approxDistanceMetres, findNearbyRefPoint, gpsToH3, h3RefsMatch, isH3Index };

package/dist/ref-points/index.js

@@ -1,2 +0,0 @@
-import { H3_RESOLUTION, approxDistanceMetres, findNearbyRefPoint, gpsToH3, h3RefsMatch, isH3Index } from "./h3-ref-point.js";
-export { H3_RESOLUTION, approxDistanceMetres, findNearbyRefPoint, gpsToH3, h3RefsMatch, isH3Index };

package/dist/ref-points-slice-tC-Wd6XJ.d.ts

@@ -1,48 +0,0 @@
-import { n as KnownRefPoint } from "./h3-ref-point-CFhayNSZ.js";
-import { t as ImportedRefPoint } from "./ref-point-importer-B_wn5ABk.js";
-import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
-
-//#region ../src/state/ref-points-slice.d.ts
-interface RefPointsState {
-  /** Prior ref points loaded from previous session ZIPs. */
-  importedRefPoints: ImportedRefPoint[];
-  /**
-   * Tracks how many times each ref point was marked in the current session.
-   * Keyed by ref-point ID (H3 index). Plain object for Redux serializability
-   * (replaces the Map<string, number> that lived in the closure).
-   */
-  sessionRefPointUsage: Record<string, number>;
-}
-declare const setImportedRefPoints: _$_reduxjs_toolkit0.ActionCreatorWithPayload<ImportedRefPoint[], "refPoints/setImportedRefPoints">, incrementRefPointUsage: _$_reduxjs_toolkit0.ActionCreatorWithPayload<string, "refPoints/incrementRefPointUsage">, clearSessionRefPointUsage: _$_reduxjs_toolkit0.ActionCreatorWithoutPayload<"refPoints/clearSessionRefPointUsage">, resetRefPointsState: _$_reduxjs_toolkit0.ActionCreatorWithoutPayload<"refPoints/resetRefPointsState">;
-declare const refPointsReducer: _$_reduxjs_toolkit0.Reducer<RefPointsState>;
-/**
- * Memoized selector that derives KnownRefPoint[] (with H3 indices) from
- * importedRefPoints. Replaces the closure-based `recomputeKnownRefPoints()`
- * in ref-point-handlers.ts.
- *
- * Uses createSelector (reselect) for standard RTK memoization — recomputes
- * only when the importedRefPoints array reference changes.
- */
-declare const selectCachedKnownRefPoints: ((state: RefPointsState) => KnownRefPoint[]) & {
-  clearCache: () => void;
-  resultsCount: () => number;
-  resetResultsCount: () => void;
-} & {
-  resultFunc: (resultFuncArgs_0: ImportedRefPoint[]) => KnownRefPoint[];
-  memoizedResultFunc: ((resultFuncArgs_0: ImportedRefPoint[]) => KnownRefPoint[]) & {
-    clearCache: () => void;
-    resultsCount: () => number;
-    resetResultsCount: () => void;
-  };
-  lastResult: () => KnownRefPoint[];
-  dependencies: [(state: RefPointsState) => ImportedRefPoint[]];
-  recomputations: () => number;
-  resetRecomputations: () => void;
-  dependencyRecomputations: () => number;
-  resetDependencyRecomputations: () => void;
-} & {
-  memoize: typeof _$_reduxjs_toolkit0.weakMapMemoize;
-  argsMemoize: typeof _$_reduxjs_toolkit0.weakMapMemoize;
-};
-//#endregion
-export { resetRefPointsState as a, refPointsReducer as i, clearSessionRefPointUsage as n, selectCachedKnownRefPoints as o, incrementRefPointUsage as r, setImportedRefPoints as s, RefPointsState as t };