@fgv/ts-web-extras 5.1.0-0 → 5.1.0-2

package/docs/interfaces/FileSystemWritableFileStream.md

@@ -0,0 +1,127 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / FileSystemWritableFileStream
+
+# Interface: FileSystemWritableFileStream
+
+Writable file stream interface
+
+## Extends
+
+- `WritableStream`
+
+## Properties
+
+| Property | Modifier | Type | Description |
+| ------ | ------ | ------ | ------ |
+| <a id="locked"></a> `locked` | `readonly` | `boolean` | The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer. [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked) |
+
+## Methods
+
+### abort()
+
+> **abort**(`reason?`): `Promise`\<`void`\>
+
+The **`abort()`** method of the WritableStream interface aborts the stream, signaling that the producer can no longer successfully write to the stream and it is to be immediately moved to an error state, with any queued writes discarded.
+
+[MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/abort)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `reason?` | `any` |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Inherited from
+
+`WritableStream.abort`
+
+***
+
+### close()
+
+> **close**(): `Promise`\<`void`\>
+
+The **`close()`** method of the WritableStream interface closes the associated stream.
+
+[MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
+
+#### Returns
+
+`Promise`\<`void`\>
+
+#### Inherited from
+
+`WritableStream.close`
+
+***
+
+### getWriter()
+
+> **getWriter**(): `WritableStreamDefaultWriter`\<`any`\>
+
+The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
+
+[MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
+
+#### Returns
+
+`WritableStreamDefaultWriter`\<`any`\>
+
+#### Inherited from
+
+`WritableStream.getWriter`
+
+***
+
+### seek()
+
+> **seek**(`position`): `Promise`\<`void`\>
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `position` | `number` |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+### truncate()
+
+> **truncate**(`size`): `Promise`\<`void`\>
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `size` | `number` |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+### write()
+
+> **write**(`data`): `Promise`\<`void`\>
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `data` | `string` \| `BufferSource` \| `Blob` |
+
+#### Returns
+
+`Promise`\<`void`\>

package/docs/interfaces/IDirectoryHandleTreeInitializer.md

@@ -0,0 +1,17 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / IDirectoryHandleTreeInitializer
+
+# Interface: IDirectoryHandleTreeInitializer
+
+Tree initializer for File System Access API directory handles.
+
+## Properties
+
+| Property | Modifier | Type |
+| ------ | ------ | ------ |
+| <a id="dirhandles"></a> `dirHandles` | `readonly` | [`FileSystemDirectoryHandle`](FileSystemDirectoryHandle.md)[] |
+| <a id="nonrecursive"></a> `nonRecursive?` | `readonly` | `boolean` |
+| <a id="prefix"></a> `prefix?` | `readonly` | `string` |

package/docs/interfaces/IFileHandleTreeInitializer.md

@@ -0,0 +1,16 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / IFileHandleTreeInitializer
+
+# Interface: IFileHandleTreeInitializer
+
+Tree initializer for File System Access API file handles.
+
+## Properties
+
+| Property | Modifier | Type |
+| ------ | ------ | ------ |
+| <a id="filehandles"></a> `fileHandles` | `readonly` | [`FileSystemFileHandle`](FileSystemFileHandle.md)[] |
+| <a id="prefix"></a> `prefix?` | `readonly` | `string` |

package/docs/interfaces/IFileListTreeInitializer.md

@@ -0,0 +1,15 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / IFileListTreeInitializer
+
+# Interface: IFileListTreeInitializer
+
+Tree initializer for FileList objects (from File API).
+
+## Properties
+
+| Property | Modifier | Type |
+| ------ | ------ | ------ |
+| <a id="filelist"></a> `fileList` | `readonly` | `FileList` |

package/docs/interfaces/IFileMetadata.md

@@ -0,0 +1,19 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / IFileMetadata
+
+# Interface: IFileMetadata
+
+Interface for file metadata.
+
+## Properties
+
+| Property | Type |
+| ------ | ------ |
+| <a id="lastmodified"></a> `lastModified` | `number` |
+| <a id="name"></a> `name` | `string` |
+| <a id="path"></a> `path` | `string` |
+| <a id="size"></a> `size` | `number` |
+| <a id="type"></a> `type` | `string` |

package/docs/interfaces/IFileSystemAccessTreeParams.md

@@ -0,0 +1,30 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / IFileSystemAccessTreeParams
+
+# Interface: IFileSystemAccessTreeParams\<TCT\>
+
+Options for creating persistent file trees.
+
+## Extends
+
+- [`IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>
+
+## Type Parameters
+
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TCT` *extends* `string` | `string` |
+
+## Properties
+
+| Property | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| <a id="autosync"></a> `autoSync?` | `boolean` | `false` | Automatically sync changes to disk immediately after each save. If false, changes are batched and written on explicit syncToDisk() call. |
+| <a id="filepath"></a> `filePath?` | `string` | `undefined` | Override the path at which the file is stored in the tree (for fromFileHandle). Must be an absolute path (e.g., '/data/confections/common.yaml'). If omitted, defaults to `/<filename>`. |
+| <a id="infercontenttype"></a> `inferContentType?` | [`ContentTypeFactory`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\> | `undefined` | - |
+| <a id="mutable"></a> `mutable?` | `boolean` \| [`IFilterSpec`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs) | `undefined` | Controls mutability of the file tree. - `undefined` or `false`: No files are mutable. - `true`: All files are mutable. - `IFilterSpec`: Only files matching the filter are mutable. |
+| <a id="prefix"></a> `prefix?` | `string` | `undefined` | - |
+| <a id="requirewritepermission"></a> `requireWritePermission?` | `boolean` | `true` | Require write permission on the directory handle. If true, fails if write permission cannot be obtained. If false, falls back to read-only mode. |

package/docs/interfaces/IFsAccessApis.md

@@ -0,0 +1,57 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / IFsAccessApis
+
+# Interface: IFsAccessApis
+
+File System Access API methods available on Window
+
+## Methods
+
+### showDirectoryPicker()
+
+> **showDirectoryPicker**(`options?`): `Promise`\<[`FileSystemDirectoryHandle`](FileSystemDirectoryHandle.md)\>
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `options?` | [`ShowDirectoryPickerOptions`](ShowDirectoryPickerOptions.md) |
+
+#### Returns
+
+`Promise`\<[`FileSystemDirectoryHandle`](FileSystemDirectoryHandle.md)\>
+
+***
+
+### showOpenFilePicker()
+
+> **showOpenFilePicker**(`options?`): `Promise`\<[`FileSystemFileHandle`](FileSystemFileHandle.md)[]\>
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `options?` | [`ShowOpenFilePickerOptions`](ShowOpenFilePickerOptions.md) |
+
+#### Returns
+
+`Promise`\<[`FileSystemFileHandle`](FileSystemFileHandle.md)[]\>
+
+***
+
+### showSaveFilePicker()
+
+> **showSaveFilePicker**(`options?`): `Promise`\<[`FileSystemFileHandle`](FileSystemFileHandle.md)\>
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `options?` | [`ShowSaveFilePickerOptions`](ShowSaveFilePickerOptions.md) |
+
+#### Returns
+
+`Promise`\<[`FileSystemFileHandle`](FileSystemFileHandle.md)\>

package/docs/interfaces/IHttpTreeParams.md

@@ -0,0 +1,32 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / IHttpTreeParams
+
+# Interface: IHttpTreeParams\<TCT\>
+
+Configuration for creating HTTP-backed tree accessors.
+
+## Extends
+
+- [`IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>
+
+## Type Parameters
+
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TCT` *extends* `string` | `string` |
+
+## Properties
+
+| Property | Modifier | Type | Description |
+| ------ | ------ | ------ | ------ |
+| <a id="autosync"></a> `autoSync?` | `readonly` | `boolean` | - |
+| <a id="baseurl"></a> `baseUrl` | `readonly` | `string` | - |
+| <a id="fetchimpl"></a> `fetchImpl?` | `readonly` | \{(`input`, `init?`): `Promise`\<`Response`\>; (`input`, `init?`): `Promise`\<`Response`\>; \} | - |
+| <a id="infercontenttype"></a> `inferContentType?` | `public` | [`ContentTypeFactory`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\> | - |
+| <a id="mutable"></a> `mutable?` | `public` | `boolean` \| [`IFilterSpec`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs) | Controls mutability of the file tree. - `undefined` or `false`: No files are mutable. - `true`: All files are mutable. - `IFilterSpec`: Only files matching the filter are mutable. |
+| <a id="namespace"></a> `namespace?` | `readonly` | `string` | - |
+| <a id="prefix"></a> `prefix?` | `public` | `string` | - |
+| <a id="userid"></a> `userId?` | `readonly` | `string` | - |

package/docs/interfaces/ILocalStorageTreeParams.md

@@ -0,0 +1,30 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / ILocalStorageTreeParams
+
+# Interface: ILocalStorageTreeParams\<TCT\>
+
+Configuration for LocalStorageTreeAccessors.
+
+## Extends
+
+- [`IFileTreeInitParams`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\>
+
+## Type Parameters
+
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TCT` *extends* `string` | `string` |
+
+## Properties
+
+| Property | Type | Description |
+| ------ | ------ | ------ |
+| <a id="autosync"></a> `autoSync?` | `boolean` | If true, automatically sync changes to localStorage on every modification. If false (default), changes are only synced when syncToDisk() is called. |
+| <a id="infercontenttype"></a> `inferContentType?` | [`ContentTypeFactory`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs)\<`TCT`\> | - |
+| <a id="mutable"></a> `mutable?` | `boolean` \| [`IFilterSpec`](https://github.com/ErikFortune/fgv/tree/main/libraries/ts-json-base/docs) | Controls mutability of the file tree. - `undefined` or `false`: No files are mutable. - `true`: All files are mutable. - `IFilterSpec`: Only files matching the filter are mutable. |
+| <a id="pathtokeymap"></a> `pathToKeyMap` | `Record`\<`string`, `string`\> | Map of directory path prefixes to localStorage keys. Files under each prefix are stored in the corresponding localStorage key. Example: { '/data/ingredients': 'myapp:ingredients:v1' } |
+| <a id="prefix"></a> `prefix?` | `string` | - |
+| <a id="storage"></a> `storage?` | `Storage` | Storage instance to use. Defaults to window.localStorage. Can be overridden for testing with mock storage. |

package/docs/interfaces/IUrlConfigOptions.md

@@ -0,0 +1,27 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / IUrlConfigOptions
+
+# Interface: IUrlConfigOptions
+
+Configuration options that can be passed via URL parameters
+
+## Properties
+
+| Property | Type | Description |
+| ------ | ------ | ------ |
+| <a id="config"></a> `config?` | `string` | Configuration name or path |
+| <a id="configstartdir"></a> `configStartDir?` | `string` | Starting directory for config file picker (derived from config path) |
+| <a id="contextfilter"></a> `contextFilter?` | `string` | Context filter token (pipe-separated) |
+| <a id="input"></a> `input?` | `string` | Input file path |
+| <a id="inputstartdir"></a> `inputStartDir?` | `string` | Starting directory for input file picker (derived from input path) |
+| <a id="interactive"></a> `interactive?` | `boolean` | Whether to launch in interactive mode |
+| <a id="loadzip"></a> `loadZip?` | `boolean` | Whether to use ZIP loading mode |
+| <a id="maxdistance"></a> `maxDistance?` | `number` | Maximum distance for language matching |
+| <a id="qualifierdefaults"></a> `qualifierDefaults?` | `string` | Qualifier defaults token (pipe-separated) |
+| <a id="reducequalifiers"></a> `reduceQualifiers?` | `boolean` | Whether to reduce qualifiers |
+| <a id="resourcetypes"></a> `resourceTypes?` | `string` | Resource types filter (comma-separated) |
+| <a id="zipfile"></a> `zipFile?` | `string` | Name of ZIP file to load from Downloads (filename only) |
+| <a id="zippath"></a> `zipPath?` | `string` | Path to ZIP file to load (for CLI-generated ZIPs) |

package/docs/interfaces/ShowDirectoryPickerOptions.md

@@ -0,0 +1,17 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / ShowDirectoryPickerOptions
+
+# Interface: ShowDirectoryPickerOptions
+
+Directory picker options
+
+## Properties
+
+| Property | Type |
+| ------ | ------ |
+| <a id="id"></a> `id?` | `string` |
+| <a id="mode"></a> `mode?` | `"readwrite"` \| `"read"` |
+| <a id="startin"></a> `startIn?` | [`FileSystemHandle`](FileSystemHandle.md) \| [`WellKnownDirectory`](../type-aliases/WellKnownDirectory.md) |

package/docs/interfaces/ShowOpenFilePickerOptions.md

@@ -0,0 +1,19 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / ShowOpenFilePickerOptions
+
+# Interface: ShowOpenFilePickerOptions
+
+File picker options
+
+## Properties
+
+| Property | Type |
+| ------ | ------ |
+| <a id="excludeacceptalloption"></a> `excludeAcceptAllOption?` | `boolean` |
+| <a id="id"></a> `id?` | `string` |
+| <a id="multiple"></a> `multiple?` | `boolean` |
+| <a id="startin"></a> `startIn?` | [`FileSystemHandle`](FileSystemHandle.md) \| [`WellKnownDirectory`](../type-aliases/WellKnownDirectory.md) |
+| <a id="types"></a> `types?` | [`FilePickerAcceptType`](FilePickerAcceptType.md)[] |

package/docs/interfaces/ShowSaveFilePickerOptions.md

@@ -0,0 +1,19 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / ShowSaveFilePickerOptions
+
+# Interface: ShowSaveFilePickerOptions
+
+Save file picker options
+
+## Properties
+
+| Property | Type |
+| ------ | ------ |
+| <a id="excludeacceptalloption"></a> `excludeAcceptAllOption?` | `boolean` |
+| <a id="id"></a> `id?` | `string` |
+| <a id="startin"></a> `startIn?` | [`FileSystemHandle`](FileSystemHandle.md) \| [`WellKnownDirectory`](../type-aliases/WellKnownDirectory.md) |
+| <a id="suggestedname"></a> `suggestedName?` | `string` |
+| <a id="types"></a> `types?` | [`FilePickerAcceptType`](FilePickerAcceptType.md)[] |

package/docs/type-aliases/TreeInitializer.md

@@ -0,0 +1,11 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / TreeInitializer
+
+# Type Alias: TreeInitializer
+
+> **TreeInitializer** = [`IFileListTreeInitializer`](../interfaces/IFileListTreeInitializer.md) \| [`IFileHandleTreeInitializer`](../interfaces/IFileHandleTreeInitializer.md) \| [`IDirectoryHandleTreeInitializer`](../interfaces/IDirectoryHandleTreeInitializer.md)
+
+Union type for all supported tree initializers.

package/docs/type-aliases/WellKnownDirectory.md

@@ -0,0 +1,11 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / WellKnownDirectory
+
+# Type Alias: WellKnownDirectory
+
+> **WellKnownDirectory** = `"desktop"` \| `"documents"` \| `"downloads"` \| `"music"` \| `"pictures"` \| `"videos"`
+
+Well-known directory type

package/docs/type-aliases/WindowWithFsAccess.md

@@ -0,0 +1,11 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / WindowWithFsAccess
+
+# Type Alias: WindowWithFsAccess
+
+> **WindowWithFsAccess** = `Window` & [`IFsAccessApis`](../interfaces/IFsAccessApis.md)
+
+Window interface extended with File System Access API

package/docs/variables/DEFAULT_DIRECTORY_HANDLE_DB.md

@@ -0,0 +1,11 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / DEFAULT\_DIRECTORY\_HANDLE\_DB
+
+# Variable: DEFAULT\_DIRECTORY\_HANDLE\_DB
+
+> `const` **DEFAULT\_DIRECTORY\_HANDLE\_DB**: `"chocolate-lab-storage"` = `'chocolate-lab-storage'`
+
+Default IndexedDB database name for directory handles.

package/docs/variables/DEFAULT_DIRECTORY_HANDLE_STORE.md

@@ -0,0 +1,11 @@
+[**@fgv/ts-web-extras**](../README.md)
+
+***
+
+[@fgv/ts-web-extras](../README.md) / DEFAULT\_DIRECTORY\_HANDLE\_STORE
+
+# Variable: DEFAULT\_DIRECTORY\_HANDLE\_STORE
+
+> `const` **DEFAULT\_DIRECTORY\_HANDLE\_STORE**: `"directory-handles"` = `'directory-handles'`
+
+Default IndexedDB store name for directory handles.

package/etc/ts-web-extras.api.md

@@ -7,6 +7,7 @@
 import { CryptoUtils as CryptoUtils_2 } from '@fgv/ts-extras';
 import { DetailedResult } from '@fgv/ts-utils';
 import { FileTree } from '@fgv/ts-json-base';
+import { Logging } from '@fgv/ts-utils';
 import { Result } from '@fgv/ts-utils';
 
 // Warning: (ae-forgotten-export) The symbol "ICryptoProvider" needs to be exported by the entry point index.d.ts
@@ -85,6 +86,7 @@ function extractFileMetadata(file: File): IFileMetadata;
 // @public
 export class FileApiTreeAccessors<TCT extends string = string> {
     static create<TCT extends string = string>(initializers: TreeInitializer[], params?: FileTree.IFileTreeInitParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    static createFromHttp<TCT extends string = string>(params: IHttpTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
     static createFromLocalStorage<TCT extends string = string>(params: ILocalStorageTreeParams<TCT>): Result<FileTree.FileTree<TCT>>;
     static createPersistent<TCT extends string = string>(dirHandle: FileSystemDirectoryHandle_2, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
     static createPersistentFromFile<TCT extends string = string>(fileHandle: FileSystemFileHandle_2, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
@@ -105,6 +107,7 @@ export interface FilePickerAcceptType {
 // @public
 export class FileSystemAccessTreeAccessors<TCT extends string = string> extends FileTree.InMemoryTreeAccessors<TCT> implements FileTree.IPersistentFileTreeAccessors<TCT> {
     protected constructor(files: FileTree.IInMemoryFile<TCT>[], rootDir: FileSystemDirectoryHandle_2, handles: Map<string, FileSystemFileHandle_2>, params: IFileSystemAccessTreeParams<TCT> | undefined, hasWritePermission: boolean);
+    deleteFile(path: string): Result<boolean>;
     fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail>;
     static fromDirectoryHandle<TCT extends string = string>(dirHandle: FileSystemDirectoryHandle_2, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileSystemAccessTreeAccessors<TCT>>>;
     static fromFileHandle<TCT extends string = string>(fileHandle: FileSystemFileHandle_2, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileSystemAccessTreeAccessors<TCT>>>;
@@ -228,6 +231,18 @@ function fromFileList(fileList: FileList, params?: FileTree.IFileTreeInitParams<
 // @public
 function getOriginalFile(fileList: FileList, path: string): Result<File>;
 
+// @public
+export class HttpTreeAccessors<TCT extends string = string> extends FileTree.InMemoryTreeAccessors<TCT> implements FileTree.IPersistentFileTreeAccessors<TCT> {
+    // (undocumented)
+    deleteFile(path: string): Result<boolean>;
+    fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail>;
+    static fromHttp<TCT extends string = string>(params: IHttpTreeParams<TCT>): Promise<Result<HttpTreeAccessors<TCT>>>;
+    getDirtyPaths(): string[];
+    isDirty(): boolean;
+    saveFileContents(path: string, contents: string): Result<string>;
+    syncToDisk(): Promise<Result<void>>;
+}
+
 // @public
 export interface IDirectoryHandleTreeInitializer {
     // (undocumented)
@@ -270,6 +285,7 @@ export interface IFileMetadata {
 export interface IFileSystemAccessTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {
     autoSync?: boolean;
     filePath?: string;
+    logger?: Logging.LogReporter<unknown>;
     requireWritePermission?: boolean;
 }
 
@@ -283,6 +299,22 @@ export interface IFsAccessApis {
     showSaveFilePicker(options?: ShowSaveFilePickerOptions): Promise<FileSystemFileHandle_2>;
 }
 
+// @public
+export interface IHttpTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {
+    // (undocumented)
+    readonly autoSync?: boolean;
+    // (undocumented)
+    readonly baseUrl: string;
+    // (undocumented)
+    readonly fetchImpl?: typeof fetch;
+    // (undocumented)
+    readonly logger?: Logging.LogReporter<unknown>;
+    // (undocumented)
+    readonly namespace?: string;
+    // (undocumented)
+    readonly userId?: string;
+}
+
 // @public
 export interface ILocalStorageTreeParams<TCT extends string = string> extends FileTree.IFileTreeInitParams<TCT> {
     autoSync?: boolean;
@@ -318,6 +350,7 @@ export interface IUrlConfigOptions {
 
 // @public
 export class LocalStorageTreeAccessors<TCT extends string = string> extends FileTree.InMemoryTreeAccessors<TCT> implements FileTree.IPersistentFileTreeAccessors<TCT> {
+    deleteFile(path: string): Result<boolean>;
     fileIsMutable(path: string): DetailedResult<boolean, FileTree.SaveDetail>;
     static fromStorage<TCT extends string = string>(params: ILocalStorageTreeParams<TCT>): Result<LocalStorageTreeAccessors<TCT>>;
     getDirtyPaths(): string[];

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

@@ -2,6 +2,7 @@ import { Result } from '@fgv/ts-utils';
 import { FileTree } from '@fgv/ts-json-base';
 import { FileSystemFileHandle, FileSystemDirectoryHandle } from '../file-api-types';
 import { IFileSystemAccessTreeParams } from './fileSystemAccessTreeAccessors';
+import { IHttpTreeParams } from './httpTreeAccessors';
 import { ILocalStorageTreeParams } from './localStorageTreeAccessors';
 /**
  * Tree initializer for FileList objects (from File API).
@@ -65,6 +66,14 @@ export declare class FileApiTreeAccessors<TCT extends string = string> {
      * @public
      */
     static createPersistent<TCT extends string = string>(dirHandle: FileSystemDirectoryHandle, params?: IFileSystemAccessTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
+    /**
+     * Create a persistent FileTree from an HTTP storage service.
+     *
+     * @param params - Configuration including API base URL, namespace, and optional autoSync
+     * @returns Promise resolving to a FileTree with persistence capability
+     * @public
+     */
+    static createFromHttp<TCT extends string = string>(params: IHttpTreeParams<TCT>): Promise<Result<FileTree.FileTree<TCT>>>;
     /**
      * Create a persistent FileTree from a single File System Access API file handle.
      * The tree contains exactly one file at `/<filename>`.

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

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

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

@@ -34,6 +34,7 @@ const ts_utils_1 = require("@fgv/ts-utils");
 const ts_json_base_1 = require("@fgv/ts-json-base");
 const file_api_types_1 = require("../file-api-types");
 const fileSystemAccessTreeAccessors_1 = require("./fileSystemAccessTreeAccessors");
+const httpTreeAccessors_1 = require("./httpTreeAccessors");
 const localStorageTreeAccessors_1 = require("./localStorageTreeAccessors");
 /**
  * Helper function to safely get webkitRelativePath from a File object.
@@ -70,6 +71,20 @@ class FileApiTreeAccessors {
         }
         return ts_json_base_1.FileTree.FileTree.create(accessorsResult.value);
     }
+    /**
+     * Create a persistent FileTree from an HTTP storage service.
+     *
+     * @param params - Configuration including API base URL, namespace, and optional autoSync
+     * @returns Promise resolving to a FileTree with persistence capability
+     * @public
+     */
+    static async createFromHttp(params) {
+        const accessorsResult = await httpTreeAccessors_1.HttpTreeAccessors.fromHttp(params);
+        if (accessorsResult.isFailure()) {
+            return (0, ts_utils_1.fail)(accessorsResult.message);
+        }
+        return ts_json_base_1.FileTree.FileTree.create(accessorsResult.value);
+    }
     /**
      * Create a persistent FileTree from a single File System Access API file handle.
      * The tree contains exactly one file at `/<filename>`.