jumpy-lion 0.1.6-beta.9 → 1.0.0-beta.4

package/dist/input/element-target.js

@@ -0,0 +1,461 @@
+/**
+ * ElementTarget - the deep module that turns a CSS selector into a stable,
+ * in-viewport coordinate target (or a typed failure: not found, invisible,
+ * unclickable, no box model, out of viewport).
+ *
+ * Sits beside InputEmulator: ElementTarget decides WHERE and WHEN to dispatch
+ * (geometry, visibility, scroll, position stabilization); InputEmulator
+ * decides HOW (paths, cadence, transport events). It talks to the page only
+ * through the narrow ElementTargetPort, so the whole acquire-protocol is
+ * unit-testable with a scripted port - same pattern as InputTransport's
+ * recording adapter.
+ */
+export const HUMAN_DELAY_MS = 200; // ms delay for human-like interactions
+export const POSITION_STABILITY_TIMEOUT_MS = 2000; // Timeout for position stabilization
+export const POSITION_CHECK_INTERVAL_MS = 100; // Interval for position checks
+export const POSITION_STABILITY_THRESHOLD = 3; // Number of consecutive stable checks required
+export const POSITION_TOLERANCE_PX = 1; // Maximum pixel difference to consider "stable"
+export const VIEWPORT_TOLERANCE_PX = 50; // Tolerance for viewport positioning
+/**
+ * Pick a click target inside an element's content box. Real users do NOT
+ * click the exact mathematical center - eye-tracking studies cluster
+ * clicks in the 30-70% range of each axis. Behavioral ML on click landing
+ * distributions (Cloudflare Turnstile 2025+, HUMAN Bot Defender) flags
+ * sessions whose clicks all hit pixel-perfect centers.
+ *
+ * Takes the axis-aligned {@link ContentBox} directly. The previous 8-element
+ * positional quad [x0,y0,...x3,y3] was synthesized from `getBoundingClientRect`
+ * (already axis-aligned) only to be reduced back via min/max over corners - a
+ * no-op for an axis-aligned box, so the box is passed straight through now.
+ */
+export function humanizedClickTarget(box) {
+    const xFrac = 0.30 + Math.random() * 0.40; // [0.30, 0.70]
+    const yFrac = 0.30 + Math.random() * 0.40;
+    return {
+        x: box.x + box.width * xFrac,
+        y: box.y + box.height * yFrac,
+    };
+}
+/**
+ * The single in-page source of truth for existence + visibility + clickability.
+ * Resolves the selector ONCE and returns all three plus the (pre-scroll) box in
+ * one evaluate round-trip.
+ *
+ * Hoisted to module scope with NO external references so `acquire`, `isVisible`,
+ * and `isClickable` share ONE implementation instead of maintaining three
+ * byte-equivalent copies. It is shipped to the page via Function.toString()
+ * (see CdpPage.evaluate), so it must stay self-contained - it may reference only
+ * page globals (document/window), never module-scope helpers.
+ */
+function probeElement(sel) {
+    // ACQUIRE_COMBINED_PROBE - unique marker for scripted-port dispatch.
+    const element = document.querySelector(sel);
+    if (!element) {
+        return {
+            found: false,
+            isVisible: false,
+            isClickable: false,
+            boundingBox: { x: 0, y: 0, width: 0, height: 0 },
+        };
+    }
+    const rect = element.getBoundingClientRect();
+    const style = window.getComputedStyle(element);
+    // --- Visibility ---
+    let isVisible;
+    if (style.display === 'none' || style.visibility === 'hidden') {
+        isVisible = false;
+    }
+    else if (rect.width === 0 || rect.height === 0) {
+        isVisible = false;
+    }
+    else if (parseFloat(style.opacity) === 0) {
+        isVisible = false;
+    }
+    else {
+        isVisible = true;
+        // Walk up the ancestor chain - clipping by a grandparent+ (cards,
+        // modals, scroll containers) is just as real as clipping by the
+        // immediate parent.
+        let ancestor = element.parentElement;
+        while (ancestor && ancestor !== document.body) {
+            const ancestorStyle = window.getComputedStyle(ancestor);
+            const clips = ancestorStyle.overflow === 'hidden' ||
+                ancestorStyle.overflowX === 'hidden' ||
+                ancestorStyle.overflowY === 'hidden';
+            if (clips) {
+                const ancestorRect = ancestor.getBoundingClientRect();
+                if (rect.left >= ancestorRect.right ||
+                    rect.right <= ancestorRect.left ||
+                    rect.top >= ancestorRect.bottom ||
+                    rect.bottom <= ancestorRect.top) {
+                    isVisible = false;
+                    break;
+                }
+            }
+            ancestor = ancestor.parentElement;
+        }
+    }
+    // --- Clickability ---
+    // readonly is intentionally NOT a blocker - only `disabled` blocks
+    // interaction; readonly inputs/textareas are still clickable.
+    let isClickable;
+    if (element.hasAttribute('disabled') || element.classList.contains('disabled')) {
+        isClickable = false;
+    }
+    else if (style.pointerEvents === 'none') {
+        isClickable = false;
+    }
+    else if (rect.width === 0 || rect.height === 0) {
+        isClickable = false;
+    }
+    else if (parseFloat(style.opacity) === 0) {
+        isClickable = false;
+    }
+    else {
+        isClickable = true;
+    }
+    return {
+        found: true,
+        isVisible,
+        isClickable,
+        boundingBox: {
+            x: rect.left,
+            y: rect.top,
+            width: rect.width,
+            height: rect.height,
+        },
+    };
+}
+export class ElementTarget {
+    constructor(port) {
+        Object.defineProperty(this, "port", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: port
+        });
+    }
+    /**
+     * Gets detailed information about an element, or null when it is absent.
+     *
+     * Delegates to the shared {@link probeElement} like `isVisible`/`isClickable`
+     * do. It used to inline its own copy of the checks, which had already
+     * drifted: that copy ignored `opacity: 0` and ancestor-overflow clipping, so
+     * it reported `isVisible: true` for elements `acquire()` rejects as hidden.
+     * One implementation means the three can never disagree again.
+     */
+    async getElementInfo(selector) {
+        const probe = await this.port.evaluate(probeElement, selector);
+        if (!probe?.found)
+            return null;
+        return {
+            nodeId: 0, // Will be set by CDP
+            boundingBox: probe.boundingBox,
+            isVisible: probe.isVisible,
+            isClickable: probe.isClickable,
+        };
+    }
+    /**
+     * Enhanced visibility check (display/visibility/opacity + ancestor-overflow
+     * clipping). Delegates to the shared {@link probeElement} so it can never
+     * drift from the check `acquire` enforces. Returns false for a missing element.
+     */
+    async isVisible(selector) {
+        const probe = await this.port.evaluate(probeElement, selector);
+        return probe.isVisible;
+    }
+    /**
+     * Enhanced clickable check (disabled/pointer-events/dimensions/opacity;
+     * readonly is intentionally NOT a blocker). Delegates to the shared
+     * {@link probeElement}. Returns false for a missing element.
+     */
+    async isClickable(selector) {
+        const probe = await this.port.evaluate(probeElement, selector);
+        return probe.isClickable;
+    }
+    /**
+     * Whether a form element is editable: present, not disabled, not readonly.
+     * Exposed separately from {@link isClickable} because readonly elements are
+     * clickable/focusable but not editable.
+     */
+    async isEditable(selector) {
+        return await this.port.evaluate((sel) => {
+            const element = document.querySelector(sel);
+            if (!element)
+                return false;
+            return !element.hasAttribute('disabled') &&
+                !element.classList.contains('disabled') &&
+                !element.hasAttribute('readonly');
+        }, selector);
+    }
+    /**
+     * Enhanced scroll into view with better positioning
+     */
+    async scrollIntoView(selector) {
+        if (this.port.humanization().scroll) {
+            try {
+                await this.port.humanScrollToElement(selector);
+                await this.port.evaluate((sel) => {
+                    const element = document.querySelector(sel);
+                    element?.scrollIntoView({ behavior: 'auto', block: 'center', inline: 'center' });
+                }, selector);
+                return;
+            }
+            catch {
+                // Some hidden/offscreen nodes do not expose a box model.
+                // Fall back to native DOM scrolling for robustness.
+            }
+        }
+        await this.port.evaluate((sel, tolerance) => {
+            const element = document.querySelector(sel);
+            if (!element)
+                return;
+            const rect = element.getBoundingClientRect();
+            const viewportHeight = window.innerHeight;
+            const viewportWidth = window.innerWidth;
+            // Check if element is already in viewport (with tolerance)
+            const isInViewport = rect.top >= -tolerance &&
+                rect.left >= -tolerance &&
+                rect.bottom <= viewportHeight + tolerance &&
+                rect.right <= viewportWidth + tolerance;
+            if (!isInViewport) {
+                // Scroll element into view with better positioning
+                element.scrollIntoView({
+                    behavior: 'smooth',
+                    block: 'center',
+                    inline: 'center',
+                });
+            }
+        }, selector, VIEWPORT_TOLERANCE_PX);
+    }
+    /**
+     * Waits for an element's position to stabilize before interacting with it.
+     * Useful for letting scroll animations or dynamic layout changes settle.
+     * Times out silently - some elements never stabilize; callers proceed at their own risk.
+     *
+     * The observation runs entirely in-page in a SINGLE evaluate round-trip:
+     * a `requestAnimationFrame` loop samples the element's position, but only
+     * once every `checkInterval` ms of wall-clock, so the settle window matches
+     * the historical driver-side poll (N stable samples spaced `checkInterval`
+     * apart). The behaviour observable to the site is identical - it still waits
+     * the same duration for layout to settle before the click; only the internal
+     * transport changes (one round-trip instead of one evaluate per tick). A
+     * setTimeout hard-cap guarantees termination even if rAF is paused (a
+     * backgrounded tab), matching the old loop which always ended at `timeout`.
+     */
+    async waitForPositionToStabilize(selector, timeout = POSITION_STABILITY_TIMEOUT_MS, checkInterval = POSITION_CHECK_INTERVAL_MS, stabilityThreshold = POSITION_STABILITY_THRESHOLD, tolerance = POSITION_TOLERANCE_PX) {
+        await this.port.evaluate(async (sel, threshold, tol, timeoutMs, intervalMs) => {
+            return new Promise((resolve) => {
+                const startTime = Date.now();
+                let stableCount = 0;
+                let lastPosition = null;
+                let lastSampleTime = 0;
+                let done = false;
+                const finish = () => {
+                    if (done)
+                        return;
+                    done = true;
+                    clearTimeout(timer);
+                    // Resolve silently, matching the historical poll loop (never rejects).
+                    resolve();
+                };
+                // Hard cap that fires even if requestAnimationFrame is fully paused
+                // (backgrounded tab), so the wait can never hang - the old poll loop
+                // always terminated at `timeout` via its own setTimeout.
+                const timer = setTimeout(finish, timeoutMs);
+                const measure = () => {
+                    if (done)
+                        return;
+                    const now = Date.now();
+                    if (now - startTime >= timeoutMs) {
+                        finish();
+                        return;
+                    }
+                    // Pace samples to `intervalMs` of wall-clock (not every frame) so
+                    // the stability window matches the historical poll: the element
+                    // must hold position across `threshold` samples spaced `intervalMs`
+                    // apart before it is treated as settled. Sampling every rAF tick
+                    // would declare "stable" ~250ms sooner and fire the click early.
+                    if (now - lastSampleTime >= intervalMs) {
+                        lastSampleTime = now;
+                        try {
+                            const element = document.querySelector(sel);
+                            if (!element) {
+                                stableCount = 0;
+                                lastPosition = null;
+                            }
+                            else {
+                                const rect = element.getBoundingClientRect();
+                                const currentPosition = {
+                                    x: Math.round(rect.left),
+                                    y: Math.round(rect.top),
+                                    width: Math.round(rect.width),
+                                    height: Math.round(rect.height),
+                                };
+                                if (!lastPosition) {
+                                    lastPosition = currentPosition;
+                                    stableCount = 1;
+                                }
+                                else {
+                                    const isStable = Math.abs(currentPosition.x - lastPosition.x) <= tol &&
+                                        Math.abs(currentPosition.y - lastPosition.y) <= tol &&
+                                        Math.abs(currentPosition.width - lastPosition.width) <= tol &&
+                                        Math.abs(currentPosition.height - lastPosition.height) <= tol;
+                                    if (isStable) {
+                                        stableCount++;
+                                        if (stableCount >= threshold) {
+                                            finish();
+                                            return;
+                                        }
+                                    }
+                                    else {
+                                        stableCount = 1;
+                                    }
+                                    lastPosition = currentPosition;
+                                }
+                            }
+                        }
+                        catch {
+                            stableCount = 0;
+                            lastPosition = null;
+                        }
+                    }
+                    requestAnimationFrame(measure);
+                };
+                requestAnimationFrame(measure);
+            });
+        }, selector, stabilityThreshold, tolerance, timeout, checkInterval);
+    }
+    /**
+     * Check if element is within the viewport (with some tolerance)
+     */
+    async isInViewport(selector) {
+        return await this.port.evaluate((sel, tolerance) => {
+            const element = document.querySelector(sel);
+            if (!element)
+                return false;
+            const rect = element.getBoundingClientRect();
+            const viewportHeight = window.innerHeight;
+            const viewportWidth = window.innerWidth;
+            // Add some tolerance for scroll positioning
+            return rect.top >= -tolerance &&
+                rect.left >= -tolerance &&
+                rect.bottom <= viewportHeight + tolerance &&
+                rect.right <= viewportWidth + tolerance;
+        }, selector, VIEWPORT_TOLERANCE_PX);
+    }
+    /**
+     * The full pre-click targeting protocol: existence + visibility +
+     * clickability checks, scroll into view, position stabilization, box-model
+     * geometry, humanized (or exact-center) point selection, and a final
+     * in-viewport check. Returns the coordinates to click; throws a typed
+     * failure otherwise.
+     *
+     * With `force: true` every check is bypassed and a hidden element falls
+     * back to its bounding-box center.
+     */
+    async acquire(selector, options) {
+        const force = options?.force ?? false;
+        // Single combined probe: resolve the selector ONCE and return existence,
+        // visibility, clickability, and boundingBox in one evaluate round-trip
+        // instead of three (getElementInfo + isVisible + isClickable). Shares
+        // the module-level probeElement with isVisible()/isClickable() so the
+        // three can never drift apart.
+        const probe = await this.port.evaluate(probeElement, selector);
+        if (!probe || !probe.found) {
+            throw new Error(`Element not found: ${selector}`);
+        }
+        if (!force) {
+            if (!probe.isVisible) {
+                throw new Error(`Element is not visible: ${selector}. Use force: true to bypass the visibility check and attempt interaction anyway. Warning: Interacting with non-visible elements may lead to unexpected behavior or errors.`);
+            }
+            if (!probe.isClickable) {
+                throw new Error(`Element is not clickable: ${selector}. Use force: true to bypass this check.`);
+            }
+        }
+        // Scroll element into view if needed
+        await this.scrollIntoView(selector);
+        // Wait for the element's position to stabilize after scrolling.
+        // Scroll animations or layout changes may shift the element for a short
+        // period; clicking before the position is stable can send the click to
+        // the wrong location.
+        await this.waitForPositionToStabilize(selector, POSITION_STABILITY_TIMEOUT_MS, POSITION_CHECK_INTERVAL_MS);
+        // Read fresh viewport-relative geometry AFTER scroll+stabilize. This is
+        // the same CSS-pixel coordinate space Input.dispatchMouseEvent consumes,
+        // so no CDP round-trips (DOM.getDocument + querySelector + getBoxModel)
+        // are needed - one evaluate replaces all three. The probe's boundingBox
+        // was captured pre-scroll and would be stale here, so we re-read.
+        //
+        // We reproduce CDP DOM.getBoxModel's `content` quad, NOT the raw
+        // getBoundingClientRect box: getBoundingClientRect returns the BORDER
+        // box (includes padding + border) while the historical click path used
+        // the CONTENT box, and humanizedClickTarget picks a point inside it.
+        // Subtracting computed padding+border makes the derived box byte-equivalent
+        // to the old content quad - a pure transport change, no behavior shift.
+        // We also return the border box as a degeneracy fallback (an element that
+        // is all padding has a zero-area content box but is still clickable).
+        const rect = await this.port.evaluate((sel) => {
+            const element = document.querySelector(sel);
+            if (!element)
+                return null;
+            const r = element.getBoundingClientRect();
+            const cs = window.getComputedStyle(element);
+            const insetL = parseFloat(cs.borderLeftWidth) + parseFloat(cs.paddingLeft);
+            const insetR = parseFloat(cs.borderRightWidth) + parseFloat(cs.paddingRight);
+            const insetT = parseFloat(cs.borderTopWidth) + parseFloat(cs.paddingTop);
+            const insetB = parseFloat(cs.borderBottomWidth) + parseFloat(cs.paddingBottom);
+            return {
+                content: {
+                    x: r.left + insetL,
+                    y: r.top + insetT,
+                    width: Math.max(0, r.width - insetL - insetR),
+                    height: Math.max(0, r.height - insetT - insetB),
+                },
+                border: { x: r.left, y: r.top, width: r.width, height: r.height },
+            };
+        }, selector);
+        // getBoundingClientRect never throws (unlike DOM.getBoxModel): a missing
+        // element yields null. Prefer the content box; fall back to the border
+        // box when the content box is degenerate (padding-only element). Non-force
+        // elements were already proven visible+clickable (non-zero border box) by
+        // the probe. Force bypasses every check, so degrade a missing element to
+        // the pre-scroll probe box, then to the rect origin - never throwing.
+        let source;
+        if (rect && rect.content.width > 0 && rect.content.height > 0) {
+            source = rect.content;
+        }
+        else if (rect && rect.border.width > 0 && rect.border.height > 0) {
+            source = rect.border;
+        }
+        else if (force) {
+            source = (probe.boundingBox.width > 0 && probe.boundingBox.height > 0)
+                ? probe.boundingBox
+                : { x: 0, y: 0, width: 0, height: 0 };
+        }
+        else {
+            throw new Error(`Could not resolve click geometry for ${selector}: element missing or zero-area after scroll.`);
+        }
+        // Randomized in-box point under mouse humanization; exact center
+        // otherwise so deterministic tests are unaffected.
+        const point = this.port.humanization().mouse
+            ? humanizedClickTarget(source)
+            : {
+                x: source.x + source.width / 2,
+                y: source.y + source.height / 2,
+            };
+        // Verify element is still in viewport after scrolling (with some tolerance)
+        if (!force) {
+            const isInViewport = await this.isInViewport(selector);
+            if (!isInViewport) {
+                // Give a bit more time for scroll animations to complete
+                await new Promise(resolve => setTimeout(resolve, HUMAN_DELAY_MS));
+                const isInViewportAfterDelay = await this.isInViewport(selector);
+                if (!isInViewportAfterDelay) {
+                    throw new Error(`Element is not in viewport after scrolling: ${selector}`);
+                }
+            }
+        }
+        return point;
+    }
+}
+//# sourceMappingURL=element-target.js.map

