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

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

@@ -1,114 +0,0 @@
-import { n as SessionMetadata } from "./opfs-storage-DYm8WHq7.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.
- */
-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.
- */
-declare function verifyWriteAccess(dirHandle: FileSystemDirectoryHandle): Promise<WriteAccessResult>;
-/**
- * Initialize storage using OPFS.
- *
- * @returns List of existing scenario folder names
- * @throws Error if OPFS is not supported
- */
-declare function initStorage(): Promise<string[]>;
-/**
- * Create a new session folder.
- *
- * When scenarioName is provided, creates under the scenario directory
- * (legacy scenario layout for the recorder). When omitted, creates under
- * the flat sessions/ directory.
- *
- * @param scenarioName - Optional name of the scenario (omit for flat layout)
- */
-declare function startSession(scenarioName?: string): Promise<{
-  scenarioPath: string;
-  sessionPath: string;
-}>;
-/**
- * List all session names.
- * When scenarioName is provided, lists sessions under that scenario.
- * Otherwise lists flat sessions.
- */
-declare function listSessions(scenarioName?: string): Promise<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.
- */
-declare function writeSessionMetadata(metadata: SessionMetadata): Promise<void>;
-/**
- * Get the current scenario handle (for loading prior sessions).
- * Legacy: uses scenario directory layout.
- */
-declare function getCurrentScenarioHandle(): FileSystemDirectoryHandle | null;
-/**
- * Set the current scenario handle (when user selects a scenario).
- * Legacy: uses scenario directory layout.
- */
-declare function setCurrentScenario(scenarioName: string): Promise<FileSystemDirectoryHandle | null>;
-/**
- * Ensure a scenario directory exists in OPFS, creating it if necessary.
- * Legacy: used during OPFS recovery.
- */
-declare function ensureScenarioDirectory(scenarioName: string): Promise<FileSystemDirectoryHandle | null>;
-/**
- * Result of clearing the reference-point cache across all scenarios.
- */
-interface ClearRefPointsCacheResult {
-  /** Number of scenarios whose `refPoints/` directory was deleted. */
-  readonly scenariosCleared: number;
-  /** Total number of scenarios scanned (including ones with no cache). */
-  readonly scenariosScanned: number;
-  /** Names of scenarios that failed to clear, with reason. */
-  readonly errors: {
-    scenarioName: string;
-    reason: string;
-  }[];
-}
-/**
- * Clear the cached `refPoints/` directory for every scenario in OPFS.
- *
- * Used by the "Clear Reference Point Cache" maintenance action so that the
- * next scenario load re-imports ref points from the read folder's `*.zip`
- * recordings (see ref-point-recovery in the recorder app).
- *
- * Failures for individual scenarios are collected in `errors` rather than
- * aborting the whole operation — partial progress is still useful.
- *
- * @throws Error if OPFS storage is unavailable (e.g. `initStorage()` not yet
- *   called, or browser does not support OPFS). Surfacing this loudly avoids
- *   reporting a silent "0 scenarios cleared" success that would mask the
- *   real failure to the user.
- */
-declare function clearRefPointsCacheForAllScenarios(): Promise<ClearRefPointsCacheResult>;
-//#endregion
-export { getCurrentScenarioHandle as a, resetForNewSession as c, startSession as d, verifyWriteAccess as f, writeSessionMetadata as h, ensureScenarioDirectory as i, resetStorageState as l, writeFrame as m, WriteAccessResult as n, initStorage as o, writeAction as p, clearRefPointsCacheForAllScenarios as r, listSessions as s, ClearRefPointsCacheResult as t, setCurrentScenario as u };

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

package/dist/recording-options-DJBXuMxV.d.ts

