@e2edev/e2e 0.2.0

package/dist/run/realm.d.ts

@@ -0,0 +1,52 @@
+/** Suite realm lifecycle: module re-import, beforeAll/afterAll scope tracking. */
+import { type SerializedError } from '../internal/errors.ts';
+import { DebugTrace } from '../internal/debug.ts';
+import type { CollectedTest } from '../collect/collect.ts';
+import { type ModuleRegistration, type RegisteredHook, type RegisteredTest } from '../collect/registry.ts';
+import type { Platform } from '../types.ts';
+import type { RunError } from './records.ts';
+export interface Realm {
+    registration: ModuleRegistration;
+    /** Registered tests by title-path key, for per-attempt lookup. */
+    testsByKey: ReadonlyMap<string, RegisteredTest>;
+    /** Scope keys whose beforeAll already ran in this realm. */
+    entered: Map<string, {
+        failed: SerializedError | undefined;
+    }>;
+    /** Scopes pending afterAll, innermost last. */
+    pendingAfterAll: string[];
+}
+/** Finds a registered test in a re-imported realm by its exact title path. */
+export declare function findRegistered(realm: Realm, test: CollectedTest): RegisteredTest | undefined;
+export interface RealmManagerOptions {
+    readonly targetName: string;
+    readonly platform: Platform;
+    readonly timeout: number;
+    readonly cleanupTimeout: number;
+    /** Run-level error sink for hook failures. */
+    readonly runErrors: RunError[];
+    readonly debug?: DebugTrace;
+}
+/** Creates realms and runs suite-scope hooks with per-realm entry tracking. */
+export declare class RealmManager {
+    private readonly options;
+    private realmCounter;
+    private readonly debug;
+    constructor(options: RealmManagerOptions);
+    /** Re-imports one test module in a fresh realm. */
+    create(absolutePath: string): Promise<Realm>;
+    /**
+     * Wraps a registration that was just imported and has run nothing yet as a
+     * realm. The worker imports every unit's file once to resolve its pairs;
+     * adopting that import saves the second, identical one per unit.
+     */
+    adopt(registration: ModuleRegistration): Realm;
+    /** Returns a test's hooks of one kind across its enclosing scope chain. */
+    hooksFor(realm: Realm, test: RegisteredTest, kind: 'beforeEach' | 'afterEach'): RegisteredHook[];
+    /** Enters suite scopes for a test, running pending beforeAll hooks. */
+    enterScopes(realm: Realm, test: RegisteredTest): Promise<SerializedError | undefined>;
+    /** Runs pending afterAll hooks, innermost scope first. */
+    leave(realm: Realm): Promise<void>;
+    private suiteFixtures;
+}
+//# sourceMappingURL=realm.d.ts.map

package/dist/run/realm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realm.d.ts","sourceRoot":"","sources":["../../src/run/realm.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAGlF,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,kBAAkB,CAAC;IACjC,kEAAkE;IAClE,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChD,4DAA4D;IAC5D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,eAAe,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAC9D,+CAA+C;IAC/C,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,CAE5F;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED,+EAA+E;AAC/E,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAEnC,YAA6B,OAAO,EAAE,mBAAmB,EAExD;IAED,mDAAmD;IAC7C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAQjD;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,EAAE,kBAAkB,GAAG,KAAK,CAI7C;IAED,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,cAAc,EAAE,CAK/F;IAED,uEAAuE;IACjE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAkC1F;IAED,0DAA0D;IACpD,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBvC;IAED,OAAO,CAAC,aAAa;CAGtB"}

package/dist/run/realm.js

