opfs-worker 2.0.0 → 2.1.1

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/createOPFSWorker.ts","../src/OPFSFacade.ts"],"sourcesContent":["import { wrap } from 'comlink';\n\nimport WorkerCtor from './worker.entry?worker&inline';\n\nimport type { OPFSOptions, RemoteOPFSWorker } from './types';\n\nconst InlineWorker = WorkerCtor as new (options?: WorkerOptions) => Worker;\n\nexport interface RawWorker {\n    /** Comlink proxy to `OPFSWorker` (bytes in / bytes out) */\n    fs: RemoteOPFSWorker;\n    /** Underlying browser Worker */\n    worker: Worker;\n    /** Calls worker `dispose()` then `terminate()` */\n    dispose: () => void;\n}\n\n/** A `BroadcastChannel` instance can't cross the wire — send its name instead. */\nfunction applyWorkerOptions(fs: Pick<RemoteOPFSWorker, 'setOptions'>, options?: OPFSOptions): void {\n    if (!options) {\n        return;\n    }\n\n    if (options.broadcastChannel instanceof BroadcastChannel) {\n        options.broadcastChannel = options.broadcastChannel.name;\n    }\n\n    void fs.setOptions(options);\n}\n\n/**\n * Mode 2: spawn the inlined worker and get a Comlink proxy to `OPFSWorker`\n * (bytes in / bytes out), without the facade.\n *\n * `OPFSFacade` is built on top of this — copy it if you want your own facade.\n */\nexport function createOPFSWorker(options?: OPFSOptions): RawWorker {\n    const worker = new InlineWorker();\n    const fs = wrap<RemoteOPFSWorker>(worker);\n\n    applyWorkerOptions(fs, options);\n\n    return {\n        fs,\n        worker,\n        dispose() {\n            void (async() => {\n                try {\n                    await fs.dispose();\n                }\n                finally {\n                    worker.terminate();\n                }\n            })();\n        },\n    };\n}\n","import { createOPFSWorker } from './createOPFSWorker';\nimport { decodeBuffer, encodeString, isBinaryFileExtension } from './utils/encoder';\n\nimport type {\n    BinaryEncoding,\n    DirentData,\n    Encoding,\n    FileOpenOptions,\n    FileStat,\n    OPFSOptions,\n    PathLike,\n    RemoteOPFSWorker,\n    RenameOptions,\n    StringEncoding,\n    WatchOptions\n} from './types';\n\n/**\n * Utility function to convert a PathLike to a string path\n * If it's a URI, extracts the pathname; otherwise returns the string as-is\n */\nfunction normalizePath(path: PathLike): string {\n    if (path instanceof URL) {\n        return path.pathname;\n    }\n\n    return path;\n}\n\n/**\n * Mode 1: Node-like facade with encoding helpers and string/binary auto-detection,\n * built on top of the raw worker API from {@link createOPFSWorker}.\n *\n * Use {@link createOPFS} to create one.\n */\nexport class OPFSFacade {\n    #fs: RemoteOPFSWorker;\n    #dispose: () => void;\n    promises: OPFSFacade = this;\n\n    constructor(options?: OPFSOptions) {\n        const raw = createOPFSWorker(options);\n\n        this.#fs = raw.fs;\n        this.#dispose = raw.dispose;\n    }\n\n    /**\n     * Start watching a file or directory for changes\n     */\n    watch(path: PathLike, options?: WatchOptions): () => void {\n        const normalizedPath = normalizePath(path);\n\n        void this.#fs.watch(normalizedPath, options);\n\n        return () => this.unwatch(normalizedPath);\n    }\n\n    /**\n     * Stop watching a previously watched path\n     */\n    unwatch(path: PathLike) {\n        const normalizedPath = normalizePath(path);\n\n        void this.#fs.unwatch(normalizedPath);\n    }\n\n    /**\n     * Update configuration options\n     */\n    async setOptions(options: OPFSOptions) {\n        return this.#fs.setOptions(options);\n    }\n\n    /**\n     * Get a complete index of all files and directories in the file system\n     */\n    async index(): Promise<Map<string, FileStat>> {\n        return this.#fs.index();\n    }\n\n    /**\n     * Read a file from the file system\n     */\n    // Overload for explicit string encoding - returns string\n    async readFile(path: PathLike, encoding: StringEncoding): Promise<string>;\n    // Overload for explicit binary encoding - returns Uint8Array\n    async readFile(path: PathLike, encoding: BinaryEncoding): Promise<Uint8Array>;\n    // Overload for options object with string encoding - returns string\n    async readFile(path: PathLike, options: { encoding: StringEncoding }): Promise<string>;\n    // Overload for options object with binary encoding - returns Uint8Array\n    async readFile(path: PathLike, options: { encoding: BinaryEncoding }): Promise<Uint8Array>;\n    // Overload for no encoding (auto-detected) - returns string | Uint8Array based on file extension\n    async readFile(path: PathLike): Promise<string | Uint8Array>;\n    // Implementation\n    async readFile(\n        path: PathLike,\n        optionsOrEncoding?: Encoding | { encoding?: Encoding }\n    ): Promise<string | Uint8Array> {\n        const normalizedPath = normalizePath(path);\n\n        // Handle both options object and direct encoding parameter for backward compatibility\n        let encoding: Encoding | undefined;\n\n        if (typeof optionsOrEncoding === 'string') {\n            encoding = optionsOrEncoding;\n        }\n        else if (optionsOrEncoding && typeof optionsOrEncoding === 'object') {\n            encoding = optionsOrEncoding.encoding;\n        }\n\n        // Same-path reads are serialized by the worker's exclusive path lock\n        const buffer = await this.#fs.readFile(normalizedPath);\n\n        // If no encoding specified, auto-detect based on file extension\n        if (!encoding) {\n            encoding = isBinaryFileExtension(normalizedPath) ? 'binary' : 'utf-8';\n        }\n\n        return (encoding === 'binary') ? buffer : decodeBuffer(buffer, encoding);\n    }\n\n    /**\n     * Write data to a file\n     */\n    async writeFile(\n        path: PathLike,\n        data: string | Uint8Array | ArrayBuffer,\n        options?: { encoding?: Encoding } | Encoding\n    ): Promise<void> {\n        const normalizedPath = normalizePath(path);\n\n        let encoding: Encoding | undefined;\n\n        if (typeof options === 'string') {\n            encoding = options;\n        }\n        else if (options && typeof options === 'object') {\n            encoding = options.encoding;\n        }\n\n        // If no encoding specified, auto-detect based on file extension\n        if (!encoding) {\n            encoding = (typeof data !== 'string' || isBinaryFileExtension(normalizedPath)) ? 'binary' : 'utf-8';\n        }\n\n        // Convert data to Uint8Array\n        const buffer = typeof data === 'string'\n            ? encodeString(data, encoding)\n            : (data instanceof Uint8Array ? data : new Uint8Array(data));\n\n        return this.#fs.writeFile(normalizedPath, buffer);\n    }\n\n    /**\n     * Append data to a file\n     */\n    async appendFile(\n        path: PathLike,\n        data: string | Uint8Array | ArrayBuffer,\n        encoding?: Encoding\n    ): Promise<void> {\n        const normalizedPath = normalizePath(path);\n\n        // If no encoding specified, auto-detect based on file extension\n        if (!encoding) {\n            encoding = (typeof data !== 'string' || isBinaryFileExtension(normalizedPath)) ? 'binary' : 'utf-8';\n        }\n\n        // Convert data to Uint8Array\n        const buffer = typeof data === 'string'\n            ? encodeString(data, encoding)\n            : (data instanceof Uint8Array ? data : new Uint8Array(data));\n\n        return this.#fs.appendFile(normalizedPath, buffer);\n    }\n\n    /**\n     * Create a directory\n     */\n    async mkdir(path: PathLike, mode?: number | { recursive?: boolean }): Promise<void> {\n        const normalizedPath = normalizePath(path);\n\n        let options: { recursive?: boolean } | undefined;\n\n        // OPFS doesn't support file modes, so we ignore the mode parameter\n        if (typeof mode === 'number') {\n            options = { recursive: false };\n        }\n        else {\n            options = mode;\n        }\n\n        return this.#fs.mkdir(normalizedPath, options);\n    }\n\n    /**\n     * Get file or directory statistics\n     */\n    async stat(path: PathLike): Promise<FileStat> {\n        const normalizedPath = normalizePath(path);\n\n        return this.#fs.stat(normalizedPath);\n    }\n\n    /**\n     * Read a directory's contents\n     */\n    async readDir(path: PathLike): Promise<DirentData[]> {\n        const normalizedPath = normalizePath(path);\n\n        return this.#fs.readDir(normalizedPath);\n    }\n\n    /**\n     * Check if a file or directory exists\n     */\n    async exists(path: PathLike): Promise<boolean> {\n        const normalizedPath = normalizePath(path);\n\n        return this.#fs.exists(normalizedPath);\n    }\n\n    /**\n     * Clear all contents of a directory without removing the directory itself\n     */\n    async clear(path?: PathLike): Promise<void> {\n        const normalizedPath = path ? normalizePath(path) : undefined;\n\n        return this.#fs.clear(normalizedPath);\n    }\n\n    /**\n     * Remove files and directories\n     */\n    async remove(path: PathLike, options?: { recursive?: boolean; force?: boolean }): Promise<void> {\n        const normalizedPath = normalizePath(path);\n\n        return this.#fs.remove(normalizedPath, options);\n    }\n\n    /**\n     * Alias for remove() for NodeJS like API compatibility\n     */\n    async unlink(path: PathLike): Promise<void> {\n        return this.remove(path);\n    }\n\n    /**\n     * Alias for remove() for NodeJS like API compatibility\n     */\n    async rm(path: PathLike, options?: { recursive?: boolean; force?: boolean }): Promise<void> {\n        return this.remove(path, options);\n    }\n\n    /**\n     * Alias for remove() for NodeJS like API compatibility\n     */\n    async rmdir(path: PathLike): Promise<void> {\n        return this.remove(path);\n    }\n\n    /**\n     * Alias for readDir() for NodeJS like API compatibility\n     */\n    async readdir(path: PathLike, _options?: unknown): Promise<DirentData[]> {\n        return this.readDir(path);\n    }\n\n    /**\n     * Alias for stat() for NodeJS like API compatibility\n     */\n    async lstat(path: PathLike): Promise<FileStat> {\n        return this.stat(path);\n    }\n\n    /**\n     * Note: OPFS doesn't support file modes, so this is a no-op and exists only for compatibility with tools like isomorphic-git\n     */\n    async chmod(_path: PathLike, _mode: number): Promise<void> {\n        return Promise.resolve();\n    }\n\n    /**\n     * Resolve a path to an absolute path\n     */\n    async realpath(path: PathLike): Promise<string> {\n        const normalizedPath = normalizePath(path);\n\n        return this.#fs.realpath(normalizedPath);\n    }\n\n    /**\n     * Rename a file or directory\n     */\n    async rename(oldPath: PathLike, newPath: PathLike, options?: RenameOptions): Promise<void> {\n        const normalizedOldPath = normalizePath(oldPath);\n        const normalizedNewPath = normalizePath(newPath);\n\n        return this.#fs.rename(normalizedOldPath, normalizedNewPath, options);\n    }\n\n    /**\n     * Copy files and directories\n     */\n    async copy(source: PathLike, destination: PathLike, options?: { recursive?: boolean; overwrite?: boolean }): Promise<void> {\n        const normalizedSource = normalizePath(source);\n        const normalizedDestination = normalizePath(destination);\n\n        return this.#fs.copy(normalizedSource, normalizedDestination, options);\n    }\n\n    /**\n     * Open a file and return a file descriptor\n     */\n    async open(path: PathLike, options?: FileOpenOptions): Promise<number> {\n        const normalizedPath = normalizePath(path);\n\n        return this.#fs.open(normalizedPath, options);\n    }\n\n    /**\n     * Close a file descriptor\n     */\n    async close(fd: number): Promise<void> {\n        return this.#fs.close(fd);\n    }\n\n    /**\n     * Read data from a file descriptor\n     * \n     * This method requires special handling due to Comlink transfer requirements.\n     * The buffer is transferred to the worker and back, so the original buffer\n     * becomes unusable after the call.\n     */\n    async read(\n        fd: number,\n        buffer: Uint8Array,\n        offset: number,\n        length: number,\n        position?: number | null | undefined\n    ): Promise<{ bytesRead: number; buffer: Uint8Array }> {\n        const { bytesRead, buffer: transferred } = await this.#fs.read(\n            fd,\n            // Temp buffer to preserve the original buffer\n            new Uint8Array(length),\n            0,\n            length,\n            position\n        );\n\n        // Copy the data from the transferred buffer to the original buffer\n        if (bytesRead > 0) {\n            buffer.set(transferred.subarray(0, bytesRead), offset);\n        }\n\n        return { bytesRead, buffer };\n    }\n\n    /**\n     * Write data to a file descriptor\n     */\n    async write(\n        fd: number,\n        buffer: Uint8Array,\n        offset?: number,\n        length?: number,\n        position?: number | null | undefined,\n        emitEvent?: boolean\n    ): Promise<number> {\n        return this.#fs.write(fd, buffer, offset, length, position, emitEvent);\n    }\n\n    /**\n     * Get file status information by file descriptor\n     */\n    async fstat(fd: number): Promise<FileStat> {\n        return this.#fs.fstat(fd);\n    }\n\n    /**\n     * Truncate file to specified size\n     */\n    async ftruncate(fd: number, size?: number): Promise<void> {\n        return this.#fs.ftruncate(fd, size);\n    }\n\n    /**\n     * Synchronize file data to storage (fsync equivalent)\n     */\n    async fsync(fd: number): Promise<void> {\n        return this.#fs.fsync(fd);\n    }\n\n    /**\n     * Synchronize the file system with external data\n     */\n    async createIndex(entries: [PathLike, string | Uint8Array | Blob][]): Promise<void> {\n        const normalizedEntries = entries.map(([path, data]) => [normalizePath(path), data] as [string, string | Uint8Array | Blob]);\n\n        return this.#fs.createIndex(normalizedEntries);\n    }\n\n    /**\n     * Read a file as text with automatic encoding detection\n     */\n    async readText(path: PathLike, encoding: Encoding = 'utf-8'): Promise<string> {\n        const normalizedPath = normalizePath(path);\n        const buffer = await this.#fs.readFile(normalizedPath);\n\n        return decodeBuffer(buffer, encoding);\n    }\n\n    /**\n     * Write text to a file with specified encoding\n     */\n    async writeText(path: PathLike, text: string, encoding: Encoding = 'utf-8'): Promise<void> {\n        const normalizedPath = normalizePath(path);\n        const buffer = encodeString(text, encoding);\n\n        return this.#fs.writeFile(normalizedPath, buffer);\n    }\n\n    /**\n     * Append text to a file with specified encoding\n     */\n    async appendText(path: PathLike, text: string, encoding: Encoding = 'utf-8'): Promise<void> {\n        const normalizedPath = normalizePath(path);\n        const buffer = encodeString(text, encoding);\n\n        return this.#fs.appendFile(normalizedPath, buffer);\n    }\n\n    /**\n     * Dispose of resources, detach the worker and clean up the file system instance\n     */\n    dispose() {\n        this.#dispose();\n    }\n}\n\n/**\n * Mode 1: start an inlined worker and get a Node-like `fs` API on top of it.\n *\n * For the raw worker API without the facade, use {@link createOPFSWorker}.\n * To use the worker class inside your own worker, see `opfs-worker/pure`.\n */\nexport function createOPFS(options?: OPFSOptions): OPFSFacade {\n    return new OPFSFacade(options);\n}\n\n/**\n * @deprecated Use {@link createOPFS}. Kept for 1.x compatibility — still returns the facade.\n */\nexport const createWorker = createOPFS;\n\n/**\n * @deprecated Use {@link OPFSFacade}.\n */\nexport { OPFSFacade as OPFSFileSystem };\n"],"names":["InlineWorker","WorkerCtor","applyWorkerOptions","fs","options","createOPFSWorker","worker","wrap","normalizePath","path","OPFSFacade","#fs","#dispose","raw","normalizedPath","optionsOrEncoding","encoding","buffer","isBinaryFileExtension","decodeBuffer","data","encodeString","mode","_options","_path","_mode","oldPath","newPath","normalizedOldPath","normalizedNewPath","source","destination","normalizedSource","normalizedDestination","fd","offset","length","position","bytesRead","transferred","emitEvent","size","entries","normalizedEntries","text","createOPFS","createWorker"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -2,7 +2,21 @@ export * from './types';
 export * from './utils/errors';
 export * from './utils/helpers';
 export * from './utils/encoder';
-export { OPFSFacade, OPFSFileSystem, createOPFS, createWorker, } from './OPFSFacade';
-export { createOPFSWorker } from './createOPFSWorker';
-export type { RawWorker } from './createOPFSWorker';
+export { BaseOPFS, OPFSFacade, OPFSSync, createOPFSDedicated, } from './index.sync';
+export type { DedicatedWorkerOptions, OPFSBackend, } from './index.sync';
+export { OPFSAsync, createOPFSAsync, } from './index.async';
+export { createOPFSShared, } from './index.sharedworker';
+export type { SharedWorkerOptions, } from './index.sharedworker';
+/**
+ * Kept as a short alias for a default Sync backend
+ */
+export { createOPFSDedicated as createOPFS } from './index.sync';
+/**
+ * @deprecated Use {@link createOPFSDedicated}. Kept for 1.x → 2.x migration.
+ */
+export { createOPFSDedicated as createWorker } from './index.sync';
+/**
+ * @deprecated Use {@link OPFSFacade}. Kept for 1.x → 2.x migration.
+ */
+export { OPFSFacade as OPFSFileSystem } from './index.sync';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACH,UAAU,EACV,cAAc,EACd,UAAU,EAEV,YAAY,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACH,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,mBAAmB,GACtB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACR,sBAAsB,EACtB,WAAW,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,SAAS,EACT,eAAe,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACH,gBAAgB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACR,mBAAmB,GACtB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,OAAO,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAEjE;;GAEG;AACH,OAAO,EAAE,mBAAmB,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnE;;GAEG;AACH,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,cAAc,CAAC"}