framewatch-mcp-server 0.1.0 → 0.2.0

package/dist/engine/hmr.js

@@ -0,0 +1,91 @@
+import { MAX_HMR_EVENTS } from "../constants.js";
+import { parseViteLine } from "../utils/vue-rules.js";
+export class HmrWatcher {
+    #page;
+    #events = [];
+    #waiters = new Set();
+    #connected = false;
+    #lastSeen = Date.now();
+    constructor(page) {
+        this.#page = page;
+        page.on("console", this.#onConsole);
+    }
+    /** Vite's client said hello, or has sent an update: this is a dev-server page. */
+    get connected() {
+        return this.#connected || this.#events.length > 0;
+    }
+    /** When a tool last looked at this page. */
+    get lastSeen() {
+        return this.#lastSeen;
+    }
+    markSeen() {
+        this.#lastSeen = Date.now();
+    }
+    /** The most recent event, whenever it happened. */
+    get latest() {
+        return this.#events[this.#events.length - 1];
+    }
+    /**
+     * The first event newer than `since`, waiting up to `timeoutMs` for one to
+     * arrive. Resolves immediately when one already has.
+     */
+    waitForEvent(since, timeoutMs) {
+        const already = this.#events.find((event) => event.t > since);
+        if (already)
+            return Promise.resolve(already);
+        return new Promise((resolve) => {
+            const done = (event) => {
+                clearTimeout(timer);
+                this.#waiters.delete(onEvent);
+                resolve(event);
+            };
+            const onEvent = (event) => {
+                if (event.t > since)
+                    done(event);
+            };
+            const timer = setTimeout(() => done(null), Math.max(0, timeoutMs));
+            this.#waiters.add(onEvent);
+        });
+    }
+    detach() {
+        this.#page.off("console", this.#onConsole);
+    }
+    #onConsole = (message) => {
+        const event = parseViteLine(message.text());
+        if (!event)
+            return;
+        if (event.kind === "connected") {
+            this.#connected = true;
+            return;
+        }
+        const record = { t: Date.now(), kind: event.kind, path: event.path };
+        this.#events.push(record);
+        if (this.#events.length > MAX_HMR_EVENTS)
+            this.#events.shift();
+        for (const waiter of [...this.#waiters])
+            waiter(record);
+    };
+}
+const byPage = new WeakMap();
+/** The watcher for `page`, created (and attached) on first use. */
+export function hmrFor(page) {
+    const existing = byPage.get(page);
+    if (existing)
+        return existing;
+    const created = new HmrWatcher(page);
+    byPage.set(page, created);
+    return created;
+}
+/** Whether the page loaded Vite's client script — a dev-server page even before it logged anything. */
+export async function hasViteClient(page) {
+    try {
+        return await page.evaluate(() => {
+            const doc = globalThis.document;
+            return !!(doc && doc.querySelector('script[src*="/@vite/client"]'));
+        });
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=hmr.js.map

package/dist/engine/hmr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.js","sourceRoot":"","sources":["../../src/engine/hmr.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConsoleMessage, Page } from \"playwright\";\nimport { MAX_HMR_EVENTS } from \"../constants.js\";\nimport { parseViteLine } from \"../utils/vue-rules.js\";\n\n/**\n * What Vite did to the session page while nobody was looking.\n *\n * Vite's client announces every hot update in the console, so a watcher on\n * the page can tell the difference between \"the page has not changed since\n * you saved\" and \"it changed 300ms ago\" without reloading anything. The\n * watcher belongs to the session page and lives as long as it does: it is\n * attached when the page is created (see `getSessionPage`), and every tool\n * that touches the page stamps `markSeen` on its way out. \"Since the last\n * look\" is then exactly the window `framewatch_wait_for` cares about — an\n * update that landed between the agent's save and its next call still\n * counts, and one from an earlier edit does not.\n */\n\nexport interface HmrEvent {\n  /** Epoch ms. */\n  t: number;\n  kind: \"update\" | \"css\" | \"reload\";\n  path: string;\n}\n\nexport class HmrWatcher {\n  readonly #page: Page;\n  readonly #events: HmrEvent[] = [];\n  readonly #waiters = new Set<(event: HmrEvent) => void>();\n  #connected = false;\n  #lastSeen: number = Date.now();\n\n  constructor(page: Page) {\n    this.#page = page;\n    page.on(\"console\", this.#onConsole);\n  }\n\n  /** Vite's client said hello, or has sent an update: this is a dev-server page. */\n  get connected(): boolean {\n    return this.#connected || this.#events.length > 0;\n  }\n\n  /** When a tool last looked at this page. */\n  get lastSeen(): number {\n    return this.#lastSeen;\n  }\n\n  markSeen(): void {\n    this.#lastSeen = Date.now();\n  }\n\n  /** The most recent event, whenever it happened. */\n  get latest(): HmrEvent | undefined {\n    return this.#events[this.#events.length - 1];\n  }\n\n  /**\n   * The first event newer than `since`, waiting up to `timeoutMs` for one to\n   * arrive. Resolves immediately when one already has.\n   */\n  waitForEvent(since: number, timeoutMs: number): Promise<HmrEvent | null> {\n    const already = this.#events.find((event) => event.t > since);\n    if (already) return Promise.resolve(already);\n    return new Promise((resolve) => {\n      const done = (event: HmrEvent | null): void => {\n        clearTimeout(timer);\n        this.#waiters.delete(onEvent);\n        resolve(event);\n      };\n      const onEvent = (event: HmrEvent): void => {\n        if (event.t > since) done(event);\n      };\n      const timer = setTimeout(() => done(null), Math.max(0, timeoutMs));\n      this.#waiters.add(onEvent);\n    });\n  }\n\n  detach(): void {\n    this.#page.off(\"console\", this.#onConsole);\n  }\n\n  readonly #onConsole = (message: ConsoleMessage): void => {\n    const event = parseViteLine(message.text());\n    if (!event) return;\n    if (event.kind === \"connected\") {\n      this.#connected = true;\n      return;\n    }\n    const record: HmrEvent = { t: Date.now(), kind: event.kind, path: event.path };\n    this.#events.push(record);\n    if (this.#events.length > MAX_HMR_EVENTS) this.#events.shift();\n    for (const waiter of [...this.#waiters]) waiter(record);\n  };\n}\n\nconst byPage = new WeakMap<Page, HmrWatcher>();\n\n/** The watcher for `page`, created (and attached) on first use. */\nexport function hmrFor(page: Page): HmrWatcher {\n  const existing = byPage.get(page);\n  if (existing) return existing;\n  const created = new HmrWatcher(page);\n  byPage.set(page, created);\n  return created;\n}\n\n/** Whether the page loaded Vite's client script — a dev-server page even before it logged anything. */\nexport async function hasViteClient(page: Page): Promise<boolean> {\n  try {\n    return await page.evaluate(() => {\n      const doc = (globalThis as any).document;\n      return !!(doc && doc.querySelector('script[src*=\"/@vite/client\"]'));\n    });\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/engine/inspect.d.ts

@@ -0,0 +1,31 @@
+import type { Page } from "playwright";
+import { type ElementMeasurement, type PageInventory } from "../utils/style-rules.js";
+import type { ComponentInfo, ComponentUnavailable } from "../utils/vue-rules.js";
+/**
+ * How an element is built, measured inside the page.
+ *
+ * A screenshot shows what a button looks like; this says what it *is*: the
+ * box in viewport pixels, the font, the colours it actually renders in (a
+ * transparent background resolved through its ancestors), the spacing, and
+ * where it sits against its parent and the sibling before it. That is what an
+ * agent needs to check its own work against the design it meant to build.
+ *
+ * Every number is read in one `evaluate` per element and judged in
+ * `style-rules.ts`, which never sees a browser.
+ */
+export interface InspectResult {
+    target: string;
+    measurement?: ElementMeasurement;
+    /** Why there is no measurement: the target resolved to nothing. */
+    error?: string;
+    /** The Vue component behind the element, when asked for and present. */
+    component?: ComponentInfo | ComponentUnavailable;
+}
+export interface MeasureOptions {
+    /** Also read the Vue component that rendered each element. */
+    components?: boolean;
+}
+/** Measure each target — a snapshot ref (`e8`) or a CSS selector — in order. */
+export declare function measureElements(page: Page, targets: readonly string[], options?: MeasureOptions): Promise<InspectResult[]>;
+/** Every font, size, weight, colour, spacing value and radius the page (or `selector`) uses. */
+export declare function inventoryPage(page: Page, selector?: string): Promise<PageInventory>;

package/dist/engine/inspect.js

@@ -0,0 +1,383 @@
+import { MAX_INSPECT_TEXT_LENGTH, MAX_INVENTORY_ELEMENTS, MAX_INVENTORY_VALUES, SELECTOR_TIMEOUT_MS, } from "../constants.js";
+import { isRef, refSelector } from "../utils/snapshot-rules.js";
+import { parseColour, toHex } from "../utils/style-rules.js";
+import { componentOf } from "./vue.js";
+/** Measure each target — a snapshot ref (`e8`) or a CSS selector — in order. */
+export async function measureElements(page, targets, options = {}) {
+    const results = [];
+    for (const target of targets) {
+        const result = await measureOne(page, target);
+        if (options.components && result.measurement) {
+            const component = await componentOf(resolve(page, target));
+            if (component)
+                result.component = component;
+        }
+        results.push(result);
+    }
+    return results;
+}
+async function measureOne(page, target) {
+    const locator = resolve(page, target);
+    let count;
+    try {
+        count = await locator.count();
+    }
+    catch (error) {
+        return { target, error: `could not be resolved: ${firstLine(error)}` };
+    }
+    if (count === 0) {
+        return {
+            target,
+            error: isRef(target)
+                ? "did not resolve — the page has changed since that snapshot, or none was taken; run framewatch_snapshot again"
+                : "matched nothing",
+        };
+    }
+    try {
+        const raw = await locator.evaluate(measureInPage, { max_text: MAX_INSPECT_TEXT_LENGTH }, { timeout: SELECTOR_TIMEOUT_MS });
+        return { target, measurement: { target, ...raw } };
+    }
+    catch (error) {
+        return { target, error: `could not be measured: ${firstLine(error)}` };
+    }
+}
+function resolve(page, target) {
+    return isRef(target) ? page.locator(refSelector(target)) : page.locator(target).first();
+}
+function firstLine(error) {
+    return (error instanceof Error ? error.message : String(error)).split("\n")[0];
+}
+/* ── Inventory ────────────────────────────────────────────────────────── */
+/** Every font, size, weight, colour, spacing value and radius the page (or `selector`) uses. */
+export async function inventoryPage(page, selector) {
+    const raw = await page.evaluate(inventoryInPage, { selector: selector ?? null, max_elements: MAX_INVENTORY_ELEMENTS });
+    const tally = (map, normalise = (v) => v) => {
+        const merged = new Map();
+        for (const [value, count] of Object.entries(map)) {
+            const key = normalise(value);
+            if (key === null)
+                continue;
+            merged.set(key, (merged.get(key) ?? 0) + count);
+        }
+        return [...merged.entries()]
+            .map(([value, count]) => ({ value, count }))
+            .sort((a, b) => b.count - a.count || a.value.localeCompare(b.value))
+            .slice(0, MAX_INVENTORY_VALUES);
+    };
+    const hex = (value) => {
+        const colour = parseColour(value);
+        if (!colour || colour.a === 0)
+            return null;
+        return toHex(colour);
+    };
+    return {
+        elements: raw.elements,
+        text_elements: raw.text_elements,
+        fonts: tally(raw.fonts),
+        font_sizes: tally(raw.font_sizes),
+        font_weights: tally(raw.font_weights),
+        text_colours: tally(raw.text_colours, hex),
+        backgrounds: tally(raw.backgrounds, hex),
+        spacing: tally(raw.spacing),
+        radii: tally(raw.radii),
+    };
+}
+function measureInPage(element, config) {
+    const g = globalThis;
+    const win = g.window;
+    const doc = g.document;
+    const px = (value) => {
+        const n = parseFloat(value);
+        return Number.isFinite(n) ? Math.round(n * 100) / 100 : 0;
+    };
+    const rect = (node) => {
+        const r = node.getBoundingClientRect();
+        return { x: Math.round(r.left), y: Math.round(r.top), width: Math.round(r.width), height: Math.round(r.height) };
+    };
+    const style = win.getComputedStyle(element);
+    const box = rect(element);
+    // Effective background: composite this element's own over each ancestor's
+    // until one is opaque. Done here as a list of layers, blended in Node.
+    const layers = [];
+    let node = element;
+    while (node && node.nodeType === 1) {
+        const bg = win.getComputedStyle(node).backgroundColor;
+        layers.push(bg);
+        if (/^rgb\(/.test(bg))
+            break;
+        node = node.parentElement;
+    }
+    const background = blend(layers);
+    // Clipped by an ancestor whose overflow is not visible.
+    let clipped = false;
+    let ancestor = element.parentElement;
+    while (ancestor && ancestor !== doc.documentElement) {
+        const s = win.getComputedStyle(ancestor);
+        if (s.overflow !== "visible" || s.overflowX !== "visible" || s.overflowY !== "visible") {
+            const a = ancestor.getBoundingClientRect();
+            const r = element.getBoundingClientRect();
+            if (r.left < a.left - 0.5 || r.right > a.right + 0.5 || r.top < a.top - 0.5 || r.bottom > a.bottom + 0.5) {
+                clipped = true;
+                break;
+            }
+        }
+        ancestor = ancestor.parentElement;
+    }
+    const vw = win.innerWidth;
+    const vh = win.innerHeight;
+    const r = element.getBoundingClientRect();
+    const inside = r.left >= 0 && r.top >= 0 && r.right <= vw && r.bottom <= vh;
+    const outside = r.right <= 0 || r.bottom <= 0 || r.left >= vw || r.top >= vh;
+    const in_viewport = inside ? "fully" : outside ? "none" : "partially";
+    const opacity = px(style.opacity);
+    const visible = style.display !== "none" && style.visibility !== "hidden" && opacity > 0 && r.width > 0 && r.height > 0;
+    const text_overflows = element.scrollWidth > element.clientWidth + 1 || element.scrollHeight > element.clientHeight + 1;
+    const ownText = () => {
+        let out = "";
+        const children = element.childNodes;
+        for (let i = 0; i < children.length; i++) {
+            if (children[i].nodeType === 3)
+                out += children[i].nodeValue;
+        }
+        out = out.replace(/\s+/g, " ").trim();
+        if (out === "" && typeof element.value === "string")
+            out = element.value;
+        if (out === "")
+            out = String(element.textContent || "").replace(/\s+/g, " ").trim();
+        return out.length > config.max_text ? out.slice(0, config.max_text) + "…" : out;
+    };
+    const accessibleName = () => {
+        const label = element.getAttribute("aria-label");
+        if (label)
+            return String(label).trim();
+        const labelledBy = element.getAttribute("aria-labelledby");
+        if (labelledBy) {
+            const names = String(labelledBy)
+                .split(/\s+/)
+                .map((id) => doc.getElementById(id))
+                .filter(Boolean)
+                .map((n) => String(n.textContent || "").replace(/\s+/g, " ").trim());
+            if (names.length > 0)
+                return names.join(" ");
+        }
+        if (element.labels && element.labels.length > 0) {
+            return String(element.labels[0].textContent || "").replace(/\s+/g, " ").trim();
+        }
+        const alt = element.getAttribute("alt");
+        if (alt)
+            return String(alt).trim();
+        const title = element.getAttribute("title");
+        if (title)
+            return String(title).trim();
+        const tag = String(element.tagName).toLowerCase();
+        if (tag === "button" || tag === "a" || /^h[1-6]$/.test(tag) || element.getAttribute("role")) {
+            const text = String(element.textContent || "").replace(/\s+/g, " ").trim();
+            return text === "" ? undefined : text.length > config.max_text ? text.slice(0, config.max_text) + "…" : text;
+        }
+        return undefined;
+    };
+    const implicitRole = () => {
+        const explicit = element.getAttribute("role");
+        if (explicit)
+            return String(explicit);
+        const tag = String(element.tagName).toLowerCase();
+        const type = String(element.getAttribute("type") || "").toLowerCase();
+        if (tag === "button")
+            return "button";
+        if (tag === "a" && element.hasAttribute("href"))
+            return "link";
+        if (/^h[1-6]$/.test(tag))
+            return "heading";
+        if (tag === "input") {
+            if (type === "checkbox")
+                return "checkbox";
+            if (type === "radio")
+                return "radio";
+            if (type === "button" || type === "submit" || type === "reset")
+                return "button";
+            if (type === "range")
+                return "slider";
+            if (type === "number")
+                return "spinbutton";
+            return "textbox";
+        }
+        if (tag === "textarea")
+            return "textbox";
+        if (tag === "select")
+            return "combobox";
+        if (tag === "img")
+            return "img";
+        if (tag === "nav")
+            return "navigation";
+        if (tag === "main")
+            return "main";
+        if (tag === "p")
+            return "paragraph";
+        if (tag === "ul" || tag === "ol")
+            return "list";
+        if (tag === "li")
+            return "listitem";
+        return undefined;
+    };
+    const neighbour = (node) => node && node.nodeType === 1 ? { tag: String(node.tagName).toLowerCase(), box: rect(node) } : undefined;
+    const lineHeight = style.lineHeight === "normal" ? null : px(style.lineHeight);
+    const gap = style.display.indexOf("flex") !== -1 || style.display.indexOf("grid") !== -1 ? px(style.rowGap === "normal" ? "0" : style.rowGap) : null;
+    const name = accessibleName();
+    const classes = [];
+    if (element.classList)
+        for (let i = 0; i < element.classList.length && i < 4; i++)
+            classes.push(String(element.classList[i]));
+    const out = {
+        tag: String(element.tagName).toLowerCase(),
+        classes,
+        box,
+        visible,
+        in_viewport,
+        clipped,
+        text_overflows,
+        display: String(style.display),
+        position: String(style.position),
+        opacity,
+        font: {
+            family: String(style.fontFamily).split(",")[0].replace(/["']/g, "").trim(),
+            size: px(style.fontSize),
+            weight: px(style.fontWeight),
+            line_height: lineHeight,
+            style: String(style.fontStyle),
+        },
+        color: String(style.color),
+        background,
+        padding: [px(style.paddingTop), px(style.paddingRight), px(style.paddingBottom), px(style.paddingLeft)],
+        margin: [px(style.marginTop), px(style.marginRight), px(style.marginBottom), px(style.marginLeft)],
+        gap,
+        border: `${style.borderTopWidth} ${style.borderTopStyle} ${style.borderTopColor}`,
+        radius: String(style.borderTopLeftRadius),
+    };
+    if (element.id)
+        out.id = String(element.id);
+    const role = implicitRole();
+    if (role !== undefined)
+        out.role = role;
+    if (name !== undefined)
+        out.name = name;
+    const text = ownText();
+    if (text !== "")
+        out.text = text;
+    const parent = neighbour(element.parentElement);
+    if (parent)
+        out.parent = parent;
+    const previous = neighbour(element.previousElementSibling);
+    if (previous)
+        out.previous = previous;
+    return out;
+    /** Composite `layers[0]` over `layers[1]` over … ; returns an rgb()/rgba() string. */
+    function blend(list) {
+        const parse = (value) => {
+            const m = /^rgba?\(\s*([\d.]+)\s*,\s*([\d.]+)\s*,\s*([\d.]+)\s*(?:,\s*([\d.]+)\s*)?\)$/.exec(value);
+            if (!m)
+                return value === "transparent" ? [0, 0, 0, 0] : null;
+            return [Number(m[1]), Number(m[2]), Number(m[3]), m[4] === undefined ? 1 : Number(m[4])];
+        };
+        // Start from the deepest (last) layer and paint each one above it on top.
+        let acc = null;
+        for (let i = list.length - 1; i >= 0; i--) {
+            const top = parse(list[i]);
+            if (!top)
+                continue;
+            if (!acc || top[3] >= 1) {
+                acc = top;
+                continue;
+            }
+            if (top[3] <= 0)
+                continue;
+            const below = acc;
+            const a = top[3] + below[3] * (1 - top[3]);
+            const mix = (t, b) => Math.round((t * top[3] + b * below[3] * (1 - top[3])) / a);
+            acc = [mix(top[0], below[0]), mix(top[1], below[1]), mix(top[2], below[2]), a];
+        }
+        if (!acc)
+            return "rgba(0, 0, 0, 0)";
+        // The page's canvas is white under everything that is still translucent.
+        if (acc[3] < 1) {
+            const a = acc[3];
+            acc = [Math.round(acc[0] * a + 255 * (1 - a)), Math.round(acc[1] * a + 255 * (1 - a)), Math.round(acc[2] * a + 255 * (1 - a)), 1];
+        }
+        return `rgb(${acc[0]}, ${acc[1]}, ${acc[2]})`;
+    }
+}
+function inventoryInPage(config) {
+    const g = globalThis;
+    const win = g.window;
+    const doc = g.document;
+    const out = {
+        elements: 0,
+        text_elements: 0,
+        fonts: {},
+        font_sizes: {},
+        font_weights: {},
+        text_colours: {},
+        backgrounds: {},
+        spacing: {},
+        radii: {},
+    };
+    const bump = (map, value) => {
+        map[value] = (map[value] || 0) + 1;
+    };
+    const SKIP = ["script", "style", "link", "meta", "title", "head", "noscript", "template", "br", "svg", "path"];
+    const root = config.selector ? doc.querySelector(config.selector) : doc.body;
+    if (!root)
+        return out;
+    const all = [root].concat(Array.prototype.slice.call(root.querySelectorAll("*")));
+    for (const el of all) {
+        if (out.elements >= config.max_elements)
+            break;
+        const tag = String(el.tagName || "").toLowerCase();
+        if (SKIP.indexOf(tag) !== -1)
+            continue;
+        const s = win.getComputedStyle(el);
+        if (s.display === "none")
+            continue;
+        out.elements++;
+        let ownText = "";
+        for (let i = 0; i < el.childNodes.length; i++) {
+            if (el.childNodes[i].nodeType === 3)
+                ownText += el.childNodes[i].nodeValue;
+        }
+        const hasText = ownText.trim() !== "" || (typeof el.value === "string" && el.value !== "" && tag !== "option");
+        if (hasText) {
+            out.text_elements++;
+            bump(out.fonts, String(s.fontFamily).split(",")[0].replace(/["']/g, "").trim());
+            bump(out.font_sizes, s.fontSize);
+            bump(out.font_weights, s.fontWeight);
+            bump(out.text_colours, s.color);
+        }
+        if (s.backgroundColor && s.backgroundColor !== "rgba(0, 0, 0, 0)" && s.backgroundColor !== "transparent") {
+            bump(out.backgrounds, s.backgroundColor);
+        }
+        const spacing = [
+            s.paddingTop,
+            s.paddingRight,
+            s.paddingBottom,
+            s.paddingLeft,
+            s.marginTop,
+            s.marginRight,
+            s.marginBottom,
+            s.marginLeft,
+        ];
+        if (s.display.indexOf("flex") !== -1 || s.display.indexOf("grid") !== -1) {
+            if (s.rowGap !== "normal")
+                spacing.push(s.rowGap);
+            if (s.columnGap !== "normal" && s.columnGap !== s.rowGap)
+                spacing.push(s.columnGap);
+        }
+        for (const value of spacing) {
+            if (value && value !== "0px" && parseFloat(value) > 0)
+                bump(out.spacing, value);
+        }
+        const radius = s.borderTopLeftRadius;
+        if (radius && radius !== "0px")
+            bump(out.radii, radius);
+    }
+    return out;
+}
+//# sourceMappingURL=inspect.js.map

package/dist/engine/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/engine/inspect.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Locator, Page } from \"playwright\";\nimport {\n  MAX_INSPECT_TEXT_LENGTH,\n  MAX_INVENTORY_ELEMENTS,\n  MAX_INVENTORY_VALUES,\n  SELECTOR_TIMEOUT_MS,\n} from \"../constants.js\";\nimport { isRef, refSelector } from \"../utils/snapshot-rules.js\";\nimport { parseColour, toHex, type ElementMeasurement, type PageInventory, type Tally } from \"../utils/style-rules.js\";\nimport type { ComponentInfo, ComponentUnavailable } from \"../utils/vue-rules.js\";\nimport { componentOf } from \"./vue.js\";\n\n/**\n * How an element is built, measured inside the page.\n *\n * A screenshot shows what a button looks like; this says what it *is*: the\n * box in viewport pixels, the font, the colours it actually renders in (a\n * transparent background resolved through its ancestors), the spacing, and\n * where it sits against its parent and the sibling before it. That is what an\n * agent needs to check its own work against the design it meant to build.\n *\n * Every number is read in one `evaluate` per element and judged in\n * `style-rules.ts`, which never sees a browser.\n */\n\nexport interface InspectResult {\n  target: string;\n  measurement?: ElementMeasurement;\n  /** Why there is no measurement: the target resolved to nothing. */\n  error?: string;\n  /** The Vue component behind the element, when asked for and present. */\n  component?: ComponentInfo | ComponentUnavailable;\n}\n\nexport interface MeasureOptions {\n  /** Also read the Vue component that rendered each element. */\n  components?: boolean;\n}\n\n/** Measure each target — a snapshot ref (`e8`) or a CSS selector — in order. */\nexport async function measureElements(page: Page, targets: readonly string[], options: MeasureOptions = {}): Promise<InspectResult[]> {\n  const results: InspectResult[] = [];\n  for (const target of targets) {\n    const result = await measureOne(page, target);\n    if (options.components && result.measurement) {\n      const component = await componentOf(resolve(page, target));\n      if (component) result.component = component;\n    }\n    results.push(result);\n  }\n  return results;\n}\n\nasync function measureOne(page: Page, target: string): Promise<InspectResult> {\n  const locator = resolve(page, target);\n  let count: number;\n  try {\n    count = await locator.count();\n  } catch (error) {\n    return { target, error: `could not be resolved: ${firstLine(error)}` };\n  }\n  if (count === 0) {\n    return {\n      target,\n      error: isRef(target)\n        ? \"did not resolve — the page has changed since that snapshot, or none was taken; run framewatch_snapshot again\"\n        : \"matched nothing\",\n    };\n  }\n  try {\n    const raw = await locator.evaluate(measureInPage, { max_text: MAX_INSPECT_TEXT_LENGTH }, { timeout: SELECTOR_TIMEOUT_MS });\n    return { target, measurement: { target, ...raw } };\n  } catch (error) {\n    return { target, error: `could not be measured: ${firstLine(error)}` };\n  }\n}\n\nfunction resolve(page: Page, target: string): Locator {\n  return isRef(target) ? page.locator(refSelector(target)) : page.locator(target).first();\n}\n\nfunction firstLine(error: unknown): string {\n  return (error instanceof Error ? error.message : String(error)).split(\"\\n\")[0];\n}\n\n/* ── Inventory ────────────────────────────────────────────────────────── */\n\n/** Every font, size, weight, colour, spacing value and radius the page (or `selector`) uses. */\nexport async function inventoryPage(page: Page, selector?: string): Promise<PageInventory> {\n  const raw = await page.evaluate(inventoryInPage, { selector: selector ?? null, max_elements: MAX_INVENTORY_ELEMENTS });\n  const tally = (map: Record<string, number>, normalise: (value: string) => string | null = (v) => v): Tally[] => {\n    const merged = new Map<string, number>();\n    for (const [value, count] of Object.entries(map)) {\n      const key = normalise(value);\n      if (key === null) continue;\n      merged.set(key, (merged.get(key) ?? 0) + count);\n    }\n    return [...merged.entries()]\n      .map(([value, count]) => ({ value, count }))\n      .sort((a, b) => b.count - a.count || a.value.localeCompare(b.value))\n      .slice(0, MAX_INVENTORY_VALUES);\n  };\n  const hex = (value: string): string | null => {\n    const colour = parseColour(value);\n    if (!colour || colour.a === 0) return null;\n    return toHex(colour);\n  };\n  return {\n    elements: raw.elements,\n    text_elements: raw.text_elements,\n    fonts: tally(raw.fonts),\n    font_sizes: tally(raw.font_sizes),\n    font_weights: tally(raw.font_weights),\n    text_colours: tally(raw.text_colours, hex),\n    backgrounds: tally(raw.backgrounds, hex),\n    spacing: tally(raw.spacing),\n    radii: tally(raw.radii),\n  };\n}\n\n/* ── In-page ──────────────────────────────────────────────────────────────\n * Everything below runs inside Chromium. Written against `globalThis` and\n * untyped nodes because this package is compiled with the Node lib only —\n * and nothing here may close over a module value: the function body is\n * serialised and run where the module does not exist (CLAUDE.md, decision 50).\n */\n\ntype RawMeasurement = Omit<ElementMeasurement, \"target\">;\n\nfunction measureInPage(element: any, config: { max_text: number }): RawMeasurement {\n  const g = globalThis as any;\n  const win = g.window;\n  const doc = g.document;\n\n  const px = (value: string): number => {\n    const n = parseFloat(value);\n    return Number.isFinite(n) ? Math.round(n * 100) / 100 : 0;\n  };\n  const rect = (node: any): { x: number; y: number; width: number; height: number } => {\n    const r = node.getBoundingClientRect();\n    return { x: Math.round(r.left), y: Math.round(r.top), width: Math.round(r.width), height: Math.round(r.height) };\n  };\n\n  const style = win.getComputedStyle(element);\n  const box = rect(element);\n\n  // Effective background: composite this element's own over each ancestor's\n  // until one is opaque. Done here as a list of layers, blended in Node.\n  const layers: string[] = [];\n  let node: any = element;\n  while (node && node.nodeType === 1) {\n    const bg = win.getComputedStyle(node).backgroundColor;\n    layers.push(bg);\n    if (/^rgb\\(/.test(bg)) break;\n    node = node.parentElement;\n  }\n  const background = blend(layers);\n\n  // Clipped by an ancestor whose overflow is not visible.\n  let clipped = false;\n  let ancestor: any = element.parentElement;\n  while (ancestor && ancestor !== doc.documentElement) {\n    const s = win.getComputedStyle(ancestor);\n    if (s.overflow !== \"visible\" || s.overflowX !== \"visible\" || s.overflowY !== \"visible\") {\n      const a = ancestor.getBoundingClientRect();\n      const r = element.getBoundingClientRect();\n      if (r.left < a.left - 0.5 || r.right > a.right + 0.5 || r.top < a.top - 0.5 || r.bottom > a.bottom + 0.5) {\n        clipped = true;\n        break;\n      }\n    }\n    ancestor = ancestor.parentElement;\n  }\n\n  const vw = win.innerWidth;\n  const vh = win.innerHeight;\n  const r = element.getBoundingClientRect();\n  const inside = r.left >= 0 && r.top >= 0 && r.right <= vw && r.bottom <= vh;\n  const outside = r.right <= 0 || r.bottom <= 0 || r.left >= vw || r.top >= vh;\n  const in_viewport: \"fully\" | \"partially\" | \"none\" = inside ? \"fully\" : outside ? \"none\" : \"partially\";\n\n  const opacity = px(style.opacity);\n  const visible =\n    style.display !== \"none\" && style.visibility !== \"hidden\" && opacity > 0 && r.width > 0 && r.height > 0;\n\n  const text_overflows = element.scrollWidth > element.clientWidth + 1 || element.scrollHeight > element.clientHeight + 1;\n\n  const ownText = (): string => {\n    let out = \"\";\n    const children = element.childNodes;\n    for (let i = 0; i < children.length; i++) {\n      if (children[i].nodeType === 3) out += children[i].nodeValue;\n    }\n    out = out.replace(/\\s+/g, \" \").trim();\n    if (out === \"\" && typeof element.value === \"string\") out = element.value;\n    if (out === \"\") out = String(element.textContent || \"\").replace(/\\s+/g, \" \").trim();\n    return out.length > config.max_text ? out.slice(0, config.max_text) + \"…\" : out;\n  };\n\n  const accessibleName = (): string | undefined => {\n    const label = element.getAttribute(\"aria-label\");\n    if (label) return String(label).trim();\n    const labelledBy = element.getAttribute(\"aria-labelledby\");\n    if (labelledBy) {\n      const names = String(labelledBy)\n        .split(/\\s+/)\n        .map((id) => doc.getElementById(id))\n        .filter(Boolean)\n        .map((n: any) => String(n.textContent || \"\").replace(/\\s+/g, \" \").trim());\n      if (names.length > 0) return names.join(\" \");\n    }\n    if (element.labels && element.labels.length > 0) {\n      return String(element.labels[0].textContent || \"\").replace(/\\s+/g, \" \").trim();\n    }\n    const alt = element.getAttribute(\"alt\");\n    if (alt) return String(alt).trim();\n    const title = element.getAttribute(\"title\");\n    if (title) return String(title).trim();\n    const tag = String(element.tagName).toLowerCase();\n    if (tag === \"button\" || tag === \"a\" || /^h[1-6]$/.test(tag) || element.getAttribute(\"role\")) {\n      const text = String(element.textContent || \"\").replace(/\\s+/g, \" \").trim();\n      return text === \"\" ? undefined : text.length > config.max_text ? text.slice(0, config.max_text) + \"…\" : text;\n    }\n    return undefined;\n  };\n\n  const implicitRole = (): string | undefined => {\n    const explicit = element.getAttribute(\"role\");\n    if (explicit) return String(explicit);\n    const tag = String(element.tagName).toLowerCase();\n    const type = String(element.getAttribute(\"type\") || \"\").toLowerCase();\n    if (tag === \"button\") return \"button\";\n    if (tag === \"a\" && element.hasAttribute(\"href\")) return \"link\";\n    if (/^h[1-6]$/.test(tag)) return \"heading\";\n    if (tag === \"input\") {\n      if (type === \"checkbox\") return \"checkbox\";\n      if (type === \"radio\") return \"radio\";\n      if (type === \"button\" || type === \"submit\" || type === \"reset\") return \"button\";\n      if (type === \"range\") return \"slider\";\n      if (type === \"number\") return \"spinbutton\";\n      return \"textbox\";\n    }\n    if (tag === \"textarea\") return \"textbox\";\n    if (tag === \"select\") return \"combobox\";\n    if (tag === \"img\") return \"img\";\n    if (tag === \"nav\") return \"navigation\";\n    if (tag === \"main\") return \"main\";\n    if (tag === \"p\") return \"paragraph\";\n    if (tag === \"ul\" || tag === \"ol\") return \"list\";\n    if (tag === \"li\") return \"listitem\";\n    return undefined;\n  };\n\n  const neighbour = (node: any): { tag: string; box: { x: number; y: number; width: number; height: number } } | undefined =>\n    node && node.nodeType === 1 ? { tag: String(node.tagName).toLowerCase(), box: rect(node) } : undefined;\n\n  const lineHeight = style.lineHeight === \"normal\" ? null : px(style.lineHeight);\n  const gap = style.display.indexOf(\"flex\") !== -1 || style.display.indexOf(\"grid\") !== -1 ? px(style.rowGap === \"normal\" ? \"0\" : style.rowGap) : null;\n\n  const name = accessibleName();\n  const classes: string[] = [];\n  if (element.classList) for (let i = 0; i < element.classList.length && i < 4; i++) classes.push(String(element.classList[i]));\n\n  const out: RawMeasurement = {\n    tag: String(element.tagName).toLowerCase(),\n    classes,\n    box,\n    visible,\n    in_viewport,\n    clipped,\n    text_overflows,\n    display: String(style.display),\n    position: String(style.position),\n    opacity,\n    font: {\n      family: String(style.fontFamily).split(\",\")[0].replace(/[\"']/g, \"\").trim(),\n      size: px(style.fontSize),\n      weight: px(style.fontWeight),\n      line_height: lineHeight,\n      style: String(style.fontStyle),\n    },\n    color: String(style.color),\n    background,\n    padding: [px(style.paddingTop), px(style.paddingRight), px(style.paddingBottom), px(style.paddingLeft)],\n    margin: [px(style.marginTop), px(style.marginRight), px(style.marginBottom), px(style.marginLeft)],\n    gap,\n    border: `${style.borderTopWidth} ${style.borderTopStyle} ${style.borderTopColor}`,\n    radius: String(style.borderTopLeftRadius),\n  };\n  if (element.id) out.id = String(element.id);\n  const role = implicitRole();\n  if (role !== undefined) out.role = role;\n  if (name !== undefined) out.name = name;\n  const text = ownText();\n  if (text !== \"\") out.text = text;\n  const parent = neighbour(element.parentElement);\n  if (parent) out.parent = parent;\n  const previous = neighbour(element.previousElementSibling);\n  if (previous) out.previous = previous;\n  return out;\n\n  /** Composite `layers[0]` over `layers[1]` over … ; returns an rgb()/rgba() string. */\n  function blend(list: string[]): string {\n    const parse = (value: string): [number, number, number, number] | null => {\n      const m = /^rgba?\\(\\s*([\\d.]+)\\s*,\\s*([\\d.]+)\\s*,\\s*([\\d.]+)\\s*(?:,\\s*([\\d.]+)\\s*)?\\)$/.exec(value);\n      if (!m) return value === \"transparent\" ? [0, 0, 0, 0] : null;\n      return [Number(m[1]), Number(m[2]), Number(m[3]), m[4] === undefined ? 1 : Number(m[4])];\n    };\n    // Start from the deepest (last) layer and paint each one above it on top.\n    let acc: [number, number, number, number] | null = null;\n    for (let i = list.length - 1; i >= 0; i--) {\n      const top = parse(list[i]);\n      if (!top) continue;\n      if (!acc || top[3] >= 1) {\n        acc = top;\n        continue;\n      }\n      if (top[3] <= 0) continue;\n      const below: [number, number, number, number] = acc;\n      const a: number = top[3] + below[3] * (1 - top[3]);\n      const mix = (t: number, b: number): number => Math.round((t * top[3] + b * below[3] * (1 - top[3])) / a);\n      acc = [mix(top[0], below[0]), mix(top[1], below[1]), mix(top[2], below[2]), a];\n    }\n    if (!acc) return \"rgba(0, 0, 0, 0)\";\n    // The page's canvas is white under everything that is still translucent.\n    if (acc[3] < 1) {\n      const a = acc[3];\n      acc = [Math.round(acc[0] * a + 255 * (1 - a)), Math.round(acc[1] * a + 255 * (1 - a)), Math.round(acc[2] * a + 255 * (1 - a)), 1];\n    }\n    return `rgb(${acc[0]}, ${acc[1]}, ${acc[2]})`;\n  }\n}\n\ninterface RawInventory {\n  elements: number;\n  text_elements: number;\n  fonts: Record<string, number>;\n  font_sizes: Record<string, number>;\n  font_weights: Record<string, number>;\n  text_colours: Record<string, number>;\n  backgrounds: Record<string, number>;\n  spacing: Record<string, number>;\n  radii: Record<string, number>;\n}\n\nfunction inventoryInPage(config: { selector: string | null; max_elements: number }): RawInventory {\n  const g = globalThis as any;\n  const win = g.window;\n  const doc = g.document;\n  const out: RawInventory = {\n    elements: 0,\n    text_elements: 0,\n    fonts: {},\n    font_sizes: {},\n    font_weights: {},\n    text_colours: {},\n    backgrounds: {},\n    spacing: {},\n    radii: {},\n  };\n  const bump = (map: Record<string, number>, value: string): void => {\n    map[value] = (map[value] || 0) + 1;\n  };\n  const SKIP = [\"script\", \"style\", \"link\", \"meta\", \"title\", \"head\", \"noscript\", \"template\", \"br\", \"svg\", \"path\"];\n\n  const root = config.selector ? doc.querySelector(config.selector) : doc.body;\n  if (!root) return out;\n  const all = [root].concat(Array.prototype.slice.call(root.querySelectorAll(\"*\")));\n\n  for (const el of all) {\n    if (out.elements >= config.max_elements) break;\n    const tag = String(el.tagName || \"\").toLowerCase();\n    if (SKIP.indexOf(tag) !== -1) continue;\n    const s = win.getComputedStyle(el);\n    if (s.display === \"none\") continue;\n    out.elements++;\n\n    let ownText = \"\";\n    for (let i = 0; i < el.childNodes.length; i++) {\n      if (el.childNodes[i].nodeType === 3) ownText += el.childNodes[i].nodeValue;\n    }\n    const hasText = ownText.trim() !== \"\" || (typeof el.value === \"string\" && el.value !== \"\" && tag !== \"option\");\n    if (hasText) {\n      out.text_elements++;\n      bump(out.fonts, String(s.fontFamily).split(\",\")[0].replace(/[\"']/g, \"\").trim());\n      bump(out.font_sizes, s.fontSize);\n      bump(out.font_weights, s.fontWeight);\n      bump(out.text_colours, s.color);\n    }\n    if (s.backgroundColor && s.backgroundColor !== \"rgba(0, 0, 0, 0)\" && s.backgroundColor !== \"transparent\") {\n      bump(out.backgrounds, s.backgroundColor);\n    }\n    const spacing = [\n      s.paddingTop,\n      s.paddingRight,\n      s.paddingBottom,\n      s.paddingLeft,\n      s.marginTop,\n      s.marginRight,\n      s.marginBottom,\n      s.marginLeft,\n    ];\n    if (s.display.indexOf(\"flex\") !== -1 || s.display.indexOf(\"grid\") !== -1) {\n      if (s.rowGap !== \"normal\") spacing.push(s.rowGap);\n      if (s.columnGap !== \"normal\" && s.columnGap !== s.rowGap) spacing.push(s.columnGap);\n    }\n    for (const value of spacing) {\n      if (value && value !== \"0px\" && parseFloat(value) > 0) bump(out.spacing, value);\n    }\n    const radius = s.borderTopLeftRadius;\n    if (radius && radius !== \"0px\") bump(out.radii, radius);\n  }\n  return out;\n}\n"]}

package/dist/engine/interaction.d.ts

@@ -9,16 +9,16 @@ import type { Page } from "playwright";
  * a single actionable line naming the step that failed — a recording is a bad
  * place to surface a 30-line call log.
  */
-/** Actions `framewatch_capture` can replay during a recording. */
-export declare const CAPTURE_ACTIONS: readonly ["click", "tap", "type", "scroll", "swipe", "wait", "navigate"];
-/** Actions `framewatch_interact` can perform as a one-off. */
-export declare const INTERACT_ACTIONS: readonly ["click", "tap", "type", "scroll", "swipe", "navigate", "select", "hover"];
+/** Actions a replayable script (`framewatch_capture`, `framewatch_save_auth`) can perform. */
+export declare const CAPTURE_ACTIONS: readonly ["click", "tap", "type", "key", "scroll", "swipe", "hover", "select", "wait", "navigate"];
+/** Actions `framewatch_interact` can perform as a one-off — everything but `wait`, which needs a script to sit in. */
+export declare const INTERACT_ACTIONS: readonly ["click", "tap", "type", "key", "scroll", "swipe", "navigate", "select", "hover"];
 export type InteractionAction = (typeof CAPTURE_ACTIONS)[number] | (typeof INTERACT_ACTIONS)[number];
 export interface Interaction {
     action: InteractionAction;
-    /** CSS selector for click/tap/type/select/hover, or the scroll container. */
+    /** CSS selector for click/tap/type/select/hover, the field to focus for `key`, or the scroll container. */
     selector?: string;
-    /** Text to type, option value to select, or URL to navigate to. */
+    /** Text to type, key to press, option value to select, or URL to navigate to. */
     value?: string;
     x?: number;
     y?: number;
@@ -31,6 +31,11 @@ export interface ExecuteOptions {
     /** Timeout for selector-based actions. Default SELECTOR_TIMEOUT_MS. */
     timeout_ms?: number;
 }
+/** What a step has to add to its own description once it has run. */
+export interface InteractionOutcome {
+    /** Appended to `describeInteraction(step)`, e.g. ` (vue-router)`. */
+    note?: string;
+}
 /** True when any step needs a touch-enabled browser context. */
 export declare function needsTouch(interactions: readonly Interaction[]): boolean;
 /**
@@ -54,7 +59,7 @@ export declare function describeInteraction(interaction: Interaction): string;
  * Throws a single-line Error naming the step on any failure; the page is never
  * touched when the step is invalid.
  */
-export declare function executeInteraction(page: Page, interaction: Interaction, options?: ExecuteOptions): Promise<void>;
+export declare function executeInteraction(page: Page, interaction: Interaction, options?: ExecuteOptions): Promise<InteractionOutcome>;
 /**
  * The shared zod fields every interaction step accepts. Both tools build their
  * own object around these (the action enums differ, and `framewatch_capture`