devharness 0.8.0

package/build/utils/abort.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Abort utilities (#110) - the shared vocabulary for cancellation.
+ *
+ * Handlers that observe an AbortSignal THROW an abort-shaped error (never
+ * return an isError response); callers classify with isAbortError. linkSignals
+ * is hand-rolled instead of AbortSignal.any because (a) `engines` allows Node
+ * >=18.0.0 and AbortSignal.any needs 18.17/20.3, and (b) AbortSignal.any can
+ * never detach its listeners - this code links against a long-lived run
+ * signal once per step, so dispose() in a `finally` is mandatory to keep a
+ * 500-step run from accumulating hundreds of dead listeners.
+ */
+/** Error thrown when an operation is cancelled via an AbortSignal. */
+export declare class AbortError extends Error {
+    readonly reason?: unknown | undefined;
+    readonly code = "ABORTED";
+    constructor(message?: string, reason?: unknown | undefined);
+}
+/**
+ * Whether an error means "cancelled" rather than "failed".
+ *
+ * Matches by name, not instanceof, because aborts arrive in several shapes:
+ * our own AbortError class, the DOMException fetch throws (NOT instanceof
+ * Error in every runtime), and whatever `signal.throwIfAborted()` rethrows
+ * (the signal's reason - a DOMException by default, anything the aborter
+ * passed otherwise). Getting this wrong turns a user's cancel into a
+ * "genuine failure" with diagnostics gathered against a browser they just
+ * tore down.
+ */
+export declare function isAbortError(err: unknown): boolean;
+/** The abort-shaped error to raise for `signal`: its reason when the reason
+ *  is itself abort-shaped, a fresh AbortError wrapping it otherwise. */
+export declare function abortErrorFor(signal: AbortSignal): Error;
+/** Throw the abort-shaped error for `signal` if it has already aborted. */
+export declare function throwIfAborted(signal?: AbortSignal): void;
+export interface LinkedSignal {
+    signal: AbortSignal;
+    /** Detach every listener this link attached to its input signals. MUST be
+     *  called (in a `finally`) once the linked operation settles - the inputs
+     *  may be long-lived run signals that outlive the operation by minutes. */
+    dispose(): void;
+}
+/**
+ * Combine signals: the returned signal aborts as soon as ANY input does
+ * (immediately, if one already has), carrying that input's reason.
+ * Undefined inputs are skipped so optional signals compose without ceremony.
+ */
+export declare function linkSignals(...signals: Array<AbortSignal | undefined>): LinkedSignal;
+/**
+ * Sleep that REJECTS (with an abort-shaped error) when `signal` aborts.
+ * Listener and timer are cleaned up on every path.
+ */
+export declare function abortableSleep(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Await `promise` unless `signal` aborts first, in which case REJECT with an
+ * abort-shaped error and stop waiting. The underlying work is NOT cancelled -
+ * this is "stop waiting", for operations with no cancellation API (a page
+ * navigation already handed to the browser). On abort the orphaned promise
+ * gets a no-op catch so its eventual rejection never surfaces as unhandled.
+ * The listener is detached on every path.
+ */
+export declare function raceAbort<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T>;
+/**
+ * Non-throwing sleep variant preserving the replay executor's shape: resolves
+ * `true` if the signal aborted before the delay elapsed, `false` otherwise.
+ * Unlike the bespoke helper it replaces, cleanup leaves no extra timer alive.
+ */
+export declare function abortableDelayResult(ms: number, signal?: AbortSignal): Promise<boolean>;
+//# sourceMappingURL=abort.d.ts.map

package/build/utils/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/utils/abort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,sEAAsE;AACtE,qBAAa,UAAW,SAAQ,KAAK;aAEwB,MAAM,CAAC,EAAE,OAAO;IAD3E,QAAQ,CAAC,IAAI,aAAa;gBACd,OAAO,SAAsB,EAAkB,MAAM,CAAC,EAAE,OAAO,YAAA;CAI5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMlD;AAED;wEACwE;AACxE,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAIxD;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAEzD;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB;;+EAE2E;IAC3E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,YAAY,CAiCpF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB9E;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAuBlF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBvF"}

package/build/utils/abort.js

@@ -0,0 +1,159 @@
+/**
+ * Abort utilities (#110) - the shared vocabulary for cancellation.
+ *
+ * Handlers that observe an AbortSignal THROW an abort-shaped error (never
+ * return an isError response); callers classify with isAbortError. linkSignals
+ * is hand-rolled instead of AbortSignal.any because (a) `engines` allows Node
+ * >=18.0.0 and AbortSignal.any needs 18.17/20.3, and (b) AbortSignal.any can
+ * never detach its listeners - this code links against a long-lived run
+ * signal once per step, so dispose() in a `finally` is mandatory to keep a
+ * 500-step run from accumulating hundreds of dead listeners.
+ */
+/** Error thrown when an operation is cancelled via an AbortSignal. */
+export class AbortError extends Error {
+    reason;
+    code = 'ABORTED';
+    constructor(message = 'Operation aborted', reason) {
+        super(message);
+        this.reason = reason;
+        this.name = 'AbortError';
+    }
+}
+/**
+ * Whether an error means "cancelled" rather than "failed".
+ *
+ * Matches by name, not instanceof, because aborts arrive in several shapes:
+ * our own AbortError class, the DOMException fetch throws (NOT instanceof
+ * Error in every runtime), and whatever `signal.throwIfAborted()` rethrows
+ * (the signal's reason - a DOMException by default, anything the aborter
+ * passed otherwise). Getting this wrong turns a user's cancel into a
+ * "genuine failure" with diagnostics gathered against a browser they just
+ * tore down.
+ */
+export function isAbortError(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        err.name === 'AbortError');
+}
+/** The abort-shaped error to raise for `signal`: its reason when the reason
+ *  is itself abort-shaped, a fresh AbortError wrapping it otherwise. */
+export function abortErrorFor(signal) {
+    const reason = signal.reason;
+    if (isAbortError(reason))
+        return reason;
+    return new AbortError('Operation aborted', reason);
+}
+/** Throw the abort-shaped error for `signal` if it has already aborted. */
+export function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw abortErrorFor(signal);
+}
+/**
+ * Combine signals: the returned signal aborts as soon as ANY input does
+ * (immediately, if one already has), carrying that input's reason.
+ * Undefined inputs are skipped so optional signals compose without ceremony.
+ */
+export function linkSignals(...signals) {
+    const controller = new AbortController();
+    const inputs = signals.filter((s) => s !== undefined);
+    const attached = [];
+    const dispose = () => {
+        for (const { signal, onAbort } of attached) {
+            signal.removeEventListener('abort', onAbort);
+        }
+        attached.length = 0;
+    };
+    const forward = (source) => {
+        if (!controller.signal.aborted) {
+            controller.abort(source.reason ?? new AbortError());
+        }
+        // Once aborted the link is settled - the other inputs no longer matter.
+        dispose();
+    };
+    for (const input of inputs) {
+        if (input.aborted) {
+            forward(input);
+            return { signal: controller.signal, dispose };
+        }
+    }
+    for (const input of inputs) {
+        const onAbort = () => forward(input);
+        input.addEventListener('abort', onAbort, { once: true });
+        attached.push({ signal: input, onAbort });
+    }
+    return { signal: controller.signal, dispose };
+}
+/**
+ * Sleep that REJECTS (with an abort-shaped error) when `signal` aborts.
+ * Listener and timer are cleaned up on every path.
+ */
+export function abortableSleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(abortErrorFor(signal));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortErrorFor(signal));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Await `promise` unless `signal` aborts first, in which case REJECT with an
+ * abort-shaped error and stop waiting. The underlying work is NOT cancelled -
+ * this is "stop waiting", for operations with no cancellation API (a page
+ * navigation already handed to the browser). On abort the orphaned promise
+ * gets a no-op catch so its eventual rejection never surfaces as unhandled.
+ * The listener is detached on every path.
+ */
+export function raceAbort(promise, signal) {
+    if (!signal)
+        return promise;
+    if (signal.aborted) {
+        promise.catch(() => { });
+        return Promise.reject(abortErrorFor(signal));
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            promise.catch(() => { });
+            reject(abortErrorFor(signal));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        promise.then((value) => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, (err) => {
+            signal.removeEventListener('abort', onAbort);
+            reject(err);
+        });
+    });
+}
+/**
+ * Non-throwing sleep variant preserving the replay executor's shape: resolves
+ * `true` if the signal aborted before the delay elapsed, `false` otherwise.
+ * Unlike the bespoke helper it replaces, cleanup leaves no extra timer alive.
+ */
+export function abortableDelayResult(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve(true);
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve(true);
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve(false);
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=abort.js.map

package/build/utils/abort.js.map

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

package/build/utils/abort.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=abort.test.d.ts.map

package/build/utils/abort.test.d.ts.map

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

package/build/utils/abort.test.js

@@ -0,0 +1,174 @@
+// @vitest-environment node
+// (node, not happy-dom: events.getEventListeners only accepts Node's own
+// EventTarget, and these tests assert listener hygiene on real AbortSignals)
+/**
+ * Abort utilities (#110): linkSignals lifecycle/hygiene, abort-shape
+ * classification (including the DOMException fetch throws), and both sleep
+ * variants' cleanup behaviour.
+ */
+import { describe, it, expect } from 'vitest';
+import { getEventListeners } from 'node:events';
+import { AbortError, isAbortError, abortErrorFor, throwIfAborted, linkSignals, abortableSleep, abortableDelayResult, } from './abort.js';
+const listenerCount = (signal) => getEventListeners(signal, 'abort').length;
+describe('isAbortError', () => {
+    it('matches our AbortError class', () => {
+        expect(isAbortError(new AbortError())).toBe(true);
+    });
+    it('matches the DOMException a real fetch abort produces', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        // An already-aborted signal rejects before any connection is attempted.
+        const err = await fetch('http://127.0.0.1:1/', { signal: controller.signal })
+            .then(() => null, (e) => e);
+        expect(err).not.toBeNull();
+        expect(isAbortError(err)).toBe(true);
+    });
+    it('matches what signal.throwIfAborted() throws (the default abort reason)', () => {
+        const controller = new AbortController();
+        controller.abort();
+        let thrown;
+        try {
+            controller.signal.throwIfAborted();
+        }
+        catch (e) {
+            thrown = e;
+        }
+        expect(isAbortError(thrown)).toBe(true);
+    });
+    it('rejects genuine failures', () => {
+        expect(isAbortError(new Error('boom'))).toBe(false);
+        expect(isAbortError(new RangeError('nope'))).toBe(false);
+        expect(isAbortError(undefined)).toBe(false);
+        expect(isAbortError('AbortError')).toBe(false);
+    });
+});
+describe('throwIfAborted / abortErrorFor', () => {
+    it('throws an abort-shaped error carrying a custom reason', () => {
+        const controller = new AbortController();
+        const reason = new AbortError('run cancelled');
+        controller.abort(reason);
+        let thrown;
+        try {
+            throwIfAborted(controller.signal);
+        }
+        catch (e) {
+            thrown = e;
+        }
+        expect(thrown).toBe(reason);
+        expect(isAbortError(abortErrorFor(controller.signal))).toBe(true);
+    });
+    it('is a no-op on a live or missing signal', () => {
+        expect(() => throwIfAborted(new AbortController().signal)).not.toThrow();
+        expect(() => throwIfAborted(undefined)).not.toThrow();
+    });
+});
+describe('linkSignals', () => {
+    it('aborts when either input aborts, carrying the reason', () => {
+        const a = new AbortController();
+        const b = new AbortController();
+        const link = linkSignals(a.signal, b.signal);
+        try {
+            expect(link.signal.aborted).toBe(false);
+            const reason = new AbortError('b fired');
+            b.abort(reason);
+            expect(link.signal.aborted).toBe(true);
+            expect(link.signal.reason).toBe(reason);
+        }
+        finally {
+            link.dispose();
+        }
+    });
+    it('aborts synchronously when an input is already aborted', () => {
+        const a = new AbortController();
+        a.abort(new AbortError('pre-aborted'));
+        const link = linkSignals(a.signal, new AbortController().signal);
+        expect(link.signal.aborted).toBe(true);
+        link.dispose();
+    });
+    it('skips undefined inputs', () => {
+        const a = new AbortController();
+        const link = linkSignals(undefined, a.signal, undefined);
+        try {
+            a.abort();
+            expect(link.signal.aborted).toBe(true);
+        }
+        finally {
+            link.dispose();
+        }
+    });
+    it('dispose() detaches every listener from the inputs', () => {
+        const a = new AbortController();
+        const b = new AbortController();
+        const link = linkSignals(a.signal, b.signal);
+        expect(listenerCount(a.signal)).toBe(1);
+        expect(listenerCount(b.signal)).toBe(1);
+        link.dispose();
+        expect(listenerCount(a.signal)).toBe(0);
+        expect(listenerCount(b.signal)).toBe(0);
+        // A post-dispose abort no longer propagates
+        a.abort();
+        expect(link.signal.aborted).toBe(false);
+    });
+    it('detaches from ALL inputs as soon as one aborts (no leak on the survivor)', () => {
+        const runController = new AbortController(); // long-lived
+        const step = new AbortController();
+        const link = linkSignals(runController.signal, step.signal);
+        step.abort();
+        expect(link.signal.aborted).toBe(true);
+        expect(listenerCount(runController.signal)).toBe(0);
+        link.dispose(); // idempotent
+        expect(listenerCount(runController.signal)).toBe(0);
+    });
+    it('leaves no listeners on a long-lived signal after many link/dispose cycles', () => {
+        const run = new AbortController();
+        for (let i = 0; i < 200; i++) {
+            const link = linkSignals(run.signal, new AbortController().signal);
+            link.dispose();
+        }
+        expect(listenerCount(run.signal)).toBe(0);
+    });
+});
+describe('abortableSleep', () => {
+    it('resolves normally and leaves no listener behind', async () => {
+        const controller = new AbortController();
+        await abortableSleep(10, controller.signal);
+        expect(listenerCount(controller.signal)).toBe(0);
+    });
+    it('rejects with an abort-shaped error when aborted mid-sleep', async () => {
+        const controller = new AbortController();
+        const p = abortableSleep(5000, controller.signal);
+        setTimeout(() => controller.abort(), 10);
+        const start = Date.now();
+        await expect(p).rejects.toSatisfy(isAbortError);
+        expect(Date.now() - start).toBeLessThan(1000);
+    });
+    it('rejects immediately on an already-aborted signal', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        await expect(abortableSleep(5000, controller.signal)).rejects.toSatisfy(isAbortError);
+    });
+    it('works without a signal', async () => {
+        await expect(abortableSleep(1)).resolves.toBeUndefined();
+    });
+});
+describe('abortableDelayResult', () => {
+    it('resolves false when the delay elapses, with no leaked listener or timer', async () => {
+        const controller = new AbortController();
+        await expect(abortableDelayResult(10, controller.signal)).resolves.toBe(false);
+        expect(listenerCount(controller.signal)).toBe(0);
+    });
+    it('resolves true promptly when aborted mid-delay', async () => {
+        const controller = new AbortController();
+        const p = abortableDelayResult(5000, controller.signal);
+        setTimeout(() => controller.abort(), 10);
+        const start = Date.now();
+        await expect(p).resolves.toBe(true);
+        expect(Date.now() - start).toBeLessThan(1000);
+    });
+    it('resolves true immediately on an already-aborted signal', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        await expect(abortableDelayResult(5000, controller.signal)).resolves.toBe(true);
+    });
+});
+//# sourceMappingURL=abort.test.js.map

