@csmodding/gameface-devtools-mcp 1.1.1 → 1.2.1

package/README.md

@@ -148,10 +148,11 @@ Or in `.vscode/mcp.json` (note the `servers` key, not `mcpServers`):
 
 > [!IMPORTANT]
 > **Input is done via DOM events, not CDP `Input`.** Gameface accepts `Input.dispatchMouseEvent` /
-> `dispatchKeyEvent` but never delivers them to the UI. So `game_click`, `game_fill`, `game_type`,
-> `game_key`, and `game_hover` dispatch real DOM events in the page. These reach the UI's own JS
-> handlers, but not any input the game routes at the native/engine level (e.g. Escape-to-close is
-> often handled natively and will not respond to a dispatched key).
+> `dispatchKeyEvent` but never delivers them to the UI — the mouse command measured on Cohtml 1.64
+> and 2.2, the key and text ones on 2.2, with a 3.x Player untested. So `game_click`, `game_fill`,
+> `game_type`, `game_key`, and `game_hover` dispatch real DOM events in the page. These reach the
+> UI's own JS handlers, but not any input the game routes at the native/engine level (e.g.
+> Escape-to-close is often handled natively and will not respond to a dispatched key).
 
 ### JS debugger tools
 

package/dist/server.mjs

@@ -30622,12 +30622,16 @@ var SUPPORTED_PSEUDOS = new Set([
   ":before",
   ":after",
   "::before",
-  "::after"
+  "::after",
+  ":host"
 ]);
+var ANSWERED_NOT_REJECTED = new Set(["::slotted", "::part", "::selection"]);
+var ARGUMENTLESS_ANSWERED = new Set(["::selection"]);
 var SUPPORTED_SUMMARY = import_common_tags2.oneLine`
   type, class, id and attribute selectors, combinators, \`:first-child\`, \`:last-child\`,
-  \`:only-child\`, \`:nth-child()\`, \`:root\`, \`:hover\`, \`:focus\`, \`:active\`, \`::before\`
-  and \`::after\`
+  \`:only-child\`, \`:nth-child()\`, \`:root\`, \`:hover\`, \`:focus\`, \`:active\`, \`::before\`,
+  \`::after\`, and \`:host\` matched off the element alone rather than from a scoped query, which
+  answers nothing
 `;
 var NTH_CHILD_ARGUMENT = /^\s*(?:[+-]?\d+|even|odd|[+-]?\d*n)\s*$/iu;
 var PSEUDO_TOKEN = /(?<colons>::?)(?<name>[a-z][a-z-]*)(?:\((?<argument>[^()]*)\))?/giu;
@@ -30723,6 +30727,9 @@ function maskLiterals(selector) {
   return LITERAL_SPANS.reduce((masked, span) => masked.replace(span, (literal3) => MASK_FILLER.repeat(literal3.length)), selector);
 }
 function isSupported(key, argument) {
+  if (ANSWERED_NOT_REJECTED.has(key)) {
+    return ARGUMENTLESS_ANSWERED.has(key) || argument != null && argument.trim() != "";
+  }
   if (!SUPPORTED_PSEUDOS.has(key)) {
     return false;
   }
@@ -32179,10 +32186,11 @@ async function gameWait(client, reloads, debug, options) {
     }
   }
 }
