@fgv/ts-web-extras 5.0.2 → 5.1.0-1

package/lib/packlets/{crypto → crypto-utils}/index.d.ts

@@ -3,4 +3,5 @@
  * @packageDocumentation
  */
 export * from './browserHashProvider';
+export * from './browserCryptoProvider';
 //# sourceMappingURL=index.d.ts.map

package/lib/packlets/crypto-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/crypto-utils/index.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/lib/packlets/{crypto → crypto-utils}/index.js

@@ -40,4 +40,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @packageDocumentation
  */
 __exportStar(require("./browserHashProvider"), exports);
+__exportStar(require("./browserCryptoProvider"), exports);
 //# sourceMappingURL=index.js.map

package/lib/packlets/crypto-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/crypto-utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH;;;GAGG;AAEH,wDAAsC;AACtC,0DAAwC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Browser-compatible cryptographic utilities using the Web Crypto API.\n * @packageDocumentation\n */\n\nexport * from './browserHashProvider';\nexport * from './browserCryptoProvider';\n"]}

package/lib/packlets/file-api-types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-api-types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-api-types/index.ts"],"names":[],"mappings":"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"}

package/lib/packlets/file-api-types/index.js

@@ -65,7 +65,15 @@ function isDirectoryHandle(handle) {
  */
 async function safeShowOpenFilePicker(window, options) {
     if (supportsFileSystemAccess(window)) {
-        return window.showOpenFilePicker(options);
+        try {
+            return await window.showOpenFilePicker(options);
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                return null;
+            }
+            throw error;
+        }
     }
     return null;
 }
@@ -78,7 +86,15 @@ async function safeShowOpenFilePicker(window, options) {
  */
 async function safeShowSaveFilePicker(window, options) {
     if (supportsFileSystemAccess(window)) {
-        return window.showSaveFilePicker(options);
+        try {
+            return await window.showSaveFilePicker(options);
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                return null;
+            }
+            throw error;
+        }
     }
     return null;
 }
@@ -91,7 +107,15 @@ async function safeShowSaveFilePicker(window, options) {
  */
 async function safeShowDirectoryPicker(window, options) {
     if (supportsFileSystemAccess(window)) {
-        return window.showDirectoryPicker(options);
+        try {
+            return await window.showDirectoryPicker(options);
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                return null;
+            }
+            throw error;
+        }
     }
     return null;
 }

