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

package/temp/ts-web-extras.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.54.0",
+    "toolVersion": "7.57.6",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -114,6 +114,22 @@
           "tagName": "@virtual",
           "syntaxKind": "modifier"
         },
+        {
+          "tagName": "@jsx",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxRuntime",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxFrag",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxImportSource",
+          "syntaxKind": "block"
+        },
         {
           "tagName": "@betaDocumentation",
           "syntaxKind": "modifier"
@@ -172,38 +188,936 @@
       "name": "",
       "preserveMemberOrder": false,
       "members": [
+        {
+          "kind": "Namespace",
+          "canonicalReference": "@fgv/ts-web-extras!CryptoUtils:namespace",
+          "docComment": "",
+          "excerptTokens": [],
+          "fileUrlPath": "src/index.ts",
+          "releaseTag": "None",
+          "name": "CryptoUtils",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Class",
+              "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider:class",
+              "docComment": "/**\n * Browser implementation of `ICryptoProvider` using the Web Crypto API. Uses AES-256-GCM for authenticated encryption.\n *\n * Note: This provider requires a browser environment with Web Crypto API support. In Node.js 15+, Web Crypto is available via globalThis.crypto or require('crypto').webcrypto.\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "export declare class BrowserCryptoProvider implements "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ICryptoProvider",
+                  "canonicalReference": "@fgv/ts-web-extras!~ICryptoProvider:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": " "
+                }
+              ],
+              "fileUrlPath": "src/packlets/crypto-utils/browserCryptoProvider.ts",
+              "releaseTag": "Public",
+              "isAbstract": false,
+              "name": "BrowserCryptoProvider",
+              "preserveMemberOrder": false,
+              "members": [
+                {
+                  "kind": "Constructor",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider:constructor(1)",
+                  "docComment": "/**\n * Creates a new {@link CryptoUtils.BrowserCryptoProvider | BrowserCryptoProvider}.\n *\n * @param cryptoApi - Optional Crypto instance (defaults to globalThis.crypto)\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "constructor(cryptoApi?: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Crypto",
+                      "canonicalReference": "!Crypto:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ");"
+                    }
+                  ],
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "cryptoApi",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": true
+                    }
+                  ]
+                },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#decrypt:member(1)",
+                  "docComment": "/**\n * Decrypts ciphertext using AES-256-GCM.\n *\n * @param encryptedData - Encrypted bytes\n *\n * @param key - 32-byte decryption key\n *\n * @param iv - Initialization vector (12 bytes)\n *\n * @param authTag - GCM authentication tag (16 bytes)\n *\n * @returns `Success` with decrypted UTF-8 string, or `Failure` with an error.\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "decrypt(encryptedData: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", key: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", iv: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", authTag: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<string>>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 9,
+                    "endIndex": 13
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "encryptedData",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "key",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 3,
+                        "endIndex": 4
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "iv",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 5,
+                        "endIndex": 6
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "authTag",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 7,
+                        "endIndex": 8
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "decrypt"
+                },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#deriveKey:member(1)",
+                  "docComment": "/**\n * Derives a key from a password using PBKDF2.\n *\n * @param password - Password string\n *\n * @param salt - Salt bytes (should be at least 16 bytes)\n *\n * @param iterations - Number of iterations (recommend 100000+)\n *\n * @returns Success with derived 32-byte key, or Failure with error\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "deriveKey(password: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", salt: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", iterations: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "number"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ">>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 13
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "password",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "salt",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 3,
+                        "endIndex": 4
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "iterations",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 5,
+                        "endIndex": 6
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "deriveKey"
+                },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#encrypt:member(1)",
+                  "docComment": "/**\n * Encrypts plaintext using AES-256-GCM.\n *\n * @param plaintext - UTF-8 string to encrypt\n *\n * @param key - 32-byte encryption key\n *\n * @returns `Success` with encryption result, or `Failure` with an error.\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "encrypt(plaintext: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", key: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "IEncryptionResult",
+                      "canonicalReference": "@fgv/ts-web-extras!~IEncryptionResult:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ">>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 11
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "plaintext",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "key",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 3,
+                        "endIndex": 4
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "encrypt"
+                },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#fromBase64:member(1)",
+                  "docComment": "/**\n * Decodes base64 string to binary data.\n *\n * @param base64 - Base64-encoded string\n *\n * @returns Success with decoded bytes, or Failure if invalid base64\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "fromBase64(base64: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ">"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 7
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "base64",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "fromBase64"
+                },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#generateKey:member(1)",
+                  "docComment": "/**\n * Generates a random 32-byte key suitable for AES-256.\n *\n * @returns Success with generated key, or Failure with error\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "generateKey(): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ">>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 7
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "generateKey"
+                },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#generateRandomBytes:member(1)",
+                  "docComment": "/**\n * Generates cryptographically secure random bytes.\n *\n * @param length - Number of bytes to generate\n *\n * @returns Success with random bytes, or Failure with error\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "generateRandomBytes(length: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "number"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ">"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 7
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "length",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "generateRandomBytes"
+                },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider#toBase64:member(1)",
+                  "docComment": "/**\n * Encodes binary data to base64 string.\n *\n * @param data - Binary data to encode\n *\n * @returns Base64-encoded string\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "toBase64(data: "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Uint8Array",
+                      "canonicalReference": "!Uint8Array:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "data",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "toBase64"
+                }
+              ],
+              "implementsTokenRanges": [
+                {
+                  "startIndex": 1,
+                  "endIndex": 2
+                }
+              ]
+            },
+            {
+              "kind": "Class",
+              "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserHashProvider:class",
+              "docComment": "/**\n * Browser-compatible hash provider using the Web Crypto API. Supports common hash algorithms available in browsers.\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "export declare class BrowserHashProvider "
+                }
+              ],
+              "fileUrlPath": "src/packlets/crypto-utils/browserHashProvider.ts",
+              "releaseTag": "Public",
+              "isAbstract": false,
+              "name": "BrowserHashProvider",
+              "preserveMemberOrder": false,
+              "members": [
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserHashProvider.hashParts:member(1)",
+                  "docComment": "/**\n * Hash multiple strings concatenated with a separator.\n *\n * @param parts - Array of strings to concatenate and hash\n *\n * @param algorithm - The hash algorithm to use\n *\n * @param separator - Separator to use between parts (default: '|')\n *\n * @returns Promise resolving to the hex-encoded hash\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "static hashParts(parts: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string[]"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", algorithm?: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", separator?: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<string>>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": true,
+                  "returnTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 11
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "parts",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "algorithm",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 3,
+                        "endIndex": 4
+                      },
+                      "isOptional": true
+                    },
+                    {
+                      "parameterName": "separator",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 5,
+                        "endIndex": 6
+                      },
+                      "isOptional": true
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "hashParts"
+                },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserHashProvider.hashString:member(1)",
+                  "docComment": "/**\n * Hash a string using the specified algorithm.\n *\n * @param data - The string to hash\n *\n * @param algorithm - The hash algorithm to use\n *\n * @returns Promise resolving to the hex-encoded hash\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "static hashString(data: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ", algorithm?: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "string"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Promise",
+                      "canonicalReference": "!Promise:interface"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<"
+                    },
+                    {
+                      "kind": "Reference",
+                      "text": "Result",
+                      "canonicalReference": "@fgv/ts-utils!Result:type"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "<string>>"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": true,
+                  "returnTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 9
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "data",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    },
+                    {
+                      "parameterName": "algorithm",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 3,
+                        "endIndex": 4
+                      },
+                      "isOptional": true
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "hashString"
+                }
+              ],
+              "implementsTokenRanges": []
+            },
+            {
+              "kind": "Function",
+              "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.createBrowserCryptoProvider:function(1)",
+              "docComment": "/**\n * Creates a {@link CryptoUtils.BrowserCryptoProvider | BrowserCryptoProvider} if Web Crypto API is available.\n *\n * @returns `Success` with provider, or `Failure` if not available\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "export declare function createBrowserCryptoProvider(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "BrowserCryptoProvider",
+                  "canonicalReference": "@fgv/ts-web-extras!CryptoUtils.BrowserCryptoProvider:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "fileUrlPath": "src/packlets/crypto-utils/browserCryptoProvider.ts",
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [],
+              "name": "createBrowserCryptoProvider"
+            }
+          ]
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@fgv/ts-web-extras!DEFAULT_DIRECTORY_HANDLE_DB:var",
+          "docComment": "/**\n * Default IndexedDB database name for directory handles.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "DEFAULT_DIRECTORY_HANDLE_DB = "
+            },
+            {
+              "kind": "Content",
+              "text": "\"chocolate-lab-storage\""
+            }
+          ],
+          "fileUrlPath": "src/packlets/file-tree/directoryHandleStore.ts",
+          "initializerTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "DEFAULT_DIRECTORY_HANDLE_DB",
+          "variableTypeTokenRange": {
+            "startIndex": 0,
+            "endIndex": 0
+          }
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@fgv/ts-web-extras!DEFAULT_DIRECTORY_HANDLE_STORE:var",
+          "docComment": "/**\n * Default IndexedDB store name for directory handles.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "DEFAULT_DIRECTORY_HANDLE_STORE = "
+            },
+            {
+              "kind": "Content",
+              "text": "\"directory-handles\""
+            }
+          ],
+          "fileUrlPath": "src/packlets/file-tree/directoryHandleStore.ts",
+          "initializerTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "DEFAULT_DIRECTORY_HANDLE_STORE",
+          "variableTypeTokenRange": {
+            "startIndex": 0,
+            "endIndex": 0
+          }
+        },
         {
           "kind": "Class",
-          "canonicalReference": "@fgv/ts-web-extras!BrowserHashProvider:class",
-          "docComment": "/**\n * Browser-compatible hash provider using the Web Crypto API. Supports common hash algorithms available in browsers.\n *\n * @public\n */\n",
+          "canonicalReference": "@fgv/ts-web-extras!DirectoryHandleStore:class",
+          "docComment": "/**\n * Manages persistence of {@link FileSystemDirectoryHandle} objects in IndexedDB. Keyed by a label (typically the directory name).\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export declare class BrowserHashProvider "
+              "text": "export declare class DirectoryHandleStore "
             }
           ],
