@e2edev/e2e 0.2.0

package/dist/cache/trace.js

@@ -0,0 +1,249 @@
+/**
+ * `trace-1` entry format (RFC0001 layer 3, cache-in decision).
+ *
+ * A trace is the ordered list of grammar actions one passing `agent.act()`
+ * step performed, each with a durable target descriptor and secret-free,
+ * verbatim input — never model output, never plaintext secrets. An entry is
+ * deliberately small: a schema version, when it was written, and the trace
+ * with the provenance it had. It does not repeat its own key: the file name
+ * is the key digest and a reader only ever opens the digest of the key it
+ * just computed.
+ *
+ * Actions are a discriminated union: each variant carries exactly the typed
+ * input its grammar action needs, so validation here is the one owner of
+ * replayability — a document that reads back as an entry replays verbatim,
+ * and a document this runner cannot replay verbatim comes back as
+ * `undefined`, never as a repaired or partially trusted entry.
+ */
+import { timestamp } from '../internal/ids.js';
+export const TRACE_SCHEMA_VERSION = 'trace-1';
+/** Mirrors the default step action budget; overflow marks the trace truncated. */
+export const MAX_TRACE_ACTIONS = 50;
+/** Prose caps keep an entry a receipt, not a transcript. */
+export const MAX_TRACE_SUMMARY_CHARS = 300;
+export const MAX_TRACE_DESCRIPTOR_CHARS = 300;
+/**
+ * Cap on verbatim replay inputs (typed text, URLs, option labels). Inputs are
+ * never truncated to fit — a trimmed URL or half a typed value would replay a
+ * different action than the one recorded — so an oversized input poisons the
+ * trace (`truncated`) instead of bending the value.
+ */
+export const MAX_TRACE_INPUT_CHARS = 4_096;
+/** Caps prose at `maxChars`, marking the cut with an ellipsis. */
+export function bound(text, maxChars) {
+    return text.length <= maxChars ? text : `${text.slice(0, maxChars - 1)}…`;
+}
+/**
+ * Cap on recorded end anchors. Anchors are the step's own delta — what
+ * appeared on screen between the first observation and the passing one — so
+ * a same-screen mutation rarely has more than a handful; a step that changes
+ * the whole screen keeps the first few in document order.
+ */
+export const MAX_TRACE_ANCHORS = 8;
+const SCROLL_DIRECTIONS = new Set(['up', 'down', 'left', 'right']);
+/** The shape `timestamp()` writes: an ISO 8601 UTC instant. */
+const ISO_INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/;
+/** Wraps one trace as a fresh entry. */
+export function buildTraceEntry(payload) {
+    return { schemaVersion: TRACE_SCHEMA_VERSION, createdAt: timestamp(), payload };
+}
+/**
+ * Reads one document as a `trace-1` entry, or returns undefined when it is
+ * not one this runner can trust. Unknown fields are dropped rather than
+ * carried: the returned entry contains exactly the validated shape.
+ */
+export function readTraceEntry(document) {
+    if (typeof document !== 'object' || document === null || Array.isArray(document)) {
+        return undefined;
+    }
+    const raw = document;
+    if (raw['schemaVersion'] !== TRACE_SCHEMA_VERSION)
+        return undefined;
+    // Provenance must be the ISO instant this runner writes (`timestamp()`),
+    // not synthesized and not merely something Date.parse tolerates: a custom
+    // store returning anything else is returning a document this runner never
+    // wrote, and fail-to-miss is the only safe answer.
+    const createdAt = raw['createdAt'];
+    if (typeof createdAt !== 'string' || !ISO_INSTANT.test(createdAt))
+        return undefined;
+    const payload = readActionTrace(raw['payload']);
+    if (payload === undefined)
+        return undefined;
+    return { schemaVersion: TRACE_SCHEMA_VERSION, createdAt, payload };
+}
+function readActionTrace(document) {
+    if (typeof document !== 'object' || document === null || Array.isArray(document)) {
+        return undefined;
+    }
+    const raw = document;
+    const executorRaw = raw['executor'];
+    if (typeof executorRaw !== 'object' || executorRaw === null)
+        return undefined;
+    const executorName = executorRaw['name'];
+    const executorVersion = executorRaw['version'];
+    if (typeof executorName !== 'string' || executorName === '')
+        return undefined;
+    if (executorVersion !== undefined && typeof executorVersion !== 'string')
+        return undefined;
+    const summary = readBoundedText(raw['summary'], MAX_TRACE_SUMMARY_CHARS);
+    if (summary === undefined)
+        return undefined;
+    const startPath = raw['startPath'];
+    if (startPath !== undefined) {
+        if (typeof startPath !== 'string' || startPath === '' || startPath.length > MAX_TRACE_DESCRIPTOR_CHARS) {
+            return undefined;
+        }
+    }
+    const endPath = raw['endPath'];
+    if (endPath !== undefined) {
+        if (typeof endPath !== 'string' || endPath === '' || endPath.length > MAX_TRACE_DESCRIPTOR_CHARS) {
+            return undefined;
+        }
+    }
+    const truncated = raw['truncated'];
+    if (truncated !== undefined && typeof truncated !== 'boolean')
+        return undefined;
+    const anchorsRaw = raw['endAnchors'];
+    let endAnchors;
+    if (anchorsRaw !== undefined) {
+        if (!Array.isArray(anchorsRaw) || anchorsRaw.length > MAX_TRACE_ANCHORS)
+            return undefined;
+        endAnchors = [];
+        for (const entry of anchorsRaw) {
+            const descriptor = readDescriptor(entry);
+            if (descriptor === undefined)
+                return undefined;
+            endAnchors.push(descriptor);
+        }
+    }
+    const actionsRaw = raw['actions'];
+    if (!Array.isArray(actionsRaw) || actionsRaw.length === 0 || actionsRaw.length > MAX_TRACE_ACTIONS) {
+        return undefined;
+    }
+    const actions = [];
+    for (const entry of actionsRaw) {
+        const action = readRecordedAction(entry);
+        if (action === undefined)
+            return undefined;
+        actions.push(action);
+    }
+    return {
+        actions,
+        executor: {
+            name: executorName,
+            ...(executorVersion === undefined ? {} : { version: executorVersion }),
+        },
+        summary,
+        ...(startPath === undefined ? {} : { startPath }),
+        ...(endPath === undefined ? {} : { endPath }),
+        ...(endAnchors === undefined || endAnchors.length === 0 ? {} : { endAnchors }),
+        ...(truncated === undefined ? {} : { truncated }),
+    };
+}
+function readRecordedAction(document) {
+    if (typeof document !== 'object' || document === null || Array.isArray(document)) {
+        return undefined;
+    }
+    const raw = document;
+    const summary = readBoundedText(raw['summary'], MAX_TRACE_SUMMARY_CHARS);
+    if (summary === undefined)
+        return undefined;
+    switch (raw['name']) {
+        case 'tap': {
+            const target = readDescriptor(raw['target']);
+            return target === undefined ? undefined : { name: 'tap', summary, target };
+        }
+        case 'type': {
+            const target = readDescriptor(raw['target']);
+            const value = readInputText(raw['value']);
+            if (target === undefined || value === undefined)
+                return undefined;
+            return { name: 'type', summary, target, value };
+        }
+        case 'typeSecret': {
+            const target = readDescriptor(raw['target']);
+            const secret = readBoundedText(raw['secret'], MAX_TRACE_DESCRIPTOR_CHARS);
+            if (target === undefined || secret === undefined)
+                return undefined;
+            return { name: 'typeSecret', summary, target, secret };
+        }
+        case 'press': {
+            const target = readDescriptor(raw['target']);
+            const key = readBoundedText(raw['key'], 64);
+            if (target === undefined || key === undefined)
+                return undefined;
+            return { name: 'press', summary, target, key };
+        }
+        case 'select': {
+            const target = readDescriptor(raw['target']);
+            const value = readInputText(raw['value']);
+            if (target === undefined || value === undefined)
+                return undefined;
+            return { name: 'select', summary, target, value };
+        }
+        case 'scroll': {
+            const direction = raw['direction'];
+            if (typeof direction !== 'string' || !SCROLL_DIRECTIONS.has(direction))
+                return undefined;
+            const target = raw['target'] === undefined ? undefined : readDescriptor(raw['target']);
+            if (raw['target'] !== undefined && target === undefined)
+                return undefined;
+            return {
+                name: 'scroll',
+                summary,
+                direction: direction,
+                ...(target === undefined ? {} : { target }),
+            };
+        }
+        case 'navigate': {
+            const url = readInputText(raw['url']);
+            return url === undefined ? undefined : { name: 'navigate', summary, url };
+        }
+        case 'tool':
+            return { name: 'tool', summary };
+        default:
+            return undefined;
+    }
+}
+const DESCRIPTOR_FIELDS = [
+    'role',
+    'name',
+    'text',
+    'testId',
+    'placeholder',
+    'selector',
+    'inputPurpose',
+];
+function readDescriptor(document) {
+    if (typeof document !== 'object' || document === null || Array.isArray(document)) {
+        return undefined;
+    }
+    const raw = document;
+    const descriptor = {};
+    for (const field of DESCRIPTOR_FIELDS) {
+        const value = raw[field];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string' || value.length > MAX_TRACE_DESCRIPTOR_CHARS)
+            return undefined;
+        if (value !== '')
+            descriptor[field] = value;
+    }
+    if (Object.keys(descriptor).length === 0)
+        return undefined;
+    return descriptor;
+}
+function readBoundedText(value, maxChars) {
+    if (typeof value !== 'string' || value.trim() === '' || value.length > maxChars) {
+        return undefined;
+    }
+    return value;
+}
+/** Verbatim replay input: bounded but never trimmed — whitespace can be the value. */
+function readInputText(value) {
+    if (typeof value !== 'string' || value === '' || value.length > MAX_TRACE_INPUT_CHARS) {
+        return undefined;
+    }
+    return value;
+}
+//# sourceMappingURL=trace.js.map