package/lib/packlets/file-api-types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/file-api-types/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * File System Access API type definitions and utilities for browser compatibility.\n * @packageDocumentation\n */\n\n// Local type definitions for File System Access API\n// Based on https://wicg.github.io/file-system-access/\n\n/**\n * File System Access API methods available on Window\n * @public\n */\nexport interface IFsAccessApis {\n  showDirectoryPicker(options?: ShowDirectoryPickerOptions): Promise<FileSystemDirectoryHandle>;\n  showOpenFilePicker(options?: ShowOpenFilePickerOptions): Promise<FileSystemFileHandle[]>;\n  showSaveFilePicker(options?: ShowSaveFilePickerOptions): Promise<FileSystemFileHandle>;\n}\n\n/**\n * Window interface extended with File System Access API\n * @public\n */\nexport type WindowWithFsAccess = Window & IFsAccessApis;\n\n/**\n * Base interface for file system handles\n * @public\n */\nexport interface FileSystemHandle {\n  readonly kind: 'file' | 'directory';\n  readonly name: string;\n  isSameEntry(other: FileSystemHandle): Promise<boolean>;\n  queryPermission(descriptor?: FileSystemHandlePermissionDescriptor): Promise<PermissionState>;\n  requestPermission(descriptor?: FileSystemHandlePermissionDescriptor): Promise<PermissionState>;\n}\n\n/**\n * File handle interface\n * @public\n */\nexport interface FileSystemFileHandle extends FileSystemHandle {\n  readonly kind: 'file';\n  getFile(): Promise<File>;\n  createWritable(options?: FileSystemCreateWritableOptions): Promise<FileSystemWritableFileStream>;\n}\n\n/**\n * Directory handle interface\n * @public\n */\nexport interface FileSystemDirectoryHandle extends FileSystemHandle {\n  readonly kind: 'directory';\n  getDirectoryHandle(\n    name: string,\n    options?: FileSystemGetDirectoryOptions\n  ): Promise<FileSystemDirectoryHandle>;\n  getFileHandle(name: string, options?: FileSystemGetFileOptions): Promise<FileSystemFileHandle>;\n  removeEntry(name: string, options?: FileSystemRemoveOptions): Promise<void>;\n  resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;\n  keys(): AsyncIterableIterator<string>;\n  values(): AsyncIterableIterator<FileSystemHandle>;\n  entries(): AsyncIterableIterator<[string, FileSystemHandle]>;\n  [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;\n}\n\n/**\n * Permission descriptor for file system handles\n * @public\n */\nexport interface FileSystemHandlePermissionDescriptor {\n  mode?: 'read' | 'readwrite';\n}\n\n/**\n * Options for creating writable file streams\n * @public\n */\nexport interface FileSystemCreateWritableOptions {\n  keepExistingData?: boolean;\n}\n\n/**\n * Options for getting directory handles\n * @public\n */\nexport interface FileSystemGetDirectoryOptions {\n  create?: boolean;\n}\n\n/**\n * Options for getting file handles\n * @public\n */\nexport interface FileSystemGetFileOptions {\n  create?: boolean;\n}\n\n/**\n * Options for removing entries\n * @public\n */\nexport interface FileSystemRemoveOptions {\n  recursive?: boolean;\n}\n\n/**\n * Writable file stream interface\n * @public\n */\nexport interface FileSystemWritableFileStream extends WritableStream {\n  write(data: BufferSource | Blob | string): Promise<void>;\n  seek(position: number): Promise<void>;\n  truncate(size: number): Promise<void>;\n}\n\n/**\n * Directory picker options\n * @public\n */\nexport interface ShowDirectoryPickerOptions {\n  id?: string;\n  mode?: 'read' | 'readwrite';\n  startIn?: FileSystemHandle | WellKnownDirectory;\n}\n\n/**\n * File picker options\n * @public\n */\nexport interface ShowOpenFilePickerOptions {\n  multiple?: boolean;\n  excludeAcceptAllOption?: boolean;\n  id?: string;\n  startIn?: FileSystemHandle | WellKnownDirectory;\n  types?: FilePickerAcceptType[];\n}\n\n/**\n * Save file picker options\n * @public\n */\nexport interface ShowSaveFilePickerOptions {\n  excludeAcceptAllOption?: boolean;\n  id?: string;\n  startIn?: FileSystemHandle | WellKnownDirectory;\n  suggestedName?: string;\n  types?: FilePickerAcceptType[];\n}\n\n/**\n * File picker accept type\n * @public\n */\nexport interface FilePickerAcceptType {\n  description?: string;\n  accept: Record<string, string | string[]>;\n}\n\n/**\n * Well-known directory type\n * @public\n */\nexport type WellKnownDirectory = 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos';\n\n/**\n * Type guard to check if the browser supports the File System Access API\n * @param window - The window object to check\n * @returns True if the window supports File System Access API\n * @public\n */\nexport function supportsFileSystemAccess(window: Window): window is WindowWithFsAccess {\n  return 'showOpenFilePicker' in window && 'showSaveFilePicker' in window && 'showDirectoryPicker' in window;\n}\n\n/**\n * Type guard to check if a FileSystemHandle is a file handle\n * @param handle - The handle to check\n * @returns True if the handle is a FileSystemFileHandle\n * @public\n */\nexport function isFileHandle(handle: FileSystemHandle): handle is FileSystemFileHandle {\n  return handle.kind === 'file';\n}\n\n/**\n * Type guard to check if a FileSystemHandle is a directory handle\n * @param handle - The handle to check\n * @returns True if the handle is a FileSystemDirectoryHandle\n * @public\n */\nexport function isDirectoryHandle(handle: FileSystemHandle): handle is FileSystemDirectoryHandle {\n  return handle.kind === 'directory';\n}\n\n/**\n * Safely access showOpenFilePicker with proper type checking\n * @param window - The window object\n * @param options - Options for the file picker\n * @returns Promise with file handles or null if not supported\n * @public\n */\nexport async function safeShowOpenFilePicker(\n  window: Window,\n  options?: ShowOpenFilePickerOptions\n): Promise<FileSystemFileHandle[] | null> {\n  if (supportsFileSystemAccess(window)) {\n    return window.showOpenFilePicker(options);\n  }\n  return null;\n}\n\n/**\n * Safely access showSaveFilePicker with proper type checking\n * @param window - The window object\n * @param options - Options for the file picker\n * @returns Promise with file handle or null if not supported\n * @public\n */\nexport async function safeShowSaveFilePicker(\n  window: Window,\n  options?: ShowSaveFilePickerOptions\n): Promise<FileSystemFileHandle | null> {\n  if (supportsFileSystemAccess(window)) {\n    return window.showSaveFilePicker(options);\n  }\n  return null;\n}\n\n/**\n * Safely access showDirectoryPicker with proper type checking\n * @param window - The window object\n * @param options - Options for the directory picker\n * @returns Promise with directory handle or null if not supported\n * @public\n */\nexport async function safeShowDirectoryPicker(\n  window: Window,\n  options?: ShowDirectoryPickerOptions\n): Promise<FileSystemDirectoryHandle | null> {\n  if (supportsFileSystemAccess(window)) {\n    return window.showDirectoryPicker(options);\n  }\n  return null;\n}\n\n/**\n * Export data as JSON file using legacy blob download method.\n * Creates a temporary download link and triggers file download.\n * @param data - Data to export as JSON\n * @param filename - Name for the downloaded file\n * @public\n */\nexport function exportAsJson(data: unknown, filename: string): void {\n  const json = JSON.stringify(data, null, 2);\n  const blob = new Blob([json], { type: 'application/json' });\n  const url = URL.createObjectURL(blob);\n\n  const a = document.createElement('a');\n  a.href = url;\n  a.download = filename;\n  document.body.appendChild(a);\n  a.click();\n  document.body.removeChild(a);\n  URL.revokeObjectURL(url);\n}\n\n/**\n * Export data using File System Access API with fallback to blob download.\n * @param data - Data to export as JSON\n * @param suggestedName - Suggested filename for the save dialog\n * @param description - Description for file type filter (default: 'JSON files')\n * @param window - Window object for API access (default: globalThis.window)\n * @returns Promise resolving to true if saved via File System Access API, false if fallback used\n * @public\n */\nexport async function exportUsingFileSystemAPI(\n  data: unknown,\n  suggestedName: string,\n  description: string = 'JSON files',\n  window: Window = globalThis.window\n): Promise<boolean> {\n  if (!supportsFileSystemAccess(window)) {\n    // Fallback to blob download\n    exportAsJson(data, suggestedName);\n    return false;\n  }\n\n  try {\n    const fileHandle = await safeShowSaveFilePicker(window, {\n      suggestedName,\n      types: [\n        {\n          description,\n          accept: {\n            'application/json': ['.json']\n          }\n        }\n      ]\n    });\n\n    if (!fileHandle) {\n      // User cancelled - fallback to blob download\n      exportAsJson(data, suggestedName);\n      return false;\n    }\n\n    const json = JSON.stringify(data, null, 2);\n    const writable = await fileHandle.createWritable();\n    await writable.write(json);\n    await writable.close();\n\n    return true;\n  } catch (error) {\n    // Handle errors by falling back to blob download\n    if ((error as Error).name === 'AbortError') {\n      // User cancelled - fallback\n      exportAsJson(data, suggestedName);\n      return false;\n    }\n    // Other errors - re-throw as they indicate a real problem\n    throw error;\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/file-api-types/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * File System Access API type definitions and utilities for browser compatibility.\n * @packageDocumentation\n */\n\n// Local type definitions for File System Access API\n// Based on https://wicg.github.io/file-system-access/\n\n/**\n * File System Access API methods available on Window\n * @public\n */\nexport interface IFsAccessApis {\n  showDirectoryPicker(options?: ShowDirectoryPickerOptions): Promise<FileSystemDirectoryHandle>;\n  showOpenFilePicker(options?: ShowOpenFilePickerOptions): Promise<FileSystemFileHandle[]>;\n  showSaveFilePicker(options?: ShowSaveFilePickerOptions): Promise<FileSystemFileHandle>;\n}\n\n/**\n * Window interface extended with File System Access API\n * @public\n */\nexport type WindowWithFsAccess = Window & IFsAccessApis;\n\n/**\n * Base interface for file system handles\n * @public\n */\nexport interface FileSystemHandle {\n  readonly kind: 'file' | 'directory';\n  readonly name: string;\n  isSameEntry(other: FileSystemHandle): Promise<boolean>;\n  queryPermission(descriptor?: FileSystemHandlePermissionDescriptor): Promise<PermissionState>;\n  requestPermission(descriptor?: FileSystemHandlePermissionDescriptor): Promise<PermissionState>;\n}\n\n/**\n * File handle interface\n * @public\n */\nexport interface FileSystemFileHandle extends FileSystemHandle {\n  readonly kind: 'file';\n  getFile(): Promise<File>;\n  createWritable(options?: FileSystemCreateWritableOptions): Promise<FileSystemWritableFileStream>;\n}\n\n/**\n * Directory handle interface\n * @public\n */\nexport interface FileSystemDirectoryHandle extends FileSystemHandle {\n  readonly kind: 'directory';\n  getDirectoryHandle(\n    name: string,\n    options?: FileSystemGetDirectoryOptions\n  ): Promise<FileSystemDirectoryHandle>;\n  getFileHandle(name: string, options?: FileSystemGetFileOptions): Promise<FileSystemFileHandle>;\n  removeEntry(name: string, options?: FileSystemRemoveOptions): Promise<void>;\n  resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;\n  keys(): AsyncIterableIterator<string>;\n  values(): AsyncIterableIterator<FileSystemHandle>;\n  entries(): AsyncIterableIterator<[string, FileSystemHandle]>;\n  [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;\n}\n\n/**\n * Permission descriptor for file system handles\n * @public\n */\nexport interface FileSystemHandlePermissionDescriptor {\n  mode?: 'read' | 'readwrite';\n}\n\n/**\n * Options for creating writable file streams\n * @public\n */\nexport interface FileSystemCreateWritableOptions {\n  keepExistingData?: boolean;\n}\n\n/**\n * Options for getting directory handles\n * @public\n */\nexport interface FileSystemGetDirectoryOptions {\n  create?: boolean;\n}\n\n/**\n * Options for getting file handles\n * @public\n */\nexport interface FileSystemGetFileOptions {\n  create?: boolean;\n}\n\n/**\n * Options for removing entries\n * @public\n */\nexport interface FileSystemRemoveOptions {\n  recursive?: boolean;\n}\n\n/**\n * Writable file stream interface\n * @public\n */\nexport interface FileSystemWritableFileStream extends WritableStream {\n  write(data: BufferSource | Blob | string): Promise<void>;\n  seek(position: number): Promise<void>;\n  truncate(size: number): Promise<void>;\n}\n\n/**\n * Directory picker options\n * @public\n */\nexport interface ShowDirectoryPickerOptions {\n  id?: string;\n  mode?: 'read' | 'readwrite';\n  startIn?: FileSystemHandle | WellKnownDirectory;\n}\n\n/**\n * File picker options\n * @public\n */\nexport interface ShowOpenFilePickerOptions {\n  multiple?: boolean;\n  excludeAcceptAllOption?: boolean;\n  id?: string;\n  startIn?: FileSystemHandle | WellKnownDirectory;\n  types?: FilePickerAcceptType[];\n}\n\n/**\n * Save file picker options\n * @public\n */\nexport interface ShowSaveFilePickerOptions {\n  excludeAcceptAllOption?: boolean;\n  id?: string;\n  startIn?: FileSystemHandle | WellKnownDirectory;\n  suggestedName?: string;\n  types?: FilePickerAcceptType[];\n}\n\n/**\n * File picker accept type\n * @public\n */\nexport interface FilePickerAcceptType {\n  description?: string;\n  accept: Record<string, string | string[]>;\n}\n\n/**\n * Well-known directory type\n * @public\n */\nexport type WellKnownDirectory = 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos';\n\n/**\n * Type guard to check if the browser supports the File System Access API\n * @param window - The window object to check\n * @returns True if the window supports File System Access API\n * @public\n */\nexport function supportsFileSystemAccess(window: Window): window is WindowWithFsAccess {\n  return 'showOpenFilePicker' in window && 'showSaveFilePicker' in window && 'showDirectoryPicker' in window;\n}\n\n/**\n * Type guard to check if a FileSystemHandle is a file handle\n * @param handle - The handle to check\n * @returns True if the handle is a FileSystemFileHandle\n * @public\n */\nexport function isFileHandle(handle: FileSystemHandle): handle is FileSystemFileHandle {\n  return handle.kind === 'file';\n}\n\n/**\n * Type guard to check if a FileSystemHandle is a directory handle\n * @param handle - The handle to check\n * @returns True if the handle is a FileSystemDirectoryHandle\n * @public\n */\nexport function isDirectoryHandle(handle: FileSystemHandle): handle is FileSystemDirectoryHandle {\n  return handle.kind === 'directory';\n}\n\n/**\n * Safely access showOpenFilePicker with proper type checking\n * @param window - The window object\n * @param options - Options for the file picker\n * @returns Promise with file handles or null if not supported\n * @public\n */\nexport async function safeShowOpenFilePicker(\n  window: Window,\n  options?: ShowOpenFilePickerOptions\n): Promise<FileSystemFileHandle[] | null> {\n  if (supportsFileSystemAccess(window)) {\n    try {\n      return await window.showOpenFilePicker(options);\n    } catch (error) {\n      if (error instanceof DOMException && error.name === 'AbortError') {\n        return null;\n      }\n      throw error;\n    }\n  }\n  return null;\n}\n\n/**\n * Safely access showSaveFilePicker with proper type checking\n * @param window - The window object\n * @param options - Options for the file picker\n * @returns Promise with file handle or null if not supported\n * @public\n */\nexport async function safeShowSaveFilePicker(\n  window: Window,\n  options?: ShowSaveFilePickerOptions\n): Promise<FileSystemFileHandle | null> {\n  if (supportsFileSystemAccess(window)) {\n    try {\n      return await window.showSaveFilePicker(options);\n    } catch (error) {\n      if (error instanceof DOMException && error.name === 'AbortError') {\n        return null;\n      }\n      throw error;\n    }\n  }\n  return null;\n}\n\n/**\n * Safely access showDirectoryPicker with proper type checking\n * @param window - The window object\n * @param options - Options for the directory picker\n * @returns Promise with directory handle or null if not supported\n * @public\n */\nexport async function safeShowDirectoryPicker(\n  window: Window,\n  options?: ShowDirectoryPickerOptions\n): Promise<FileSystemDirectoryHandle | null> {\n  if (supportsFileSystemAccess(window)) {\n    try {\n      return await window.showDirectoryPicker(options);\n    } catch (error) {\n      if (error instanceof DOMException && error.name === 'AbortError') {\n        return null;\n      }\n      throw error;\n    }\n  }\n  return null;\n}\n\n/**\n * Export data as JSON file using legacy blob download method.\n * Creates a temporary download link and triggers file download.\n * @param data - Data to export as JSON\n * @param filename - Name for the downloaded file\n * @public\n */\nexport function exportAsJson(data: unknown, filename: string): void {\n  const json = JSON.stringify(data, null, 2);\n  const blob = new Blob([json], { type: 'application/json' });\n  const url = URL.createObjectURL(blob);\n\n  const a = document.createElement('a');\n  a.href = url;\n  a.download = filename;\n  document.body.appendChild(a);\n  a.click();\n  document.body.removeChild(a);\n  URL.revokeObjectURL(url);\n}\n\n/**\n * Export data using File System Access API with fallback to blob download.\n * @param data - Data to export as JSON\n * @param suggestedName - Suggested filename for the save dialog\n * @param description - Description for file type filter (default: 'JSON files')\n * @param window - Window object for API access (default: globalThis.window)\n * @returns Promise resolving to true if saved via File System Access API, false if fallback used\n * @public\n */\nexport async function exportUsingFileSystemAPI(\n  data: unknown,\n  suggestedName: string,\n  description: string = 'JSON files',\n  window: Window = globalThis.window\n): Promise<boolean> {\n  if (!supportsFileSystemAccess(window)) {\n    // Fallback to blob download\n    exportAsJson(data, suggestedName);\n    return false;\n  }\n\n  try {\n    const fileHandle = await safeShowSaveFilePicker(window, {\n      suggestedName,\n      types: [\n        {\n          description,\n          accept: {\n            'application/json': ['.json']\n          }\n        }\n      ]\n    });\n\n    if (!fileHandle) {\n      // User cancelled - fallback to blob download\n      exportAsJson(data, suggestedName);\n      return false;\n    }\n\n    const json = JSON.stringify(data, null, 2);\n    const writable = await fileHandle.createWritable();\n    await writable.write(json);\n    await writable.close();\n\n    return true;\n  } catch (error) {\n    // Handle errors by falling back to blob download\n    if ((error as Error).name === 'AbortError') {\n      // User cancelled - fallback\n      exportAsJson(data, suggestedName);\n      return false;\n    }\n    // Other errors - re-throw as they indicate a real problem\n    throw error;\n  }\n}\n"]}