@@ -0,0 +1,101 @@
+/** Suite realm lifecycle: module re-import, beforeAll/afterAll scope tracking. */
+import { importModule } from '../config/load.js';
+import { classifyError, E2EError, serializeError, TestTimeoutError, } from '../internal/errors.js';
+import { DebugTrace } from '../internal/debug.js';
+import { titlePathKey } from '../internal/ids.js';
+import { withTimeout } from '../internal/time.js';
+import { collectModule, groupChain, groupTitles, } from '../collect/registry.js';
+/** Finds a registered test in a re-imported realm by its exact title path. */
+export function findRegistered(realm, test) {
+    return realm.testsByKey.get(titlePathKey(test.titlePath));
+}
+/** Creates realms and runs suite-scope hooks with per-realm entry tracking. */
+export class RealmManager {
+    options;
+    realmCounter = 0;
+    debug;
+    constructor(options) {
+        this.options = options;
+        this.debug = options.debug ?? new DebugTrace(false);
+    }
+    /** Re-imports one test module in a fresh realm. */
+    async create(absolutePath) {
+        this.realmCounter += 1;
+        const registration = await this.debug.time('realm.import', () => collectModule(() => importModule(absolutePath, `${this.options.targetName}-${this.realmCounter}`)));
+        return this.adopt(registration);
+    }
+    /**
+     * Wraps a registration that was just imported and has run nothing yet as a
+     * realm. The worker imports every unit's file once to resolve its pairs;
+     * adopting that import saves the second, identical one per unit.
+     */
+    adopt(registration) {
+        const testsByKey = new Map();
+        for (const test of registration.tests)
+            testsByKey.set(titlePathKey(test.titlePath), test);
+        return { registration, testsByKey, entered: new Map(), pendingAfterAll: [] };
+    }
+    /** Returns a test's hooks of one kind across its enclosing scope chain. */
+    hooksFor(realm, test, kind) {
+        const chainKeys = new Set(scopeChainFor(test).map(scopeKey));
+        return realm.registration.hooks.filter((hook) => hook.kind === kind && chainKeys.has(scopeKey(hook.group)));
+    }
+    /** Enters suite scopes for a test, running pending beforeAll hooks. */
+    async enterScopes(realm, test) {
+        for (const scope of scopeChainFor(test)) {
+            const key = scopeKey(scope);
+            const entered = realm.entered.get(key);
+            if (entered !== undefined) {
+                if (entered.failed !== undefined)
+                    return entered.failed;
+                continue;
+            }
+            const hooks = realm.registration.hooks.filter((hook) => hook.kind === 'beforeAll' && scopeKey(hook.group) === key);
+            let failed;
+            for (const hook of hooks) {
+                try {
+                    await withTimeout(Promise.resolve(hook.fn(this.suiteFixtures())), this.options.timeout, () => new TestTimeoutError('beforeAll hook timed out'));
+                }
+                catch (cause) {
+                    const error = classifyError(cause);
+                    failed = serializeError(new E2EError('test', 'HOOK_FAILED', `beforeAll failed: ${error.message}`, { cause }), { phase: 'beforeAll', scopeId: key === '' ? (test.titlePath[0] ?? 'file') : key });
+                    this.options.runErrors.push({ error: failed });
+                    break;
+                }
+            }
+            realm.entered.set(key, { failed });
+            realm.pendingAfterAll.push(key);
+            if (failed !== undefined)
+                return failed;
+        }
+        return undefined;
+    }
+    /** Runs pending afterAll hooks, innermost scope first. */
+    async leave(realm) {
+        for (const key of [...realm.pendingAfterAll].toReversed()) {
+            const hooks = realm.registration.hooks.filter((hook) => hook.kind === 'afterAll' && scopeKey(hook.group) === key);
+            for (const hook of [...hooks].toReversed()) {
+                try {
+                    await withTimeout(Promise.resolve(hook.fn(this.suiteFixtures())), this.options.cleanupTimeout, () => new TestTimeoutError('afterAll hook timed out'));
+                }
+                catch (cause) {
+                    const error = classifyError(cause);
+                    this.options.runErrors.push({
+                        error: serializeError(new E2EError('test', 'HOOK_FAILED', `afterAll failed: ${error.message}`, { cause }), { phase: 'afterAll', scopeId: key }),
+                    });
+                }
+            }
+        }
+        realm.pendingAfterAll = [];
+    }
+    suiteFixtures() {
+        return { platform: this.options.platform };
+    }
+}
+function scopeKey(group) {
+    return titlePathKey(groupTitles(group));
+}
+function scopeChainFor(test) {
+    return [undefined, ...groupChain(test.group)];
+}
+//# sourceMappingURL=realm.js.map

package/dist/run/realm.js.map

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

package/dist/run/records.d.ts

