@ontrails/testing 1.0.0-beta.14 → 1.0.0-beta.16

package/dist/crosses.js

@@ -1,213 +0,0 @@
-/**
- * testCrosses — crossing-aware scenario testing for trails with crossings.
- *
- * Tests the crossing graph: which trails were crossed, in what order,
- * and supports failure injection from crossed trail examples.
- */
-import { describe, expect, test } from 'bun:test';
-import { executeTrail, InternalError, Result, ValidationError, validateInput, } from '@ontrails/core';
-import { assertErrorMatch, assertFullMatch, assertSchemaMatch, } from './assertions.js';
-import { mergeProvisionOverrides, mergeTestContext } from './context.js';
-const collectDeclaredProvisions = (trailDef, trailsMap) => {
-    const seenProvisionIds = new Set();
-    const seenTrailIds = new Set();
-    const provisions = [];
-    const collect = (candidate) => {
-        for (const declaredProvision of candidate.provisions) {
-            if (seenProvisionIds.has(declaredProvision.id)) {
-                continue;
-            }
-            seenProvisionIds.add(declaredProvision.id);
-            provisions.push(declaredProvision);
-        }
-    };
-    const visit = (candidate) => {
-        if (seenTrailIds.has(candidate.id)) {
-            return;
-        }
-        seenTrailIds.add(candidate.id);
-        collect(candidate);
-        for (const crossedId of candidate.crosses) {
-            const crossedTrail = trailsMap?.get(crossedId);
-            if (crossedTrail) {
-                visit(crossedTrail);
-            }
-        }
-    };
-    visit(trailDef);
-    return provisions;
-};
-const resolveCrossMockProvisions = async (trailDef, trailsMap) => {
-    const provisions = {};
-    for (const declaredProvision of collectDeclaredProvisions(trailDef, trailsMap)) {
-        if (!declaredProvision.mock) {
-            continue;
-        }
-        provisions[declaredProvision.id] = await declaredProvision.mock();
-    }
-    return provisions;
-};
-// ---------------------------------------------------------------------------
-// Injection helpers
-// ---------------------------------------------------------------------------
-/**
- * Find an error example on a trail by name or description substring.
- */
-const findErrorExample = (trailDef, description) => {
-    const example = trailDef.examples?.find((ex) => ex.error !== undefined &&
-        (ex.description?.includes(description) || ex.name.includes(description)));
-    return example?.error;
-};
-/**
- * Try to inject an error from a crossed trail's example.
- * Returns undefined when no injection is configured for this trail ID.
- */
-const tryInjectError = (id, scenario, trailsMap) => {
-    const injection = scenario.injectFromExample?.[id];
-    if (injection === undefined) {
-        return undefined;
-    }
-    const trailDef = trailsMap?.get(id);
-    if (trailDef === undefined) {
-        return Result.err(new InternalError(`Cannot inject: trail "${id}" not in topo`));
-    }
-    const errorName = findErrorExample(trailDef, injection);
-    if (errorName === undefined) {
-        return Result.err(new InternalError(`No error example matching "${injection}" on trail "${id}"`));
-    }
-    return Result.err(new Error(errorName));
-};
-/**
- * Execute a trail from the map, validating input first.
- */
-const executeFromMap = (id, input, trailsMap, ctx, provisions, cross) => {
-    const trailDef = trailsMap?.get(id);
-    if (trailDef === undefined) {
-        return undefined;
-    }
-    const nestedCtx = cross ? { ...ctx, cross } : ctx;
-    return executeTrail(trailDef, input, {
-        ctx: nestedCtx,
-        provisions,
-    });
-};
-// ---------------------------------------------------------------------------
-// Cross factory
-// ---------------------------------------------------------------------------
-/**
- * Build a recording cross function that optionally injects errors.
- */
-const createRecordingCross = (trace, scenario, trailsMap, baseCross, ctx, provisions) => {
-    // The generic O on CrossFn is erased at runtime; the cast is safe
-    // because callers narrow via isOk/isErr before accessing the value.
-    const cross = (id, input) => {
-        trace.push({ id, input });
-        const injected = tryInjectError(id, scenario, trailsMap);
-        if (injected !== undefined) {
-            return Promise.resolve(injected);
-        }
-        if (baseCross !== undefined) {
-            return baseCross(id, input);
-        }
-        const executed = executeFromMap(id, input, trailsMap, ctx, provisions, cross);
-        if (executed !== undefined) {
-            return Promise.resolve(executed);
-        }
-        return Promise.resolve(Result.ok());
-    };
-    return cross;
-};
-// ---------------------------------------------------------------------------
-// Scenario assertions
-// ---------------------------------------------------------------------------
-const assertScenarioResult = (result, scenario, trailDef) => {
-    if (scenario.expectValue !== undefined) {
-        assertFullMatch(result, scenario.expectValue);
-    }
-    else if (scenario.expectErr !== undefined) {
-        assertErrorMatch(result, scenario.expectErr, scenario.expectErrMessage);
-    }
-    else if (scenario.expectErrMessage !== undefined) {
-        expect(result.isErr()).toBe(true);
-        if (result.isErr()) {
-            expect(result.error.message).toContain(scenario.expectErrMessage);
-        }
-    }
-    else if (scenario.expectOk === true) {
-        expect(result.isOk()).toBe(true);
-        assertSchemaMatch(result, trailDef.output);
-    }
-};
-const assertCrossTrace = (trace, scenario) => {
-    if (scenario.expectCrossed !== undefined) {
-        const crossedIds = trace.map((r) => r.id);
-        expect(crossedIds).toEqual([...scenario.expectCrossed]);
-    }
-    if (scenario.expectCrossedCount !== undefined) {
-        const counts = {};
-        for (const record of trace) {
-            counts[record.id] = (counts[record.id] ?? 0) + 1;
-        }
-        expect(counts).toEqual({ ...scenario.expectCrossedCount });
-    }
-};
-const handleValidationError = (validated, scenario) => {
-    if (!validated.isErr()) {
-        return false;
-    }
-    if (scenario.expectErr === ValidationError) {
-        expect(validated.error).toBeInstanceOf(ValidationError);
-        if (scenario.expectErrMessage !== undefined) {
-            expect(validated.error.message).toContain(scenario.expectErrMessage);
-        }
-        return true;
-    }
-    throw new Error(`Input validation failed unexpectedly: ${validated.error.message}`);
-};
-// ---------------------------------------------------------------------------
-// Scenario runner
-// ---------------------------------------------------------------------------
-const buildTestContext = (scenario, ctx, trailsMap, provisions) => {
-    const trace = [];
-    const baseCtx = mergeTestContext(ctx);
-    const cross = createRecordingCross(trace, scenario, trailsMap, baseCtx.cross, baseCtx, provisions);
-    return { testCtx: { ...baseCtx, cross }, trace };
-};
-const runScenario = async (trailDef, scenario, ctx, trailsMap, provisions) => {
-    const validated = validateInput(trailDef.input, scenario.input);
-    if (handleValidationError(validated, scenario)) {
-        return;
-    }
-    const { trace, testCtx } = buildTestContext(scenario, ctx, trailsMap, provisions);
-    const result = await executeTrail(trailDef, scenario.input, {
-        ctx: testCtx,
-        provisions,
-    });
-    assertCrossTrace(trace, scenario);
-    assertScenarioResult(result, scenario, trailDef);
-};
-/**
- * Generate a describe block for a trail with crossings with one test per scenario.
- *
- * @example
- * ```ts
- * testCrosses(onboardTrail, [
- *   {
- *     description: "crosses add then relate",
- *     input: { name: "Alpha" },
- *     expectOk: true,
- *     expectCrossed: ["entity.add", "entity.relate"],
- *   },
- * ]);
- * ```
- */
-export const testCrosses = (trailDef, scenarios, options) => {
-    const explicitProvisions = options?.provisions;
-    describe(trailDef.id, () => {
-        test.each([...scenarios])('$description', async (scenario) => {
-            const provisions = mergeProvisionOverrides(await resolveCrossMockProvisions(trailDef, options?.trails), options?.ctx, explicitProvisions);
-            await runScenario(trailDef, scenario, options?.ctx, options?.trails, provisions);
-        });
-    });
-};
-//# sourceMappingURL=crosses.js.map

