@vforsh/argus 0.1.7 → 0.1.8

package/dist/argus.js

@@ -5,15 +5,29 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
@@ -5211,16 +5225,72 @@ var buildModifyFunction = (options) => {
   }
 };
 // ../argus-watcher/dist/cdp/dom/setFile.js
+var DISPATCH_FILE_EVENTS_AND_GET_COUNT = `function() {
+	var el = this;
+	el.dispatchEvent(new Event('input', { bubbles: true }));
+	el.dispatchEvent(new Event('change', { bubbles: true }));
+	return el.files ? el.files.length : 0;
+}`;
+var getBackendNodeId = async (session, nodeId) => {
+  const described = await session.sendAndWait("DOM.describeNode", { nodeId });
+  return described.node?.backendNodeId ?? null;
+};
+var resolveObjectId = async (session, params) => {
+  const resolved = await session.sendAndWait("DOM.resolveNode", params);
+  return resolved.object?.objectId ?? null;
+};
+var trySetFiles = async (session, params, files) => {
+  try {
+    await session.sendAndWait("DOM.setFileInputFiles", {
+      files,
+      ...params
+    });
+    return true;
+  } catch {
+    return false;
+  }
+};
+var setFilesUsingStableNodeRef = async (session, nodeId, files) => {
+  const backendNodeId = await getBackendNodeId(session, nodeId);
+  const objectIdFromBackendNode = backendNodeId != null ? await resolveObjectId(session, { backendNodeId }) : null;
+  if (objectIdFromBackendNode != null && await trySetFiles(session, { objectId: objectIdFromBackendNode }, files)) {
+    return { backendNodeId, objectId: objectIdFromBackendNode };
+  }
+  if (backendNodeId != null && await trySetFiles(session, { backendNodeId }, files)) {
+    return { backendNodeId, objectId: objectIdFromBackendNode };
+  }
+  const objectIdFromNode = await resolveObjectId(session, { nodeId });
+  if (objectIdFromNode != null && await trySetFiles(session, { objectId: objectIdFromNode }, files)) {
+    return { backendNodeId, objectId: objectIdFromNode };
+  }
+  await session.sendAndWait("DOM.setFileInputFiles", { files, nodeId });
+  return { backendNodeId, objectId: objectIdFromNode };
+};
+var setFileOnResolvedNode = async (session, nodeId, files) => {
+  const { backendNodeId, objectId } = await setFilesUsingStableNodeRef(session, nodeId, files);
+  const resolvedObjectId = objectId ?? await resolveObjectId(session, backendNodeId != null ? { backendNodeId } : { nodeId });
+  if (!resolvedObjectId) {
+    return false;
+  }
+  const result = await session.sendAndWait("Runtime.callFunctionOn", {
+    objectId: resolvedObjectId,
+    functionDeclaration: DISPATCH_FILE_EVENTS_AND_GET_COUNT,
+    awaitPromise: false,
+    returnByValue: true
+  });
+  return typeof result.result?.value === "number" && result.result.value > 0;
+};
 var setFileOnResolvedNodes = async (session, nodeIds, files) => {
   if (nodeIds.length === 0)
     return 0;
+  let updatedCount = 0;
   for (const nodeId of nodeIds) {
-    await session.sendAndWait("DOM.setFileInputFiles", {
-      files,
-      nodeId
-    });
+    const ok = await setFileOnResolvedNode(session, nodeId, files);
+    if (ok) {
+      updatedCount += 1;
+    }
   }
-  return nodeIds.length;
+  return updatedCount;
 };
 // ../argus-watcher/dist/cdp/dom/fill.js
 var FILL_FUNCTION = `function(value) {
@@ -5262,79 +5332,6 @@ var fillResolvedNodes = async (session, nodeIds, value) => {
   }
   return nodeIds.length;
 };
-// ../argus-watcher/dist/http/routes/postDomTree.js
-var handle11 = async (req, res, _url, ctx) => {
-  const payload = await readJsonBody(req, res);
-  if (!payload) {
-    return;
-  }
-  if (!payload.selector || typeof payload.selector !== "string") {
-    return respondInvalidBody(res, "selector is required");
-  }
-  const all = payload.all ?? false;
-  if (typeof all !== "boolean") {
-    return respondInvalidBody(res, "all must be a boolean");
-  }
-  emitRequest(ctx, res, "dom/tree");
-  try {
-    const response = await fetchDomSubtreeBySelector(ctx.cdpSession, {
-      selector: payload.selector,
-      depth: payload.depth,
-      maxNodes: payload.maxNodes,
-      all,
-      text: payload.text
-    });
-    if (!all && response.matches > 1) {
-      return respondJson(res, {
-        ok: false,
-        error: {
-          message: `Selector matched ${response.matches} elements; pass all=true to return all matches`,
-          code: "multiple_matches"
-        }
-      }, 400);
-    }
-    respondJson(res, response);
-  } catch (error) {
-    respondError(res, error);
-  }
-};
-
-// ../argus-watcher/dist/http/routes/postDomInfo.js
-var handle12 = async (req, res, _url, ctx) => {
-  const payload = await readJsonBody(req, res);
-  if (!payload) {
-    return;
-  }
-  if (!payload.selector || typeof payload.selector !== "string") {
-    return respondInvalidBody(res, "selector is required");
-  }
-  const all = payload.all ?? false;
-  if (typeof all !== "boolean") {
-    return respondInvalidBody(res, "all must be a boolean");
-  }
-  emitRequest(ctx, res, "dom/info");
-  try {
-    const response = await fetchDomInfoBySelector(ctx.cdpSession, {
-      selector: payload.selector,
-      all,
-      outerHtmlMaxChars: payload.outerHtmlMaxChars,
-      text: payload.text
-    });
-    if (!all && response.matches > 1) {
-      return respondJson(res, {
-        ok: false,
-        error: {
-          message: `Selector matched ${response.matches} elements; pass all=true to return all matches`,
-          code: "multiple_matches"
-        }
-      }, 400);
-    }
-    respondJson(res, response);
-  } catch (error) {
-    respondError(res, error);
-  }
-};
-
 // ../argus-watcher/dist/cdp/mouse.js
 var resolveDomSelectorMatches = async (session, selector, all, text) => {
   await session.sendAndWait("DOM.enable");
@@ -5521,6 +5518,205 @@ var createNotInteractableError = (message) => {
   return error;
 };
 
+// ../argus-watcher/dist/cdp/dom/submit.js
+var 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);
+}`;
+var 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;
+};
+var 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;
+};
+var 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 };
+};
+// ../argus-watcher/dist/http/routes/postDomTree.js
+var handle11 = async (req, res, _url, ctx) => {
+  const payload = await readJsonBody(req, res);
+  if (!payload) {
+    return;
+  }
+  if (!payload.selector || typeof payload.selector !== "string") {
+    return respondInvalidBody(res, "selector is required");
+  }
+  const all = payload.all ?? false;
+  if (typeof all !== "boolean") {
+    return respondInvalidBody(res, "all must be a boolean");
+  }
+  emitRequest(ctx, res, "dom/tree");
+  try {
+    const response = await fetchDomSubtreeBySelector(ctx.cdpSession, {
+      selector: payload.selector,
+      depth: payload.depth,
+      maxNodes: payload.maxNodes,
+      all,
+      text: payload.text
+    });
+    if (!all && response.matches > 1) {
+      return respondJson(res, {
+        ok: false,
+        error: {
+          message: `Selector matched ${response.matches} elements; pass all=true to return all matches`,
+          code: "multiple_matches"
+        }
+      }, 400);
+    }
+    respondJson(res, response);
+  } catch (error) {
+    respondError(res, error);
+  }
+};
+
+// ../argus-watcher/dist/http/routes/postDomInfo.js
+var handle12 = async (req, res, _url, ctx) => {
+  const payload = await readJsonBody(req, res);
+  if (!payload) {
+    return;
+  }
+  if (!payload.selector || typeof payload.selector !== "string") {
+    return respondInvalidBody(res, "selector is required");
+  }
+  const all = payload.all ?? false;
+  if (typeof all !== "boolean") {
+    return respondInvalidBody(res, "all must be a boolean");
+  }
+  emitRequest(ctx, res, "dom/info");
+  try {
+    const response = await fetchDomInfoBySelector(ctx.cdpSession, {
+      selector: payload.selector,
+      all,
+      outerHtmlMaxChars: payload.outerHtmlMaxChars,
+      text: payload.text
+    });
+    if (!all && response.matches > 1) {
+      return respondJson(res, {
+        ok: false,
+        error: {
+          message: `Selector matched ${response.matches} elements; pass all=true to return all matches`,
+          code: "multiple_matches"
+        }
+      }, 400);
+    }
+    respondJson(res, response);
+  } catch (error) {
+    respondError(res, error);
+  }
+};
+
 // ../argus-watcher/dist/http/routes/postDomHover.js
 var handle13 = async (req, res, _url, ctx) => {
   const payload = await readJsonBody(req, res);
@@ -6001,6 +6197,15 @@ var handle19 = async (req, res, _url, ctx) => {
       }, 400);
     }
     const updatedCount = await setFileOnResolvedNodes(ctx.cdpSession, nodeIds, payload.files);
