@aria-cli/tools 1.0.0

package/dist/definitions/browser/pw-downloads.js

@@ -0,0 +1,115 @@
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+/**
+ * File upload and download handling.
+ * Ported from OpenClaw's pw-tools-core.downloads.ts.
+ *
+ * Note: Upload is handled in pw-interactions.ts via setInputFiles.
+ * This module provides download capture via page "download" event.
+ */
+import { tmpdir } from "node:os";
+import { join, dirname, resolve, basename } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { normalizeTimeoutMs } from "./pw-shared.js";
+// ── Filename sanitization ─────────────────────────────────────────────
+function sanitizeDownloadFileName(fileName) {
+    const trimmed = String(fileName ?? "").trim();
+    if (!trimmed) {
+        return "download.bin";
+    }
+    // Force a basename so path separators/traversal can't escape the downloads dir.
+    let base = basename(trimmed);
+    let cleaned = "";
+    for (let i = 0; i < base.length; i++) {
+        const code = base.charCodeAt(i);
+        if (code < 0x20 || code === 0x7f) {
+            continue;
+        }
+        cleaned += base[i];
+    }
+    base = cleaned.trim();
+    if (!base || base === "." || base === "..") {
+        return "download.bin";
+    }
+    if (base.length > 200) {
+        base = base.slice(0, 200);
+    }
+    return base;
+}
+function buildTempDownloadPath(fileName) {
+    const id = randomUUID();
+    const safeName = sanitizeDownloadFileName(fileName);
+    return join(tmpdir(), "aria-downloads", `${id}-${safeName}`);
+}
+// ── Download waiter ───────────────────────────────────────────────────
+function createPageDownloadWaiter(page, timeoutMs) {
+    let done = false;
+    let timer;
+    let handler;
+    const cleanup = () => {
+        if (timer) {
+            clearTimeout(timer);
+        }
+        timer = undefined;
+        if (handler) {
+            page.off("download", handler);
+            handler = undefined;
+        }
+    };
+    const promise = new Promise((resolveP, reject) => {
+        handler = (download) => {
+            if (done) {
+                return;
+            }
+            done = true;
+            cleanup();
+            resolveP(download);
+        };
+        page.on("download", handler);
+        timer = setTimeout(() => {
+            if (done) {
+                return;
+            }
+            done = true;
+            cleanup();
+            reject(new Error("Timeout waiting for download"));
+        }, timeoutMs);
+    });
+    return {
+        promise,
+        cancel: () => {
+            if (done) {
+                return;
+            }
+            done = true;
+            cleanup();
+        },
+    };
+}
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Wait for the next download event on the page and save the file.
+ */
+export async function waitForDownload(opts) {
+    const timeout = normalizeTimeoutMs(opts.timeoutMs, 120_000);
+    const waiter = createPageDownloadWaiter(opts.page, timeout);
+    try {
+        const download = (await waiter.promise);
+        const suggested = download.suggestedFilename?.() || "download.bin";
+        const outPath = opts.path?.trim() || buildTempDownloadPath(suggested);
+        await mkdir(dirname(outPath), { recursive: true });
+        await download.saveAs?.(outPath);
+        return {
+            url: download.url?.() || "",
+            suggestedFilename: suggested,
+            path: resolve(outPath),
+        };
+    }
+    catch (err) {
+        waiter.cancel();
+        throw err;
+    }
+}
+//# sourceMappingURL=pw-downloads.js.map

package/dist/definitions/browser/pw-downloads.js.map

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

