framewatch-mcp-server 0.1.0 → 0.2.0

package/dist/engine/forms.js

@@ -0,0 +1,474 @@
+import { MAX_FORM_FIELDS, MAX_FORM_MESSAGE_LENGTH, MAX_FORM_MESSAGES, MAX_FORM_TEXT_LENGTH, SELECTOR_TIMEOUT_MS } from "../constants.js";
+import { XSS_MARKER, checkedFor, optionFor, valueFor, } from "../utils/test-data.js";
+/**
+ * Form engine.
+ *
+ * Finds the forms on a page, fills them according to a strategy, submits them,
+ * and reads back what the page said about it. Everything here works on real
+ * input — Playwright's `fill`, `check` and `selectOption` dispatch the same
+ * events a person's typing does — because the bugs this is looking for live in
+ * the handlers those events run. Setting `.value` from inside the page would
+ * skip every one of them, and a React-controlled input would not even keep the
+ * value.
+ *
+ * Nothing here decides *what* to type; that is `utils/test-data.ts`. This
+ * module is about the page: which fields exist, which of them can be filled,
+ * what landed in them, and what came back.
+ */
+/** Elements that can hold a value. */
+const FIELD_SELECTOR = "input, select, textarea";
+/** Elements that might submit a form. `[role=button]` catches the div-with-a-handler school of markup. */
+const SUBMIT_SELECTOR = 'button, input[type="submit"], input[type="image"], input[type="button"], [role="button"]';
+/** Words on a button that mean "this one sends the form", when nothing declares it. */
+const SUBMIT_WORDS = /\b(submit|send|save|sign\s?in|sign\s?up|log\s?in|register|create|continue|next|confirm|apply|search|subscribe|order|pay|checkout|update|post|add)\b/i;
+/**
+ * Elements that carry a validation message. Class-name matching is deliberately
+ * broad — every framework spells it differently — and the noise it lets in is
+ * dealt with afterwards: only visible elements with short text count, only the
+ * innermost of a nest, and only messages that were not already on the page
+ * before the form was touched.
+ */
+const MESSAGE_SELECTOR = [
+    '[role="alert"]',
+    '[role="status"]',
+    '[aria-live="polite"]',
+    '[aria-live="assertive"]',
+    '[class*="error" i]',
+    '[class*="invalid" i]',
+    '[class*="warning" i]',
+    '[class*="danger" i]',
+    '[class*="toast" i]',
+    '[class*="notice" i]',
+    '[id*="error" i]',
+].join(", ");
+/**
+ * Find the forms on a page.
+ *
+ * With a `selector`, whatever it matches is the form — a `<form>` element or
+ * any container, since the fields are looked for underneath it either way.
+ * Without one, every `<form>` on the page is returned in document order.
+ *
+ * A page with no `<form>` element at all is not a page without a form: React,
+ * Vue and Svelte apps routinely put inputs and a button in a `<div>` and wire
+ * the submit up in JavaScript. So when there is no form, the page itself is
+ * treated as one (`is_form: false`), and everything works as it does for a
+ * real form except that Enter cannot be used to submit it.
+ */
+export async function discoverForms(page, options = {}) {
+    const maxFields = options.max_fields ?? MAX_FORM_FIELDS;
+    const roots = await findRoots(page, options.selector);
+    const forms = [];
+    for (const root of roots) {
+        const handles = await root.handle.$$(FIELD_SELECTOR);
+        const described = await Promise.all(handles.map((handle) => handle.evaluate(describeField)));
+        const fields = [];
+        const skipped = [];
+        let fillable = 0;
+        for (let i = 0; i < handles.length; i++) {
+            const raw = described[i];
+            if (raw.skip !== undefined) {
+                skipped.push({ description: raw.description, reason: raw.skip });
+                continue;
+            }
+            fillable++;
+            if (fields.length >= maxFields)
+                continue;
+            fields.push({ handle: handles[i], info: toFieldInfo(raw) });
+        }
+        forms.push({
+            index: forms.length + 1,
+            description: root.description,
+            is_form: root.is_form,
+            total_fields: fillable,
+            fields,
+            skipped,
+            root: root.handle,
+            page,
+        });
+    }
+    return forms;
+}
+async function findRoots(page, selector) {
+    if (selector !== undefined) {
+        const handles = await page.$$(selector);
+        if (handles.length === 0) {
+            throw new Error(`no element on the page matches \`${selector}\``);
+        }
+        return Promise.all(handles.map(async (handle) => ({ handle, ...(await handle.evaluate(describeRoot)) })));
+    }
+    const forms = await page.$$("form");
+    if (forms.length > 0) {
+        return Promise.all(forms.map(async (handle) => ({ handle, ...(await handle.evaluate(describeRoot)) })));
+    }
+    const body = await page.$("body");
+    if (!body)
+        return [];
+    return [{ handle: body, description: "the page (it has no <form> element)", is_form: false }];
+}
+/**
+ * Fill every field of `form` according to `strategy`.
+ *
+ * A field that will not take its value is recorded and the rest are still
+ * filled: a form where one field is locked is a finding about that field, and
+ * abandoning the other twenty would throw away the run that found it.
+ */
+export async function fillForm(form, strategy, options = {}) {
+    const timeout = options.timeout_ms ?? SELECTOR_TIMEOUT_MS;
+    const result = { filled: [], failed: [], skipped: [] };
+    /** Radio groups already answered — one choice per group, not one per button. */
+    const groups = new Set();
+    for (let i = 0; i < form.fields.length; i++) {
+        const { info, handle } = form.fields[i];
+        try {
+            const outcome = await fillField(handle, info, strategy, i, timeout, groups);
+            if ("reason" in outcome)
+                result.skipped.push({ description: info.description, reason: outcome.reason });
+            else
+                result.filled.push(outcome);
+        }
+        catch (error) {
+            result.failed.push({ description: info.description, reason: firstLine(error) });
+        }
+    }
+    return result;
+}
+async function fillField(handle, info, strategy, variant, timeout, groups) {
+    if (info.kind === "toggle") {
+        const want = checkedFor(strategy);
+        if (info.type === "radio") {
+            // Clicking a radio cannot clear it, only move the choice elsewhere.
+            if (!want)
+                return { reason: "a radio button cannot be cleared, only replaced" };
+            const group = info.name ?? info.description;
+            if (groups.has(group))
+                return { reason: `another option in the "${group}" group was chosen` };
+            groups.add(group);
+            await handle.check({ timeout });
+        }
+        else {
+            await handle.setChecked(want, { timeout });
+        }
+        const state = await readBack(handle);
+        return {
+            description: info.description,
+            kind: info.kind,
+            requested: want ? "checked" : "unchecked",
+            requested_length: 0,
+            landed: state.checked ? "checked" : "unchecked",
+            landed_length: 0,
+            truncated: false,
+            checked: state.checked,
+        };
+    }
+    if (info.kind === "choice") {
+        const option = optionFor({ ...info, options: info.options ?? [] }, strategy);
+        if (option === null)
+            return { reason: "no option to choose — every option is disabled" };
+        await handle.selectOption(option, { timeout });
+        const state = await readBack(handle);
+        return {
+            description: info.description,
+            kind: info.kind,
+            requested: elide(option),
+            requested_length: option.length,
+            landed: elide(state.value),
+            landed_length: state.value.length,
+            truncated: false,
+        };
+    }
+    const requested = valueFor(info, strategy, variant);
+    await handle.fill(requested, { timeout });
+    const state = await readBack(handle);
+    return {
+        description: info.description,
+        kind: info.kind,
+        requested: elide(requested),
+        requested_length: requested.length,
+        landed: elide(state.value),
+        landed_length: state.value.length,
+        // Only ever shorter: a page that appends to what was typed (a formatter
+        // adding separators) is not truncating it.
+        truncated: state.value.length < requested.length,
+    };
+}
+function readBack(handle) {
+    return handle.evaluate((node) => ({
+        value: typeof node.value === "string" ? node.value : "",
+        checked: node.checked === true,
+    }));
+}
+/**
+ * Send the form the way a person would.
+ *
+ * A real submit control comes first, then a button whose text says what it
+ * does, then Enter in a text field — which is how a search box with no button
+ * is submitted, and the only route left when the markup names nothing. A form
+ * that offers none of those is reported rather than forced: calling
+ * `form.submit()` from script would skip the page's own submit handler and
+ * validation, which is the thing under test.
+ */
+export async function submitForm(form, options = {}) {
+    const timeout = options.timeout_ms ?? SELECTOR_TIMEOUT_MS;
+    const control = await findSubmitControl(form);
+    if (control) {
+        try {
+            await control.handle.click({ timeout });
+            return { ok: true, how: `clicked "${control.description}"` };
+        }
+        catch (error) {
+            // A click that navigates can detach the button underneath Playwright;
+            // the submit happened either way, which the URL proves.
+            if (form.page.url() !== control.url_before) {
+                return { ok: true, how: `clicked "${control.description}"` };
+            }
+            return { ok: false, how: `tried to click "${control.description}"`, reason: firstLine(error) };
+        }
+    }
+    const typed = form.fields.find((field) => field.info.kind === "text");
+    if (form.is_form && typed) {
+        try {
+            await typed.handle.press("Enter", { timeout });
+            return { ok: true, how: `pressed Enter in "${typed.info.description}"` };
+        }
+        catch (error) {
+            return { ok: false, how: `tried to press Enter in "${typed.info.description}"`, reason: firstLine(error) };
+        }
+    }
+    return {
+        ok: false,
+        how: "nothing",
+        reason: form.is_form
+            ? "no submit control found — no button, and no text field to press Enter in"
+            : "no submit control found — no button, and this is not a <form>, so Enter has nothing to submit",
+    };
+}
+async function findSubmitControl(form) {
+    const handles = await form.root.$$(SUBMIT_SELECTOR);
+    if (handles.length === 0)
+        return null;
+    const described = await Promise.all(handles.map((handle) => handle.evaluate(describeButton)));
+    const usable = described
+        .map((button, index) => ({ button, index }))
+        .filter(({ button }) => button.usable);
+    if (usable.length === 0)
+        return null;
+    const declared = usable.find(({ button }) => button.type === "submit" || button.type === "image");
+    const worded = usable.find(({ button }) => SUBMIT_WORDS.test(button.text));
+    const chosen = declared ?? worded ?? usable[0];
+    return {
+        handle: handles[chosen.index],
+        description: chosen.button.description,
+        url_before: form.page.url(),
+    };
+}
+/**
+ * What the page says about the state it is in.
+ *
+ * Two independent sources, because apps use one, the other or both: the
+ * browser's constraint validation (`required`, `type=email`, `min`), which is
+ * true whether or not the app ever shows it, and the text actually visible on
+ * screen, which is what a user would see. Neither is meaningful alone —
+ * constraint validation on a form with `novalidate` never reaches the user,
+ * and visible text tells you nothing about which field it belongs to.
+ */
+export async function readValidation(page, form) {
+    const states = await Promise.all(form.fields.map(async (field) => ({
+        field: field.info.description,
+        ...(await field.handle.evaluate(readFieldValidity).catch(() => ({ valid: true, message: "", invalid: false }))),
+    })));
+    const messages = await page
+        .evaluate(scanMessages, { selector: MESSAGE_SELECTOR, max: MAX_FORM_MESSAGES, max_length: MAX_FORM_MESSAGE_LENGTH })
+        .catch(() => []);
+    return {
+        browser: states
+            .filter((state) => !state.valid && state.message !== "")
+            .map((state) => ({ field: state.field, message: state.message })),
+        messages,
+        invalid: states.filter((state) => state.invalid).map((state) => state.field),
+    };
+}
+/** Messages that were not on the page before — the ones this strategy caused. */
+export function newMessages(before, after) {
+    return after.messages.filter((message) => !before.messages.includes(message));
+}
+/**
+ * Whether an XSS payload has executed on this page (see `XSS_MARKER`).
+ *
+ * Reading a marker the payload itself sets is the only honest answer to "did
+ * my input run as code". Looking for the payload in the DOM afterwards is not:
+ * an input's `value` serialises with its angle brackets intact, so a page that
+ * escaped everything perfectly would still look like a hit.
+ */
+export async function readXssMarker(page) {
+    try {
+        return await page.evaluate((name) => Boolean(globalThis[name]), XSS_MARKER);
+    }
+    catch {
+        return false;
+    }
+}
+function describeField(node) {
+    const tag = String(node.tagName ?? "").toLowerCase();
+    const type = tag === "textarea" ? "textarea" : String(node.type ?? "text").toLowerCase();
+    const attr = (name) => {
+        const value = node.getAttribute ? node.getAttribute(name) : null;
+        return value === null || value === undefined ? undefined : String(value);
+    };
+    const flatten = (text) => String(text ?? "").replace(/\s+/g, " ").trim();
+    const id = node.id ? String(node.id) : "";
+    const name = node.name ? String(node.name) : "";
+    const description = id ? `#${id}` : name ? `[name="${name}"]` : tag === "input" ? `input[type=${type}]` : tag;
+    let label = "";
+    try {
+        const labels = node.labels;
+        if (labels && labels.length > 0)
+            label = flatten(labels[0].textContent);
+        if (!label)
+            label = flatten(attr("aria-label"));
+        if (!label) {
+            const by = attr("aria-labelledby");
+            const target = by ? globalThis.document?.getElementById(by.split(/\s+/)[0]) : null;
+            if (target)
+                label = flatten(target.textContent);
+        }
+        if (!label && node.closest)
+            label = flatten(node.closest("label")?.textContent);
+    }
+    catch {
+        label = "";
+    }
+    const visible = (() => {
+        try {
+            return node.getClientRects ? node.getClientRects().length > 0 : true;
+        }
+        catch {
+            return true;
+        }
+    })();
+    const skip = (() => {
+        if (type === "hidden")
+            return "hidden input";
+        if (node.disabled === true)
+            return "disabled";
+        if (node.readOnly === true)
+            return "read-only";
+        if (type === "file")
+            return "file input — a file cannot be chosen from a script";
+        if (type === "submit" || type === "button" || type === "reset" || type === "image")
+            return "not an input field";
+        if (!visible)
+            return "not visible";
+        return undefined;
+    })();
+    const maxLength = typeof node.maxLength === "number" && node.maxLength > 0 ? node.maxLength : undefined;
+    const options = tag === "select" && node.options
+        ? Array.from(node.options).map((option) => ({
+            value: String(option.value ?? ""),
+            label: flatten(option.textContent),
+            disabled: option.disabled === true,
+        }))
+        : undefined;
+    return {
+        tag,
+        type,
+        description,
+        ...(name ? { name } : {}),
+        ...(label ? { label: label.slice(0, 80) } : {}),
+        ...(attr("placeholder") ? { placeholder: attr("placeholder") } : {}),
+        ...(maxLength !== undefined ? { maxlength: maxLength } : {}),
+        ...(attr("min") !== undefined ? { min: attr("min") } : {}),
+        ...(attr("max") !== undefined ? { max: attr("max") } : {}),
+        ...(attr("step") !== undefined ? { step: attr("step") } : {}),
+        required: node.required === true,
+        ...(options ? { options } : {}),
+        ...(skip !== undefined ? { skip } : {}),
+    };
+}
+function describeRoot(node) {
+    const tag = String(node.tagName ?? "").toLowerCase();
+    const id = node.id ? `#${String(node.id)}` : "";
+    const name = node.name ? `[name="${String(node.name)}"]` : "";
+    const action = node.getAttribute && node.getAttribute("action") ? `[action="${node.getAttribute("action")}"]` : "";
+    return { description: id || name || `${tag}${action}`, is_form: tag === "form" };
+}
+function describeButton(node) {
+    const tag = String(node.tagName ?? "").toLowerCase();
+    const type = String(node.type ?? "").toLowerCase();
+    const flatten = (text) => String(text ?? "").replace(/\s+/g, " ").trim();
+    const id = node.id ? String(node.id) : "";
+    const name = node.name ? String(node.name) : "";
+    const text = flatten(node.textContent) || flatten(node.value) || flatten(node.getAttribute?.("aria-label"));
+    let visible = true;
+    try {
+        visible = node.getClientRects ? node.getClientRects().length > 0 : true;
+    }
+    catch {
+        visible = true;
+    }
+    return {
+        usable: visible && node.disabled !== true,
+        type,
+        text,
+        description: id ? `#${id}` : name ? `[name="${name}"]` : text ? `${tag} "${text.slice(0, 40)}"` : tag,
+    };
+}
+function readFieldValidity(node) {
+    // `validity`, never `checkValidity()`: the call fires an `invalid` event the
+    // page can see and act on, and reading the state must not change it.
+    const validity = node.validity;
+    return {
+        valid: validity ? validity.valid === true : true,
+        message: String(node.validationMessage ?? ""),
+        invalid: node.getAttribute ? node.getAttribute("aria-invalid") === "true" : false,
+    };
+}
+function scanMessages(options) {
+    const doc = globalThis.document;
+    if (!doc)
+        return [];
+    let nodes = [];
+    try {
+        nodes = Array.from(doc.querySelectorAll(options.selector));
+    }
+    catch {
+        return [];
+    }
+    const visible = nodes.filter((node) => {
+        try {
+            return node.getClientRects && node.getClientRects().length > 0;
+        }
+        catch {
+            return false;
+        }
+    });
+    // Keep the innermost of a nest: a wrapper element matching on its class name
+    // would otherwise contribute the whole panel's text as one "message".
+    const innermost = visible.filter((node) => !visible.some((other) => other !== node && node.contains(other)));
+    const messages = [];
+    for (const node of innermost) {
+        const text = String(node.textContent ?? "")
+            .replace(/\s+/g, " ")
+            .trim();
+        if (text === "" || text.length > options.max_length)
+            continue;
+        if (!messages.includes(text))
+            messages.push(text);
+        if (messages.length >= options.max)
+            break;
+    }
+    return messages;
+}
+/* ── Helpers ──────────────────────────────────────────────────────────── */
+function toFieldInfo(raw) {
+    const kind = raw.tag === "select" ? "choice" : raw.type === "checkbox" || raw.type === "radio" ? "toggle" : "text";
+    const { skip: _skip, ...rest } = raw;
+    return { ...rest, kind };
+}
+function elide(value, max = MAX_FORM_TEXT_LENGTH) {
+    const flat = value.replace(/\s+/g, " ");
+    return flat.length > max ? `${flat.slice(0, max)}…` : flat;
+}
+function firstLine(error) {
+    return (error instanceof Error ? error.message : String(error)).split("\n")[0];
+}
+//# sourceMappingURL=forms.js.map