package/lib/packlets/file-tree/directoryHandleStore.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Persistent storage for FileSystemDirectoryHandle objects using IndexedDB.
+ * Allows directory handles to survive page reloads without re-prompting the user.
+ * @packageDocumentation
+ */
+import { Result } from '@fgv/ts-utils';
+import { FileSystemDirectoryHandle } from '../file-api-types';
+/**
+ * Default IndexedDB database name for directory handles.
+ * @public
+ */
+export declare const DEFAULT_DIRECTORY_HANDLE_DB = "chocolate-lab-storage";
+/**
+ * Default IndexedDB store name for directory handles.
+ * @public
+ */
+export declare const DEFAULT_DIRECTORY_HANDLE_STORE = "directory-handles";
+/**
+ * Manages persistence of {@link FileSystemDirectoryHandle} objects in IndexedDB.
+ * Keyed by a label (typically the directory name).
+ * @public
+ */
+export declare class DirectoryHandleStore {
+    private readonly _store;
+    constructor(dbName?: string, storeName?: string);
+    /**
+     * Saves a directory handle to IndexedDB under the given label.
+     * @param label - Key to store the handle under (typically dirHandle.name)
+     * @param handle - The FileSystemDirectoryHandle to persist
+     * @returns Success or Failure
+     */
+    save(label: string, handle: FileSystemDirectoryHandle): Promise<Result<void>>;
+    /**
+     * Retrieves a directory handle by label.
+     * @param label - Key to look up
+     * @returns Success with handle (or undefined if not found), or Failure on error
+     */
+    load(label: string): Promise<Result<FileSystemDirectoryHandle | undefined>>;
+    /**
+     * Removes a directory handle from IndexedDB.
+     * @param label - Key to remove
+     * @returns Success or Failure
+     */
+    remove(label: string): Promise<Result<void>>;
+    /**
+     * Returns all stored labels (keys).
+     * @returns Success with array of labels, or Failure
+     */
+    getAllLabels(): Promise<Result<string[]>>;
+    /**
+     * Returns all stored handles as label/handle pairs.
+     * @returns Success with array of entries, or Failure
+     */
+    getAll(): Promise<Result<Array<{
+        label: string;
+        handle: FileSystemDirectoryHandle;
+    }>>>;
+}
+//# sourceMappingURL=directoryHandleStore.d.ts.map

