@struktoai/mirage-browser 0.0.7-alpha.2 → 0.0.7-alpha.3

package/dist/{resource → vfs}/opfs/opfs.js

@@ -11,34 +11,30 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { makeResolveGlob } from '@struktoai/mirage-core/commands/builtin/generic_bind/index';
-import { BaseResource } from '@struktoai/mirage-core/resource/base';
-import { ResourceName } from '@struktoai/mirage-core/types';
+import { chunks } from '@struktoai/mirage-core/io/cooperative';
+import { BaseVFS } from '@struktoai/mirage-core/vfs/base';
+import { VFSName } from '@struktoai/mirage-core/types';
 import { lstripSlash } from '@struktoai/mirage-core/utils/slash';
 import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
 import { OPFSAccessor } from "../../accessor/opfs.js";
-import { OPFS_COMMANDS } from "../../commands/builtin/opfs/index.js";
-import { appendBytes as appendCore } from "../../core/opfs/append.js";
-import { SCOPE_ERROR } from "../../core/opfs/constants.js";
-import { copy as copyCore } from "../../core/opfs/copy.js";
-import { size as duSizeCore } from "../../core/opfs/du/index.js";
-import { exists as existsCore } from "../../core/opfs/exists.js";
-import { find as findCore } from "../../core/opfs/find.js";
-import { mkdir as mkdirCore } from "../../core/opfs/mkdir.js";
-import { read as readCoreFn } from "../../core/opfs/read.js";
-import { readdir as readdirCore } from "../../core/opfs/readdir.js";
-import { rename as renameCore } from "../../core/opfs/rename.js";
-import { rmR as rmRCore } from "../../core/opfs/rm.js";
-import { rmdir as rmdirCore } from "../../core/opfs/rmdir.js";
-import { stat as statCore } from "../../core/opfs/stat.js";
-import { stream as streamCore } from "../../core/opfs/stream.js";
-import { truncate as truncateCore } from "../../core/opfs/truncate.js";
-import { unlink as unlinkCore } from "../../core/opfs/unlink.js";
 import { iterEntries, toWritableChunk } from "../../core/opfs/utils.js";