-async function gameFill(client, selector, value, index = 0) {
+async function gameFill(client, options) {
+  const { selector, value, index = 0, commit = false } = options;
   try {
     const res = await client.call("Runtime.evaluate", {
-      expression: callPageFn(fillFn, selector, value, index),
+      expression: callPageFn(fillFn, selector, value, index, commit),
       returnByValue: true
     });
     if (res.exceptionDetails) {
@@ -32203,10 +32211,11 @@ async function gameFill(client, selector, value, index = 0) {
     return toErrorResult(error51);
   }
 }
-async function gameType(client, selector, textToType, index = 0) {
+async function gameType(client, options) {
+  const { selector, text: textToType, index = 0, commit = false } = options;
   try {
     const res = await client.call("Runtime.evaluate", {
-      expression: callPageFn(typeFn, selector, textToType, index),
+      expression: callPageFn(typeFn, selector, textToType, index, commit),
       returnByValue: true
     });
     if (res.exceptionDetails) {
@@ -32501,6 +32510,8 @@ function clickFn(sel, index) {
     cancelable: true,
     view: window,
     button: 0,
+    screenX: cx,
+    screenY: cy,
     clientX: cx,
     clientY: cy
   };
@@ -32530,7 +32541,7 @@ function waitCheckFn(sel, visible) {
   const rect = el.getBoundingClientRect();
   return rect.width > 0 && rect.height > 0;
 }
-function fillFn(sel, value, index) {
+function fillFn(sel, value, index, commit) {
   const nodes = document.querySelectorAll(sel);
   if (nodes.length == 0) {
     return { found: false, count: 0 };
@@ -32549,6 +32560,7 @@ function fillFn(sel, value, index) {
     el.textContent = value;
     el.dispatchEvent(new Event("input", { bubbles: true }));
     el.dispatchEvent(new Event("change", { bubbles: true }));
+    commitEdit();
     return { found: true, count, mode: "contenteditable", value: el.textContent ?? "" };
   }
   const field = el;
@@ -32561,9 +32573,22 @@ function fillFn(sel, value, index) {
   }
   el.dispatchEvent(new Event("input", { bubbles: true }));
   el.dispatchEvent(new Event("change", { bubbles: true }));
+  commitEdit();
   return { found: true, count, mode: tag || "input", value: field.value };
+  function commitEdit() {
+    if (!commit) {
+      return;
+    }
+    let event;
+    try {
+      event = new FocusEvent("focusout", { bubbles: true });
+    } catch {
+      event = new Event("focusout", { bubbles: true });
+    }
+    el.dispatchEvent(event);
+  }
 }
-function typeFn(sel, textToType, index) {
+function typeFn(sel, textToType, index, commit) {
   const nodes = document.querySelectorAll(sel);
   if (nodes.length == 0) {
     return { found: false, count: 0, typed: 0 };
@@ -32590,18 +32615,55 @@ function typeFn(sel, textToType, index) {
       key: ch,
       view: window
     };
-    try {
-      el.dispatchEvent(new KeyboardEvent("keydown", opts));
-    } catch {}
+    sendKey("keydown", ch, opts);
     setValue(current() + ch);
     el.dispatchEvent(new Event("input", { bubbles: true }));
-    try {
-      el.dispatchEvent(new KeyboardEvent("keyup", opts));
-    } catch {}
+    sendKey("keyup", ch, opts);
     typed++;
   }
   el.dispatchEvent(new Event("change", { bubbles: true }));
+  if (commit) {
+    let event;
+    try {
+      event = new FocusEvent("focusout", { bubbles: true });
+    } catch {
+      event = new Event("focusout", { bubbles: true });
+    }
+    el.dispatchEvent(event);
+  }
   return { found: true, count, typed, value: current() };
+  function sendKey(type, ch, init) {
+    try {
+      const ev = new KeyboardEvent(type, init);
+      force(ev, "key", ch);
+      const legacy = codeForChar(ch);
+      if (legacy) {
+        force(ev, "code", legacy.code);
+        force(ev, "keyCode", legacy.keyCode);
+        force(ev, "which", legacy.keyCode);
+      }
+      el.dispatchEvent(ev);
+    } catch {}
+  }
+  function codeForChar(ch) {
+    const SPACE_KEY_CODE = 32;
+    if (ch == " ") {
+      return { code: "Space", keyCode: SPACE_KEY_CODE };
+    }
+    if (/^[a-zA-Z]$/u.test(ch)) {
+      const upper = ch.toUpperCase();
+      return { code: `Key${upper}`, keyCode: upper.codePointAt(0) ?? 0 };
+    }
+    if (/^[0-9]$/u.test(ch)) {
+      return { code: `Digit${ch}`, keyCode: ch.codePointAt(0) ?? 0 };
+    }
+    return;
+  }
+  function force(ev, prop, value) {
+    try {
+      Object.defineProperty(ev, prop, { get: () => value, configurable: true });
+    } catch {}
+  }
   function current() {
     if (editable) {
       return el.textContent ?? "";
@@ -32636,6 +32698,8 @@ function hoverFn(sel, index) {
     bubbles: true,
     cancelable: true,
     view: window,
+    screenX: cx,
+    screenY: cy,
     clientX: cx,
     clientY: cy
   };
@@ -32898,26 +32962,44 @@ async function main() {
         Set the value of an input, textarea, or contenteditable element and fire input/change so
         the UI framework reacts as if the user edited it.
         Best for setting a field in one shot; use game_type for keystrokes.
+        If the value reverts (the field, or the state behind it, goes back to the old value), the
+        field commits on blur: call again with commit true.
+        A value that still reverts with commit true was rejected by the field; read it back rather
+        than repeating the call.
       `,
     inputSchema: {
       selector: exports_external.string().describe(`CSS selector of the field to fill`),
       value: exports_external.string().describe(`Value to set`),
-      index: exports_external.number().int().min(0).optional().describe(`Which match to fill when several exist (default: 0)`)
+      index: exports_external.number().int().min(0).optional().describe(`Which match to fill when several exist (default: 0)`),
+      commit: exports_external.boolean().optional().describe(import_common_tags6.oneLine`
+            Also dispatch a bubbling focusout after the value is set, so a field that commits on
+            blur takes it. This call moves focus nowhere itself, but the page's own focusout
+            handler may (default: false)
+          `)
     }
-  }, ({ selector, value, index }) => gameFill(client, selector, value, index));
+  }, ({ selector, value, index, commit }) => gameFill(client, { selector, value, index, commit }));
   server.registerTool("game_type", {
     title: `Type text into the Gameface UI`,
     description: import_common_tags6.oneLine`
         Type text into an element character by character, firing real KeyboardEvents plus keeping
         the value in sync.
         Use when handlers react to individual keystrokes; otherwise game_fill.
+        If the value reverts (the field, or the state behind it, goes back to the old value), the
+        field commits on blur: call again with commit true.
+        A value that still reverts with commit true was rejected by the field; read it back rather
+        than repeating the call, which would type the text a second time.
       `,
     inputSchema: {
       selector: exports_external.string().describe(`CSS selector of the field to type into`),
       text: exports_external.string().describe(`Text to type`),
-      index: exports_external.number().int().min(0).optional().describe(`Which match to type into when several exist (default: 0)`)
+      index: exports_external.number().int().min(0).optional().describe(`Which match to type into when several exist (default: 0)`),
+      commit: exports_external.boolean().optional().describe(import_common_tags6.oneLine`
+            Also dispatch a bubbling focusout after the last keystroke, so a field that commits on
+            blur takes the text. This call moves focus nowhere itself, but the page's own focusout
+            handler may (default: false)
+          `)
     }
-  }, ({ selector, text: text2, index }) => gameType(client, selector, text2, index));
+  }, ({ selector, text: text2, index, commit }) => gameType(client, { selector, text: text2, index, commit }));
   server.registerTool("game_hover", {
     title: `Hover an element in the Gameface UI`,
     description: import_common_tags6.oneLine`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@csmodding/gameface-devtools-mcp",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "MCP server that drives a running Coherent Gameface (Cohtml) game UI over a direct Chrome DevTools Protocol connection: evaluate JS, screenshot, inspect and drive the DOM, capture the console, and set JS breakpoints.",
   "keywords": [
     "browser-automation",
@@ -42,6 +42,7 @@
     "@types/common-tags": "^1.8.4",
     "@types/node": "^24.13.3",
     "common-tags": "^1.8.2",
+    "happy-dom": "^20.12.2",
     "typescript": "^7.0.2",
     "zod": "^4.4.3"
   },