@grest-ts/testkit 0.0.5

package/dist/src/GGTest.js

@@ -0,0 +1,245 @@
+import { GG_TEST_RESOURCE, GG_TEST_RUNNER } from "./GGTestRunner.js";
+import { GGTestMode, GGTestRuntime } from "./GGTestRuntime.js";
+import { createStartResult } from "./testers/GGTestSelector.js";
+/**
+ * Static API for test setup operations.
+ * Use GGTest.startWorker(), GGTest.with(), etc. in test files.
+ *
+ * @example
+ * // Single runtime
+ * const t = GGTest.startWorker(MainRuntime);
+ * t.logs.cursor();
+ *
+ * // Multiple instances
+ * const t = GGTest.startWorker([MainRuntime, MainRuntime]);
+ * t[0].logs.cursor();
+ *
+ * // Named runtimes
+ * const t = GGTest.startWorker({main: MainRuntime, sub: SubRuntime});
+ * t.main.logs.cursor();
+ * t.sub.config.update();
+ */
+export class GGTest {
+    // -------------------------------------------------
+    // Private state for runtime management
+    // -------------------------------------------------
+    // When GG_COVERAGE_MODE is set, force INLINE mode for all runtimes
+    // This is needed because v8 coverage doesn't capture worker_threads or child_process
+    static forceCoverageInline = process.env.GG_COVERAGE_MODE === '1';
+    // -------------------------------------------------
+    // Public static methods
+    // -------------------------------------------------
+    /**
+     * Get a resource wrapper for calling test operations.
+     * Returns an object with methods defined by the resource's [GG_TEST_RESOURCE].
+     *
+     * @example
+     * GGTest.with(MyConfig.mysql).clone();
+     * GGTest.with(MyConfig.mysql).clone("seed.sql");
+     */
+    static with(resource) {
+        return resource[GG_TEST_RESOURCE];
+    }
+    /**
+     * Start runtimes in inline mode.
+     * Inline mode runs the service code in the same process as the test.
+     *
+     * @example
+     * // Single runtime
+     * const t = GGTest.startInline(MainRuntime);
+     *
+     * // Array of runtimes (multiple instances)
+     * const t = GGTest.startInline([MainRuntime, MainRuntime]);
+     *
+     * // Object with named runtimes
+     * const t = GGTest.startInline({main: MainRuntime, sub: SubRuntime});
+     */
+    static startInline(input) {
+        return this.startWithMode(input, GGTestMode.INLINE);
+    }
+    /**
+     * Start runtimes in worker mode.
+     * Worker mode runs the service code in a worker thread.
+     *
+     * @example
+     * // Single runtime
+     * const t = GGTest.startWorker(MainRuntime);
+     *
+     * // Array of runtimes (multiple instances)
+     * const t = GGTest.startWorker([MainRuntime, MainRuntime]);
+     *
+     * // Object with named runtimes
+     * const t = GGTest.startWorker({main: MainRuntime, sub: SubRuntime});
+     */
+    static startWorker(input) {
+        return this.startWithMode(input, GGTestMode.WORKER);
+    }
+    /**
+     * Start runtimes in isolated mode.
+     * Isolated mode runs the service code in a separate process.
+     *
+     * @example
+     * // Single runtime
+     * const t = GGTest.startIsolated(MainRuntime);
+     *
+     * // Array of runtimes (multiple instances)
+     * const t = GGTest.startIsolated([MainRuntime, MainRuntime]);
+     *
+     * // Object with named runtimes
+     * const t = GGTest.startIsolated({main: MainRuntime, sub: SubRuntime});
+     */
+    static startIsolated(input) {
+        return this.startWithMode(input, GGTestMode.ISOLATED);
+    }
+    /**
+     * Wait for an async expectation to be satisfied.
+     * Use this for standalone async expectations outside of action chains.
+     *
+     * Polls the expectation every 20ms until it's satisfied or timeout is reached.
+     *
+     * @param expectation - The expectation to wait for
+     * @param timeout - Max time to wait in ms (default: 5000)
+     *
+     * @example
+     * // Wait for a log after injecting an event
+     * await UserEventsPublisher.inject.registered({...});
+     * await GGTest.waitFor(t.logs.expect(/validation failed/i));
+     *
+     * @example
+     * // Wait for a metric to be incremented
+     * await GGTest.waitFor(t.main.metrics.expect(SomeMetric).inc({label: 'value'}));
+     */
+    static async waitFor(expectation, timeout = 5000) {
+        const interceptor = expectation.createInterceptor();
+        const checkInterval = 20;
+        const startTime = Date.now();
+        await interceptor.register();
+        try {
+            await new Promise((resolve, reject) => {
+                const check = () => {
+                    const elapsed = Date.now() - startTime;
+                    if (interceptor.isCalled()) {
+                        resolve();
+                        return;
+                    }
+                    if (elapsed > timeout) {
+                        reject(new Error(`[GGTest.waitFor] Timeout after ${timeout}ms waiting for expectation`));
+                        return;
+                    }
+                    setTimeout(check, checkInterval);
+                };
+                check();
+            });
+            await interceptor.validate();
+            const error = interceptor.getMockValidationError();
+            if (error) {
+                throw error;
+            }
+        }
+        finally {
+            await interceptor.unregister();
+        }
+    }
+    // -------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------
+    static startWithMode(input, mode) {
+        const test = GG_TEST_RUNNER.get();
+        const constructors = this.extractConstructors(input);
+        const runtimes = this.createRuntimes(test, constructors, { mode: this.getCoverageMode(mode) });
+        const result = createStartResult(input, runtimes);
+        if (test.started) {
+            // We're inside a test block - start immediately
+            // Cleanup is handled by the global afterEach registered in initInTestCleanup
+            const startupPromise = this.startRuntimesInTestBlock(runtimes);
+            return this.makeAwaitable(result, startupPromise);
+        }
+        else {
+            // We're in describe block - normal flow, runtimes start in beforeAll
+            // Return immediately-resolved thenable for consistency
+            return this.makeAwaitable(result, Promise.resolve());
+        }
+    }
+    /**
+     * Extract runtime constructors from the input in the order they should be created.
+     */
+    static extractConstructors(input) {
+        // Single runtime
+        if ('NAME' in input) {
+            return [input];
+        }
+        // Array of runtimes
+        if (Array.isArray(input)) {
+            return input;
+        }
+        // Object: { main: MainRuntime, sub: [SubRuntime, SubRuntime] }
+        const constructors = [];
+        for (const value of Object.values(input)) {
+            if (Array.isArray(value)) {
+                constructors.push(...value);
+            }
+            else {
+                constructors.push(value);
+            }
+        }
+        return constructors;
+    }
+    /**
+     * Start runtimes immediately (for in-test usage).
+     * Runtimes are automatically tracked by the runner for afterEach cleanup.
+     */
+    static async startRuntimesInTestBlock(runtimes) {
+        for (const runtime of runtimes) {
+            await runtime.start();
+        }
+    }
+    /**
+     * Makes a result thenable by adding a then() method.
+     * This allows both sync and async usage patterns.
+     *
+     * IMPORTANT: The then() method removes itself after being called to prevent
+     * infinite thenable resolution. When onfulfilled returns the result,
+     * JavaScript would try to resolve it again if then() still existed.
+     */
+    static makeAwaitable(result, startupPromise) {
+        const awaitable = result;
+        awaitable.then = (onfulfilled, onrejected) => {
+            // Remove then() to prevent infinite thenable resolution
+            delete awaitable.then;
+            return startupPromise.then(() => onfulfilled ? onfulfilled(result) : result, onrejected);
+        };
+        return awaitable;
+    }
+    static getCoverageMode(requestedMode) {
+        if (this.forceCoverageInline && requestedMode !== GGTestMode.INLINE) {
+            return GGTestMode.INLINE;
+        }
+        return requestedMode;
+    }
+    static createRuntimes(test, services, config) {
+        const createdRuntimes = [];
+        for (const service of services) {
+            const runtimeConstructor = service;
+            // Validate that runtime has NAME property
+            if (!runtimeConstructor.NAME) {
+                throw new Error(`Runtime '${service.name}' must define a static NAME property. ` +
+                    `Add 'public static readonly NAME = "yourname"' to the class.`);
+            }
+            // Validate that runtime has SOURCE_MODULE_URL (set by GGRuntime.cli())
+            if (!runtimeConstructor.SOURCE_MODULE_URL) {
+                throw new Error(`Runtime '${service.name}' has no source path. ` +
+                    `Make sure the runtime file calls: ${service.name}.cli(import.meta.url)`);
+            }
+            const className = service.name;
+            const name = runtimeConstructor.NAME;
+            const sourcePath = runtimeConstructor.SOURCE_MODULE_URL;
+            const runtime = new GGTestRuntime(test, sourcePath, className, name, config);
+            // Store factory for inline mode — avoids dynamic import which causes
+            // duplicate module loading in Vite/vitest environments
+            runtime.runtimeFactory = () => new runtimeConstructor();
+            createdRuntimes.push(runtime);
+        }
+        return createdRuntimes;
+    }
+}
+//# sourceMappingURL=GGTest.js.map