package/build/utils/abort.test.js.map

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

package/build/utils/modal-detection-core.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Core modal detection utilities
+ *
+ * This module contains the fundamental logic for detecting modals and overlays
+ * on web pages. It uses a combination of:
+ * - Visual analysis (position, z-index, viewport coverage)
+ * - DOM structure analysis (ARIA attributes, common patterns)
+ * - Reverse detection (elementFromPoint for accuracy)
+ *
+ * NOTE: Functions in this file are serialized and executed in browser context.
+ * We use `as any` type assertions because these functions access DOM APIs
+ * (window, document, Element) that aren't available in Node.js types.
+ * At runtime, these functions execute in the browser where DOM APIs exist.
+ */
+/**
+ * Modal type classification
+ */
+export type ModalType = 'cookie-consent' | 'newsletter-popup' | 'age-verification' | 'generic-dialog' | 'blocking-overlay' | 'unknown';
+/**
+ * Available dismiss strategies
+ */
+export type DismissStrategy = 'accept' | 'reject' | 'close' | 'remove';
+/**
+ * Bounding box coordinates
+ */
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Modal detection options
+ */
+export interface ModalDetectionOptions {
+    minZIndex?: number;
+    minViewportCoverage?: number;
+    includeBackdrops?: boolean;
+}
+/**
+ * Modal classification result
+ */
+export interface ModalClassification {
+    type: ModalType;
+    confidence: number;
+    description: string;
+}
+/**
+ * Detected modal information (returned from page.evaluate)
+ */
+export interface DetectedModalInfo {
+    selector: string;
+    type: ModalType;
+    zIndex: number;
+    boundingBox: BoundingBox;
+    dismissStrategies: DismissStrategy[];
+    confidence: number;
+    description: string;
+}
+/**
+ * Browser-side modal detection types
+ * These types are used within page.evaluate() context
+ */
+export interface BrowserModalInfo {
+    selector: string;
+    type: string;
+    zIndex: number;
+    boundingBox: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    dismissStrategies: string[];
+    confidence: number;
+    description: string;
+}
+/**
+ * Common modal/dialog selectors and patterns
+ */
+export declare const MODAL_PATTERNS: {
+    cookieConsent: {
+        selectors: string[];
+        textPatterns: RegExp;
+    };
+    newsletter: {
+        selectors: string[];
+        textPatterns: RegExp;
+    };
+    ageVerification: {
+        selectors: string[];
+        textPatterns: RegExp;
+    };
+    genericDialog: {
+        selectors: string[];
+        textPatterns: null;
+    };
+};
+/**
+ * Common selectors for finding modal elements
+ */
+export declare const COMMON_MODAL_SELECTORS: string[];
+/**
+ * Check if element meets basic visibility criteria
+ * Runs in browser context via page.evaluate()
+ */
+export declare function isBasicVisible(el: any): boolean;
+/**
+ * Check if element is positioned to block viewport
+ * Runs in browser context via page.evaluate()
+ */
+export declare function isBlockingPosition(el: any): boolean;
+/**
+ * Check if element has sufficient z-index
+ * Runs in browser context via page.evaluate()
+ */
+export declare function hasMinimumZIndex(el: any, minZIndex: number): boolean;
+/**
+ * Check if element covers sufficient viewport area
+ * Runs in browser context via page.evaluate()
+ */
+export declare function coversMinimumViewport(el: any, minCoverage: number): boolean;
+/**
+ * Check if element is actually visible on top using elementFromPoint
+ * This is the most reliable method - it verifies the element is truly on top
+ * Runs in browser context via page.evaluate()
+ */
+export declare function isVisibleOnTop(el: any): boolean;
+/**
+ * Combined check: is element blocking the viewport?
+ * Uses all visibility checks including elementFromPoint for accuracy
+ * Runs in browser context via page.evaluate()
+ */
+export declare function isElementBlockingViewport(el: any, minZIndex: number, minViewportCoverage: number): boolean;
+/**
+ * Classify modal type based on content and attributes
+ * Runs in browser context via page.evaluate()
+ */
+export declare function classifyModal(el: any, patterns: typeof MODAL_PATTERNS): ModalClassification;
+/**
+ * Determine dismissal strategies available for a modal
+ * Runs in browser context via page.evaluate()
+ */
+export declare function getDismissStrategies(el: any, modalType: string): DismissStrategy[];
+/**
+ * Generate unique CSS selector for an element
+ * Runs in browser context via page.evaluate()
+ */
+export declare function getUniqueSelector(el: any): string;
+//# sourceMappingURL=modal-detection-core.d.ts.map

package/build/utils/modal-detection-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal-detection-core.d.ts","sourceRoot":"","sources":["../../src/utils/modal-detection-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE;QACX,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CA8C1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,UAYlC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAS/C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAMnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAOpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAQ3E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAkB/C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,GAAG,EACP,SAAS,EAAE,MAAM,EACjB,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,GAAG,EACP,QAAQ,EAAE,OAAO,cAAc,GAC9B,mBAAmB,CA8FrB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CA2ClF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CA4CjD"}