package/lib/packlets/file-tree/directoryHandleStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directoryHandleStore.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/directoryHandleStore.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AAEH,OAAO,EAAQ,MAAM,EAAW,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,2BAA2B,0BAA0B,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,8BAA8B,sBAAsB,CAAC;AAElE;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;gBAGtD,MAAM,GAAE,MAAoC,EAC5C,SAAS,GAAE,MAAuC;IAKpD;;;;;OAKG;IACU,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAS1F;;;;OAIG;IACU,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAAC;IASxF;;;;OAIG;IACU,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IASzD;;;OAGG;IACU,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAStD;;;OAGG;IACU,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,yBAAyB,CAAA;KAAE,CAAC,CAAC,CAAC;CAkBpG"}

package/lib/packlets/file-tree/directoryHandleStore.js

@@ -0,0 +1,128 @@
+"use strict";
+// Copyright (c) 2026 Erik Fortune
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectoryHandleStore = exports.DEFAULT_DIRECTORY_HANDLE_STORE = exports.DEFAULT_DIRECTORY_HANDLE_DB = void 0;
+/**
+ * Persistent storage for FileSystemDirectoryHandle objects using IndexedDB.
+ * Allows directory handles to survive page reloads without re-prompting the user.
+ * @packageDocumentation
+ */
+const ts_utils_1 = require("@fgv/ts-utils");
+const idb_keyval_1 = require("idb-keyval");
+/**
+ * Default IndexedDB database name for directory handles.
+ * @public
+ */
+exports.DEFAULT_DIRECTORY_HANDLE_DB = 'chocolate-lab-storage';
+/**
+ * Default IndexedDB store name for directory handles.
+ * @public
+ */
+exports.DEFAULT_DIRECTORY_HANDLE_STORE = 'directory-handles';
+/**
+ * Manages persistence of {@link FileSystemDirectoryHandle} objects in IndexedDB.
+ * Keyed by a label (typically the directory name).
+ * @public
+ */
+class DirectoryHandleStore {
+    constructor(dbName = exports.DEFAULT_DIRECTORY_HANDLE_DB, storeName = exports.DEFAULT_DIRECTORY_HANDLE_STORE) {
+        this._store = (0, idb_keyval_1.createStore)(dbName, storeName);
+    }
+    /**
+     * Saves a directory handle to IndexedDB under the given label.
+     * @param label - Key to store the handle under (typically dirHandle.name)
+     * @param handle - The FileSystemDirectoryHandle to persist
+     * @returns Success or Failure
+     */
+    async save(label, handle) {
+        try {
+            await (0, idb_keyval_1.set)(label, handle, this._store);
+            return (0, ts_utils_1.succeed)(undefined);
+        }
+        catch (e) {
+            return (0, ts_utils_1.fail)(`DirectoryHandleStore.save "${label}": ${String(e)}`);
+        }
+    }
+    /**
+     * Retrieves a directory handle by label.
+     * @param label - Key to look up
+     * @returns Success with handle (or undefined if not found), or Failure on error
+     */
+    async load(label) {
+        try {
+            const handle = await (0, idb_keyval_1.get)(label, this._store);
+            return (0, ts_utils_1.succeed)(handle);
+        }
+        catch (e) {
+            return (0, ts_utils_1.fail)(`DirectoryHandleStore.load "${label}": ${String(e)}`);
+        }
+    }
+    /**
+     * Removes a directory handle from IndexedDB.
+     * @param label - Key to remove
+     * @returns Success or Failure
+     */
+    async remove(label) {
+        try {
+            await (0, idb_keyval_1.del)(label, this._store);
+            return (0, ts_utils_1.succeed)(undefined);
+        }
+        catch (e) {
+            return (0, ts_utils_1.fail)(`DirectoryHandleStore.remove "${label}": ${String(e)}`);
+        }
+    }
+    /**
+     * Returns all stored labels (keys).
+     * @returns Success with array of labels, or Failure
+     */
+    async getAllLabels() {
+        try {
+            const allKeys = await (0, idb_keyval_1.keys)(this._store);
+            return (0, ts_utils_1.succeed)(allKeys);
+        }
+        catch (e) {
+            return (0, ts_utils_1.fail)(`DirectoryHandleStore.getAllLabels: ${String(e)}`);
+        }
+    }
+    /**
+     * Returns all stored handles as label/handle pairs.
+     * @returns Success with array of entries, or Failure
+     */
+    async getAll() {
+        const labelsResult = await this.getAllLabels();
+        if (labelsResult.isFailure()) {
+            return (0, ts_utils_1.fail)(labelsResult.message);
+        }
+        const entries = [];
+        for (const label of labelsResult.value) {
+            const handleResult = await this.load(label);
+            if (handleResult.isFailure()) {
+                return (0, ts_utils_1.fail)(handleResult.message);
+            }
+            if (handleResult.value !== undefined) {
+                entries.push({ label, handle: handleResult.value });
+            }
+        }
+        return (0, ts_utils_1.succeed)(entries);
+    }
+}
+exports.DirectoryHandleStore = DirectoryHandleStore;
+//# sourceMappingURL=directoryHandleStore.js.map

