@e2edev/e2e 0.2.0

package/dist/collect/collect.js

@@ -0,0 +1,89 @@
+/** Collection realm: imports test modules and derives stable identities. */
+import path from 'node:path';
+import { discoverFiles } from '../internal/globs.js';
+import { CollectionError } from '../internal/errors.js';
+import { setupTestId, testId } from '../internal/ids.js';
+import { importModule } from '../config/load.js';
+import { collectModule, groupTitles, outermostSerialGroup, } from './registry.js';
+/** Narrows a collected test to its reportable, serializable identity. */
+export function testIdentity(test) {
+    return {
+        kind: test.kind,
+        title: test.title,
+        titlePath: test.titlePath,
+        declarationIndex: test.declarationIndex,
+        sessions: test.sessions,
+        source: test.source,
+        file: test.file,
+        id: test.id,
+        serialId: test.serialId,
+    };
+}
+/** Derives the serial unit source ID per 11-lifecycle.md. */
+function serialSourceId(file, group) {
+    return `serial::${testId(file, groupTitles(group))}`;
+}
+function toCollectedTests(file, registration) {
+    const seenTitlePaths = new Set();
+    return registration.tests.map((registered) => {
+        const encoded = testId(file, registered.titlePath);
+        if (seenTitlePaths.has(encoded)) {
+            throw new CollectionError(`duplicate title path ${registered.titlePath.join(' > ')} in ${file}`);
+        }
+        seenTitlePaths.add(encoded);
+        const serialRoot = outermostSerialGroup(registered.group);
+        return {
+            ...registered,
+            file,
+            id: registered.kind === 'setup' ? setupTestId(file, registered.titlePath) : encoded,
+            serialRoot,
+            serialId: serialRoot === undefined ? undefined : serialSourceId(file, serialRoot),
+        };
+    });
+}
+/** Normalizes an absolute or relative file path to the project-root-relative wire form. */
+function normalizeRelativePath(projectRoot, filePath) {
+    const relative = path.isAbsolute(filePath) ? path.relative(projectRoot, filePath) : filePath;
+    const normalized = relative.split(path.sep).join('/');
+    if (normalized.startsWith('..')) {
+        throw new CollectionError(`test file is outside the project root: ${filePath}`);
+    }
+    return normalized;
+}
+/** Builds one CollectedFile from an already-produced registration. */
+export function collectFromRegistration(projectRoot, filePath, registration) {
+    const file = normalizeRelativePath(projectRoot, filePath);
+    return {
+        file,
+        absolutePath: path.resolve(projectRoot, file),
+        registration,
+        tests: toCollectedTests(file, registration),
+    };
+}
+/**
+ * Runs collection: resolves globs, sorts matched files by code point, and
+ * imports each module once in the collection realm.
+ */
+export async function collect(config, fileFilter) {
+    let matched = discoverFiles(config.projectRoot, config.tests);
+    if (fileFilter !== undefined && fileFilter.length > 0) {
+        const normalizedFilters = new Set(fileFilter.map((file) => normalizeRelativePath(config.projectRoot, file)));
+        matched = matched.filter((file) => normalizedFilters.has(file));
+    }
+    const files = [];
+    for (const file of matched) {
+        const absolutePath = path.join(config.projectRoot, file);
+        let registration;
+        try {
+            registration = await collectModule(() => importModule(absolutePath, 'collect'));
+        }
+        catch (cause) {
+            if (cause instanceof CollectionError)
+                throw cause;
+            throw new CollectionError(`failed to collect ${file}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        }
+        files.push(collectFromRegistration(config.projectRoot, absolutePath, registration));
+    }
+    return { files, tests: files.flatMap((file) => file.tests) };
+}
+//# sourceMappingURL=collect.js.map

package/dist/collect/collect.js.map

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

package/dist/collect/registry.d.ts

@@ -0,0 +1,47 @@
+/** Synchronous registration during module evaluation (spec 11-lifecycle.md). */
+import type { DescribeOptions, SetupFn, SuiteHookFn, TestAPI, TestFn, TestHookFn, TestOptions } from '../types.ts';
+export interface SourceLocation {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+}
+export interface GroupNode {
+    readonly title: string;
+    readonly options: DescribeOptions;
+    readonly parent: GroupNode | undefined;
+    readonly serial: boolean;
+}
+export type TestMode = 'normal' | 'skip' | 'only';
+export interface RegisteredTest {
+    readonly kind: 'test' | 'setup';
+    readonly title: string;
+    readonly titlePath: readonly string[];
+    readonly declarationIndex: number;
+    readonly options: TestOptions;
+    readonly sessions: readonly string[];
+    readonly fn: TestFn | SetupFn;
+    readonly group: GroupNode | undefined;
+    readonly mode: TestMode;
+    readonly source: SourceLocation | undefined;
+}
+export type HookKind = 'beforeEach' | 'afterEach' | 'beforeAll' | 'afterAll';
+export interface RegisteredHook {
+    readonly kind: HookKind;
+    readonly fn: TestHookFn | SuiteHookFn;
+    readonly group: GroupNode | undefined;
+    readonly declarationIndex: number;
+}
+export interface ModuleRegistration {
+    readonly tests: readonly RegisteredTest[];
+    readonly hooks: readonly RegisteredHook[];
+}
+/** Canonical group-tree walk: the enclosing groups of a node, outermost first. */
+export declare function groupChain(group: GroupNode | undefined): GroupNode[];
+/** Group titles along the chain, outermost first. */
+export declare function groupTitles(group: GroupNode | undefined): string[];
+/** Finds the outermost serial group enclosing a node, if any. */
+export declare function outermostSerialGroup(group: GroupNode | undefined): GroupNode | undefined;
+/** Runs `load` with a fresh collector active and returns everything it registered. */
+export declare function collectModule(load: () => Promise<unknown>): Promise<ModuleRegistration>;
+export declare const test: TestAPI;
+//# sourceMappingURL=registry.d.ts.map

package/dist/collect/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/collect/registry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAQhF,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EAEP,WAAW,EACX,OAAO,EAEP,MAAM,EACN,UAAU,EACV,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;CAC3C;AAyHD,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,EAAE,CAMpE;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,EAAE,CAElE;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAExF;AAqDD,sFAAsF;AACtF,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAY7F;AAkDD,eAAO,MAAM,IAAI,EAAE,OAyCN,CAAC"}

package/dist/collect/registry.js

@@ -0,0 +1,262 @@
+/** Synchronous registration during module evaluation (spec 11-lifecycle.md). */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { testCaseBrand } from '../internal/brands.js';
+import { CollectionError } from '../internal/errors.js';
+import { validateTitle } from '../internal/ids.js';
+import { realmSlot } from '../internal/realm-slot.js';
+const SESSION_NAME_PATTERN = /^[A-Za-z0-9_.-]{1,128}$/;
+class Collector {
+    tests = [];
+    hooks = [];
+    currentGroup = undefined;
+    declarationCounter = 0;
+    closed = false;
+    close() {
+        this.closed = true;
+        return { tests: this.tests, hooks: this.hooks };
+    }
+    assertOpen(api) {
+        if (this.closed) {
+            throw new CollectionError(`${api} was called after module evaluation finished; registration must be synchronous`);
+        }
+    }
+    registerTest(kind, mode, title, options, sessions, fn) {
+        this.assertOpen(kind === 'setup' ? 'test.setup()' : 'test()');
+        const titleError = validateTitle(title);
+        if (titleError !== null)
+            throw new CollectionError(titleError);
+        const normalizedTitle = title.normalize('NFC');
+        if (typeof fn !== 'function')
+            throw new CollectionError('test body must be a function');
+        if (kind === 'setup') {
+            if (this.currentGroup !== undefined) {
+                throw new CollectionError('setup tests must be top-level; they cannot appear in describe');
+            }
+            if (sessions.length === 0) {
+                throw new CollectionError('setup tests must declare at least one session');
+            }
+            for (const name of sessions) {
+                if (!SESSION_NAME_PATTERN.test(name)) {
+                    throw new CollectionError(`invalid session name ${JSON.stringify(name)}: names are 1 through 128 ASCII letters, numbers, "_", "-", or "."`);
+                }
+            }
+            if (new Set(sessions).size !== sessions.length) {
+                throw new CollectionError('duplicate session names in one setup declaration');
+            }
+        }
+        validateTestOptions(options, this.currentGroup);
+        const titlePath = [...groupTitles(this.currentGroup), normalizedTitle];
+        const registered = {
+            kind,
+            title: normalizedTitle,
+            titlePath,
+            declarationIndex: this.declarationCounter,
+            options,
+            sessions,
+            fn,
+            group: this.currentGroup,
+            mode,
+            source: captureSource(),
+        };
+        this.declarationCounter += 1;
+        this.tests.push(registered);
+        return Object.freeze({ [testCaseBrand]: true });
+    }
+    registerDescribe(title, options, body) {
+        this.assertOpen('test.describe()');
+        const titleError = validateTitle(title);
+        if (titleError !== null)
+            throw new CollectionError(titleError);
+        if (typeof body !== 'function')
+            throw new CollectionError('describe body must be a function');
+        validateDescribeOptions(options, this.currentGroup);
+        const group = {
+            title: title.normalize('NFC'),
+            options,
+            parent: this.currentGroup,
+            serial: options.serial === true,
+        };
+        const previous = this.currentGroup;
+        this.currentGroup = group;
+        try {
+            const result = body();
+            if (isPromiseLike(result)) {
+                throw new CollectionError(`describe body for ${JSON.stringify(title)} must finish synchronously`);
+            }
+        }
+        finally {
+            this.currentGroup = previous;
+        }
+    }
+    registerHook(kind, fn) {
+        this.assertOpen(`test.${kind}()`);
+        if (typeof fn !== 'function')
+            throw new CollectionError(`${kind} hook must be a function`);
+        this.hooks.push({
+            kind,
+            fn,
+            group: this.currentGroup,
+            declarationIndex: this.declarationCounter,
+        });
+        this.declarationCounter += 1;
+    }
+}
+function isPromiseLike(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.then === 'function');
+}
+/** Canonical group-tree walk: the enclosing groups of a node, outermost first. */
+export function groupChain(group) {
+    const chain = [];
+    for (let node = group; node !== undefined; node = node.parent) {
+        chain.unshift(node);
+    }
+    return chain;
+}
+/** Group titles along the chain, outermost first. */
+export function groupTitles(group) {
+    return groupChain(group).map((node) => node.title);
+}
+/** Finds the outermost serial group enclosing a node, if any. */
+export function outermostSerialGroup(group) {
+    return groupChain(group).find((node) => node.serial);
+}
+function validateCommonOptions(options, label) {
+    if (options.timeout !== undefined) {
+        if (!Number.isSafeInteger(options.timeout) || options.timeout <= 0) {
+            throw new CollectionError(`${label}: timeout must be a positive safe integer`);
+        }
+    }
+    if (options.retries !== undefined) {
+        if (!Number.isInteger(options.retries) || options.retries < 0 || options.retries > 10) {
+            throw new CollectionError(`${label}: retries must be an integer from 0 through 10`);
+        }
+    }
+}
+function insideSerial(group) {
+    return outermostSerialGroup(group) !== undefined;
+}
+function validateTestOptions(options, group) {
+    validateCommonOptions(options, 'test options');
+    if (insideSerial(group)) {
+        const forbidden = [
+            'retries',
+            'session',
+            'platforms',
+            'requires',
+            'skip',
+            'only',
+        ];
+        for (const key of forbidden) {
+            if (options[key] !== undefined) {
+                throw new CollectionError(`test option "${key}" cannot be overridden inside a serial group; it belongs to the unit`);
+            }
+        }
+    }
+}
+function validateDescribeOptions(options, parent) {
+    validateCommonOptions(options, 'describe options');
+    if (options.serial === true && insideSerial(parent)) {
+        throw new CollectionError('nested serial groups are collection errors');
+    }
+}
+/**
+ * The active collector lives on globalThis because test modules load in an
+ * isolated module realm (tsx) and must reach the runner's collector instance.
+ */
+const collectorSlot = realmSlot('e2e.activeCollector.v1');
+/** Runs `load` with a fresh collector active and returns everything it registered. */
+export async function collectModule(load) {
+    if (collectorSlot.get(globalThis) !== undefined) {
+        throw new CollectionError('collection is already in progress');
+    }
+    const collector = new Collector();
+    collectorSlot.set(globalThis, collector);
+    try {
+        await load();
+    }
+    finally {
+        collectorSlot.delete(globalThis);
+    }
+    return collector.close();
+}
+function requireCollector(api) {
+    const collector = collectorSlot.get(globalThis);
+    if (collector === undefined) {
+        throw new CollectionError(`${api} can only be called while a test module is being collected by the e2e runner`);
+    }
+    return collector;
+}
+/** The runner's own source root (`src/` or `dist/`), whose frames are never a test's location. */
+const RUNNER_ROOT = `${path.dirname(path.dirname(fileURLToPath(import.meta.url)))}${path.sep}`;
+function captureSource() {
+    const stack = new Error().stack;
+    if (stack === undefined)
+        return undefined;
+    const lines = stack.split('\n').slice(1);
+    for (const line of lines) {
+        const match = /\(?(?:file:\/\/)?([^()\s]+?):(\d+):(\d+)\)?$/.exec(line.trim());
+        if (match === null)
+            continue;
+        const file = decodeURIComponent(match[1]);
+        if (file.startsWith(RUNNER_ROOT) || file.startsWith('node:'))
+            continue;
+        return { file, line: Number(match[2]), column: Number(match[3]) };
+    }
+    return undefined;
+}
+function normalizeArgs(optionsOrFn, maybeFn) {
+    if (typeof optionsOrFn === 'function') {
+        return { options: {}, fn: optionsOrFn };
+    }
+    if (maybeFn === undefined)
+        throw new CollectionError('test body function is required');
+    return { options: optionsOrFn, fn: maybeFn };
+}
+const testFunction = (title, optionsOrFn, maybeFn) => {
+    const { options, fn } = normalizeArgs(optionsOrFn, maybeFn);
+    const mode = options.only === true ? 'only' : options.skip !== undefined && options.skip !== false ? 'skip' : 'normal';
+    return requireCollector('test()').registerTest('test', mode, title, options, [], fn);
+};
+export const test = Object.assign(testFunction, {
+    skip(title, fn) {
+        return requireCollector('test.skip()').registerTest('test', 'skip', title, { skip: true }, [], fn);
+    },
+    only(title, fn) {
+        return requireCollector('test.only()').registerTest('test', 'only', title, { only: true }, [], fn);
+    },
+    setup(title, options, fn) {
+        if (options === undefined || !Array.isArray(options.sessions)) {
+            throw new CollectionError('test.setup() requires a static sessions list');
+        }
+        const { sessions, ...rest } = options;
+        return requireCollector('test.setup()').registerTest('setup', 'normal', title, rest, sessions, fn);
+    },
+    describe(title, optionsOrBody, maybeBody) {
+        const options = typeof optionsOrBody === 'function' ? {} : optionsOrBody;
+        const body = typeof optionsOrBody === 'function' ? optionsOrBody : maybeBody;
+        if (body === undefined)
+            throw new CollectionError('describe body function is required');
+        requireCollector('test.describe()').registerDescribe(title, options, body);
+    },
+    beforeEach(fn) {
+        requireCollector('test.beforeEach()').registerHook('beforeEach', fn);
+    },
+    afterEach(fn) {
+        requireCollector('test.afterEach()').registerHook('afterEach', fn);
+    },
+    beforeAll(fn) {
+        requireCollector('test.beforeAll()').registerHook('beforeAll', fn);
+    },
+    afterAll(fn) {
+        requireCollector('test.afterAll()').registerHook('afterAll', fn);
+    },
+    // Type-only refinement: contributed fixtures are resolved from the backend
+    // at runtime, so the same test object serves every fixture shape.
+    extend() {
+        return test;
+    },
+});
+//# sourceMappingURL=registry.js.map

package/dist/collect/registry.js.map

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

package/dist/collect/select.d.ts

@@ -0,0 +1,54 @@
+/** Option resolution and test-target selection (spec 11-lifecycle.md). */
+import type { ResolvedConfig, ResolvedTarget } from '../config/resolve.ts';
+import type { Capability, Platform } from '../types.ts';
+import type { Collection, CollectedTest } from './collect.ts';
+export interface ResolvedTestOptions {
+    readonly timeout: number;
+    readonly retries: number;
+    readonly tags: readonly string[];
+    readonly platforms: readonly Platform[] | undefined;
+    readonly requires: readonly Capability[];
+    readonly session: string | undefined;
+    readonly agentContext: string | undefined;
+    readonly skipReason: string | undefined;
+    readonly serial: boolean;
+}
+export interface SkipInfo {
+    readonly cause: 'explicit' | 'filtered' | 'platform-unavailable' | 'capability-unavailable' | 'setup-failed' | 'serial-predecessor-failed' | 'hook-failed' | 'infrastructure-unavailable';
+    readonly reason: string;
+    readonly relatedId?: string;
+}
+export interface TestTargetPair {
+    readonly test: CollectedTest;
+    readonly target: ResolvedTarget;
+    readonly options: ResolvedTestOptions;
+    /** run: execute; skip: report skipped; filtered: report as unselected. */
+    readonly disposition: 'run' | 'skip' | 'filtered';
+    readonly skip: SkipInfo | undefined;
+}
+/** All pairs for one selected target, in report order. */
+export interface TargetSelection {
+    readonly target: ResolvedTarget;
+    readonly pairs: readonly TestTargetPair[];
+}
+export interface Selection {
+    /** Every pair across all selected targets, in report order. */
+    readonly pairs: readonly TestTargetPair[];
+    /** Selected targets with their pairs, in config order. */
+    readonly perTarget: readonly TargetSelection[];
+}
+export interface SelectionFilters {
+    readonly tags?: readonly string[];
+    readonly tagMode?: 'any' | 'all';
+    readonly targetIds?: readonly string[];
+}
+/** Resolves effective options: test > nearest group > outer groups > config > default. */
+export declare function resolveOptions(test: CollectedTest, config: ResolvedConfig): ResolvedTestOptions;
+/**
+ * Expands the collection into test-target pairs and applies focus, tag,
+ * platform, capability, session, and serial-closure rules.
+ */
+export declare function select(collection: Collection, config: ResolvedConfig, filters?: SelectionFilters, flags?: {
+    passWithNoTests?: boolean;
+}): Selection;
+//# sourceMappingURL=select.d.ts.map

package/dist/collect/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/collect/select.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAG1E,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EACV,UAAU,GACV,UAAU,GACV,sBAAsB,GACtB,wBAAwB,GACxB,cAAc,GACd,2BAA2B,GAC3B,aAAa,GACb,4BAA4B,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;CACrC;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,GAAG,mBAAmB,CA+C/F;AAYD;;;GAGG;AACH,wBAAgB,MAAM,CACpB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,gBAAqB,EAC9B,KAAK,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,SAAS,CAyDX"}