package/dist/definitions/browser/pw-interactions.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Playwright interaction handlers: click, type, hover, drag, select, key press, evaluate.
+ * Ported from OpenClaw's pw-tools-core.interactions.ts.
+ */
+import type { PwPage, RoleRefMap } from "./types.js";
+/**
+ * Resolve a ref string (e.g. "e1") into a Playwright Locator using the
+ * role-ref map from the last snapshot.
+ */
+export declare function refLocator(page: PwPage, ref: string, refs: RoleRefMap): import("./types.js").PwLocator;
+export declare function clickViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    doubleClick?: boolean;
+    button?: "left" | "right" | "middle";
+    modifiers?: string[];
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function hoverViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function dragViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    startRef: string;
+    endRef: string;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function typeViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    text: string;
+    submit?: boolean;
+    slowly?: boolean;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function selectOptionViaPlaywright(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    values: string[];
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function pressKeyViaPlaywright(opts: {
+    page: PwPage;
+    key: string;
+}): Promise<void>;
+export declare function evaluateViaPlaywright(opts: {
+    page: PwPage;
+    script: string;
+    timeoutMs?: number;
+}): Promise<unknown>;
+export declare function takeScreenshot(opts: {
+    page: PwPage;
+    fullPage?: boolean;
+}): Promise<Buffer>;
+export declare function scrollPage(opts: {
+    page: PwPage;
+    direction: "up" | "down";
+    amount?: number;
+}): Promise<void>;
+export declare function waitForCondition(opts: {
+    page: PwPage;
+    selector?: string;
+    text?: string;
+    timeout?: number;
+}): Promise<void>;
+export declare function uploadFiles(opts: {
+    page: PwPage;
+    refs: RoleRefMap;
+    ref: string;
+    paths: string[];
+}): Promise<void>;
+//# sourceMappingURL=pw-interactions.d.ts.map

package/dist/definitions/browser/pw-interactions.d.ts.map

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

package/dist/definitions/browser/pw-interactions.js

@@ -0,0 +1,200 @@
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+import { requireRef, toAIFriendlyError, normalizeTimeoutMs } from "./pw-shared.js";
+// ── Ref locator ───────────────────────────────────────────────────────
+/**
+ * Resolve a ref string (e.g. "e1") into a Playwright Locator using the
+ * role-ref map from the last snapshot.
+ */
+export function refLocator(page, ref, refs) {
+    const normalized = ref.startsWith("@")
+        ? ref.slice(1)
+        : ref.startsWith("ref=")
+            ? ref.slice(4)
+            : ref;
+    if (/^e\d+$/.test(normalized)) {
+        const info = refs[normalized];
+        if (!info) {
+            throw new Error(`Unknown ref "${normalized}". Run a new snapshot and use a ref from that snapshot.`);
+        }
+        const locator = info.name
+            ? page.getByRole(info.role, { name: info.name, exact: true })
+            : page.getByRole(info.role);
+        return info.nth !== undefined ? locator.nth(info.nth) : locator;
+    }
+    // Fallback: treat as CSS selector
+    return page.locator(normalized);
+}
+// ── Click ─────────────────────────────────────────────────────────────
+export async function clickViaPlaywright(opts) {
+    const ref = requireRef(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    const timeout = normalizeTimeoutMs(opts.timeoutMs, 8000);
+    try {
+        if (opts.doubleClick) {
+            await locator.dblclick({
+                timeout,
+                button: opts.button,
+                modifiers: opts.modifiers,
+            });
+        }
+        else {
+            await locator.click({
+                timeout,
+                button: opts.button,
+                modifiers: opts.modifiers,
+            });
+        }
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, ref);
+    }
+}
+// ── Hover ─────────────────────────────────────────────────────────────
+export async function hoverViaPlaywright(opts) {
+    const ref = requireRef(opts.ref);
+    try {
+        await refLocator(opts.page, ref, opts.refs).hover({
+            timeout: normalizeTimeoutMs(opts.timeoutMs, 8000),
+        });
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, ref);
+    }
+}
+// ── Drag ──────────────────────────────────────────────────────────────
+export async function dragViaPlaywright(opts) {
+    const startRef = requireRef(opts.startRef);
+    const endRef = requireRef(opts.endRef);
+    try {
+        await refLocator(opts.page, startRef, opts.refs).dragTo(refLocator(opts.page, endRef, opts.refs), { timeout: normalizeTimeoutMs(opts.timeoutMs, 8000) });
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, `${startRef} -> ${endRef}`);
+    }
+}
+// ── Type ──────────────────────────────────────────────────────────────
+export async function typeViaPlaywright(opts) {
+    const text = String(opts.text ?? "");
+    const ref = requireRef(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    const timeout = normalizeTimeoutMs(opts.timeoutMs, 8000);
+    try {
+        if (opts.slowly) {
+            await locator.click({ timeout });
+            await locator.type(text, { timeout, delay: 75 });
+        }
+        else {
+            await locator.fill(text, { timeout });
+        }
+        if (opts.submit) {
+            await locator.press("Enter", { timeout });
+        }
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, ref);
+    }
+}
+// ── Select option ─────────────────────────────────────────────────────
+export async function selectOptionViaPlaywright(opts) {
+    const ref = requireRef(opts.ref);
+    if (!opts.values?.length) {
+        throw new Error("values are required");
+    }
+    try {
+        await refLocator(opts.page, ref, opts.refs).selectOption(opts.values, {
+            timeout: normalizeTimeoutMs(opts.timeoutMs, 8000),
+        });
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, ref);
+    }
+}
+// ── Key press ─────────────────────────────────────────────────────────
+export async function pressKeyViaPlaywright(opts) {
+    const key = String(opts.key ?? "").trim();
+    if (!key) {
+        throw new Error("key is required");
+    }
+    await opts.page.keyboard.press(key);
+}
+// ── Evaluate ──────────────────────────────────────────────────────────
+export async function evaluateViaPlaywright(opts) {
+    const script = String(opts.script ?? "").trim();
+    if (!script) {
+        throw new Error("script is required");
+    }
+    const evaluateTimeout = normalizeTimeoutMs(opts.timeoutMs, 20_000);
+    // Inject a timeout wrapper into the browser context so async scripts
+    // don't block the Playwright command queue indefinitely.
+    // We use a string-form evaluate to avoid TypeScript signature conflicts
+    // with our minimal PwPage interface.
+    const wrappedScript = `
+    (function() {
+      var fnBody = ${JSON.stringify(script)};
+      var timeoutMs = ${evaluateTimeout};
+      try {
+        var candidate = eval("(" + fnBody + ")");
+        var result = typeof candidate === "function" ? candidate() : candidate;
+        if (result && typeof result === "object" && typeof result.then === "function") {
+          return Promise.race([
+            result,
+            new Promise(function(_, reject) {
+              setTimeout(function() { reject(new Error("evaluate timed out after " + timeoutMs + "ms")); }, timeoutMs);
+            })
+          ]);
+        }
+        return result;
+      } catch (err) {
+        throw new Error("Invalid evaluate function: " + (err && err.message ? err.message : String(err)));
+      }
+    })()
+  `;
+    const result = await opts.page.evaluate(wrappedScript);
+    return result;
+}
+// ── Screenshot ────────────────────────────────────────────────────────
+export async function takeScreenshot(opts) {
+    return opts.page.screenshot({
+        type: "png",
+        fullPage: Boolean(opts.fullPage),
+    });
+}
+// ── Scroll ────────────────────────────────────────────────────────────
+export async function scrollPage(opts) {
+    const pixels = Math.max(100, Math.min(5000, opts.amount ?? 500));
+    const deltaY = opts.direction === "up" ? -pixels : pixels;
+    await opts.page.mouse.wheel(0, deltaY);
+    // Give the page a moment to process the scroll
+    await opts.page.waitForTimeout(300);
+}
+// ── Wait ──────────────────────────────────────────────────────────────
+export async function waitForCondition(opts) {
+    const timeout = normalizeTimeoutMs(opts.timeout, 10_000);
+    if (opts.text) {
+        await opts.page.locator(`text=${opts.text}`).first().waitFor({ state: "visible", timeout });
+        return;
+    }
+    if (opts.selector) {
+        await opts.page.locator(opts.selector).first().waitFor({ state: "visible", timeout });
+        return;
+    }
+    // Default: wait for network idle
+    await opts.page.waitForLoadState("networkidle", { timeout });
+}
+// ── Upload ────────────────────────────────────────────────────────────
+export async function uploadFiles(opts) {
+    if (!opts.paths?.length) {
+        throw new Error("paths are required");
+    }
+    const ref = requireRef(opts.ref);
+    const locator = refLocator(opts.page, ref, opts.refs);
+    try {
+        await locator.setInputFiles(opts.paths);
+    }
+    catch (err) {
+        throw toAIFriendlyError(err, ref);
+    }
+}
+//# sourceMappingURL=pw-interactions.js.map