+    if (nodeIds.length > 0 && updatedCount === 0) {
+      return respondJson(res, {
+        ok: false,
+        error: {
+          message: "Matched file input element(s), but none accepted files after DOM.setFileInputFiles + input/change dispatch",
+          code: "set_file_failed"
+        }
+      }, 500);
+    }
     const response = { ok: true, matches: allNodeIds.length, updated: updatedCount };
     respondJson(res, response);
   } catch (error) {
@@ -6098,8 +6303,54 @@ var handle21 = async (req, res, _url, ctx) => {
   }
 };
 
-// ../argus-watcher/dist/http/routes/postDomScroll.js
+// ../argus-watcher/dist/http/routes/postDomSubmit.js
 var handle22 = async (req, res, _url, ctx) => {
+  const payload = await readJsonBody(req, res);
+  if (!payload) {
+    return;
+  }
+  if (!payload.selector || typeof payload.selector !== "string") {
+    return respondInvalidBody(res, "selector is required");
+  }
+  const all = payload.all ?? false;
+  if (typeof all !== "boolean") {
+    return respondInvalidBody(res, "all must be a boolean");
+  }
+  const waitMs = payload.wait ?? 0;
+  if (typeof waitMs !== "number" || !Number.isFinite(waitMs) || waitMs < 0) {
+    return respondInvalidBody(res, "wait must be a non-negative number (ms)");
+  }
+  const strategy = payload.strategy ?? "auto";
+  if (strategy !== "auto" && strategy !== "form" && strategy !== "self") {
+    return respondInvalidBody(res, "strategy must be one of: auto, form, self");
+  }
+  emitRequest(ctx, res, "dom/submit");
+  try {
+    const { allNodeIds, submittedCount } = await submitElements(ctx.cdpSession, {
+      selector: payload.selector,
+      all,
+      text: payload.text,
+      wait: waitMs,
+      strategy
+    });
+    if (!all && allNodeIds.length > 1) {
+      return respondJson(res, {
+        ok: false,
+        error: {
+          message: `Selector matched ${allNodeIds.length} elements; pass all=true to submit all matches`,
+          code: "multiple_matches"
+        }
+      }, 400);
+    }
+    const response = { ok: true, matches: allNodeIds.length, submitted: submittedCount };
+    respondJson(res, response);
+  } catch (error) {
+    respondError(res, error);
+  }
+};
+
+// ../argus-watcher/dist/http/routes/postDomScroll.js
+var handle23 = async (req, res, _url, ctx) => {
   const payload = await readJsonBody(req, res);
   if (!payload) {
     return;
@@ -6168,7 +6419,7 @@ var getViewportSize = async (session) => {
 };
 
 // ../argus-watcher/dist/http/routes/postDomScrollTo.js
-var handle23 = async (req, res, _url, ctx) => {
+var handle24 = async (req, res, _url, ctx) => {
   const payload = await readJsonBody(req, res);
   if (!payload) {
     return;
@@ -6227,14 +6478,14 @@ var handle23 = async (req, res, _url, ctx) => {
 };
 
 // ../argus-watcher/dist/http/routes/getEmulation.js
-var handle24 = (_req, res, _url, ctx) => {
+var handle25 = (_req, res, _url, ctx) => {
   emitRequest(ctx, res, "emulation");
   const status = ctx.emulationController.getStatus({ attached: ctx.getCdpStatus().attached });
   respondJson(res, status);
 };
 
 // ../argus-watcher/dist/http/routes/postEmulation.js
-var handle25 = async (req, res, _url, ctx) => {
+var handle26 = async (req, res, _url, ctx) => {
   const payload = await readJsonBody(req, res);
   if (!payload) {
     return;
@@ -6297,14 +6548,14 @@ var handle25 = async (req, res, _url, ctx) => {
 };
 
 // ../argus-watcher/dist/http/routes/getThrottle.js
-var handle26 = (_req, res, _url, ctx) => {
+var handle27 = (_req, res, _url, ctx) => {
   emitRequest(ctx, res, "throttle");
   const status = ctx.throttleController.getStatus({ attached: ctx.getCdpStatus().attached });
   respondJson(res, status);
 };
 
 // ../argus-watcher/dist/http/routes/postThrottle.js
-var handle27 = async (req, res, _url, ctx) => {
+var handle28 = async (req, res, _url, ctx) => {
   const payload = await readJsonBody(req, res);
   if (!payload) {
     return;
@@ -6402,7 +6653,7 @@ var buildActionCode = (action, key, value) => {
 };
 
 // ../argus-watcher/dist/http/routes/postStorageLocal.js
-var handle28 = async (req, res, _url, ctx) => {
+var handle29 = async (req, res, _url, ctx) => {
   const payload = await readJsonBody(req, res);
   if (!payload) {
     return;
@@ -6427,7 +6678,7 @@ var handle28 = async (req, res, _url, ctx) => {
 };
 
 // ../argus-watcher/dist/http/routes/postReload.js
-var handle29 = async (req, res, _url, ctx) => {
+var handle30 = async (req, res, _url, ctx) => {
   const payload = await readJsonBody(req, res);
   if (!payload) {
     return;
@@ -6445,7 +6696,7 @@ var handle29 = async (req, res, _url, ctx) => {
 };
 
 // ../argus-watcher/dist/http/routes/postShutdown.js
-var handle30 = (_req, res, _url, ctx) => {
+var handle31 = (_req, res, _url, ctx) => {
   emitRequest(ctx, res, "shutdown");
   const response = { ok: true };
   respondJson(res, response);
@@ -6457,7 +6708,7 @@ var handle30 = (_req, res, _url, ctx) => {
 };
 
 // ../argus-watcher/dist/http/routes/getTargets.js
-var handle31 = async (_req, res, _url, ctx) => {
+var handle32 = async (_req, res, _url, ctx) => {
   if (!ctx.sourceHandle?.listTargets) {
     return respondJson(res, { ok: false, error: { message: "Not available", code: "not_available" } }, 400);
   }
@@ -6471,7 +6722,7 @@ var handle31 = async (_req, res, _url, ctx) => {
 };
 
 // ../argus-watcher/dist/http/routes/postAttach.js
-var handle32 = async (req, res, _url, ctx) => {
+var handle33 = async (req, res, _url, ctx) => {
   if (!ctx.sourceHandle?.attachTarget) {
     return respondJson(res, { ok: false, error: { message: "Not available", code: "not_available" } }, 400);
   }
@@ -6492,7 +6743,7 @@ var handle32 = async (req, res, _url, ctx) => {
 };
 
 // ../argus-watcher/dist/http/routes/postDetach.js
-var handle33 = async (req, res, _url, ctx) => {
+var handle34 = async (req, res, _url, ctx) => {
   if (!ctx.sourceHandle?.detachTarget) {
     return respondJson(res, { ok: false, error: { message: "Not available", code: "not_available" } }, 400);
   }
@@ -6535,18 +6786,19 @@ var routes = {
   "POST /dom/set-file": { handler: handle19 },
   "POST /dom/focus": { handler: handle20 },
   "POST /dom/fill": { handler: handle21 },
-  "POST /dom/scroll": { handler: handle22 },
-  "POST /dom/scroll-to": { handler: handle23 },
-  "GET /emulation": { handler: handle24 },
-  "POST /emulation": { handler: handle25 },
-  "GET /throttle": { handler: handle26 },
-  "POST /throttle": { handler: handle27 },
-  "POST /storage/local": { handler: handle28 },
-  "POST /reload": { handler: handle29 },
-  "POST /shutdown": { handler: handle30 },
-  "GET /targets": { handler: handle31, extensionOnly: true },
-  "POST /attach": { handler: handle32, extensionOnly: true },
-  "POST /detach": { handler: handle33, extensionOnly: true }
+  "POST /dom/submit": { handler: handle22 },
+  "POST /dom/scroll": { handler: handle23 },
+  "POST /dom/scroll-to": { handler: handle24 },
+  "GET /emulation": { handler: handle25 },
+  "POST /emulation": { handler: handle26 },
+  "GET /throttle": { handler: handle27 },
+  "POST /throttle": { handler: handle28 },
+  "POST /storage/local": { handler: handle29 },
+  "POST /reload": { handler: handle30 },
+  "POST /shutdown": { handler: handle31 },
+  "GET /targets": { handler: handle32, extensionOnly: true },
+  "POST /attach": { handler: handle33, extensionOnly: true },
+  "POST /detach": { handler: handle34, extensionOnly: true }
 };
 var dispatch = (req, res, url, ctx) => {
   const entry = routes[`${req.method} ${url.pathname}`];
@@ -7123,7 +7375,7 @@ var createTraceRecorder = (options) => {
     await new Promise((resolve) => state.stream.end(resolve));
   };
   options.session.onEvent("Tracing.dataCollected", (params) => {
-    if (!active || active.state !== "recording") {
+    if (!active) {
       return;
     }
     const payload = params;
@@ -9178,7 +9430,7 @@ class SessionManager {
     const enabledDomains = new Set;
     const tabHandlers = new Map;
     this.eventHandlers.set(tabId, tabHandlers);
-    const handle34 = {
+    const handle35 = {
       isAttached: () => this.sessions.has(tabId),
       sendAndWait: async (method, params, options) => {
         if (!this.sessions.has(tabId)) {
@@ -9220,7 +9472,7 @@ class SessionManager {
       title,
       faviconUrl,
       attachedAt: Date.now(),
-      handle: handle34,
+      handle: handle35,
       enabledDomains
     };
     this.sessions.set(tabId, session);
@@ -10372,9 +10624,9 @@ var runStart = async (options) => {
     artifactsBaseDir = resolvePath(trimmed);
   }
   const inject = await resolveInjectScript(options.inject, output);
-  let handle34;
+  let handle35;
   try {
-    handle34 = await startWatcher({
+    handle35 = await startWatcher({
       id: watcherId,
       source: "cdp",
       match: Object.keys(match).length > 0 ? match : undefined,
@@ -10394,7 +10646,7 @@ var runStart = async (options) => {
   }
   const shutdown = async () => {
     try {
-      await handle34.close();
+      await handle35.close();
     } catch {}
     await chrome.closeGracefully();
   };
@@ -10410,23 +10662,23 @@ var runStart = async (options) => {
         rmSync2(chrome.userDataDir, { recursive: true, force: true });
       } catch {}
     }
-    handle34.close().then(() => process.exit(0));
+    handle35.close().then(() => process.exit(0));
   });
-  handle34.events.on("cdpAttached", ({ target }) => {
+  handle35.events.on("cdpAttached", ({ target }) => {
     const typeInfo = target?.type ? ` (type: ${target.type})` : "";
     output.writeHuman(`[${watcherId}] CDP attached: ${target?.title} (${target?.url})${typeInfo}`);
   });
-  handle34.events.on("cdpDetached", ({ reason, target }) => {
+  handle35.events.on("cdpDetached", ({ reason, target }) => {
     output.writeHuman(`[${watcherId}] CDP detached: ${reason} (last target: ${target?.title})`);
   });
   const result = {
-    id: handle34.watcher.id,
+    id: handle35.watcher.id,
     chromePid: chrome.chrome.pid,
     cdpHost: chrome.cdpHost,
     cdpPort: chrome.cdpPort,
-    watcherHost: handle34.watcher.host,
-    watcherPort: handle34.watcher.port,
-    watcherPid: handle34.watcher.pid
+    watcherHost: handle35.watcher.host,
+    watcherPort: handle35.watcher.port,
+    watcherPid: handle35.watcher.pid
   };
   if (options.json) {
     output.writeJson(result);
@@ -11294,9 +11546,9 @@ var runWatcherStart = async (options) => {
   if (options.parent?.trim()) {
     match.parent = options.parent.trim();
   }
-  let handle34;
+  let handle35;
   try {
-    handle34 = await startWatcher({
+    handle35 = await startWatcher({
       id: watcherId,
       source: sourceMode,
       match: sourceMode === "cdp" && Object.keys(match).length > 0 ? match : undefined,
@@ -11314,10 +11566,10 @@ var runWatcherStart = async (options) => {
     return;
   }
   const result = {
-    id: handle34.watcher.id,
-    host: handle34.watcher.host,
-    port: handle34.watcher.port,
-    pid: handle34.watcher.pid,
+    id: handle35.watcher.id,
+    host: handle35.watcher.host,
+    port: handle35.watcher.port,
+    pid: handle35.watcher.pid,
     source: sourceMode,
     matchUrl: match.url,
     matchType: match.type,
@@ -11330,7 +11582,7 @@ var runWatcherStart = async (options) => {
   };
   const cleanup = async () => {
     try {
-      await handle34.close();
+      await handle35.close();
     } catch {}
   };
   process.on("SIGINT", () => {
@@ -11339,12 +11591,12 @@ var runWatcherStart = async (options) => {
   process.on("SIGTERM", () => {
     cleanup().then(() => process.exit(0));
   });
-  handle34.events.on("cdpAttached", ({ target }) => {
+  handle35.events.on("cdpAttached", ({ target }) => {
     const typeInfo = target?.type ? ` (type: ${target.type})` : "";
-    output.writeHuman(`[${handle34.watcher.id}] CDP attached: ${target?.title} (${target?.url})${typeInfo}`);
+    output.writeHuman(`[${handle35.watcher.id}] CDP attached: ${target?.title} (${target?.url})${typeInfo}`);
   });
-  handle34.events.on("cdpDetached", ({ reason, target }) => {
-    output.writeHuman(`[${handle34.watcher.id}] CDP detached: ${reason} (last target: ${target?.title})`);
+  handle35.events.on("cdpDetached", ({ reason, target }) => {
+    output.writeHuman(`[${handle35.watcher.id}] CDP detached: ${reason} (last target: ${target?.title})`);
   });
   if (options.json) {
     output.writeJson(result);
@@ -11556,9 +11808,9 @@ var checkWatcherReachable = async (watcher) => {
 // dist/commands/watcherNativeHost.js
 var runWatcherNativeHost = async (options) => {
   const watcherId = options.id?.trim() || "extension";
-  let handle34;
+  let handle35;
   try {
-    handle34 = await startWatcher({
+    handle35 = await startWatcher({
       id: watcherId,
       source: "extension",
       host: "127.0.0.1",
@@ -11569,10 +11821,10 @@ var runWatcherNativeHost = async (options) => {
     console.error(`Failed to start watcher: ${error instanceof Error ? error.message : error}`);
     process.exit(1);
   }
-  console.error(`[NativeHost] Watcher started: id=${handle34.watcher.id} port=${handle34.watcher.port}`);
+  console.error(`[NativeHost] Watcher started: id=${handle35.watcher.id} port=${handle35.watcher.port}`);
   const cleanup = async () => {
     try {
-      await handle34.close();
+      await handle35.close();
     } catch {}
   };
   process.on("SIGINT", () => {
@@ -14081,11 +14333,91 @@ var runDomSetFile = async (id, options) => {
     process.exitCode = 1;
     return;
   }
+  if (successResp.updated === 0) {
+    output.writeWarn(`Matched ${successResp.matches} file input element(s), but none accepted files`);
+    process.exitCode = 1;
+    return;
+  }
   const fileLabel = files.length === 1 ? "1 file" : `${files.length} files`;
   const elLabel = successResp.updated === 1 ? "1 element" : `${successResp.updated} elements`;
   output.writeHuman(`Set ${fileLabel} on ${elLabel} for selector: ${options.selector}`);
 };
 
+// dist/commands/domSubmit.js
+var runDomSubmit = async (id, options) => {
+  const output = createOutput(options);
+  if (!options.selector || options.selector.trim() === "") {
+    output.writeWarn("--selector or --testid is required");
+    process.exitCode = 2;
+    return;
+  }
+  let waitMs = 0;
+  if (options.wait != null) {
+    const parsed = parseDurationMs(options.wait);
+    if (parsed == null || parsed < 0) {
+      output.writeWarn("Invalid --wait value: expected a duration like 5s, 500ms, 2m.");
+      process.exitCode = 2;
+      return;
+    }
+    waitMs = parsed;
+  }
+  const strategy = options.strategy ?? "auto";
+  if (strategy !== "auto" && strategy !== "form" && strategy !== "self") {
+    output.writeWarn("Invalid --strategy value: expected auto, form, or self.");
+    process.exitCode = 2;
+    return;
+  }
+  const body = {
+    selector: options.selector,
+    all: options.all ?? false,
+    text: options.text,
+    strategy
+  };
+  if (waitMs > 0) {
+    body.wait = waitMs;
+  }
+  const result = await requestWatcherJson({
+    id,
+    path: "/dom/submit",
+    method: "POST",
+    body,
+    timeoutMs: Math.max(30000, waitMs + 5000),
+    returnErrorResponse: true
+  });
+  if (!result.ok) {
+    writeRequestError(result, output);
+    return;
+  }
+  const response = result.data;
+  if (!response.ok) {
+    const errorResp = response;
+    if (options.json) {
+      output.writeJson(response);
+    } else {
+      output.writeWarn(`Error: ${errorResp.error.message}`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+  const successResp = response;
+  if (options.json) {
+    output.writeJson(successResp);
+    return;
+  }
+  if (successResp.matches === 0) {
+    output.writeWarn(`No element found for selector: ${options.selector}`);
+    process.exitCode = 1;
+    return;
+  }
+  if (successResp.submitted === 0) {
+    output.writeWarn(`Matched ${successResp.matches} element(s), but none could be submitted`);
+    process.exitCode = 1;
+    return;
+  }
+  const label = successResp.submitted === 1 ? "1 element" : `${successResp.submitted} elements`;
+  output.writeHuman(`Submitted ${label} for selector: ${options.selector}`);
+};
+
 // dist/commands/domScroll.js
 var runDomScroll = async (id, options) => {
   const output = createOutput(options);
@@ -14548,6 +14880,17 @@ Examples:
       return;
     await runDomSetFile(id, options);
   });
+  dom.command("submit").argument("[id]", "Watcher id to query").description("Submit a form or the nearest form for the matched element(s)").option("--selector <css>", "CSS selector for a form or a descendant element").option("--testid <id>", `Shorthand for --selector "[data-testid='<id>']"`).option("--all", "Allow multiple matches (default: error if >1 match)").option("--text <string>", "Filter by textContent (trimmed). Supports /regex/flags syntax").option("--wait <duration>", "Wait for selector to appear (e.g. 5s, 500ms)").option("--strategy <mode>", "Submit strategy: auto (default), form, or self").option("--json", "Output JSON for automation").addHelpText("after", `
+Examples:
+  $ argus dom submit app --selector "form"
+  $ argus dom submit app --selector "input[type=email]"
+  $ argus dom submit app --selector "button[type=submit]" --strategy form
+  $ argus dom submit app --selector "#login" --wait 5s
+`).action(async (id, options) => {
+    if (!resolveTestId(options))
+      return;
+    await runDomSubmit(id, options);
+  });
   dom.command("scroll").argument("[id]", "Watcher id to query").description("Emulate a touch scroll gesture (fires real scroll/wheel events)").option("--selector <css>", "CSS selector — scroll at element center").option("--testid <id>", `Shorthand for --selector "[data-testid='<id>']"`).option("--pos <x,y>", "Viewport coordinates to scroll at (mutually exclusive with selector)").requiredOption("--by <dx,dy>", "Scroll delta (positive y = scroll down)").option("--all", "Allow multiple matches (default: error if >1 match)").option("--text <string>", "Filter by textContent (trimmed). Supports /regex/flags syntax").option("--json", "Output JSON for automation").addHelpText("after", `
 Examples:
   $ argus dom scroll app --by 0,300