package/dist/engine/forms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../src/engine/forms.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ElementHandle, Page } from \"playwright\";\nimport { MAX_FORM_FIELDS, MAX_FORM_MESSAGE_LENGTH, MAX_FORM_MESSAGES, MAX_FORM_TEXT_LENGTH, SELECTOR_TIMEOUT_MS } from \"../constants.js\";\nimport {\n  XSS_MARKER,\n  checkedFor,\n  optionFor,\n  valueFor,\n  type FieldShape,\n  type FormStrategy,\n  type OptionInfo,\n} from \"../utils/test-data.js\";\n\n/**\n * Form engine.\n *\n * Finds the forms on a page, fills them according to a strategy, submits them,\n * and reads back what the page said about it. Everything here works on real\n * input — Playwright's `fill`, `check` and `selectOption` dispatch the same\n * events a person's typing does — because the bugs this is looking for live in\n * the handlers those events run. Setting `.value` from inside the page would\n * skip every one of them, and a React-controlled input would not even keep the\n * value.\n *\n * Nothing here decides *what* to type; that is `utils/test-data.ts`. This\n * module is about the page: which fields exist, which of them can be filled,\n * what landed in them, and what came back.\n */\n\n/** Elements that can hold a value. */\nconst FIELD_SELECTOR = \"input, select, textarea\";\n\n/** Elements that might submit a form. `[role=button]` catches the div-with-a-handler school of markup. */\nconst SUBMIT_SELECTOR = 'button, input[type=\"submit\"], input[type=\"image\"], input[type=\"button\"], [role=\"button\"]';\n\n/** Words on a button that mean \"this one sends the form\", when nothing declares it. */\nconst SUBMIT_WORDS =\n  /\\b(submit|send|save|sign\\s?in|sign\\s?up|log\\s?in|register|create|continue|next|confirm|apply|search|subscribe|order|pay|checkout|update|post|add)\\b/i;\n\n/**\n * Elements that carry a validation message. Class-name matching is deliberately\n * broad — every framework spells it differently — and the noise it lets in is\n * dealt with afterwards: only visible elements with short text count, only the\n * innermost of a nest, and only messages that were not already on the page\n * before the form was touched.\n */\nconst MESSAGE_SELECTOR = [\n  '[role=\"alert\"]',\n  '[role=\"status\"]',\n  '[aria-live=\"polite\"]',\n  '[aria-live=\"assertive\"]',\n  '[class*=\"error\" i]',\n  '[class*=\"invalid\" i]',\n  '[class*=\"warning\" i]',\n  '[class*=\"danger\" i]',\n  '[class*=\"toast\" i]',\n  '[class*=\"notice\" i]',\n  '[id*=\"error\" i]',\n].join(\", \");\n\n/** How a field is filled. */\nexport type FieldKind = \"text\" | \"choice\" | \"toggle\";\n\nexport interface FieldInfo extends FieldShape {\n  tag: string;\n  kind: FieldKind;\n  required: boolean;\n  options?: OptionInfo[];\n  /** How the field is named in the report — `#email`, `[name=\"plan\"]`, `input[type=text]`. */\n  description: string;\n}\n\nexport interface DiscoveredField {\n  info: FieldInfo;\n  handle: ElementHandle;\n}\n\n/** A field that was not filled, and why. */\nexport interface FieldProblem {\n  description: string;\n  reason: string;\n}\n\nexport interface DiscoveredForm {\n  /** 1-based position among the forms found on the page. */\n  index: number;\n  description: string;\n  /** False when this is not a real `<form>` — see `discoverForms`. */\n  is_form: boolean;\n  /** Fillable fields found, before `max_fields` trimmed the list. */\n  total_fields: number;\n  fields: DiscoveredField[];\n  /** Fields that exist but cannot be filled (hidden, disabled, read-only, file). */\n  skipped: FieldProblem[];\n  root: ElementHandle;\n  page: Page;\n}\n\nexport interface DiscoverOptions {\n  /** CSS selector for one form, or for a container to treat as one. Defaults to every `<form>` on the page. */\n  selector?: string;\n  max_fields?: number;\n}\n\n/**\n * Find the forms on a page.\n *\n * With a `selector`, whatever it matches is the form — a `<form>` element or\n * any container, since the fields are looked for underneath it either way.\n * Without one, every `<form>` on the page is returned in document order.\n *\n * A page with no `<form>` element at all is not a page without a form: React,\n * Vue and Svelte apps routinely put inputs and a button in a `<div>` and wire\n * the submit up in JavaScript. So when there is no form, the page itself is\n * treated as one (`is_form: false`), and everything works as it does for a\n * real form except that Enter cannot be used to submit it.\n */\nexport async function discoverForms(page: Page, options: DiscoverOptions = {}): Promise<DiscoveredForm[]> {\n  const maxFields = options.max_fields ?? MAX_FORM_FIELDS;\n  const roots = await findRoots(page, options.selector);\n\n  const forms: DiscoveredForm[] = [];\n  for (const root of roots) {\n    const handles = await root.handle.$$(FIELD_SELECTOR);\n    const described = await Promise.all(handles.map((handle) => handle.evaluate(describeField)));\n\n    const fields: DiscoveredField[] = [];\n    const skipped: FieldProblem[] = [];\n    let fillable = 0;\n\n    for (let i = 0; i < handles.length; i++) {\n      const raw = described[i];\n      if (raw.skip !== undefined) {\n        skipped.push({ description: raw.description, reason: raw.skip });\n        continue;\n      }\n      fillable++;\n      if (fields.length >= maxFields) continue;\n      fields.push({ handle: handles[i], info: toFieldInfo(raw) });\n    }\n\n    forms.push({\n      index: forms.length + 1,\n      description: root.description,\n      is_form: root.is_form,\n      total_fields: fillable,\n      fields,\n      skipped,\n      root: root.handle,\n      page,\n    });\n  }\n\n  return forms;\n}\n\ninterface Root {\n  handle: ElementHandle;\n  description: string;\n  is_form: boolean;\n}\n\nasync function findRoots(page: Page, selector?: string): Promise<Root[]> {\n  if (selector !== undefined) {\n    const handles = await page.$$(selector);\n    if (handles.length === 0) {\n      throw new Error(`no element on the page matches \\`${selector}\\``);\n    }\n    return Promise.all(handles.map(async (handle) => ({ handle, ...(await handle.evaluate(describeRoot)) })));\n  }\n\n  const forms = await page.$$(\"form\");\n  if (forms.length > 0) {\n    return Promise.all(forms.map(async (handle) => ({ handle, ...(await handle.evaluate(describeRoot)) })));\n  }\n\n  const body = await page.$(\"body\");\n  if (!body) return [];\n  return [{ handle: body, description: \"the page (it has no <form> element)\", is_form: false }];\n}\n\n/**\n * Fill every field of `form` according to `strategy`.\n *\n * A field that will not take its value is recorded and the rest are still\n * filled: a form where one field is locked is a finding about that field, and\n * abandoning the other twenty would throw away the run that found it.\n */\nexport async function fillForm(\n  form: DiscoveredForm,\n  strategy: FormStrategy,\n  options: { timeout_ms?: number } = {},\n): Promise<FillResult> {\n  const timeout = options.timeout_ms ?? SELECTOR_TIMEOUT_MS;\n  const result: FillResult = { filled: [], failed: [], skipped: [] };\n  /** Radio groups already answered — one choice per group, not one per button. */\n  const groups = new Set<string>();\n\n  for (let i = 0; i < form.fields.length; i++) {\n    const { info, handle } = form.fields[i];\n    try {\n      const outcome = await fillField(handle, info, strategy, i, timeout, groups);\n      if (\"reason\" in outcome) result.skipped.push({ description: info.description, reason: outcome.reason });\n      else result.filled.push(outcome);\n    } catch (error) {\n      result.failed.push({ description: info.description, reason: firstLine(error) });\n    }\n  }\n\n  return result;\n}\n\nexport interface FilledField {\n  description: string;\n  kind: FieldKind;\n  /** What the strategy asked for, elided for the report. */\n  requested: string;\n  requested_length: number;\n  /** What the field actually holds now, elided for the report. */\n  landed: string;\n  landed_length: number;\n  /** True when the page kept less than it was given — a limit nothing declared. */\n  truncated: boolean;\n  /** For checkboxes and radios. */\n  checked?: boolean;\n}\n\nexport interface FillResult {\n  filled: FilledField[];\n  failed: FieldProblem[];\n  /** Fields this strategy deliberately left alone, with the reason. */\n  skipped: FieldProblem[];\n}\n\nasync function fillField(\n  handle: ElementHandle,\n  info: FieldInfo,\n  strategy: FormStrategy,\n  variant: number,\n  timeout: number,\n  groups: Set<string>,\n): Promise<FilledField | { reason: string }> {\n  if (info.kind === \"toggle\") {\n    const want = checkedFor(strategy);\n    if (info.type === \"radio\") {\n      // Clicking a radio cannot clear it, only move the choice elsewhere.\n      if (!want) return { reason: \"a radio button cannot be cleared, only replaced\" };\n      const group = info.name ?? info.description;\n      if (groups.has(group)) return { reason: `another option in the \"${group}\" group was chosen` };\n      groups.add(group);\n      await handle.check({ timeout });\n    } else {\n      await handle.setChecked(want, { timeout });\n    }\n    const state = await readBack(handle);\n    return {\n      description: info.description,\n      kind: info.kind,\n      requested: want ? \"checked\" : \"unchecked\",\n      requested_length: 0,\n      landed: state.checked ? \"checked\" : \"unchecked\",\n      landed_length: 0,\n      truncated: false,\n      checked: state.checked,\n    };\n  }\n\n  if (info.kind === \"choice\") {\n    const option = optionFor({ ...info, options: info.options ?? [] }, strategy);\n    if (option === null) return { reason: \"no option to choose — every option is disabled\" };\n    await handle.selectOption(option, { timeout });\n    const state = await readBack(handle);\n    return {\n      description: info.description,\n      kind: info.kind,\n      requested: elide(option),\n      requested_length: option.length,\n      landed: elide(state.value),\n      landed_length: state.value.length,\n      truncated: false,\n    };\n  }\n\n  const requested = valueFor(info, strategy, variant);\n  await handle.fill(requested, { timeout });\n  const state = await readBack(handle);\n  return {\n    description: info.description,\n    kind: info.kind,\n    requested: elide(requested),\n    requested_length: requested.length,\n    landed: elide(state.value),\n    landed_length: state.value.length,\n    // Only ever shorter: a page that appends to what was typed (a formatter\n    // adding separators) is not truncating it.\n    truncated: state.value.length < requested.length,\n  };\n}\n\nfunction readBack(handle: ElementHandle): Promise<{ value: string; checked: boolean }> {\n  return handle.evaluate((node: any) => ({\n    value: typeof node.value === \"string\" ? node.value : \"\",\n    checked: node.checked === true,\n  }));\n}\n\nexport interface SubmitResult {\n  ok: boolean;\n  /** What was done — `clicked \"#submit\"`, `pressed Enter in \"#q\"`. */\n  how: string;\n  /** Why nothing was done, when `ok` is false. */\n  reason?: string;\n}\n\n/**\n * Send the form the way a person would.\n *\n * A real submit control comes first, then a button whose text says what it\n * does, then Enter in a text field — which is how a search box with no button\n * is submitted, and the only route left when the markup names nothing. A form\n * that offers none of those is reported rather than forced: calling\n * `form.submit()` from script would skip the page's own submit handler and\n * validation, which is the thing under test.\n */\nexport async function submitForm(form: DiscoveredForm, options: { timeout_ms?: number } = {}): Promise<SubmitResult> {\n  const timeout = options.timeout_ms ?? SELECTOR_TIMEOUT_MS;\n  const control = await findSubmitControl(form);\n\n  if (control) {\n    try {\n      await control.handle.click({ timeout });\n      return { ok: true, how: `clicked \"${control.description}\"` };\n    } catch (error) {\n      // A click that navigates can detach the button underneath Playwright;\n      // the submit happened either way, which the URL proves.\n      if (form.page.url() !== control.url_before) {\n        return { ok: true, how: `clicked \"${control.description}\"` };\n      }\n      return { ok: false, how: `tried to click \"${control.description}\"`, reason: firstLine(error) };\n    }\n  }\n\n  const typed = form.fields.find((field) => field.info.kind === \"text\");\n  if (form.is_form && typed) {\n    try {\n      await typed.handle.press(\"Enter\", { timeout });\n      return { ok: true, how: `pressed Enter in \"${typed.info.description}\"` };\n    } catch (error) {\n      return { ok: false, how: `tried to press Enter in \"${typed.info.description}\"`, reason: firstLine(error) };\n    }\n  }\n\n  return {\n    ok: false,\n    how: \"nothing\",\n    reason: form.is_form\n      ? \"no submit control found — no button, and no text field to press Enter in\"\n      : \"no submit control found — no button, and this is not a <form>, so Enter has nothing to submit\",\n  };\n}\n\ninterface SubmitControl {\n  handle: ElementHandle;\n  description: string;\n  url_before: string;\n}\n\nasync function findSubmitControl(form: DiscoveredForm): Promise<SubmitControl | null> {\n  const handles = await form.root.$$(SUBMIT_SELECTOR);\n  if (handles.length === 0) return null;\n\n  const described = await Promise.all(handles.map((handle) => handle.evaluate(describeButton)));\n  const usable = described\n    .map((button, index) => ({ button, index }))\n    .filter(({ button }) => button.usable);\n  if (usable.length === 0) return null;\n\n  const declared = usable.find(({ button }) => button.type === \"submit\" || button.type === \"image\");\n  const worded = usable.find(({ button }) => SUBMIT_WORDS.test(button.text));\n  const chosen = declared ?? worded ?? usable[0];\n\n  return {\n    handle: handles[chosen.index],\n    description: chosen.button.description,\n    url_before: form.page.url(),\n  };\n}\n\nexport interface ValidationSnapshot {\n  /** The browser's own constraint validation, per field that fails it. */\n  browser: Array<{ field: string; message: string }>;\n  /** Messages visible on the page — the app's own validation, plus any alert or toast. */\n  messages: string[];\n  /** Fields the page marked `aria-invalid`. */\n  invalid: string[];\n}\n\n/**\n * What the page says about the state it is in.\n *\n * Two independent sources, because apps use one, the other or both: the\n * browser's constraint validation (`required`, `type=email`, `min`), which is\n * true whether or not the app ever shows it, and the text actually visible on\n * screen, which is what a user would see. Neither is meaningful alone —\n * constraint validation on a form with `novalidate` never reaches the user,\n * and visible text tells you nothing about which field it belongs to.\n */\nexport async function readValidation(page: Page, form: DiscoveredForm): Promise<ValidationSnapshot> {\n  const states = await Promise.all(\n    form.fields.map(async (field) => ({\n      field: field.info.description,\n      ...(await field.handle.evaluate(readFieldValidity).catch(() => ({ valid: true, message: \"\", invalid: false }))),\n    })),\n  );\n\n  const messages = await page\n    .evaluate(scanMessages, { selector: MESSAGE_SELECTOR, max: MAX_FORM_MESSAGES, max_length: MAX_FORM_MESSAGE_LENGTH })\n    .catch(() => [] as string[]);\n\n  return {\n    browser: states\n      .filter((state) => !state.valid && state.message !== \"\")\n      .map((state) => ({ field: state.field, message: state.message })),\n    messages,\n    invalid: states.filter((state) => state.invalid).map((state) => state.field),\n  };\n}\n\n/** Messages that were not on the page before — the ones this strategy caused. */\nexport function newMessages(before: ValidationSnapshot, after: ValidationSnapshot): string[] {\n  return after.messages.filter((message) => !before.messages.includes(message));\n}\n\n/**\n * Whether an XSS payload has executed on this page (see `XSS_MARKER`).\n *\n * Reading a marker the payload itself sets is the only honest answer to \"did\n * my input run as code\". Looking for the payload in the DOM afterwards is not:\n * an input's `value` serialises with its angle brackets intact, so a page that\n * escaped everything perfectly would still look like a hit.\n */\nexport async function readXssMarker(page: Page): Promise<boolean> {\n  try {\n    return await page.evaluate((name: string) => Boolean((globalThis as any)[name]), XSS_MARKER);\n  } catch {\n    return false;\n  }\n}\n\n/* ── In-page readers ──────────────────────────────────────────────────────\n * Everything below runs inside Chromium, so it is written against\n * `globalThis` and untyped nodes: this package is compiled with the Node lib\n * only, and the page it lands in may be mid-teardown, using a framework that\n * has patched half of these properties, or both.\n */\n\ninterface RawField {\n  tag: string;\n  type: string;\n  description: string;\n  name?: string;\n  label?: string;\n  placeholder?: string;\n  maxlength?: number;\n  min?: string;\n  max?: string;\n  step?: string;\n  required: boolean;\n  options?: OptionInfo[];\n  /** Why this field cannot be filled. Absent when it can. */\n  skip?: string;\n}\n\nfunction describeField(node: any): RawField {\n  const tag = String(node.tagName ?? \"\").toLowerCase();\n  const type = tag === \"textarea\" ? \"textarea\" : String(node.type ?? \"text\").toLowerCase();\n  const attr = (name: string): string | undefined => {\n    const value = node.getAttribute ? node.getAttribute(name) : null;\n    return value === null || value === undefined ? undefined : String(value);\n  };\n\n  const flatten = (text: unknown): string => String(text ?? \"\").replace(/\\s+/g, \" \").trim();\n  const id = node.id ? String(node.id) : \"\";\n  const name = node.name ? String(node.name) : \"\";\n  const description = id ? `#${id}` : name ? `[name=\"${name}\"]` : tag === \"input\" ? `input[type=${type}]` : tag;\n\n  let label = \"\";\n  try {\n    const labels = node.labels;\n    if (labels && labels.length > 0) label = flatten(labels[0].textContent);\n    if (!label) label = flatten(attr(\"aria-label\"));\n    if (!label) {\n      const by = attr(\"aria-labelledby\");\n      const target = by ? (globalThis as any).document?.getElementById(by.split(/\\s+/)[0]) : null;\n      if (target) label = flatten(target.textContent);\n    }\n    if (!label && node.closest) label = flatten(node.closest(\"label\")?.textContent);\n  } catch {\n    label = \"\";\n  }\n\n  const visible = (() => {\n    try {\n      return node.getClientRects ? node.getClientRects().length > 0 : true;\n    } catch {\n      return true;\n    }\n  })();\n\n  const skip = ((): string | undefined => {\n    if (type === \"hidden\") return \"hidden input\";\n    if (node.disabled === true) return \"disabled\";\n    if (node.readOnly === true) return \"read-only\";\n    if (type === \"file\") return \"file input — a file cannot be chosen from a script\";\n    if (type === \"submit\" || type === \"button\" || type === \"reset\" || type === \"image\") return \"not an input field\";\n    if (!visible) return \"not visible\";\n    return undefined;\n  })();\n\n  const maxLength = typeof node.maxLength === \"number\" && node.maxLength > 0 ? node.maxLength : undefined;\n  const options =\n    tag === \"select\" && node.options\n      ? Array.from(node.options as any[]).map((option: any) => ({\n          value: String(option.value ?? \"\"),\n          label: flatten(option.textContent),\n          disabled: option.disabled === true,\n        }))\n      : undefined;\n\n  return {\n    tag,\n    type,\n    description,\n    ...(name ? { name } : {}),\n    ...(label ? { label: label.slice(0, 80) } : {}),\n    ...(attr(\"placeholder\") ? { placeholder: attr(\"placeholder\") } : {}),\n    ...(maxLength !== undefined ? { maxlength: maxLength } : {}),\n    ...(attr(\"min\") !== undefined ? { min: attr(\"min\") } : {}),\n    ...(attr(\"max\") !== undefined ? { max: attr(\"max\") } : {}),\n    ...(attr(\"step\") !== undefined ? { step: attr(\"step\") } : {}),\n    required: node.required === true,\n    ...(options ? { options } : {}),\n    ...(skip !== undefined ? { skip } : {}),\n  };\n}\n\nfunction describeRoot(node: any): { description: string; is_form: boolean } {\n  const tag = String(node.tagName ?? \"\").toLowerCase();\n  const id = node.id ? `#${String(node.id)}` : \"\";\n  const name = node.name ? `[name=\"${String(node.name)}\"]` : \"\";\n  const action = node.getAttribute && node.getAttribute(\"action\") ? `[action=\"${node.getAttribute(\"action\")}\"]` : \"\";\n  return { description: id || name || `${tag}${action}`, is_form: tag === \"form\" };\n}\n\nfunction describeButton(node: any): { usable: boolean; type: string; text: string; description: string } {\n  const tag = String(node.tagName ?? \"\").toLowerCase();\n  const type = String(node.type ?? \"\").toLowerCase();\n  const flatten = (text: unknown): string => String(text ?? \"\").replace(/\\s+/g, \" \").trim();\n  const id = node.id ? String(node.id) : \"\";\n  const name = node.name ? String(node.name) : \"\";\n  const text = flatten(node.textContent) || flatten(node.value) || flatten(node.getAttribute?.(\"aria-label\"));\n\n  let visible = true;\n  try {\n    visible = node.getClientRects ? node.getClientRects().length > 0 : true;\n  } catch {\n    visible = true;\n  }\n\n  return {\n    usable: visible && node.disabled !== true,\n    type,\n    text,\n    description: id ? `#${id}` : name ? `[name=\"${name}\"]` : text ? `${tag} \"${text.slice(0, 40)}\"` : tag,\n  };\n}\n\nfunction readFieldValidity(node: any): { valid: boolean; message: string; invalid: boolean } {\n  // `validity`, never `checkValidity()`: the call fires an `invalid` event the\n  // page can see and act on, and reading the state must not change it.\n  const validity = node.validity;\n  return {\n    valid: validity ? validity.valid === true : true,\n    message: String(node.validationMessage ?? \"\"),\n    invalid: node.getAttribute ? node.getAttribute(\"aria-invalid\") === \"true\" : false,\n  };\n}\n\nfunction scanMessages(options: { selector: string; max: number; max_length: number }): string[] {\n  const doc = (globalThis as any).document;\n  if (!doc) return [];\n\n  let nodes: any[] = [];\n  try {\n    nodes = Array.from(doc.querySelectorAll(options.selector) as any[]);\n  } catch {\n    return [];\n  }\n\n  const visible = nodes.filter((node) => {\n    try {\n      return node.getClientRects && node.getClientRects().length > 0;\n    } catch {\n      return false;\n    }\n  });\n  // Keep the innermost of a nest: a wrapper element matching on its class name\n  // would otherwise contribute the whole panel's text as one \"message\".\n  const innermost = visible.filter((node) => !visible.some((other) => other !== node && node.contains(other)));\n\n  const messages: string[] = [];\n  for (const node of innermost) {\n    const text = String(node.textContent ?? \"\")\n      .replace(/\\s+/g, \" \")\n      .trim();\n    if (text === \"\" || text.length > options.max_length) continue;\n    if (!messages.includes(text)) messages.push(text);\n    if (messages.length >= options.max) break;\n  }\n  return messages;\n}\n\n/* ── Helpers ──────────────────────────────────────────────────────────── */\n\nfunction toFieldInfo(raw: RawField): FieldInfo {\n  const kind: FieldKind =\n    raw.tag === \"select\" ? \"choice\" : raw.type === \"checkbox\" || raw.type === \"radio\" ? \"toggle\" : \"text\";\n  const { skip: _skip, ...rest } = raw;\n  return { ...rest, kind };\n}\n\nfunction elide(value: string, max: number = MAX_FORM_TEXT_LENGTH): string {\n  const flat = value.replace(/\\s+/g, \" \");\n  return flat.length > max ? `${flat.slice(0, max)}…` : flat;\n}\n\nfunction firstLine(error: unknown): string {\n  return (error instanceof Error ? error.message : String(error)).split(\"\\n\")[0];\n}\n"]}

