@c9up/helix 0.1.8 → 0.1.10

package/dist/runtime/suite-taps.js

@@ -0,0 +1,218 @@
+/**
+ * `suite.onTest()` / `suite.onGroup()` — the taps Japa's `Suite` exposes to
+ * `configureSuite`, so a bootstrap can configure every test or group of a suite
+ * without touching the test files.
+ *
+ *     export const configureSuite = (suite) => {
+ *       if (suite.name === "e2e") suite.onTest((test) => test.timeout(30_000))
+ *     }
+ *
+ * `configureSuite` runs before the test file is imported, so the callbacks are
+ * stored and applied to the collected tree just before execution — the same
+ * point at which Japa's taps fire (each test, once, before it runs).
+ *
+ * Each method maps onto a field the collection tree already carries; nothing
+ * here is a facade over behaviour helix does not have. Japa `Test` members that
+ * belong to EXECUTION rather than configuration — `run`, `exec`, `context`,
+ * `executed`, `failed`, `options` — are absent: helix owns execution, and a
+ * handle that pretended otherwise would be lying about what a callback can do.
+ */
+export function testHandle(node) {
+    const handle = {
+        get title() {
+            return node.name;
+        },
+        skip(skip = true, reason) {
+            if (typeof skip === "function")
+                node.skipCondition = skip;
+            else
+                node.mode = skip ? "skip" : "run";
+            if (reason !== undefined)
+                node.reason = reason;
+            return handle;
+        },
+        fails(reason) {
+            node.failing = true;
+            if (reason !== undefined)
+                node.reason = reason;
+            return handle;
+        },
+        timeout(ms) {
+            node.timeoutMs = ms;
+            return handle;
+        },
+        disableTimeout() {
+            node.timeoutMs = 0;
+            return handle;
+        },
+        resetTimeout(ms) {
+            node.timeoutMs = ms ?? 0;
+            return handle;
+        },
+        tags(tags, strategy = "replace") {
+            const current = node.tags ?? [];
+            node.tags =
+                strategy === "append"
+                    ? [...current, ...tags]
+                    : strategy === "prepend"
+                        ? [...tags, ...current]
+                        : [...tags];
+            return handle;
+        },
+        retry(retries) {
+            node.retries = retries;
+            return handle;
+        },
+        waitForDone() {
+            node.waitForDone = true;
+            return handle;
+        },
+        pin() {
+            node.pinned = true;
+            return handle;
+        },
+        setup(fn) {
+            node.setups ??= [];
+            node.setups.push(fn);
+            return handle;
+        },
+        teardown(fn) {
+            node.teardowns ??= [];
+            node.teardowns.push(fn);
+            return handle;
+        },
+    };
+    return handle;
+}
+export function groupHandle(node) {
+    const handle = {
+        get title() {
+            return node.name;
+        },
+        tap(callback) {
+            for (const child of node.children) {
+                if (child.kind === "test")
+                    callback(testHandle(child));
+            }
+            return handle;
+        },
+        setup(fn) {
+            node.hooks.push({ type: "beforeAll", fn });
+            return handle;
+        },
+        teardown(fn) {
+            node.hooks.push({ type: "afterAll", fn });
+            return handle;
+        },
+        each: {
+            setup(fn) {
+                node.hooks.push({ type: "beforeEach", fn });
+            },
+            teardown(fn) {
+                node.hooks.push({ type: "afterEach", fn });
+            },
+            timeout(ms) {
+                node.eachTimeout = ms;
+            },
+            retry(retries) {
+                node.eachRetries = retries;
+            },
+        },
+    };
+    return handle;
+}
+/**
+ * A handle whose `setup`/`teardown` append to the given arrays — the caller
+ * owns when those hooks run, so the same handle serves the bootstrap's
+ * `configureSuite` and a plugin's `runner.onSuite`.
+ */
+export function makeSuiteHandle(name, setup, teardown) {
+    const handle = {
+        name,
+        setup(fn) {
+            setup.push(fn);
+            return handle;
+        },
+        teardown(fn) {
+            teardown.push(fn);
+            return handle;
+        },
+        onTest(callback) {
+            registerTestTap(callback);
+            return handle;
+        },
+        onGroup(callback) {
+            registerGroupTap(callback);
+            return handle;
+        },
+        bail(toggle = true) {
+            setBail(toggle);
+            return handle;
+        },
+    };
+    return handle;
+}
+/**
+ * The suite the current `configure()` call is running for. Set before plugins
+ * run so `runner.onSuite` has something to hand back — a worker runs exactly
+ * one suite, so Japa's "called once per suite" is "called once".
+ */
+let current;
+export function setCurrentSuite(handle) {
+    current = handle;
+}
+export function currentSuite() {
+    return current;
+}
+/**
+ * Callbacks registered before the file is imported (`configureSuite`, and a
+ * plugin reaching for `runner.bail`), applied once the tree exists. Process-wide,
+ * like the rest of the bootstrap state.
+ */
+const taps = { onTest: [], onGroup: [] };
+/** Register a per-test tap (Japa `Suite#onTest`). */
+export function registerTestTap(callback) {
+    taps.onTest.push(callback);
+}
+/** Register a per-group tap (Japa `Suite#onGroup`). */
+export function registerGroupTap(callback) {
+    taps.onGroup.push(callback);
+}
+/** Ask this suite to stop at the first failure (Japa `Suite#bail`). */
+export function setBail(toggle) {
+    taps.bail = toggle;
+}
+/** Whether a tap asked for bail; `undefined` leaves the CLI flag in charge. */
+export function tappedBail() {
+    return taps.bail;
+}
+/** Test seam: drop every registered tap. */
+export function resetTaps() {
+    taps.onTest.length = 0;
+    taps.onGroup.length = 0;
+    taps.bail = undefined;
+    current = undefined;
+}
+/**
+ * Walk the collected tree, handing every test to the `onTest` taps and every
+ * group to the `onGroup` ones. Depth-first in declaration order, so a tap sees
+ * the tests in the order they will run.
+ */
+export function applyTaps(root) {
+    if (taps.onTest.length === 0 && taps.onGroup.length === 0)
+        return;
+    const walk = (node) => {
+        for (const child of node.children) {
+            if (child.kind === "test") {
+                for (const callback of taps.onTest)
+                    callback(testHandle(child));
+                continue;
+            }
+            for (const callback of taps.onGroup)
+                callback(groupHandle(child));
+            walk(child);
+        }
+    };
+    walk(root);
+}
+//# sourceMappingURL=suite-taps.js.map