-          "fileUrlPath": "src/packlets/crypto/browserHashProvider.ts",
+          "fileUrlPath": "src/packlets/file-tree/directoryHandleStore.ts",
           "releaseTag": "Public",
           "isAbstract": false,
-          "name": "BrowserHashProvider",
+          "name": "DirectoryHandleStore",
           "preserveMemberOrder": false,
           "members": [
             {
-              "kind": "Method",
-              "canonicalReference": "@fgv/ts-web-extras!BrowserHashProvider.hashParts:member(1)",
-              "docComment": "/**\n * Hash multiple strings concatenated with a separator.\n *\n * @param parts - Array of strings to concatenate and hash\n *\n * @param algorithm - The hash algorithm to use\n *\n * @param separator - Separator to use between parts (default: '|')\n *\n * @returns Promise resolving to the hex-encoded hash\n */\n",
+              "kind": "Constructor",
+              "canonicalReference": "@fgv/ts-web-extras!DirectoryHandleStore:constructor(1)",
+              "docComment": "/**\n * Constructs a new instance of the `DirectoryHandleStore` class\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "static hashParts(parts: "
+                  "text": "constructor(dbName?: "
                 },
                 {
                   "kind": "Content",
-                  "text": "string[]"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": ", algorithm?: "
+                  "text": ", storeName?: "
                 },
                 {
                   "kind": "Content",
@@ -211,15 +1125,39 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ", separator?: "
-                },
+                  "text": ");"
+                }
+              ],
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
                 {
-                  "kind": "Content",
-                  "text": "string"
+                  "parameterName": "dbName",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
                 },
