@vforsh/argus-watcher 0.1.2 → 0.1.4

package/dist/cdp/connection.js.map

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

package/dist/cdp/dom/fill.d.ts

@@ -0,0 +1,22 @@
+import type { CdpSessionHandle } from '../connection.js';
+/** Options for filling input/textarea/contenteditable elements. */
+export type FillElementsOptions = {
+    selector: string;
+    value: string;
+    all?: boolean;
+    text?: string;
+};
+/** Result of fillElements operation. */
+export type FillElementsResult = {
+    allNodeIds: number[];
+    filledCount: number;
+};
+/** Fill pre-resolved node IDs with a value. Skips selector resolution. */
+export declare const fillResolvedNodes: (session: CdpSessionHandle, nodeIds: number[], value: string) => Promise<number>;
+/**
+ * Fill input/textarea/contenteditable element(s) with a value.
+ * Uses the native setter trick to bypass framework property wrappers,
+ * then dispatches input + change events so React/Vue/Angular detect the change.
+ */
+export declare const fillElements: (session: CdpSessionHandle, options: FillElementsOptions) => Promise<FillElementsResult>;
+//# sourceMappingURL=fill.d.ts.map

package/dist/cdp/dom/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGxD,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA;AA6BD,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,GAAU,SAAS,gBAAgB,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,CAkBnH,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAU,SAAS,gBAAgB,EAAE,SAAS,mBAAmB,KAAG,OAAO,CAAC,kBAAkB,CAQtH,CAAA"}

package/dist/cdp/dom/fill.js

@@ -0,0 +1,59 @@
+import { getDomRootId, resolveSelectorMatches } from './selector.js';
+/**
+ * Browser-context function that sets the element value using the native
+ * prototype setter (to bypass React/Vue/Angular property wrappers) and
+ * dispatches input + change events so framework change detection fires.
+ */
+const FILL_FUNCTION = `function(value) {
+	var el = this;
+	if (el.isContentEditable) {
+		el.focus();
+		el.textContent = value;
+		el.dispatchEvent(new Event('input', { bubbles: true }));
+		el.dispatchEvent(new Event('change', { bubbles: true }));
+		return;
+	}
+	var proto = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype
+		: el.tagName === 'SELECT' ? HTMLSelectElement.prototype
+		: HTMLInputElement.prototype;
+	var nativeSetter = Object.getOwnPropertyDescriptor(proto, 'value');
+	if (nativeSetter && nativeSetter.set) {
+		nativeSetter.set.call(el, value);
+	} else {
+		el.value = value;
+	}
+	el.dispatchEvent(new Event('input', { bubbles: true }));
+	el.dispatchEvent(new Event('change', { bubbles: true }));
+}`;
+/** Fill pre-resolved node IDs with a value. Skips selector resolution. */
+export const fillResolvedNodes = async (session, nodeIds, value) => {
+    if (nodeIds.length === 0)
+        return 0;
+    for (const nodeId of nodeIds) {
+        const resolved = (await session.sendAndWait('DOM.resolveNode', { nodeId }));
+        const objectId = resolved.object?.objectId;
+        if (!objectId)
+            continue;
+        await session.sendAndWait('Runtime.callFunctionOn', {
+            objectId,
+            functionDeclaration: FILL_FUNCTION,
+            arguments: [{ value }],
+            awaitPromise: false,
+            returnByValue: true,
+        });
+    }
+    return nodeIds.length;
+};
+/**
+ * Fill input/textarea/contenteditable element(s) with a value.
+ * Uses the native setter trick to bypass framework property wrappers,
+ * then dispatches input + change events so React/Vue/Angular detect the change.
+ */
+export const fillElements = async (session, options) => {
+    await session.sendAndWait('DOM.enable');
+    const rootId = await getDomRootId(session);
+    const { allNodeIds, nodeIds } = await resolveSelectorMatches(session, rootId, options.selector, options.all ?? false, options.text);
+    const filledCount = await fillResolvedNodes(session, nodeIds, options.value);
+    return { allNodeIds, filledCount };
+};
+//# sourceMappingURL=fill.js.map