@@ -1,182 +0,0 @@
-//#region ../src/state/recording-options.d.ts
-/**
- * Recording Options - User-configurable settings for data capture.
- *
- * Allows users to disable/configure high-frequency data streams
- * (depth sampling, image capture) to improve performance on lower-end devices.
- *
- * Options persist in localStorage across sessions.
- */
-/**
- * Input type for validateRecordingOptions allowing partial nested objects.
- * This allows passing incomplete objects that will be merged with defaults.
- */
-interface RecordingOptionsInput {
-  depth?: Partial<DepthCaptureOptions>;
-  images?: Partial<ImageCaptureOptions>;
-  arCrashIsolation?: Partial<ArCrashIsolationOptions>;
-}
-/**
- * Diagnostic flags for isolating pre-recording AR startup crashes.
- * These gates affect XR session negotiation and frame-loop behavior,
- * independently of recording-time image/depth capture.
- */
-interface ArCrashIsolationOptions {
-  enableDomOverlay: boolean;
-  enableCameraAccess: boolean;
-  enableDepthSensingFeature: boolean;
-  enableCss3dRenderer: boolean;
-  enableCameraTextureAcquisition: boolean;
-  /**
-   * Apply the Chromium WebXR camera-access tab-crash workaround at app
-   * bootstrap. The workaround always deletes
-   * `XRWebGLBinding.prototype.createProjectionLayer` /
-   * `XRRenderState.prototype.layers` (forcing `XRWebGLLayer`) — required on
-   * every affected Chrome build observed on-device, including Chrome 150 — and
-   * additionally persists the `baseLayer` across
-   * `XRSession.prototype.updateRenderState` only for Chrome builds inside the
-   * affected window (148.0.7778.12 up to 149.0.7821).
-   *
-   * Default `true`. Opt-out is offered because forcing `XRWebGLLayer` may break
-   * WebXR on unaffected (e.g. Quest) devices.
-   *
-   * @see GpsPlusSlamJs_AppFramework/src/ar/chromium-camera-access-workaround.ts
-   * @see https://github.com/mrdoob/three.js/issues/33404
-   */
-  applyChromiumProjectionLayerWorkaround: boolean;
-}
-/**
- * Configuration for depth sampling during recording.
- */
-interface DepthCaptureOptions {
-  /** Whether to capture depth samples. Default: true */
-  enabled: boolean;
-  /** Interval between samples in milliseconds. Default: 1000 */
-  intervalMs: number;
-  /**
-   * Grid size (N×N points per sample). Default: 16 — dense enough to
-   * populate the AR-space occupancy grid (2026-06-11 port plan §1).
-   */
-  gridSize: number;
-  /**
-   * Whether to enrich each depth point with the camera color at its view
-   * coordinates (RGB voxel coloring, occupancy-grid port plan Iter 8).
-   * Costs one small GPU blit+readback per sample (~1 Hz); when off, the
-   * occupancy cubes keep the height-based coloring. Default: true.
-   */
-  rgb: boolean;
-}
-/**
- * Configuration for image capture during recording.
- */
-interface ImageCaptureOptions {
-  /** Whether to capture images. Default: true */
-  enabled: boolean;
-  /** Interval between captures in milliseconds. Default: 2000 */
-  intervalMs: number;
-  /** JPEG quality (0.0 - 1.0). Default: 0.7 */
-  quality: number;
-  /** Resolution divisor: 1 = full native resolution, 2 = half, 4 = quarter. Default: 1 */
-  resolutionDivisor: number;
-}
-/**
- * User-configurable recording options.
- * Persisted to localStorage for cross-session consistency.
- */
-interface RecordingOptions {
-  /** Depth sampling configuration */
-  depth: DepthCaptureOptions;
-  /** Image capture configuration */
-  images: ImageCaptureOptions;
-  /** Diagnostic flags for pre-recording AR crash isolation */
-  arCrashIsolation: ArCrashIsolationOptions;
-}
-/**
- * localStorage key for persisted options.
- *
- * **Multi-tab caveat:** All tabs/instances sharing the same origin will
- * read and write this key. In multi-tab or embedded scenarios, concurrent
- * saves can silently overwrite each other. Use a custom `storageKey`
- * parameter in `loadRecordingOptions` / `saveRecordingOptions` to isolate
- * instances when needed.
- */
-declare const STORAGE_KEY = "gps-plus-slam-recorder-options";
-/** Default recording options (all streams enabled) */
-declare const DEFAULT_RECORDING_OPTIONS: RecordingOptions;
-/** Validation constraints for depth options */
-declare const DEPTH_CONSTRAINTS: {
-  readonly intervalMs: {
-    readonly min: 500;
-    readonly max: 5000;
-    readonly step: 100;
-  };
-  readonly gridSize: {
-    readonly min: 2;
-    readonly max: 32;
-    readonly step: 1;
-  };
-};
-/** Validation constraints for image options */
-declare const IMAGE_CONSTRAINTS: {
-  readonly intervalMs: {
-    readonly min: 1000;
-    readonly max: 10000;
-    readonly step: 500;
-  };
-  readonly quality: {
-    readonly min: 0.3;
-    readonly max: 1;
-    readonly step: 0.1;
-  };
-  readonly resolutionDivisor: {
-    readonly min: 1;
-    readonly max: 8;
-    readonly step: 1;
-  };
-};
-/**
- * Validate and normalize AR crash isolation flags.
- * Missing or invalid values fall back to defaults.
- */
-declare function validateArCrashIsolationOptions(options: Partial<ArCrashIsolationOptions>): ArCrashIsolationOptions;
-/**
- * Validate and normalize depth options.
- * Invalid values are clamped to valid ranges.
- */
-declare function validateDepthOptions(options: Partial<DepthCaptureOptions>): DepthCaptureOptions;
-/**
- * Validate and normalize image options.
- * Invalid values are clamped to valid ranges.
- */
-declare function validateImageOptions(options: Partial<ImageCaptureOptions>): ImageCaptureOptions;
-/**
- * Validate and normalize a full RecordingOptions object.
- * Merges with defaults and clamps invalid values.
- */
-declare function validateRecordingOptions(options: RecordingOptionsInput): RecordingOptions;
-/**
- * Load recording options from localStorage.
- * Returns defaults if no saved options exist or parsing fails.
- * Validates and merges with defaults to handle schema evolution.
- * @param storageKey - Optional custom localStorage key (defaults to STORAGE_KEY).
- */
-declare function loadRecordingOptions(storageKey?: string): RecordingOptions;
-/**
- * Save recording options to localStorage.
- * Options are validated before saving.
- * @param storageKey - Optional custom localStorage key (defaults to STORAGE_KEY).
- */
-declare function saveRecordingOptions(options: RecordingOptions, storageKey?: string): void;
-/**
- * Reset recording options to defaults.
- * Clears localStorage and returns default options.
- * @param storageKey - Optional custom localStorage key (defaults to STORAGE_KEY).
- */
-declare function resetRecordingOptions(storageKey?: string): RecordingOptions;
-/**
- * Create a deep copy of recording options.
- * Useful for creating mutable copies of the frozen defaults.
- */
-declare function cloneRecordingOptions(options: RecordingOptions): RecordingOptions;
-//#endregion
-export { validateRecordingOptions as _, IMAGE_CONSTRAINTS as a, RecordingOptionsInput as c, loadRecordingOptions as d, resetRecordingOptions as f, validateImageOptions as g, validateDepthOptions as h, DepthCaptureOptions as i, STORAGE_KEY as l, validateArCrashIsolationOptions as m, DEFAULT_RECORDING_OPTIONS as n, ImageCaptureOptions as o, saveRecordingOptions as p, DEPTH_CONSTRAINTS as r, RecordingOptions as s, ArCrashIsolationOptions as t, cloneRecordingOptions as u };

