@vforsh/argus-watcher 0.1.2 → 0.1.3

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

@@ -0,0 +1,15 @@
+import type { CdpSessionHandle } from '../connection.js';
+export type SubmitElementsOptions = {
+    selector: string;
+    all?: boolean;
+    text?: string;
+    wait?: number;
+    strategy?: 'auto' | 'form' | 'self';
+};
+export type SubmitElementsResult = {
+    allNodeIds: number[];
+    submittedCount: number;
+};
+export declare const submitResolvedNodes: (session: CdpSessionHandle, nodeIds: number[], strategy: "auto" | "form" | "self") => Promise<number>;
+export declare const submitElements: (session: CdpSessionHandle, options: SubmitElementsOptions) => Promise<SubmitElementsResult>;
+//# sourceMappingURL=submit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAIxD,MAAM,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;CACtB,CAAA;AAkHD,eAAO,MAAM,mBAAmB,GAC/B,SAAS,gBAAgB,EACzB,SAAS,MAAM,EAAE,EACjB,UAAU,MAAM,GAAG,MAAM,GAAG,MAAM,KAChC,OAAO,CAAC,MAAM,CAchB,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,SAAS,gBAAgB,EAAE,SAAS,qBAAqB,KAAG,OAAO,CAAC,oBAAoB,CAY5H,CAAA"}

package/dist/cdp/dom/submit.js