package/dist/crosses.js.map

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

package/dist/detours.d.ts

@@ -1,12 +0,0 @@
-/**
- * testDetours — verify that all detour targets exist in the topo.
- *
- * Pure structural validation. No implementation execution needed.
- */
-import type { Topo } from '@ontrails/core';
-/**
- * Verify that every trail's detour targets reference trails that
- * actually exist in the app's topo.
- */
-export declare const testDetours: (app: Topo) => void;
-//# sourceMappingURL=detours.d.ts.map

package/dist/detours.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"detours.d.ts","sourceRoot":"","sources":["../src/detours.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAS,MAAM,gBAAgB,CAAC;AAMlD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,IAAI,KAAG,IAyBvC,CAAC"}

package/dist/detours.js

@@ -1,30 +0,0 @@
-/**
- * testDetours — verify that all detour targets exist in the topo.
- *
- * Pure structural validation. No implementation execution needed.
- */
-import { describe, expect, test } from 'bun:test';
-// ---------------------------------------------------------------------------
-// testDetours
-// ---------------------------------------------------------------------------
-/**
- * Verify that every trail's detour targets reference trails that
- * actually exist in the app's topo.
- */
-export const testDetours = (app) => {
-    const trailEntries = [...app.trails];
-    describe('detours', () => {
-        describe.each(trailEntries)('%s', (_id, trailDef) => {
-            const t = trailDef;
-            if (t.detours === undefined) {
-                return;
-            }
-            const { detours } = t;
-            const testCases = Object.entries(detours).flatMap(([detourName, targets]) => targets.map((targetId) => ({ detourName, targetId })));
-            test.each(testCases)('detour "$detourName" -> "$targetId" exists', ({ targetId }) => {
-                expect(app.has(targetId)).toBe(true);
-            });
-        });
-    });
-};
-//# sourceMappingURL=detours.js.map