package/dist/cdp/dom/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../src/cdp/dom/fill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAgBpE;;;;GAIG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;EAoBpB,CAAA;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAyB,EAAE,OAAiB,EAAE,KAAa,EAAmB,EAAE;IACvH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAuC,CAAA;QACjH,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;QAC1C,IAAI,CAAC,QAAQ;YAAE,SAAQ;QAEvB,MAAM,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE;YACnD,QAAQ;YACR,mBAAmB,EAAE,aAAa;YAClC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;YACtB,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,IAAI;SACnB,CAAC,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAA;AACtB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,OAAyB,EAAE,OAA4B,EAA+B,EAAE;IAC1H,MAAM,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAEvC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;IAC1C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnI,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC5E,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAA;AACnC,CAAC,CAAA"}

package/dist/cdp/dom/info.d.ts

@@ -0,0 +1,14 @@
+import type { DomInfoResponse } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from '../connection.js';
+/** Options for fetching DOM element info by selector. */
+export type FetchDomInfoOptions = {
+    selector: string;
+    all?: boolean;
+    outerHtmlMaxChars?: number;
+    text?: string;
+};
+/**
+ * Fetch detailed info for element(s) matching a CSS selector.
+ */
+export declare const fetchDomInfoBySelector: (session: CdpSessionHandle, options: FetchDomInfoOptions) => Promise<DomInfoResponse>;
+//# sourceMappingURL=info.d.ts.map

package/dist/cdp/dom/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAWxD,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAU,SAAS,gBAAgB,EAAE,SAAS,mBAAmB,KAAG,OAAO,CAAC,eAAe,CAuD7H,CAAA"}

package/dist/cdp/dom/info.js

@@ -0,0 +1,52 @@
+import { getDomRootId, resolveSelectorMatches, toAttributesRecord, countElementChildren, clamp } from './selector.js';
+const DEFAULT_OUTER_HTML_MAX_CHARS = 50_000;
+const MAX_OUTER_HTML_CHARS = 500_000;
+/**
+ * Fetch detailed info for element(s) matching a CSS selector.
+ */
+export const fetchDomInfoBySelector = async (session, options) => {
+    const all = options.all ?? false;
+    const maxChars = clamp(options.outerHtmlMaxChars ?? DEFAULT_OUTER_HTML_MAX_CHARS, 0, MAX_OUTER_HTML_CHARS);
+    await session.sendAndWait('DOM.enable');
+    const rootId = await getDomRootId(session);
+    const { allNodeIds, nodeIds } = await resolveSelectorMatches(session, rootId, options.selector, all, options.text);
+    if (allNodeIds.length === 0) {
+        return { ok: true, matches: 0, elements: [] };
+    }
+    const elements = [];
+    for (const nodeId of nodeIds) {
+        const describeResult = (await session.sendAndWait('DOM.describeNode', {
+            nodeId,
+            depth: 1, // Just enough to get child count
+        }));
+        if (!describeResult.node) {
+            continue;
+        }
+        const node = describeResult.node;
+        const attributes = toAttributesRecord(node.attributes);
+        const childElementCount = countElementChildren(node.children);
+        let outerHTML = null;
+        let outerHTMLTruncated = false;
+        try {
+            const htmlResult = (await session.sendAndWait('DOM.getOuterHTML', { nodeId }));
+            outerHTML = htmlResult.outerHTML ?? null;
+            if (outerHTML && outerHTML.length > maxChars) {
+                outerHTML = outerHTML.slice(0, maxChars);
+                outerHTMLTruncated = true;
+            }
+        }
+        catch {
+            // getOuterHTML can fail for certain nodes; leave as null
+        }
+        elements.push({
+            nodeId,
+            tag: (node.localName ?? node.nodeName).toLowerCase(),
+            attributes,
+            childElementCount,
+            outerHTML,
+            outerHTMLTruncated,
+        });
+    }
+    return { ok: true, matches: allNodeIds.length, elements };
+};
+//# sourceMappingURL=info.js.map