package/dist/definitions/browser/pw-interactions.js.map

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

package/dist/definitions/browser/pw-responses.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Console, network, and error monitoring.
+ * Ported from OpenClaw's pw-tools-core.activity.ts + pw-tools-core.responses.ts.
+ */
+import type { BrowserConsoleMessage, BrowserNetworkRequest, BrowserPageError } from "./types.js";
+export declare const MAX_CONSOLE_MESSAGES = 500;
+export declare const MAX_NETWORK_REQUESTS = 500;
+export declare const MAX_PAGE_ERRORS = 200;
+/**
+ * Filter console messages by minimum severity level.
+ */
+export declare function filterConsoleMessages(messages: BrowserConsoleMessage[], level?: string): BrowserConsoleMessage[];
+/**
+ * Filter network requests by URL substring match.
+ */
+export declare function filterNetworkRequests(requests: BrowserNetworkRequest[], filter?: string): BrowserNetworkRequest[];
+/**
+ * Format console messages for tool output.
+ */
+export declare function formatConsoleMessages(messages: BrowserConsoleMessage[]): string;
+/**
+ * Format network requests for tool output.
+ */
+export declare function formatNetworkRequests(requests: BrowserNetworkRequest[]): string;
+/**
+ * Format page errors for tool output.
+ */
+export declare function formatPageErrors(errors: BrowserPageError[]): string;
+//# sourceMappingURL=pw-responses.d.ts.map