+                {
+                  "parameterName": "storeName",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ]
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!DirectoryHandleStore#getAll:member(1)",
+              "docComment": "/**\n * Returns all stored handles as label/handle pairs.\n *\n * @returns Success with array of entries, or Failure\n */\n",
+              "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "): "
+                  "text": "getAll(): "
                 },
                 {
                   "kind": "Reference",
@@ -237,67 +1175,97 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "<string>>"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Array",
+                  "canonicalReference": "!Array:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<{\n        label: string;\n        handle: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemDirectoryHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemDirectoryHandle_2:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n    }>>>"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isStatic": true,
+              "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 7,
-                "endIndex": 11
+                "startIndex": 1,
+                "endIndex": 9
               },
               "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getAll"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!DirectoryHandleStore#getAllLabels:member(1)",
+              "docComment": "/**\n * Returns all stored labels (keys).\n *\n * @returns Success with array of labels, or Failure\n */\n",
+              "excerptTokens": [
                 {
-                  "parameterName": "parts",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
+                  "kind": "Content",
+                  "text": "getAllLabels(): "
                 },
                 {
-                  "parameterName": "algorithm",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 3,
-                    "endIndex": 4
-                  },
-                  "isOptional": true
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
                 },
                 {
-                  "parameterName": "separator",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 5,
-                    "endIndex": 6
-                  },
-                  "isOptional": true
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string[]>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
                 }
               ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "hashParts"
+              "name": "getAllLabels"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@fgv/ts-web-extras!BrowserHashProvider.hashString:member(1)",
-              "docComment": "/**\n * Hash a string using the specified algorithm.\n *\n * @param data - The string to hash\n *\n * @param algorithm - The hash algorithm to use\n *\n * @returns Promise resolving to the hex-encoded hash\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!DirectoryHandleStore#load:member(1)",
+              "docComment": "/**\n * Retrieves a directory handle by label.\n *\n * @param label - Key to look up\n *\n * @returns Success with handle (or undefined if not found), or Failure on error\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "static hashString(data: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", algorithm?: "
+                  "text": "load(label: "
                 },
                 {
                   "kind": "Content",
@@ -323,16 +1291,25 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "<string>>"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemDirectoryHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemDirectoryHandle_2:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined>>"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isStatic": true,
+              "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 5,
+                "startIndex": 3,
                 "endIndex": 9
               },
               "releaseTag": "Public",
@@ -340,7 +1317,140 @@
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "data",
+                  "parameterName": "label",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "load"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!DirectoryHandleStore#remove:member(1)",
+              "docComment": "/**\n * Removes a directory handle from IndexedDB.\n *\n * @param label - Key to remove\n *\n * @returns Success or Failure\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "remove(label: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "label",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "remove"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!DirectoryHandleStore#save:member(1)",
+              "docComment": "/**\n * Saves a directory handle to IndexedDB under the given label.\n *\n * @param label - Key to store the handle under (typically dirHandle.name)\n *\n * @param handle - The FileSystemDirectoryHandle to persist\n *\n * @returns Success or Failure\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "save(label: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", handle: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemDirectoryHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemDirectoryHandle_2:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 9
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "label",
                   "parameterTypeTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
@@ -348,17 +1458,17 @@
                   "isOptional": false
                 },
                 {
-                  "parameterName": "algorithm",
+                  "parameterName": "handle",
                   "parameterTypeTokenRange": {
                     "startIndex": 3,
                     "endIndex": 4
                   },
-                  "isOptional": true
+                  "isOptional": false
                 }
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "hashString"
+              "name": "save"
             }
           ],
           "implementsTokenRanges": []
@@ -741,17 +1851,37 @@
             },
             {
               "kind": "Method",
-              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.extractFileMetadata:member(1)",
-              "docComment": "/**\n * Extract file metadata from a File.\n *\n * @param fileList - The File to extract metadata from\n *\n * @returns The {@link IFileMetadata | file metadata}\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.createFromLocalStorage:member(1)",
+              "docComment": "/**\n * Create a persistent FileTree from browser localStorage. Changes to files can be synced back to localStorage.\n *\n * @remarks\n *\n * - 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\n *\n * @param params - Configuration including path-to-key mappings and optional autoSync\n *\n * @returns Result containing a FileTree with persistence capability\n *\n * @example\n * ```typescript\n * const tree = FileApiTreeAccessors.createFromLocalStorage({\n *   pathToKeyMap: {\n *     '/data/ingredients': 'myapp:ingredients:v1',\n *     '/data/fillings': 'myapp:fillings:v1'\n *   },\n *   mutable: true,\n *   autoSync: false\n * });\n * ```\n *\n * @public\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "static extractFileMetadata(file: "
+                  "text": "static createFromLocalStorage<TCT extends "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(params: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "File",
-                  "canonicalReference": "!File:interface"
+                  "text": "ILocalStorageTreeParams",
+                  "canonicalReference": "@fgv/ts-web-extras!ILocalStorageTreeParams:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>"
                 },
                 {
                   "kind": "Content",
@@ -759,44 +1889,70 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "IFileMetadata",
-                  "canonicalReference": "@fgv/ts-web-extras!IFileMetadata:interface"
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileTree.FileTree",
+                  "canonicalReference": "@fgv/ts-json-base!FileTree_2:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>>"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "TCT",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                }
+              ],
               "isStatic": true,
               "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
+                "startIndex": 8,
+                "endIndex": 12
               },
               "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "file",
+                  "parameterName": "params",
                   "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