package/dist/engine/hmr.d.ts

@@ -0,0 +1,41 @@
+import type { Page } from "playwright";
+/**
+ * What Vite did to the session page while nobody was looking.
+ *
+ * Vite's client announces every hot update in the console, so a watcher on
+ * the page can tell the difference between "the page has not changed since
+ * you saved" and "it changed 300ms ago" without reloading anything. The
+ * watcher belongs to the session page and lives as long as it does: it is
+ * attached when the page is created (see `getSessionPage`), and every tool
+ * that touches the page stamps `markSeen` on its way out. "Since the last
+ * look" is then exactly the window `framewatch_wait_for` cares about — an
+ * update that landed between the agent's save and its next call still
+ * counts, and one from an earlier edit does not.
+ */
+export interface HmrEvent {
+    /** Epoch ms. */
+    t: number;
+    kind: "update" | "css" | "reload";
+    path: string;
+}
+export declare class HmrWatcher {
+    #private;
+    constructor(page: Page);
+    /** Vite's client said hello, or has sent an update: this is a dev-server page. */
+    get connected(): boolean;
+    /** When a tool last looked at this page. */
+    get lastSeen(): number;
+    markSeen(): void;
+    /** The most recent event, whenever it happened. */
+    get latest(): HmrEvent | undefined;
+    /**
+     * The first event newer than `since`, waiting up to `timeoutMs` for one to
+     * arrive. Resolves immediately when one already has.
+     */
+    waitForEvent(since: number, timeoutMs: number): Promise<HmrEvent | null>;
+    detach(): void;
+}
+/** The watcher for `page`, created (and attached) on first use. */
+export declare function hmrFor(page: Page): HmrWatcher;
+/** Whether the page loaded Vite's client script — a dev-server page even before it logged anything. */
+export declare function hasViteClient(page: Page): Promise<boolean>;