opfs-worker 2.1.1 → 2.1.2

package/dist/types.d.ts

@@ -1,3 +1,4 @@
+import type { BaseOPFS } from './core/BaseOPFS';
 import type { OPFSSync } from './core/OPFSSync';
 /**
  * Type for paths that can be either a string or URI
@@ -38,12 +39,11 @@ export interface WatchEvent {
 }
 export type { OPFSSync };
 /**
- * Promise-based fs API surface shared by all backends: a Comlink proxy to
- * `OPFSSync` in a worker, or an in-process `OPFSAsync` instance.
+ * Public bytes API shared by all backends (`OPFSSync`, `OPFSAsync`, or a
+ * Comlink proxy to one of them). Declared on {@link BaseOPFS}; subclasses
+ * implement the abstract I/O and FD methods.
  */
-export type OPFSApi = {
-    [K in keyof OPFSSync]: OPFSSync[K];
-};
+export type OPFSApi = Pick<BaseOPFS, keyof BaseOPFS>;
 export interface OPFSOptions {
     /** Root path for the file system (default: '/') */
     root?: string;

package/dist/types.d.ts.map

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

package/dist/utils/helpers.d.ts

@@ -5,17 +5,26 @@ import type { Encoding } from '../types';
  * @throws {OPFSNotSupportedError} If the browser does not support the OPFS API
  */
 export declare function checkOPFSSupport(): void;
+/**
+ * Join a mount `root` with an API path into an absolute OPFS path.
+ *
+ * Lock keys and cross-instance coordination use this so `/x.txt` under
+ * `root: '/app'` and `/app/x.txt` under `root: '/'` resolve to the same file.
+ */
+export declare function absoluteOpfsPath(root: string, path: string): string;
 /**
  * Run a callback while holding an exclusive lock on a path
  *
  * Locks are always exclusive: OPFS permits a single sync access handle per file,
- * so readers can't share access either.
+ * so readers can't share access either. The lock key is the absolute OPFS path
+ * (`root` + API `path`) so different mounts of the same file serialize correctly.
  *
- * @param path - The path to lock
+ * @param path - The API path to lock (relative to `root`)
  * @param fn - The callback to run while holding the lock
+ * @param root - Mount root (default: `/`)
  * @returns The value returned by the callback
  */
-export declare function withLock<T>(path: string, fn: () => Promise<T>): Promise<T>;
+export declare function withLock<T>(path: string, fn: () => Promise<T>, root?: string): Promise<T>;
 /**
  * Split a path into an array of segments
  *
@@ -174,6 +183,7 @@ export declare function removeEntry(parentHandle: FileSystemDirectoryHandle, pat
     recursive?: boolean;
     force?: boolean;
     useTrash?: boolean;
+    root?: string;
 }): Promise<void>;
 /**
  * Validate read/write arguments for file descriptor operations

package/dist/utils/helpers.d.ts.map

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

package/dist/worker/createDedicatedWorker.d.ts

@@ -9,7 +9,7 @@ export interface DedicatedWorkerOptions extends OPFSOptions {
      * prefer the self-contained file (strict CSP without `blob:`, or DIY hosting).
      */
     url?: string | URL;
-    /** Bring your own Worker instance (overrides `url`) */
+    /** Bring your own Worker instance (overrides `url`) — not pooled */
     worker?: Worker;
 }
 export interface RawWorker {
@@ -17,13 +17,18 @@ export interface RawWorker {
     fs: RemoteOPFSSync;
     /** Underlying browser Worker */
     worker: Worker;
-    /** Calls worker `dispose()` then `terminate()` */
+    /** Drops this facade's port; terminates the Worker when the last user of this pool entry disposes */
     dispose: () => void;
 }
 /**
- * Internal helper: spawn a dedicated worker and wrap `OPFSSync` with Comlink.
+ * Internal helper: spawn (or reuse) a dedicated worker and wrap `OPFSSync` with Comlink.
  * Prefer {@link createOPFSDedicated}; access the proxy / Worker via
  * `facade.backend` / `facade.worker`.
+ *
+ * Calls with the same `root` (and same `url`, if any) share one Worker on this page.
+ * Different roots get different Workers. Passing `worker` bypasses the pool.
+ *
+ * `setOptions` hits the shared instance — keep options consistent for the same root.
  */
 export declare function createDedicatedWorker(options?: DedicatedWorkerOptions): RawWorker;
 export {};

package/dist/worker/createDedicatedWorker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createDedicatedWorker.d.ts","sourceRoot":"","sources":["../../src/worker/createDedicatedWorker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC,KAAK,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEvC,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACvD;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACtB,yDAAyD;IACzD,EAAE,EAAE,cAAc,CAAC;IACnB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB;AAeD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,SAAS,CAuBrF"}
+{"version":3,"file":"createDedicatedWorker.d.ts","sourceRoot":"","sources":["../../src/worker/createDedicatedWorker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC,KAAK,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEvC,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACvD;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACtB,yDAAyD;IACzD,EAAE,EAAE,cAAc,CAAC;IACnB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB;AAmCD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,SAAS,CA2ErF"}

package/docs/README.md

@@ -0,0 +1,18 @@
+# Docs
+
+- [API overview](./api/README.md) — entries, facade methods, options, trade-offs
+- [File descriptors](./api/file-descriptors.md) — positional `open` / `read` / `write`
+- [Types](./types.md)
+- [Migration from 1.x](./migration.md)
+
+## Guides
+
+| Guide                                     | About                                                     |
+| ----------------------------------------- | --------------------------------------------------------- |
+| [Dedicated worker](./guides/dedicated.md) | How to use OPFS via a dedicated worker (the default path) |
+| [Async](./guides/async.md)                | How to use OPFS on the main thread, without a worker      |
+| [SharedWorker](./guides/sharedworker.md)  | How to share one filesystem across all tabs               |
+| [Pure classes](./guides/pure.md)          | How to drop OPFS into a worker you already run            |
+| [Streaming](./guides/streaming.md)        | How to handle large files and bulk uploads                |
+| [Watching](./guides/watching.md)          | How to listen for file changes across tabs                |
+| [Hashing](./guides/hashing.md)            | How file hashes / etags work on `stat` and watch events   |

package/docs/api/README.md

@@ -0,0 +1,221 @@
+# API
+
+The sync backend works in every browser that has OPFS, but the browser only allows it inside a dedicated worker — `createOPFS()` / `createOPFSDedicated()` set that up for you. The async backend can run on the main thread or in a SharedWorker, but needs a modern browser — writes will not work in Safari before 26.
+
+## Package entries
+
+| Import from                | Worker                                     | Use it when                                                           |
+| -------------------------- | ------------------------------------------ | --------------------------------------------------------------------- |
+| `opfs-worker`              | Starts a dedicated worker                  | Default; fine if bundle size doesn’t matter or tree-shaking is set up |
+| `opfs-worker/sync`         | Starts a dedicated worker                  | Same as the default, without async / shared code in the bundle        |
+| `opfs-worker/async`        | Runs directly in the current thread        | Main thread or your own worker; Safari prior to 26 can’t write        |
+| `opfs-worker/sharedworker` | Starts one SharedWorker shared by all tabs | One shared fs process for every tab; Safari prior to 26 can’t write   |
+| `opfs-worker/pure`         | None                                       | Low-level classes to build your own custom worker                     |
+
+## Facade
+
+Every helper returns an `OPFSFacade` — the same Node-like API in all modes. The facade hides the actual work: depending on which helper you call, it either creates a dedicated worker and talks to it, works with OPFS directly in the current thread, or connects to a SharedWorker.
+
+Each takes optional `[options](#options)`.
+
+| Function           | From                                        | Under the hood                                   |
+| ------------------ | ------------------------------------------- | ------------------------------------------------ |
+| `createOPFS`       | `opfs-worker` or `opfs-worker/sync`         | Dedicated worker + `OPFSSync`                    |
+| `createOPFSAsync`  | `opfs-worker` or `opfs-worker/async`        | OPFS directly, `OPFSAsync` in the current thread |
+| `createOPFSShared` | `opfs-worker` or `opfs-worker/sharedworker` | SharedWorker + `OPFSAsync`                       |
+
+```typescript
+import { createOPFS, createOPFSAsync, createOPFSShared } from 'opfs-worker';
+
+const fs = createOPFS(); // or createOPFSAsync(), createOPFSShared({ url: '...' })
+```
+
+### File I/O
+
+Paths are `string | URL` everywhere below.
+
+| Method         | Parameters                                                     | Returns                                                                                        |
+| -------------- | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------- | --------------- |
+| `readFile`     | `path`, optional `encoding` or `{ encoding }`                  | `Promise<string                                                                                | Uint8Array>` — auto by extension if omitted (`.txt`→ string,`.bin` → bytes) |
+| `writeFile`    | `path`, `data` (`string                                        | Uint8Array                                                                                     | ArrayBuffer                                                                 | Blob`), optional encoding                                                  | `Promise<void>` |
+| `appendFile`   | `path`, `data` (`string                                        | Uint8Array                                                                                     | ArrayBuffer                                                                 | Blob`), optional encoding                                                  | `Promise<void>` |
+| `readText`     | `path`, `encoding?` (default `'utf-8'`)                        | `Promise<string>`                                                                              |
+| `writeText`    | `path`, `text`, `encoding?` (default `'utf-8'`)                | `Promise<void>`                                                                                |
+| `appendText`   | `path`, `text`, `encoding?` (default `'utf-8'`)                | `Promise<void>`                                                                                |
+| `readBlob`     | `path`                                                         | `Promise<Blob>` — disk-backed, not copied into memory. See [streaming](../guides/streaming.md) |
+| `importStream` | `path`, `ReadableStream                                        | Blob                                                                                           | File`, optional `{ onProgress }`                                            | `Promise<number>` — bytes written. See [streaming](../guides/streaming.md) |
+| `importFiles`  | `[path, data][]` / `Map` / iterable, optional `{ onProgress }` | `Promise<ImportFilesResult>` — paths, count, bytes. See [streaming](../guides/streaming.md)    |
+
+For Node compatibility, `fs.promises` is the same instance (`fs.promises === fs`).
+
+### Directories & metadata
+
+| Method     | Parameters                                                           | Returns                                                             |
+| ---------- | -------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| `mkdir`    | `path`, optional `{ recursive }` (numeric mode accepted and ignored) | `Promise<void>`                                                     |
+| `readDir`  | `path`                                                               | `Promise<DirentData[]>`                                             |
+| `stat`     | `path`                                                               | `Promise<FileStat>`                                                 |
+| `exists`   | `path`                                                               | `Promise<boolean>`                                                  |
+| `realpath` | `path`                                                               | `Promise<string>`                                                   |
+| `remove`   | `path`, optional `{ recursive, force }`                              | `Promise<void>`                                                     |
+| `rename`   | `oldPath`, `newPath`, optional `{ overwrite }`                       | `Promise<void>`                                                     |
+| `copy`     | `source`, `destination`, optional `{ recursive, overwrite }`         | `Promise<void>`                                                     |
+| `clear`    | `path?` (default `/`)                                                | `Promise<void>` — empties the directory, keeps the directory itself |
+| `index`    | —                                                                    | `Promise<Map<string, FileStat>>`                                    |
+
+### Watch & lifecycle
+
+| Method       | Parameters                                                            | Returns                                          |
+| ------------ | --------------------------------------------------------------------- | ------------------------------------------------ |
+| `watch`      | `path`, optional `{ recursive, include, exclude }`                    | `() => void` unsubscribe                         |
+| `unwatch`    | `path`                                                                | `void`                                           |
+| `setOptions` | `options` — see [Options](#options) / [hashing](../guides/hashing.md) | `Promise<void>`                                  |
+| `dispose`    | —                                                                     | `void` — tears down watches, backend, and worker |
+
+### File descriptors
+
+Dedicated / `OPFSSync` only — async throws `ENOTSUP`. Details: [file descriptors](./file-descriptors.md).
+
+| Method      | Parameters                                         | Returns                                     |
+| ----------- | -------------------------------------------------- | ------------------------------------------- |
+| `open`      | `path`, optional `{ create, exclusive, truncate }` | `Promise<number>` — file descriptor         |
+| `read`      | `fd`, `buffer`, `offset`, `length`, `position?`    | `Promise<{ bytesRead, buffer }>`            |
+| `write`     | `fd`, `buffer`, `offset?`, `length?`, `position?`  | `Promise<number>` — bytes written           |
+| `close`     | `fd`                                               | `Promise<void>`                             |
+| `fstat`     | `fd`                                               | `Promise<FileStat>`                         |
+| `ftruncate` | `fd`, `size?` (default `0`)                        | `Promise<void>`                             |
+| `fsync`     | `fd`                                               | `Promise<void>` — best-effort flush in OPFS |
+
+### Node aliases
+
+| Alias     | Parameters                              | Returns                                         |
+| --------- | --------------------------------------- | ----------------------------------------------- |
+| `unlink`  | `path`                                  | same as `remove(path)`                          |
+| `rm`      | `path`, optional `{ recursive, force }` | same as `remove`                                |
+| `rmdir`   | `path`                                  | same as `remove(path)`                          |
+| `readdir` | `path`                                  | same as `readDir`                               |
+| `lstat`   | `path`                                  | same as `stat`                                  |
+| `chmod`   | `path`, `mode`                          | `Promise<void>` — no-op (no Unix modes in OPFS) |
+
+### Backend access
+
+`fs.backend` is the raw bytes API the facade wraps — a Comlink proxy to the worker for dedicated / SharedWorker, or the in-process `OPFSAsync` instance for async. Same methods as the facade, but without encoding helpers (you pass / get `Uint8Array`).
+
+| Field        | Type                             | Notes                |
+| ------------ | -------------------------------- | -------------------- | ---------- | ---------------------------------------------------- |
+| `fs.backend` | `[OPFSApi](../types.md#opfsapi)` | bytes in / bytes out |
+| `fs.worker`  | `Worker                          | SharedWorker         | undefined` | set when a worker was created; `undefined` for async |
+
+## Options
+
+Passed to any `createOPFS*` (and to `setOptions()` later).
+
+| Option             | Default                 | What it does                                                                                                                   |
+| ------------------ | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `root`             | `'/'`                   | Scope all paths under this OPFS subdirectory                                                                                   |
+| `namespace`        | `'opfs-worker:${root}'` | Stamp on every [watch](../guides/watching.md) event                                                                            |
+| `hashAlgorithm`    | `'etag'`                | File hash on `stat` / `index` / watch — `'etag'`, `'SHA-*'`, or `null`/`false` to disable. See [hashing](../guides/hashing.md) |
+| `maxFileSize`      | `50MB`                  | Skip SHA- hashing above this size (`etag` ignores it)                                                                          |
+| `broadcastChannel` | `'opfs-worker'`         | Channel name, a `BroadcastChannel` instance, or `null` to disable                                                              |
+
+```typescript
+const fs = createOPFS({
+    root: '/my-app',
+    hashAlgorithm: 'SHA-256',
+    maxFileSize: 10 * 1024 * 1024,
+});
+```
+
+### Dedicated worker only
+
+| Option   | Type     | Default | What it does                                |
+| -------- | -------- | ------- | ------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `url`    | `string  | URL`    | inlined worker                              | Script URL for `opfs-worker/dedicated.worker.js` (or your own) instead of the blob |
+| `worker` | `Worker` | —       | Pass an existing `Worker` (overrides `url`) |
+
+Leave these unset unless you need them — the default inlined worker is enough.
+
+```typescript
+const fs = createOPFS({ root: '/my-app' });
+
+// Escape hatches only:
+// createOPFS({ root: '/my-app', url: workerUrl })           // CSP without blob:
+// createOPFS({ root: '/my-app', worker: existingWorker })   // bring your own Worker
+```
+
+### SharedWorker only
+
+| Option   | Type           | Default         | What it does                                            |
+| -------- | -------------- | --------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `url`    | `string        | URL`            | next to the package                                     | Script URL for `opfs-worker/shared.worker.js` — with Vite: `import url from '…/shared.worker.js?url'` |
+| `worker` | `SharedWorker` | —               | Pass an existing `SharedWorker` (overrides `url`)       |
+| `name`   | `string`       | `'opfs-worker'` | Tabs with the same script URL + name share one instance |
+
+```typescript
+import workerUrl from 'opfs-worker/shared.worker.js?url'; // Vite
+import { createOPFSShared } from 'opfs-worker/sharedworker';
+
+const fs = createOPFSShared({
+    root: '/my-app',
+    url: workerUrl,
+    name: 'opfs-worker',
+});
+```
+
+## Ready-made worker files
+
+These files already contain a backend (`OPFSSync` or `OPFSAsync`) wrapped in Comlink expose.
+
+| Export                            | Inside                | Start with                                               |
+| --------------------------------- | --------------------- | -------------------------------------------------------- |
+| `opfs-worker/dedicated.worker.js` | Comlink + `OPFSSync`  | `new Worker(url, { type: 'module' })` or `{ url }`       |
+| `opfs-worker/shared.worker.js`    | Comlink + `OPFSAsync` | `new SharedWorker(url, { type: 'module' })` or `{ url }` |
+
+### Use the facade with a worker URL
+
+This is required for SharedWorker. For dedicated workers, use it only when the default inlined worker is blocked by CSP or you want to host the script yourself.
+
+```typescript
+import workerUrl from 'opfs-worker/dedicated.worker.js?url';
+
+const fs = createOPFS({ root: '/my-app', url: workerUrl });
+```
+
+You can also create the `Worker` yourself and pass it to the facade. The facade still handles Comlink, options, encoding helpers, buffer transfers, and cleanup.
+
+```typescript
+const worker = new Worker(workerUrl, { type: 'module' });
+const fs = createOPFS({ root: '/my-app', worker });
+```
+
+### Use the worker without the facade
+
+Wrap it with Comlink and configure the backend manually. This exposes the bytes API directly: no encoding helpers, automatic FD buffer transfers, or automatic worker termination.
+
+```typescript
+import { wrap } from 'comlink';
+import type { OPFSApi } from 'opfs-worker';
+import workerUrl from 'opfs-worker/dedicated.worker.js?url';
+
+const worker = new Worker(workerUrl, { type: 'module' });
+const backend = wrap<OPFSApi>(worker);
+
+await backend.setOptions({ root: '/my-app' });
+await backend.writeFile('/hello.txt', new TextEncoder().encode('hello'));
+
+await backend.dispose();
+worker.terminate();
+```
+
+Guides: [Dedicated worker](../guides/dedicated.md), [SharedWorker](../guides/sharedworker.md).
+
+## Trade-offs
+
+|                                     | Dedicated (`OPFSSync`)                           | Async (`OPFSAsync`)          |
+| ----------------------------------- | ------------------------------------------------ | ---------------------------- |
+| File descriptors                    | yes                                              | throw `ENOTSUP`              |
+| Browser support                     | every browser that has OPFS                      | Safari before 26 can’t write |
+| SharedWorker                        | no                                               | yes                          |
+| One instance for all tabs           | no                                               | yes, with `createOPFSShared` |
+| Bundle                              | ~80 KB inlined worker, or ready-made worker file | small via `/async`           |
+| Works under strict CSP (no `blob:`) | pass a worker `url` instead of the inlined blob  | n/a                          |

package/docs/{file-descriptors.md → api/file-descriptors.md}

@@ -2,7 +2,7 @@
 
 Positional I/O on the **dedicated / sync** backend (`createOPFSDedicated` / `createOPFS`, or `OPFSSync` from `/pure`). Async and SharedWorker throw `ENOTSUP`.
 
-If you call FD `read`/`write` on **`fs.backend`** from the main thread, transfer buffers with Comlink. The [facade](./api/facade.md) does that for you.
+If you call FD `read`/`write` on **`fs.backend`** from the main thread, transfer buffers with Comlink. The [facade](./README.md#facade) does that for you.
 
 ```typescript
 import { transfer } from 'comlink';
@@ -17,11 +17,11 @@ const fd = await fs.open('/data/unique.txt', { create: true, exclusive: true });
 const fd = await fs.open('/data/log.txt', { create: true, truncate: true });
 ```
 
-| Option | Default | |
-| ------ | ------- | --- |
-| `create` | `false` | Create the file if missing |
+| Option      | Default |                                                |
+| ----------- | ------- | ---------------------------------------------- |
+| `create`    | `false` | Create the file if missing                     |
 | `exclusive` | `false` | With `create`, fail if the file already exists |
-| `truncate` | `false` | Truncate to zero length |
+| `truncate`  | `false` | Truncate to zero length                        |
 
 Throws `AlreadyExistsError` (`exclusive`), `FileTypeError` (path is a directory), or `FileSystemOperationError`.
 
@@ -127,11 +127,11 @@ try {
 
 ## Errors
 
-| Error | When |
-| ----- | ---- |
-| `AlreadyExistsError` | `exclusive: true` and file exists |
-| `ExistenceError` | Missing path |
-| `FileTypeError` | File vs directory mismatch |
-| `ValidationError` | Bad offset / length / args |
-| `FileSystemOperationError` / `IOError` | Underlying FS / I/O failure |
-| `PermissionError` | Access denied |
+| Error                                  | When                              |
+| -------------------------------------- | --------------------------------- |
+| `AlreadyExistsError`                   | `exclusive: true` and file exists |
+| `ExistenceError`                       | Missing path                      |
+| `FileTypeError`                        | File vs directory mismatch        |
+| `ValidationError`                      | Bad offset / length / args        |
+| `FileSystemOperationError` / `IOError` | Underlying FS / I/O failure       |
+| `PermissionError`                      | Access denied                     |

package/docs/guides/async.md

@@ -1,6 +1,6 @@
-# Async (no worker)
+# Async
 
-`OPFSAsync` on the current thread — `getFile()` / `createWritable()`, no Comlink, no worker in the bundle.
+`OPFSAsync` on the **current** thread (main or a worker you already run). Does not create a worker. Uses `getFile()` / `createWritable()`, no Comlink.
 
 Same limits apply as SharedWorker (it’s the same backend).
 

package/docs/guides/dedicated.md

@@ -2,7 +2,7 @@
 
 The default path: `OPFSSync` inside a dedicated Web Worker. You get file descriptors and the fastest write path the browser allows for OPFS.
 
-See also [Choosing a mode](../choosing-a-mode.md).
+See also [API](../api/README.md).
 
 ## Facade
 
@@ -16,7 +16,7 @@ await fs.writeFile('/config.json', JSON.stringify({ theme: 'dark' }));
 const config = await fs.readFile('/config.json'); // string — auto-detected
 ```
 
-`createOPFS` is the same thing with a shorter name.
+`createOPFS` is the same thing with a shorter name (also from `opfs-worker/sync`).
 
 The worker is inlined by default, so you don’t need a special bundler worker setup.
 
@@ -70,7 +70,9 @@ const fs = new OPFSFacade({
 
 ## Notes
 
-- Each call gets its own worker. Tabs don’t share state — use [SharedWorker](./sharedworker.md) for that.
+- Same `root` (and same `url`) on one page reuses one Worker; different roots get different Workers. `dispose()` drops your port and terminates the Worker only when the last facade for that pool entry is gone.
+- Tabs don’t share a dedicated Worker — use [SharedWorker](./sharedworker.md) for that.
 - Sync access handles only work in a dedicated worker.
+- `setOptions` hits the shared instance for a pooled root — keep options consistent.
 
-Also: [file descriptors](../file-descriptors.md), [streaming](./streaming.md), [create helpers](../api/create.md).
+Also: [file descriptors](../api/file-descriptors.md), [streaming](./streaming.md), [API](../api/README.md).

package/docs/guides/hashing.md

@@ -31,4 +31,4 @@ const fs = createOPFS({
 });
 ```
 
-Full options table: [`create` helpers](../api/create.md#options).
+Full options table: [API → Options](../api/README.md#options).

package/docs/guides/pure.md

@@ -43,4 +43,4 @@ onconnect = (e) => {
 
 Or use the [SharedWorker guide](./sharedworker.md).
 
-Also: [backend API](../api/backend.md), [dedicated](./dedicated.md), [async](./async.md).
+Also: [dedicated](./dedicated.md), [async](./async.md), [API](../api/README.md).

package/docs/guides/sharedworker.md

@@ -54,4 +54,4 @@ fs.dispose(); // closes this tab’s port only
 - `setOptions` hits the shared instance, so keep options consistent across tabs.
 - Same script URL + `name` (default `'opfs-worker'`) → same instance.
 
-Also: [async](./async.md), [watching](./watching.md), [create helpers](../api/create.md).
+Also: [async](./async.md), [watching](./watching.md), [API](../api/README.md).

package/docs/guides/streaming.md

@@ -140,7 +140,7 @@ dropZone.addEventListener('drop', async (e) => {
 });
 ```
 
-The [demo](https://kachurun.github.io/opfs-worker/) implements exactly this flow — see `demo/FileBrowser.tsx`.
+The [demo](https://kachurun.github.io/opfs-worker/) implements exactly this flow — see `demo/components/FileBrowser/`.
 
 ## `writeStream` (raw)
 
@@ -182,4 +182,4 @@ When the file system runs in a worker, the `Blob` crosses the boundary by refere
 
 Dedicated path chunks through FDs; async path uses `createWritable()` (Safari 26+ for writes).
 
-Also: [facade](../api/facade.md), [backend](../api/backend.md).
+Also: [facade](../api/README.md#facade).

package/docs/migration.md

@@ -2,14 +2,13 @@
 
 ## Renames
 
-| Was                      | Now                                                                                  |
-| ------------------------ | ------------------------------------------------------------------------------------ |
-| `createWorker`           | `createOPFSDedicated` (`createOPFS` alias; deprecated `createWorker` still exported) |
-| `OPFSFileSystem`         | `OPFSFacade` (deprecated alias kept)                                                 |
-| `OPFSWorker`             | `OPFSSync`                                                                           |
-| `opfs-worker/raw`        | `opfs-worker/pure`                                                                   |
-| `opfs-worker/raw?worker` | `createOPFSDedicated()` + `fs.backend` / `fs.worker`, or `dedicated.worker.js`       |
-| `fs.sync(entries)`       | `fs.importFiles(entries)` (`createIndex` alias kept, deprecated)                     |
+| Was                       | Now                                                  |
+| ------------------------- | ---------------------------------------------------- |
+| `createWorker`            | `createOPFS` (deprecated alias kept)                 |
+| `OPFSFileSystem`          | `OPFSFacade` (deprecated alias kept)                 |
+| `OPFSWorker`              | `OPFSSync`                                           |
+| `opfs-worker/raw`         | `opfs-worker/pure`                                   |
+| `fs.createIndex(entries)` | `fs.importFiles(entries)` (`createIndex` alias kept) |
 
 ```diff
 - import { createWorker, OPFSFileSystem } from 'opfs-worker';
@@ -38,4 +37,4 @@
 - Multiple FDs on one path share one sync handle, each with its own cursor
 - Dedicated `dispose()` terminates the browser `Worker`
 
-Full entry map: [Choosing a mode](./choosing-a-mode.md).
+Full entry map: [API](./api/README.md).

package/docs/types.md

@@ -69,10 +69,10 @@ Entries accept `Iterable<[path, string | Uint8Array | Blob]>` or `Map<string,
 
 ## `OPFSApi`
 
-Promise-based surface shared by all backends — a Comlink proxy to `OPFSSync`, or an in-process `OPFSAsync`. What `OPFSFacade` talks to (see `OPFSBackend` in [Create helpers](./api/create.md)).
+Public bytes API shared by all backends — the public methods of `BaseOPFS` (subclasses `OPFSSync` / `OPFSAsync`, or a Comlink proxy). What `OPFSFacade` talks to via `fs.backend`.
 
 ```typescript
-type OPFSApi = { [K in keyof OPFSSync]: OPFSSync[K] };
+type OPFSApi = Pick<BaseOPFS, keyof BaseOPFS>;
 ```
 
 ## `PathLike`
@@ -93,8 +93,6 @@ interface FileOpenOptions {
 
 ## `OPFSOptions`
 
-Table: [Create helpers → Options](./api/create.md#options).
-
 ```typescript
 interface OPFSOptions {
     /** Root path (default: '/') */
@@ -110,6 +108,8 @@ interface OPFSOptions {
 }
 ```
 
+Defaults and behavior: [API → Options](./api/README.md#options).
+
 ## `WatchEventType`
 
 ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "opfs-worker",
-    "version": "2.1.1",
+    "version": "2.1.2",
     "description": "A robust TypeScript library for working with Origin Private File System (OPFS) through Web Workers",
     "type": "module",
     "main": "dist/index.js",
@@ -89,6 +89,7 @@
     "homepage": "https://github.com/kachurun/opfs-worker#readme",
     "devDependencies": {
         "@changesets/cli": "^2.29.5",
+        "@codemirror/commands": "6.10.4",
         "@codemirror/lang-cpp": "6.0.3",
         "@codemirror/lang-css": "6.3.1",
         "@codemirror/lang-go": "6.0.1",
@@ -103,28 +104,29 @@
         "@codemirror/lang-sql": "6.10.0",
         "@codemirror/lang-xml": "6.1.0",
         "@codemirror/lang-yaml": "6.1.3",
+        "@codemirror/language": "6.12.4",
         "@codemirror/legacy-modes": "6.5.3",
+        "@codemirror/state": "6.7.1",
         "@codemirror/theme-one-dark": "6.1.3",
+        "@codemirror/view": "6.43.6",
         "@flexbe/eslint-config": "^1.0.11",
         "@tailwindcss/vite": "4.3.3",
         "@types/minimatch": "^6.0.0",
         "@types/node": "^24.2.0",
-        "@types/react": "^19.1.9",
-        "@types/react-dom": "^19.1.7",
         "@typescript-eslint/eslint-plugin": "^8.39.0",
         "@typescript-eslint/parser": "^8.39.0",
-        "@uiw/react-codemirror": "4.25.11",
         "@vitest/coverage-v8": "^3.2.4",
         "daisyui": "5.7.4",
         "eslint": "^9.32.0",
+        "fflate": "0.8.3",
         "happy-dom": "^18.0.1",
-        "lucide-react": "1.26.0",
-        "react": "^19.1.1",
-        "react-dom": "^19.1.1",
-        "react-icons": "5.7.0",
+        "lucide-solid": "1.27.0",
+        "solid-icons": "1.2.0",
+        "solid-js": "1.9.14",
         "tailwindcss": "4.3.3",
         "typescript": "^5.9.2",
         "vite": "^7.0.6",
+        "vite-plugin-solid": "2.11.13",
         "vitest": "^3.2.4"
     },
     "engines": {
@@ -136,7 +138,6 @@
     "packageManager": "bun@1.2.19",
     "dependencies": {
         "comlink": "^4.4.2",
-        "fflate": "0.8.3",
         "minimatch": "^10.0.3"
     },
     "publishConfig": {