@ibgib/web-gib 0.0.1

package/dist/witness/space/metaspace/metaspace-webspace/metaspace-webspace.mjs

@@ -0,0 +1,389 @@
+/**
+ * @module metaspace-webspace driven by a web indexeddb storage substrate
+ *
+ * a metaspace is a space of spaces. it adds/removes spaces and does
+ * inter-spatial composition related things. it's similar to what people think
+ * of in terms of a node in a p2p network.
+ */
+import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { MetaspaceBase } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-base.mjs';
+import { GLOBAL_LOG_A_LOT, GLOBAL_TIMER_NAME, } from '../../../../constants.mjs';
+import { fnCreateNewLocalSpace, fnDtoToSpace_webFilesystem } from './metaspace-webspace-helper.mjs';
+import { WebFilesystemSpace_V1 } from '../../web-filesystem-space/web-filesystem-space-v1.mjs';
+// import { storageCreateStoreIfNotExist, initializeStorage, storageDBExists, } from '../../../../helpers.web.mjs';
+import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
+import { storageCreateStoreIfNotExist } from '../../../../storage/storage-helpers.web.mjs';
+import { validateIbGibIntrinsically } from '@ibgib/ts-gib/dist/V1/validate-helper.mjs';
+import { execInSpaceWithLocking } from '@ibgib/core-gib/dist/witness/space/space-helper.mjs';
+import { getGlobalDbName } from '../../../../helpers.web.mjs';
+const logalot = GLOBAL_LOG_A_LOT;
+const NAIVE_SPACE_CACHE = new Map();
+const ZERO_SPACE_CACHE_ADDR = 'zero_space^gib';
+const STORES_CONFIRMED = new Set();
+/**
+ * All-purpose mega service (todo: which we'll need to break up!) to interact
+ * with ibgibs at the app/device level.
+ *
+ * This works with the local app user space.
+ *
+ * ## regarding special ibgibs
+ *
+ * Special ibgibs' behaviors are what hold in other apps configuration data.
+ * Of course the difference is that most special ibgibs can leverage the "on-chain"
+ * functionality of "regular" ibgibs.
+ *
+ * There are a couple meta ibgibs (which I also call "special"):
+ *   * roots^gib
+ *     * tracks other special root^gib ibgibs, which are like local app-level indexes.
+ *   * tags^gib
+ *     * tracks other special tag^gib ibgibs, which you can apply to any ibgib
+ *   * latest^gib
+ *     * tracks mappings between tjp -> latest ib^gib address
+ *     * ephemeral (deletes past rel8ns and past ibGib frames)
+ *   * ...
+ *
+ * ## regarding latest ibgibs
+ *
+ * The tjp (temporal junction point) defines atow the beginning of an ibGib
+ * timeline.  it's like the birthday for an ibGib. (Or you can think if it as
+ * the id for the stream of ibgib frames in a given timeline.)
+ *
+ * The latest ibGib in that timeline is also special, because it's often what
+ * you want to work with.
+ *
+ * So ideally, when an ibgib, A, has a tjp A1, and it is updated to A2, A3, An
+ * via `mut8` and/or `rel8` transforms, that ibgib creates a single timeline.
+ * This service attempts to track the relationship between that starting tjp
+ * address and its corresponding latest frame in that timeline, i.e., A1 -> An.
+ *
+ * ### mapping persistence implementation details
+ *
+ * The latest ibGib service is backed by a special ibgib that maintains the
+ * mapping index.  It does this by rel8-ing that special backing ibgib via the
+ * tjp pointer, e.g. [special latest ibgib^XXX000].rel8ns[A^TJP123] ===
+ * [A^N12345] . It does this via the ib^gib content address pointer, so this
+ * becomes a mapping from A^TJP123 to A^N12345.
+ *
+ * This backing ibGib is special (even for special ibGibs) in that:
+ *   * it does not relate itself with the current root of the application
+ *   * it does not maintain references to its past (i.e. rel8ns['past'] === [])
+ *   * it DELETES its previous incarnation from the files service
+ *
+ * In other words, this service is meant to be as ephemeral as possible. I am
+ * keeping it as an ibGib and not some other data format (like straight in
+ * storage/some other db) because I've found this is often useful and what I end
+ * up doing anyway to leverage other ibgib behavior. For example, in the future
+ * it may be good to take snapshots, which is a simple copy operation of the
+ * file persistence.
+ *
+ * ### current naive implementation notes
+ *
+ * questions:
+ *   * What do we want to do if we can't locate an ibGib record?
+ *   * How/when do we want to alert the user/our own code that we've found
+ *     multiple timelines for an ibGib with a tjp (usually a thing we want to
+ *     avoid)?
+ *   * Who do we want to notify when new ibGibs arrive?
+ *   * How often do we want to check external sources for latest?
+ *   * When do we get to merging ibGib timelines?
+ *
+ * This is behavior that is somewhat taken care of, e.g. in git, with the HEAD
+ * pointer for a repo.  But we're talking about here basically as a metarepo or
+ * "repo of repos", and unlike git, we don't want our HEAD metadata living "off
+ * chain" (outside of the DLT itself that it's modifying).  So eventually, what
+ * we want is just like what we want with ALL ibGibs: perspective. From "the
+ * app"'s perspective, the latest is mapped. But really, apps can't view slices
+ * of ibGib graphs in all sorts of interesting ways and still be productive &
+ * beneficial to the ecosystem as a whole.
+ */
+export class Metaspace_Webspace extends MetaspaceBase {
+    cacheSvc;
+    // we won't get an object back, only a DTO ibGib essentially
+    lc = `[${Metaspace_Webspace.name}]`;
+    get zeroSpace() {
+        const lc = `[${this.lc}][get zeroSpace]`;
+        if (NAIVE_SPACE_CACHE.has(ZERO_SPACE_CACHE_ADDR)) {
+            return NAIVE_SPACE_CACHE.get(ZERO_SPACE_CACHE_ADDR);
+        }
+        else if (this.metaspaceFactory.fnZeroSpaceFactory) {
+            const zeroSpace = this.metaspaceFactory.fnZeroSpaceFactory();
+            NAIVE_SPACE_CACHE.set(ZERO_SPACE_CACHE_ADDR, zeroSpace);
+            return zeroSpace;
+        }
+        else {
+            throw new Error(`${lc} (UNEXPECTED) this.metaspaceFactory.fnZeroSpaceFactory falsy. not initialized? (E: 9e6c6954dacd868b18c9f34a71e63523)`);
+        }
+    }
+    constructor(
+    // public modalController: ModalController,
+    // public alertController: AlertController,
+    cacheSvc) {
+        super(cacheSvc);
+        this.cacheSvc = cacheSvc;
+        const lc = `${this.lc}[ctor]`;
+        if (logalot) {
+            console.log(`${lc}${GLOBAL_TIMER_NAME}`);
+            console.timeLog(GLOBAL_TIMER_NAME);
+            console.log(`${lc} created. (I: 5690dc2ebf774df3a442bd463dee7455)`);
+        }
+    }
+    async initializeMetaspaceFactory({ metaspaceFactory }) {
+        const lc = `[${this.initializeMetaspaceFactory.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 5a29670439ac47634dcdfe25225c8223)`);
+            }
+            await super.initializeMetaspaceFactory({ metaspaceFactory });
+            metaspaceFactory.fnDefaultLocalSpaceFactory ??= async (opts) => {
+                const createdSpace = await fnCreateNewLocalSpace(opts);
+                if (!createdSpace) {
+                    throw new Error(`(UNEXPECTED) createdSpace undefined? (E: 21258175efdd1a9cb1f9fc8ab59e0324)`);
+                }
+                if (!createdSpace.data?.uuid) {
+                    throw new Error(`(UNEXPECTED) createdSpace.data.uuid undefined? (E: 0a6c44c078d9e21e92f703adbc995c24)`);
+                }
+                // ensure the local space exists in storage (db & store)
+                const storeNameForSpace = createdSpace.data.uuid;
+                await storageCreateStoreIfNotExist({
+                    dbName: getGlobalDbName(),
+                    storeName: storeNameForSpace,
+                    logalot,
+                });
+                // cache newly created space
+                const spaceAddr = getIbGibAddr({ ibGib: createdSpace });
+                NAIVE_SPACE_CACHE.set(spaceAddr, createdSpace);
+                // return it
+                return createdSpace;
+            };
+            metaspaceFactory.fnDtoToSpace ??= async (spaceDto) => {
+                // first ensure that the store exists in IndexedDB
+                const storeNameForSpace = spaceDto.data?.uuid;
+                if (!storeNameForSpace) {
+                    throw new Error(`spaceDto.data?.uuid falsy? (E: b73bded9ebede92b8ef53b8d05dca225)`);
+                }
+                if (!STORES_CONFIRMED.has(storeNameForSpace)) {
+                    await storageCreateStoreIfNotExist({
+                        dbName: getGlobalDbName(),
+                        storeName: storeNameForSpace,
+                        logalot,
+                    });
+                    STORES_CONFIRMED.add(storeNameForSpace);
+                }
+                // get the space from cache if available, else create it
+                const spaceAddr = getIbGibAddr({ ibGib: spaceDto });
+                let resSpace = NAIVE_SPACE_CACHE.get(spaceAddr);
+                resSpace = undefined; // testing bug
+                if (!resSpace) {
+                    resSpace = await fnDtoToSpace_webFilesystem(spaceDto);
+                    if (!resSpace.data?.uuid) {
+                        throw new Error(`(UNEXPECTED) resCreateNewSpace.data.uuid undefined? (E: f1e0e75f02b607b349b4102a8c8f7724)`);
+                    }
+                    NAIVE_SPACE_CACHE.set(spaceAddr, resSpace);
+                }
+                return resSpace;
+            };
+            this.metaspaceFactory.fnZeroSpaceFactory ??= () => {
+                // default to web space
+                const zeroSpace = new WebFilesystemSpace_V1(/*initialData*/ undefined, /*initialRel8ns*/ undefined);
+                zeroSpace.gib = 'gib';
+                return zeroSpace;
+            };
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    async initialize(args) {
+        const lc = `${this.lc}[${this.initialize.name}]`;
+        // const {
+        //   spaceName,
+        //   metaspaceFactory,
+        //   getFnAlert, getFnPrompt, getFnPromptPassword,
+        // } = args;
+        await this.initializeZeroSpace();
+        await super.initialize(args);
+    }
+    async initializeZeroSpace() {
+        const lc = `[${this.initializeZeroSpace.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: a3364e9601c70c8163e67868e5d67723)`);
+            }
+            // make sure the db and store exist for the zero space.
+            // I'll reuse storagePut to ensure the store exists for the zero space?
+            // is this initilizeStorage necessary with the initialization as
+            // referenced in the proceeding code with storageCreateStoreIfNotExist?
+            // await initializeStorage({
+            //   dbName: BLANK_GIB_DB_NAME,
+            //   storeName: ZERO_SPACE_ID,
+            //   logalot,
+            // });
+            if (logalot) {
+                console.log(`${lc} we are assuming zero space storage is initialized in indexed db. atow (03/2025), this is done in initBlankGibStorage in index.mts (I: cb1dd69b21efc2fc366956349e865125)`);
+            }
+            // this is now done in initBlankGibStorage in index.mts
+            // await storageCreateStoreIfNotExist({
+            //   dbName: BLANK_GIB_DB_NAME,
+            //   storeName: ZERO_SPACE_ID,
+            //   logalot,
+            // });
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * I'm overriding this to troubleshoot figuring out why the space is
+     * becoming invalid.
+     */
+    async getLocalUserSpace({ lock, localSpaceId, }) {
+        const lc = `${this.lc}[${this.getLocalUserSpace.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: e68ae7f617e4a1af026ab1ac1c52f425)`);
+            }
+            const space = await super.getLocalUserSpace({ lock, localSpaceId });
+            if (!space) {
+                console.error(`(UNEXPECTED) local user space falsy? NOTE: This error is just logged, not thrown as I don't know if this is always improper behavior. (E: 3c7cac40d11b26c3fd95183d06ffc225)`);
+                return space; /* <<<< returns early */
+            }
+            const errors = await validateIbGibIntrinsically({ ibGib: space }) ?? [];
+            if (errors.length > 0) {
+                // debugger; // space is invalid intrinsically? I'm putting this here to try to troubleshoot how this is coming to be.
+                console.error(`(UNEXPECTED) local user space is invalid intrinsically? when did this happen? (E: df5c8e62c204a6972e364fa33d9b7725)`);
+            }
+            return space;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    /**
+     * overriding to try to execute serially via commanding architecture.
+     *
+     * just wraps super call with {@link commandifyAnonFn}.
+     *
+     * @see {@link commandifyAnonFn}
+     */
+    async rel8ToCurrentRoot(opts) {
+        const lc = `${this.lc}[${this.rel8ToCurrentRoot.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 0f999532d51b1ad2084ed30670297125)`);
+            }
+            // const cmd = commandifyAnonFn<any>({
+            //     fn: () => {
+            const space = opts.space ?? await this.getLocalUserSpace({});
+            if (!space) {
+                throw new Error(`(UNEXPECTED) space falsy and couldn't get default local user space? (E: e8b63af1b0fb692c4761fe9627eaf525)`);
+            }
+            await execInSpaceWithLocking({
+                fn: async () => {
+                    const lc = `${this.lc}[${this.rel8ToCurrentRoot.name}]`;
+                    try {
+                        if (logalot) {
+                            console.log(`${lc} starting... (I: 5444c70bd93b13b59ef9cd06ee72d825)`);
+                        }
+                        return super.rel8ToCurrentRoot(opts);
+                    }
+                    catch (error) {
+                        console.error(`${lc} ${extractErrorMsg(error)}`);
+                        throw error;
+                    }
+                    finally {
+                        if (logalot) {
+                            console.log(`${lc} complete.`);
+                        }
+                    }
+                },
+                scope: lc,
+                secondsValid: 60,
+                maxDelayMs: 100,
+                maxLockAttempts: 600,
+                space,
+                callerInstanceId: this.instanceId,
+            });
+            // debugger; // before viacmd?
+            // const result = cmd.fnViaCmd();
+            // debugger; // after viacmd?
+            // return result;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+    async rel8ToSpecialIbGib(opts) {
+        const lc = `${this.lc}[${this.rel8ToSpecialIbGib.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: 906d2e553f163405f3238f141ed6fb25)`);
+            }
+            // const { type, rel8nName, ibGibsToRel8, ibGibsToUnRel8, linked, severPast, deletePreviousSpecialIbGib, space, } = opts;
+            const space = opts.space ?? await this.getLocalUserSpace({});
+            if (!space) {
+                throw new Error(`(UNEXPECTED) space falsy and couldn't get default local user space? (E: 3c587503d08aa8b8cda25bb7064bf125)`);
+            }
+            const result = await execInSpaceWithLocking({
+                fn: async () => {
+                    const lc = `${this.lc}[${this.rel8ToCurrentRoot.name}]`;
+                    try {
+                        if (logalot) {
+                            console.log(`${lc} starting... (I: 3b9f44934d88196bc3d0087cadd23125)`);
+                        }
+                        return super.rel8ToSpecialIbGib(opts);
+                    }
+                    catch (error) {
+                        console.error(`${lc} ${extractErrorMsg(error)}`);
+                        throw error;
+                    }
+                    finally {
+                        if (logalot) {
+                            console.log(`${lc} complete.`);
+                        }
+                    }
+                },
+                scope: lc,
+                secondsValid: 60,
+                maxDelayMs: 100,
+                maxLockAttempts: 600,
+                space,
+                callerInstanceId: this.instanceId,
+            });
+            return result;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=metaspace-webspace.mjs.map