+                    "startIndex": 5,
+                    "endIndex": 7
                   },
                   "isOptional": false
                 }
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "extractFileMetadata"
+              "name": "createFromLocalStorage"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.fromDirectoryUpload:member(1)",
-              "docComment": "/**\n * Create FileTree from directory upload with webkitRelativePath.\n *\n * @param fileList - FileList from a directory upload (input with webkitdirectory)\n *\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n *\n * @returns Promise resolving to a FileTree with all content pre-loaded\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.createPersistent:member(1)",
+              "docComment": "/**\n * Create a persistent FileTree from a File System Access API directory handle. Changes to files can be synced back to disk.\n *\n * @remarks\n *\n * - 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)\n *\n * @param dirHandle - FileSystemDirectoryHandle to load files from\n *\n * @param params - Optional parameters including autoSync and permission settings\n *\n * @returns Promise resolving to a FileTree with persistence capability\n *\n * @public\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "static fromDirectoryUpload<TCT extends "
+                  "text": "static createPersistent<TCT extends "
                 },
                 {
                   "kind": "Content",
@@ -812,12 +1968,12 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ">(fileList: "
+                  "text": ">(dirHandle: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "FileList",
-                  "canonicalReference": "!FileList:interface"
+                  "text": "FileSystemDirectoryHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemDirectoryHandle_2:interface"
                 },
                 {
                   "kind": "Content",
@@ -825,8 +1981,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "FileTree.IFileTreeInitParams",
-                  "canonicalReference": "@fgv/ts-json-base!IFileTreeInitParams:interface"
+                  "text": "IFileSystemAccessTreeParams",
+                  "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams:interface"
                 },
                 {
                   "kind": "Content",
@@ -891,7 +2047,7 @@
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "fileList",
+                  "parameterName": "dirHandle",
                   "parameterTypeTokenRange": {
                     "startIndex": 5,
                     "endIndex": 6
@@ -909,16 +2065,16 @@
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "fromDirectoryUpload"
+              "name": "createPersistent"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.fromFileList:member(1)",
-              "docComment": "/**\n * Create FileTree from FileList (e.g., from input[type=\"file\"]).\n *\n * @param fileList - FileList from a file input element\n *\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n *\n * @returns Promise resolving to a FileTree with all content pre-loaded\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.createPersistentFromFile:member(1)",
+              "docComment": "/**\n * 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()`.\n *\n * @param fileHandle - FileSystemFileHandle to load\n *\n * @param params - Optional parameters including autoSync and permission settings\n *\n * @returns Promise resolving to a FileTree with persistence capability\n *\n * @public\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "static fromFileList<TCT extends "
+                  "text": "static createPersistentFromFile<TCT extends "
                 },
                 {
                   "kind": "Content",
@@ -934,12 +2090,12 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ">(fileList: "
+                  "text": ">(fileHandle: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "FileList",
-                  "canonicalReference": "!FileList:interface"
+                  "text": "FileSystemFileHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemFileHandle_2:interface"
                 },
                 {
                   "kind": "Content",
@@ -947,8 +2103,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "FileTree.IFileTreeInitParams",
-                  "canonicalReference": "@fgv/ts-json-base!IFileTreeInitParams:interface"
+                  "text": "IFileSystemAccessTreeParams",
+                  "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams:interface"
                 },
                 {
                   "kind": "Content",
@@ -1013,7 +2169,7 @@
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "fileList",
+                  "parameterName": "fileHandle",
                   "parameterTypeTokenRange": {
                     "startIndex": 5,
                     "endIndex": 6
@@ -1031,29 +2187,21 @@
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "fromFileList"
+              "name": "createPersistentFromFile"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.getOriginalFile:member(1)",
-              "docComment": "/**\n * 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.\n *\n * @param fileList - The original FileList\n *\n * @param targetPath - The path to find\n *\n * @returns Result containing the File object if found\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.extractFileMetadata:member(1)",
+              "docComment": "/**\n * Extract file metadata from a File.\n *\n * @param fileList - The File to extract metadata from\n *\n * @returns The {@link IFileMetadata | file metadata}\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "static getOriginalFile(fileList: "
+                  "text": "static extractFileMetadata(file: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "FileList",
-                  "canonicalReference": "!FileList:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", targetPath: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
+                  "text": "File",
+                  "canonicalReference": "!File:interface"
                 },
                 {
                   "kind": "Content",
@@ -1061,21 +2209,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "Result",
-                  "canonicalReference": "@fgv/ts-utils!Result:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": "<"
-                },
-                {
-                  "kind": "Reference",
-                  "text": "File",
-                  "canonicalReference": "!File:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": ">"
+                  "text": "IFileMetadata",
+                  "canonicalReference": "@fgv/ts-web-extras!IFileMetadata:interface"
                 },
                 {
                   "kind": "Content",
@@ -1084,113 +2219,1114 @@
               ],
               "isStatic": true,
               "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 9
+                "startIndex": 3,
+                "endIndex": 4
               },
               "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "fileList",
+                  "parameterName": "file",
                   "parameterTypeTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
                   },
                   "isOptional": false
-                },
-                {
-                  "parameterName": "targetPath",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 3,
-                    "endIndex": 4
-                  },
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "extractFileMetadata"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.fromDirectoryUpload:member(1)",
+              "docComment": "/**\n * Create FileTree from directory upload with webkitRelativePath.\n *\n * @param fileList - FileList from a directory upload (input with webkitdirectory)\n *\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n *\n * @returns Promise resolving to a FileTree with all content pre-loaded\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static fromDirectoryUpload<TCT extends "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(fileList: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileList",
+                  "canonicalReference": "!FileList:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", params?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileTree.IFileTreeInitParams",
+                  "canonicalReference": "@fgv/ts-json-base!IFileTreeInitParams:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileTree.FileTree",
+                  "canonicalReference": "@fgv/ts-json-base!FileTree_2:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "TCT",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 10,
+                "endIndex": 16
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "fileList",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "params",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 9
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "fromDirectoryUpload"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.fromFileList:member(1)",
+              "docComment": "/**\n * Create FileTree from FileList (e.g., from input[type=\"file\"]).\n *\n * @param fileList - FileList from a file input element\n *\n * @param params - Optional `IFileTreeInitParams` for the file tree.\n *\n * @returns Promise resolving to a FileTree with all content pre-loaded\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static fromFileList<TCT extends "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(fileList: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileList",
+                  "canonicalReference": "!FileList:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", params?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileTree.IFileTreeInitParams",
+                  "canonicalReference": "@fgv/ts-json-base!IFileTreeInitParams:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileTree.FileTree",
+                  "canonicalReference": "@fgv/ts-json-base!FileTree_2:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "TCT",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 10,
+                "endIndex": 16
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "fileList",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "params",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 9
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "fromFileList"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileApiTreeAccessors.getOriginalFile:member(1)",
+              "docComment": "/**\n * 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.\n *\n * @param fileList - The original FileList\n *\n * @param targetPath - The path to find\n *\n * @returns Result containing the File object if found\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static getOriginalFile(fileList: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileList",
+                  "canonicalReference": "!FileList:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", targetPath: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "File",
+                  "canonicalReference": "!File:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 9
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "fileList",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "targetPath",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getOriginalFile"
+            }
+          ],
+          "implementsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-web-extras!FilePickerAcceptType:interface",
+          "docComment": "/**\n * File picker accept type\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface FilePickerAcceptType "
+            }
+          ],
+          "fileUrlPath": "src/packlets/file-api-types/index.ts",
+          "releaseTag": "Public",
+          "name": "FilePickerAcceptType",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!FilePickerAcceptType#accept:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "accept: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, string | string[]>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "accept",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!FilePickerAcceptType#description:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "description?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "description",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Class",
+          "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors:class",
+          "docComment": "/**\n * Implementation of `FileTree.IPersistentFileTreeAccessors` that uses the File System Access API to provide persistent file editing in browsers.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class FileSystemAccessTreeAccessors<TCT extends "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": " = "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "> extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "FileTree.InMemoryTreeAccessors",
+              "canonicalReference": "@fgv/ts-json-base!InMemoryTreeAccessors:class"
+            },
+            {
+              "kind": "Content",
+              "text": "<TCT>"
+            },
+            {
+              "kind": "Content",
+              "text": " implements "
+            },
+            {
+              "kind": "Reference",
+              "text": "FileTree.IPersistentFileTreeAccessors",
+              "canonicalReference": "@fgv/ts-json-base!IPersistentFileTreeAccessors:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<TCT>"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/packlets/file-tree/fileSystemAccessTreeAccessors.ts",
+          "releaseTag": "Public",
+          "typeParameters": [
+            {
+              "typeParameterName": "TCT",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "isAbstract": false,
+          "name": "FileSystemAccessTreeAccessors",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Constructor",
+              "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors:constructor(1)",
+              "docComment": "/**\n * Protected constructor for FileSystemAccessTreeAccessors.\n *\n * @param files - An array of in-memory files to include in the tree.\n *\n * @param rootDir - The root directory handle.\n *\n * @param handles - Map of file paths to their handles.\n *\n * @param params - Optional params for the tree.\n *\n * @param hasWritePermission - Whether write permission was granted.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "protected constructor(files: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileTree.IInMemoryFile",
+                  "canonicalReference": "@fgv/ts-json-base!IInMemoryFile:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", rootDir: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemDirectoryHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemDirectoryHandle_2:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", handles: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Map",
+                  "canonicalReference": "!Map:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string, "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemFileHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemFileHandle_2:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", params: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IFileSystemAccessTreeParams",
+                  "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT> | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", hasWritePermission: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ");"
+                }
+              ],
+              "releaseTag": "Public",
+              "isProtected": true,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "files",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 3
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "rootDir",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 4,
+                    "endIndex": 5
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "handles",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 6,
+                    "endIndex": 10
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "params",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 11,
+                    "endIndex": 13
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "hasWritePermission",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 14,
+                    "endIndex": 15
+                  },
+                  "isOptional": false
+                }
+              ]
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors#fileIsMutable:member(1)",
+              "docComment": "/**\n * Implements `FileTree.IMutableFileTreeAccessors.fileIsMutable`\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "fileIsMutable(path: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "DetailedResult",
+                  "canonicalReference": "@fgv/ts-utils!DetailedResult:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<boolean, "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileTree.SaveDetail",
+                  "canonicalReference": "@fgv/ts-json-base!SaveDetail:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "path",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "fileIsMutable"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors.fromDirectoryHandle:member(1)",
+              "docComment": "/**\n * Creates a new FileSystemAccessTreeAccessors instance from a directory handle.\n *\n * @param dirHandle - The FileSystemDirectoryHandle to load files from.\n *\n * @param params - Optional parameters including autoSync and permission settings.\n *\n * @returns Promise resolving to a FileSystemAccessTreeAccessors instance.\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static fromDirectoryHandle<TCT extends "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(dirHandle: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemDirectoryHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemDirectoryHandle_2:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", params?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IFileSystemAccessTreeParams",
+                  "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemAccessTreeAccessors",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "TCT",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 10,
+                "endIndex": 16
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "dirHandle",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "params",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 9
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "fromDirectoryHandle"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors.fromFileHandle:member(1)",
+              "docComment": "/**\n * Creates a new FileSystemAccessTreeAccessors instance from a single file handle.\n *\n * 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).\n *\n * @param fileHandle - The FileSystemFileHandle to load.\n *\n * @param params - Optional parameters including autoSync and permission settings.\n *\n * @returns Promise resolving to a FileSystemAccessTreeAccessors instance.\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "static fromFileHandle<TCT extends "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": " = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(fileHandle: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemFileHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemFileHandle_2:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", params?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "IFileSystemAccessTreeParams",
+                  "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemAccessTreeAccessors",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "TCT",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 10,
+                "endIndex": 16
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "fileHandle",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
                   "isOptional": false
+                },
+                {
+                  "parameterName": "params",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 9
+                  },
+                  "isOptional": true
                 }
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getOriginalFile"
-            }
-          ],
-          "implementsTokenRanges": []
-        },
-        {
-          "kind": "Interface",
-          "canonicalReference": "@fgv/ts-web-extras!FilePickerAcceptType:interface",
-          "docComment": "/**\n * File picker accept type\n *\n * @public\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export interface FilePickerAcceptType "
-            }
-          ],
-          "fileUrlPath": "src/packlets/file-api-types/index.ts",
-          "releaseTag": "Public",
-          "name": "FilePickerAcceptType",
-          "preserveMemberOrder": false,
-          "members": [
+              "name": "fromFileHandle"
+            },
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!FilePickerAcceptType#accept:member",
-              "docComment": "",
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors#getDirtyPaths:member(1)",
+              "docComment": "/**\n * Implements `FileTree.IPersistentFileTreeAccessors.getDirtyPaths`\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "accept: "
+                  "text": "getDirtyPaths(): "
                 },
                 {
-                  "kind": "Reference",
-                  "text": "Record",
-                  "canonicalReference": "!Record:type"
+                  "kind": "Content",
+                  "text": "string[]"
                 },
                 {
                   "kind": "Content",
-                  "text": "<string, string | string[]>"
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getDirtyPaths"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors#isDirty:member(1)",
+              "docComment": "/**\n * Implements `FileTree.IPersistentFileTreeAccessors.isDirty`\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "isDirty(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "accept",
-              "propertyTypeTokenRange": {
+              "isStatic": false,
+              "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
-              }
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "isDirty"
             },
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!FilePickerAcceptType#description:member",
-              "docComment": "",
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors#saveFileContents:member(1)",
+              "docComment": "/**\n * Implements `FileTree.IMutableFileTreeAccessors.saveFileContents`\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "description?: "
+                  "text": "saveFileContents(path: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", contents: "
                 },
                 {
                   "kind": "Content",
                   "text": "string"
                 },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string>"