package/dist/cdp/dom/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../src/cdp/dom/info.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAErH,MAAM,4BAA4B,GAAG,MAAM,CAAA;AAC3C,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAcpC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,OAAyB,EAAE,OAA4B,EAA4B,EAAE;IACjI,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,KAAK,CAAA;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,IAAI,4BAA4B,EAAE,CAAC,EAAE,oBAAoB,CAAC,CAAA;IAE1G,MAAM,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAEvC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;IAC1C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAElH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAqB,EAAE,CAAA;IAErC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE;YACrE,MAAM;YACN,KAAK,EAAE,CAAC,EAAE,iCAAiC;SAC3C,CAAC,CAAsB,CAAA;QAExB,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAC1B,SAAQ;QACT,CAAC;QAED,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAA;QAChC,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACtD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAE7D,IAAI,SAAS,GAAkB,IAAI,CAAA;QACnC,IAAI,kBAAkB,GAAG,KAAK,CAAA;QAE9B,IAAI,CAAC;YACJ,MAAM,UAAU,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAuB,CAAA;YACpG,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,IAAI,CAAA;YAExC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;gBAC9C,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;gBACxC,kBAAkB,GAAG,IAAI,CAAA;YAC1B,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,yDAAyD;QAC1D,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACb,MAAM;YACN,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;YACpD,UAAU;YACV,iBAAiB;YACjB,SAAS;YACT,kBAAkB;SAClB,CAAC,CAAA;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC1D,CAAC,CAAA"}

package/dist/cdp/dom/insert.d.ts

@@ -0,0 +1,19 @@
+import type { DomInsertPosition } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from '../connection.js';
+/** Options for inserting HTML adjacent to matched elements. */
+export type InsertAdjacentHtmlOptions = {
+    nodeIds: number[];
+    html: string;
+    position?: DomInsertPosition;
+    text?: boolean;
+};
+/** Result of insertAdjacentHtml operation. */
+export type InsertAdjacentHtmlResult = {
+    insertedCount: number;
+};
+/**
+ * Insert HTML adjacent to element(s) matching a CSS selector.
+ * Uses insertAdjacentHTML on each matched element.
+ */
+export declare const insertAdjacentHtml: (session: CdpSessionHandle, options: InsertAdjacentHtmlOptions) => Promise<InsertAdjacentHtmlResult>;
+//# sourceMappingURL=insert.d.ts.map

package/dist/cdp/dom/insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/insert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,+DAA+D;AAC/D,MAAM,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,wBAAwB,GAAG;IACtC,aAAa,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAU,SAAS,gBAAgB,EAAE,SAAS,yBAAyB,KAAG,OAAO,CAAC,wBAAwB,CA6BxI,CAAA"}

package/dist/cdp/dom/insert.js

@@ -0,0 +1,30 @@
+/**
+ * Insert HTML adjacent to element(s) matching a CSS selector.
+ * Uses insertAdjacentHTML on each matched element.
+ */
+export const insertAdjacentHtml = async (session, options) => {
+    await session.sendAndWait('DOM.enable');
+    if (options.nodeIds.length === 0) {
+        return { insertedCount: 0 };
+    }
+    const position = options.position ?? 'beforeend';
+    const functionDeclaration = options.text
+        ? 'function(pos, value) { this.insertAdjacentText(pos, value); }'
+        : 'function(pos, html) { this.insertAdjacentHTML(pos, html); }';
+    for (const nodeId of options.nodeIds) {
+        const resolved = (await session.sendAndWait('DOM.resolveNode', { nodeId }));
+        const objectId = resolved.object?.objectId;
+        if (!objectId) {
+            continue;
+        }
+        await session.sendAndWait('Runtime.callFunctionOn', {
+            objectId,
+            functionDeclaration,
+            arguments: [{ value: position }, { value: options.html }],
+            awaitPromise: false,
+            returnByValue: true,
+        });
+    }
+    return { insertedCount: options.nodeIds.length };
+};
+//# sourceMappingURL=insert.js.map

package/dist/cdp/dom/insert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert.js","sourceRoot":"","sources":["../../../src/cdp/dom/insert.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,OAAyB,EAAE,OAAkC,EAAqC,EAAE;IAC5I,MAAM,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAEvC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,CAAA;IAC5B,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,WAAW,CAAA;IAChD,MAAM,mBAAmB,GAAG,OAAO,CAAC,IAAI;QACvC,CAAC,CAAC,+DAA+D;QACjE,CAAC,CAAC,6DAA6D,CAAA;IAEhE,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAuC,CAAA;QACjH,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,SAAQ;QACT,CAAC;QAED,MAAM,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE;YACnD,QAAQ;YACR,mBAAmB;YACnB,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YACzD,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,IAAI;SACnB,CAAC,CAAA;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;AACjD,CAAC,CAAA"}

package/dist/cdp/dom/modify.d.ts