package/dist/witness/space/metaspace/metaspace-webspace/metaspace-webspace.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaspace-webspace.mjs","sourceRoot":"","sources":["../../../../../src/witness/space/metaspace/metaspace-webspace/metaspace-webspace.mts"],"names":[],"mappings":"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"}

package/dist/witness/space/web-filesystem-space/web-filesystem-space-constants.d.mts

@@ -0,0 +1,2 @@
+export declare const INDEXED_DB_LONG_PATH_LENGTH = 9999999999999;
+//# sourceMappingURL=web-filesystem-space-constants.d.mts.map

package/dist/witness/space/web-filesystem-space/web-filesystem-space-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-filesystem-space-constants.d.mts","sourceRoot":"","sources":["../../../../src/witness/space/web-filesystem-space/web-filesystem-space-constants.mts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,gBAAgB,CAAC"}

package/dist/witness/space/web-filesystem-space/web-filesystem-space-constants.mjs

@@ -0,0 +1,2 @@
+export const INDEXED_DB_LONG_PATH_LENGTH = 9999999999999;
+//# sourceMappingURL=web-filesystem-space-constants.mjs.map

package/dist/witness/space/web-filesystem-space/web-filesystem-space-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-filesystem-space-constants.mjs","sourceRoot":"","sources":["../../../../src/witness/space/web-filesystem-space/web-filesystem-space-constants.mts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,aAAa,CAAC"}