+                },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
-              "isOptional": true,
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
               "releaseTag": "Public",
-              "name": "description",
-              "propertyTypeTokenRange": {
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "path",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "contents",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "saveFileContents"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!FileSystemAccessTreeAccessors#syncToDisk:member(1)",
+              "docComment": "/**\n * Implements `FileTree.IPersistentFileTreeAccessors.syncToDisk`\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "syncToDisk(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
-              }
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "syncToDisk"
             }
           ],
-          "extendsTokenRanges": []
+          "extendsTokenRange": {
+            "startIndex": 5,
+            "endIndex": 7
+          },
+          "implementsTokenRanges": [
+            {
+              "startIndex": 8,
+              "endIndex": 10
+            }
+          ]
         },
         {
           "kind": "Interface",
@@ -3297,6 +5433,152 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams:interface",
+          "docComment": "/**\n * Options for creating persistent file trees.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IFileSystemAccessTreeParams<TCT extends "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": " = "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "> extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "FileTree.IFileTreeInitParams",
+              "canonicalReference": "@fgv/ts-json-base!IFileTreeInitParams:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<TCT>"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/packlets/file-tree/fileSystemAccessTreeAccessors.ts",
+          "releaseTag": "Public",
+          "typeParameters": [
+            {
+              "typeParameterName": "TCT",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "name": "IFileSystemAccessTreeParams",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams#autoSync:member",
+              "docComment": "/**\n * Automatically sync changes to disk immediately after each save. If false, changes are batched and written on explicit syncToDisk() call.\n *\n * @defaultValue false\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "autoSync?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "autoSync",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams#filePath:member",
+              "docComment": "/**\n * 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>`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "filePath?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "filePath",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IFileSystemAccessTreeParams#requireWritePermission:member",
+              "docComment": "/**\n * Require write permission on the directory handle. If true, fails if write permission cannot be obtained. If false, falls back to read-only mode.\n *\n * @defaultValue true\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "requireWritePermission?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "requireWritePermission",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": [
+            {
+              "startIndex": 5,
+              "endIndex": 7
+            }
+          ]
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@fgv/ts-web-extras!IFsAccessApis:interface",
@@ -3433,67 +5715,219 @@
               "name": "showOpenFilePicker"
             },
             {
-              "kind": "MethodSignature",
-              "canonicalReference": "@fgv/ts-web-extras!IFsAccessApis#showSaveFilePicker:member(1)",
-              "docComment": "",
+              "kind": "MethodSignature",
+              "canonicalReference": "@fgv/ts-web-extras!IFsAccessApis#showSaveFilePicker:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "showSaveFilePicker(options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ShowSaveFilePickerOptions",
+                  "canonicalReference": "@fgv/ts-web-extras!ShowSaveFilePickerOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileSystemFileHandle",
+                  "canonicalReference": "@fgv/ts-web-extras!FileSystemFileHandle_2:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "showSaveFilePicker"
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-web-extras!ILocalStorageTreeParams:interface",
+          "docComment": "/**\n * Configuration for LocalStorageTreeAccessors.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ILocalStorageTreeParams<TCT extends "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": " = "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "> extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "FileTree.IFileTreeInitParams",
+              "canonicalReference": "@fgv/ts-json-base!IFileTreeInitParams:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<TCT>"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/packlets/file-tree/localStorageTreeAccessors.ts",
+          "releaseTag": "Public",
+          "typeParameters": [
+            {
+              "typeParameterName": "TCT",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "name": "ILocalStorageTreeParams",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!ILocalStorageTreeParams#autoSync:member",
+              "docComment": "/**\n * If true, automatically sync changes to localStorage on every modification. If false (default), changes are only synced when syncToDisk() is called.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "autoSync?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "autoSync",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!ILocalStorageTreeParams#pathToKeyMap:member",
+              "docComment": "/**\n * 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' \\}\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "showSaveFilePicker(options?: "
+                  "text": "pathToKeyMap: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ShowSaveFilePickerOptions",
-                  "canonicalReference": "@fgv/ts-web-extras!ShowSaveFilePickerOptions:interface"
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "): "
+                  "text": "<string, string>"
                 },
                 {
-                  "kind": "Reference",
-                  "text": "Promise",
-                  "canonicalReference": "!Promise:interface"
-                },
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "pathToKeyMap",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!ILocalStorageTreeParams#storage:member",
+              "docComment": "/**\n * Storage instance to use. Defaults to window.localStorage. Can be overridden for testing with mock storage.\n */\n",
+              "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "<"
+                  "text": "storage?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "FileSystemFileHandle",
-                  "canonicalReference": "@fgv/ts-web-extras!FileSystemFileHandle_2:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": ">"
+                  "text": "Storage",
+                  "canonicalReference": "!Storage:interface"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isOptional": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 7
-              },
+              "isReadonly": false,
+              "isOptional": true,
               "releaseTag": "Public",
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "options",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": true
-                }
-              ],
-              "name": "showSaveFilePicker"
+              "name": "storage",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             }
           ],