@@ -0,0 +1,130 @@
+import { scrollIntoView } from '../mouse.js';
+import { getDomRootId, resolveSelectorMatches, waitForSelectorMatches } from './selector.js';
+const SUBMIT_DECLARATION = `function(strategy) {
+	var target = this;
+
+	function isForm(el) {
+		return typeof HTMLFormElement !== 'undefined' && el instanceof HTMLFormElement;
+	}
+
+	function resolveForm(el) {
+		if (!el) {
+			return null;
+		}
+		if (isForm(el)) {
+			return el;
+		}
+		if (el.form) {
+			return el.form;
+		}
+		if (typeof el.closest === 'function') {
+			return el.closest('form');
+		}
+		return null;
+	}
+
+	function resolveSubmitter(el, form) {
+		if (!el || !form || isForm(el)) {
+			return undefined;
+		}
+		if (
+			typeof HTMLElement !== 'undefined'
+			&& el instanceof HTMLElement
+			&& el.form === form
+			&& (
+				(typeof HTMLButtonElement !== 'undefined' && el instanceof HTMLButtonElement)
+				|| (
+					typeof HTMLInputElement !== 'undefined'
+					&& el instanceof HTMLInputElement
+					&& (el.type === 'submit' || el.type === 'image')
+				)
+			)
+		) {
+			return el;
+		}
+		return undefined;
+	}
+
+	function submitElement(el, submitter) {
+		if (!el) {
+			return false;
+		}
+		if (typeof el.requestSubmit === 'function') {
+			try {
+				if (submitter !== undefined) {
+					el.requestSubmit(submitter);
+				} else {
+					el.requestSubmit();
+				}
+			} catch (_) {
+				el.requestSubmit();
+			}
+			return true;
+		}
+		if (typeof el.submit === 'function') {
+			el.submit();
+			return true;
+		}
+		var event = new Event('submit', { bubbles: true, cancelable: true });
+		el.dispatchEvent(event);
+		return true;
+	}
+
+	var nearestForm = resolveForm(target);
+	var submitter = resolveSubmitter(target, nearestForm);
+
+	if (strategy === 'form') {
+		return submitElement(nearestForm, submitter);
+	}
+
+	if (strategy === 'self') {
+		return submitElement(target);
+	}
+
+	if (submitElement(nearestForm, submitter)) {
+		return true;
+	}
+
+	return submitElement(target);
+}`;
+const submitResolvedNode = async (session, nodeId, strategy) => {
+    await scrollIntoView(session, nodeId);
+    const resolved = (await session.sendAndWait('DOM.resolveNode', { nodeId }));
+    const objectId = resolved.object?.objectId;
+    if (!objectId) {
+        return false;
+    }
+    const result = (await session.sendAndWait('Runtime.callFunctionOn', {
+        objectId,
+        functionDeclaration: SUBMIT_DECLARATION,
+        arguments: [{ value: strategy }],
+        awaitPromise: false,
+        returnByValue: true,
+    }));
+    return result.result?.value === true;
+};
+export const submitResolvedNodes = async (session, nodeIds, strategy) => {
+    if (nodeIds.length === 0) {
+        return 0;
+    }
+    let submittedCount = 0;
+    for (const nodeId of nodeIds) {
+        const ok = await submitResolvedNode(session, nodeId, strategy);
+        if (ok) {
+            submittedCount += 1;
+        }
+    }
+    return submittedCount;
+};
+export const submitElements = async (session, options) => {
+    await session.sendAndWait('DOM.enable');
+    const all = options.all ?? false;
+    const waitMs = options.wait ?? 0;
+    const strategy = options.strategy ?? 'auto';
+    const result = waitMs > 0
+        ? await waitForSelectorMatches(session, options.selector, all, options.text, waitMs)
+        : await resolveSelectorMatches(session, await getDomRootId(session), options.selector, all, options.text);
+    const submittedCount = await submitResolvedNodes(session, result.nodeIds, strategy);
+    return { allNodeIds: result.allNodeIds, submittedCount };
+};
+//# sourceMappingURL=submit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submit.js","sourceRoot":"","sources":["../../../src/cdp/dom/submit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAe5F,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsFzB,CAAA;AAEF,MAAM,kBAAkB,GAAG,KAAK,EAC/B,OAAyB,EACzB,MAAc,EACd,QAAkC,EACf,EAAE;IACrB,MAAM,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAErC,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAuC,CAAA;IACjH,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,KAAK,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE;QACnE,QAAQ;QACR,mBAAmB,EAAE,kBAAkB;QACvC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAChC,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,IAAI;KACnB,CAAC,CAAqC,CAAA;IAEvC,OAAO,MAAM,CAAC,MAAM,EAAE,KAAK,KAAK,IAAI,CAAA;AACrC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACvC,OAAyB,EACzB,OAAiB,EACjB,QAAkC,EAChB,EAAE;IACpB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAA;IACT,CAAC;IAED,IAAI,cAAc,GAAG,CAAC,CAAA;IACtB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC9D,IAAI,EAAE,EAAE,CAAC;YACR,cAAc,IAAI,CAAC,CAAA;QACpB,CAAC;IACF,CAAC;IAED,OAAO,cAAc,CAAA;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAyB,EAAE,OAA8B,EAAiC,EAAE;IAChI,MAAM,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,KAAK,CAAA;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAA;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAA;IAC3C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,MAAM,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QACpF,CAAC,CAAC,MAAM,sBAAsB,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1G,MAAM,cAAc,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IACnF,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,cAAc,EAAE,CAAA;AACzD,CAAC,CAAA"}

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

@@ -0,0 +1,16 @@
+import type { DomTreeResponse } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from '../connection.js';
+/** Options for fetching a DOM subtree by selector. */
+export type FetchDomTreeOptions = {
+    selector: string;
+    depth?: number;
+    maxNodes?: number;
+    all?: boolean;
+    text?: string;
+};
+/**
+ * Fetch a DOM subtree rooted at element(s) matching a CSS selector.
+ * Returns only element nodes (nodeType === 1).
+ */
+export declare const fetchDomSubtreeBySelector: (session: CdpSessionHandle, options: FetchDomTreeOptions) => Promise<DomTreeResponse>;
+//# sourceMappingURL=tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAUxD,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GAAU,SAAS,gBAAgB,EAAE,SAAS,mBAAmB,KAAG,OAAO,CAAC,eAAe,CA8ChI,CAAA"}