@@ -0,0 +1,87 @@
+/** Execution result data model shared by the executor and reporters. */
+import type { SerializedError } from '../internal/errors.ts';
+import type { TestIdentity } from '../collect/collect.ts';
+import type { SkipInfo } from '../collect/select.ts';
+import type { ResolvedTarget } from '../config/resolve.ts';
+import type { StepRecord } from './steps.ts';
+export type ArtifactProducer = {
+    kind: 'step';
+    stepId: string;
+} | {
+    kind: 'attempt';
+};
+export interface ArtifactRecord {
+    id: string;
+    kind: 'screenshot' | 'trace' | 'video' | 'download' | 'log';
+    mediaType: string;
+    path?: string;
+    size?: number;
+    sha256?: string;
+    /** The configured `ArtifactStore`'s reference for this artifact, when one accepted it. */
+    ref?: string;
+    redaction: 'none' | 'complete';
+    producer: ArtifactProducer;
+}
+export interface AttemptRecord {
+    id: string;
+    index: number;
+    status: 'passed' | 'failed' | 'timed-out' | 'interrupted';
+    startedAt: string;
+    durationMs: number;
+    steps: StepRecord[];
+    artifacts: ArtifactRecord[];
+    error?: SerializedError;
+    secondaryErrors: SerializedError[];
+    cleanup: 'complete' | 'failed' | 'forced';
+}
+export interface SerialMemberRecord {
+    id: string;
+    index: number;
+    testId: string;
+    status: 'passed' | 'failed' | 'timed-out' | 'interrupted' | 'skipped';
+    startedAt: string;
+    durationMs: number;
+    steps: StepRecord[];
+    error?: SerializedError;
+    skip?: SkipInfo;
+    secondaryErrors: SerializedError[];
+}
+export interface SerialAttemptRecord {
+    id: string;
+    index: number;
+    status: 'passed' | 'failed' | 'timed-out' | 'interrupted';
+    startedAt: string;
+    durationMs: number;
+    members: SerialMemberRecord[];
+    artifacts: ArtifactRecord[];
+    error?: SerializedError;
+    secondaryErrors: SerializedError[];
+    cleanup: 'complete' | 'failed' | 'forced';
+}
+export interface SerialGroupRecord {
+    id: string;
+    serialId: string;
+    declarationIndex: number;
+    file: string;
+    titlePath: string[];
+    targetId: string;
+    platform: string;
+    memberTestIds: string[];
+    status: 'passed' | 'flaky' | 'failed' | 'timed-out' | 'interrupted' | 'skipped';
+    skip?: SkipInfo;
+    attempts: SerialAttemptRecord[];
+}
+export type ResultStatus = 'passed' | 'flaky' | 'failed' | 'timed-out' | 'interrupted' | 'skipped';
+export interface ResultRecord {
+    test: TestIdentity;
+    target: ResolvedTarget;
+    status: ResultStatus;
+    selected: boolean;
+    skip?: SkipInfo | undefined;
+    attempts: AttemptRecord[];
+    serialGroupId?: string;
+}
+export interface RunError {
+    error: SerializedError;
+}
+//# sourceMappingURL=records.d.ts.map

package/dist/run/records.d.ts.map

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

package/dist/run/records.js

@@ -0,0 +1,3 @@
+/** Execution result data model shared by the executor and reporters. */
+export {};
+//# sourceMappingURL=records.js.map

package/dist/run/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/run/records.ts"],"names":[],"mappings":"AAAA,wEAAwE"}

package/dist/run/retry.d.ts

@@ -0,0 +1,18 @@
+/** Shared retry policy for ordinary tests, setup tests, and serial groups. */
+import type { SerializedError } from '../internal/errors.ts';
+import type { ResultStatus } from './records.ts';
+/** The status-and-error slice of an attempt the retry policy inspects. */
+export interface RetryAttempt {
+    readonly status: 'passed' | 'failed' | 'timed-out' | 'interrupted';
+    readonly error?: SerializedError | undefined;
+}
+/** Only test-category failures and timeouts consume retry budget. */
+export declare function isRetryEligible(attempt: RetryAttempt): boolean;
+/**
+ * Runs up to `maxAttempts` attempts, stopping on pass, interrupt, or a
+ * failure that does not consume retry budget. `runOnce` returns the
+ * finished attempt, or undefined when the attempt could not start (the
+ * loop stops and the last observed status stands).
+ */
+export declare function runWithRetries(maxAttempts: number, interruptSignal: AbortSignal, runOnce: (attemptIndex: number) => Promise<RetryAttempt | undefined>): Promise<ResultStatus>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/run/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/run/retry.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC9C;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAK9D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,WAAW,EAC5B,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,GACnE,OAAO,CAAC,YAAY,CAAC,CAcvB"}

package/dist/run/retry.js