@@ -0,0 +1,50 @@
+import type { CdpSessionHandle } from '../connection.js';
+/** Base options for modifying matched elements. */
+type ModifyElementsBaseOptions = {
+    selector: string;
+    all?: boolean;
+    text?: string;
+};
+/** Attribute modification options. */
+type ModifyAttrOptions = ModifyElementsBaseOptions & {
+    type: 'attr';
+    set?: Record<string, string | true>;
+    remove?: string[];
+};
+/** Class modification options. */
+type ModifyClassOptions = ModifyElementsBaseOptions & {
+    type: 'class';
+    add?: string[];
+    remove?: string[];
+    toggle?: string[];
+};
+/** Style modification options. */
+type ModifyStyleOptions = ModifyElementsBaseOptions & {
+    type: 'style';
+    set?: Record<string, string>;
+    remove?: string[];
+};
+/** Text content modification options. */
+type ModifyTextOptions = ModifyElementsBaseOptions & {
+    type: 'text';
+    value: string;
+};
+/** HTML content modification options. */
+type ModifyHtmlOptions = ModifyElementsBaseOptions & {
+    type: 'html';
+    value: string;
+};
+/** Options for modifying matched elements. */
+export type ModifyElementsOptions = ModifyAttrOptions | ModifyClassOptions | ModifyStyleOptions | ModifyTextOptions | ModifyHtmlOptions;
+/** Result of modifyElements operation. */
+export type ModifyElementsResult = {
+    allNodeIds: number[];
+    modifiedCount: number;
+};
+/**
+ * Modify element(s) matching a CSS selector.
+ * Supports attribute, class, style, text, and HTML modifications.
+ */
+export declare const modifyElements: (session: CdpSessionHandle, options: ModifyElementsOptions) => Promise<ModifyElementsResult>;
+export {};
+//# sourceMappingURL=modify.d.ts.map

package/dist/cdp/dom/modify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modify.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/modify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAOxD,mDAAmD;AACnD,KAAK,yBAAyB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,sCAAsC;AACtC,KAAK,iBAAiB,GAAG,yBAAyB,GAAG;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,kCAAkC;AAClC,KAAK,kBAAkB,GAAG,yBAAyB,GAAG;IACrD,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,kCAAkC;AAClC,KAAK,kBAAkB,GAAG,yBAAyB,GAAG;IACrD,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,yCAAyC;AACzC,KAAK,iBAAiB,GAAG,yBAAyB,GAAG;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,yCAAyC;AACzC,KAAK,iBAAiB,GAAG,yBAAyB,GAAG;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,iBAAiB,CAAA;AAEvI,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACrB,CAAA;AAMD;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,gBAAgB,EAAE,SAAS,qBAAqB,KAAG,OAAO,CAAC,oBAAoB,CA6B5H,CAAA"}

package/dist/cdp/dom/modify.js

@@ -0,0 +1,100 @@
+import { getDomRootId, resolveSelectorMatches } from './selector.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Modify element(s) matching a CSS selector.
+ * Supports attribute, class, style, text, and HTML modifications.
+ */
+export const modifyElements = async (session, options) => {
+    await session.sendAndWait('DOM.enable');
+    const rootId = await getDomRootId(session);
+    const { allNodeIds, nodeIds } = await resolveSelectorMatches(session, rootId, options.selector, options.all ?? false, options.text);
+    if (nodeIds.length === 0) {
+        return { allNodeIds, modifiedCount: 0 };
+    }
+    const fn = buildModifyFunction(options);
+    for (const nodeId of nodeIds) {
+        const resolved = (await session.sendAndWait('DOM.resolveNode', { nodeId }));
+        const objectId = resolved.object?.objectId;
+        if (!objectId) {
+            continue;
+        }
+        await session.sendAndWait('Runtime.callFunctionOn', {
+            objectId,
+            functionDeclaration: fn.code,
+            arguments: fn.args,
+            awaitPromise: false,
+            returnByValue: true,
+        });
+    }
+    return { allNodeIds, modifiedCount: nodeIds.length };
+};
+const buildModifyFunction = (options) => {
+    switch (options.type) {
+        case 'attr':
+            return {
+                code: `function(toSet, toRemove) {
+					if (toSet) {
+						for (const [name, value] of Object.entries(toSet)) {
+							if (value === true) {
+								this.setAttribute(name, '');
+							} else {
+								this.setAttribute(name, value);
+							}
+						}
+					}
+					if (toRemove) {
+						for (const name of toRemove) {
+							this.removeAttribute(name);
+						}
+					}
+				}`,
+                args: [{ value: options.set ?? null }, { value: options.remove ?? null }],
+            };
+        case 'class':
+            return {
+                code: `function(toAdd, toRemove, toToggle) {
+					if (toAdd) {
+						this.classList.add(...toAdd);
+					}
+					if (toRemove) {
+						this.classList.remove(...toRemove);
+					}
+					if (toToggle) {
+						for (const cls of toToggle) {
+							this.classList.toggle(cls);
+						}
+					}
+				}`,
+                args: [{ value: options.add ?? null }, { value: options.remove ?? null }, { value: options.toggle ?? null }],
+            };
+        case 'style':
+            return {
+                code: `function(toSet, toRemove) {
+					if (toSet) {
+						for (const [prop, value] of Object.entries(toSet)) {
+							this.style.setProperty(prop, value);
+						}
+					}
+					if (toRemove) {
+						for (const prop of toRemove) {
+							this.style.removeProperty(prop);
+						}
+					}
+				}`,
+                args: [{ value: options.set ?? null }, { value: options.remove ?? null }],
+            };
+        case 'text':
+            return {
+                code: `function(value) { this.textContent = value; }`,
+                args: [{ value: options.value }],
+            };
+        case 'html':
+            return {
+                code: `function(value) { this.innerHTML = value; }`,
+                args: [{ value: options.value }],
+            };
+    }
+};
+//# sourceMappingURL=modify.js.map