package/dist/definitions/browser/pw-responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pw-responses.d.ts","sourceRoot":"","sources":["../../../src/definitions/browser/pw-responses.ts"],"names":[],"mappings":"AAIA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIjG,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,eAAe,MAAM,CAAC;AAoBnC;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,qBAAqB,EAAE,EACjC,KAAK,CAAC,EAAE,MAAM,GACb,qBAAqB,EAAE,CAMzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,qBAAqB,EAAE,EACjC,MAAM,CAAC,EAAE,MAAM,GACd,qBAAqB,EAAE,CAMzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAK/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAW/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAKnE"}

package/dist/definitions/browser/pw-responses.js

@@ -0,0 +1,77 @@
+// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
+// https://github.com/openclaw/openclaw
+// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
+// ── Circular buffer limits ────────────────────────────────────────────
+export const MAX_CONSOLE_MESSAGES = 500;
+export const MAX_NETWORK_REQUESTS = 500;
+export const MAX_PAGE_ERRORS = 200;
+// ── Console message filtering ─────────────────────────────────────────
+function consolePriority(level) {
+    switch (level) {
+        case "error":
+            return 3;
+        case "warning":
+            return 2;
+        case "info":
+        case "log":
+            return 1;
+        case "debug":
+            return 0;
+        default:
+            return 1;
+    }
+}
+/**
+ * Filter console messages by minimum severity level.
+ */
+export function filterConsoleMessages(messages, level) {
+    if (!level) {
+        return [...messages];
+    }
+    const min = consolePriority(level);
+    return messages.filter((msg) => consolePriority(msg.type) >= min);
+}
+/**
+ * Filter network requests by URL substring match.
+ */
+export function filterNetworkRequests(requests, filter) {
+    const pattern = typeof filter === "string" ? filter.trim() : "";
+    if (!pattern) {
+        return [...requests];
+    }
+    return requests.filter((r) => r.url.includes(pattern));
+}
+/**
+ * Format console messages for tool output.
+ */
+export function formatConsoleMessages(messages) {
+    if (!messages.length) {
+        return "No console messages captured.";
+    }
+    return messages.map((m) => `[${m.type.toUpperCase()}] ${m.text}`).join("\n");
+}
+/**
+ * Format network requests for tool output.
+ */
+export function formatNetworkRequests(requests) {
+    if (!requests.length) {
+        return "No network requests captured.";
+    }
+    return requests
+        .map((r) => {
+        const status = r.status !== undefined ? ` ${r.status}` : "";
+        const failure = r.failureText ? ` (FAILED: ${r.failureText})` : "";
+        return `${r.method}${status} ${r.url}${failure}`;
+    })
+        .join("\n");
+}
+/**
+ * Format page errors for tool output.
+ */
+export function formatPageErrors(errors) {
+    if (!errors.length) {
+        return "No page errors captured.";
+    }
+    return errors.map((e) => `${e.name ?? "Error"}: ${e.message}`).join("\n");
+}
+//# sourceMappingURL=pw-responses.js.map