package/dist/src/GGTest.js.map

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

package/dist/src/GGTestContext.d.ts

@@ -0,0 +1,36 @@
+import { GGContext } from "@grest-ts/context";
+import { GGTestCallOn, GGTestCallOnCollection } from "./callOn/callOn";
+export declare class GGTestContext extends GGContext {
+    resetAfterEach(): this;
+    /**
+     * Register APIs and services for testing.
+     * Returns `this` merged with test clients for all registered items.
+     *
+     * @example
+     * const alice = new GGTestContext("alice")
+     *     .apisV2({
+     *         chain: ChainApi,           // HTTP API → test client
+     *         services: {
+     *             weather: WeatherService // Service class → testable access
+     *         }
+     *     });
+     *
+     * alice.chain.getWeather({...})           // HTTP test client
+     * alice.services.weather.getWeather({...}) // Testable service
+     */
+    apis<T extends object>(apis: T): this & GGTestCallOnCollection<T>;
+    /**
+     * Call a method on an API or service within this context.
+     * Creates and caches test clients/proxies for reuse.
+     *
+     * @example
+     * alice.callOn(ChainApi).getWeather({city: "NYC"})
+     * alice.callOn(WeatherService).getWeather("NYC")
+     */
+    callOn<T extends object>(target: T): GGTestCallOn<T>;
+    beforeAll(callback: () => void): this;
+    beforeEach(callback: () => void): this;
+    afterEach(callback: () => void): this;
+    afterAll(callback: () => void): this;
+}
+//# sourceMappingURL=GGTestContext.d.ts.map

