@fgv/ts-web-extras 5.0.0

package/lib/packlets/crypto/index.js

@@ -0,0 +1,43 @@
+"use strict";
+/*
+ * Copyright (c) 2025 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Browser-compatible cryptographic utilities using the Web Crypto API.
+ * @packageDocumentation
+ */
+__exportStar(require("./browserHashProvider"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/crypto/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH;;;GAGG;AAEH,wDAAsC","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';\n"]}

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

@@ -0,0 +1,205 @@
+/**
+ * File System Access API type definitions and utilities for browser compatibility.
+ * @packageDocumentation
+ */
+/**
+ * File System Access API methods available on Window
+ * @public
+ */
+export interface IFsAccessApis {
+    showDirectoryPicker(options?: ShowDirectoryPickerOptions): Promise<FileSystemDirectoryHandle>;
+    showOpenFilePicker(options?: ShowOpenFilePickerOptions): Promise<FileSystemFileHandle[]>;
+    showSaveFilePicker(options?: ShowSaveFilePickerOptions): Promise<FileSystemFileHandle>;
+}
+/**
+ * Window interface extended with File System Access API
+ * @public
+ */
+export type WindowWithFsAccess = Window & IFsAccessApis;
+/**
+ * Base interface for file system handles
+ * @public
+ */
+export interface FileSystemHandle {
+    readonly kind: 'file' | 'directory';
+    readonly name: string;
+    isSameEntry(other: FileSystemHandle): Promise<boolean>;
+    queryPermission(descriptor?: FileSystemHandlePermissionDescriptor): Promise<PermissionState>;
+    requestPermission(descriptor?: FileSystemHandlePermissionDescriptor): Promise<PermissionState>;
+}
+/**
+ * File handle interface
+ * @public
+ */
+export interface FileSystemFileHandle extends FileSystemHandle {
+    readonly kind: 'file';
+    getFile(): Promise<File>;
+    createWritable(options?: FileSystemCreateWritableOptions): Promise<FileSystemWritableFileStream>;
+}
+/**
+ * Directory handle interface
+ * @public
+ */
+export interface FileSystemDirectoryHandle extends FileSystemHandle {
+    readonly kind: 'directory';
+    getDirectoryHandle(name: string, options?: FileSystemGetDirectoryOptions): Promise<FileSystemDirectoryHandle>;
+    getFileHandle(name: string, options?: FileSystemGetFileOptions): Promise<FileSystemFileHandle>;
+    removeEntry(name: string, options?: FileSystemRemoveOptions): Promise<void>;
+    resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;
+    keys(): AsyncIterableIterator<string>;
+    values(): AsyncIterableIterator<FileSystemHandle>;
+    entries(): AsyncIterableIterator<[string, FileSystemHandle]>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;
+}
+/**
+ * Permission descriptor for file system handles
+ * @public
+ */
+export interface FileSystemHandlePermissionDescriptor {
+    mode?: 'read' | 'readwrite';
+}
+/**
+ * Options for creating writable file streams
+ * @public
+ */
+export interface FileSystemCreateWritableOptions {
+    keepExistingData?: boolean;
+}
+/**
+ * Options for getting directory handles
+ * @public
+ */
+export interface FileSystemGetDirectoryOptions {
+    create?: boolean;
+}
+/**
+ * Options for getting file handles
+ * @public
+ */
+export interface FileSystemGetFileOptions {
+    create?: boolean;
+}
+/**
+ * Options for removing entries
+ * @public
+ */
+export interface FileSystemRemoveOptions {
+    recursive?: boolean;
+}
+/**
+ * Writable file stream interface
+ * @public
+ */
+export interface FileSystemWritableFileStream extends WritableStream {
+    write(data: BufferSource | Blob | string): Promise<void>;
+    seek(position: number): Promise<void>;
+    truncate(size: number): Promise<void>;
+}
+/**
+ * Directory picker options
+ * @public
+ */
+export interface ShowDirectoryPickerOptions {
+    id?: string;
+    mode?: 'read' | 'readwrite';
+    startIn?: FileSystemHandle | WellKnownDirectory;
+}
+/**
+ * File picker options
+ * @public
+ */
+export interface ShowOpenFilePickerOptions {
+    multiple?: boolean;
+    excludeAcceptAllOption?: boolean;
+    id?: string;
+    startIn?: FileSystemHandle | WellKnownDirectory;
+    types?: FilePickerAcceptType[];
+}
+/**
+ * Save file picker options
+ * @public
+ */
+export interface ShowSaveFilePickerOptions {
+    excludeAcceptAllOption?: boolean;
+    id?: string;
+    startIn?: FileSystemHandle | WellKnownDirectory;
+    suggestedName?: string;
+    types?: FilePickerAcceptType[];
+}
+/**
+ * File picker accept type
+ * @public
+ */
+export interface FilePickerAcceptType {
+    description?: string;
+    accept: Record<string, string | string[]>;
+}
+/**
+ * Well-known directory type
+ * @public
+ */
+export type WellKnownDirectory = 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos';
+/**
+ * Type guard to check if the browser supports the File System Access API
+ * @param window - The window object to check
+ * @returns True if the window supports File System Access API
+ * @public
+ */
+export declare function supportsFileSystemAccess(window: Window): window is WindowWithFsAccess;
+/**
+ * Type guard to check if a FileSystemHandle is a file handle
+ * @param handle - The handle to check
+ * @returns True if the handle is a FileSystemFileHandle
+ * @public
+ */
+export declare function isFileHandle(handle: FileSystemHandle): handle is FileSystemFileHandle;
+/**
+ * Type guard to check if a FileSystemHandle is a directory handle
+ * @param handle - The handle to check
+ * @returns True if the handle is a FileSystemDirectoryHandle
+ * @public
+ */
+export declare function isDirectoryHandle(handle: FileSystemHandle): handle is FileSystemDirectoryHandle;
+/**
+ * Safely access showOpenFilePicker with proper type checking
+ * @param window - The window object
+ * @param options - Options for the file picker
+ * @returns Promise with file handles or null if not supported
+ * @public
+ */
+export declare function safeShowOpenFilePicker(window: Window, options?: ShowOpenFilePickerOptions): Promise<FileSystemFileHandle[] | null>;
+/**
+ * Safely access showSaveFilePicker with proper type checking
+ * @param window - The window object
+ * @param options - Options for the file picker
+ * @returns Promise with file handle or null if not supported
+ * @public
+ */
+export declare function safeShowSaveFilePicker(window: Window, options?: ShowSaveFilePickerOptions): Promise<FileSystemFileHandle | null>;
+/**
+ * Safely access showDirectoryPicker with proper type checking
+ * @param window - The window object
+ * @param options - Options for the directory picker
+ * @returns Promise with directory handle or null if not supported
+ * @public
+ */
+export declare function safeShowDirectoryPicker(window: Window, options?: ShowDirectoryPickerOptions): Promise<FileSystemDirectoryHandle | null>;
+/**
+ * Export data as JSON file using legacy blob download method.
+ * Creates a temporary download link and triggers file download.
+ * @param data - Data to export as JSON
+ * @param filename - Name for the downloaded file
+ * @public
+ */
+export declare function exportAsJson(data: unknown, filename: string): void;
+/**
+ * Export data using File System Access API with fallback to blob download.
+ * @param data - Data to export as JSON
+ * @param suggestedName - Suggested filename for the save dialog
+ * @param description - Description for file type filter (default: 'JSON files')
+ * @param window - Window object for API access (default: globalThis.window)
+ * @returns Promise resolving to true if saved via File System Access API, false if fallback used
+ * @public
+ */
+export declare function exportUsingFileSystemAPI(data: unknown, suggestedName: string, description?: string, window?: Window): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,166 @@
+"use strict";
+/*
+ * Copyright (c) 2025 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.supportsFileSystemAccess = supportsFileSystemAccess;
+exports.isFileHandle = isFileHandle;
+exports.isDirectoryHandle = isDirectoryHandle;
+exports.safeShowOpenFilePicker = safeShowOpenFilePicker;
+exports.safeShowSaveFilePicker = safeShowSaveFilePicker;
+exports.safeShowDirectoryPicker = safeShowDirectoryPicker;
+exports.exportAsJson = exportAsJson;
+exports.exportUsingFileSystemAPI = exportUsingFileSystemAPI;
+/**
+ * Type guard to check if the browser supports the File System Access API
+ * @param window - The window object to check
+ * @returns True if the window supports File System Access API
+ * @public
+ */
+function supportsFileSystemAccess(window) {
+    return 'showOpenFilePicker' in window && 'showSaveFilePicker' in window && 'showDirectoryPicker' in window;
+}
+/**
+ * Type guard to check if a FileSystemHandle is a file handle
+ * @param handle - The handle to check
+ * @returns True if the handle is a FileSystemFileHandle
+ * @public
+ */
+function isFileHandle(handle) {
+    return handle.kind === 'file';
+}
+/**
+ * Type guard to check if a FileSystemHandle is a directory handle
+ * @param handle - The handle to check
+ * @returns True if the handle is a FileSystemDirectoryHandle
+ * @public
+ */
+function isDirectoryHandle(handle) {
+    return handle.kind === 'directory';
+}
+/**
+ * Safely access showOpenFilePicker with proper type checking
+ * @param window - The window object
+ * @param options - Options for the file picker
+ * @returns Promise with file handles or null if not supported
+ * @public
+ */
+async function safeShowOpenFilePicker(window, options) {
+    if (supportsFileSystemAccess(window)) {
+        return window.showOpenFilePicker(options);
+    }
+    return null;
+}
+/**
+ * Safely access showSaveFilePicker with proper type checking
+ * @param window - The window object
+ * @param options - Options for the file picker
+ * @returns Promise with file handle or null if not supported
+ * @public
+ */
+async function safeShowSaveFilePicker(window, options) {
+    if (supportsFileSystemAccess(window)) {
+        return window.showSaveFilePicker(options);
+    }
+    return null;
+}
+/**
+ * Safely access showDirectoryPicker with proper type checking
+ * @param window - The window object
+ * @param options - Options for the directory picker
+ * @returns Promise with directory handle or null if not supported
+ * @public
+ */
+async function safeShowDirectoryPicker(window, options) {
+    if (supportsFileSystemAccess(window)) {
+        return window.showDirectoryPicker(options);
+    }
+    return null;
+}
+/**
+ * Export data as JSON file using legacy blob download method.
+ * Creates a temporary download link and triggers file download.
+ * @param data - Data to export as JSON
+ * @param filename - Name for the downloaded file
+ * @public
+ */
+function exportAsJson(data, filename) {
+    const json = JSON.stringify(data, null, 2);
+    const blob = new Blob([json], { type: 'application/json' });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+}
+/**
+ * Export data using File System Access API with fallback to blob download.
+ * @param data - Data to export as JSON
+ * @param suggestedName - Suggested filename for the save dialog
+ * @param description - Description for file type filter (default: 'JSON files')
+ * @param window - Window object for API access (default: globalThis.window)
+ * @returns Promise resolving to true if saved via File System Access API, false if fallback used
+ * @public
+ */
+async function exportUsingFileSystemAPI(data, suggestedName, description = 'JSON files', window = globalThis.window) {
+    if (!supportsFileSystemAccess(window)) {
+        // Fallback to blob download
+        exportAsJson(data, suggestedName);
+        return false;
+    }
+    try {
+        const fileHandle = await safeShowSaveFilePicker(window, {
+            suggestedName,
+            types: [
+                {
+                    description,
+                    accept: {
+                        'application/json': ['.json']
+                    }
+                }
+            ]
+        });
+        if (!fileHandle) {
+            // User cancelled - fallback to blob download
+            exportAsJson(data, suggestedName);
+            return false;
+        }
+        const json = JSON.stringify(data, null, 2);
+        const writable = await fileHandle.createWritable();
+        await writable.write(json);
+        await writable.close();
+        return true;
+    }
+    catch (error) {
+        // Handle errors by falling back to blob download
+        if (error.name === 'AbortError') {
+            // User cancelled - fallback
+            exportAsJson(data, suggestedName);
+            return false;
+        }
+        // Other errors - re-throw as they indicate a real problem
+        throw error;
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,129 @@
+import { Result } from '@fgv/ts-utils';
+import { FileTree } from '@fgv/ts-json-base';
+import { FileSystemFileHandle, FileSystemDirectoryHandle } from '../file-api-types';
+/**
+ * Tree initializer for FileList objects (from File API).
+ * @public
+ */
+export interface IFileListTreeInitializer {
+    readonly fileList: FileList;
+}
+/**
+ * Tree initializer for File System Access API file handles.
+ * @public
+ */
+export interface IFileHandleTreeInitializer {
+    readonly prefix?: string;
+    readonly fileHandles: FileSystemFileHandle[];
+}
+/**
+ * Tree initializer for File System Access API directory handles.
+ * @public
+ */
+export interface IDirectoryHandleTreeInitializer {
+    readonly prefix?: string;
+    readonly dirHandles: FileSystemDirectoryHandle[];
+    readonly nonRecursive?: boolean;
+}
+/**
+ * Union type for all supported tree initializers.
+ * @public
+ */
+export type TreeInitializer = IFileListTreeInitializer | IFileHandleTreeInitializer | IDirectoryHandleTreeInitializer;
+/**
+ * Interface for file metadata.
+ * @public
+ */
+export interface IFileMetadata {
+    path: string;
+    name: string;
+    size: number;
+    type: string;
+    lastModified: number;
+}
+/**
+ * Helper class to create FileTree instances from various file sources.
+ * Supports File API (FileList) and File System Access API handles.
+ * @public
+ */
+export declare class FileApiTreeAccessors<TCT extends string = string> {
+    /**
+     * Create FileTree from various file sources using TreeInitializer array.
+     * @param initializers - Array of TreeInitializer objects specifying file sources
+     * @param params - Optional `IFileTreeInitParams` for the file tree.
+     * @returns Promise resolving to a FileTree with all content pre-loaded
+     */
+    static create<TCT extends string = string>(initializers: TreeInitializer[], params?: FileTree.IFileTreeInitParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    /**
+     * Create FileTree from FileList (e.g., from input[type="file"]).
+     * @param fileList - FileList from a file input element
+     * @param params - Optional `IFileTreeInitParams` for the file tree.
+     * @returns Promise resolving to a FileTree with all content pre-loaded
+     */
+    static fromFileList<TCT extends string = string>(fileList: FileList, params?: FileTree.IFileTreeInitParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    /**
+     * Create FileTree from directory upload with webkitRelativePath.
+     * @param fileList - FileList from a directory upload (input with webkitdirectory)
+     * @param params - Optional `IFileTreeInitParams` for the file tree.
+     * @returns Promise resolving to a FileTree with all content pre-loaded
+     */
+    static fromDirectoryUpload<TCT extends string = string>(fileList: FileList, params?: FileTree.IFileTreeInitParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    /**
+     * Get the File object for a specific path from the original FileList.
+     * This is useful for accessing the original File API object for operations
+     * like getting file metadata, MIME type, etc.
+     * @param fileList - The original FileList
+     * @param targetPath - The path to find
+     * @returns Result containing the File object if found
+     */
+    static getOriginalFile(fileList: FileList, targetPath: string): Result<File>;
+    /**
+     * Extract file metadata from a File.
+     * @param fileList - The File to extract metadata from
+     * @returns The {@link IFileMetadata | file metadata}
+     */
+    static extractFileMetadata(file: File): IFileMetadata;
+    /**
+     * Process a single TreeInitializer and return the resulting files.
+     * @param initializer - The TreeInitializer to process
+     * @param params - Optional `IFileTreeInitParams` for the file tree.
+     * @returns Promise resolving to an array of `IInMemoryFile` objects
+     * @internal
+     */
+    private static _processInitializer;
+    /**
+     * Process a FileList and return IInMemoryFile array.
+     * @param fileList - The FileList to process
+     * @param params - Optional `IFileTreeInitParams` for the file tree.
+     * @returns Promise resolving to an array of `IInMemoryFile` objects
+     * @internal
+     */
+    private static _processFileList;
+    /**
+     * Process FileSystemFileHandles and return IInMemoryFile array.
+     * @internal
+     */
+    private static _processFileHandles;
+    /**
+     * Process FileSystemDirectoryHandles and return IInMemoryFile array.
+     * @param handles - The FileSystemDirectoryHandle[] to process
+     * @param prefix - The prefix to use for the file paths
+     * @param recursive - Whether to process the directory recursively
+     * @param params - Optional `IFileTreeInitParams` for the file tree.
+     * @returns Promise resolving to an array of `IInMemoryFile` objects
+     * @internal
+     */
+    private static _processDirectoryHandles;
+    /**
+     * Process a single FileSystemDirectoryHandle recursively.
+     * @param handle - The FileSystemDirectoryHandle to process
+     * @param basePath - The base path to use for the file paths
+     * @param recursive - Whether to process the directory recursively
+     * @param params - Optional `IFileTreeInitParams` for the file tree.
+     * @returns Promise resolving to an array of `IInMemoryFile` objects
+     * @internal
+     */
+    private static _processDirectoryHandle;
+    private static _normalizePath;
+}
+//# sourceMappingURL=fileApiTreeAccessors.d.ts.map

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

@@ -0,0 +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"}