package/dist/cache/trace.js.map

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

package/dist/cli/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/cli/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":""}

package/dist/cli/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from './index.js';
+await main(process.argv);
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,4 @@
+/** e2e CLI (spec 06-cli.md). */
+/** CLI entry invoked by the bin wrapper. */
+export declare function main(argv: readonly string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AA0HhC,4CAA4C;AAC5C,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjE"}

package/dist/cli/index.js

@@ -0,0 +1,108 @@
+/** e2e CLI (spec 06-cli.md). */
+import { Command, CommanderError, InvalidArgumentError } from 'commander';
+import { run } from '../run/runner.js';
+import { init } from './init.js';
+/** Shape check only; the config resolver applies each flag's bounds. */
+function parseNonNegativeInt(value) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 0) {
+        throw new InvalidArgumentError('must be a nonnegative integer');
+    }
+    return parsed;
+}
+function parseList(value) {
+    return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item !== '');
+}
+const REPORTERS = ['list', 'json'];
+function isReporter(value) {
+    return REPORTERS.includes(value);
+}
+function isTagMode(value) {
+    return value === 'any' || value === 'all';
+}
+/** Builds the commander program. */
+function createProgram() {
+    const program = new Command('e2e');
+    program.description('open, local-first standard for agentic end-to-end testing');
+    // Commander would exit(1) on a usage error itself; spec 06-cli.md reserves 1
+    // for product failures and 2 for CLI errors, so exits are decided in main.
+    program.exitOverride();
+    program
+        .command('init')
+        .description('scaffold e2e.config.ts, an example test, and .gitignore entries')
+        .option('-y, --yes', 'skip confirmation prompts')
+        .action(async (options) => {
+        process.exitCode = await init(process.cwd(), options);
+    });
+    program
+        .command('run')
+        .description('run e2e tests')
+        .argument('[files...]', 'test files relative to the project root')
+        .option('--config <path>', 'explicit config path')
+        .option('--target <ids>', 'comma-separated target IDs', parseList)
+        .option('--tag <tag>', 'repeatable tag filter', (value, previous = []) => [...previous, value])
+        .option('--tag-mode <mode>', 'tag composition: any or all', 'any')
+        .option('--headed', 'request visible UI when the backend supports it')
+        .option('--retries <n>', 'replace resolved retry count', parseNonNegativeInt)
+        .option('--workers <n>', 'replace worker count', parseNonNegativeInt)
+        .option('--reporter <ids>', 'comma-separated reporters: list, json', parseList)
+        .option('--artifacts <dir>', 'artifact root, default .e2e/artifacts')
+        .option('--no-cache', 'run without the trace cache, overriding the config')
+        .option('--pass-with-no-tests', 'allow zero runnable ordinary test-target pairs')
+        .option('--debug', 'print aggregated phase timings to stderr after the run')
+        .option('--ai-trace', 'record every model call to .e2e/ai-trace.json for trace viewers')
+        .action(async (files, options) => {
+        const { tagMode, reporter } = options;
+        if (!isTagMode(tagMode)) {
+            process.stderr.write(`invalid --tag-mode "${tagMode}"; expected any or all\n`);
+            process.exitCode = 2;
+            return;
+        }
+        const invalidReporter = reporter?.find((value) => !isReporter(value));
+        if (invalidReporter !== undefined) {
+            process.stderr.write(`unknown reporter "${invalidReporter}"\n`);
+            process.exitCode = 2;
+            return;
+        }
+        const outcome = await run({
+            files,
+            configPath: options.config,
+            targetIds: options.target,
+            tags: options.tag,
+            tagMode,
+            headed: options.headed,
+            retries: options.retries,
+            workers: options.workers,
+            // Validated above; the filter is the type narrowing, not a second check.
+            reporters: reporter?.filter(isReporter),
+            artifactsDir: options.artifacts,
+            noCache: options.cache === false,
+            passWithNoTests: options.passWithNoTests,
+            debug: options.debug,
+            aiTrace: options.aiTrace,
+        });
+        process.exitCode = outcome.exitCode;
+    });
+    return program;
+}
+/** CLI entry invoked by the bin wrapper. */
+export async function main(argv) {
+    const program = createProgram();
+    try {
+        await program.parseAsync([...argv]);
+    }
+    catch (cause) {
+        if (cause instanceof CommanderError) {
+            // Commander has already written its diagnostic. `--help` and
+            // `--version` exit 0; every usage error is a CLI error: exit 2.
+            process.exitCode = cause.exitCode === 0 ? 0 : 2;
+            return;
+        }
+        process.stderr.write(`${cause instanceof Error ? cause.message : String(cause)}\n`);
+        process.exitCode = 2;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,6 @@
+/** Non-destructive project scaffolding (spec 06-cli.md). */
+/** Runs `e2e init`. Creates only missing files and stops before any conflict. */
+export declare function init(cwd: string, options?: {
+    yes?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAsD5D,iFAAiF;AACjF,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DxF"}

package/dist/cli/init.js

@@ -0,0 +1,101 @@
+/** Non-destructive project scaffolding (spec 06-cli.md). */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import * as clack from '@clack/prompts';
+const CONFIG_TEMPLATE = `import { defineConfig } from '@e2edev/e2e';
+import { createAgent } from '@e2edev/e2e/agent';
+import { playwright } from '@e2edev/playwright';
+
+export default defineConfig({
+  specVersion: '0.1',
+  app: {
+    url: process.env.APP_URL ?? 'http://localhost:3000',
+  },
+  // The runner ships no intelligence: you construct the agent and pass it in.
+  // createAgent builds the built-in one; its model comes from E2E_MODEL.
+  agent: createAgent({
+    system: 'You are a thorough QA agent. Verify every outcome on screen.',
+  }),
+  // The runner knows no platform: a target is served by the backend you pass.
+  targets: [{ name: 'web', platform: 'web', backend: playwright({ browser: 'chromium' }) }],
+});
+`;
+const EXAMPLE_TEMPLATE = `import { test } from '@e2edev/playwright';
+import { expect } from '@e2edev/e2e';
+
+test('app opens', async ({ app, web }) => {
+  await app.open();
+  await expect(web).toHaveURL('/');
+});
+
+// Runs when E2E_MODEL and E2E_MODEL_API_KEY are set:
+// test('the agent drives a flow', async ({ app, agent }) => {
+//   await app.open();
+//   await agent.act('one goal in plain language');
+//   await agent.assert('one question about the screen');
+// });
+`;
+const GITIGNORE_ENTRIES = [
+    '.e2e/artifacts/',
+    '.e2e/cache/',
+    '.e2e/sessions/',
+    '.e2e/report.json',
+    '.e2e/ai-trace.json',
+];
+/** Runs `e2e init`. Creates only missing files and stops before any conflict. */
+export async function init(cwd, options = {}) {
+    clack.intro('e2e init');
+    const planned = [
+        { relative: 'e2e.config.ts', content: CONFIG_TEMPLATE },
+        { relative: path.join('tests', 'example.e2e.ts'), content: EXAMPLE_TEMPLATE },
+    ];
+    const exists = (file) => existsSync(path.join(cwd, file.relative));
+    const conflicts = planned.filter(exists);
+    const remaining = planned.filter((file) => !exists(file));
+    for (const conflict of conflicts) {
+        clack.log.warn(`exists, not touching: ${conflict.relative}`);
+    }
+    // The ignore list is reconciled on every run, not only the first: a project
+    // initialized before an entry existed (`.e2e/ai-trace.json`, say) picks it
+    // up by re-running init, without touching any scaffold file.
+    const gitignorePath = path.join(cwd, '.gitignore');
+    const existing = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf8') : '';
+    // A CRLF .gitignore must not re-append every entry on each init.
+    const lines = existing.split(/\r?\n/);
+    const missing = GITIGNORE_ENTRIES.filter((entry) => !lines.includes(entry));
+    if (remaining.length === 0 && missing.length === 0) {
+        clack.outro('nothing to create; project already initialized');
+        return 0;
+    }
+    if (options.yes !== true) {
+        const actions = [
+            ...(remaining.length === 0
+                ? []
+                : [`create ${remaining.map((file) => file.relative).join(', ')}`]),
+            ...(missing.length === 0 ? [] : ['update .gitignore']),
+        ];
+        const proceed = await clack.confirm({ message: `${actions.join(' and ')}?` });
+        if (clack.isCancel(proceed) || proceed !== true) {
+            clack.cancel('cancelled; no changes were made');
+            return 0;
+        }
+    }
+    for (const file of remaining) {
+        const absolute = path.join(cwd, file.relative);
+        mkdirSync(path.dirname(absolute), { recursive: true });
+        writeFileSync(absolute, file.content, 'utf8');
+        clack.log.success(`created ${file.relative}`);
+    }
+    if (missing.length > 0) {
+        const prefix = existing === '' || existing.endsWith('\n') ? '' : '\n';
+        writeFileSync(gitignorePath, `${existing}${prefix}${missing.join('\n')}\n`, 'utf8');
+        clack.log.success(`updated .gitignore (${missing.length} entries)`);
+    }
+    if (remaining.length === 0) {
+        clack.outro('project already initialized; .gitignore brought up to date');
+        return 0;
+    }
+    clack.outro('next: install @e2edev/playwright, then APP_URL=http://localhost:3000 npx --no-install e2e run');
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/collect/collect.d.ts

@@ -0,0 +1,44 @@
+/** Collection realm: imports test modules and derives stable identities. */
+import type { ResolvedConfig } from '../config/resolve.ts';
+import { type GroupNode, type ModuleRegistration, type RegisteredTest, type SourceLocation } from './registry.ts';
+/**
+ * Everything needed to name and report a test, with no executable or realm
+ * state attached. Fully JSON-serializable, so it is what result records carry
+ * and what crosses the runner<->worker IPC channel.
+ */
+export interface TestIdentity {
+    readonly kind: 'test' | 'setup';
+    readonly title: string;
+    readonly titlePath: readonly string[];
+    readonly declarationIndex: number;
+    readonly sessions: readonly string[];
+    readonly source: SourceLocation | undefined;
+    /** Normalized project-root-relative file path with `/` separators. */
+    readonly file: string;
+    readonly id: string;
+    readonly serialId: string | undefined;
+}
+export interface CollectedTest extends RegisteredTest, TestIdentity {
+    /** Outermost serial group, when the test is a serial-group member. */
+    readonly serialRoot: GroupNode | undefined;
+}
+/** Narrows a collected test to its reportable, serializable identity. */
+export declare function testIdentity(test: CollectedTest): TestIdentity;
+export interface CollectedFile {
+    readonly file: string;
+    readonly absolutePath: string;
+    readonly registration: ModuleRegistration;
+    readonly tests: readonly CollectedTest[];
+}
+export interface Collection {
+    readonly files: readonly CollectedFile[];
+    readonly tests: readonly CollectedTest[];
+}
+/** Builds one CollectedFile from an already-produced registration. */
+export declare function collectFromRegistration(projectRoot: string, filePath: string, registration: ModuleRegistration): CollectedFile;
+/**
+ * Runs collection: resolves globs, sorts matched files by code point, and
+ * imports each module once in the collection realm.
+ */
+export declare function collect(config: ResolvedConfig, fileFilter?: readonly string[]): Promise<Collection>;
+//# sourceMappingURL=collect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/collect/collect.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAO5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,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,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc,EAAE,YAAY;IACjE,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC;CAC5C;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAY9D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAsCD,sEAAsE;AACtE,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,kBAAkB,GAC/B,aAAa,CAQf;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,cAAc,EACtB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,UAAU,CAAC,CAsBrB"}