package/dist/cdp/dom/modify.js.map

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

package/dist/cdp/dom/remove.d.ts

@@ -0,0 +1,17 @@
+import type { CdpSessionHandle } from '../connection.js';
+/** Options for removing matched elements. */
+export type RemoveElementsOptions = {
+    selector: string;
+    all?: boolean;
+    text?: string;
+};
+/** Result of removeElements operation. */
+export type RemoveElementsResult = {
+    allNodeIds: number[];
+    removedCount: number;
+};
+/**
+ * Remove element(s) matching a CSS selector from the DOM.
+ */
+export declare const removeElements: (session: CdpSessionHandle, options: RemoveElementsOptions) => Promise<RemoveElementsResult>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/cdp/dom/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/remove.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGxD,6CAA6C;AAC7C,MAAM,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,gBAAgB,EAAE,SAAS,qBAAqB,KAAG,OAAO,CAAC,oBAAoB,CA0B5H,CAAA"}

package/dist/cdp/dom/remove.js

@@ -0,0 +1,27 @@
+import { getDomRootId, resolveSelectorMatches } from './selector.js';
+/**
+ * Remove element(s) matching a CSS selector from the DOM.
+ */
+export const removeElements = async (session, options) => {
+    await session.sendAndWait('DOM.enable');
+    const rootId = await getDomRootId(session);
+    const { allNodeIds, nodeIds } = await resolveSelectorMatches(session, rootId, options.selector, options.all ?? false, options.text);
+    if (nodeIds.length === 0) {
+        return { allNodeIds, removedCount: 0 };
+    }
+    for (const nodeId of nodeIds) {
+        const resolved = (await session.sendAndWait('DOM.resolveNode', { nodeId }));
+        const objectId = resolved.object?.objectId;
+        if (!objectId) {
+            continue;
+        }
+        await session.sendAndWait('Runtime.callFunctionOn', {
+            objectId,
+            functionDeclaration: 'function() { this.remove(); }',
+            awaitPromise: false,
+            returnByValue: true,
+        });
+    }
+    return { allNodeIds, removedCount: nodeIds.length };
+};
+//# sourceMappingURL=remove.js.map

package/dist/cdp/dom/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../src/cdp/dom/remove.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAepE;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAyB,EAAE,OAA8B,EAAiC,EAAE;IAChI,MAAM,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAEvC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;IAC1C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,EAAE,CAAA;IACvC,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAuC,CAAA;QACjH,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,SAAQ;QACT,CAAC;QAED,MAAM,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE;YACnD,QAAQ;YACR,mBAAmB,EAAE,+BAA+B;YACpD,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,IAAI;SACnB,CAAC,CAAA;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAA;AACpD,CAAC,CAAA"}

package/dist/cdp/dom/selector.d.ts