package/dist/input/element-target.js.map

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

package/dist/input/input-emulator.d.ts

@@ -0,0 +1,85 @@
+import type { InputTransport } from './input-transport.js';
+export type MouseButton = 'left' | 'right' | 'middle';
+export interface HumanizationOptions {
+    mouse: boolean;
+    keyboard: boolean;
+    scroll: boolean;
+}
+export interface ClickOptions {
+    button?: MouseButton;
+    clickCount?: number;
+    /** Explicit press→release delay (ms). Overrides humanized timing when > 0. */
+    delay?: number;
+}
+export interface TypeOptions {
+    /** Explicit inter-character delay (ms). Overrides humanized cadence when > 0. */
+    delay?: number;
+}
+interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Cubic Bézier mouse path from (fromX, fromY) to (toX, toY) in pure TypeScript -
+ * NO `Runtime.evaluate` round-trip per move (which is itself a 2026 CDP-detection
+ * signal). Two perpendicular-offset control points (±30% distance bias) bow each
+ * move unpredictably; eased-in-out timing matches arm motion; sub-pixel wobble
+ * (peaking mid-curve, under ±1.5 px) mimics pointer tremor. Returns rounded
+ * integer points; the caller dispatches one mouse event per point.
+ */
+export declare function bezierMousePath(fromX: number, fromY: number, toX: number, toY: number): Point[];
+/**
+ * True for code points entered through an IME (Korean Hangul, Japanese
+ * Hiragana/Katakana, Chinese Han, Fullwidth/Halfwidth forms). These can't go
+ * through the rawKeyDown → char → keyUp path; Naver / Japanese IME-aware forms
+ * validate the composition event lifecycle, which plain `insertText` skips.
+ */
+export declare function isCjkChar(char: string): boolean;
+/**
+ * Deep module over {@link InputTransport}: turns high-level intents
+ * (move, click, type) into humanized sequences of transport events. Owns
+ * cursor position, the held-button bitmask, and the CJK composition lifecycle.
+ * Coordinate/text level - selector resolution is the caller's job.
+ */
+export declare class InputEmulator {
+    private readonly transport;
+    private lastMousePosition;
+    private readonly heldMouseButtons;
+    private humanization;
+    constructor(transport: InputTransport, humanization?: Partial<HumanizationOptions>);
+    setHumanization(options?: Partial<HumanizationOptions>): void;
+    /** Current cursor position (copy). */
+    get position(): {
+        x: number;
+        y: number;
+    };
+    private buttonsBitmask;
+    /**
+     * Move the cursor to (x, y). With mouse humanization on, follows a Bézier
+     * path with eased timing; otherwise a single `mouseMoved`.
+     */
+    moveTo(x: number, y: number): Promise<void>;
+    /**
+     * Move to (x, y) and perform a human-like click. The held-button set is
+     * updated before each dispatch so `event.buttons` is spec-correct on
+     * mousedown (button present) and mouseup (button cleared).
+     */
+    clickAt(x: number, y: number, options?: ClickOptions): Promise<void>;
+    /**
+     * Type text at the current focus. ANSI keys go through rawKeyDown → char →
+     * keyUp; CJK characters go through the IME composition path; other Unicode
+     * falls back to insertText. Keyboard humanization adds a bimodal cadence
+     * (mostly fast, occasional "thinking" pauses).
+     */
+    typeText(text: string, options?: TypeOptions): Promise<void>;
+    private typeChar;
+    /**
+     * Type one CJK character through the IME composition path so the page sees a
+     * real `compositionstart → compositionupdate → compositionend` sequence
+     * (`imeSetComposition` starts it; `text`/insertText commits). Falls back to
+     * plain text if composition is unavailable.
+     */
+    private typeCjkChar;
+}
+export {};
+//# sourceMappingURL=input-emulator.d.ts.map

package/dist/input/input-emulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-emulator.d.ts","sourceRoot":"","sources":["../../src/input/input-emulator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAcD,UAAU,KAAK;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;AA0CxC;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACZ,KAAK,EAAE,CAsCT;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAY/C;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IAMlB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL9B,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAC3D,OAAO,CAAC,YAAY,CAAsB;gBAGrB,SAAS,EAAE,cAAc,EAC1C,YAAY,GAAE,OAAO,CAAC,mBAAmB,CAAM;IASnD,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAQ7D,sCAAsC;IACtC,IAAI,QAAQ,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAEvC;IAED,OAAO,CAAC,cAAc;IAMtB;;;OAGG;IACG,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BjD;;;;OAIG;IACG,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC1E;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YA6BpD,QAAQ;IA2CtB;;;;;OAKG;YACW,WAAW;CAY5B"}