package/lib/packlets/file-tree/directoryHandleStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directoryHandleStore.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/directoryHandleStore.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * Persistent storage for FileSystemDirectoryHandle objects using IndexedDB.\n * Allows directory handles to survive page reloads without re-prompting the user.\n * @packageDocumentation\n */\n\nimport { fail, Result, succeed } from '@fgv/ts-utils';\nimport { createStore, del, get, keys, set } from 'idb-keyval';\nimport { FileSystemDirectoryHandle } from '../file-api-types';\n\n/**\n * Default IndexedDB database name for directory handles.\n * @public\n */\nexport const DEFAULT_DIRECTORY_HANDLE_DB = 'chocolate-lab-storage';\n\n/**\n * Default IndexedDB store name for directory handles.\n * @public\n */\nexport const DEFAULT_DIRECTORY_HANDLE_STORE = 'directory-handles';\n\n/**\n * Manages persistence of {@link FileSystemDirectoryHandle} objects in IndexedDB.\n * Keyed by a label (typically the directory name).\n * @public\n */\nexport class DirectoryHandleStore {\n  private readonly _store: ReturnType<typeof createStore>;\n\n  public constructor(\n    dbName: string = DEFAULT_DIRECTORY_HANDLE_DB,\n    storeName: string = DEFAULT_DIRECTORY_HANDLE_STORE\n  ) {\n    this._store = createStore(dbName, storeName);\n  }\n\n  /**\n   * Saves a directory handle to IndexedDB under the given label.\n   * @param label - Key to store the handle under (typically dirHandle.name)\n   * @param handle - The FileSystemDirectoryHandle to persist\n   * @returns Success or Failure\n   */\n  public async save(label: string, handle: FileSystemDirectoryHandle): Promise<Result<void>> {\n    try {\n      await set(label, handle, this._store);\n      return succeed(undefined);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.save \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Retrieves a directory handle by label.\n   * @param label - Key to look up\n   * @returns Success with handle (or undefined if not found), or Failure on error\n   */\n  public async load(label: string): Promise<Result<FileSystemDirectoryHandle | undefined>> {\n    try {\n      const handle = await get<FileSystemDirectoryHandle>(label, this._store);\n      return succeed(handle);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.load \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Removes a directory handle from IndexedDB.\n   * @param label - Key to remove\n   * @returns Success or Failure\n   */\n  public async remove(label: string): Promise<Result<void>> {\n    try {\n      await del(label, this._store);\n      return succeed(undefined);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.remove \"${label}\": ${String(e)}`);\n    }\n  }\n\n  /**\n   * Returns all stored labels (keys).\n   * @returns Success with array of labels, or Failure\n   */\n  public async getAllLabels(): Promise<Result<string[]>> {\n    try {\n      const allKeys = await keys<string>(this._store);\n      return succeed(allKeys);\n    } catch (e) {\n      return fail(`DirectoryHandleStore.getAllLabels: ${String(e)}`);\n    }\n  }\n\n  /**\n   * Returns all stored handles as label/handle pairs.\n   * @returns Success with array of entries, or Failure\n   */\n  public async getAll(): Promise<Result<Array<{ label: string; handle: FileSystemDirectoryHandle }>>> {\n    const labelsResult = await this.getAllLabels();\n    if (labelsResult.isFailure()) {\n      return fail(labelsResult.message);\n    }\n\n    const entries: Array<{ label: string; handle: FileSystemDirectoryHandle }> = [];\n    for (const label of labelsResult.value) {\n      const handleResult = await this.load(label);\n      if (handleResult.isFailure()) {\n        return fail(handleResult.message);\n      }\n      if (handleResult.value !== undefined) {\n        entries.push({ label, handle: handleResult.value });\n      }\n    }\n    return succeed(entries);\n  }\n}\n"]}

package/lib/packlets/file-tree/fileApiTreeAccessors.d.ts

@@ -1,6 +1,9 @@
 import { Result } from '@fgv/ts-utils';
 import { FileTree } from '@fgv/ts-json-base';
 import { FileSystemFileHandle, FileSystemDirectoryHandle } from '../file-api-types';
+import { IFileSystemAccessTreeParams } from './fileSystemAccessTreeAccessors';
+import { IHttpTreeParams } from './httpTreeAccessors';
+import { ILocalStorageTreeParams } from './localStorageTreeAccessors';
 /**
  * Tree initializer for FileList objects (from File API).
  * @public
@@ -47,6 +50,69 @@ export interface IFileMetadata {
  * @public
  */
 export declare class FileApiTreeAccessors<TCT extends string = string> {
+    /**
+     * Create a persistent FileTree from a File System Access API directory handle.
+     * Changes to files can be synced back to disk.
+     *
+     * @param dirHandle - FileSystemDirectoryHandle to load files from
+     * @param params - Optional parameters including autoSync and permission settings
+     * @returns Promise resolving to a FileTree with persistence capability
+     *
+     * @remarks
+     * - Only works in browsers supporting File System Access API (Chrome, Edge, Opera)
+     * - Requires 'readwrite' permission on the directory handle
+     * - Falls back to read-only mode if permissions unavailable (unless requireWritePermission is true)
+     *
+     * @public
+     */
+    static createPersistent<TCT extends string = string>(dirHandle: FileSystemDirectoryHandle, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    /**
+     * Create a persistent FileTree from an HTTP storage service.
+     *
+     * @param params - Configuration including API base URL, namespace, and optional autoSync
+     * @returns Promise resolving to a FileTree with persistence capability
+     * @public
+     */
+    static createFromHttp<TCT extends string = string>(params: IHttpTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    /**
+     * Create a persistent FileTree from a single File System Access API file handle.
+     * The tree contains exactly one file at `/<filename>`.
+     * Changes can be synced back to the original file via `syncToDisk()`.
+     *
+     * @param fileHandle - FileSystemFileHandle to load
+     * @param params - Optional parameters including autoSync and permission settings
+     * @returns Promise resolving to a FileTree with persistence capability
+     * @public
+     */
+    static createPersistentFromFile<TCT extends string = string>(fileHandle: FileSystemFileHandle, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    /**
+     * Create a persistent FileTree from browser localStorage.
+     * Changes to files can be synced back to localStorage.
+     *
+     * @param params - Configuration including path-to-key mappings and optional autoSync
+     * @returns Result containing a FileTree with persistence capability
+     *
+     * @remarks
+     * - Works in all browsers with localStorage support
+     * - Maps directory paths to localStorage keys
+     * - Each key stores multiple collections as JSON
+     * - Files are automatically discovered from storage
+     *
+     * @example
+     * ```typescript
+     * const tree = FileApiTreeAccessors.createFromLocalStorage({
+     *   pathToKeyMap: {
+     *     '/data/ingredients': 'myapp:ingredients:v1',
+     *     '/data/fillings': 'myapp:fillings:v1'
+     *   },
+     *   mutable: true,
+     *   autoSync: false
+     * });
+     * ```
+     *
+     * @public
+     */
+    static createFromLocalStorage<TCT extends string = string>(params: ILocalStorageTreeParams<TCT>): Result<FileTree.FileTree<TCT>>;
     /**
      * Create FileTree from various file sources using TreeInitializer array.
      * @param initializers - Array of TreeInitializer objects specifying file sources

package/lib/packlets/file-tree/fileApiTreeAccessors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fileApiTreeAccessors.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileApiTreeAccessors.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAGL,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAmB3B;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,EAAE,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,wBAAwB,GACxB,0BAA0B,GAC1B,+BAA+B,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,oBAAoB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IAC3D;;;;;OAKG;WACiB,MAAM,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EACpD,YAAY,EAAE,eAAe,EAAE,EAC/B,MAAM,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAoB1C;;;;;OAKG;WACiB,YAAY,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EAC1D,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAyB1C;;;;;OAKG;WACiB,mBAAmB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EACjE,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IA0B1C;;;;;;;OAOG;WACW,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;IAUnF;;;;OAIG;WACW,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa;IAU5D;;;;;;OAMG;mBACkB,mBAAmB;IAoBxC;;;;;;OAMG;mBACkB,gBAAgB;IA8BrC;;;OAGG;mBACkB,mBAAmB;IA8BxC;;;;;;;;OAQG;mBACkB,wBAAwB;IAqB7C;;;;;;;;OAQG;mBACkB,uBAAuB;IAuC5C,OAAO,CAAC,MAAM,CAAC,cAAc;CAS9B"}
+{"version":3,"file":"fileApiTreeAccessors.d.ts","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileApiTreeAccessors.ts"],"names":[],"mappings":"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"}

package/lib/packlets/file-tree/fileApiTreeAccessors.js

@@ -33,6 +33,9 @@ exports.FileApiTreeAccessors = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
 const ts_json_base_1 = require("@fgv/ts-json-base");
 const file_api_types_1 = require("../file-api-types");
+const fileSystemAccessTreeAccessors_1 = require("./fileSystemAccessTreeAccessors");
+const httpTreeAccessors_1 = require("./httpTreeAccessors");
+const localStorageTreeAccessors_1 = require("./localStorageTreeAccessors");
 /**
  * Helper function to safely get webkitRelativePath from a File object.
  * @internal
@@ -46,6 +49,94 @@ function getFileRelativePath(file) {
  * @public
  */
 class FileApiTreeAccessors {
+    /**
+     * Create a persistent FileTree from a File System Access API directory handle.
+     * Changes to files can be synced back to disk.
+     *
+     * @param dirHandle - FileSystemDirectoryHandle to load files from
+     * @param params - Optional parameters including autoSync and permission settings
+     * @returns Promise resolving to a FileTree with persistence capability
+     *
+     * @remarks
+     * - Only works in browsers supporting File System Access API (Chrome, Edge, Opera)
+     * - Requires 'readwrite' permission on the directory handle
+     * - Falls back to read-only mode if permissions unavailable (unless requireWritePermission is true)
+     *
+     * @public
+     */
+    static async createPersistent(dirHandle, params) {
+        const accessorsResult = await fileSystemAccessTreeAccessors_1.FileSystemAccessTreeAccessors.fromDirectoryHandle(dirHandle, params);
+        if (accessorsResult.isFailure()) {
+            return (0, ts_utils_1.fail)(accessorsResult.message);
+        }
+        return ts_json_base_1.FileTree.FileTree.create(accessorsResult.value);
+    }
+    /**
+     * Create a persistent FileTree from an HTTP storage service.
+     *
+     * @param params - Configuration including API base URL, namespace, and optional autoSync
+     * @returns Promise resolving to a FileTree with persistence capability
+     * @public
+     */
+    static async createFromHttp(params) {
+        const accessorsResult = await httpTreeAccessors_1.HttpTreeAccessors.fromHttp(params);
+        if (accessorsResult.isFailure()) {
+            return (0, ts_utils_1.fail)(accessorsResult.message);
+        }
+        return ts_json_base_1.FileTree.FileTree.create(accessorsResult.value);
+    }
+    /**
+     * Create a persistent FileTree from a single File System Access API file handle.
+     * The tree contains exactly one file at `/<filename>`.
+     * Changes can be synced back to the original file via `syncToDisk()`.
+     *
+     * @param fileHandle - FileSystemFileHandle to load
+     * @param params - Optional parameters including autoSync and permission settings
+     * @returns Promise resolving to a FileTree with persistence capability
+     * @public
+     */
+    static async createPersistentFromFile(fileHandle, params) {
+        const accessorsResult = await fileSystemAccessTreeAccessors_1.FileSystemAccessTreeAccessors.fromFileHandle(fileHandle, params);
+        if (accessorsResult.isFailure()) {
+            return (0, ts_utils_1.fail)(accessorsResult.message);
+        }
+        return ts_json_base_1.FileTree.FileTree.create(accessorsResult.value);
+    }
+    /**
+     * Create a persistent FileTree from browser localStorage.
+     * Changes to files can be synced back to localStorage.
+     *
+     * @param params - Configuration including path-to-key mappings and optional autoSync
+     * @returns Result containing a FileTree with persistence capability
+     *
+     * @remarks
+     * - Works in all browsers with localStorage support
+     * - Maps directory paths to localStorage keys
+     * - Each key stores multiple collections as JSON
+     * - Files are automatically discovered from storage
+     *
+     * @example
+     * ```typescript
+     * const tree = FileApiTreeAccessors.createFromLocalStorage({
+     *   pathToKeyMap: {
+     *     '/data/ingredients': 'myapp:ingredients:v1',
+     *     '/data/fillings': 'myapp:fillings:v1'
+     *   },
+     *   mutable: true,
+     *   autoSync: false
+     * });
+     * ```
+     *
+     * @public
+     */
+    static createFromLocalStorage(params) {
+        const accessorsResult = localStorageTreeAccessors_1.LocalStorageTreeAccessors.fromStorage(params);
+        /* c8 ignore next 3 - coverage intermittently missed in full suite */
+        if (accessorsResult.isFailure()) {
+            return (0, ts_utils_1.fail)(accessorsResult.message);
+        }
+        return ts_json_base_1.FileTree.FileTree.create(accessorsResult.value);
+    }
     /**
      * Create FileTree from various file sources using TreeInitializer array.
      * @param initializers - Array of TreeInitializer objects specifying file sources