package/dist/detours.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"detours.js","sourceRoot":"","sources":["../src/detours.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAIlD,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAS,EAAQ,EAAE;IAC7C,MAAM,YAAY,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAErC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;YAClD,MAAM,CAAC,GAAG,QAAmC,CAAC;YAE9C,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YACtB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAC/C,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,CACxB,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CACxD,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAClB,4CAA4C,EAC5C,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;gBACf,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/examples.d.ts

@@ -1,23 +0,0 @@
-/**
- * testExamples — the headline one-liner.
- *
- * Iterates every trail in the app's topo. For each trail with examples,
- * generates describe/test blocks using bun:test. Progressive assertion
- * determines which check to run per example. For trails with `crosses`
- * declarations, checks that every declared crossing was called at least once.
- */
-import type { Topo, TrailContext } from '@ontrails/core';
-import type { TestExecutionOptions } from './context.js';
-/**
- * Generate describe/test blocks for every trail example in the app.
- *
- * For trails with `crosses` declarations and examples, also verifies that
- * every declared crossed ID was called at least once across all examples.
- *
- * One line in your test file:
- * ```ts
- * testExamples(app);
- * ```
- */
-export declare const testExamples: (app: Topo, ctxOrFactory?: Partial<TrailContext> | TestExecutionOptions | (() => Partial<TrailContext> | TestExecutionOptions)) => void;
-//# sourceMappingURL=examples.d.ts.map

package/dist/examples.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../src/examples.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAGV,IAAI,EAGJ,YAAY,EACb,MAAM,gBAAgB,CAAC;AAmCxB,OAAO,KAAK,EAAiB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA6MxE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,IAAI,EACT,eACI,OAAO,CAAC,YAAY,CAAC,GACrB,oBAAoB,GACpB,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,oBAAoB,CAAC,KACvD,IA0EF,CAAC"}

package/dist/examples.js

@@ -1,202 +0,0 @@
-/**
- * testExamples — the headline one-liner.
- *
- * Iterates every trail in the app's topo. For each trail with examples,
- * generates describe/test blocks using bun:test. Progressive assertion
- * determines which check to run per example. For trails with `crosses`
- * declarations, checks that every declared crossing was called at least once.
- */
-import { describe, expect, test } from 'bun:test';
-import { AlreadyExistsError, AmbiguousError, AssertionError, AuthError, CancelledError, ConflictError, InternalError, NetworkError, NotFoundError, PermissionError, RateLimitError, executeTrail, Result, TimeoutError, TrailsError, ValidationError, validateInput, } from '@ontrails/core';
-import { assertErrorMatch, assertFullMatch, assertSchemaMatch, } from './assertions.js';
-import { defaultMintPermit, mergeProvisionOverrides, mergeTestContext, normalizeTestExecutionOptions, resolveMockProvisions, } from './context.js';
-// ---------------------------------------------------------------------------
-// Error class name -> constructor map
-// ---------------------------------------------------------------------------
-const ERROR_MAP = {
-    AlreadyExistsError: AlreadyExistsError,
-    AmbiguousError: AmbiguousError,
-    AssertionError: AssertionError,
-    AuthError: AuthError,
-    CancelledError: CancelledError,
-    ConflictError: ConflictError,
-    InternalError: InternalError,
-    NetworkError: NetworkError,
-    NotFoundError: NotFoundError,
-    PermissionError: PermissionError,
-    RateLimitError: RateLimitError,
-    TimeoutError: TimeoutError,
-    TrailsError: TrailsError,
-    ValidationError: ValidationError,
-};
-/**
- * Resolve an error class name string to the actual constructor.
- * Falls back to generic Error if the name is not in the core taxonomy.
- */
-const resolveErrorClass = (name) => ERROR_MAP[name] ?? Error;
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-const assertProgressiveMatch = (result, example, output) => {
-    if (example.expected !== undefined) {
-        assertFullMatch(result, example.expected);
-        return;
-    }
-    if (example.error !== undefined) {
-        const errorClass = resolveErrorClass(example.error);
-        assertErrorMatch(result, errorClass);
-        return;
-    }
-    assertSchemaMatch(result, output);
-};
-/**
- * Handle input validation failure for an example.
- * Returns true if the validation error was expected (and assertions passed).
- * Throws if the validation error was unexpected.
- */
-const handleValidationError = (validated, example) => {
-    if (!validated.isErr()) {
-        return false;
-    }
-    if (example.error !== undefined) {
-        const errorClass = resolveErrorClass(example.error);
-        expect(validated.error).toBeInstanceOf(errorClass);
-        return true;
-    }
-    throw new Error(`Example "${example.name}" has invalid input: ${validated.error.message}`);
-};
-/**
- * Apply auto-minting: if the trail declares scoped permits and the context
- * doesn't already have a permit, mint one and merge it into the context.
- */
-const applyAutoMint = (ctx, trailDef, opts) => {
-    if (opts.strictPermits) {
-        return ctx;
-    }
-    if (ctx.permit !== undefined) {
-        return ctx;
-    }
-    const mint = opts.mintPermit ?? defaultMintPermit;
-    const permit = mint(trailDef);
-    if (!permit) {
-        return ctx;
-    }
-    return { ...ctx, permit };
-};
-/**
- * Run a single example against a trail.
- * Handles validation, execution, and assertions.
- */
-const runExample = async (t, example, output, testCtx, provisions, opts) => {
-    const validated = validateInput(t.input, example.input);
-    if (handleValidationError(validated, example)) {
-        return;
-    }
-    const ctx = opts ? applyAutoMint(testCtx, t, opts) : testCtx;
-    const result = await executeTrail(t, example.input, {
-        ctx,
-        provisions: provisions ?? opts?.provisions,
-    });
-    assertProgressiveMatch(result, example, output);
-};
-// ---------------------------------------------------------------------------
-// Crossing coverage for trails with crossings
-// ---------------------------------------------------------------------------
-/**
- * Build a recording cross function that tracks which trail IDs are called.
- *
- * Delegates to `baseCross` when available, otherwise looks up the trail
- * in the topo and executes it with validated input. Falls back to
- * `Result.ok()` when neither is available.
- */
-const createCoverageCross = (called, baseCross, topo, ctx, provisions) => {
-    const cross = (id, input) => {
-        called.add(id);
-        if (baseCross !== undefined) {
-            return baseCross(id, input);
-        }
-        const trailDef = topo.get(id);
-        if (trailDef !== undefined) {
-            return executeTrail(trailDef, input, {
-                ctx: { ...ctx, cross },
-                provisions,
-            });
-        }
-        return Promise.resolve(Result.ok());
-    };
-    return cross;
-};
-/**
- * Run a single example against a trail with crossings, recording cross calls.
- */
-const runCompositionExample = async (trailDef, example, output, baseCtx, called, topo, provisions, opts) => {
-    const validated = validateInput(trailDef.input, example.input);
-    if (handleValidationError(validated, example)) {
-        return;
-    }
-    const mintedCtx = opts ? applyAutoMint(baseCtx, trailDef, opts) : baseCtx;
-    const cross = createCoverageCross(called, mintedCtx.cross, topo, mintedCtx, provisions);
-    const testCtx = { ...mintedCtx, cross };
-    const result = await executeTrail(trailDef, example.input, {
-        ctx: testCtx,
-        provisions: provisions ?? opts?.provisions,
-    });
-    assertProgressiveMatch(result, example, output);
-};
-// ---------------------------------------------------------------------------
-// testExamples
-// ---------------------------------------------------------------------------
-/**
- * Generate describe/test blocks for every trail example in the app.
- *
- * For trails with `crosses` declarations and examples, also verifies that
- * every declared crossed ID was called at least once across all examples.
- *
- * One line in your test file:
- * ```ts
- * testExamples(app);
- * ```
- */
-export const testExamples = (app, ctxOrFactory) => {
-    const resolveInput = typeof ctxOrFactory === 'function' ? ctxOrFactory : () => ctxOrFactory;
-    const allTrails = app.list();
-    const withExamples = allTrails.filter((t) => t.examples !== undefined && t.examples.length > 0);
-    const simpleTrails = withExamples.filter((t) => t.crosses.length === 0);
-    const compositionTrails = withExamples.filter((t) => t.crosses.length > 0);
-    // Simple trails: run examples directly
-    if (simpleTrails.length > 0) {
-        describe.each(simpleTrails)('$id', (t) => {
-            const { examples, output } = t;
-            if (!examples) {
-                return;
-            }
-            test.each([...examples])('example: $name', async (example) => {
-                const resolved = normalizeTestExecutionOptions(resolveInput());
-                const provisions = mergeProvisionOverrides(await resolveMockProvisions(app), resolved.ctx, resolved.provisions);
-                const testCtx = mergeTestContext(resolved.ctx);
-                await runExample(t, example, output, testCtx, provisions, resolved);
-            });
-        });
-    }
-    // Composition trails: use recording cross and check coverage
-    if (compositionTrails.length > 0) {
-        describe.each(compositionTrails)('$id', (t) => {
-            const { examples, output } = t;
-            if (!examples) {
-                return;
-            }
-            const called = new Set();
-            test.each([...examples])('example: $name', async (example) => {
-                const resolved = normalizeTestExecutionOptions(resolveInput());
-                const provisions = mergeProvisionOverrides(await resolveMockProvisions(app), resolved.ctx, resolved.provisions);
-                const baseCtx = mergeTestContext(resolved.ctx);
-                await runCompositionExample(t, example, output, baseCtx, called, app, provisions, resolved);
-            });
-            test('crossing coverage', () => {
-                const uncovered = t.crosses.filter((id) => !called.has(id));
-                expect(uncovered).toEqual([]);
-            });
-        });
-    }
-};
-//# sourceMappingURL=examples.js.map

package/dist/examples.js.map

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

package/dist/follows.d.ts

@@ -1,38 +0,0 @@
-/**
- * testFollows — composition-aware scenario testing for trails with follow.
- *
- * Tests the follow graph: which trails were followed, in what order,
- * and supports failure injection from followed trail examples.
- */
-import type { AnyTrail, ServiceOverrideMap, TrailContext } from '@ontrails/core';
-import type { FollowScenario } from './types.js';
-/** Options for testFollows that provide trail definitions for injection. */
-export interface TestFollowOptions {
-    /** Partial context overrides. */
-    readonly ctx?: Partial<TrailContext> | undefined;
-    /**
-     * Explicit service overrides merged on top of auto-resolved mocks for every
-     * scenario. Values are passed by reference — provide immutable objects, or
-     * use `mock()` on the service definition to get a fresh instance per run.
-     */
-    readonly services?: ServiceOverrideMap | undefined;
-    /** Map of trail ID to trail definition, used for injectFromExample. */
-    readonly trails?: ReadonlyMap<string, AnyTrail> | undefined;
-}
-/**
- * Generate a describe block for a composition trail with one test per scenario.
- *
- * @example
- * ```ts
- * testFollows(onboardTrail, [
- *   {
- *     description: "follows add then relate",
- *     input: { name: "Alpha" },
- *     expectOk: true,
- *     expectFollowed: ["entity.add", "entity.relate"],
- *   },
- * ]);
- * ```
- */
-export declare const testFollows: (trailDef: AnyTrail, scenarios: readonly FollowScenario[], options?: TestFollowOptions) => void;
-//# sourceMappingURL=follows.d.ts.map

package/dist/follows.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"follows.d.ts","sourceRoot":"","sources":["../src/follows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,QAAQ,EAER,kBAAkB,EAClB,YAAY,EACb,MAAM,gBAAgB,CAAC;AAexB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuSjD,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;CAC7D;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,QAAQ,EAClB,WAAW,SAAS,cAAc,EAAE,EACpC,UAAU,iBAAiB,KAC1B,IAoBF,CAAC"}