@e2edev/e2e 0.2.0

package/dist/run/scheduler.js

@@ -0,0 +1,512 @@
+/**
+ * The run engine: dispatches file-target work units across workers (spec
+ * 11-lifecycle.md). Per target, setup units complete before ordinary units
+ * dispatch; a worker is bound to one target, runs one unit at a time, and is
+ * discarded after any failing unit or infrastructure fault.
+ *
+ * Workers are reached only through `SpawnUnitRunner`, so the same scheduling,
+ * gating, and reporting logic covers both child-process and in-process
+ * execution.
+ */
+import { InfrastructureError, serializeError } from '../internal/errors.js';
+import { timestamp, uuidv7 } from '../internal/ids.js';
+import { buildWorkPlans, INTERRUPTED_BEFORE_START, nonRunResult, pairResult, setupFailedSkip, unstartedResult, } from './units.js';
+import { decodeResult } from './worker/protocol.js';
+/** Consecutive worker-boot failures per target before its units are failed. */
+const MAX_INIT_FAILURES = 2;
+/** How long a retiring or draining worker gets before it is force-killed. */
+const SHUTDOWN_GRACE_MS = 10_000;
+/** Runs every selected unit and streams records. */
+export async function runUnits(options) {
+    await new Scheduler(options).run();
+}
+/**
+ * One worker and the unit it is executing. Owns its own lifecycle so the
+ * scheduler never has to keep a separate record in sync with the transport.
+ */
+class SchedulerWorker {
+    targetName;
+    runner;
+    state = 'starting';
+    /** Unit handed over but not yet acknowledged, while the worker starts up. */
+    queued;
+    unit;
+    /** Test ids already reported for `unit`, used to synthesize crash results. */
+    reported = new Set();
+    inFlightTestId;
+    sawFailure = false;
+    becameReady = false;
+    killTimer;
+    constructor(targetName, spawn, onMessage, onExit) {
+        this.targetName = targetName;
+        this.runner = spawn(targetName, {
+            onMessage: (message) => onMessage(this, message),
+            onExit: (detail) => {
+                this.clearKillTimer();
+                onExit(this, detail);
+            },
+        });
+    }
+    /** Sends a unit and starts tracking it. */
+    dispatch(unit) {
+        this.state = 'busy';
+        this.unit = unit;
+        this.reported.clear();
+        this.inFlightTestId = undefined;
+        this.sawFailure = false;
+        const pairs = unit.pairs.map((pair) => ({
+            test: pair.test,
+            options: pair.options,
+        }));
+        this.runner.send({
+            type: 'run-unit',
+            unitId: unit.id,
+            kind: unit.kind,
+            file: unit.file,
+            absolutePath: unit.absolutePath,
+            pairs,
+        });
+    }
+    /** Asks for a graceful exit and force-kills if it takes too long. */
+    shutdown(graceMs) {
+        this.runner.send({ type: 'shutdown' });
+        this.killAfter(graceMs);
+    }
+    killAfter(graceMs) {
+        if (this.killTimer !== undefined || !this.runner.alive)
+            return;
+        this.killTimer = setTimeout(() => this.runner.kill(), graceMs);
+        this.killTimer.unref();
+    }
+    clearKillTimer() {
+        if (this.killTimer === undefined)
+            return;
+        clearTimeout(this.killTimer);
+        this.killTimer = undefined;
+    }
+}
+class Scheduler {
+    options;
+    targets = new Map();
+    /** Every worker that has not exited yet, retired ones included. */
+    workers = [];
+    wake;
+    interruptBroadcast = false;
+    constructor(options) {
+        this.options = options;
+    }
+    async run() {
+        const plans = buildWorkPlans(this.options.selection, this.options.collection, this.options.projectRoot);
+        for (const plan of plans) {
+            this.targets.set(plan.target.name, {
+                target: plan.target,
+                setupQueue: [...plan.setupUnits],
+                fileQueue: [...plan.fileUnits],
+                failedSessions: new Map(),
+                initFailures: 0,
+                failed: false,
+            });
+            if (!this.options.interruptSignal.aborted) {
+                for (const pair of plan.immediate)
+                    this.options.events.onResult(nonRunResult(pair));
+            }
+        }
+        const onInterrupt = () => this.wakeUp();
+        this.options.interruptSignal.addEventListener('abort', onInterrupt, { once: true });
+        try {
+            for (;;) {
+                this.broadcastInterrupt();
+                this.dispatch();
+                if (this.isDone())
+                    break;
+                await new Promise((resolve) => {
+                    this.wake = resolve;
+                });
+            }
+        }
+        finally {
+            this.options.interruptSignal.removeEventListener('abort', onInterrupt);
+            await this.drain();
+        }
+    }
+    wakeUp() {
+        const resolve = this.wake;
+        this.wake = undefined;
+        resolve?.();
+    }
+    broadcastInterrupt() {
+        if (!this.options.interruptSignal.aborted || this.interruptBroadcast)
+            return;
+        this.interruptBroadcast = true;
+        for (const state of this.targets.values()) {
+            state.setupQueue.length = 0;
+            state.fileQueue.length = 0;
+        }
+        // Snapshot first: retiring a worker mutates `this.workers`, and iterating
+        // the live array would skip entries as they are spliced out.
+        const live = [...this.workers];
+        for (const worker of live) {
+            worker.runner.send({ type: 'interrupt' });
+            if (worker.state === 'busy')
+                worker.killAfter(this.options.interruptGraceMs);
+            else
+                this.retire(worker);
+        }
+    }
+    isDone() {
+        for (const state of this.targets.values()) {
+            if (state.setupQueue.length > 0 || state.fileQueue.length > 0)
+                return false;
+        }
+        return !this.workers.some((worker) => worker.state === 'busy' || worker.queued !== undefined);
+    }
+    // --- dispatch ---
+    /**
+     * Assigns as much work as capacity allows. A unit is always taken off its
+     * queue before a worker is acquired, so a spawn can never be left with
+     * nothing to do.
+     */
+    dispatch() {
+        if (this.options.interruptSignal.aborted)
+            return;
+        for (;;) {
+            const state = this.nextTarget();
+            if (state === undefined)
+                return;
+            const unit = this.takeUnit(state);
+            if (unit === undefined)
+                continue;
+            const worker = this.acquireWorker(state.target.name);
+            if (worker === undefined) {
+                // No capacity right now; put the unit back at the head of its queue.
+                this.returnUnit(state, unit);
+                return;
+            }
+            if (worker.state === 'idle')
+                worker.dispatch(unit);
+            else
+                worker.queued = unit;
+        }
+    }
+    /** The first target that has a dispatchable unit and could accept a worker. */
+    nextTarget() {
+        for (const state of this.targets.values()) {
+            if (this.peekUnit(state) === undefined)
+                continue;
+            if (this.canPlaceWork(state.target.name))
+                return state;
+        }
+        return undefined;
+    }
+    peekUnit(state) {
+        if (state.failed)
+            return undefined;
+        if (state.setupQueue.length > 0)
+            return state.setupQueue[0];
+        // Ordinary units wait until every setup for this target has finished.
+        if (this.hasPendingSetup(state))
+            return undefined;
+        return state.fileQueue[0];
+    }
+    /**
+     * Setup gating is derived, not counted: a target has pending setups while
+     * any setup unit is queued or in flight for it.
+     */
+    hasPendingSetup(state) {
+        if (state.setupQueue.length > 0)
+            return true;
+        return this.workers.some((worker) => worker.targetName === state.target.name &&
+            (worker.unit?.kind === 'setup' || worker.queued?.kind === 'setup'));
+    }
+    /** Pops the next unit, applying setup-failure gating; may complete it inline. */
+    takeUnit(state) {
+        for (;;) {
+            const unit = this.peekUnit(state);
+            if (unit === undefined)
+                return undefined;
+            if (unit.kind === 'setup')
+                state.setupQueue.shift();
+            else
+                state.fileQueue.shift();
+            const runnable = unit.pairs.filter((pair) => {
+                const skip = this.dependencySkip(state, pair);
+                if (skip === undefined)
+                    return true;
+                this.options.events.onResult(pairResult(pair, { status: 'skipped', selected: true, skip, attempts: [] }));
+                return false;
+            });
+            if (runnable.length === 0)
+                continue;
+            return runnable.length === unit.pairs.length ? unit : { ...unit, pairs: runnable };
+        }
+    }
+    /** Puts an untaken unit back so capacity pressure never drops work. */
+    returnUnit(state, unit) {
+        if (unit.kind === 'setup')
+            state.setupQueue.unshift(unit);
+        else
+            state.fileQueue.unshift(unit);
+    }
+    /** Skip info when a pair's session was not produced by a passing setup. */
+    dependencySkip(state, pair) {
+        const session = pair.options.session;
+        if (session === undefined)
+            return undefined;
+        const failedSetup = state.failedSessions.get(session);
+        if (failedSetup === undefined)
+            return undefined;
+        return setupFailedSkip(session, failedSetup);
+    }
+    // --- workers ---
+    /** Whether a worker for `targetName` can be obtained without exceeding the cap. */
+    canPlaceWork(targetName) {
+        if (this.findAvailable(targetName) !== undefined)
+            return true;
+        if (this.workers.length < this.options.workers)
+            return true;
+        return this.findRetirableForeignWorker(targetName) !== undefined;
+    }
+    /**
+     * A worker for this target, spawning one if the cap allows. Retired workers
+     * keep counting against the cap until they are gone, so a discarded worker
+     * never doubles the number of live surfaces. At capacity this discards an
+     * idle worker bound to another target and returns nothing; its exit wakes
+     * the loop and dispatch retries with the freed slot.
+     */
+    acquireWorker(targetName) {
+        const available = this.findAvailable(targetName);
+        if (available !== undefined)
+            return available;
+        if (this.workers.length < this.options.workers)
+            return this.spawn(targetName);
+        const foreign = this.findRetirableForeignWorker(targetName);
+        if (foreign !== undefined)
+            this.retire(foreign);
+        return undefined;
+    }
+    findAvailable(targetName) {
+        return this.workers.find((worker) => worker.targetName === targetName &&
+            worker.queued === undefined &&
+            (worker.state === 'idle' || worker.state === 'starting'));
+    }
+    findRetirableForeignWorker(targetName) {
+        return this.workers.find((worker) => worker.state === 'idle' && worker.targetName !== targetName);
+    }
+    spawn(targetName) {
+        const worker = new SchedulerWorker(targetName, this.options.spawn, (target, message) => this.onMessage(target, message), (target, detail) => this.onExit(target, detail));
+        this.workers.push(worker);
+        return worker;
+    }
+    /**
+     * Discards a worker. It stays in `this.workers` (so it keeps counting
+     * against the cap) until its exit is observed.
+     */
+    retire(worker) {
+        if (worker.state === 'retired')
+            return;
+        worker.state = 'retired';
+        // Dropping rather than requeueing is only safe because the sole caller
+        // that can retire a worker still holding a unit is the interrupt
+        // broadcast, which clears the queues anyway. Requeueing here would strand
+        // the loop instead: `dispatch` stops once interrupted, so the unit would
+        // sit in a queue that `isDone` waits on forever. The other callers only
+        // ever retire idle workers, which never hold a queued unit.
+        worker.queued = undefined;
+        worker.shutdown(SHUTDOWN_GRACE_MS);
+    }
+    forget(worker) {
+        const index = this.workers.indexOf(worker);
+        if (index !== -1)
+            this.workers.splice(index, 1);
+    }
+    targetState(worker) {
+        const state = this.targets.get(worker.targetName);
+        if (state === undefined) {
+            throw new Error(`worker bound to unknown target "${worker.targetName}"`);
+        }
+        return state;
+    }
+    onMessage(worker, message) {
+        switch (message.type) {
+            case 'ready': {
+                worker.becameReady = true;
+                this.targetState(worker).initFailures = 0;
+                worker.state = 'idle';
+                const queued = worker.queued;
+                worker.queued = undefined;
+                if (queued !== undefined)
+                    worker.dispatch(queued);
+                this.wakeUp();
+                break;
+            }
+            case 'pair-start': {
+                worker.inFlightTestId = message.testId;
+                this.options.events.onTestStart?.(message.testId, message.title, worker.targetName);
+                break;
+            }
+            case 'progress': {
+                this.options.events.onProgress?.(message.testId, worker.targetName, message.progress);
+                break;
+            }
+            case 'result': {
+                const state = this.targetState(worker);
+                const result = decodeResult(message.result, state.target);
+                worker.reported.add(result.test.id);
+                if (result.status !== 'passed' && result.status !== 'flaky' && result.status !== 'skipped') {
+                    worker.sawFailure = true;
+                }
+                if (result.test.kind === 'setup')
+                    this.recordSetupOutcome(state, result);
+                this.options.events.onResult(result);
+                break;
+            }
+            case 'serial-group': {
+                this.options.events.onSerialGroup(message.group);
+                break;
+            }
+            case 'unit-done': {
+                for (const runError of message.runErrors)
+                    this.options.events.onRunError(runError);
+                if (message.debug !== undefined)
+                    this.options.events.onDebug?.(message.debug);
+                if (message.aiTrace !== undefined)
+                    this.options.events.onAiTrace?.(message.aiTrace);
+                const unit = worker.unit;
+                worker.unit = undefined;
+                worker.inFlightTestId = undefined;
+                if (unit !== undefined && unit.id !== message.unitId) {
+                    this.options.events.onRunError({
+                        error: serializeError(new InfrastructureError('WORKER_PROTOCOL', `worker reported unit "${message.unitId}" while running "${unit.id}"`)),
+                    });
+                }
+                if (worker.state !== 'retired') {
+                    // Spec 11-lifecycle.md: discard the worker after a failing unit.
+                    if (worker.sawFailure)
+                        this.retire(worker);
+                    else
+                        worker.state = 'idle';
+                }
+                this.wakeUp();
+                break;
+            }
+            case 'shutdown-done': {
+                for (const runError of message.runErrors)
+                    this.options.events.onRunError(runError);
+                if (message.debug !== undefined)
+                    this.options.events.onDebug?.(message.debug);
+                if (message.aiTrace !== undefined)
+                    this.options.events.onAiTrace?.(message.aiTrace);
+                break;
+            }
+            case 'fatal': {
+                this.options.events.onRunError({ error: message.error });
+                worker.runner.kill();
+                break;
+            }
+        }
+    }
+    recordSetupOutcome(state, result) {
+        if (result.status === 'passed' || result.status === 'flaky')
+            return;
+        for (const session of result.test.sessions) {
+            state.failedSessions.set(session, result.test.id);
+        }
+    }
+    onExit(worker, detail) {
+        const tracked = this.workers.includes(worker);
+        this.forget(worker);
+        const state = this.targetState(worker);
+        const unit = worker.unit;
+        worker.unit = undefined;
+        // A queued unit never reached the worker. Requeue it before any handling
+        // below, so that failing the target drains it along with the rest.
+        if (worker.queued !== undefined) {
+            this.returnUnit(state, worker.queued);
+            worker.queued = undefined;
+        }
+        if (unit !== undefined) {
+            this.options.events.onRunError({
+                error: serializeError(new InfrastructureError('WORKER_EXIT', `worker for target "${worker.targetName}" exited unexpectedly (${detail}) during ${unit.id}`)),
+            });
+            this.synthesizeCrashResults(state, worker, unit);
+        }
+        else if (tracked && !worker.becameReady) {
+            state.initFailures += 1;
+            if (state.initFailures >= MAX_INIT_FAILURES)
+                this.failTarget(state);
+        }
+        this.wakeUp();
+    }
+    /** Emits records for a unit whose worker died before reporting it done. */
+    synthesizeCrashResults(state, worker, unit) {
+        const interrupted = this.options.interruptSignal.aborted;
+        for (const pair of unit.pairs) {
+            if (worker.reported.has(pair.test.id))
+                continue;
+            if (interrupted) {
+                this.options.events.onResult(unstartedResult(pair, INTERRUPTED_BEFORE_START));
+                continue;
+            }
+            // A crashed setup never persisted its sessions; dependents must skip.
+            if (pair.test.kind === 'setup') {
+                for (const session of pair.test.sessions) {
+                    state.failedSessions.set(session, pair.test.id);
+                }
+            }
+            const wasRunning = pair.test.id === worker.inFlightTestId && pair.test.serialId === undefined;
+            if (!wasRunning) {
+                this.options.events.onResult(unstartedResult(pair, {
+                    cause: 'infrastructure-unavailable',
+                    reason: 'worker process exited before this test started',
+                }));
+                continue;
+            }
+            this.options.events.onResult(pairResult(pair, {
+                status: 'failed',
+                selected: true,
+                attempts: [
+                    {
+                        id: uuidv7(),
+                        index: 0,
+                        status: 'failed',
+                        startedAt: timestamp(),
+                        durationMs: 0,
+                        steps: [],
+                        artifacts: [],
+                        error: serializeError(new InfrastructureError('WORKER_CRASH', 'worker process exited during this test')),
+                        secondaryErrors: [],
+                        cleanup: 'forced',
+                    },
+                ],
+            }));
+        }
+    }
+    /** Fails a target whose workers cannot boot; drains its queues with skips. */
+    failTarget(state) {
+        state.failed = true;
+        this.options.events.onRunError({
+            error: serializeError(new InfrastructureError('WORKER_INIT_FAILED', `workers for target "${state.target.name}" failed to start ${MAX_INIT_FAILURES} times; remaining units skipped`)),
+        });
+        const units = [...state.setupQueue, ...state.fileQueue];
+        state.setupQueue.length = 0;
+        state.fileQueue.length = 0;
+        for (const unit of units) {
+            for (const pair of unit.pairs) {
+                this.options.events.onResult(unstartedResult(pair, {
+                    cause: 'infrastructure-unavailable',
+                    reason: 'worker process failed to start',
+                }));
+            }
+        }
+    }
+    /** Shuts every remaining worker down, force-killing stragglers. */
+    async drain() {
+        const remaining = [...this.workers];
+        for (const worker of remaining) {
+            if (worker.state !== 'retired' && worker.runner.alive)
+                worker.shutdown(SHUTDOWN_GRACE_MS);
+        }
+        await Promise.all(remaining.map((worker) => worker.runner.exit));
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/run/scheduler.js.map

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

package/dist/run/serial.d.ts

@@ -0,0 +1,52 @@
+/** Serial-group execution: one shared session per group attempt (spec 11-lifecycle.md). */
+import type { TargetSession } from '../backend/surface.ts';
+import { type SerializedError } from '../internal/errors.ts';
+import { type RegisteredTest } from '../collect/registry.ts';
+import type { TestTargetPair } from '../collect/select.ts';
+import type { ResolvedTarget } from '../config/resolve.ts';
+import type { ArtifactStore } from '../types.ts';
+import type { AttemptContext } from './execute.ts';
+import type { ArtifactSink } from './fixtures.ts';
+import type { StepRecord } from './steps.ts';
+import { type Realm, RealmManager } from './realm.ts';
+import type { AttemptRecord, ResultRecord, SerialGroupRecord } from './records.ts';
+/**
+ * One shared session for a serial-group attempt: members preserve app state,
+ * so a screen an earlier member reached stays current for later members.
+ */
+export interface SharedSerialSession {
+    readonly session: TargetSession;
+    /**
+     * The group attempt's report id. Member artifacts are filed under this
+     * attempt in the report, so a member's store identity uses it rather than
+     * the member's own private attempt id.
+     */
+    readonly attemptId: string;
+    /**
+     * Report segments of the group attempt directory. The shared session writes
+     * every artifact there, so members resolve artifact paths against it rather
+     * than against their own attempt directory.
+     */
+    readonly artifactSegments: readonly string[];
+    /** Steps completed by earlier members, so later members see them as prior context. */
+    readonly priorSteps: StepRecord[];
+}
+/** Executor capabilities the serial runner borrows. */
+export interface SerialHost {
+    readonly target: ResolvedTarget;
+    readonly artifactsRoot: string;
+    readonly runId: string;
+    /** The configured artifact store, so group-owned artifacts (the shared trace) upload like any other. */
+    readonly artifactStore: ArtifactStore | undefined;
+    readonly interruptSignal: AbortSignal;
+    readonly realms: RealmManager;
+    launchSession(pair: TestTargetPair, attemptId: string, artifactsDir: string, signal: AbortSignal): Promise<TargetSession>;
+    closeSession(session: TargetSession, attemptId: string, record: {
+        cleanup: 'complete' | 'failed' | 'forced';
+    }, sink: ArtifactSink, secondaryErrors: SerializedError[]): Promise<void>;
+    runAttempt(pair: TestTargetPair, registered: RegisteredTest, realm: Realm, attemptIndex: number, context: AttemptContext): Promise<AttemptRecord>;
+    emit(result: ResultRecord): void;
+}
+/** Runs one serial unit to completion and emits every member result. */
+export declare function runSerialUnit(host: SerialHost, members: readonly TestTargetPair[], absolutePath: string): Promise<SerialGroupRecord>;
+//# sourceMappingURL=serial.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serial.d.ts","sourceRoot":"","sources":["../../src/run/serial.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAkB,KAAK,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAGZ,iBAAiB,EAElB,MAAM,cAAc,CAAC;AAItB;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC;CACnC;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wGAAwG;IACxG,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,aAAa,CACX,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,YAAY,CACV,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;QAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAA;KAAE,EACrD,IAAI,EAAE,YAAY,EAClB,eAAe,EAAE,eAAe,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CACR,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,cAAc,EAC1B,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAClC;AAED,wEAAwE;AACxE,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAmE5B"}