@@ -0,0 +1,19 @@
+import type { CdpNode } from './types.js';
+import type { CdpSessionHandle } from '../connection.js';
+export type SelectorMatchResult = {
+    /** All matched node IDs. */
+    allNodeIds: number[];
+    /** Node IDs to process (respects `all` flag). */
+    nodeIds: number[];
+};
+export declare const getDomRootId: (session: CdpSessionHandle) => Promise<number>;
+export declare const resolveSelectorMatches: (session: CdpSessionHandle, rootId: number, selector: string, all: boolean, text?: string) => Promise<SelectorMatchResult>;
+/**
+ * Poll for selector matches until at least one is found or the deadline is reached.
+ * Returns the last resolution result (which may have zero matches on timeout).
+ */
+export declare const waitForSelectorMatches: (session: CdpSessionHandle, selector: string, all: boolean, text: string | undefined, waitMs: number, intervalMs?: number) => Promise<SelectorMatchResult>;
+export declare const toAttributesRecord: (attributes?: string[]) => Record<string, string>;
+export declare const countElementChildren: (children?: CdpNode[]) => number;
+export declare const clamp: (value: number, min: number, max: number) => number;
+//# sourceMappingURL=selector.d.ts.map

package/dist/cdp/dom/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAmBxD,MAAM,MAAM,mBAAmB,GAAG;IACjC,4BAA4B;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,eAAO,MAAM,YAAY,GAAU,SAAS,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAkC5E,CAAA;AAED,eAAO,MAAM,sBAAsB,GAClC,SAAS,gBAAgB,EACzB,QAAQ,MAAM,EACd,UAAU,MAAM,EAChB,KAAK,OAAO,EACZ,OAAO,MAAM,KACX,OAAO,CAAC,mBAAmB,CAa7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAClC,SAAS,gBAAgB,EACzB,UAAU,MAAM,EAChB,KAAK,OAAO,EACZ,MAAM,MAAM,GAAG,SAAS,EACxB,QAAQ,MAAM,EACd,mBAAgB,KACd,OAAO,CAAC,mBAAmB,CAU7B,CAAA;AAMD,eAAO,MAAM,kBAAkB,GAAI,aAAa,MAAM,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAc/E,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,WAAW,OAAO,EAAE,KAAG,MAK3D,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAE/D,CAAA"}

package/dist/cdp/dom/selector.js