-          "extendsTokenRanges": []
+          "extendsTokenRanges": [
+            {
+              "startIndex": 5,
+              "endIndex": 7
+            }
+          ]
         },
         {
           "kind": "Function",
@@ -3625,56 +6059,272 @@
               "text": "): "
             },
             {
-              "kind": "Content",
-              "text": "boolean"
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/packlets/url-utils/urlParams.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "path",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "isFilePath"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions:interface",
+          "docComment": "/**\n * Configuration options that can be passed via URL parameters\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface IUrlConfigOptions "
+            }
+          ],
+          "fileUrlPath": "src/packlets/url-utils/urlParams.ts",
+          "releaseTag": "Public",
+          "name": "IUrlConfigOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#config:member",
+              "docComment": "/**\n * Configuration name or path\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "config?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "config",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#configStartDir:member",
+              "docComment": "/**\n * Starting directory for config file picker (derived from config path)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "configStartDir?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "configStartDir",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#contextFilter:member",
+              "docComment": "/**\n * Context filter token (pipe-separated)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "contextFilter?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "contextFilter",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#input:member",
+              "docComment": "/**\n * Input file path\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "input?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "input",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#inputStartDir:member",
+              "docComment": "/**\n * Starting directory for input file picker (derived from input path)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "inputStartDir?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "inputStartDir",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#interactive:member",
+              "docComment": "/**\n * Whether to launch in interactive mode\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "interactive?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "interactive",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#loadZip:member",
+              "docComment": "/**\n * Whether to use ZIP loading mode\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "loadZip?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "loadZip",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             },
             {
-              "kind": "Content",
-              "text": ";"
-            }
-          ],
-          "fileUrlPath": "src/packlets/url-utils/urlParams.ts",
-          "returnTypeTokenRange": {
-            "startIndex": 3,
-            "endIndex": 4
-          },
-          "releaseTag": "Public",
-          "overloadIndex": 1,
-          "parameters": [
-            {
-              "parameterName": "path",
-              "parameterTypeTokenRange": {
+              "kind": "PropertySignature",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#maxDistance:member",
+              "docComment": "/**\n * Maximum distance for language matching\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "maxDistance?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "maxDistance",
+              "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
-              },
-              "isOptional": false
-            }
-          ],
-          "name": "isFilePath"
-        },
-        {
-          "kind": "Interface",
-          "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions:interface",
-          "docComment": "/**\n * Configuration options that can be passed via URL parameters\n *\n * @public\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export interface IUrlConfigOptions "
-            }
-          ],
-          "fileUrlPath": "src/packlets/url-utils/urlParams.ts",
-          "releaseTag": "Public",
-          "name": "IUrlConfigOptions",
-          "preserveMemberOrder": false,
-          "members": [
+              }
+            },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#config:member",
-              "docComment": "/**\n * Configuration name or path\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#qualifierDefaults:member",
+              "docComment": "/**\n * Qualifier defaults token (pipe-separated)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "config?: "
+                  "text": "qualifierDefaults?: "
                 },
                 {
                   "kind": "Content",
@@ -3688,7 +6338,7 @@
               "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Public",
-              "name": "config",
+              "name": "qualifierDefaults",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -3696,16 +6346,16 @@
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#configStartDir:member",
-              "docComment": "/**\n * Starting directory for config file picker (derived from config path)\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#reduceQualifiers:member",
+              "docComment": "/**\n * Whether to reduce qualifiers\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "configStartDir?: "
+                  "text": "reduceQualifiers?: "
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "boolean"
                 },
                 {
                   "kind": "Content",
@@ -3715,7 +6365,7 @@
               "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Public",
-              "name": "configStartDir",
+              "name": "reduceQualifiers",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -3723,12 +6373,12 @@
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#contextFilter:member",
-              "docComment": "/**\n * Context filter token (pipe-separated)\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#resourceTypes:member",
+              "docComment": "/**\n * Resource types filter (comma-separated)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "contextFilter?: "
+                  "text": "resourceTypes?: "
                 },
                 {
                   "kind": "Content",
@@ -3742,7 +6392,7 @@
               "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Public",
-              "name": "contextFilter",
+              "name": "resourceTypes",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -3750,12 +6400,12 @@
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#input:member",
-              "docComment": "/**\n * Input file path\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#zipFile:member",
+              "docComment": "/**\n * Name of ZIP file to load from Downloads (filename only)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "input?: "
+                  "text": "zipFile?: "
                 },
                 {
                   "kind": "Content",
@@ -3769,7 +6419,7 @@
               "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Public",
-              "name": "input",
+              "name": "zipFile",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -3777,12 +6427,12 @@
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#inputStartDir:member",
-              "docComment": "/**\n * Starting directory for input file picker (derived from input path)\n */\n",
+              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#zipPath:member",
+              "docComment": "/**\n * Path to ZIP file to load (for CLI-generated ZIPs)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "inputStartDir?: "
+                  "text": "zipPath?: "
                 },
                 {
                   "kind": "Content",
@@ -3796,128 +6446,283 @@
               "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Public",
-              "name": "inputStartDir",
+              "name": "zipPath",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
               }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Class",