package/dist/witness/space/web-filesystem-space/web-filesystem-space-helper.d.mts

@@ -0,0 +1,104 @@
+/**
+ * @module web-filesystem-space-helper
+ */
+import { WebFilesystemSpace_V1 } from './web-filesystem-space-v1.mjs';
+import { FileDataInfo, FileEncoding } from './web-filesystem-space-types.mjs';
+import { Dirent } from '../../../storage/storage-types.web.mjs';
+/**
+ * tries to read the given path. if fails **FOR ANY REASON**, @returns `null`.
+ *
+ * does not throw
+ *
+ * @returns file contents as string or `null`
+ */
+export declare function tryRead({ path, directory, encoding, }: {
+    path: string;
+    directory: string;
+    encoding: string;
+}): Promise<string | Uint8Array | null>;
+export declare function tryRead_bin({ path, directory, encoding, }: {
+    path: string;
+    directory: string;
+    encoding: string;
+}): Promise<FileDataInfo | null>;
+/**
+ * basic validation for a web fs space ibgib
+ */
+export declare function validateWebFilesystemSpace_V1Intrinsically({ space }: {
+    space: WebFilesystemSpace_V1<any, any>;
+}): Promise<string[] | null>;
+/**
+ * gets the data and encoding of a given {@link inputPath} if that file exists.
+ * if it doesn't exist, this will throw an ENOENT error, but this is not logged
+ * as an error.
+ *
+ * this is because atow (03/2024) this is only used in a tryRead_bin function
+ * where the file often does not exist.
+ */
+export declare function getFileDataAndEncoding({ inputPath, encodingsToTry, }: {
+    inputPath: string;
+    /**
+     * ignored in web version
+     */
+    encodingsToTry?: (FileEncoding | undefined)[];
+}): Promise<FileDataInfo>;
+/**
+ * Writes a "file" to the "filesystem" using IndexedDB.
+ *
+ * This overload in the node version is used for writing string files (i.e.
+ * non-binary utf-8 files).
+ *
+ * @param fullPath path to write to
+ * @param data data to write
+ * @param encoding ignored atow (11/2024) in this web version of this function.
+ */
+export declare function writeFile(fullPath: string, data: any, encoding: any): Promise<void>;
+/**
+ * Writes a "file" to the "filesystem" using IndexedDB.
+ *
+ * ATOW (12/2024) this assumes the fullPath is in the form of
+ *
+ *   [dbName]/
+ *
+ * This overload in the node version is used for writing binary files.
+ *
+ * @param fullPath path to write to
+ * @param data data to write
+ */
+export declare function writeFile(fullPath: string, data: any): Promise<void>;
+export declare function readFile(fullPath: any, opts?: {
+    encoding: string;
+}): Promise<string | Uint8Array | undefined>;
+export declare function rm(fullPath: string, opts: {
+    /**
+     * ignored in web version atow (11/2024)
+     */
+    force: boolean;
+}): Promise<void>;
+/**
+ * is this necessary in web version?
+ * @param fullPath
+ * @param opts
+ */
+export declare function mkdirSync(fullPath: string, opts: {
+    recursive: boolean;
+}): void;
+/**
+ * mimic node's readdir when `withFileTypes` is true.
+ *
+ * in this overload, returns mimicked `Dirent[]`
+ */
+export declare function readdir(containingDir: string, opts: {
+    withFileTypes: true;
+    recursive?: boolean;
+}): Promise<Dirent[]>;
+/**
+ * mimic node's readdir when `withFileTypes` is falsy.
+ *
+ * in this overload, returns `string[]`
+ */
+export declare function readdir(containingDir: string, opts?: {
+    withFileTypes?: false;
+    recursive?: boolean;
+}): Promise<string[]>;
+//# sourceMappingURL=web-filesystem-space-helper.d.mts.map