package/dist/runtime/suite-taps.js.map

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

package/dist/runtime/suite.d.ts

@@ -7,12 +7,32 @@
  * invocations never share state.
  */
 import { AsyncLocalStorage } from "node:async_hooks";
-export type TestFn = () => void | Promise<void>;
+import type { TestContext } from "./context.js";
+import { type TestCleanup } from "./test-context.js";
+/**
+ * Signals completion of a `waitForDone()` test. Call `done()` to pass, or
+ * `done(error)` to fail (Japa parity). Ignored unless `test.waitForDone()`.
+ */
+export type DoneFn = (error?: unknown) => void;
+/**
+ * A test body. Receives the injected {@link TestContext} as its first argument
+ * and a `done` callback as its second (Japa parity). Existing zero/one-argument
+ * bodies stay valid — they simply ignore the extra parameters.
+ */
+export type TestFn = (ctx: TestContext, done: DoneFn) => void | Promise<void>;
 export type SuiteFn = () => void;
-/** Teardown function a hook may return (Vitest/Japa parity). */
-export type CleanupFn = () => void | Promise<void>;
-/** A lifecycle hook: may return nothing or a cleanup function. */
-export type HookFn = () => void | CleanupFn | Promise<void | CleanupFn>;
+/**
+ * Teardown a hook may return (Vitest/Japa parity). Receives `(hasError, subject)`
+ * — whether the test/group errored, and the Test or Group instance. Both params
+ * are optional so plain `() => …` cleanups stay valid.
+ */
+export type CleanupFn = (hasError?: boolean, subject?: TestInstance | GroupInstance) => void | Promise<void>;
+/**
+ * A lifecycle hook. Receives the Test instance (test hooks) or Group instance
+ * (group hooks) as its argument (Japa parity); may return a {@link CleanupFn}.
+ * Existing zero-argument hooks stay valid.
+ */
+export type HookFn = ((subject?: TestInstance | GroupInstance) => void | Promise<void>) | ((subject?: TestInstance | GroupInstance) => CleanupFn | Promise<CleanupFn>);
 export type HookType = "beforeAll" | "afterAll" | "beforeEach" | "afterEach";
 export interface Hook {
     type: HookType;
@@ -34,6 +54,98 @@ export interface TestNode {
     tags?: string[];
     /** When `true`, the test is expected to throw — `test.fails()`. */
     failing?: boolean;
+    /** Reason attached to `test.fails(reason)` / `test.skip(cond, reason)`. */
+    reason?: string;
+    /** Marked via `test.pin()` — reported as pinned; runs like `.only`. */
+    pinned?: boolean;
+    /** Per-test setup hooks — `test.setup(fn)` (run just before this test). */
+    setups?: HookFn[];
+    /** Per-test teardown hooks — `test.teardown(fn)` (run just after this test). */
+    teardowns?: HookFn[];
+    /** Resolved dataset rows backing this test — `test(name, fn).with(rows)` (Japa `ctx.test.dataset`). */
+    dataset?: readonly unknown[];
+    /**
+     * Deferred dataset source — `test(name, fn).with(rows)`. An array OR a
+     * (possibly async) function returning one (Japa parity). Resolved at RUN time
+     * so async datasets work; the node then expands into one result per row.
+     */
+    datasetFn?: DatasetSource<unknown>;
+    /**
+     * The dataset test body — receives `(ctx, row)`. Set by `.with().run()` or
+     * re-homed from `test(name, fn).with()`. Declared as a METHOD signature so its
+     * `row` param is bivariant: a caller's `(ctx, row: Row) => …` assigns here
+     * without a cast (the type-erasure boundary between the generic `.with<Row>`
+     * surface and this untyped node storage).
+     */
+    datasetBody?(ctx: TestContext, row: unknown): void | Promise<void>;
+    /** Wait for the `done()` callback before completing — `test.waitForDone()`. */
+    waitForDone?: boolean;
+    /**
+     * Deferred skip condition — `test.skip(fn)` where `fn` may be async (Japa
+     * parity). Evaluated at RUN time. A static boolean sets `mode` at collection
+     * instead, so this only ever holds a function.
+     */
+    skipCondition?: () => boolean | Promise<boolean>;
+}
+/** A group's instance, passed to `group.setup`/`teardown` hooks (Japa parity). */
+export interface GroupInstance {
+    /** The group's own name. */
+    title: string;
+    /** Fully-qualified dotted name (suite path). */
+    fullName: string;
+}
+/**
+ * The running test's own instance, injected as `ctx.test` (Japa parity). Read
+ * access to the test's identity + resolved options + dataset.
+ */
+export interface TestInstance {
+    /** The test's own name (leaf). */
+    title: string;
+    /** Fully-qualified dotted name (suite path + title). */
+    fullName: string;
+    /** Resolved options in effect for this run (Japa `test.options` parity). */
+    options: {
+        /** The test's title (leaf name). */
+        title: string;
+        timeout: number;
+        retries: number;
+        tags: readonly string[];
+        /** Whether this is a `todo` test. Always `false` inside a running test. */
+        isTodo: boolean;
+        /** Whether the test is expected to throw — `test.fails()` (Japa parity). */
+        isFailing: boolean;
+        /**
+         * Free-form metadata bag (Japa `options.meta`): `fileName`, `group` (the
+         * enclosing {@link Group} instance, or `undefined` outside a group),
+         * `suite` (`{ name }` — `"default"` unless `configure({ suite })` or
+         * `--suite` names it, exactly like Japa's implicit suite), and `abort`.
+         */
+        meta: Record<string, unknown>;
+    };
+    /** The full dataset when created via `test(name, fn).with(rows)`, else undefined. */
+    dataset?: readonly unknown[];
+    /**
+     * The injected {@link TestContext} for this run — Japa's `$test.context`. Set
+     * before the `beforeEach` chain, so lifecycle hooks can reach it; the same
+     * context is passed to the test body as its first argument. Undefined only
+     * outside an active run.
+     */
+    context?: TestContext;
+    /** Whether the test was pinned via `test.pin()`. */
+    isPinned: boolean;
+    /**
+     * Re-arm the running test's timeout (Japa `ctx.test.resetTimeout`). With no
+     * argument, restarts the current timeout; with `ms`, sets a new one. Useful
+     * for long polling steps that shouldn't count against a single deadline.
+     */
+    resetTimeout(ms?: number): void;
+    /**
+     * Register a teardown that runs at the end of THIS test regardless of outcome
+     * (Japa `test.cleanup`). This is the same registry as `ctx.cleanup`; it is
+     * exposed here so a resource macro's `t` (see `test.macro`) can register
+     * cleanups — `test.macro((t) => { t.cleanup(() => …) })`.
+     */
+    cleanup(fn: TestCleanup): void;
 }
 /** Vitest-style per-test options (3rd argument to `test`). */
 export interface TestOptions {
@@ -51,12 +163,57 @@ export interface TestOptions {
  * mutate the just-registered node. Ignoring the return keeps Vitest's
  * `test(name, fn)` ergonomics; chaining adds `@japa/runner` parity.
  */
+/** How `tags()` merges with any tags already on the test (Japa parity). */
+export type TagStrategy = "replace" | "append" | "prepend";
 export interface TestHandle {
     retry(n: number): TestHandle;
     timeout(ms: number): TestHandle;
     disableTimeout(): TestHandle;
-    tags(...tags: string[]): TestHandle;
-    fails(): TestHandle;
+    /**
+     * Attach tags. Japa parity: `tags(['@slow'], 'append')`. `strategy` defaults
+     * to `'replace'`. A single string is accepted as a shorthand.
+     */
+    tags(tags: string | string[], strategy?: TagStrategy): TestHandle;
+    /** Expect the test to throw. Optional `reason` documents why (Japa parity). */
+    fails(reason?: string): TestHandle;
+    /** Run a hook just before THIS test (Japa `test.setup`). */
+    setup(fn: HookFn): TestHandle;
+    /** Run a hook just after THIS test (Japa `test.teardown`). */
+    teardown(fn: HookFn): TestHandle;
+    /** Pin the test: when any test is pinned, only pinned tests run (Japa `test.pin`). */
+    pin(): TestHandle;
+    /**
+     * Skip the test, optionally only when `condition` (a boolean OR a function
+     * returning one — which may be async, Japa parity) is true, with a `reason`.
+     * A function condition is evaluated at RUN time, not at collection.
+     */
+    skip(condition?: boolean | (() => boolean | Promise<boolean>), reason?: string): TestHandle;
+    /** Complete only once the body calls its `done` callback (Japa `waitForDone`). */
+    waitForDone(): TestHandle;
+    /**
+     * Attach a dataset (Japa parity). Two forms:
+     *   - `test('title', (ctx, row) => …).with([...])` — the body from `test()`
+     *     is re-homed and runs once per row (row typed as the 2nd body arg).
+     *   - `test('title').with([...]).run((ctx, row) => …)` — the fully-typed
+     *     form; `row` is inferred as the dataset element type.
+     * `rows` may be an array OR a (possibly async) function returning one,
+     * resolved at run time. Title tokens: `{prop}` (object rows), `{$i}`
+     * (1-based index), `{$self}` (the row itself).
+     */
+    with<Row>(rows: DatasetSource<Row>): DatasetHandle<Row>;
+}
+/**
+ * The handle returned by `test(...).with(rows)` — carries the dataset element
+ * type so `.run((ctx, row) => …)` types `row` precisely (Japa parity).
+ */
+export interface DatasetHandle<Row> {
+    /**
+     * Provide the per-row body when `test('title')` had none —
+     * `test('title').with([...]).run((ctx, row) => …)`. Takes only the body (no
+     * name); the name came from `test()`. Returns the base handle for further
+     * chaining.
+     */
+    run(fn: (ctx: TestContext, row: Row) => void | Promise<void>): TestHandle;
 }
 export interface SuiteNode {
     kind: "suite";
@@ -65,6 +222,18 @@ export interface SuiteNode {
     parent: SuiteNode | undefined;
     children: Array<SuiteNode | TestNode>;
     hooks: Hook[];
+    /** Default per-test timeout for tests in this group — `group.each.timeout(ms)`. */
+    eachTimeout?: number;
+    /** Default per-test retries for tests in this group — `group.each.retry(n)`. */
+    eachRetries?: number;
+    /** Opened via `test.group()` (vs `describe`) — Japa forbids nesting these. */
+    isGroup?: boolean;
+    /**
+     * The single {@link Group} instance built by `test.group()` for this node —
+     * the body handle, the value returned, AND the `self` its hooks receive
+     * (Japa `self === group`). Absent on plain `describe` suites.
+     */
+    groupInstance?: Group;
 }
 interface CollectionContext {
     root: SuiteNode;
@@ -109,12 +278,112 @@ type ObjectRow = Readonly<Record<string, unknown>>;
 type EachRow = ArrayRow | ObjectRow | null | undefined | string | number | boolean | bigint | symbol;
 /** Source of `each` rows: a static array or a (sync) function returning one. */
 type EachRows<Row extends EachRow> = readonly Row[] | (() => readonly Row[]);
+/**
+ * Source of dataset rows (`test(name, fn).with(...)`): a static array OR a
+ * function returning one — the function may be async (Japa parity). Resolved at
+ * RUN time so async sources work.
+ */
+export type DatasetSource<Row> = readonly Row[] | (() => readonly Row[] | Promise<readonly Row[]>);
+/**
+ * The `group` handle passed to `test.group(name, (group) => …)` (Japa parity).
+ * `setup`/`teardown` run once for the whole group; `each.setup`/`each.teardown`
+ * run around every test in it. Hook bodies may return a cleanup function.
+ */
+export interface Group extends GroupInstance {
+    /** Run once before all tests in the group (≈ `beforeAll`). */
+    setup(fn: HookFn): void;
+    /** Run once after all tests in the group (≈ `afterAll`). */
+    teardown(fn: HookFn): void;
+    /** Per-test hooks + defaults for this group (≈ `beforeEach`/`afterEach`). */
+    each: {
+        setup(fn: HookFn): void;
+        teardown(fn: HookFn): void;
+        /** Default timeout (ms) for every test in the group — `group.each.timeout(ms)`. */
+        timeout(ms: number): void;
+        /** Disable the timeout for every test in the group. */
+        disableTimeout(): void;
+        /** Default retries for every test in the group — `group.each.retry(n)`. */
+        retry(n: number): void;
+    };
+    /**
+     * Configure every test in the group — `group.tap(t => t.tags('@slow'))` or
+     * `group.tap(t => { t.options.title = t.options.title.toUpperCase() })`.
+     * Applied to all tests registered in the group body. The callback receives a
+     * {@link TapHandle}: the chainable modifiers PLUS a mutable `options` view
+     * (Japa `test.options.title` parity).
+     */
+    tap(fn: (test: TapHandle) => void): void;
+}
+/** The mutable, resolved options of a test, exposed to `group.tap` (Japa parity). */
+export interface TapOptions {
+    /** The test's title — assignable to rename it (Japa `test.options.title`). */
+    title: string;
+    /** The test's tags — assignable to replace them. */
+    tags: string[];
+    /** Per-test timeout in ms (`undefined` = inherit). */
+    timeout: number | undefined;
+    /** Extra attempts on failure (`undefined` = inherit). */
+    retries: number | undefined;
+}
+/**
+ * The handle passed to `group.tap` — a {@link TestHandle} (chainable modifiers)
+ * augmented with a mutable {@link TapOptions} view, matching Japa's `test`
+ * instance whose `options` are directly assignable.
+ */
+export interface TapHandle extends TestHandle {
+    readonly options: TapOptions;
+}
 type TestApi = {
-    (name: string, fn: TestFn, options?: TestOptions | number): TestHandle;
+    /**
+     * Register a test. Omitting `fn` marks it `todo` (Japa parity) — reported as
+     * pending and never executed — unless a dataset body is supplied later via
+     * `.with(...).run(fn)`.
+     */
+    (name: string, fn?: TestFn, options?: TestOptions | number): TestHandle;
     skip(name: string, fn?: TestFn): void;
     only(name: string, fn: TestFn, options?: TestOptions | number): TestHandle;
     todo(name: string): void;
     each<Row extends EachRow>(rows: EachRows<Row>): (name: string, fn: (row: Row) => void | Promise<void>) => void;
+    /**
+     * Japa-style grouping: `test.group(name, (group) => { … })`. Returns the
+     * {@link Group} — the SAME instance passed to the body and to the group's
+     * hooks as `self` (Japa's current release returns the group; `self === group`).
+     */
+    group(name: string, fn: (group: Group) => void): Group;
+    /**
+     * Create a resource macro (Japa `test.macro`). The callback receives the
+     * running test instance `t` (carrying `t.cleanup`) followed by any arguments;
+     * `macro` returns a function that, called inside a test body, invokes the
+     * callback against the active test and returns its value:
+     *
+     *     const useFile = test.macro((t, path: string) => {
+     *       t.cleanup(() => rm(path))
+     *       return writeFile(path, '…')
+     *     })
+     *     // inside a test: await useFile('tmp/a.txt')
+     *
+     * To add a chainable method to every handle instead, use {@link Test.macro}.
+     */
+    macro<Args extends unknown[], R>(callback: (test: TestInstance, ...args: Args) => R): (...args: Args) => R;
+};
+/**
+ * Interpolate a dataset test title (Japa parity). Tokens:
+ *   - `{$i}`   → the 1-based row index
+ *   - `{$self}`→ the row itself (stringified) — for primitive/array rows
+ *   - `{prop}` / `{a.b}` → a (dotted) property lookup on an object row
+ * Unknown `{tokens}` are left verbatim. A template with no token at all is
+ * returned unchanged and therefore repeats for every row — Japa's behaviour,
+ * and what the golden dataset spec pins down.
+ */
+export declare function interpolateDatasetTitle(template: string, row: unknown, index: number): string;
+/**
+ * Class-level extension surface (Japa `Test.macro`). Registers a named method
+ * available on every test handle; `this` inside it is the handle, so it can
+ * chain (`Test.macro('slow', function () { this.tags(['@slow']); return this })`).
+ * Pair with a `declare module` augmentation for the types.
+ */
+export declare const Test: {
+    macro(name: string, fn: (this: TestHandle, ...args: unknown[]) => unknown): void;
 };
 export declare const describe: SuiteApi;
 export declare const test: TestApi;

package/dist/runtime/suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../src/runtime/suite.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../src/runtime/suite.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9E,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;AAEjC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CACvB,QAAQ,CAAC,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,YAAY,GAAG,aAAa,KAClC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1B;;;;GAIG;AACH,MAAM,MAAM,MAAM,GACf,CAAC,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAClE,CAAC,CACD,OAAO,CAAC,EAAE,YAAY,GAAG,aAAa,KACjC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAExC,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAE7E,MAAM,WAAW,IAAI;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,uGAAuG;IACvG,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC7B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,OAAO,EAAE;QACR,oCAAoC;QACpC,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACxB,2EAA2E;QAC3E,MAAM,EAAE,OAAO,CAAC;QAChB,4EAA4E;QAC5E,SAAS,EAAE,OAAO,CAAC;QACnB;;;;;WAKG;QACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9B,CAAC;IACF,qFAAqF;IACrF,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;CAC/B;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC3B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,UAAU;IAC1B,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC;IAChC,cAAc,IAAI,UAAU,CAAC;IAC7B;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAClE,+EAA+E;IAC/E,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,sFAAsF;IACtF,GAAG,IAAI,UAAU,CAAC;IAClB;;;;OAIG;IACH,IAAI,CACH,SAAS,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,EACxD,MAAM,CAAC,EAAE,MAAM,GACb,UAAU,CAAC;IACd,kFAAkF;IAClF,WAAW,IAAI,UAAU,CAAC;IAC1B;;;;;;;;;OASG;IACH,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,GAAG;IACjC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC;CAC1E;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC;IACtC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;CACtB;AAED,UAAU,iBAAiB;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;CACnB;AAiBD;;;;;;;;;;;;GAYG;AACH,UAAU,kBAAkB;IAC3B,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAC9C,YAAY,EAAE,SAAS,CAAC;IACxB,aAAa,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,OAAO,CAAC,MAAM,CAAC;IAEd,IAAI,yBAAyB,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC9D;AAuBD,wBAAgB,SAAS,IAAI,SAAS,CAKrC;AAED,wBAAgB,OAAO,IAAI,SAAS,CAEnC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC9B,OAAO,CAAC,SAAS,CAAC,CAOpB;AAmND,KAAK,QAAQ,GAAG;IACf,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,KAAK,QAAQ,GAAG,SAAS,OAAO,EAAE,CAAC;AACnC,KAAK,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACnD,KAAK,OAAO,GACT,QAAQ,GACR,SAAS,GACT,IAAI,GACJ,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,CAAC;AAEV,gFAAgF;AAChF,KAAK,QAAQ,CAAC,GAAG,SAAS,OAAO,IAAI,SAAS,GAAG,EAAE,GAAG,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,GAAG,IAC1B,SAAS,GAAG,EAAE,GACd,CAAC,MAAM,SAAS,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,KAAM,SAAQ,aAAa;IAC3C,8DAA8D;IAC9D,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,IAAI,EAAE;QACL,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,mFAAmF;QACnF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,uDAAuD;QACvD,cAAc,IAAI,IAAI,CAAC;QACvB,2EAA2E;QAC3E,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC;CACzC;AAED,qFAAqF;AACrF,MAAM,WAAW,UAAU;IAC1B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sDAAsD;IACtD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC5C,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC7B;AAED,KAAK,OAAO,GAAG;IACd;;;;OAIG;IACH,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;IACxE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;IAC3E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,GAAG,SAAS,OAAO,EACvB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,GACjB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAClE;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,KAAK,CAAC;IACvD;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GAChD,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC;CACxB,CAAC;AAoGF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,MAAM,GACX,MAAM,CA2BR;AAsHD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,EAAE;IAClB,KAAK,CACJ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACnD,IAAI,CAAC;CAKR,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,QAAqB,CAAC;AAC7C,eAAO,MAAM,IAAI,EAAE,OAAgB,CAAC;AACpC,eAAO,MAAM,EAAE,EAAE,OAAgB,CAAC;AAElC,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,IAAgC,CAAC;AACxE,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,KAAG,IAA+B,CAAC;AACtE,eAAO,MAAM,UAAU,GAAI,IAAI,MAAM,KAAG,IAAiC,CAAC;AAC1E,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,IAAgC,CAAC"}