@fgv/ts-web-extras 5.0.1-8 → 5.0.1

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

@@ -0,0 +1,156 @@
+/*
+ * 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.
+ */
+/**
+ * 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 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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/dist/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/dist/packlets/file-tree/fileApiTreeAccessors.js

@@ -0,0 +1,330 @@
+/*
+ * 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 __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+// File System Access API types are imported via the file-api-types module
+import { succeed, fail } from '@fgv/ts-utils';
+import { FileTree } from '@fgv/ts-json-base';
+import { isFileHandle, isDirectoryHandle } from '../file-api-types';
+/**
+ * Helper function to safely get webkitRelativePath from a File object.
+ * @internal
+ */
+function getFileRelativePath(file) {
+    return file.webkitRelativePath || file.name;
+}
+/**
+ * Helper class to create FileTree instances from various file sources.
+ * Supports File API (FileList) and File System Access API handles.
+ * @public
+ */
+export class FileApiTreeAccessors {
+    /**
+     * 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 async create(initializers, params) {
+        try {
+            const allFiles = [];
+            for (const initializer of initializers) {
+                const filesResult = await this._processInitializer(initializer, params);
+                if (filesResult.isFailure()) {
+                    return fail(filesResult.message);
+                }
+                allFiles.push(...filesResult.value);
+            }
+            return FileTree.inMemory(allFiles, params);
+            /* c8 ignore next 5 - defense in depth */
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return fail(`Failed to process initializers: ${message}`);
+        }
+    }
+    /**
+     * 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 async fromFileList(fileList, params) {
+        var _a;
+        const files = [];
+        for (let i = 0; i < fileList.length; i++) {
+            const file = fileList[i];
+            const path = this._normalizePath((params === null || params === void 0 ? void 0 : params.prefix) || '', file.name);
+            try {
+                const contents = await file.text();
+                const contentType = (_a = params === null || params === void 0 ? void 0 : params.inferContentType) === null || _a === void 0 ? void 0 : _a.call(params, path, file.type).orDefault();
+                files.push({
+                    path,
+                    contents,
+                    contentType
+                });
+            }
+            catch (error) {
+                /* c8 ignore next 1 - defense in depth */
+                const message = error instanceof Error ? error.message : String(error);
+                return fail(`Failed to read file ${file.name}: ${message}`);
+            }
+        }
+        return FileTree.inMemory(files, params);
+    }
+    /**
+     * 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 async fromDirectoryUpload(fileList, params) {
+        var _a;
+        const files = [];
+        for (let i = 0; i < fileList.length; i++) {
+            const file = fileList[i];
+            const relativePath = getFileRelativePath(file);
+            const path = this._normalizePath((params === null || params === void 0 ? void 0 : params.prefix) || '', relativePath);
+            try {
+                const contents = await file.text();
+                const contentType = (_a = params === null || params === void 0 ? void 0 : params.inferContentType) === null || _a === void 0 ? void 0 : _a.call(params, path, file.type).orDefault();
+                files.push({
+                    path,
+                    contents,
+                    contentType
+                });
+            }
+            catch (error) {
+                /* c8 ignore next 1 - defense in depth */
+                const message = error instanceof Error ? error.message : String(error);
+                return fail(`Failed to read file ${relativePath}: ${message}`);
+            }
+        }
+        return FileTree.inMemory(files, params);
+    }
+    /**
+     * 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, targetPath) {
+        for (const file of Array.from(fileList)) {
+            const filePath = getFileRelativePath(file);
+            if (filePath === targetPath) {
+                return succeed(file);
+            }
+        }
+        return fail(`File not found: ${targetPath}`);
+    }
+    /**
+     * Extract file metadata from a File.
+     * @param fileList - The File to extract metadata from
+     * @returns The {@link IFileMetadata | file metadata}
+     */
+    static extractFileMetadata(file) {
+        return {
+            path: getFileRelativePath(file),
+            name: file.name,
+            size: file.size,
+            type: file.type,
+            lastModified: file.lastModified
+        };
+    }
+    /**
+     * 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
+     */
+    static async _processInitializer(initializer, params) {
+        var _a;
+        if ('fileList' in initializer) {
+            return this._processFileList(initializer.fileList, params);
+        }
+        else if ('fileHandles' in initializer) {
+            return this._processFileHandles(initializer.fileHandles, params);
+        }
+        else if ('dirHandles' in initializer) {
+            return this._processDirectoryHandles(initializer.dirHandles, (_a = initializer.prefix) !== null && _a !== void 0 ? _a : params === null || params === void 0 ? void 0 : params.prefix, !initializer.nonRecursive, params);
+        }
+        else {
+            return fail('Unknown initializer type');
+        }
+    }
+    /**
+     * 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
+     */
+    static async _processFileList(fileList, params) {
+        var _a;
+        const files = [];
+        for (let i = 0; i < fileList.length; i++) {
+            const file = fileList[i];
+            const metadata = this.extractFileMetadata(file);
+            const relativePath = metadata.path;
+            const path = relativePath.startsWith('/') ? relativePath : `/${relativePath}`;
+            try {
+                const contents = await file.text();
+                const contentType = (_a = params === null || params === void 0 ? void 0 : params.inferContentType) === null || _a === void 0 ? void 0 : _a.call(params, path, metadata.type).orDefault();
+                files.push({
+                    path,
+                    contents,
+                    contentType
+                });
+            }
+            catch (error) {
+                /* c8 ignore next 1 - defense in depth */
+                const message = error instanceof Error ? error.message : String(error);
+                return fail(`Failed to read file ${relativePath}: ${message}`);
+            }
+        }
+        return succeed(files);
+    }
+    /**
+     * Process FileSystemFileHandles and return IInMemoryFile array.
+     * @internal
+     */
+    static async _processFileHandles(handles, params) {
+        var _a, _b;
+        const files = [];
+        for (const handle of handles) {
+            try {
+                const file = await handle.getFile();
+                const contents = await file.text();
+                const metadata = this.extractFileMetadata(file);
+                /* c8 ignore next 1 - defense in depth */
+                const path = this._normalizePath((_a = params === null || params === void 0 ? void 0 : params.prefix) !== null && _a !== void 0 ? _a : '', handle.name);
+                const contentType = (_b = params === null || params === void 0 ? void 0 : params.inferContentType) === null || _b === void 0 ? void 0 : _b.call(params, path, metadata.type).orDefault();
+                files.push({
+                    path,
+                    contents,
+                    contentType
+                });
+            }
+            catch (error) {
+                /* c8 ignore next 1 - defense in depth */
+                const message = error instanceof Error ? error.message : String(error);
+                return fail(`Failed to read file handle ${handle.name}: ${message}`);
+            }
+        }
+        return succeed(files);
+    }
+    /**
+     * 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
+     */
+    static async _processDirectoryHandles(handles, prefix, recursive = true, params) {
+        const allFiles = [];
+        prefix = prefix !== null && prefix !== void 0 ? prefix : params === null || params === void 0 ? void 0 : params.prefix;
+        for (const handle of handles) {
+            const dirPrefix = this._normalizePath(prefix !== null && prefix !== void 0 ? prefix : '', handle.name);
+            const filesResult = await this._processDirectoryHandle(handle, dirPrefix, recursive, params);
+            if (filesResult.isFailure()) {
+                return filesResult;
+            }
+            allFiles.push(...filesResult.value);
+        }
+        return succeed(allFiles);
+    }
+    /**
+     * 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
+     */
+    static async _processDirectoryHandle(handle, basePath, recursive, params) {
+        var _a, e_1, _b, _c;
+        var _d;
+        const files = [];
+        try {
+            try {
+                for (var _e = true, _f = __asyncValues(handle.values()), _g; _g = await _f.next(), _a = _g.done, !_a; _e = true) {
+                    _c = _g.value;
+                    _e = false;
+                    const entry = _c;
+                    if (isFileHandle(entry)) {
+                        const file = await entry.getFile();
+                        const contents = await file.text();
+                        const path = this._normalizePath(basePath, entry.name);
+                        const contentType = (_d = params === null || params === void 0 ? void 0 : params.inferContentType) === null || _d === void 0 ? void 0 : _d.call(params, path).orDefault();
+                        files.push({
+                            path,
+                            contents,
+                            contentType
+                        });
+                    }
+                    else if (isDirectoryHandle(entry) && recursive) {
+                        const subDirPath = this._normalizePath(basePath, entry.name);
+                        const subdirResult = await this._processDirectoryHandle(entry, subDirPath, recursive, params);
+                        if (subdirResult.isFailure()) {
+                            return subdirResult;
+                        }
+                        files.push(...subdirResult.value);
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_e && !_a && (_b = _f.return)) await _b.call(_f);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            return succeed(files);
+        }
+        catch (error) {
+            /* c8 ignore next 1 - defense in depth */
+            const message = error instanceof Error ? error.message : String(error);
+            return fail(`Failed to process directory ${handle.name}: ${message}`);
+        }
+    }
+    static _normalizePath(prefix, path) {
+        // Remove leading slash from prefix if it exists to avoid double slashes
+        const cleanPrefix = prefix ? prefix.replace(/^\/+/, '') : '';
+        const combined = cleanPrefix ? `${cleanPrefix}/${path}` : path;
+        // Normalize multiple slashes and ensure it starts with / for FileTree compatibility
+        const normalized = combined.replace(/\/+/g, '/').replace(/\/$/, '');
+        /* c8 ignore next 1 - tested but coverage intermittently missed */
+        return normalized.startsWith('/') ? normalized : `/${normalized}`;
+    }
+}
+//# sourceMappingURL=fileApiTreeAccessors.js.map

package/dist/packlets/file-tree/fileApiTreeAccessors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileApiTreeAccessors.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/fileApiTreeAccessors.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// File System Access API types are imported via the file-api-types module\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport {\n  isFileHandle,\n  isDirectoryHandle,\n  FileSystemFileHandle,\n  FileSystemDirectoryHandle\n} from '../file-api-types';\n\n/**\n * Interface for File objects that may have the webkitRelativePath property.\n * This property is added by browsers when using directory upload (webkitdirectory).\n * @internal\n */\ninterface IFileWithWebkitPath {\n  readonly webkitRelativePath?: string;\n}\n\n/**\n * Helper function to safely get webkitRelativePath from a File object.\n * @internal\n */\nfunction getFileRelativePath(file: File): string {\n  return (file as unknown as IFileWithWebkitPath).webkitRelativePath || file.name;\n}\n\n/**\n * Tree initializer for FileList objects (from File API).\n * @public\n */\nexport interface IFileListTreeInitializer {\n  readonly fileList: FileList;\n}\n\n/**\n * Tree initializer for File System Access API file handles.\n * @public\n */\nexport interface IFileHandleTreeInitializer {\n  readonly prefix?: string;\n  readonly fileHandles: FileSystemFileHandle[];\n}\n\n/**\n * Tree initializer for File System Access API directory handles.\n * @public\n */\nexport interface IDirectoryHandleTreeInitializer {\n  readonly prefix?: string;\n  readonly dirHandles: FileSystemDirectoryHandle[];\n  readonly nonRecursive?: boolean; // Default: false (recursive by default)\n}\n\n/**\n * Union type for all supported tree initializers.\n * @public\n */\nexport type TreeInitializer =\n  | IFileListTreeInitializer\n  | IFileHandleTreeInitializer\n  | IDirectoryHandleTreeInitializer;\n\n/**\n * Interface for file metadata.\n * @public\n */\nexport interface IFileMetadata {\n  path: string;\n  name: string;\n  size: number;\n  type: string;\n  lastModified: number;\n}\n\n/**\n * Helper class to create FileTree instances from various file sources.\n * Supports File API (FileList) and File System Access API handles.\n * @public\n */\nexport class FileApiTreeAccessors<TCT extends string = string> {\n  /**\n   * Create FileTree from various file sources using TreeInitializer array.\n   * @param initializers - Array of TreeInitializer objects specifying file sources\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to a FileTree with all content pre-loaded\n   */\n  public static async create<TCT extends string = string>(\n    initializers: TreeInitializer[],\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    try {\n      const allFiles: FileTree.IInMemoryFile<TCT>[] = [];\n\n      for (const initializer of initializers) {\n        const filesResult = await this._processInitializer<TCT>(initializer, params);\n        if (filesResult.isFailure()) {\n          return fail(filesResult.message);\n        }\n        allFiles.push(...filesResult.value);\n      }\n\n      return FileTree.inMemory<TCT>(allFiles, params);\n      /* c8 ignore next 5 - defense in depth */\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to process initializers: ${message}`);\n    }\n  }\n\n  /**\n   * Create FileTree from FileList (e.g., from input[type=\"file\"]).\n   * @param fileList - FileList from a file input element\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to a FileTree with all content pre-loaded\n   */\n  public static async fromFileList<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const path = this._normalizePath(params?.prefix || '', file.name);\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, file.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${file.name}: ${message}`);\n      }\n    }\n\n    return FileTree.inMemory<TCT>(files, params);\n  }\n\n  /**\n   * Create FileTree from directory upload with webkitRelativePath.\n   * @param fileList - FileList from a directory upload (input with webkitdirectory)\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to a FileTree with all content pre-loaded\n   */\n  public static async fromDirectoryUpload<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.FileTree<TCT>>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const relativePath = getFileRelativePath(file);\n      const path = this._normalizePath(params?.prefix || '', relativePath);\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, file.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${relativePath}: ${message}`);\n      }\n    }\n\n    return FileTree.inMemory<TCT>(files, params);\n  }\n\n  /**\n   * Get the File object for a specific path from the original FileList.\n   * This is useful for accessing the original File API object for operations\n   * like getting file metadata, MIME type, etc.\n   * @param fileList - The original FileList\n   * @param targetPath - The path to find\n   * @returns Result containing the File object if found\n   */\n  public static getOriginalFile(fileList: FileList, targetPath: string): Result<File> {\n    for (const file of Array.from(fileList)) {\n      const filePath = getFileRelativePath(file);\n      if (filePath === targetPath) {\n        return succeed(file);\n      }\n    }\n    return fail(`File not found: ${targetPath}`);\n  }\n\n  /**\n   * Extract file metadata from a File.\n   * @param fileList - The File to extract metadata from\n   * @returns The {@link IFileMetadata | file metadata}\n   */\n  public static extractFileMetadata(file: File): IFileMetadata {\n    return {\n      path: getFileRelativePath(file),\n      name: file.name,\n      size: file.size,\n      type: file.type,\n      lastModified: file.lastModified\n    };\n  }\n\n  /**\n   * Process a single TreeInitializer and return the resulting files.\n   * @param initializer - The TreeInitializer to process\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processInitializer<TCT extends string = string>(\n    initializer: TreeInitializer,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    if ('fileList' in initializer) {\n      return this._processFileList<TCT>(initializer.fileList, params);\n    } else if ('fileHandles' in initializer) {\n      return this._processFileHandles<TCT>(initializer.fileHandles, params);\n    } else if ('dirHandles' in initializer) {\n      return this._processDirectoryHandles<TCT>(\n        initializer.dirHandles,\n        initializer.prefix ?? params?.prefix,\n        !initializer.nonRecursive,\n        params\n      );\n    } else {\n      return fail('Unknown initializer type');\n    }\n  }\n\n  /**\n   * Process a FileList and return IInMemoryFile array.\n   * @param fileList - The FileList to process\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processFileList<TCT extends string = string>(\n    fileList: FileList,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (let i = 0; i < fileList.length; i++) {\n      const file = fileList[i];\n      const metadata = this.extractFileMetadata(file);\n      const relativePath = metadata.path;\n      const path = relativePath.startsWith('/') ? relativePath : `/${relativePath}`;\n\n      try {\n        const contents = await file.text();\n        const contentType = params?.inferContentType?.(path, metadata.type).orDefault();\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file ${relativePath}: ${message}`);\n      }\n    }\n\n    return succeed(files);\n  }\n\n  /**\n   * Process FileSystemFileHandles and return IInMemoryFile array.\n   * @internal\n   */\n  private static async _processFileHandles<TCT extends string = string>(\n    handles: FileSystemFileHandle[],\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    for (const handle of handles) {\n      try {\n        const file = await handle.getFile();\n        const contents = await file.text();\n        const metadata = this.extractFileMetadata(file);\n        /* c8 ignore next 1 - defense in depth */\n        const path = this._normalizePath(params?.prefix ?? '', handle.name);\n        const contentType = params?.inferContentType?.(path, metadata.type).orDefault();\n\n        files.push({\n          path,\n          contents,\n          contentType\n        });\n      } catch (error) {\n        /* c8 ignore next 1 - defense in depth */\n        const message = error instanceof Error ? error.message : String(error);\n        return fail(`Failed to read file handle ${handle.name}: ${message}`);\n      }\n    }\n\n    return succeed(files);\n  }\n\n  /**\n   * Process FileSystemDirectoryHandles and return IInMemoryFile array.\n   * @param handles - The FileSystemDirectoryHandle[] to process\n   * @param prefix - The prefix to use for the file paths\n   * @param recursive - Whether to process the directory recursively\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processDirectoryHandles<TCT extends string = string>(\n    handles: FileSystemDirectoryHandle[],\n    prefix?: string,\n    recursive: boolean = true,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const allFiles: FileTree.IInMemoryFile<TCT>[] = [];\n    prefix = prefix ?? params?.prefix;\n\n    for (const handle of handles) {\n      const dirPrefix = this._normalizePath(prefix ?? '', handle.name);\n      const filesResult = await this._processDirectoryHandle<TCT>(handle, dirPrefix, recursive, params);\n      if (filesResult.isFailure()) {\n        return filesResult;\n      }\n      allFiles.push(...filesResult.value);\n    }\n\n    return succeed(allFiles);\n  }\n\n  /**\n   * Process a single FileSystemDirectoryHandle recursively.\n   * @param handle - The FileSystemDirectoryHandle to process\n   * @param basePath - The base path to use for the file paths\n   * @param recursive - Whether to process the directory recursively\n   * @param params - Optional `IFileTreeInitParams` for the file tree.\n   * @returns Promise resolving to an array of `IInMemoryFile` objects\n   * @internal\n   */\n  private static async _processDirectoryHandle<TCT extends string = string>(\n    handle: FileSystemDirectoryHandle,\n    basePath: string,\n    recursive: boolean,\n    params?: FileTree.IFileTreeInitParams<TCT>\n  ): Promise<Result<FileTree.IInMemoryFile<TCT>[]>> {\n    const files: FileTree.IInMemoryFile<TCT>[] = [];\n\n    try {\n      for await (const entry of handle.values()) {\n        if (isFileHandle(entry)) {\n          const file = await entry.getFile();\n          const contents = await file.text();\n          const path = this._normalizePath(basePath, entry.name);\n          const contentType = params?.inferContentType?.(path).orDefault();\n\n          files.push({\n            path,\n            contents,\n            contentType\n          });\n        } else if (isDirectoryHandle(entry) && recursive) {\n          const subDirPath = this._normalizePath(basePath, entry.name);\n          const subdirResult = await this._processDirectoryHandle<TCT>(entry, subDirPath, recursive, params);\n          if (subdirResult.isFailure()) {\n            return subdirResult;\n          }\n          files.push(...subdirResult.value);\n        }\n      }\n\n      return succeed(files);\n    } catch (error) {\n      /* c8 ignore next 1 - defense in depth */\n      const message = error instanceof Error ? error.message : String(error);\n      return fail(`Failed to process directory ${handle.name}: ${message}`);\n    }\n  }\n\n  private static _normalizePath(prefix: string, path: string): string {\n    // Remove leading slash from prefix if it exists to avoid double slashes\n    const cleanPrefix = prefix ? prefix.replace(/^\\/+/, '') : '';\n    const combined = cleanPrefix ? `${cleanPrefix}/${path}` : path;\n    // Normalize multiple slashes and ensure it starts with / for FileTree compatibility\n    const normalized = combined.replace(/\\/+/g, '/').replace(/\\/$/, '');\n    /* c8 ignore next 1 - tested but coverage intermittently missed */\n    return normalized.startsWith('/') ? normalized : `/${normalized}`;\n  }\n}\n"]}

package/dist/packlets/file-tree/index.js

@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+/**
+ * Browser-compatible FileTree implementations using the File API.
+ * @packageDocumentation
+ */
+export * from './fileApiTreeAccessors';
+//# sourceMappingURL=index.js.map

package/dist/packlets/file-tree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/file-tree/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;GAGG;AAEH,cAAc,wBAAwB,CAAC","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 FileTree implementations using the File API.\n * @packageDocumentation\n */\n\nexport * from './fileApiTreeAccessors';\n"]}