package/dist/witness/space/web-filesystem-space/web-filesystem-space-helper.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-filesystem-space-helper.d.mts","sourceRoot":"","sources":["../../../../src/witness/space/web-filesystem-space/web-filesystem-space-helper.mts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAkD,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAG9H,OAAO,EAAE,MAAM,EAAE,MAAM,wCAAwC,CAAC;AAKhE;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,EAC1B,IAAI,EACJ,SAAS,EACT,QAAQ,GACX,EAAE;IACC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,CA+BtC;AAED,wBAAsB,WAAW,CAAC,EAC9B,IAAI,EACJ,SAAS,EACT,QAAQ,GACX,EAAE;IACC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAqC/B;AAED;;GAEG;AACH,wBAAsB,0CAA0C,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CA+FhJ;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,EACzC,SAAS,EACT,cAA+C,GAClD,EAAE;IACC,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC;CACjD,GAAG,OAAO,CAAC,YAAY,CAAC,CA4FxB;AAkCD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACrF;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AA0BtE,wBAAsB,QAAQ,CAC1B,QAAQ,EAAE,GAAG,EACb,IAAI,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;CAAE,GAC7B,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC,CAc1C;AAED,wBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAC7C;;OAEG;IACH,KAAK,EAAE,OAAO,CAAA;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAG9E;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CACzB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE;IAAE,aAAa,EAAE,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACrB;;;;GAIG;AACH,wBAAsB,OAAO,CACzB,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC"}