package/dist/src/GGTestContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGTestContext.d.ts","sourceRoot":"","sources":["../../src/GGTestContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAA2B,YAAY,EAAE,sBAAsB,EAAC,MAAM,iBAAiB,CAAC;AAS/F,qBAAa,aAAc,SAAQ,SAAS;IAGjC,cAAc,IAAI,IAAI;IAO7B;;;;;;;;;;;;;;;OAeG;IACI,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,sBAAsB,CAAC,CAAC,CAAC;IAKxE;;;;;;;OAOG;IACI,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAIpD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAKrC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAKtC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAKrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CAI9C"}

package/dist/src/GGTestContext.js

@@ -0,0 +1,63 @@
+import { GGContext } from "@grest-ts/context";
+import { callOn, callOnCollection } from "./callOn/callOn.js";
+// Note: beforeAll, beforeEach, afterEach, afterAll are vitest globals
+// Do NOT import them directly - it breaks worker threads that load this module
+// ============================================================================
+// Test Collection Types
+// ============================================================================
+export class GGTestContext extends GGContext {
+    resetAfterEach() {
+        afterEach(() => {
+            this.reset();
+        });
+        return this;
+    }
+    /**
+     * Register APIs and services for testing.
+     * Returns `this` merged with test clients for all registered items.
+     *
+     * @example
+     * const alice = new GGTestContext("alice")
+     *     .apisV2({
+     *         chain: ChainApi,           // HTTP API → test client
+     *         services: {
+     *             weather: WeatherService // Service class → testable access
+     *         }
+     *     });
+     *
+     * alice.chain.getWeather({...})           // HTTP test client
+     * alice.services.weather.getWeather({...}) // Testable service
+     */
+    apis(apis) {
+        Object.assign(this, callOnCollection(apis, this));
+        return this;
+    }
+    /**
+     * Call a method on an API or service within this context.
+     * Creates and caches test clients/proxies for reuse.
+     *
+     * @example
+     * alice.callOn(ChainApi).getWeather({city: "NYC"})
+     * alice.callOn(WeatherService).getWeather("NYC")
+     */
+    callOn(target) {
+        return callOn(target, this);
+    }
+    beforeAll(callback) {
+        beforeAll(() => this.run(callback));
+        return this;
+    }
+    beforeEach(callback) {
+        beforeEach(() => this.run(callback));
+        return this;
+    }
+    afterEach(callback) {
+        afterEach(() => this.run(callback));
+        return this;
+    }
+    afterAll(callback) {
+        afterAll(() => this.run(callback));
+        return this;
+    }
+}
+//# sourceMappingURL=GGTestContext.js.map

