memfs 4.26.0 → 4.28.0

package/README.md

@@ -1,9 +1,7 @@
 # memfs
 
-[![][chat-badge]][chat] [![][npm-badge]][npm-url]
+[![][npm-badge]][npm-url]
 
-[chat]: https://onp4.com/@vadim/~memfs
-[chat-badge]: https://img.shields.io/badge/Chat-%F0%9F%92%AC-green?style=flat&logo=chat&link=https://onp4.com/@vadim/~memfs
 [npm-url]: https://www.npmjs.com/package/memfs
 [npm-badge]: https://img.shields.io/npm/v/memfs.svg
 
@@ -19,8 +17,9 @@ npm i memfs
 
 - Documentation
   - [In-memory Node.js `fs` API](./docs/node/index.md)
-  - `experimental` [`fs` to File System Access API adapter](./docs/fsa/fs-to-fsa.md)
-  - `experimental` [File System Access API to `fs` adapter](./docs/fsa/fsa-to-fs.md)
+  - [In-memory browser FSA (File System Access) API](./docs/fsa/fsa.md)
+  - [`fs` to File System Access API adapter](./docs/fsa/fs-to-fsa.md)
+  - [File System Access API to `fs` adapter](./docs/fsa/fsa-to-fs.md)
   - `experimental` [`crudfs` a CRUD-like file system abstraction](./docs/crudfs/index.md)
   - `experimental` [`casfs` Content Addressable Storage file system abstraction](./docs/casfs/index.md)
   - [Directory `snapshot` utility](./docs/snapshot/index.md)

package/lib/fsa/CoreFileSystemDirectoryHandle.d.ts

@@ -0,0 +1,73 @@
+import { CoreFileSystemHandle } from './CoreFileSystemHandle';
+import type { CoreFsaContext, GetDirectoryHandleOptions, GetFileHandleOptions, IFileSystemDirectoryHandle, IFileSystemFileHandle, IFileSystemHandle, RemoveEntryOptions } from './types';
+import type { Superblock } from '../core/Superblock';
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle
+ */
+export declare class CoreFileSystemDirectoryHandle extends CoreFileSystemHandle implements IFileSystemDirectoryHandle {
+    protected readonly _core: Superblock;
+    protected readonly ctx: CoreFsaContext;
+    /** Directory path with trailing slash. */
+    readonly __path: string;
+    constructor(_core: Superblock, path: string, ctx?: Partial<CoreFsaContext>);
+    /**
+     * Returns a new array iterator containing the keys for each item in
+     * {@link CoreFileSystemDirectoryHandle} object.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/keys
+     */
+    keys(): AsyncIterableIterator<string>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/entries
+     */
+    entries(): AsyncIterableIterator<[string, CoreFileSystemHandle]>;
+    /**
+     * Returns a new array iterator containing the values for each index in the
+     * {@link FileSystemDirectoryHandle} object.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/values
+     */
+    values(): AsyncIterableIterator<CoreFileSystemHandle>;
+    /**
+     * Returns a {@link CoreFileSystemDirectoryHandle} for a subdirectory with the specified
+     * name within the directory handle on which the method is called.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle
+     * @param name A string representing the {@link CoreFileSystemHandle} name of
+     *        the subdirectory you wish to retrieve.
+     * @param options An optional object containing options for the retrieved
+     *        subdirectory.
+     */
+    getDirectoryHandle(name: string, options?: GetDirectoryHandleOptions): Promise<IFileSystemDirectoryHandle>;
+    /**
+     * Returns a {@link CoreFileSystemFileHandle} for a file with the specified name,
+     * within the directory the method is called.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getFileHandle
+     * @param name A string representing the {@link CoreFileSystemHandle} name of
+     *        the file you wish to retrieve.
+     * @param options An optional object containing options for the retrieved file.
+     */
+    getFileHandle(name: string, options?: GetFileHandleOptions): Promise<IFileSystemFileHandle>;
+    /**
+     * Attempts to remove an entry if the directory handle contains a file or
+     * directory called the name specified.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/removeEntry
+     * @param name A string representing the {@link CoreFileSystemHandle} name of the
+     *        entry you wish to remove.
+     * @param options An optional object containing options.
+     */
+    removeEntry(name: string, { recursive }?: RemoveEntryOptions): Promise<void>;
+    /**
+     * The `resolve()` method of the {@link FileSystemDirectoryHandle} interface
+     * returns an {@link Array} of directory names from the parent handle to the specified
+     * child entry, with the name of the child entry as the last array item.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/resolve
+     * @param possibleDescendant The {@link CoreFileSystemHandle} from which
+     *        to return the relative path.
+     */
+    resolve(possibleDescendant: IFileSystemHandle): Promise<string[] | null>;
+    private _handleError;
+}