+          "canonicalReference": "@fgv/ts-web-extras!LocalStorageTreeAccessors:class",
+          "docComment": "/**\n * Browser localStorage-backed file tree accessors with persistence support.\n *\n * Maps filesystem-like directory paths to localStorage keys, where each key stores multiple collections as a JSON object. This provides a general-purpose implementation for browser-based file tree persistence without requiring File System Access API.\n *\n * Storage format per key: `{ \"collection-id\": \"<raw file content>\" }` File paths map as: `/data/ingredients/collection-id.yaml` → stored in key for `/data/ingredients`\n *\n * Legacy format (v1): `{ \"collection-id\": { ...parsedJsonObject } }` is auto-migrated on load.\n *\n * @remarks\n *\n * The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `LocalStorageTreeAccessors` class.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class LocalStorageTreeAccessors<TCT extends "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": " = "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "> extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "FileTree.InMemoryTreeAccessors",
+              "canonicalReference": "@fgv/ts-json-base!InMemoryTreeAccessors:class"
+            },
+            {
+              "kind": "Content",
+              "text": "<TCT>"
+            },
+            {
+              "kind": "Content",
+              "text": " implements "
+            },
+            {
+              "kind": "Reference",
+              "text": "FileTree.IPersistentFileTreeAccessors",
+              "canonicalReference": "@fgv/ts-json-base!IPersistentFileTreeAccessors:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<TCT>"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/packlets/file-tree/localStorageTreeAccessors.ts",
+          "releaseTag": "Public",
+          "typeParameters": [
+            {
+              "typeParameterName": "TCT",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              }
+            }
+          ],
+          "isAbstract": false,
+          "name": "LocalStorageTreeAccessors",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!LocalStorageTreeAccessors#fileIsMutable:member(1)",
+              "docComment": "/**\n * Check if a file is mutable and return persistence detail.\n *\n * @param path - File path to check\n *\n * @returns DetailedResult with mutability status and 'persistent' detail if mutable\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "fileIsMutable(path: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "DetailedResult",
+                  "canonicalReference": "@fgv/ts-utils!DetailedResult:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<boolean, "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "FileTree.SaveDetail",
+                  "canonicalReference": "@fgv/ts-json-base!SaveDetail:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "path",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "fileIsMutable"
             },
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#interactive:member",
-              "docComment": "/**\n * Whether to launch in interactive mode\n */\n",
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!LocalStorageTreeAccessors.fromStorage:member(1)",
+              "docComment": "/**\n * Create LocalStorageTreeAccessors from browser localStorage. Loads all collections from the configured storage keys.\n *\n * @param params - Configuration including path-to-key mappings\n *\n * @returns Result containing the accessors or an error\n *\n * @public\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "interactive?: "
+                  "text": "static fromStorage<TCT extends "
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "interactive",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#loadZip:member",
-              "docComment": "/**\n * Whether to use ZIP loading mode\n */\n",
-              "excerptTokens": [
+                  "text": " = "
+                },
                 {
                   "kind": "Content",
-                  "text": "loadZip?: "
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": ">(params: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ILocalStorageTreeParams",
+                  "canonicalReference": "@fgv/ts-web-extras!ILocalStorageTreeParams:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "loadZip",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#maxDistance:member",
-              "docComment": "/**\n * Maximum distance for language matching\n */\n",
-              "excerptTokens": [
+                  "text": "<TCT>"
+                },
                 {
                   "kind": "Content",
-                  "text": "maxDistance?: "
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "number"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "LocalStorageTreeAccessors",
+                  "canonicalReference": "@fgv/ts-web-extras!LocalStorageTreeAccessors:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<TCT>>"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
-              "isOptional": true,
+              "typeParameters": [
+                {
+                  "typeParameterName": "TCT",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  }
+                }
+              ],
+              "isStatic": true,
+              "returnTypeTokenRange": {
+                "startIndex": 8,
+                "endIndex": 12
+              },
               "releaseTag": "Public",
-              "name": "maxDistance",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "params",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 7
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "fromStorage"
             },
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#qualifierDefaults:member",
-              "docComment": "/**\n * Qualifier defaults token (pipe-separated)\n */\n",
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!LocalStorageTreeAccessors#getDirtyPaths:member(1)",
+              "docComment": "/**\n * Get list of file paths with unsaved changes.\n *\n * @returns Array of dirty file paths\n *\n * @public\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "qualifierDefaults?: "
+                  "text": "getDirtyPaths(): "
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "string[]"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "qualifierDefaults",
-              "propertyTypeTokenRange": {
+              "isStatic": false,
+              "returnTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
-              }
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getDirtyPaths"
             },
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#reduceQualifiers:member",
-              "docComment": "/**\n * Whether to reduce qualifiers\n */\n",
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!LocalStorageTreeAccessors#isDirty:member(1)",
+              "docComment": "/**\n * Check if there are unsaved changes.\n *\n * @returns True if there are dirty files\n *\n * @public\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "reduceQualifiers?: "
+                  "text": "isDirty(): "
                 },
                 {
                   "kind": "Content",
@@ -3928,23 +6733,27 @@
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "reduceQualifiers",
-              "propertyTypeTokenRange": {
+              "isStatic": false,
+              "returnTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
-              }
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "isDirty"
             },
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#resourceTypes:member",
-              "docComment": "/**\n * Resource types filter (comma-separated)\n */\n",
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!LocalStorageTreeAccessors#saveFileContents:member(1)",
+              "docComment": "/**\n * Save file contents. Marks file as dirty and optionally auto-syncs.\n *\n * @param path - File path\n *\n * @param contents - New file contents\n *\n * @returns Result with the saved contents or error\n *\n * @public\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "resourceTypes?: "
+                  "text": "saveFileContents(path: "
                 },
                 {
                   "kind": "Content",
@@ -3952,74 +6761,116 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "resourceTypes",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#zipFile:member",
-              "docComment": "/**\n * Name of ZIP file to load from Downloads (filename only)\n */\n",
-              "excerptTokens": [
+                  "text": ", contents: "
+                },
                 {
                   "kind": "Content",
-                  "text": "zipFile?: "
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string>"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
-              "isOptional": true,
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
               "releaseTag": "Public",
-              "name": "zipFile",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "path",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "contents",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "saveFileContents"
             },
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@fgv/ts-web-extras!IUrlConfigOptions#zipPath:member",
-              "docComment": "/**\n * Path to ZIP file to load (for CLI-generated ZIPs)\n */\n",
+              "kind": "Method",
+              "canonicalReference": "@fgv/ts-web-extras!LocalStorageTreeAccessors#syncToDisk:member(1)",
+              "docComment": "/**\n * Sync all dirty files to localStorage.\n *\n * @returns Result indicating success or failure\n *\n * @public\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "zipPath?: "
+                  "text": "syncToDisk(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Result",
+                  "canonicalReference": "@fgv/ts-utils!Result:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>>"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Public",
-              "name": "zipPath",
-              "propertyTypeTokenRange": {
+              "isStatic": false,
+              "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
-              }
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "syncToDisk"
             }
           ],
-          "extendsTokenRanges": []
+          "extendsTokenRange": {
+            "startIndex": 5,
+            "endIndex": 7
+          },
+          "implementsTokenRanges": [
+            {
+              "startIndex": 8,
+              "endIndex": 10
+            }
+          ]
         },
         {
           "kind": "Function",