gps-plus-slam-app-framework 1.0.0

package/dist/test-utils/browser-mocks.d.ts

@@ -0,0 +1,294 @@
+import { a as WebXRQuaternion, o as WebXRVec3 } from "../ar-types-B-ORgk6Z.js";
+import { Mock } from "vitest";
+
+//#region ../src/test-utils/browser-mocks.d.ts
+interface MockXRViewerPose {
+  views: MockXRView[];
+  transform?: {
+    matrix: Float32Array;
+    position: DOMPointReadOnly;
+    orientation: DOMPointReadOnly;
+    inverse: XRRigidTransform | null;
+  };
+  emulatedPosition?: boolean;
+}
+interface MockXRView {
+  transform: {
+    position: {
+      x: number;
+      y: number;
+      z: number;
+      w: number;
+    };
+    orientation: WebXRQuaternion;
+  };
+}
+interface MockXRFrame {
+  getViewerPose: Mock<(space: unknown) => MockXRViewerPose | null>;
+  getDepthInformation?: Mock<(view: unknown) => MockDepthInfo | null>;
+}
+interface MockDepthInfo {
+  width: number;
+  height: number;
+  getDepthInMeters: (x: number, y: number) => number;
+}
+interface MockXRSession {
+  addEventListener: Mock;
+  removeEventListener: Mock;
+  end: Mock<() => Promise<void>>;
+  requestReferenceSpace: Mock<(type: string) => Promise<unknown>>;
+}
+interface MockXR {
+  isSessionSupported: Mock<(mode: string) => Promise<boolean>>;
+  requestSession: Mock<(mode: string, options?: unknown) => Promise<MockXRSession>>;
+}
+/**
+ * Create a mock XRViewerPose with specified position and orientation.
+ */
+declare function createMockPose(position: WebXRVec3, orientation: WebXRQuaternion): MockXRViewerPose;
+/**
+ * Create a mock XRFrame that returns the specified pose.
+ */
+declare function createMockFrame(pose: MockXRViewerPose | null): MockXRFrame;
+/**
+ * Create a mock depth info object with configurable depth function.
+ */
+declare function createMockDepthInfo(depthFn?: (x: number, y: number) => number): MockDepthInfo;
+/**
+ * Create a mock XRSession.
+ */
+declare function createMockXRSession(): MockXRSession;
+/**
+ * Create a mock navigator.xr object.
+ */
+declare function createMockXR(supported?: boolean): MockXR;
+/**
+ * Install WebXR mocks on the global navigator object.
+ * Returns cleanup function.
+ */
+declare function installWebXRMocks(supported?: boolean): () => void;
+interface MockGeolocationPosition {
+  coords: {
+    latitude: number;
+    longitude: number;
+    altitude: number | null;
+    accuracy: number;
+    altitudeAccuracy: number | null;
+    heading: number | null;
+    speed: number | null;
+    toJSON: () => GeolocationCoordinates;
+  };
+  timestamp: number;
+  toJSON: () => GeolocationPosition;
+}
+interface MockGeolocation {
+  watchPosition: Mock<(success: PositionCallback, error?: PositionErrorCallback | null, options?: PositionOptions) => number>;
+  clearWatch: Mock<(id: number) => void>;
+  getCurrentPosition: Mock<(success: PositionCallback, error?: PositionErrorCallback | null, options?: PositionOptions) => void>;
+}
+/**
+ * Create a mock geolocation position.
+ */
+declare function createMockGeoPosition(lat: number, lon: number, altitude?: number | null, accuracy?: number): MockGeolocationPosition;
+/**
+ * Create a mock geolocation object.
+ */
+declare function createMockGeolocation(): MockGeolocation;
+/**
+ * Install geolocation mocks on the global navigator object.
+ * Returns cleanup function.
+ */
+declare function installGeolocationMocks(): () => void;
+interface MockDeviceOrientationEvent {
+  alpha: number | null;
+  beta: number | null;
+  gamma: number | null;
+  absolute: boolean;
+}
+/**
+ * Create a mock DeviceOrientationEvent.
+ */
+declare function createMockOrientationEvent(alpha: number, beta: number, gamma: number, absolute?: boolean): MockDeviceOrientationEvent;
+/**
+ * Create a mock DeviceOrientationEvent class with requestPermission support.
+ */
+declare function createMockDeviceOrientationEventClass(permissionGranted?: boolean): typeof DeviceOrientationEvent & {
+  requestPermission?: () => Promise<'granted' | 'denied'>;
+};
+interface MockFileSystemFileHandle {
+  kind: 'file';
+  name: string;
+  getFile: Mock<() => Promise<File>>;
+  createWritable: Mock<() => Promise<MockFileSystemWritableFileStream>>;
+}
+interface MockFileSystemWritableFileStream {
+  write: Mock<(data: unknown) => Promise<void>>;
+  close: Mock<() => Promise<void>>;
+}
+interface MockFileSystemDirectoryHandle {
+  kind: 'directory';
+  name: string;
+  entries: Mock<() => AsyncIterable<[string, MockFileSystemFileHandle | MockFileSystemDirectoryHandle]>>;
+  getFileHandle: Mock<(name: string, options?: {
+    create?: boolean;
+  }) => Promise<MockFileSystemFileHandle>>;
+  getDirectoryHandle: Mock<(name: string, options?: {
+    create?: boolean;
+  }) => Promise<MockFileSystemDirectoryHandle>>;
+  removeEntry: Mock<(name: string, options?: {
+    recursive?: boolean;
+  }) => Promise<void>>;
+}
+/**
+ * Create a mock file handle.
+ */
+declare function createMockFileHandle(name: string, content?: string): MockFileSystemFileHandle;
+/**
+ * Create a mock directory handle with specified files.
+ */
+declare function createMockDirectoryHandle(name: string, files?: Map<string, string>, subdirs?: Map<string, MockFileSystemDirectoryHandle>): MockFileSystemDirectoryHandle;
+/**
+ * Class-based mock FileSystemFileHandle for tests requiring mutable state.
+ * Use this when you need to modify file contents during tests.
+ */
+declare class MockFSFileHandle implements FileSystemFileHandle {
+  kind: "file";
+  name: string;
+  private content;
+  constructor(name: string, content?: string | Uint8Array);
+  getFile(): Promise<File>;
+  createWritable(): Promise<FileSystemWritableFileStream>;
+  createSyncAccessHandle(): Promise<unknown>;
+  isSameEntry(): Promise<boolean>;
+}
+/**
+ * Class-based mock FileSystemDirectoryHandle for tests requiring addFile/addDirectory.
+ * Implements the full FileSystemDirectoryHandle interface.
+ */
+declare class MockFSDirectoryHandle implements FileSystemDirectoryHandle {
+  kind: "directory";
+  name: string;
+  private contents;
+  constructor(name: string);
+  /**
+   * Add a file to this directory.
+   * Accepts string content (for JSON etc) or Uint8Array (for zip bytes).
+   */
+  addFile(name: string, content: string | Uint8Array): void;
+  /**
+   * Add a subdirectory to this directory.
+   */
+  addDirectory(name: string, handle: FileSystemDirectoryHandle): void;
+  entries(): AsyncGenerator<[string, FileSystemDirectoryHandle | FileSystemFileHandle], undefined, unknown>;
+  [Symbol.asyncIterator](): AsyncGenerator<[string, FileSystemDirectoryHandle | FileSystemFileHandle], undefined, unknown>;
+  getDirectoryHandle(name: string, options?: {
+    create?: boolean;
+  }): Promise<FileSystemDirectoryHandle>;
+  getFileHandle(name: string, options?: {
+    create?: boolean;
+  }): Promise<FileSystemFileHandle>;
+  removeEntry(name: string): Promise<void>;
+  resolve(): Promise<string[] | null>;
+  isSameEntry(): Promise<boolean>;
+  values(): AsyncGenerator<FileSystemDirectoryHandle | FileSystemFileHandle, undefined, unknown>;
+  keys(): AsyncGenerator<string, undefined, unknown>;
+  queryPermission(_descriptor?: {
+    mode?: 'read' | 'readwrite';
+  }): Promise<PermissionState>;
+}
+/**
+ * Install File System Access API mocks on the global window object.
+ * Returns cleanup function.
+ */
+declare function installFileSystemMocks(rootDir?: MockFileSystemDirectoryHandle): () => void;
+/**
+ * Install all browser mocks at once.
+ * Returns cleanup function.
+ */
+declare function installAllBrowserMocks(options?: {
+  webxrSupported?: boolean;
+  geolocation?: boolean;
+  fileSystem?: boolean;
+  rootDir?: MockFileSystemDirectoryHandle;
+}): () => void;
+/**
+ * In-memory file system for OPFS mocking.
+ * Stores file contents as ArrayBuffer for binary compatibility.
+ */
+declare class MockOPFSDirectoryHandle implements FileSystemDirectoryHandle {
+  kind: "directory";
+  name: string;
+  private contents;
+  private fileContents;
+  constructor(name: string);
+  /**
+   * Get stored file content (for test assertions).
+   */
+  getStoredContent(fileName: string): ArrayBuffer | undefined;
+  /**
+   * Get stored file content as string (for test assertions).
+   */
+  getStoredContentAsString(fileName: string): string | undefined;
+  /**
+   * Set file content directly (for test setup).
+   * Also ensures a corresponding file handle exists in contents map
+   * so that getFileHandle() and iterators work correctly.
+   */
+  setStoredContent(fileName: string, content: string | ArrayBuffer): void;
+  entries(): AsyncGenerator<[string, FileSystemDirectoryHandle | FileSystemFileHandle], undefined, unknown>;
+  [Symbol.asyncIterator](): AsyncGenerator<[string, FileSystemDirectoryHandle | FileSystemFileHandle], undefined, unknown>;
+  getDirectoryHandle(name: string, options?: {
+    create?: boolean;
+  }): Promise<FileSystemDirectoryHandle>;
+  getFileHandle(name: string, options?: {
+    create?: boolean;
+  }): Promise<FileSystemFileHandle>;
+  removeEntry(name: string): Promise<void>;
+  resolve(): Promise<string[] | null>;
+  isSameEntry(): Promise<boolean>;
+  values(): AsyncGenerator<FileSystemDirectoryHandle | FileSystemFileHandle, undefined, unknown>;
+  keys(): AsyncGenerator<string, undefined, unknown>;
+  queryPermission(_descriptor?: {
+    mode?: 'read' | 'readwrite';
+  }): Promise<PermissionState>;
+}
+/**
+ * Mock OPFS file handle with writable stream support.
+ */
+declare class MockOPFSFileHandle implements FileSystemFileHandle {
+  kind: "file";
+  name: string;
+  private parentDir;
+  private storageKey;
+  constructor(name: string, parentDir: MockOPFSDirectoryHandle, storageKey: string);
+  getFile(): Promise<File>;
+  createWritable(): Promise<FileSystemWritableFileStream>;
+  createSyncAccessHandle(): Promise<unknown>;
+  isSameEntry(): Promise<boolean>;
+}
+/**
+ * Mock navigator.storage for OPFS support.
+ */
+interface MockStorageManager {
+  getDirectory: () => Promise<FileSystemDirectoryHandle>;
+  estimate: () => Promise<{
+    quota: number;
+    usage: number;
+  }>;
+  persist: () => Promise<boolean>;
+  persisted: () => Promise<boolean>;
+}
+/**
+ * Create a mock StorageManager with OPFS support.
+ */
+declare function createMockStorageManager(opfsRoot?: MockOPFSDirectoryHandle): MockStorageManager;
+/**
+ * Install OPFS mocks on the global navigator object.
+ * Returns the mock OPFS root directory for test assertions and cleanup function.
+ */
+declare function installOPFSMocks(opfsRoot?: MockOPFSDirectoryHandle): {
+  root: MockOPFSDirectoryHandle;
+  cleanup: () => void;
+};
+//#endregion
+export { MockDepthInfo, MockDeviceOrientationEvent, MockFSDirectoryHandle, MockFSFileHandle, MockFileSystemDirectoryHandle, MockFileSystemFileHandle, MockFileSystemWritableFileStream, MockGeolocation, MockGeolocationPosition, MockOPFSDirectoryHandle, MockOPFSFileHandle, MockStorageManager, MockXR, MockXRFrame, MockXRSession, MockXRView, MockXRViewerPose, createMockDepthInfo, createMockDeviceOrientationEventClass, createMockDirectoryHandle, createMockFileHandle, createMockFrame, createMockGeoPosition, createMockGeolocation, createMockOrientationEvent, createMockPose, createMockStorageManager, createMockXR, createMockXRSession, installAllBrowserMocks, installFileSystemMocks, installGeolocationMocks, installOPFSMocks, installWebXRMocks };