package/lib/fsa/CoreFileSystemDirectoryHandle.js

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreFileSystemDirectoryHandle = void 0;
+const tslib_1 = require("tslib");
+const CoreFileSystemHandle_1 = require("./CoreFileSystemHandle");
+const util_1 = require("./util");
+const CoreFileSystemFileHandle_1 = require("./CoreFileSystemFileHandle");
+const buffer_1 = require("../internal/buffer");
+const constants_1 = require("../node/constants");
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle
+ */
+class CoreFileSystemDirectoryHandle extends CoreFileSystemHandle_1.CoreFileSystemHandle {
+    constructor(_core, path, ctx = {}) {
+        const fullCtx = (0, util_1.ctx)(ctx);
+        super('directory', (0, util_1.basename)(path, fullCtx.separator), fullCtx);
+        this._core = _core;
+        this.ctx = fullCtx;
+        this.__path = path[path.length - 1] === this.ctx.separator ? path : path + this.ctx.separator;
+    }
+    /**
+     * Returns a new array iterator containing the keys for each item in
+     * {@link CoreFileSystemDirectoryHandle} object.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/keys
+     */
+    keys() {
+        return tslib_1.__asyncGenerator(this, arguments, function* keys_1() {
+            try {
+                const link = this._core.getResolvedLinkOrThrow(this.__path);
+                const children = link.children;
+                for (const [name] of children) {
+                    if (name !== '.' && name !== '..') {
+                        yield yield tslib_1.__await(name);
+                    }
+                }
+            }
+            catch (error) {
+                this._handleError(error, 'keys');
+            }
+        });
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/entries
+     */
+    entries() {
+        return tslib_1.__asyncGenerator(this, arguments, function* entries_1() {
+            const { __path: path, _core, ctx } = this;
+            try {
+                const link = _core.getResolvedLinkOrThrow(path);
+                const children = link.children;
+                for (const [name, childLink] of children) {
+                    if (name !== '.' && name !== '..' && childLink) {
+                        const childPath = path + name;
+                        const node = childLink.getNode();
+                        if (node.isDirectory()) {
+                            yield yield tslib_1.__await([name, new CoreFileSystemDirectoryHandle(_core, childPath, ctx)]);
+                        }
+                        else if (node.isFile()) {
+                            yield yield tslib_1.__await([name, new CoreFileSystemFileHandle_1.CoreFileSystemFileHandle(_core, childPath, ctx)]);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                this._handleError(error, 'entries');
+            }
+        });
+    }
+    /**
+     * Returns a new array iterator containing the values for each index in the
+     * {@link FileSystemDirectoryHandle} object.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/values
+     */
+    values() {
+        return tslib_1.__asyncGenerator(this, arguments, function* values_1() {
+            var _a, e_1, _b, _c;
+            try {
+                for (var _d = true, _e = tslib_1.__asyncValues(this.entries()), _f; _f = yield tslib_1.__await(_e.next()), _a = _f.done, !_a; _d = true) {
+                    _c = _f.value;
+                    _d = false;
+                    const [, value] = _c;
+                    yield yield tslib_1.__await(value);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) yield tslib_1.__await(_b.call(_e));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+    /**
+     * Returns a {@link CoreFileSystemDirectoryHandle} for a subdirectory with the specified
+     * name within the directory handle on which the method is called.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle
+     * @param name A string representing the {@link CoreFileSystemHandle} name of
+     *        the subdirectory you wish to retrieve.
+     * @param options An optional object containing options for the retrieved
+     *        subdirectory.
+     */
+    async getDirectoryHandle(name, options) {
+        (0, util_1.assertName)(name, 'getDirectoryHandle', 'FileSystemDirectoryHandle');
+        const filename = this.__path + name;
+        try {
+            const link = this._core.getResolvedLink(filename);
+            if (link) {
+                const node = link.getNode();
+                if (!node.isDirectory())
+                    throw (0, util_1.newTypeMismatchError)();
+                return new CoreFileSystemDirectoryHandle(this._core, filename, this.ctx);
+            }
+            else {
+                throw new Error('ENOENT'); // Simulate error for consistency with catch block
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException)
+                throw error;
+            if (error && typeof error === 'object') {
+                if (error.code === "ENOENT" /* ERROR_CODE.ENOENT */ || error.message === 'ENOENT') {
+                    if (options === null || options === void 0 ? void 0 : options.create) {
+                        (0, util_1.assertCanWrite)(this.ctx.mode);
+                        try {
+                            this._core.mkdir(filename, 0o755);
+                            return new CoreFileSystemDirectoryHandle(this._core, filename, this.ctx);
+                        }
+                        catch (createError) {
+                            if (createError && typeof createError === 'object' && createError.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                                throw (0, util_1.newNotAllowedError)();
+                            }
+                            throw createError;
+                        }
+                    }
+                    throw (0, util_1.newNotFoundError)();
+                }
+                if (error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                    throw (0, util_1.newNotAllowedError)();
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Returns a {@link CoreFileSystemFileHandle} for a file with the specified name,
+     * within the directory the method is called.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getFileHandle
+     * @param name A string representing the {@link CoreFileSystemHandle} name of
+     *        the file you wish to retrieve.
+     * @param options An optional object containing options for the retrieved file.
+     */
+    async getFileHandle(name, options) {
+        (0, util_1.assertName)(name, 'getFileHandle', 'FileSystemDirectoryHandle');
+        const filename = this.__path + name;
+        try {
+            const link = this._core.getResolvedLink(filename);
+            if (link) {
+                const node = link.getNode();
+                if (!node.isFile())
+                    throw (0, util_1.newTypeMismatchError)();
+                return new CoreFileSystemFileHandle_1.CoreFileSystemFileHandle(this._core, filename, this.ctx);
+            }
+            else {
+                throw new Error('ENOENT'); // Simulate error for consistency with catch block
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException)
+                throw error;
+            if (error && typeof error === 'object') {
+                if (error.code === "ENOENT" /* ERROR_CODE.ENOENT */ || error.message === 'ENOENT') {
+                    if (options === null || options === void 0 ? void 0 : options.create) {
+                        (0, util_1.assertCanWrite)(this.ctx.mode);
+                        try {
+                            this._core.writeFile(filename, buffer_1.Buffer.alloc(0), constants_1.FLAGS.w, 438 /* MODE.FILE */);
+                            return new CoreFileSystemFileHandle_1.CoreFileSystemFileHandle(this._core, filename, this.ctx);
+                        }
+                        catch (createError) {
+                            if (createError && typeof createError === 'object' && createError.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                                throw (0, util_1.newNotAllowedError)();
+                            }
+                            throw createError;
+                        }
+                    }
+                    throw (0, util_1.newNotFoundError)();
+                }
+                if (error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                    throw (0, util_1.newNotAllowedError)();
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Attempts to remove an entry if the directory handle contains a file or
+     * directory called the name specified.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/removeEntry
+     * @param name A string representing the {@link CoreFileSystemHandle} name of the
+     *        entry you wish to remove.
+     * @param options An optional object containing options.
+     */
+    async removeEntry(name, { recursive = false } = {}) {
+        (0, util_1.assertCanWrite)(this.ctx.mode);
+        (0, util_1.assertName)(name, 'removeEntry', 'FileSystemDirectoryHandle');
+        const filename = this.__path + name;
+        try {
+            const link = this._core.getResolvedLinkOrThrow(filename);
+            const node = link.getNode();
+            if (node.isFile()) {
+                this._core.unlink(filename);
+            }
+            else if (node.isDirectory()) {
+                this._core.rmdir(filename, recursive);
+            }
+            else {
+                throw (0, util_1.newTypeMismatchError)();
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException)
+                throw error;
+            if (error && typeof error === 'object') {
+                switch (error.code) {
+                    case "ENOENT" /* ERROR_CODE.ENOENT */: {
+                        throw (0, util_1.newNotFoundError)();
+                    }
+                    case "EACCES" /* ERROR_CODE.EACCES */:
+                        throw (0, util_1.newNotAllowedError)();
+                    case "ENOTEMPTY" /* ERROR_CODE.ENOTEMPTY */:
+                        throw new DOMException('The object can not be modified in this way.', 'InvalidModificationError');
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * The `resolve()` method of the {@link FileSystemDirectoryHandle} interface
+     * returns an {@link Array} of directory names from the parent handle to the specified
+     * child entry, with the name of the child entry as the last array item.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/resolve
+     * @param possibleDescendant The {@link CoreFileSystemHandle} from which
+     *        to return the relative path.
+     */
+    async resolve(possibleDescendant) {
+        if (possibleDescendant instanceof CoreFileSystemDirectoryHandle ||
+            possibleDescendant instanceof CoreFileSystemFileHandle_1.CoreFileSystemFileHandle) {
+            // First check if they are from the same core instance
+            if (possibleDescendant._core !== this._core)
+                return null;
+            const path = this.__path;
+            const childPath = possibleDescendant.__path;
+            if (!childPath.startsWith(path))
+                return null;
+            let relative = childPath.slice(path.length);
+            if (relative === '')
+                return [];
+            const separator = this.ctx.separator;
+            if (relative[0] === separator)
+                relative = relative.slice(1);
+            return relative.split(separator);
+        }
+        return null;
+    }
+    _handleError(error, method) {
+        if (error instanceof DOMException)
+            throw error;
+        if (error && typeof error === 'object') {
+            switch (error.code) {
+                case "ENOENT" /* ERROR_CODE.ENOENT */:
+                    throw (0, util_1.newNotFoundError)();
+                case "EACCES" /* ERROR_CODE.EACCES */:
+                    throw (0, util_1.newNotAllowedError)();
+            }
+        }
+        throw error;
+    }
+}
+exports.CoreFileSystemDirectoryHandle = CoreFileSystemDirectoryHandle;
+//# sourceMappingURL=CoreFileSystemDirectoryHandle.js.map

package/lib/fsa/CoreFileSystemDirectoryHandle.js.map

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

package/lib/fsa/CoreFileSystemFileHandle.d.ts

@@ -0,0 +1,25 @@
+import { CoreFileSystemHandle } from './CoreFileSystemHandle';
+import { CoreFileSystemWritableFileStream } from './CoreFileSystemWritableFileStream';
+import type { CoreFsaContext, CreateWritableOptions, IFileSystemFileHandle, IFileSystemSyncAccessHandle } from './types';
+import type { Superblock } from '../core/Superblock';
+export declare class CoreFileSystemFileHandle extends CoreFileSystemHandle implements IFileSystemFileHandle {
+    protected readonly _core: Superblock;
+    readonly __path: string;
+    protected readonly ctx: CoreFsaContext;
+    constructor(_core: Superblock, __path: string, ctx?: Partial<CoreFsaContext>);
+    /**
+     * Returns a {@link Promise} which resolves to a {@link File} object
+     * representing the state on disk of the entry represented by the handle.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/getFile
+     */
+    getFile(): Promise<File>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createSyncAccessHandle
+     */
+    get createSyncAccessHandle(): undefined | (() => Promise<IFileSystemSyncAccessHandle>);
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createWritable
+     */
+    createWritable({ keepExistingData }?: CreateWritableOptions): Promise<CoreFileSystemWritableFileStream>;
+}

package/lib/fsa/CoreFileSystemFileHandle.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreFileSystemFileHandle = void 0;
+const CoreFileSystemHandle_1 = require("./CoreFileSystemHandle");
+const CoreFileSystemSyncAccessHandle_1 = require("./CoreFileSystemSyncAccessHandle");
+const util_1 = require("./util");
+const CoreFileSystemWritableFileStream_1 = require("./CoreFileSystemWritableFileStream");
+class CoreFileSystemFileHandle extends CoreFileSystemHandle_1.CoreFileSystemHandle {
+    constructor(_core, __path, ctx = {}) {
+        const fullCtx = (0, util_1.ctx)(ctx);
+        super('file', (0, util_1.basename)(__path, fullCtx.separator), fullCtx);
+        this._core = _core;
+        this.__path = __path;
+        this.ctx = fullCtx;
+    }
+    /**
+     * Returns a {@link Promise} which resolves to a {@link File} object
+     * representing the state on disk of the entry represented by the handle.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/getFile
+     */
+    async getFile() {
+        try {
+            const path = this.__path;
+            const link = this._core.getResolvedLinkOrThrow(path);
+            const node = link.getNode();
+            if (!node.isFile()) {
+                throw new Error('Not a file');
+            }
+            // Get file stats for lastModified
+            const lastModified = node.mtime ? node.mtime.getTime() : Date.now();
+            // Read file content
+            const buffer = node.getBuffer();
+            const data = new Uint8Array(buffer);
+            const file = new File([data], this.name, { lastModified });
+            return file;
+        }
+        catch (error) {
+            if (error instanceof DOMException)
+                throw error;
+            if (error && typeof error === 'object') {
+                switch (error.code) {
+                    case "EACCES" /* ERROR_CODE.EACCES */:
+                        throw (0, util_1.newNotAllowedError)();
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createSyncAccessHandle
+     */
+    get createSyncAccessHandle() {
+        if (!this.ctx.syncHandleAllowed)
+            return undefined;
+        return async () => new CoreFileSystemSyncAccessHandle_1.CoreFileSystemSyncAccessHandle(this._core, this.__path, this.ctx);
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createWritable
+     */
+    async createWritable({ keepExistingData = false } = { keepExistingData: false }) {
+        (0, util_1.assertCanWrite)(this.ctx.mode);
+        return new CoreFileSystemWritableFileStream_1.CoreFileSystemWritableFileStream(this._core, this.__path, keepExistingData);
+    }
+}
+exports.CoreFileSystemFileHandle = CoreFileSystemFileHandle;
+//# sourceMappingURL=CoreFileSystemFileHandle.js.map

package/lib/fsa/CoreFileSystemFileHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreFileSystemFileHandle.js","sourceRoot":"","sources":["../../src/fsa/CoreFileSystemFileHandle.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAC9D,qFAAkF;AAClF,iCAAwF;AACxF,yFAAsF;AAWtF,MAAa,wBAAyB,SAAQ,2CAAoB;IAGhE,YACqB,KAAiB,EACpB,MAAc,EAC9B,MAA+B,EAAE;QAEjC,MAAM,OAAO,GAAG,IAAA,UAAS,EAAC,GAAG,CAAC,CAAC;QAC/B,KAAK,CAAC,MAAM,EAAE,IAAA,eAAQ,EAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QALzC,UAAK,GAAL,KAAK,CAAY;QACpB,WAAM,GAAN,MAAM,CAAQ;QAK9B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,OAAO;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAE5B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;YAChC,CAAC;YAED,kCAAkC;YAClC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAEpE,oBAAoB;YACpB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;YAEpC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,YAAY;gBAAE,MAAM,KAAK,CAAC;YAC/C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;oBACnB;wBACE,MAAM,IAAA,yBAAkB,GAAE,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,sBAAsB;QAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB;YAAE,OAAO,SAAS,CAAC;QAClD,OAAO,KAAK,IAAI,EAAE,CAAC,IAAI,+DAA8B,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc,CACzB,EAAE,gBAAgB,GAAG,KAAK,KAA4B,EAAE,gBAAgB,EAAE,KAAK,EAAE;QAEjF,IAAA,qBAAc,EAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,mEAAgC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACzF,CAAC;CACF;AAnED,4DAmEC"}

package/lib/fsa/CoreFileSystemHandle.d.ts

@@ -0,0 +1,34 @@
+import { CorePermissionStatus } from './CorePermissionStatus';
+import type { IFileSystemHandle, FileSystemHandlePermissionDescriptor, CoreFsaContext } from './types';
+/**
+ * Represents a File System Access API file handle `FileSystemHandle` object,
+ * which was created from a core `Superblock`.
+ *
+ * @see [MDN Documentation](https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle)
+ */
+export declare abstract class CoreFileSystemHandle implements IFileSystemHandle {
+    readonly kind: 'file' | 'directory';
+    readonly name: string;
+    protected readonly ctx: CoreFsaContext;
+    constructor(kind: 'file' | 'directory', name: string, ctx: CoreFsaContext);
+    /**
+     * Compares two handles to see if the associated entries (either a file or directory) match.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/isSameEntry
+     */
+    isSameEntry(fileSystemHandle: CoreFileSystemHandle): boolean;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/queryPermission
+     */
+    queryPermission(fileSystemHandlePermissionDescriptor: FileSystemHandlePermissionDescriptor): CorePermissionStatus;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/remove
+     */
+    remove({ recursive }?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/requestPermission
+     */
+    requestPermission(fileSystemHandlePermissionDescriptor: FileSystemHandlePermissionDescriptor): CorePermissionStatus;
+}

package/lib/fsa/CoreFileSystemHandle.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreFileSystemHandle = void 0;
+const CorePermissionStatus_1 = require("./CorePermissionStatus");
+/**
+ * Represents a File System Access API file handle `FileSystemHandle` object,
+ * which was created from a core `Superblock`.
+ *
+ * @see [MDN Documentation](https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle)
+ */
+class CoreFileSystemHandle {
+    constructor(kind, name, ctx) {
+        this.kind = kind;
+        this.name = name;
+        this.ctx = ctx;
+    }
+    /**
+     * Compares two handles to see if the associated entries (either a file or directory) match.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/isSameEntry
+     */
+    isSameEntry(fileSystemHandle) {
+        return (this.constructor === fileSystemHandle.constructor && this.__path === fileSystemHandle.__path);
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/queryPermission
+     */
+    queryPermission(fileSystemHandlePermissionDescriptor) {
+        // Check if the requested mode is compatible with the context mode
+        const requestedMode = fileSystemHandlePermissionDescriptor.mode;
+        const contextMode = this.ctx.mode;
+        // If requesting readwrite but context only allows read, deny
+        if (requestedMode === 'readwrite' && contextMode === 'read') {
+            return new CorePermissionStatus_1.CorePermissionStatus('denied', requestedMode);
+        }
+        // Otherwise grant the permission
+        return new CorePermissionStatus_1.CorePermissionStatus('granted', requestedMode);
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/remove
+     */
+    async remove({ recursive } = { recursive: false }) {
+        throw new Error('Not implemented');
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemHandle/requestPermission
+     */
+    requestPermission(fileSystemHandlePermissionDescriptor) {
+        throw new Error('Not implemented');
+    }
+}
+exports.CoreFileSystemHandle = CoreFileSystemHandle;
+//# sourceMappingURL=CoreFileSystemHandle.js.map

package/lib/fsa/CoreFileSystemHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreFileSystemHandle.js","sourceRoot":"","sources":["../../src/fsa/CoreFileSystemHandle.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAG9D;;;;;GAKG;AACH,MAAsB,oBAAoB;IAGxC,YACkB,IAA0B,EAC1B,IAAY,EAC5B,GAAmB;QAFH,SAAI,GAAJ,IAAI,CAAsB;QAC1B,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,gBAAsC;QACvD,OAAO,CACL,IAAI,CAAC,WAAW,KAAK,gBAAgB,CAAC,WAAW,IAAK,IAAY,CAAC,MAAM,KAAM,gBAAwB,CAAC,MAAM,CAC/G,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,eAAe,CACpB,oCAA0E;QAE1E,kEAAkE;QAClE,MAAM,aAAa,GAAG,oCAAoC,CAAC,IAAI,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAElC,6DAA6D;QAC7D,IAAI,aAAa,KAAK,WAAW,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;YAC5D,OAAO,IAAI,2CAAoB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC3D,CAAC;QAED,iCAAiC;QACjC,OAAO,IAAI,2CAAoB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,KAA8B,EAAE,SAAS,EAAE,KAAK,EAAE;QAC/E,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,iBAAiB,CACtB,oCAA0E;QAE1E,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF;AAxDD,oDAwDC"}

package/lib/fsa/CoreFileSystemSyncAccessHandle.d.ts

@@ -0,0 +1,38 @@
+import type { IFileSystemSyncAccessHandle, FileSystemReadWriteOptions, CoreFsaContext } from './types';
+import type { Superblock } from '../core/Superblock';
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle
+ */
+export declare class CoreFileSystemSyncAccessHandle implements IFileSystemSyncAccessHandle {
+    private readonly _core;
+    private readonly _path;
+    private readonly _ctx;
+    private _fd;
+    private _closed;
+    constructor(_core: Superblock, _path: string, _ctx: CoreFsaContext);
+    private _ensureOpen;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/close
+     */
+    close(): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/flush
+     */
+    flush(): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/getSize
+     */
+    getSize(): Promise<number>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/read
+     */
+    read(buffer: ArrayBuffer | ArrayBufferView, options?: FileSystemReadWriteOptions): Promise<number>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/truncate
+     */
+    truncate(newSize: number): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/write
+     */
+    write(buffer: ArrayBuffer | ArrayBufferView | DataView, options?: FileSystemReadWriteOptions): Promise<number>;
+}

package/lib/fsa/CoreFileSystemSyncAccessHandle.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreFileSystemSyncAccessHandle = void 0;
+const buffer_1 = require("../internal/buffer");
+const util_1 = require("./util");
+const constants_1 = require("../node/constants");
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle
+ */
+class CoreFileSystemSyncAccessHandle {
+    constructor(_core, _path, _ctx) {
+        this._core = _core;
+        this._path = _path;
+        this._ctx = _ctx;
+        this._fd = null;
+        this._closed = false;
+    }
+    _ensureOpen() {
+        if (this._closed) {
+            throw new DOMException('The file handle is closed.', 'InvalidStateError');
+        }
+        if (this._fd === null) {
+            // Open file for read/write
+            const flags = this._ctx.mode === 'readwrite' ? constants_1.FLAGS['r+'] : constants_1.FLAGS.r;
+            this._fd = this._core.open(this._path, flags, 0o644);
+        }
+        return this._fd;
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/close
+     */
+    async close() {
+        if (this._fd !== null) {
+            this._core.close(this._fd);
+            this._fd = null;
+        }
+        this._closed = true;
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/flush
+     */
+    async flush() {
+        const fd = this._ensureOpen();
+        // Core doesn't have an explicit flush method, but we can try to sync if available
+        // For now, this is a no-op as the core writes are synchronous
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/getSize
+     */
+    async getSize() {
+        try {
+            const link = this._core.getResolvedLinkOrThrow(this._path);
+            const node = link.getNode();
+            return node.getSize();
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                throw (0, util_1.newNotAllowedError)();
+            }
+            throw error;
+        }
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/read
+     */
+    async read(buffer, options = {}) {
+        const fd = this._ensureOpen();
+        const { at: position = 0 } = options;
+        const buf = buffer_1.Buffer.from(buffer);
+        try {
+            return this._core.read(fd, buf, 0, buf.length, position);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                throw (0, util_1.newNotAllowedError)();
+            }
+            throw error;
+        }
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/truncate
+     */
+    async truncate(newSize) {
+        if (this._ctx.mode !== 'readwrite') {
+            throw (0, util_1.newNotAllowedError)();
+        }
+        try {
+            const link = this._core.getResolvedLinkOrThrow(this._path);
+            const node = link.getNode();
+            node.truncate(newSize);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                throw (0, util_1.newNotAllowedError)();
+            }
+            throw error;
+        }
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/write
+     */
+    async write(buffer, options = {}) {
+        if (this._ctx.mode !== 'readwrite') {
+            throw (0, util_1.newNotAllowedError)();
+        }
+        const fd = this._ensureOpen();
+        const { at: position = 0 } = options;
+        const buf = buffer_1.Buffer.from(buffer);
+        try {
+            return this._core.write(fd, buf, 0, buf.length, position);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                throw (0, util_1.newNotAllowedError)();
+            }
+            throw error;
+        }
+    }
+}
+exports.CoreFileSystemSyncAccessHandle = CoreFileSystemSyncAccessHandle;
+//# sourceMappingURL=CoreFileSystemSyncAccessHandle.js.map

package/lib/fsa/CoreFileSystemSyncAccessHandle.js.map

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

package/lib/fsa/CoreFileSystemWritableFileStream.d.ts

@@ -0,0 +1,29 @@
+import type { IFileSystemWritableFileStream, FileSystemWritableFileStreamParams, Data } from './types';
+import type { Superblock } from '../core/Superblock';
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream
+ */
+export declare class CoreFileSystemWritableFileStream extends WritableStream implements IFileSystemWritableFileStream {
+    private _fd;
+    private _position;
+    private _closed;
+    private readonly _core;
+    private readonly _path;
+    constructor(core: Superblock, path: string, keepExistingData?: boolean);
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/seek
+     */
+    seek(position: number): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/truncate
+     */
+    truncate(size: number): Promise<void>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/write
+     */
+    write(chunk: Data): Promise<void>;
+    write(params: FileSystemWritableFileStreamParams): Promise<void>;
+    private _write;
+    private _isParams;
+    private _dataToBuffer;
+}

package/lib/fsa/CoreFileSystemWritableFileStream.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreFileSystemWritableFileStream = void 0;
+const buffer_1 = require("../internal/buffer");
+const util_1 = require("./util");
+const constants_1 = require("../node/constants");
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream
+ */
+class CoreFileSystemWritableFileStream extends WritableStream {
+    constructor(core, path, keepExistingData = false) {
+        let fd;
+        super({
+            start: controller => {
+                // Open file for writing
+                const flags = keepExistingData ? constants_1.FLAGS['r+'] : constants_1.FLAGS.w;
+                try {
+                    fd = core.open(path, flags, 438 /* MODE.FILE */);
+                }
+                catch (error) {
+                    if (error && typeof error === 'object' && error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                        throw (0, util_1.newNotAllowedError)();
+                    }
+                    throw error;
+                }
+            },
+            write: async (chunk) => {
+                await this._write(chunk);
+            },
+            close: async () => {
+                if (!this._closed && this._fd !== undefined) {
+                    core.close(this._fd);
+                    this._closed = true;
+                }
+            },
+            abort: async () => {
+                if (!this._closed && this._fd !== undefined) {
+                    core.close(this._fd);
+                    this._closed = true;
+                }
+            },
+        });
+        this._position = 0;
+        this._closed = false;
+        this._core = core;
+        this._path = path;
+        this._fd = fd;
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/seek
+     */
+    async seek(position) {
+        if (this._closed) {
+            throw new DOMException('The stream is closed.', 'InvalidStateError');
+        }
+        this._position = position;
+    }
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/truncate
+     */
+    async truncate(size) {
+        if (this._closed) {
+            throw new DOMException('The stream is closed.', 'InvalidStateError');
+        }
+        try {
+            const link = this._core.getResolvedLinkOrThrow(this._path);
+            const node = link.getNode();
+            node.truncate(size);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                throw (0, util_1.newNotAllowedError)();
+            }
+            throw error;
+        }
+    }
+    async write(chunkOrParams) {
+        await this._write(chunkOrParams);
+    }
+    async _write(chunkOrParams) {
+        if (this._closed) {
+            throw new DOMException('The stream is closed.', 'InvalidStateError');
+        }
+        if (this._fd === undefined) {
+            throw new DOMException('The stream is not ready.', 'InvalidStateError');
+        }
+        try {
+            if (this._isParams(chunkOrParams)) {
+                const params = chunkOrParams;
+                switch (params.type) {
+                    case 'write': {
+                        if (params.data !== undefined) {
+                            const buffer = this._dataToBuffer(params.data);
+                            const position = params.position !== undefined ? params.position : this._position;
+                            const written = this._core.write(this._fd, buffer, 0, buffer.length, position);
+                            if (params.position === undefined) {
+                                this._position += written;
+                            }
+                        }
+                        break;
+                    }
+                    case 'seek': {
+                        if (params.position !== undefined) {
+                            this._position = params.position;
+                        }
+                        break;
+                    }
+                    case 'truncate': {
+                        if (params.size !== undefined) {
+                            await this.truncate(params.size);
+                        }
+                        break;
+                    }
+                }
+            }
+            else {
+                // Direct data write
+                const buffer = this._dataToBuffer(chunkOrParams);
+                const written = this._core.write(this._fd, buffer, 0, buffer.length, this._position);
+                this._position += written;
+            }
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && error.code === "EACCES" /* ERROR_CODE.EACCES */) {
+                throw (0, util_1.newNotAllowedError)();
+            }
+            throw error;
+        }
+    }
+    _isParams(chunk) {
+        return !!(chunk && typeof chunk === 'object' && 'type' in chunk);
+    }
+    _dataToBuffer(data) {
+        if (typeof data === 'string') {
+            return buffer_1.Buffer.from(data, 'utf8');
+        }
+        if (data instanceof buffer_1.Buffer) {
+            return data;
+        }
+        if (data instanceof ArrayBuffer) {
+            return buffer_1.Buffer.from(data);
+        }
+        if (ArrayBuffer.isView(data)) {
+            return buffer_1.Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+        }
+        if (data instanceof Blob) {
+            // For Blob, we would need to read it asynchronously
+            // This is a simplified implementation
+            throw new Error('Blob data type not fully supported in this implementation');
+        }
+        throw new Error('Unsupported data type');
+    }
+}
+exports.CoreFileSystemWritableFileStream = CoreFileSystemWritableFileStream;
+//# sourceMappingURL=CoreFileSystemWritableFileStream.js.map

package/lib/fsa/CoreFileSystemWritableFileStream.js.map

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

package/lib/fsa/CorePermissionStatus.d.ts

@@ -0,0 +1,9 @@
+import type { IPermissionStatus } from './types';
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/PermissionStatus
+ */
+export declare class CorePermissionStatus implements IPermissionStatus {
+    readonly name: string;
+    readonly state: 'granted' | 'denied' | 'prompt';
+    constructor(state: 'granted' | 'denied' | 'prompt', name?: string);
+}

package/lib/fsa/CorePermissionStatus.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorePermissionStatus = void 0;
+/**
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/PermissionStatus
+ */
+class CorePermissionStatus {
+    constructor(state, name = '') {
+        this.name = name;
+        this.state = state;
+    }
+}
+exports.CorePermissionStatus = CorePermissionStatus;
+//# sourceMappingURL=CorePermissionStatus.js.map

package/lib/fsa/CorePermissionStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CorePermissionStatus.js","sourceRoot":"","sources":["../../src/fsa/CorePermissionStatus.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,oBAAoB;IAI/B,YAAY,KAAsC,EAAE,OAAe,EAAE;QACnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AARD,oDAQC"}

package/lib/fsa/index.d.ts

@@ -0,0 +1,27 @@
+import { CoreFileSystemDirectoryHandle } from './CoreFileSystemDirectoryHandle';
+import { CoreFsaContext } from './types';
+import { Superblock } from '../core/Superblock';
+export * from './types';
+export * from './CoreFileSystemHandle';
+export * from './CoreFileSystemDirectoryHandle';
+export * from './CoreFileSystemFileHandle';
+export * from './CoreFileSystemSyncAccessHandle';
+export * from './CoreFileSystemWritableFileStream';
+export * from './CorePermissionStatus';
+/**
+ * Creates a File System Access API implementation on top of a Superblock.
+ */
+export declare const coreToFsa: (core: Superblock, dirPath?: string, ctx?: Partial<CoreFsaContext>) => CoreFileSystemDirectoryHandle;
+/**
+ * Create a new instance of an in-memory File System Access API
+ * implementation rooted at the root directory of the filesystem.
+ *
+ * @param ctx Optional context for the File System Access API.
+ * @returns A File System Access API implementation `dir` rooted at
+ *     the root directory of the filesystem, as well as the `core`
+ *     file system itself.
+ */
+export declare const fsa: (ctx?: Partial<CoreFsaContext>) => {
+    dir: CoreFileSystemDirectoryHandle;
+    core: Superblock;
+};

package/lib/fsa/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fsa = exports.coreToFsa = void 0;
+const tslib_1 = require("tslib");
+const CoreFileSystemDirectoryHandle_1 = require("./CoreFileSystemDirectoryHandle");
+const Superblock_1 = require("../core/Superblock");
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./CoreFileSystemHandle"), exports);
+tslib_1.__exportStar(require("./CoreFileSystemDirectoryHandle"), exports);
+tslib_1.__exportStar(require("./CoreFileSystemFileHandle"), exports);
+tslib_1.__exportStar(require("./CoreFileSystemSyncAccessHandle"), exports);
+tslib_1.__exportStar(require("./CoreFileSystemWritableFileStream"), exports);
+tslib_1.__exportStar(require("./CorePermissionStatus"), exports);
+/**
+ * Creates a File System Access API implementation on top of a Superblock.
+ */
+const coreToFsa = (core, dirPath = '/', ctx) => {
+    return new CoreFileSystemDirectoryHandle_1.CoreFileSystemDirectoryHandle(core, dirPath, ctx);
+};
+exports.coreToFsa = coreToFsa;
+/**
+ * Create a new instance of an in-memory File System Access API
+ * implementation rooted at the root directory of the filesystem.
+ *
+ * @param ctx Optional context for the File System Access API.
+ * @returns A File System Access API implementation `dir` rooted at
+ *     the root directory of the filesystem, as well as the `core`
+ *     file system itself.
+ */
+const fsa = (ctx) => {
+    const core = new Superblock_1.Superblock();
+    const dir = new CoreFileSystemDirectoryHandle_1.CoreFileSystemDirectoryHandle(core, '/', ctx);
+    return { dir, core };
+};
+exports.fsa = fsa;
+//# sourceMappingURL=index.js.map

package/lib/fsa/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fsa/index.ts"],"names":[],"mappings":";;;;AAAA,mFAAgF;AAEhF,mDAAgD;AAEhD,kDAAwB;AACxB,iEAAuC;AACvC,0EAAgD;AAChD,qEAA2C;AAC3C,2EAAiD;AACjD,6EAAmD;AACnD,iEAAuC;AAEvC;;GAEG;AACI,MAAM,SAAS,GAAG,CACvB,IAAgB,EAChB,UAAkB,GAAG,EACrB,GAA6B,EACE,EAAE;IACjC,OAAO,IAAI,6DAA6B,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;AAC/D,CAAC,CAAC;AANW,QAAA,SAAS,aAMpB;AAEF;;;;;;;;GAQG;AACI,MAAM,GAAG,GAAG,CAAC,GAA6B,EAAE,EAAE;IACnD,MAAM,IAAI,GAAG,IAAI,uBAAU,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,6DAA6B,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACvB,CAAC,CAAC;AAJW,QAAA,GAAG,OAId"}

package/lib/fsa/types.d.ts

@@ -24,6 +24,19 @@ export interface IFileSystemDirectoryHandle extends IFileSystemHandle {
     removeEntry(name: string, options?: RemoveEntryOptions): Promise<void>;
     resolve(possibleDescendant: IFileSystemHandle): Promise<string[] | null>;
 }
+/**
+ * Context for Core FSA operations - similar to NodeFsaContext but for Superblock
+ */
+export interface CoreFsaContext {
+    separator: '/' | '\\';
+    /** Whether synchronous file handles are allowed. */
+    syncHandleAllowed: boolean;
+    /** Whether writes are allowed, defaults to `read`. */
+    mode: 'read' | 'readwrite';
+}
+export interface CreateWritableOptions {
+    keepExistingData?: boolean;
+}
 export interface GetDirectoryHandleOptions {
     /**
      * A boolean value, which defaults to `false`. When set to `true` if the directory

package/lib/fsa/util.d.ts

@@ -0,0 +1,11 @@
+import type { CoreFsaContext } from './types';
+/**
+ * Creates a new {@link CoreFsaContext}.
+ */
+export declare const ctx: (partial?: Partial<CoreFsaContext>) => CoreFsaContext;
+export declare const basename: (path: string, separator: string) => string;
+export declare const assertName: (name: string, method: string, klass: string) => void;
+export declare const assertCanWrite: (mode: "read" | "readwrite") => void;
+export declare const newNotFoundError: () => DOMException;
+export declare const newTypeMismatchError: () => DOMException;
+export declare const newNotAllowedError: () => DOMException;

package/lib/fsa/util.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newNotAllowedError = exports.newTypeMismatchError = exports.newNotFoundError = exports.assertCanWrite = exports.assertName = exports.basename = exports.ctx = void 0;
+/**
+ * Creates a new {@link CoreFsaContext}.
+ */
+const ctx = (partial = {}) => {
+    return Object.assign({ separator: '/', syncHandleAllowed: false, mode: 'read' }, partial);
+};
+exports.ctx = ctx;
+const basename = (path, separator) => {
+    if (path[path.length - 1] === separator)
+        path = path.slice(0, -1);
+    const lastSlashIndex = path.lastIndexOf(separator);
+    return lastSlashIndex === -1 ? path : path.slice(lastSlashIndex + 1);
+};
+exports.basename = basename;
+const nameRegex = /^(\.{1,2})$|[\/\\]/;
+const assertName = (name, method, klass) => {
+    const isInvalid = !name || nameRegex.test(name);
+    if (isInvalid)
+        throw new TypeError(`Failed to execute '${method}' on '${klass}': Name is not allowed.`);
+};
+exports.assertName = assertName;
+const assertCanWrite = (mode) => {
+    if (mode !== 'readwrite')
+        throw new DOMException('The request is not allowed by the user agent or the platform in the current context.', 'NotAllowedError');
+};
+exports.assertCanWrite = assertCanWrite;
+const newNotFoundError = () => new DOMException('A requested file or directory could not be found at the time an operation was processed.', 'NotFoundError');
+exports.newNotFoundError = newNotFoundError;
+const newTypeMismatchError = () => new DOMException('The path supplied exists, but was not an entry of requested type.', 'TypeMismatchError');
+exports.newTypeMismatchError = newTypeMismatchError;
+const newNotAllowedError = () => new DOMException('Permission not granted.', 'NotAllowedError');
+exports.newNotAllowedError = newNotAllowedError;
+//# sourceMappingURL=util.js.map

package/lib/fsa/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/fsa/util.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACI,MAAM,GAAG,GAAG,CAAC,UAAmC,EAAE,EAAkB,EAAE;IAC3E,uBACE,SAAS,EAAE,GAAG,EACd,iBAAiB,EAAE,KAAK,EACxB,IAAI,EAAE,MAAM,IACT,OAAO,EACV;AACJ,CAAC,CAAC;AAPW,QAAA,GAAG,OAOd;AAEK,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAE,EAAE;IAC1D,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,SAAS;QAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACnD,OAAO,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AAJW,QAAA,QAAQ,YAInB;AAEF,MAAM,SAAS,GAAG,oBAAoB,CAAC;AAEhC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,KAAa,EAAE,EAAE;IACxE,MAAM,SAAS,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,sBAAsB,MAAM,SAAS,KAAK,yBAAyB,CAAC,CAAC;AAC1G,CAAC,CAAC;AAHW,QAAA,UAAU,cAGrB;AAEK,MAAM,cAAc,GAAG,CAAC,IAA0B,EAAE,EAAE;IAC3D,IAAI,IAAI,KAAK,WAAW;QACtB,MAAM,IAAI,YAAY,CACpB,sFAAsF,EACtF,iBAAiB,CAClB,CAAC;AACN,CAAC,CAAC;AANW,QAAA,cAAc,kBAMzB;AAEK,MAAM,gBAAgB,GAAG,GAAG,EAAE,CACnC,IAAI,YAAY,CACd,0FAA0F,EAC1F,eAAe,CAChB,CAAC;AAJS,QAAA,gBAAgB,oBAIzB;AAEG,MAAM,oBAAoB,GAAG,GAAG,EAAE,CACvC,IAAI,YAAY,CAAC,mEAAmE,EAAE,mBAAmB,CAAC,CAAC;AADhG,QAAA,oBAAoB,wBAC4E;AAEtG,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAI,YAAY,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;AAA1F,QAAA,kBAAkB,sBAAwE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memfs",
-  "version": "4.26.0",
+  "version": "4.28.0",
   "description": "In-memory file-system with Node's fs API.",
   "keywords": [
     "fs",