package/dist/recording-slice-89O07ebs.d.ts

@@ -1,36 +0,0 @@
-import { i as DepthSample } from "./ar-types-Dan1MVTi.js";
-import { s as RecordingOptions } from "./recording-options-DJBXuMxV.js";
-import * as _$_reduxjs_toolkit0 from "@reduxjs/toolkit";
-
-//#region ../src/state/recording-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 RecordingState {
-  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;
-  /**
-   * The most recent depth sample, kept ONLY so subscribers can observe new
-   * samples via reference comparison (the AR-space occupancy grid is fed
-   * this way — see the 2026-06-11 occupancy-grid port plan). The persisted
-   * action stream remains the source of truth; no history is kept here.
-   * The payload stays in raw WebXR coordinates — conversion-free.
-   */
-  latestDepthSample: DepthSample | null;
-}
-declare const startSession: _$_reduxjs_toolkit0.ActionCreatorWithPayload<SessionMetadata, "recording/startSession">, endSession: _$_reduxjs_toolkit0.ActionCreatorWithoutPayload<"recording/endSession">, recordDepthSample: _$_reduxjs_toolkit0.ActionCreatorWithPayload<DepthSample, "recording/recordDepthSample">, recordWriteFailure: _$_reduxjs_toolkit0.ActionCreatorWithPayload<string, "recording/recordWriteFailure">;
-declare const recordingReducer: _$_reduxjs_toolkit0.Reducer<RecordingState>;
-//#endregion
-export { recordWriteFailure as a, recordDepthSample as i, SessionMetadata as n, recordingReducer as o, endSession as r, startSession as s, RecordingState as t };

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