-import { writeBytes as writeCore } from "../../core/opfs/write.js";
-import { OPFS_OPS } from "../../ops/opfs/index.js";
-import { OPFS_PROMPT } from "./prompt.js";
-const globCore = makeResolveGlob(readdirCore, SCOPE_ERROR);
+import { PROMPT } from "./prompt.js";
+import { readdir as opfsReaddir } from "../../core/opfs/readdir.js";
+import { read as opfsRead } from "../../core/opfs/read.js";
+import { stat as opfsStat } from "../../core/opfs/stat.js";
+import { readStream as opfsStream } from "../../core/opfs/stream.js";
+import { exists as opfsExists } from "../../core/opfs/exists.js";
+import { write as opfsWrite, writeStream as opfsWriteStream } from "../../core/opfs/write.js";
+import { appendBytes as opfsAppend, appendStream as opfsAppendStream, } from "../../core/opfs/append.js";
+import { create as opfsCreate } from "../../core/opfs/create.js";
+import { mkdir as opfsMkdir } from "../../core/opfs/mkdir.js";
+import { unlink as opfsUnlink } from "../../core/opfs/unlink.js";
+import { rmdir as opfsRmdir } from "../../core/opfs/rmdir.js";
+import { rmR as opfsRmR } from "../../core/opfs/rm.js";
+import { rename as opfsRename } from "../../core/opfs/rename.js";
+import { copy as opfsCopy } from "../../core/opfs/copy.js";
+import { truncate as opfsTruncate } from "../../core/opfs/truncate.js";
+import { SCOPE_ERROR } from "../../core/opfs/constants.js";
 async function walkFiles(dir, currentPath, files) {
     for await (const [name, handle] of iterEntries(dir)) {
         const childPath = currentPath === '' ? name : `${currentPath}/${name}`;
@@ -72,12 +68,12 @@ async function splitAndCreate(root, relativePath) {
     }
     return handle;
 }
-export class OPFSResource extends BaseResource {
-    kind = ResourceName.OPFS;
+export class OPFSVFS extends BaseVFS {
+    name = VFSName.OPFS;
     // OPFS is a real filesystem: getFile().size is the exact byte count a
     // read returns.
     sizesAlwaysKnown = true;
-    prompt = OPFS_PROMPT;
+    prompt = PROMPT;
     rootName;
     accessor;
     rootHandle = null;
@@ -87,9 +83,6 @@ export class OPFSResource extends BaseResource {
         this.rootName = options.root ?? '';
         this.accessor = new OPFSAccessor(this);
     }
-    open() {
-        return this.ensureOpen().then(() => undefined);
-    }
     async close() {
         this.rootHandle = null;
         this.openPromise = null;
@@ -97,10 +90,10 @@ export class OPFSResource extends BaseResource {
     }
     /**
      * Lazily resolve to a usable root handle. Memoizes `navigator.storage`
-     * traversal so the resource self-initializes on first method call without
-     * relying on an external orchestrator.
+     * traversal so the VFS self-initializes on the first op, the way the
+     * node redis store connects on its first command.
      */
-    ensureOpen() {
+    root() {
         if (this.rootHandle !== null)
             return Promise.resolve(this.rootHandle);
         this.openPromise ??= (async () => {
@@ -116,108 +109,84 @@ export class OPFSResource extends BaseResource {
         })();
         return this.openPromise;
     }
-    requireHandle() {
-        if (this.rootHandle === null) {
-            throw new Error('OPFSResource is not open — call open() first');
-        }
-        return this.rootHandle;
-    }
-    ops() {
-        return OPFS_OPS;
-    }
-    commands() {
-        return OPFS_COMMANDS;
-    }
-    async *streamPath(p) {
-        await this.ensureOpen();
-        yield* streamCore(this.accessor, p);
+    readsRanges = true;
+    local = true;
+    maxGlobMatches = SCOPE_ERROR;
+    readdir(path) {
+        return opfsReaddir(this.accessor, path);
     }
-    async readFile(p) {
-        await this.ensureOpen();
-        return readCoreFn(this.accessor, p);
+    read(path, _handed, offset = 0, size = null) {
+        if (offset === 0 && size === null)
+            return opfsRead(this.accessor, path);
+        return opfsRead(this.accessor, path, size === null ? { offset } : { offset, size });
     }
-    async writeFile(p, data) {
-        await this.ensureOpen();
-        return writeCore(this.accessor, p, data);
+    stat(path) {
+        return opfsStat(this.accessor, path);
     }
-    async appendFile(p, data) {
-        await this.ensureOpen();
-        return appendCore(this.accessor, p, data);
+    readStream(path) {
+        return opfsStream(this.accessor, path);
     }
-    async readdir(p) {
-        await this.ensureOpen();
-        return readdirCore(this.accessor, p);
+    exists(path) {
+        return opfsExists(this.accessor, path);
     }
-    async stat(p) {
-        await this.ensureOpen();
-        return statCore(this.accessor, p);
+    write(path, data) {
+        return opfsWrite(this.accessor, path, data);
     }
-    async exists(p) {
-        await this.ensureOpen();
-        return existsCore(this.accessor, p);
+    writeStream(path, data, signal) {
+        return opfsWriteStream(this.accessor, path, chunks(data, signal));
     }
-    async mkdir(p, options) {
-        await this.ensureOpen();
-        return mkdirCore(this.accessor, p, options?.recursive === true);
+    appendStream(path, data, signal) {
+        return opfsAppendStream(this.accessor, path, chunks(data, signal));
     }
-    async rmdir(p) {
-        await this.ensureOpen();
-        return rmdirCore(this.accessor, p);
+    append(path, data) {
+        return opfsAppend(this.accessor, path, data);
     }
-    async unlink(p) {
-        await this.ensureOpen();
-        return unlinkCore(this.accessor, p);
+    create(path) {
+        return opfsCreate(this.accessor, path);
     }
-    async rename(src, dst) {
-        await this.ensureOpen();
-        return renameCore(this.accessor, src, dst);
+    mkdir(path, parents = false) {
+        return opfsMkdir(this.accessor, path, parents);
     }
-    async truncate(p, length) {
-        await this.ensureOpen();
-        return truncateCore(this.accessor, p, length);
+    unlink(path) {
+        return opfsUnlink(this.accessor, path);
     }
-    async copy(src, dst) {
-        await this.ensureOpen();
-        return copyCore(this.accessor, src, dst);
+    rmdir(path) {
+        return opfsRmdir(this.accessor, path);
     }
-    async rmR(p) {
-        await this.ensureOpen();
-        return rmRCore(this.accessor, p);
+    rmR(path) {
+        return opfsRmR(this.accessor, path);
     }
-    async du(p) {
-        await this.ensureOpen();
-        return duSizeCore(this.accessor, p);
+    rename(src, dst) {
+        return opfsRename(this.accessor, src, dst);
     }
-    async find(p, options = {}) {
-        await this.ensureOpen();
-        return findCore(this.accessor, p, options);
+    copy(src, dst) {
+        return opfsCopy(this.accessor, src, dst);
     }
-    async glob(paths) {
-        await this.ensureOpen();
-        return globCore(this.accessor, paths);
+    truncate(path, length, noCreate = false) {
+        return opfsTruncate(this.accessor, path, length, noCreate);
     }
     async getState() {
-        const handle = await this.ensureOpen();
+        const handle = await this.root();
         const files = {};
         await walkFiles(handle, '', files);
         const dirs = [];
         await walkDirs(handle, '', dirs);
         dirs.sort(compareCodePoints);
         return {
-            type: this.kind,
+            type: this.name,
             files,
             dirs,
         };
     }
     async loadState(state) {
-        const handle = await this.ensureOpen();
-        for (const dir of state.dirs) {
+        const handle = await this.root();
+        for (const dir of state.dirs ?? []) {
             const rel = lstripSlash(dir);
             if (rel === '')
                 continue;
             await splitAndCreate(handle, rel);
         }
-        for (const [rel, data] of Object.entries(state.files)) {
+        for (const [rel, data] of Object.entries(state.files ?? {})) {
             const segs = rel.split('/').filter((s) => s !== '' && s !== '.');
             const fileName = segs.pop();
             if (fileName === undefined)

package/dist/vfs/opfs/opfs.js.map

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

package/dist/vfs/opfs/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const PROMPT = "{prefix}\n  Browser Origin Private File System. Persistent per-origin storage that survives page reloads.\n  Standard commands: ls, cat, head, tail, grep, wc, find, tree, mkdir, touch, cp, mv, rm, tee.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/vfs/opfs/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/vfs/opfs/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,MAAM,8MAE4E,CAAA"}

package/dist/{resource → vfs}/opfs/prompt.js

@@ -11,7 +11,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-export const OPFS_PROMPT = `{prefix}
+export const PROMPT = `{prefix}
   Browser Origin Private File System. Persistent per-origin storage that survives page reloads.
   Standard commands: ls, cat, head, tail, grep, wc, find, tree, mkdir, touch, cp, mv, rm, tee.`;
 //# sourceMappingURL=prompt.js.map

package/dist/vfs/opfs/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/vfs/opfs/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,MAAM,GAAG;;+FAEyE,CAAA"}

package/dist/vfs/postgres/neon_driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neon_driver.d.ts","sourceRoot":"","sources":["../../../src/vfs/postgres/neon_driver.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAA;AAO3F,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgC;gBAExC,GAAG,EAAE,MAAM;IAIjB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAC1B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAQ5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvB"}

package/dist/{resource → vfs}/postgres/neon_driver.js

@@ -11,11 +11,12 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { neon } from '@neondatabase/serverless';
+import { neon, types } from '@neondatabase/serverless';
+import { readAsText } from '@struktoai/mirage-core/accessor/postgres';
 export class NeonPgDriver {
     sql;
     constructor(dsn) {
-        this.sql = neon(dsn, { fullResults: true });
+        this.sql = neon(dsn, { fullResults: true, types: readAsText(types) });
     }
     async query(text, params) {
         const result = (await this.sql.query(text, params));

package/dist/vfs/postgres/neon_driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neon_driver.js","sourceRoot":"","sources":["../../../src/vfs/postgres/neon_driver.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,IAAI,EAAE,KAAK,EAA0B,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAQrE,MAAM,OAAO,YAAY;IACN,GAAG,CAAgC;IAEpD,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,KAAK,CACT,IAAY,EACZ,MAA2B;QAE3B,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAClC,IAAI,EACJ,MAA+B,CAChC,CAAiC,CAAA;QAClC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAC/E,CAAC;IAED,KAAK;QACH,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;CACF"}

package/dist/vfs/postgres/postgres.d.ts

@@ -0,0 +1,27 @@
+import { PostgresVFSBase } from '@struktoai/mirage-core/vfs/postgres/postgres';
+import { PostgresAccessor } from '@struktoai/mirage-core/accessor/postgres';
+import type { PgDriver } from '@struktoai/mirage-core/core/postgres/_driver';
+import type { PostgresConfig, PostgresConfigRedacted, PostgresConfigResolved } from '@struktoai/mirage-core/vfs/postgres/config';
+export interface PostgresVFSOptions {
+    config: PostgresConfig;
+    prefix?: string;
+    driver?: PgDriver;
+}
+export interface PostgresVFSState {
+    type: string;
+    config: PostgresConfigRedacted;
+    needs_override: true;
+}
+export declare class PostgresVFS extends PostgresVFSBase {
+    readonly name: string;
+    readonly cachesReads: boolean;
+    readonly indexTtl: number;
+    readonly prompt: string;
+    readonly config: PostgresConfigResolved;
+    readonly driver: PgDriver;
+    readonly accessor: PostgresAccessor;
+    constructor(options: PostgresVFSOptions | PostgresConfig);
+    getState(): PostgresVFSState;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/vfs/postgres/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/vfs/postgres/postgres.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAA;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAE3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8CAA8C,CAAA;AAM5E,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,4CAA4C,CAAA;AAMnD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,sBAAsB,CAAA;IAC9B,cAAc,EAAE,IAAI,CAAA;CACrB;AAED,qBAAa,WAAY,SAAQ,eAAe;IAC9C,SAAkB,IAAI,EAAE,MAAM,CAAmB;IACjD,SAAkB,WAAW,EAAE,OAAO,CAAQ;IAC9C,SAAkB,QAAQ,EAAE,MAAM,CAAI;IACtC,SAAkB,MAAM,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,SAAkB,QAAQ,EAAE,gBAAgB,CAAA;gBAEhC,OAAO,EAAE,kBAAkB,GAAG,cAAc;IAU/C,QAAQ,IAAI,gBAAgB;IAatB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAItC"}

package/dist/vfs/postgres/postgres.js

@@ -0,0 +1,53 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { PostgresVFSBase } from '@struktoai/mirage-core/vfs/postgres/postgres';
+import { PostgresAccessor } from '@struktoai/mirage-core/accessor/postgres';
+import { redactPostgresConfig, resolvePostgresConfig, } from '@struktoai/mirage-core/vfs/postgres/config';
+import { PROMPT } from '@struktoai/mirage-core/vfs/postgres/prompt';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { NeonPgDriver } from "./neon_driver.js";
+export class PostgresVFS extends PostgresVFSBase {
+    name = VFSName.POSTGRES;
+    cachesReads = false;
+    indexTtl = 0;
+    prompt;
+    config;
+    driver;
+    accessor;
+    constructor(options) {
+        super();
+        const { config, prefix, driver } = 'config' in options ? options : { config: options, prefix: undefined, driver: undefined };
+        this.config = resolvePostgresConfig(config);
+        this.driver = driver ?? new NeonPgDriver(this.config.dsn);
+        this.accessor = new PostgresAccessor(this.driver, this.config);
+        this.prompt = PROMPT.replace('{prefix}', prefix ?? '');
+    }
+    getState() {
+        return {
+            type: this.name,
+            config: redactPostgresConfig(this.config),
+            // TypeScript cannot rebuild a config-backed mount from state:
+            // `buildMountArgs` substitutes a RAMVFS for anything it was
+            // not handed. Saying so out loud turns a silently empty mount
+            // into a refusal to load. Python rebuilds via its registry, so it
+            // writes this on only four mounts and reads it nowhere.
+            needs_override: true,
+        };
+    }
+    async close() {
+        await this.driver.close();
+        await super.close();
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/vfs/postgres/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../../src/vfs/postgres/postgres.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAA;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAI3E,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,4CAA4C,CAAA;AAMnD,OAAO,EAAE,MAAM,EAAE,MAAM,4CAA4C,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAc/C,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC5B,IAAI,GAAW,OAAO,CAAC,QAAQ,CAAA;IAC/B,WAAW,GAAY,KAAK,CAAA;IAC5B,QAAQ,GAAW,CAAC,CAAA;IACpB,MAAM,CAAQ;IACvB,MAAM,CAAwB;IAC9B,MAAM,CAAU;IACP,QAAQ,CAAkB;IAE5C,YAAY,OAA4C;QACtD,KAAK,EAAE,CAAA;QACP,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAC9B,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QAC3F,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACzD,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC,CAAA;IACxD,CAAC;IAEQ,QAAQ;QACf,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;YACzC,8DAA8D;YAC9D,4DAA4D;YAC5D,8DAA8D;YAC9D,kEAAkE;YAClE,wDAAwD;YACxD,cAAc,EAAE,IAAI;SACrB,CAAA;IACH,CAAC;IAEQ,KAAK,CAAC,KAAK;QAClB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACzB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;CACF"}

package/dist/{resource → vfs}/qingstor/config.d.ts

@@ -1,7 +1,7 @@
-import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/vfs/secrets';
 declare const QingStorConfigSchema: import("zod").ZodObject<{
     bucket: import("zod").ZodString;
-    presignedUrlProvider: import("zod").ZodCustom<import("@struktoai/mirage-core/resource/s3/config").S3BrowserPresignedUrlProvider, import("@struktoai/mirage-core/resource/s3/config").S3BrowserPresignedUrlProvider>;
+    presignedUrlProvider: import("zod").ZodCustom<import("@struktoai/mirage-core/vfs/s3/config").S3BrowserPresignedUrlProvider, import("@struktoai/mirage-core/vfs/s3/config").S3BrowserPresignedUrlProvider>;
     region: import("zod").ZodOptional<import("zod").ZodString>;
     endpoint: import("zod").ZodOptional<import("zod").ZodString>;
     defaultContentType: import("zod").ZodOptional<import("zod").ZodString>;
@@ -10,7 +10,7 @@ declare const QingStorConfigSchema: import("zod").ZodObject<{
 export type QingStorConfig = ConfigOf<typeof QingStorConfigSchema>;
 export type QingStorConfigRedacted = RedactedConfig<QingStorConfig, 'presignedUrlProvider'>;
 export declare const resolvedQingStorEndpoint: (config: QingStorConfig) => string | undefined;
-export declare const qingStorToS3Config: (config: QingStorConfig) => import("@struktoai/mirage-core/resource/s3/config").S3Config;
+export declare const qingStorToS3Config: (config: QingStorConfig) => import("@struktoai/mirage-core/vfs/s3/config").S3Config;
 export declare const redactQingStorConfig: (config: QingStorConfig) => QingStorConfigRedacted;
 export declare const normalizeQingStorConfig: (input: Record<string, unknown>) => QingStorConfig;
 export {};

package/dist/vfs/qingstor/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/vfs/qingstor/config.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAGlF,QAAA,MAAM,oBAAoB;;;;;;;gCAAyB,CAAA;AAEnD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAA;AAO3F,eAAO,MAAM,wBAAwB,gDAAyB,CAAA;AAC9D,eAAO,MAAM,kBAAkB,qFAAmB,CAAA;AAClD,eAAO,MAAM,oBAAoB,oDAAe,CAAA;AAChD,eAAO,MAAM,uBAAuB,oDAAkB,CAAA"}

package/dist/vfs/qingstor/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/vfs/qingstor/config.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExF,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAA;AAMnD,MAAM,KAAK,GAAG,kBAAkB,CAAyC;IACvE,MAAM,EAAE,oBAAoB;IAC5B,WAAW,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,MAAM,eAAe,CAAC;CACxF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC,gBAAgB,CAAA;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,UAAU,CAAA;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAA;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC,SAAS,CAAA"}

package/dist/{resource/r2 → vfs/qingstor}/prompt.d.ts

@@ -1,2 +1,2 @@
-export declare const R2_BROWSER_PROMPT = "{prefix}\n  Remote Cloudflare R2 bucket accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
+export declare const PROMPT = "{prefix}\n  Remote QingStor bucket (S3-compatible) accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
 //# sourceMappingURL=prompt.d.ts.map

package/dist/vfs/qingstor/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/vfs/qingstor/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,MAAM,wVAIyD,CAAA"}

package/dist/{resource → vfs}/qingstor/prompt.js

@@ -11,7 +11,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-export const QINGSTOR_BROWSER_PROMPT = `{prefix}
+export const PROMPT = `{prefix}
   Remote QingStor bucket (S3-compatible) accessed via presigned URLs (browser runtime).
   Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.
   Listing operations require the presigner to sign LIST/COPY operations in

package/dist/{resource/oci → vfs/qingstor}/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/resource/oci/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;4EAI0C,CAAA"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/vfs/qingstor/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,MAAM,GAAG;;;;4EAIsD,CAAA"}

package/dist/vfs/qingstor/qingstor.d.ts

@@ -0,0 +1,8 @@
+import { S3AliasVFS, type S3AliasVFSState } from '../s3_alias.ts';
+import { type QingStorConfig, type QingStorConfigRedacted } from './config.ts';
+export type QingStorVFSState = S3AliasVFSState<QingStorConfigRedacted>;
+export declare class QingStorVFS extends S3AliasVFS<QingStorConfig, QingStorConfigRedacted> {
+    readonly prompt: string;
+    constructor(config: QingStorConfig);
+}
+//# sourceMappingURL=qingstor.d.ts.map

package/dist/vfs/qingstor/qingstor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qingstor.d.ts","sourceRoot":"","sources":["../../../src/vfs/qingstor/qingstor.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAA;AAGpB,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC,sBAAsB,CAAC,CAAA;AAEtE,qBAAa,WAAY,SAAQ,UAAU,CAAC,cAAc,EAAE,sBAAsB,CAAC;IACjF,SAAkB,MAAM,EAAE,MAAM,CAAS;gBAE7B,MAAM,EAAE,cAAc;CAGnC"}

package/dist/{resource → vfs}/qingstor/qingstor.js

@@ -11,14 +11,14 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { ResourceName } from '@struktoai/mirage-core/types';
-import { S3AliasResource } from "../s3_alias.js";
+import { VFSName } from '@struktoai/mirage-core/types';
+import { S3AliasVFS } from "../s3_alias.js";
 import { qingStorToS3Config, redactQingStorConfig, } from "./config.js";
-import { QINGSTOR_BROWSER_PROMPT } from "./prompt.js";
-export class QingStorResource extends S3AliasResource {
-    prompt = QINGSTOR_BROWSER_PROMPT;
+import { PROMPT } from "./prompt.js";
+export class QingStorVFS extends S3AliasVFS {
+    prompt = PROMPT;
     constructor(config) {
-        super(ResourceName.QINGSTOR, config, qingStorToS3Config(config), redactQingStorConfig);
+        super(VFSName.QINGSTOR, config, qingStorToS3Config(config), redactQingStorConfig);
     }
 }
 //# sourceMappingURL=qingstor.js.map

package/dist/vfs/qingstor/qingstor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qingstor.js","sourceRoot":"","sources":["../../../src/vfs/qingstor/qingstor.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AACtD,OAAO,EAAE,UAAU,EAAwB,MAAM,gBAAgB,CAAA;AACjE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIpC,MAAM,OAAO,WAAY,SAAQ,UAAkD;IAC/D,MAAM,GAAW,MAAM,CAAA;IAEzC,YAAY,MAAsB;QAChC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAA;IACnF,CAAC;CACF"}

package/dist/{resource → vfs}/r2/config.d.ts

@@ -1,8 +1,8 @@
-import { z } from '@struktoai/mirage-core/resource/secrets';
-import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/resource/secrets';
+import { z } from '@struktoai/mirage-core/vfs/secrets';
+import type { ConfigOf, RedactedConfig } from '@struktoai/mirage-core/vfs/secrets';
 declare const R2ConfigSchema: z.ZodObject<{
     bucket: z.ZodString;
-    presignedUrlProvider: z.ZodCustom<import("@struktoai/mirage-core/resource/s3/config").S3BrowserPresignedUrlProvider, import("@struktoai/mirage-core/resource/s3/config").S3BrowserPresignedUrlProvider>;
+    presignedUrlProvider: z.ZodCustom<import("@struktoai/mirage-core/vfs/s3/config").S3BrowserPresignedUrlProvider, import("@struktoai/mirage-core/vfs/s3/config").S3BrowserPresignedUrlProvider>;
     region: z.ZodOptional<z.ZodString>;
     endpoint: z.ZodOptional<z.ZodString>;
     defaultContentType: z.ZodOptional<z.ZodString>;
@@ -13,7 +13,7 @@ declare const R2ConfigSchema: z.ZodObject<{
 export type R2Config = ConfigOf<typeof R2ConfigSchema>;
 export type R2ConfigRedacted = RedactedConfig<R2Config, 'presignedUrlProvider'>;
 export declare const resolvedR2Endpoint: (config: R2Config) => string | undefined;
-export declare const r2ToS3Config: (config: R2Config) => import("@struktoai/mirage-core/resource/s3/config").S3Config;
+export declare const r2ToS3Config: (config: R2Config) => import("@struktoai/mirage-core/vfs/s3/config").S3Config;
 export declare const redactR2Config: (config: R2Config) => R2ConfigRedacted;
 export declare const normalizeR2Config: (input: Record<string, unknown>) => R2Config;
 export {};

package/dist/vfs/r2/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/vfs/r2/config.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,oCAAoC,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAGlF,QAAA,MAAM,cAAc;;;;;;;;;iBAA2D,CAAA;AAE/E,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,cAAc,CAAC,CAAA;AAEtD,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAA;AAW/E,eAAO,MAAM,kBAAkB,0CAAyB,CAAA;AACxD,eAAO,MAAM,YAAY,+EAAmB,CAAA;AAC5C,eAAO,MAAM,cAAc,wCAAe,CAAA;AAC1C,eAAO,MAAM,iBAAiB,8CAAkB,CAAA"}

package/dist/{resource → vfs}/r2/config.js

@@ -11,7 +11,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { z } from '@struktoai/mirage-core/resource/secrets';
+import { z } from '@struktoai/mirage-core/vfs/secrets';
 import { browserAliasSchema, derivedEndpoint, makeBrowserS3Alias } from "../s3_alias.js";
 const R2ConfigSchema = browserAliasSchema({ accountId: z.string().optional() });
 const alias = makeBrowserS3Alias({

package/dist/vfs/r2/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/vfs/r2/config.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,CAAC,EAAE,MAAM,oCAAoC,CAAA;AAEtD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExF,MAAM,cAAc,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;AAM/E,MAAM,KAAK,GAAG,kBAAkB,CAA6B;IAC3D,MAAM,EAAE,cAAc;IACtB,WAAW,EAAE,eAAe,CAC1B,WAAW,EACX,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,SAAS,2BAA2B,CAC/D;IACD,aAAa,EAAE,MAAM;CACtB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,gBAAgB,CAAA;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAA;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAA;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC,SAAS,CAAA"}

package/dist/vfs/r2/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const PROMPT = "{prefix}\n  Remote Cloudflare R2 bucket accessed via presigned URLs (browser runtime).\n  Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.\n  Listing operations require the presigner to sign LIST/COPY operations in\n  addition to GET/PUT/HEAD/DELETE \u2014 see S3BrowserPresignedUrlProvider docs.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/vfs/r2/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/vfs/r2/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,MAAM,6UAIyD,CAAA"}

package/dist/{resource → vfs}/r2/prompt.js

@@ -11,7 +11,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-export const R2_BROWSER_PROMPT = `{prefix}
+export const PROMPT = `{prefix}
   Remote Cloudflare R2 bucket accessed via presigned URLs (browser runtime).
   Supports the full filesystem command set: ls/tree/cat/grep/find/du/cp/mv/rm/etc.
   Listing operations require the presigner to sign LIST/COPY operations in

package/dist/vfs/r2/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/vfs/r2/prompt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,MAAM,CAAC,MAAM,MAAM,GAAG;;;;4EAIsD,CAAA"}

package/dist/vfs/r2/r2.d.ts

@@ -0,0 +1,8 @@
+import { S3AliasVFS, type S3AliasVFSState } from '../s3_alias.ts';
+import { type R2Config, type R2ConfigRedacted } from './config.ts';
+export type R2VFSState = S3AliasVFSState<R2ConfigRedacted>;
+export declare class R2VFS extends S3AliasVFS<R2Config, R2ConfigRedacted> {
+    readonly prompt: string;
+    constructor(config: R2Config);
+}
+//# sourceMappingURL=r2.d.ts.map

package/dist/vfs/r2/r2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.d.ts","sourceRoot":"","sources":["../../../src/vfs/r2/r2.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAAgC,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGhG,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAA;AAE1D,qBAAa,KAAM,SAAQ,UAAU,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAC/D,SAAkB,MAAM,EAAE,MAAM,CAAS;gBAE7B,MAAM,EAAE,QAAQ;CAG7B"}

package/dist/{resource → vfs}/r2/r2.js

@@ -11,14 +11,14 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { ResourceName } from '@struktoai/mirage-core/types';
-import { S3AliasResource } from "../s3_alias.js";
+import { VFSName } from '@struktoai/mirage-core/types';
+import { S3AliasVFS } from "../s3_alias.js";
 import { r2ToS3Config, redactR2Config } from "./config.js";
-import { R2_BROWSER_PROMPT } from "./prompt.js";
-export class R2Resource extends S3AliasResource {
-    prompt = R2_BROWSER_PROMPT;
+import { PROMPT } from "./prompt.js";
+export class R2VFS extends S3AliasVFS {
+    prompt = PROMPT;
     constructor(config) {
-        super(ResourceName.R2, config, r2ToS3Config(config), redactR2Config);
+        super(VFSName.R2, config, r2ToS3Config(config), redactR2Config);
     }
 }
 //# sourceMappingURL=r2.js.map

package/dist/vfs/r2/r2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.js","sourceRoot":"","sources":["../../../src/vfs/r2/r2.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AACtD,OAAO,EAAE,UAAU,EAAwB,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAwC,MAAM,aAAa,CAAA;AAChG,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIpC,MAAM,OAAO,KAAM,SAAQ,UAAsC;IAC7C,MAAM,GAAW,MAAM,CAAA;IAEzC,YAAY,MAAgB;QAC1B,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAA;IACjE,CAAC;CACF"}