package/dist/src/GGTestContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGTestContext.js","sourceRoot":"","sources":["../../src/GGTestContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAC,MAAM,EAAE,gBAAgB,EAAuC,MAAM,iBAAiB,CAAC;AAE/F,sEAAsE;AACtE,+EAA+E;AAE/E,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,OAAO,aAAc,SAAQ,SAAS;IAGjC,cAAc;QACjB,SAAS,CAAC,GAAG,EAAE;YACX,IAAI,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,IAAI,CAAmB,IAAO;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAClD,OAAO,IAAwC,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAmB,MAAS;QACrC,OAAO,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;IAEM,SAAS,CAAC,QAAoB;QACjC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,UAAU,CAAC,QAAoB;QAClC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,SAAS,CAAC,QAAoB;QACjC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,QAAQ,CAAC,QAAoB;QAChC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/dist/src/GGTestRunner.d.ts

@@ -0,0 +1,108 @@
+import { GGTestRuntime } from "./GGTestRuntime";
+import { IPCClientRequest, IPCServer } from "@grest-ts/ipc";
+import { GGLocatorKey } from "@grest-ts/locator";
+import { GGTestComponent, GGTestComponentType } from "./testers/GGTestComponent";
+import { IGGLocalDiscoveryServer } from "./IGGLocalDiscoveryServer";
+export declare const GG_TEST_RUNNER: GGLocatorKey<GGTestRunner>;
+/**
+ * Interface for test lifecycle hooks.
+ * Registered via GGTest.registerHook() to run setup/teardown logic.
+ */
+export interface GGTestRunnerHook {
+    /** Key name for deduplication (e.g., config key name) */
+    keyName: string;
+    /** Runs in beforeAll - setup logic */
+    beforeAll: () => Promise<void>;
+    /** Runs in afterAll - cleanup logic */
+    afterAll: () => Promise<void>;
+}
+/**
+ * Symbol for resources that support test operations.
+ * Resources implement this to expose operations like clone().
+ */
+export declare const GG_TEST_RESOURCE: unique symbol;
+/**
+ * Type for objects that expose test resource operations.
+ * Used by GGTest.with() to get available operations.
+ */
+export interface TestResource<T = any> {
+    [GG_TEST_RESOURCE]: T;
+}
+export interface GGTestConfig {
+    serviceStartupTimeout: number;
+    verboseProxy: boolean;
+}
+export declare class GGTestRunner {
+    /**
+     * Unique identifier for this test context.
+     * Used for test resource isolation (e.g., creating isolated DB schemas).
+     */
+    readonly testId: string;
+    readonly ipcServer: IPCServer;
+    readonly discoveryServer: IGGLocalDiscoveryServer;
+    readonly config: GGTestConfig;
+    private _started;
+    /**
+     * Runtimes added in the describe block (before start).
+     * These are managed by beforeAll/afterAll.
+     */
+    private readonly globalRuntimes;
+    /**
+     * Runtimes added within test blocks (after start).
+     * These are managed by afterEach and cleared after each test.
+     */
+    private readonly inTestRuntimes;
+    /**
+     * Extension instances - extensions are some "describe block level components".
+     * Some examples EventsServer, HttpInterceptorsServer, MockableInterceptorsServer etc.
+     */
+    private readonly extensionInstances;
+    private readonly hooks;
+    constructor(ipcServer: IPCServer, discoveryServer: IGGLocalDiscoveryServer, userConfig?: Partial<GGTestConfig>);
+    /**
+     * Extension factories - extensions are some "describe block level components".
+     * Some examples EventsServer, HttpInterceptorsServer, MockableInterceptorsServer etc.
+     */
+    private static extensionFactories;
+    /**
+     * Register a component type.
+     * Components must accept GGTestRunner as their constructor argument.
+     */
+    static registerExtension<T extends GGTestComponent>(type: GGTestComponentType<T>): void;
+    /**
+     * Get a component by type. Creates it lazily if not yet instantiated.
+     */
+    getExtensionInstance<T extends GGTestComponent>(type: GGTestComponentType<T>): T;
+    /**
+     * Whether the test has started (services are running).
+     */
+    get started(): boolean;
+    /**
+     * Register a test lifecycle hook.
+     * Hooks run beforeAll (during start) and afterAll (during teardown).
+     * Duplicate registrations with the same keyName are skipped.
+     */
+    registerHook(hook: GGTestRunnerHook): void;
+    /**
+     * Send a command to ALL runtimes.
+     * Used by resource hooks (e.g., DB config) that apply globally.
+     */
+    sendCommand<Payload>(type: IPCClientRequest<Payload, any>, payload: Payload): Promise<void>;
+    /**
+     * Add a runtime to this test runner.
+     * Automatically routes to the appropriate list based on lifecycle stage.
+     */
+    addRuntime(runtime: GGTestRuntime): void;
+    /**
+     * Get all active runtimes (both global and in-test).
+     */
+    getAllRuntimes(): GGTestRuntime[];
+    /**
+     * Find a runtime by its unique runtimeId.
+     */
+    getRuntimeById(runtimeId: string): GGTestRuntime | undefined;
+    start(): Promise<void>;
+    runAfterEachHooks(): Promise<void>;
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=GGTestRunner.d.ts.map

package/dist/src/GGTestRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGTestRunner.d.ts","sourceRoot":"","sources":["../../src/GGTestRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,OAAO,EAAC,gBAAgB,EAAE,SAAS,EAAC,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,eAAe,EAAE,mBAAmB,EAAC,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAGlE,eAAO,MAAM,cAAc,4BAAiD,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACjC,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IACzB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,YAAY,EAAE,OAAO,CAAA;CACxB;AAED,qBAAa,YAAY;IAErB;;;OAGG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,eAAe,EAAE,uBAAuB,CAAA;IACxD,SAAgB,MAAM,EAAE,YAAY,CAGnC;IACD,OAAO,CAAC,QAAQ,CAAiB;IAEjC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwD;IAE3F,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;gBAErD,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,uBAAuB,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAsB9G;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAkC;IAEnE;;;OAGG;WACW,iBAAiB,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ9F;;OAEG;IACI,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC;IAavF;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;;OAIG;IACI,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAQjD;;;OAGG;IACU,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxG;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAU/C;;OAEG;IACI,cAAc,IAAI,aAAa,EAAE;IAIxC;;OAEG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAKtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwDtB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAalC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA4CzC"}