@@ -0,0 +1,86 @@
+import { filterNodesByText } from '../text-filter.js';
+export const getDomRootId = async (session) => {
+    const targetContext = session.getTargetContext?.();
+    if (targetContext?.kind === 'frame') {
+        // Extension mode keeps one tab-level debugger session and switches the active frame via
+        // executionContextId. Resolving `document` in that context gives us the right DOM root.
+        if (targetContext.executionContextId == null) {
+            throw new Error(`Selected frame is not ready yet: ${targetContext.frameId}`);
+        }
+        const evaluated = (await session.sendAndWait('Runtime.evaluate', {
+            expression: 'document',
+            contextId: targetContext.executionContextId,
+            returnByValue: false,
+        }));
+        const objectId = evaluated.result?.objectId;
+        if (!objectId) {
+            throw new Error(`Unable to resolve document root for frame: ${targetContext.frameId}`);
+        }
+        const requested = (await session.sendAndWait('DOM.requestNode', { objectId }));
+        if (!requested.nodeId) {
+            throw new Error(`Unable to resolve DOM root for frame: ${targetContext.frameId}`);
+        }
+        return requested.nodeId;
+    }
+    const result = (await session.sendAndWait('DOM.getDocument', { depth: 1 }));
+    const rootId = result.root?.nodeId;
+    if (!rootId) {
+        throw new Error('Unable to resolve DOM root');
+    }
+    return rootId;
+};
+export const resolveSelectorMatches = async (session, rootId, selector, all, text) => {
+    // Always use querySelectorAll to get the true match count
+    const result = (await session.sendAndWait('DOM.querySelectorAll', { nodeId: rootId, selector }));
+    let allNodeIds = result.nodeIds ?? [];
+    if (text != null) {
+        allNodeIds = await filterNodesByText(session, allNodeIds, text);
+    }
+    // If all=false, only return the first match (if any)
+    const nodeIds = all ? allNodeIds : allNodeIds.slice(0, 1);
+    return { allNodeIds, nodeIds };
+};
+/**
+ * Poll for selector matches until at least one is found or the deadline is reached.
+ * Returns the last resolution result (which may have zero matches on timeout).
+ */
+export const waitForSelectorMatches = async (session, selector, all, text, waitMs, intervalMs = 100) => {
+    const deadline = Date.now() + waitMs;
+    while (true) {
+        const rootId = await getDomRootId(session);
+        const result = await resolveSelectorMatches(session, rootId, selector, all, text);
+        if (result.allNodeIds.length > 0)
+            return result;
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            return result;
+        await new Promise((r) => setTimeout(r, Math.min(intervalMs, remaining)));
+    }
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Shared helpers
+// ─────────────────────────────────────────────────────────────────────────────
+export const toAttributesRecord = (attributes) => {
+    if (!attributes || attributes.length === 0) {
+        return {};
+    }
+    const record = {};
+    for (let i = 0; i < attributes.length; i += 2) {
+        const key = attributes[i];
+        const value = attributes[i + 1] ?? '';
+        if (key) {
+            record[key] = value;
+        }
+    }
+    return record;
+};
+export const countElementChildren = (children) => {
+    if (!children) {
+        return 0;
+    }
+    return children.filter((c) => c.nodeType === 1).length;
+};
+export const clamp = (value, min, max) => {
+    return Math.max(min, Math.min(max, value));
+};
+//# sourceMappingURL=selector.js.map

package/dist/cdp/dom/selector.js.map

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

package/dist/cdp/dom/setFile.d.ts

@@ -0,0 +1,21 @@
+import type { CdpSessionHandle } from '../connection.js';
+/** Options for setting files on file input elements. */
+export type SetFileInputFilesOptions = {
+    selector: string;
+    files: string[];
+    all?: boolean;
+    text?: string;
+};
+/** Result of setFileInputFiles operation. */
+export type SetFileInputFilesResult = {
+    allNodeIds: number[];
+    updatedCount: number;
+};
+/** Set files on pre-resolved node IDs. Skips selector resolution. */
+export declare const setFileOnResolvedNodes: (session: CdpSessionHandle, nodeIds: number[], files: string[]) => Promise<number>;
+/**
+ * Set files on `<input type="file">` element(s) matching a CSS selector.
+ * Uses CDP's `DOM.setFileInputFiles` which reads files directly from disk.
+ */
+export declare const setFileInputFiles: (session: CdpSessionHandle, options: SetFileInputFilesOptions) => Promise<SetFileInputFilesResult>;
+//# sourceMappingURL=setFile.d.ts.map

package/dist/cdp/dom/setFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setFile.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/setFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGxD,wDAAwD;AACxD,MAAM,MAAM,wBAAwB,GAAG;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,uBAAuB,GAAG;IACrC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,GAAU,SAAS,gBAAgB,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CAW1H,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAU,SAAS,gBAAgB,EAAE,SAAS,wBAAwB,KAAG,OAAO,CAAC,uBAAuB,CAQrI,CAAA"}

package/dist/cdp/dom/setFile.js

@@ -0,0 +1,25 @@
+import { getDomRootId, resolveSelectorMatches } from './selector.js';
+/** Set files on pre-resolved node IDs. Skips selector resolution. */
+export const setFileOnResolvedNodes = async (session, nodeIds, files) => {
+    if (nodeIds.length === 0)
+        return 0;
+    for (const nodeId of nodeIds) {
+        await session.sendAndWait('DOM.setFileInputFiles', {
+            files,
+            nodeId,
+        });
+    }
+    return nodeIds.length;
+};
+/**
+ * Set files on `<input type="file">` element(s) matching a CSS selector.
+ * Uses CDP's `DOM.setFileInputFiles` which reads files directly from disk.
+ */
+export const setFileInputFiles = async (session, options) => {
+    await session.sendAndWait('DOM.enable');
+    const rootId = await getDomRootId(session);
+    const { allNodeIds, nodeIds } = await resolveSelectorMatches(session, rootId, options.selector, options.all ?? false, options.text);
+    const updatedCount = await setFileOnResolvedNodes(session, nodeIds, options.files);
+    return { allNodeIds, updatedCount };
+};
+//# sourceMappingURL=setFile.js.map

package/dist/cdp/dom/setFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setFile.js","sourceRoot":"","sources":["../../../src/cdp/dom/setFile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAgBpE,qEAAqE;AACrE,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,OAAyB,EAAE,OAAiB,EAAE,KAAe,EAAmB,EAAE;IAC9H,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE;YAClD,KAAK;YACL,MAAM;SACN,CAAC,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAA;AACtB,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAyB,EAAE,OAAiC,EAAoC,EAAE;IACzI,MAAM,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAEvC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;IAC1C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnI,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAClF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAA;AACpC,CAAC,CAAA"}