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

package/docs/classes/FileApiTreeAccessors.createFromLocalStorage.md

@@ -0,0 +1,25 @@
+[Home](../README.md) > [FileApiTreeAccessors](./FileApiTreeAccessors.md) > createFromLocalStorage
+
+## FileApiTreeAccessors.createFromLocalStorage() method
+
+Create a persistent FileTree from browser localStorage.
+Changes to files can be synced back to localStorage.
+
+**Signature:**
+
+```typescript
+static createFromLocalStorage(params: ILocalStorageTreeParams<TCT>): Result<FileTree_2<TCT>>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>params</td><td>ILocalStorageTreeParams&lt;TCT&gt;</td><td>Configuration including path-to-key mappings and optional autoSync</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Result&lt;FileTree_2&lt;TCT&gt;&gt;
+
+Result containing a FileTree with persistence capability

package/docs/classes/FileApiTreeAccessors.createPersistent.md

@@ -0,0 +1,26 @@
+[Home](../README.md) > [FileApiTreeAccessors](./FileApiTreeAccessors.md) > createPersistent
+
+## FileApiTreeAccessors.createPersistent() method
+
+Create a persistent FileTree from a File System Access API directory handle.
+Changes to files can be synced back to disk.
+
+**Signature:**
+
+```typescript
+static createPersistent(dirHandle: FileSystemDirectoryHandle, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree_2<TCT>>>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>dirHandle</td><td>FileSystemDirectoryHandle</td><td>FileSystemDirectoryHandle to load files from</td></tr>
+<tr><td>params</td><td>IFileSystemAccessTreeParams&lt;TCT&gt;</td><td>Optional parameters including autoSync and permission settings</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;Result&lt;FileTree_2&lt;TCT&gt;&gt;&gt;
+
+Promise resolving to a FileTree with persistence capability

package/docs/classes/FileApiTreeAccessors.createPersistentFromFile.md

@@ -0,0 +1,27 @@
+[Home](../README.md) > [FileApiTreeAccessors](./FileApiTreeAccessors.md) > createPersistentFromFile
+
+## FileApiTreeAccessors.createPersistentFromFile() method
+
+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()`.
+
+**Signature:**
+
+```typescript
+static createPersistentFromFile(fileHandle: FileSystemFileHandle, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree_2<TCT>>>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>fileHandle</td><td>FileSystemFileHandle</td><td>FileSystemFileHandle to load</td></tr>
+<tr><td>params</td><td>IFileSystemAccessTreeParams&lt;TCT&gt;</td><td>Optional parameters including autoSync and permission settings</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;Result&lt;FileTree_2&lt;TCT&gt;&gt;&gt;
+
+Promise resolving to a FileTree with persistence capability

package/docs/classes/FileApiTreeAccessors.extractFileMetadata.md

@@ -0,0 +1,24 @@
+[Home](../README.md) > [FileApiTreeAccessors](./FileApiTreeAccessors.md) > extractFileMetadata
+
+## FileApiTreeAccessors.extractFileMetadata() method
+
+Extract file metadata from a File.
+
+**Signature:**
+
+```typescript
+static extractFileMetadata(file: File): IFileMetadata;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>file</td><td>File</td><td></td></tr>
+</tbody></table>
+
+**Returns:**
+
+[IFileMetadata](../interfaces/IFileMetadata.md)
+
+The IFileMetadata | file metadata

package/docs/classes/FileApiTreeAccessors.fromDirectoryUpload.md

@@ -0,0 +1,25 @@
+[Home](../README.md) > [FileApiTreeAccessors](./FileApiTreeAccessors.md) > fromDirectoryUpload
+
+## FileApiTreeAccessors.fromDirectoryUpload() method
+
+Create FileTree from directory upload with webkitRelativePath.
+
+**Signature:**
+
+```typescript
+static fromDirectoryUpload(fileList: FileList, params?: IFileTreeInitParams<TCT>): Promise<Result<FileTree_2<TCT>>>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>fileList</td><td>FileList</td><td>FileList from a directory upload (input with webkitdirectory)</td></tr>
+<tr><td>params</td><td>IFileTreeInitParams&lt;TCT&gt;</td><td>Optional `IFileTreeInitParams` for the file tree.</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;Result&lt;FileTree_2&lt;TCT&gt;&gt;&gt;
+
+Promise resolving to a FileTree with all content pre-loaded

package/docs/classes/FileApiTreeAccessors.fromFileList.md

@@ -0,0 +1,25 @@
+[Home](../README.md) > [FileApiTreeAccessors](./FileApiTreeAccessors.md) > fromFileList
+
+## FileApiTreeAccessors.fromFileList() method
+
+Create FileTree from FileList (e.g., from input[type="file"]).
+
+**Signature:**
+
+```typescript
+static fromFileList(fileList: FileList, params?: IFileTreeInitParams<TCT>): Promise<Result<FileTree_2<TCT>>>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>fileList</td><td>FileList</td><td>FileList from a file input element</td></tr>
+<tr><td>params</td><td>IFileTreeInitParams&lt;TCT&gt;</td><td>Optional `IFileTreeInitParams` for the file tree.</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;Result&lt;FileTree_2&lt;TCT&gt;&gt;&gt;
+
+Promise resolving to a FileTree with all content pre-loaded

package/docs/classes/FileApiTreeAccessors.getOriginalFile.md

@@ -0,0 +1,27 @@
+[Home](../README.md) > [FileApiTreeAccessors](./FileApiTreeAccessors.md) > getOriginalFile
+
+## FileApiTreeAccessors.getOriginalFile() method
+
+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.
+
+**Signature:**
+
+```typescript
+static getOriginalFile(fileList: FileList, targetPath: string): Result<File>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>fileList</td><td>FileList</td><td>The original FileList</td></tr>
+<tr><td>targetPath</td><td>string</td><td>The path to find</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Result&lt;File&gt;
+
+Result containing the File object if found

package/docs/classes/FileApiTreeAccessors.md

@@ -1,286 +1,172 @@
-[**@fgv/ts-web-extras**](../README.md)
+[Home](../README.md) > FileApiTreeAccessors
 
-***
-
-[@fgv/ts-web-extras](../README.md) / FileApiTreeAccessors
-
-# Class: FileApiTreeAccessors\<TCT\>
+# Class: FileApiTreeAccessors
 
 Helper class to create FileTree instances from various file sources.
 Supports File API (FileList) and File System Access API handles.
 
-## Type Parameters
-
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TCT` *extends* `string` | `string` |
-
 ## Constructors
 
-### Constructor
-
-> **new FileApiTreeAccessors**\<`TCT`\>(): `FileApiTreeAccessors`\<`TCT`\>
-
-#### Returns
-
-`FileApiTreeAccessors`\<`TCT`\>
-
-## Methods
-
-### create()
-
-> `static` **create**\<`TCT`\>(`initializers`, `params?`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
-
-Create FileTree from various file sources using TreeInitializer array.
-
-#### Type Parameters
-
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TCT` *extends* `string` | `string` |
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `initializers` | [`TreeInitializer`](../type-aliases/TreeInitializer.md)[] | Array of TreeInitializer objects specifying file sources |
-| `params?` | [`IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\> | Optional `IFileTreeInitParams` for the file tree. |
-
-#### Returns
+<table><thead><tr><th>
 
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
-
-Promise resolving to a FileTree with all content pre-loaded
-
-***
-
-### createFromHttp()
-
-> `static` **createFromHttp**\<`TCT`\>(`params`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
-
-Create a persistent FileTree from an HTTP storage service.
+Constructor
 
-#### Type Parameters
+</th><th>
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TCT` *extends* `string` | `string` |
+Modifiers
 
-#### Parameters
+</th><th>
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `params` | [`IHttpTreeParams`](../interfaces/IHttpTreeParams.md)\<`TCT`\> | Configuration including API base URL, namespace, and optional autoSync |
+Description
 
-#### Returns
+</th></tr></thead>
+<tbody>
+<tr><td>
 
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
+`constructor()`
 
-Promise resolving to a FileTree with persistence capability
+</td><td>
 
-***
 
-### createFromLocalStorage()
 
-> `static` **createFromLocalStorage**\<`TCT`\>(`params`): [`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>
+</td><td>
 
-Create a persistent FileTree from browser localStorage.
-Changes to files can be synced back to localStorage.
 
-#### Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TCT` *extends* `string` | `string` |
+</td></tr>
+</tbody></table>
 
-#### Parameters
+## Methods
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `params` | [`ILocalStorageTreeParams`](../interfaces/ILocalStorageTreeParams.md)\<`TCT`\> | Configuration including path-to-key mappings and optional autoSync |
+<table><thead><tr><th>
 
-#### Returns
+Method
 
-[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>
+</th><th>
 
-Result containing a FileTree with persistence capability
+Modifiers
 
-#### Remarks
+</th><th>
 
-- 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
+Description
 
-#### Example
+</th></tr></thead>
+<tbody>
+<tr><td>
 
-```typescript
-const tree = FileApiTreeAccessors.createFromLocalStorage({
-  pathToKeyMap: {
-    '/data/ingredients': 'myapp:ingredients:v1',
-    '/data/fillings': 'myapp:fillings:v1'
-  },
-  mutable: true,
-  autoSync: false
-});
-```
+[createPersistent(dirHandle, params)](./FileApiTreeAccessors.createPersistent.md)
 
-***
+</td><td>
 
-### createPersistent()
+`static`
 
-> `static` **createPersistent**\<`TCT`\>(`dirHandle`, `params?`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
+</td><td>
 
 Create a persistent FileTree from a File System Access API directory handle.
-Changes to files can be synced back to disk.
-
-#### Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TCT` *extends* `string` | `string` |
+</td></tr>
+<tr><td>
 
-#### Parameters
+[createFromHttp(params)](./FileApiTreeAccessors.createFromHttp.md)
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `dirHandle` | [`FileSystemDirectoryHandle`](../interfaces/FileSystemDirectoryHandle.md) | FileSystemDirectoryHandle to load files from |
-| `params?` | [`IFileSystemAccessTreeParams`](../interfaces/IFileSystemAccessTreeParams.md)\<`TCT`\> | Optional parameters including autoSync and permission settings |
+</td><td>
 
-#### Returns
+`static`
 
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
+</td><td>
 
-Promise resolving to a FileTree with persistence capability
+Create a persistent FileTree from an HTTP storage service.
 
-#### Remarks
+</td></tr>
+<tr><td>
 
-- 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)
+[createPersistentFromFile(fileHandle, params)](./FileApiTreeAccessors.createPersistentFromFile.md)
 
-***
+</td><td>
 
-### createPersistentFromFile()
+`static`
 
-> `static` **createPersistentFromFile**\<`TCT`\>(`fileHandle`, `params?`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
+</td><td>
 
 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()`.
-
-#### Type Parameters
-
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TCT` *extends* `string` | `string` |
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `fileHandle` | [`FileSystemFileHandle`](../interfaces/FileSystemFileHandle.md) | FileSystemFileHandle to load |
-| `params?` | [`IFileSystemAccessTreeParams`](../interfaces/IFileSystemAccessTreeParams.md)\<`TCT`\> | Optional parameters including autoSync and permission settings |
-
-#### Returns
-
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
-
-Promise resolving to a FileTree with persistence capability
-
-***
 
-### extractFileMetadata()
+</td></tr>
+<tr><td>
 
-> `static` **extractFileMetadata**(`file`): [`IFileMetadata`](../interfaces/IFileMetadata.md)
+[createFromLocalStorage(params)](./FileApiTreeAccessors.createFromLocalStorage.md)
 
-Extract file metadata from a File.
-
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `file` | `File` |
+</td><td>
 
-#### Returns
+`static`
 
-[`IFileMetadata`](../interfaces/IFileMetadata.md)
+</td><td>
 
-The [file metadata](../interfaces/IFileMetadata.md)
+Create a persistent FileTree from browser localStorage.
 
-***
+</td></tr>
+<tr><td>
 
-### fromDirectoryUpload()
+[create(initializers, params)](./FileApiTreeAccessors.create.md)
 
-> `static` **fromDirectoryUpload**\<`TCT`\>(`fileList`, `params?`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
+</td><td>
 
-Create FileTree from directory upload with webkitRelativePath.
+`static`
 
-#### Type Parameters
+</td><td>
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TCT` *extends* `string` | `string` |
+Create FileTree from various file sources using TreeInitializer array.
 
-#### Parameters
+</td></tr>
+<tr><td>
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `fileList` | `FileList` | FileList from a directory upload (input with webkitdirectory) |
-| `params?` | [`IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\> | Optional `IFileTreeInitParams` for the file tree. |
+[fromFileList(fileList, params)](./FileApiTreeAccessors.fromFileList.md)
 
-#### Returns
+</td><td>
 
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
+`static`
 
-Promise resolving to a FileTree with all content pre-loaded
+</td><td>
 
-***
+Create FileTree from FileList (e.g., from input[type="file"]).
 
-### fromFileList()
+</td></tr>
+<tr><td>
 
-> `static` **fromFileList**\<`TCT`\>(`fileList`, `params?`): `Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
+[fromDirectoryUpload(fileList, params)](./FileApiTreeAccessors.fromDirectoryUpload.md)
 
-Create FileTree from FileList (e.g., from input[type="file"]).
+</td><td>
 
-#### Type Parameters
+`static`
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TCT` *extends* `string` | `string` |
+</td><td>
 
-#### Parameters
+Create FileTree from directory upload with webkitRelativePath.
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `fileList` | `FileList` | FileList from a file input element |
-| `params?` | [`IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\> | Optional `IFileTreeInitParams` for the file tree. |
+</td></tr>
+<tr><td>
 
-#### Returns
+[getOriginalFile(fileList, targetPath)](./FileApiTreeAccessors.getOriginalFile.md)
 
-`Promise`\<[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<[`FileTree_2`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>\>\>
+</td><td>
 
-Promise resolving to a FileTree with all content pre-loaded
+`static`
 
-***
+</td><td>
 
-### getOriginalFile()
+Get the File object for a specific path from the original FileList.
 
-> `static` **getOriginalFile**(`fileList`, `targetPath`): [`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`File`\>
+</td></tr>
+<tr><td>
 
-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.
+[extractFileMetadata(file)](./FileApiTreeAccessors.extractFileMetadata.md)
 
-#### Parameters
+</td><td>
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `fileList` | `FileList` | The original FileList |
-| `targetPath` | `string` | The path to find |
+`static`
 
-#### Returns
+</td><td>
 
-[`Result`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-utils/docs)\<`File`\>
+Extract file metadata from a File.
 
-Result containing the File object if found
+</td></tr>
+</tbody></table>

package/docs/classes/FileSystemAccessTreeAccessors.deleteFile.md

@@ -0,0 +1,22 @@
+[Home](../README.md) > [FileSystemAccessTreeAccessors](./FileSystemAccessTreeAccessors.md) > deleteFile
+
+## FileSystemAccessTreeAccessors.deleteFile() method
+
+Override deleteFile to track pending deletions for syncToDisk.
+
+**Signature:**
+
+```typescript
+deleteFile(path: string): Result<boolean>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>path</td><td>string</td><td></td></tr>
+</tbody></table>
+
+**Returns:**
+
+Result&lt;boolean&gt;

package/docs/classes/FileSystemAccessTreeAccessors.fileIsMutable.md

@@ -0,0 +1,22 @@
+[Home](../README.md) > [FileSystemAccessTreeAccessors](./FileSystemAccessTreeAccessors.md) > fileIsMutable
+
+## FileSystemAccessTreeAccessors.fileIsMutable() method
+
+Implements `FileTree.IMutableFileTreeAccessors.fileIsMutable`
+
+**Signature:**
+
+```typescript
+fileIsMutable(path: string): DetailedResult<boolean, SaveDetail>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>path</td><td>string</td><td></td></tr>
+</tbody></table>
+
+**Returns:**
+
+DetailedResult&lt;boolean, SaveDetail&gt;

package/docs/classes/FileSystemAccessTreeAccessors.fromDirectoryHandle.md

@@ -0,0 +1,25 @@
+[Home](../README.md) > [FileSystemAccessTreeAccessors](./FileSystemAccessTreeAccessors.md) > fromDirectoryHandle
+
+## FileSystemAccessTreeAccessors.fromDirectoryHandle() method
+
+Creates a new FileSystemAccessTreeAccessors instance from a directory handle.
+
+**Signature:**
+
+```typescript
+static fromDirectoryHandle(dirHandle: FileSystemDirectoryHandle, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileSystemAccessTreeAccessors<TCT>>>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>dirHandle</td><td>FileSystemDirectoryHandle</td><td>The FileSystemDirectoryHandle to load files from.</td></tr>
+<tr><td>params</td><td>IFileSystemAccessTreeParams&lt;TCT&gt;</td><td>Optional parameters including autoSync and permission settings.</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;Result&lt;[FileSystemAccessTreeAccessors](FileSystemAccessTreeAccessors.md)&lt;TCT&gt;&gt;&gt;
+
+Promise resolving to a FileSystemAccessTreeAccessors instance.

package/docs/classes/FileSystemAccessTreeAccessors.fromFileHandle.md

@@ -0,0 +1,29 @@
+[Home](../README.md) > [FileSystemAccessTreeAccessors](./FileSystemAccessTreeAccessors.md) > fromFileHandle
+
+## FileSystemAccessTreeAccessors.fromFileHandle() method
+
+Creates a new FileSystemAccessTreeAccessors instance from a single file handle.
+
+The resulting tree contains exactly one file at `/<filename>`.
+`syncToDisk()` writes changes back to the original file via the File System Access API.
+New file creation is not supported on this tree (no parent directory handle).
+
+**Signature:**
+
+```typescript
+static fromFileHandle(fileHandle: FileSystemFileHandle, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileSystemAccessTreeAccessors<TCT>>>;
+```
+
+**Parameters:**
+
+<table><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead>
+<tbody>
+<tr><td>fileHandle</td><td>FileSystemFileHandle</td><td>The FileSystemFileHandle to load.</td></tr>
+<tr><td>params</td><td>IFileSystemAccessTreeParams&lt;TCT&gt;</td><td>Optional parameters including autoSync and permission settings.</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;Result&lt;[FileSystemAccessTreeAccessors](FileSystemAccessTreeAccessors.md)&lt;TCT&gt;&gt;&gt;
+
+Promise resolving to a FileSystemAccessTreeAccessors instance.