@@ -1,2 +0,0 @@
-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";
-export { ClearRefPointsCacheResult, WriteAccessResult, clearRefPointsCacheForAllScenarios, ensureScenarioDirectory, getCurrentScenarioHandle, initStorage, listSessions, resetForNewSession, resetStorageState, setCurrentScenario, startSession, verifyWriteAccess, writeAction, writeFrame, writeSessionMetadata };

package/dist/storage/file-system.js

@@ -1,289 +0,0 @@
-import { createLogger } from "../utils/logger.js";
-import { setFileSystemState } from "../sensors/permission-checker.js";
-import { 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
-/**
-* File System Storage Module
-*
-* Facade over the OPFS storage module. Provides session lifecycle, write
-* operations, and backwards-compatible scenario management for the recorder.
-*
-* The core OPFS module (opfs-storage.ts) is scenario-free — it manages
-* flat sessions/{timestamp}/ directories. This module bridges the gap by
-* managing scenario directory handles for consumers that still need them
-* (recorder, ref-point loader, etc.) until those are migrated to
-* ScenarioWrappingStorageBackend in later iterations.
-*/
-const log = createLogger("Storage");
-let _currentScenarioName = null;
-let storageInitialized = false;
-let scenariosDir = null;
-let currentScenarioHandle = null;
-/**
-* Reset module state - exported for testing only
-* @internal
-*/
-function resetStorageState() {
-	_currentScenarioName = null;
-	storageInitialized = false;
-	scenariosDir = null;
-	currentScenarioHandle = null;
-	resetOpfsStorage();
-}
-/**
-* 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.
-*/
-function resetForNewSession() {
-	_currentScenarioName = null;
-	currentScenarioHandle = null;
-	resetSessionHandles();
-}
-/**
-* Verify that we have actual write access to a directory.
-*/
-async function verifyWriteAccess(dirHandle) {
-	const testFilename = `.write-test-${Date.now()}`;
-	try {
-		const writable = await (await dirHandle.getFileHandle(testFilename, { create: true })).createWritable();
-		await writable.write("write-test");
-		await writable.close();
-		try {
-			await dirHandle.removeEntry(testFilename);
-		} catch (cleanupErr) {
-			log.warn("Write test cleanup failed (non-critical):", cleanupErr);
-		}
-		log.info("Write access verified for:", dirHandle.name);
-		return { success: true };
-	} catch (err) {
-		const error = err instanceof Error ? err : new Error(String(err));
-		log.error("Write verification failed:", error);
-		if (error.name === "NoModificationAllowedError") return {
-			success: false,
-			error: "Folder is read-only. Please select a different folder with write access."
-		};
-		return {
-			success: false,
-			error: `Cannot write to folder: ${error.message}`
-		};
-	}
-}
-async function ensureScenariosDir() {
-	if (scenariosDir) return scenariosDir;
-	const appRoot = getAppRootHandle();
-	if (!appRoot) return null;
-	scenariosDir = await appRoot.getDirectoryHandle("scenarios", { create: true });
-	return scenariosDir;
-}
-/**
-* List all scenario names in OPFS storage.
-* Legacy: scenarios are managed by the recorder, not the framework.
-*/
-async function listScenarios() {
-	const dir = await ensureScenariosDir();
-	if (!dir) return [];
-	const scenarios = [];
-	for await (const entry of dir.values()) if (entry.kind === "directory") scenarios.push(entry.name);
-	return scenarios;
-}
-/**
-* Initialize storage using OPFS.
-*
-* @returns List of existing scenario folder names
-* @throws Error if OPFS is not supported
-*/
-async function initStorage() {
-	try {
-		await initOpfsStorage();
-		storageInitialized = true;
-		setFileSystemState({
-			folderSelected: true,
-			writeVerified: true
-		});
-		await ensureScenariosDir();
-		const scenarios = await listScenarios();
-		log.info("OPFS storage initialized, found scenarios:", scenarios);
-		return scenarios;
-	} catch (err) {
-		const error = err instanceof Error ? err : new Error(String(err));
-		log.error("OPFS initialization failed:", error);
-		setFileSystemState({
-			folderSelected: false,
-			writeVerified: false,
-			writeError: error.message
-		});
-		throw error;
-	}
-}
-/**
-* Create a new session folder.
-*
-* When scenarioName is provided, creates under the scenario directory
-* (legacy scenario layout for the recorder). When omitted, creates under
-* the flat sessions/ directory.
-*
-* @param scenarioName - Optional name of the scenario (omit for flat layout)
-*/
-async function startSession(scenarioName) {
-	if (!storageInitialized) throw new Error("Storage not initialized. Call initStorage first.");
-	if (scenarioName) {
-		const dir = await ensureScenariosDir();
-		if (!dir) throw new Error("Failed to access scenarios directory.");
-		const scenarioHandle = await dir.getDirectoryHandle(scenarioName, { create: true });
-		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 }));
-		_currentScenarioName = scenarioName;
-		log.info("Session started:", `${scenarioName}/${sessionName}`);
-		return {
-			scenarioPath: scenarioName,
-			sessionPath: sessionName
-		};
-	}
-	const result = await createSession(/* @__PURE__ */ new Date());
-	_currentScenarioName = "";
-	result.sessionName;
-	log.info("Session started:", result.sessionName);
-	return {
-		scenarioPath: "",
-		sessionPath: result.sessionName
-	};
-}
-/**
-* List all session names.
-* When scenarioName is provided, lists sessions under that scenario.
-* Otherwise lists flat sessions.
-*/
-async function listSessions(scenarioName) {
-	if (scenarioName) {
-		const dir = await ensureScenariosDir();
-		if (!dir) return [];
-		try {
-			const scenarioHandle = await dir.getDirectoryHandle(scenarioName);
-			const sessions = [];
-			for await (const entry of scenarioHandle.values()) if (entry.kind === "directory") sessions.push(entry.name);
-			return sessions;
-		} catch {
-			return [];
-		}
-	}
-	return listSessions$1();
-}
-/**
-* Write a Redux action to OPFS as a JSON file.
-*/
-async function writeAction(action, index) {
-	await writeAction$1(action, index);
-}
-/**
-* Write a captured frame image to OPFS.
-*/
-async function writeFrame(blob, index) {
-	await writeFrame$1(blob, index);
-}
-/**
-* Write session metadata (session.json) to OPFS.
-*/
-async function writeSessionMetadata(metadata) {
-	await writeSessionMetadata$1(metadata);
-}
-/**
-* Get the current scenario handle (for loading prior sessions).
-* Legacy: uses scenario directory layout.
-*/
-function getCurrentScenarioHandle() {
-	if (!_currentScenarioName) return null;
-	return currentScenarioHandle;
-}
-/**
-* Set the current scenario handle (when user selects a scenario).
-* Legacy: uses scenario directory layout.
-*/
-async function setCurrentScenario(scenarioName) {
-	const scenRoot = await ensureScenariosDir();
-	if (!scenRoot) return null;
-	try {
-		const handle = await scenRoot.getDirectoryHandle(scenarioName);
-		_currentScenarioName = scenarioName;
-		currentScenarioHandle = handle;
-		return handle;
-	} catch {
-		log.warn("Scenario not found:", scenarioName);
-		return null;
-	}
-}
-/**
-* Ensure a scenario directory exists in OPFS, creating it if necessary.
-* Legacy: used during OPFS recovery.
-*/
-async function ensureScenarioDirectory(scenarioName) {
-	const scenRoot = await ensureScenariosDir();
-	if (!scenRoot) return null;
-	try {
-		const handle = await scenRoot.getDirectoryHandle(scenarioName, { create: true });
-		_currentScenarioName = scenarioName;
-		currentScenarioHandle = handle;
-		return handle;
-	} catch (err) {
-		log.error("Failed to create scenario directory:", err);
-		return null;
-	}
-}
-/**
-* Clear the cached `refPoints/` directory for every scenario in OPFS.
-*
-* Used by the "Clear Reference Point Cache" maintenance action so that the
-* next scenario load re-imports ref points from the read folder's `*.zip`
-* recordings (see ref-point-recovery in the recorder app).
-*
-* Failures for individual scenarios are collected in `errors` rather than
-* aborting the whole operation — partial progress is still useful.
-*
-* @throws Error if OPFS storage is unavailable (e.g. `initStorage()` not yet
-*   called, or browser does not support OPFS). Surfacing this loudly avoids
-*   reporting a silent "0 scenarios cleared" success that would mask the
-*   real failure to the user.
-*/
-async function clearRefPointsCacheForAllScenarios() {
-	const dir = await ensureScenariosDir();
-	if (!dir) throw new Error("clearRefPointsCacheForAllScenarios: OPFS scenarios directory is unavailable — call initStorage() first or check OPFS support");
-	const errors = [];
-	let scenariosCleared = 0;
-	let scenariosScanned = 0;
-	const scenarios = await listScenarios();
-	for (const scenarioName of scenarios) {
-		scenariosScanned++;
-		try {
-			const handle = await dir.getDirectoryHandle(scenarioName);
-			if (!handle) continue;
-			try {
-				await handle.removeEntry("refPoints", { recursive: true });
-				scenariosCleared++;
-			} catch (err) {
-				if ((err instanceof Error ? err.name : String(err?.name)) === "NotFoundError") continue;
-				errors.push({
-					scenarioName,
-					reason: err instanceof Error ? err.message : String(err)
-				});
-			}
-		} catch (err) {
-			errors.push({
-				scenarioName,
-				reason: err instanceof Error ? err.message : String(err)
-			});
-		}
-	}
-	log.info(`Cleared ref-point cache for ${scenariosCleared}/${scenariosScanned} scenarios (${errors.length} errors)`);
-	return {
-		scenariosCleared,
-		scenariosScanned,
-		errors
-	};
-}
-//#endregion
-export { clearRefPointsCacheForAllScenarios, ensureScenarioDirectory, getCurrentScenarioHandle, initStorage, listSessions, resetForNewSession, resetStorageState, setCurrentScenario, startSession, verifyWriteAccess, writeAction, writeFrame, writeSessionMetadata };