package/dist/cdp/dom/tree.js

@@ -0,0 +1,100 @@
+import { getDomRootId, resolveSelectorMatches, toAttributesRecord, clamp } from './selector.js';
+const DEFAULT_DEPTH = 2;
+const DEFAULT_MAX_NODES = 5000;
+const MAX_DEPTH = 10;
+const MAX_MAX_NODES = 50_000;
+/**
+ * Fetch a DOM subtree rooted at element(s) matching a CSS selector.
+ * Returns only element nodes (nodeType === 1).
+ */
+export const fetchDomSubtreeBySelector = async (session, options) => {
+    const depth = clamp(options.depth ?? DEFAULT_DEPTH, 0, MAX_DEPTH);
+    const maxNodes = clamp(options.maxNodes ?? DEFAULT_MAX_NODES, 1, MAX_MAX_NODES);
+    const all = options.all ?? false;
+    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, roots: [], truncated: false };
+    }
+    const state = { count: 0, maxNodes, truncated: false, truncatedReason: undefined };
+    const roots = [];
+    for (const nodeId of nodeIds) {
+        if (state.count >= maxNodes) {
+            state.truncated = true;
+            state.truncatedReason = 'max_nodes';
+            break;
+        }
+        const describeResult = (await session.sendAndWait('DOM.describeNode', {
+            nodeId,
+            depth: depth + 1, // CDP depth is from the queried node, so +1 to include that node
+        }));
+        if (!describeResult.node) {
+            continue;
+        }
+        const tree = toDomNodeTree(describeResult.node, depth, state);
+        if (tree) {
+            roots.push(tree);
+        }
+    }
+    return {
+        ok: true,
+        matches: allNodeIds.length,
+        roots,
+        truncated: state.truncated,
+        truncatedReason: state.truncatedReason,
+    };
+};
+const toDomNodeTree = (node, remainingDepth, state) => {
+    // Filter to element nodes only
+    if (node.nodeType !== 1) {
+        return null;
+    }
+    state.count++;
+    const result = {
+        nodeId: node.nodeId,
+        tag: (node.localName ?? node.nodeName).toLowerCase(),
+        attributes: toAttributesRecord(node.attributes),
+    };
+    // Check if we should descend further
+    if (remainingDepth <= 0) {
+        if (node.children && node.children.some((c) => c.nodeType === 1)) {
+            result.truncated = true;
+            state.truncated = true;
+            if (!state.truncatedReason) {
+                state.truncatedReason = 'depth';
+            }
+        }
+        return result;
+    }
+    // Check maxNodes limit
+    if (state.count >= state.maxNodes) {
+        if (node.children && node.children.some((c) => c.nodeType === 1)) {
+            result.truncated = true;
+            state.truncated = true;
+            state.truncatedReason = 'max_nodes';
+        }
+        return result;
+    }
+    // Process children
+    if (node.children && node.children.length > 0) {
+        const children = [];
+        for (const child of node.children) {
+            if (state.count >= state.maxNodes) {
+                result.truncated = true;
+                state.truncated = true;
+                state.truncatedReason = 'max_nodes';
+                break;
+            }
+            const childNode = toDomNodeTree(child, remainingDepth - 1, state);
+            if (childNode) {
+                children.push(childNode);
+            }
+        }
+        if (children.length > 0) {
+            result.children = children;
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=tree.js.map

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

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

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

@@ -0,0 +1,16 @@
+/** CDP node shape returned by DOM.describeNode. */
+export type CdpNode = {
+    nodeId: number;
+    backendNodeId?: number;
+    nodeType: number;
+    nodeName: string;
+    localName?: string;
+    attributes?: string[];
+    children?: CdpNode[];
+    childNodeCount?: number;
+};
+/** CDP result shape for DOM.describeNode. */
+export type CdpDescribeResult = {
+    node?: CdpNode;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cdp/dom/types.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA"}

package/dist/cdp/dom/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cdp/dom/types.ts"],"names":[],"mappings":""}

package/dist/cdp/dom.d.ts

@@ -0,0 +1,17 @@
+export { fetchDomSubtreeBySelector } from './dom/tree.js';
+export type { FetchDomTreeOptions } from './dom/tree.js';
+export { fetchDomInfoBySelector } from './dom/info.js';
+export type { FetchDomInfoOptions } from './dom/info.js';
+export { insertAdjacentHtml } from './dom/insert.js';
+export type { InsertAdjacentHtmlOptions, InsertAdjacentHtmlResult } from './dom/insert.js';
+export { removeElements } from './dom/remove.js';
+export type { RemoveElementsOptions, RemoveElementsResult } from './dom/remove.js';
+export { modifyElements } from './dom/modify.js';
+export type { ModifyElementsOptions, ModifyElementsResult } from './dom/modify.js';
+export { setFileInputFiles, setFileOnResolvedNodes } from './dom/setFile.js';
+export type { SetFileInputFilesOptions, SetFileInputFilesResult } from './dom/setFile.js';
+export { fillElements, fillResolvedNodes } from './dom/fill.js';
+export type { FillElementsOptions, FillElementsResult } from './dom/fill.js';
+export { submitElements, submitResolvedNodes } from './dom/submit.js';
+export type { SubmitElementsOptions, SubmitElementsResult } from './dom/submit.js';
+//# sourceMappingURL=dom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/cdp/dom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAE1F,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAElF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAElF,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAEzF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAC/D,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrE,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/cdp/dom.js

@@ -0,0 +1,10 @@
+// Re-export shim — keeps `../cdp/dom.js` imports stable across the HTTP layer.
+export { fetchDomSubtreeBySelector } from './dom/tree.js';
+export { fetchDomInfoBySelector } from './dom/info.js';
+export { insertAdjacentHtml } from './dom/insert.js';
+export { removeElements } from './dom/remove.js';
+export { modifyElements } from './dom/modify.js';
+export { setFileInputFiles, setFileOnResolvedNodes } from './dom/setFile.js';
+export { fillElements, fillResolvedNodes } from './dom/fill.js';
+export { submitElements, submitResolvedNodes } from './dom/submit.js';
+//# sourceMappingURL=dom.js.map

package/dist/cdp/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/cdp/dom.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AAGzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGpD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAG5E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAG/D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/cdp/emulation.d.ts

@@ -0,0 +1,16 @@
+import type { EmulationState } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from './connection.js';
+type Baseline = {
+    userAgent: string | null;
+};
+/**
+ * Apply the desired emulation state to a CDP session.
+ * Each aspect (viewport, touch, UA) is applied independently so partial failures don't block the rest.
+ */
+export declare const applyEmulation: (session: CdpSessionHandle, state: EmulationState, baseline: Baseline) => Promise<void>;
+/**
+ * Clear all emulation overrides, restoring the page to its default state.
+ */
+export declare const clearEmulation: (session: CdpSessionHandle, baseline: Baseline) => Promise<void>;
+export {};
+//# sourceMappingURL=emulation.d.ts.map

package/dist/cdp/emulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulation.d.ts","sourceRoot":"","sources":["../../src/cdp/emulation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,KAAK,QAAQ,GAAG;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAE5C;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,gBAAgB,EAAE,OAAO,cAAc,EAAE,UAAU,QAAQ,KAAG,OAAO,CAAC,IAAI,CAwBvH,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS,gBAAgB,EAAE,UAAU,QAAQ,KAAG,OAAO,CAAC,IAAI,CAOhG,CAAA"}

package/dist/cdp/emulation.js

@@ -0,0 +1,40 @@
+/**
+ * Apply the desired emulation state to a CDP session.
+ * Each aspect (viewport, touch, UA) is applied independently so partial failures don't block the rest.
+ */
+export const applyEmulation = async (session, state, baseline) => {
+    // Viewport / device metrics
+    if (state.viewport) {
+        await session.sendAndWait('Emulation.setDeviceMetricsOverride', {
+            width: state.viewport.width,
+            height: state.viewport.height,
+            deviceScaleFactor: state.viewport.deviceScaleFactor,
+            mobile: state.viewport.mobile,
+        });
+    }
+    else {
+        await session.sendAndWait('Emulation.clearDeviceMetricsOverride');
+    }
+    // Touch emulation
+    const touchEnabled = state.touch?.enabled ?? false;
+    await session.sendAndWait('Emulation.setTouchEmulationEnabled', { enabled: touchEnabled });
+    // User-agent override
+    if (state.userAgent?.value != null) {
+        await session.sendAndWait('Emulation.setUserAgentOverride', { userAgent: state.userAgent.value });
+    }
+    else if (baseline.userAgent) {
+        // Restore baseline UA (no "clear UA override" primitive exists)
+        await session.sendAndWait('Emulation.setUserAgentOverride', { userAgent: baseline.userAgent });
+    }
+};
+/**
+ * Clear all emulation overrides, restoring the page to its default state.
+ */
+export const clearEmulation = async (session, baseline) => {
+    await session.sendAndWait('Emulation.clearDeviceMetricsOverride');
+    await session.sendAndWait('Emulation.setTouchEmulationEnabled', { enabled: false });
+    if (baseline.userAgent) {
+        await session.sendAndWait('Emulation.setUserAgentOverride', { userAgent: baseline.userAgent });
+    }
+};
+//# sourceMappingURL=emulation.js.map

package/dist/cdp/emulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emulation.js","sourceRoot":"","sources":["../../src/cdp/emulation.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAyB,EAAE,KAAqB,EAAE,QAAkB,EAAiB,EAAE;IAC3H,4BAA4B;IAC5B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,OAAO,CAAC,WAAW,CAAC,oCAAoC,EAAE;YAC/D,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK;YAC3B,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;YAC7B,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,iBAAiB;YACnD,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;SAC7B,CAAC,CAAA;IACH,CAAC;SAAM,CAAC;QACP,MAAM,OAAO,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAA;IAClE,CAAC;IAED,kBAAkB;IAClB,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAA;IAClD,MAAM,OAAO,CAAC,WAAW,CAAC,oCAAoC,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAA;IAE1F,sBAAsB;IACtB,IAAI,KAAK,CAAC,SAAS,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAA;IAClG,CAAC;SAAM,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC/B,gEAAgE;QAChE,MAAM,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;IAC/F,CAAC;AACF,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAyB,EAAE,QAAkB,EAAiB,EAAE;IACpG,MAAM,OAAO,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAA;IACjE,MAAM,OAAO,CAAC,WAAW,CAAC,oCAAoC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IAEnF,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxB,MAAM,OAAO,CAAC,WAAW,CAAC,gCAAgC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;IAC/F,CAAC;AACF,CAAC,CAAA"}

package/dist/cdp/eval.d.ts

@@ -0,0 +1,10 @@
+import type { EvalResponse } from '@vforsh/argus-core';
+import type { CdpSessionHandle } from './connection.js';
+export type EvalRequestOptions = {
+    expression: string;
+    awaitPromise?: boolean;
+    returnByValue?: boolean;
+    timeoutMs?: number;
+};
+export declare const evaluateExpression: (session: CdpSessionHandle, options: EvalRequestOptions) => Promise<EvalResponse>;
+//# sourceMappingURL=eval.d.ts.map

package/dist/cdp/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/cdp/eval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGvD,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC9B,SAAS,gBAAgB,EACzB,SAAS,kBAAkB,KACzB,OAAO,CAAC,YAAY,CA0CtB,CAAA"}

package/dist/cdp/eval.js

@@ -0,0 +1,34 @@
+import { serializeRemoteObject } from './remoteObject.js';
+export const evaluateExpression = async (session, options) => {
+    const result = await session.sendAndWait('Runtime.evaluate', {
+        expression: options.expression,
+        awaitPromise: options.awaitPromise ?? true,
+        returnByValue: options.returnByValue ?? true,
+    }, { timeoutMs: options.timeoutMs });
+    const payload = result;
+    if (payload.exceptionDetails) {
+        return {
+            ok: true,
+            result: null,
+            type: payload.result?.type ?? null,
+            exception: {
+                text: payload.exceptionDetails.text ?? 'Exception',
+                details: payload.exceptionDetails.exception ?? null,
+            },
+        };
+    }
+    const record = payload.result;
+    let value = record?.value;
+    if (value === undefined && record) {
+        value = await serializeRemoteObject(record, {
+            sendAndWait: (method, params) => session.sendAndWait(method, params),
+        });
+    }
+    return {
+        ok: true,
+        result: value ?? null,
+        type: record?.type ?? null,
+        exception: null,
+    };
+};
+//# sourceMappingURL=eval.js.map

package/dist/cdp/eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../src/cdp/eval.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AASzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACtC,OAAyB,EACzB,OAA2B,EACH,EAAE;IAC1B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CACvC,kBAAkB,EAClB;QACC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;KAC5C,EACD,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAChC,CAAA;IAED,MAAM,OAAO,GAAG,MAGf,CAAA;IAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9B,OAAO;YACN,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI;YAClC,SAAS,EAAE;gBACV,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,IAAI,IAAI,WAAW;gBAClD,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,SAAS,IAAI,IAAI;aACnD;SACD,CAAA;IACF,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC7B,IAAI,KAAK,GAAY,MAAM,EAAE,KAAK,CAAA;IAClC,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,EAAE,CAAC;QACnC,KAAK,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE;YAC3C,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;SACpE,CAAC,CAAA;IACH,CAAC;IAED,OAAO;QACN,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,KAAK,IAAI,IAAI;QACrB,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI;QAC1B,SAAS,EAAE,IAAI;KACf,CAAA;AACF,CAAC,CAAA"}

package/dist/cdp/keyboard.d.ts

@@ -0,0 +1,38 @@
+import type { CdpSessionHandle } from './connection.js';
+type KeyDefinition = {
+    key: string;
+    code: string;
+    keyCode: number;
+    text?: string;
+};
+/**
+ * Resolve a key name to its CDP key definition.
+ * Lookup is case-insensitive.
+ */
+export declare const resolveKeyDefinition: (key: string) => KeyDefinition | undefined;
+/**
+ * Parse a comma-separated modifier string into a CDP bitmask.
+ * Accepts aliases: ctrl/control, meta/cmd/command.
+ * Returns 0 for undefined/empty input.
+ */
+export declare const parseModifiers: (input?: string) => number;
+export type DispatchKeydownOptions = {
+    key: string;
+    selector?: string;
+    modifiers?: number;
+};
+export type DispatchKeydownResult = {
+    key: string;
+    modifiers: number;
+    focused: boolean;
+};
+/**
+ * Dispatch a keyboard event sequence via CDP Input.dispatchKeyEvent.
+ *
+ * 1. If `selector` provided: resolve → error if 0 or >1 match → focus
+ * 2. Resolve key definition
+ * 3. Dispatch: printable → keyDown+char+keyUp; non-printable → rawKeyDown+keyUp
+ */
+export declare const dispatchKeydown: (session: CdpSessionHandle, options: DispatchKeydownOptions) => Promise<DispatchKeydownResult>;
+export {};
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/cdp/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/cdp/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAOvD,KAAK,aAAa,GAAG;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AA2DD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,aAAa,GAAG,SAElE,CAAA;AAiBD;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAoB/C,CAAA;AAMD,MAAM,MAAM,sBAAsB,GAAG;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,gBAAgB,EAAE,SAAS,sBAAsB,KAAG,OAAO,CAAC,qBAAqB,CAyD/H,CAAA"}