package/dist/definitions/browser/pw-responses.js.map

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

package/dist/definitions/browser/pw-session.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Browser session lifecycle management.
+ * Unlike OpenClaw (which connects to an external Chrome via CDP), ARIA
+ * launches its own Playwright browser instance directly.
+ */
+import type { BrowserConsoleMessage, BrowserNetworkRequest, BrowserPageError, BrowserSession, PwBrowser, RoleRefMap } from "./types.js";
+export declare function getSession(): BrowserSession | null;
+export declare function getRefs(): RoleRefMap;
+export declare function setRefs(refs: RoleRefMap): void;
+export declare function getConsoleMessages(): BrowserConsoleMessage[];
+export declare function getNetworkRequests(): BrowserNetworkRequest[];
+export declare function getPageErrors(): BrowserPageError[];
+/**
+ * Test seam for injecting a mocked playwright loader.
+ * Passing null restores the production loader.
+ */
+export declare function setPlaywrightLoaderForTest(loader: (() => Promise<unknown>) | null): void;
+type ChromiumLike = {
+    launch: (options?: {
+        headless?: boolean;
+    }) => Promise<PwBrowser>;
+};
+/**
+ * Resolve Playwright's chromium launcher across module interop shapes.
+ * Some runtimes expose `{ chromium }`, others only `{ default: { chromium } }`.
+ */
+export declare function resolveChromiumLauncher(moduleValue: unknown): ChromiumLike;
+/**
+ * Launch a new Playwright browser session.
+ * Uses dynamic import so the tool module loads even without playwright installed.
+ */
+export declare function launchBrowser(options?: {
+    headless?: boolean;
+    url?: string;
+}): Promise<BrowserSession>;
+/**
+ * Close the current browser session and clean up all state.
+ */
+export declare function closeBrowser(): Promise<void>;
+/**
+ * List all open tabs (pages) in the current context.
+ */
+export declare function listTabs(): Array<{
+    index: number;
+    url: string;
+    active: boolean;
+}>;
+/**
+ * Open a new tab, optionally navigating to a URL.
+ */
+export declare function newTab(url?: string): Promise<{
+    index: number;
+    url: string;
+}>;
+/**
+ * Switch to a tab by index.
+ */
+export declare function selectTab(index: number): Promise<{
+    url: string;
+}>;
+/**
+ * Close a tab by index (defaults to current tab).
+ */
+export declare function closeTab(index?: number): Promise<void>;
+export {};
+//# sourceMappingURL=pw-session.d.ts.map

package/dist/definitions/browser/pw-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pw-session.d.ts","sourceRoot":"","sources":["../../../src/definitions/browser/pw-session.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,SAAS,EAGT,UAAU,EACX,MAAM,YAAY,CAAC;AAmBpB,wBAAgB,UAAU,IAAI,cAAc,GAAG,IAAI,CAElD;AAED,wBAAgB,OAAO,IAAI,UAAU,CAEpC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE9C;AAED,wBAAgB,kBAAkB,IAAI,qBAAqB,EAAE,CAE5D;AAED,wBAAgB,kBAAkB,IAAI,qBAAqB,EAAE,CAE5D;AAED,wBAAgB,aAAa,IAAI,gBAAgB,EAAE,CAElD;AAOD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAExF;AAyGD,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAClE,CAAC;AAUF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,YAAY,CAe1E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,cAAc,CAAC,CA2E1B;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBlD;AAID;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAUjF;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBlF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBvE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B5D"}