@@ -0,0 +1,33 @@
+/** Shared retry policy for ordinary tests, setup tests, and serial groups. */
+/** Only test-category failures and timeouts consume retry budget. */
+export function isRetryEligible(attempt) {
+    return (attempt.status === 'timed-out' ||
+        (attempt.error !== undefined && attempt.error.category === 'test'));
+}
+/**
+ * Runs up to `maxAttempts` attempts, stopping on pass, interrupt, or a
+ * failure that does not consume retry budget. `runOnce` returns the
+ * finished attempt, or undefined when the attempt could not start (the
+ * loop stops and the last observed status stands).
+ */
+export async function runWithRetries(maxAttempts, interruptSignal, runOnce) {
+    let finalStatus = 'failed';
+    let attemptCount = 0;
+    for (let attemptIndex = 0; attemptIndex < maxAttempts; attemptIndex += 1) {
+        if (interruptSignal.aborted)
+            break;
+        const attempt = await runOnce(attemptIndex);
+        if (attempt === undefined)
+            break;
+        attemptCount += 1;
+        if (attempt.status === 'passed')
+            return attemptCount > 1 ? 'flaky' : 'passed';
+        if (attempt.status === 'interrupted')
+            return 'interrupted';
+        finalStatus = attempt.status;
+        if (!isRetryEligible(attempt))
+            break;
+    }
+    return finalStatus;
+}
+//# sourceMappingURL=retry.js.map

package/dist/run/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/run/retry.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAW9E,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,OAAO,CACL,OAAO,CAAC,MAAM,KAAK,WAAW;QAC9B,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,CACnE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,eAA4B,EAC5B,OAAoE;IAEpE,IAAI,WAAW,GAAiB,QAAQ,CAAC;IACzC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,IAAI,YAAY,GAAG,CAAC,EAAE,YAAY,GAAG,WAAW,EAAE,YAAY,IAAI,CAAC,EAAE,CAAC;QACzE,IAAI,eAAe,CAAC,OAAO;YAAE,MAAM;QACnC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM;QACjC,YAAY,IAAI,CAAC,CAAC;QAClB,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC9E,IAAI,OAAO,CAAC,MAAM,KAAK,aAAa;YAAE,OAAO,aAAa,CAAC;QAC3D,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;YAAE,MAAM;IACvC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/run/runner.d.ts

@@ -0,0 +1,49 @@
+/** Run orchestration: config, collection, selection, execution, reporting. */
+import { type Report1Document } from '../report/build.ts';
+import { type RunEventSink, type RunExitCode } from './events.ts';
+import type { ResultRecord } from './records.ts';
+import type { E2EConfig } from '../types.ts';
+export interface RunOptions {
+    cwd?: string | undefined;
+    configPath?: string | undefined;
+    files?: readonly string[] | undefined;
+    tags?: readonly string[] | undefined;
+    tagMode?: 'any' | 'all' | undefined;
+    targetIds?: readonly string[] | undefined;
+    headed?: boolean | undefined;
+    retries?: number | undefined;
+    workers?: number | undefined;
+    reporters?: readonly ('list' | 'json')[] | undefined;
+    artifactsDir?: string | undefined;
+    passWithNoTests?: boolean | undefined;
+    /** Runs with the trace cache off (`--no-cache`), overriding the config. */
+    noCache?: boolean | undefined;
+    /** Prints aggregated phase timings to stderr after the run. */
+    debug?: boolean | undefined;
+    /** Records every model call to `.e2e/ai-trace.json` (`--ai-trace`). */
+    aiTrace?: boolean | undefined;
+    /**
+     * A config value instead of a discovered file — the embedding-host entry
+     * point (see the embedding guide). May hold live values (executors, driver
+     * handles, model instances, cache stores, secret providers), which cannot
+     * cross a process boundary, so the run executes in-process on one worker.
+     */
+    rawConfig?: E2EConfig | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+    quiet?: boolean | undefined;
+    interruptSignal?: AbortSignal | undefined;
+    /** Structured, JSON-serializable run events for embedding hosts. */
+    onEvent?: RunEventSink | undefined;
+}
+export interface RunOutcome {
+    exitCode: RunExitCode;
+    status: 'passed' | 'failed' | 'error' | 'interrupted';
+    report: Report1Document;
+    reportPath: string | undefined;
+    /** Where the AI trace was written; undefined unless `aiTrace` was requested. */
+    aiTracePath: string | undefined;
+    results: readonly ResultRecord[];
+}
+/** Executes one complete run and returns the outcome without exiting. */
+export declare function run(options?: RunOptions): Promise<RunOutcome>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/run/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/run/runner.ts"],"names":[],"mappings":"AAAA,8EAA8E;AA2B9E,OAAO,EAA+B,KAAK,eAAe,EAAyB,MAAM,oBAAoB,CAAC;AAK9G,OAAO,EAAwC,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAExG,OAAO,KAAK,EAAE,YAAY,EAA+B,MAAM,cAAc,CAAC;AAK9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1C,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,eAAe,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,oEAAoE;IACpE,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;IACtD,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,gFAAgF;IAChF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAClC;AAED,yEAAyE;AACzE,wBAAsB,GAAG,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CA0UvE"}