framewatch-mcp-server 0.1.0 → 0.2.0

package/dist/engine/snapshot.d.ts

@@ -0,0 +1,29 @@
+import type { Page } from "playwright";
+/**
+ * The page as a tree of named elements.
+ *
+ * Playwright's AI-mode aria snapshot gives every visible element a `[ref=eN]`
+ * that `aria-ref=eN` resolves back to, so an agent that has read the tree
+ * can act on `e8` instead of guessing a selector from a screenshot. The refs
+ * belong to the page: they are assigned when the snapshot is taken and stay
+ * valid until the DOM changes, which is why this runs on the long-lived
+ * interact session rather than on a throwaway page.
+ */
+export interface SnapshotOptions {
+    /** Only this container. Omit for the whole document. */
+    selector?: string;
+    /** `full` keeps the tree; `interactive` flattens it to what a person can act on. */
+    mode: "full" | "interactive";
+    /** Cut the text past this many characters, on a line boundary. */
+    max_chars: number;
+}
+export interface PageSnapshot {
+    text: string;
+    /** Elements with a ref, before any cut. */
+    elements: number;
+    /** Of those, the ones a person can act on. */
+    interactive: number;
+    /** Lines dropped to fit `max_chars`. */
+    cut_lines: number;
+}
+export declare function takeSnapshot(page: Page, options: SnapshotOptions): Promise<PageSnapshot>;

package/dist/engine/snapshot.js

@@ -0,0 +1,10 @@
+import { countSnapshot, interactiveOnly, truncateSnapshot } from "../utils/snapshot-rules.js";
+export async function takeSnapshot(page, options) {
+    const root = options.selector ? page.locator(options.selector).first() : page.locator(":root");
+    const tree = await root.ariaSnapshot({ mode: "ai" });
+    const counts = countSnapshot(tree);
+    const text = options.mode === "interactive" ? interactiveOnly(tree) : tree;
+    const cut = truncateSnapshot(text, options.max_chars);
+    return { text: cut.text, elements: counts.elements, interactive: counts.interactive, cut_lines: cut.cut_lines };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/engine/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/engine/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAgC9F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAU,EAAE,OAAwB;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/F,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;AAClH,CAAC","sourcesContent":["import type { Page } from \"playwright\";\nimport { countSnapshot, interactiveOnly, truncateSnapshot } from \"../utils/snapshot-rules.js\";\n\n/**\n * The page as a tree of named elements.\n *\n * Playwright's AI-mode aria snapshot gives every visible element a `[ref=eN]`\n * that `aria-ref=eN` resolves back to, so an agent that has read the tree\n * can act on `e8` instead of guessing a selector from a screenshot. The refs\n * belong to the page: they are assigned when the snapshot is taken and stay\n * valid until the DOM changes, which is why this runs on the long-lived\n * interact session rather than on a throwaway page.\n */\n\nexport interface SnapshotOptions {\n  /** Only this container. Omit for the whole document. */\n  selector?: string;\n  /** `full` keeps the tree; `interactive` flattens it to what a person can act on. */\n  mode: \"full\" | \"interactive\";\n  /** Cut the text past this many characters, on a line boundary. */\n  max_chars: number;\n}\n\nexport interface PageSnapshot {\n  text: string;\n  /** Elements with a ref, before any cut. */\n  elements: number;\n  /** Of those, the ones a person can act on. */\n  interactive: number;\n  /** Lines dropped to fit `max_chars`. */\n  cut_lines: number;\n}\n\nexport async function takeSnapshot(page: Page, options: SnapshotOptions): Promise<PageSnapshot> {\n  const root = options.selector ? page.locator(options.selector).first() : page.locator(\":root\");\n  const tree = await root.ariaSnapshot({ mode: \"ai\" });\n  const counts = countSnapshot(tree);\n  const text = options.mode === \"interactive\" ? interactiveOnly(tree) : tree;\n  const cut = truncateSnapshot(text, options.max_chars);\n  return { text: cut.text, elements: counts.elements, interactive: counts.interactive, cut_lines: cut.cut_lines };\n}\n"]}

package/dist/engine/vue.d.ts

@@ -0,0 +1,54 @@
+import type { Locator, Page } from "playwright";
+import type { ComponentInfo, ComponentNode, ComponentUnavailable, VueInfo } from "../utils/vue-rules.js";
+/**
+ * What a Vue app on the page is willing to tell us.
+ *
+ * Vue 3 leaves two handles behind in the DOM: the app on its container
+ * (`__vue_app__`, and `data-v-app` on the same element), and on every element
+ * a dev build rendered, the component instance that rendered it
+ * (`__vueParentComponent`). From those come the version, the router and its
+ * current route, the component name, props and state behind any element, the
+ * whole component tree, and a way to navigate through the router instead of
+ * the address bar. Production builds keep only the app handle, and say so.
+ *
+ * Everything in-page below is serialised into Chromium: it may not close over
+ * a module value (CLAUDE.md, decision 50), so every cap is passed in.
+ */
+export declare function detectVue(page: Page): Promise<VueInfo | null>;
+export interface ReadyOptions {
+    /** How long to keep looking for a mounted app. */
+    detect_ms: number;
+    /** Once found, how long to give the router to be ready. */
+    ready_ms: number;
+}
+export interface ReadyResult {
+    vue: VueInfo | null;
+    /** Wall time spent, whichever way it ended. */
+    waited_ms: number;
+}
+/**
+ * Wait for a Vue app to be mounted and its router (if any) to have resolved
+ * its first navigation, then two frames so the first render is painted.
+ * Returns as soon as that is true; a page with no Vue is given `detect_ms`
+ * and then handed back untouched — no slower than the sleep it replaces.
+ */
+export declare function waitForVueReady(page: Page, options: ReadyOptions): Promise<ReadyResult>;
+/** The component that rendered the element `locator` points at, or why there is none. */
+export declare function componentOf(locator: Locator): Promise<ComponentInfo | ComponentUnavailable | null>;
+export interface ComponentTree {
+    root: ComponentNode;
+    total: number;
+}
+export declare function componentTree(page: Page): Promise<ComponentTree | null>;
+export type RouterOutcome = {
+    ok: true;
+    route: {
+        path: string;
+        name?: string;
+    };
+} | {
+    ok: false;
+    error: string;
+};
+/** `router.push(path)`, awaited, on the app's own router. */
+export declare function routerNavigate(page: Page, path: string): Promise<RouterOutcome>;

package/dist/engine/vue.js

@@ -0,0 +1,419 @@
+import { MAX_COMPONENT_ENTRIES, MAX_COMPONENT_TREE_NODES, MAX_COMPONENT_VALUE_LENGTH } from "../constants.js";
+/**
+ * What a Vue app on the page is willing to tell us.
+ *
+ * Vue 3 leaves two handles behind in the DOM: the app on its container
+ * (`__vue_app__`, and `data-v-app` on the same element), and on every element
+ * a dev build rendered, the component instance that rendered it
+ * (`__vueParentComponent`). From those come the version, the router and its
+ * current route, the component name, props and state behind any element, the
+ * whole component tree, and a way to navigate through the router instead of
+ * the address bar. Production builds keep only the app handle, and say so.
+ *
+ * Everything in-page below is serialised into Chromium: it may not close over
+ * a module value (CLAUDE.md, decision 50), so every cap is passed in.
+ */
+export async function detectVue(page) {
+    try {
+        return await page.evaluate(detectInPage);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Wait for a Vue app to be mounted and its router (if any) to have resolved
+ * its first navigation, then two frames so the first render is painted.
+ * Returns as soon as that is true; a page with no Vue is given `detect_ms`
+ * and then handed back untouched — no slower than the sleep it replaces.
+ */
+export async function waitForVueReady(page, options) {
+    const started = Date.now();
+    const deadline = started + Math.max(0, options.detect_ms);
+    let vue = null;
+    for (;;) {
+        vue = await detectVue(page);
+        if (vue !== null || Date.now() >= deadline)
+            break;
+        await page.waitForTimeout(Math.min(50, Math.max(1, deadline - Date.now())));
+    }
+    if (vue !== null) {
+        await page.evaluate(readyInPage, { timeout_ms: options.ready_ms }).catch(() => undefined);
+        vue = (await detectVue(page)) ?? vue;
+    }
+    return { vue, waited_ms: Date.now() - started };
+}
+/** The component that rendered the element `locator` points at, or why there is none. */
+export async function componentOf(locator) {
+    try {
+        return await locator.evaluate(componentInPage, { max_value: MAX_COMPONENT_VALUE_LENGTH, max_entries: MAX_COMPONENT_ENTRIES });
+    }
+    catch {
+        return null;
+    }
+}
+export async function componentTree(page) {
+    try {
+        return await page.evaluate(treeInPage, {
+            max_nodes: MAX_COMPONENT_TREE_NODES,
+            builtins: ["RouterView", "RouterLink", "Transition", "TransitionGroup", "KeepAlive", "BaseTransition", "Teleport", "Suspense"],
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/** `router.push(path)`, awaited, on the app's own router. */
+export async function routerNavigate(page, path) {
+    try {
+        return await page.evaluate(routerPushInPage, { path });
+    }
+    catch (error) {
+        return { ok: false, error: (error instanceof Error ? error.message : String(error)).split("\n")[0] };
+    }
+}
+/* ── In-page ──────────────────────────────────────────────────────────────
+ * Each function below is serialised whole into Chromium, so each carries its
+ * own copy of `findApp`: a shared module-level helper would be a
+ * ReferenceError in the page (CLAUDE.md, decision 50).
+ */
+function detectInPage() {
+    const doc = globalThis.document;
+    if (!doc)
+        return null;
+    const findApp = () => {
+        const doc = globalThis.document;
+        if (!doc)
+            return null;
+        const marked = doc.querySelector("[data-v-app]");
+        if (marked && marked.__vue_app__)
+            return { app: marked.__vue_app__, root: marked };
+        const all = doc.querySelectorAll("*");
+        for (let i = 0; i < all.length; i++) {
+            if (all[i].__vue_app__)
+                return { app: all[i].__vue_app__, root: all[i] };
+        }
+        return null;
+    };
+    const found = findApp();
+    if (found) {
+        const { app, root } = found;
+        // A dev build keeps the root instance on the app; a production build does
+        // not, but both stamp `data-v-app` on the container at mount.
+        const instance = app._instance;
+        const mounted = instance ? instance.isMounted === true : root.hasAttribute("data-v-app");
+        if (!mounted)
+            return null;
+        const props = app.config && app.config.globalProperties;
+        const router = props && props.$router;
+        let route;
+        if (router && router.currentRoute && router.currentRoute.value) {
+            const current = router.currentRoute.value;
+            route = { path: String(current.fullPath) };
+            if (current.name !== undefined && current.name !== null)
+                route.name = String(current.name);
+        }
+        // A dev build stamps every rendered element with its component; a
+        // production build stamps none. Look at what the app rendered.
+        let production = true;
+        const rendered = root.querySelectorAll("*");
+        for (let i = 0; i < rendered.length && i < 50; i++) {
+            if ("__vueParentComponent" in rendered[i]) {
+                production = false;
+                break;
+            }
+        }
+        if (rendered.length === 0)
+            production = !("__vueParentComponent" in root);
+        const version = String(app.version || "3");
+        const out = { version, major: Number(version.split(".")[0]) || 3, router: !!router, production };
+        if (route)
+            out.route = route;
+        return out;
+    }
+    // Vue 2 leaves `__vue__` on component root elements.
+    const all = doc.querySelectorAll("*");
+    for (let i = 0; i < all.length; i++) {
+        const vm = all[i].__vue__;
+        if (!vm || !vm.$root)
+            continue;
+        const ctor = vm.$root.constructor;
+        const version = String((ctor && ctor.version) || (globalThis.Vue && globalThis.Vue.version) || "2");
+        const router = vm.$root.$router;
+        const out = { version, major: 2, router: !!router, production: false };
+        if (router && vm.$root.$route) {
+            out.route = { path: String(vm.$root.$route.fullPath) };
+            if (vm.$root.$route.name)
+                out.route.name = String(vm.$root.$route.name);
+        }
+        return out;
+    }
+    return null;
+}
+async function readyInPage(config) {
+    const findApp = () => {
+        const doc = globalThis.document;
+        if (!doc)
+            return null;
+        const marked = doc.querySelector("[data-v-app]");
+        if (marked && marked.__vue_app__)
+            return { app: marked.__vue_app__, root: marked };
+        const all = doc.querySelectorAll("*");
+        for (let i = 0; i < all.length; i++) {
+            if (all[i].__vue_app__)
+                return { app: all[i].__vue_app__, root: all[i] };
+        }
+        return null;
+    };
+    const found = findApp();
+    if (!found)
+        return false;
+    const props = found.app.config && found.app.config.globalProperties;
+    const router = props && props.$router;
+    let ready = true;
+    if (router && typeof router.isReady === "function") {
+        ready = await Promise.race([
+            router.isReady().then(() => true, () => false),
+            new Promise((resolve) => setTimeout(() => resolve(false), config.timeout_ms)),
+        ]);
+    }
+    const raf = globalThis.requestAnimationFrame;
+    if (typeof raf === "function") {
+        await new Promise((resolve) => raf(() => raf(() => resolve())));
+    }
+    return ready;
+}
+function componentInPage(element, config) {
+    const findApp = () => {
+        const doc = globalThis.document;
+        if (!doc)
+            return null;
+        const marked = doc.querySelector("[data-v-app]");
+        if (marked && marked.__vue_app__)
+            return { app: marked.__vue_app__, root: marked };
+        const all = doc.querySelectorAll("*");
+        for (let i = 0; i < all.length; i++) {
+            if (all[i].__vue_app__)
+                return { app: all[i].__vue_app__, root: all[i] };
+        }
+        return null;
+    };
+    const serialise = (value) => {
+        if (value === null)
+            return "null";
+        if (value === undefined)
+            return "undefined";
+        const type = typeof value;
+        if (type === "string") {
+            const quoted = JSON.stringify(value);
+            return quoted.length > config.max_value + 2 ? JSON.stringify(value.slice(0, config.max_value)) + "…" : quoted;
+        }
+        if (type === "number" || type === "boolean" || type === "bigint")
+            return String(value);
+        if (type === "function")
+            return "fn";
+        if (type === "symbol")
+            return "symbol";
+        if (Array.isArray(value))
+            return "[" + value.length + "]";
+        if (value instanceof Date)
+            return value.toISOString();
+        if (value && typeof value === "object" && "__v_isRef" in value)
+            return serialise(value.value);
+        try {
+            const keys = Object.keys(value);
+            const shown = keys.slice(0, 4).join(", ");
+            return "{" + shown + (keys.length > 4 ? ", …" : "") + "}";
+        }
+        catch {
+            return "{…}";
+        }
+    };
+    const entries = (source, skip) => {
+        const out = {};
+        if (!source || typeof source !== "object")
+            return out;
+        let keys = [];
+        try {
+            keys = Object.keys(source);
+        }
+        catch {
+            return out;
+        }
+        let count = 0;
+        for (const key of keys) {
+            if (skip && skip(key))
+                continue;
+            if (count >= config.max_entries) {
+                out["…"] = "+" + (keys.length - count) + " more";
+                break;
+            }
+            let value;
+            try {
+                value = source[key];
+            }
+            catch {
+                value = undefined;
+            }
+            out[key] = serialise(value);
+            count++;
+        }
+        return out;
+    };
+    const nameOf = (instance) => {
+        const type = instance && instance.type;
+        if (!type)
+            return "Anonymous";
+        if (type.name)
+            return String(type.name);
+        if (type.__name)
+            return String(type.__name);
+        if (type.__file)
+            return String(type.__file).split("/").pop().replace(/\.vue$/, "");
+        return instance.parent === null ? "App" : "Anonymous";
+    };
+    // Vue 3 dev build: the nearest element that knows its component.
+    let node = element;
+    while (node && node.nodeType === 1) {
+        if ("__vueParentComponent" in node && node.__vueParentComponent) {
+            const instance = node.__vueParentComponent;
+            const path = [];
+            let parent = instance.parent;
+            while (parent) {
+                path.push(nameOf(parent));
+                parent = parent.parent;
+            }
+            return {
+                name: nameOf(instance),
+                props: entries(instance.props),
+                state: {
+                    ...entries(instance.setupState, (key) => key.startsWith("_") || key.startsWith("$")),
+                    ...entries(instance.data, (key) => key.startsWith("_") || key.startsWith("$")),
+                },
+                path,
+            };
+        }
+        node = node.parentElement;
+    }
+    // No component data. Say which kind of nothing this is.
+    node = element;
+    while (node && node.nodeType === 1) {
+        if (node.__vue__)
+            return { unavailable: "Vue 2 — component details need Vue 3" };
+        if (node.__vue_app__)
+            return { unavailable: "production build — no component data on elements" };
+        node = node.parentElement;
+    }
+    const found = findApp();
+    if (found && found.root.contains(element))
+        return { unavailable: "production build — no component data on elements" };
+    return null;
+}
+function treeInPage(config) {
+    const findApp = () => {
+        const doc = globalThis.document;
+        if (!doc)
+            return null;
+        const marked = doc.querySelector("[data-v-app]");
+        if (marked && marked.__vue_app__)
+            return { app: marked.__vue_app__, root: marked };
+        const all = doc.querySelectorAll("*");
+        for (let i = 0; i < all.length; i++) {
+            if (all[i].__vue_app__)
+                return { app: all[i].__vue_app__, root: all[i] };
+        }
+        return null;
+    };
+    const found = findApp();
+    if (!found || !found.app._instance)
+        return null;
+    const builtins = new Set(config.builtins);
+    let total = 0;
+    const nameOf = (instance) => {
+        const type = instance.type || {};
+        if (type.name)
+            return String(type.name);
+        if (type.__name)
+            return String(type.__name);
+        if (type.__file)
+            return String(type.__file).split("/").pop().replace(/\.vue$/, "");
+        return instance.parent === null ? "App" : "Anonymous";
+    };
+    const visit = (vnode, into) => {
+        if (!vnode || total >= config.max_nodes)
+            return;
+        if (vnode.component) {
+            const instance = vnode.component;
+            const name = nameOf(instance);
+            if (builtins.has(name)) {
+                visit(instance.subTree, into);
+                return;
+            }
+            const node = { name, children: [] };
+            total++;
+            into.push(node);
+            visit(instance.subTree, node.children);
+            return;
+        }
+        if (vnode.suspense) {
+            visit(vnode.suspense.activeBranch, into);
+            return;
+        }
+        if (Array.isArray(vnode.children)) {
+            for (const child of vnode.children)
+                visit(child, into);
+        }
+    };
+    const rootInstance = found.app._instance;
+    const root = { name: nameOf(rootInstance), children: [] };
+    total = 1;
+    visit(rootInstance.subTree, root.children);
+    return { root, total };
+}
+async function routerPushInPage(config) {
+    const findApp = () => {
+        const doc = globalThis.document;
+        if (!doc)
+            return null;
+        const marked = doc.querySelector("[data-v-app]");
+        if (marked && marked.__vue_app__)
+            return { app: marked.__vue_app__, root: marked };
+        const all = doc.querySelectorAll("*");
+        for (let i = 0; i < all.length; i++) {
+            if (all[i].__vue_app__)
+                return { app: all[i].__vue_app__, root: all[i] };
+        }
+        return null;
+    };
+    const found = findApp();
+    if (!found)
+        return { ok: false, error: "no Vue app on this page" };
+    const props = found.app.config && found.app.config.globalProperties;
+    const router = props && props.$router;
+    if (!router || typeof router.push !== "function")
+        return { ok: false, error: "no vue-router on this app" };
+    try {
+        if (typeof router.resolve === "function") {
+            const resolved = router.resolve(config.path);
+            if (!resolved || !resolved.matched || resolved.matched.length === 0) {
+                return { ok: false, error: "no route matched " + config.path };
+            }
+        }
+        const failure = await router.push(config.path);
+        if (failure) {
+            return { ok: false, error: "navigation " + (failure.type === 8 ? "cancelled" : failure.type === 16 ? "duplicated" : "aborted") + (failure.message ? ": " + failure.message : "") };
+        }
+        const raf = globalThis.requestAnimationFrame;
+        if (typeof raf === "function")
+            await new Promise((resolve) => raf(() => raf(() => resolve())));
+        const current = router.currentRoute && router.currentRoute.value;
+        const route = { path: current ? String(current.fullPath) : config.path };
+        if (current && current.name !== undefined && current.name !== null)
+            route.name = String(current.name);
+        return { ok: true, route };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+//# sourceMappingURL=vue.js.map

package/dist/engine/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../src/engine/vue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG9G;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAU;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAeD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU,EAAE,OAAqB;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,GAAG,GAAmB,IAAI,CAAC;IAC/B,SAAS,CAAC;QACR,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;YAAE,MAAM;QAClD,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1F,GAAG,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;AAClD,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,0BAA0B,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAChI,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAU;IAC5C,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE;YACrC,SAAS,EAAE,wBAAwB;YACnC,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,CAAC;SAC/H,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAID,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU,EAAE,IAAY;IAC3D,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvG,CAAC;AACH,CAAC;AAED;;;;GAIG;AAEH,SAAS,YAAY;IACnB,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;IACzC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,OAAO,GAAG,GAAmC,EAAE;QACnD,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,MAAM,IAAI,MAAM,CAAC,WAAW;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnF,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW;gBAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QAC5B,0EAA0E;QAC1E,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC;QAC/B,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACzF,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACxD,MAAM,MAAM,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;QACtC,IAAI,KAAkD,CAAC;QACvD,IAAI,MAAM,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC;YAC1C,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;gBAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7F,CAAC;QACD,kEAAkE;QAClE,+DAA+D;QAC/D,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,IAAI,sBAAsB,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,UAAU,GAAG,KAAK,CAAC;gBACnB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,UAAU,GAAG,CAAC,CAAC,sBAAsB,IAAI,IAAI,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QAC1G,IAAI,KAAK;YAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,qDAAqD;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1B,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK;YAAE,SAAS;QAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAE,UAAkB,CAAC,GAAG,IAAK,UAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QACtH,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;QAChC,MAAM,GAAG,GAAY,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAChF,IAAI,MAAM,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC9B,GAAG,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI;gBAAE,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,MAA8B;IACvD,MAAM,OAAO,GAAG,GAAmC,EAAE;QACnD,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,MAAM,IAAI,MAAM,CAAC,WAAW;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnF,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW;gBAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;IACpE,MAAM,MAAM,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACnD,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAU;YAClC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;SACvF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,GAAG,GAAI,UAAkB,CAAC,qBAAqB,CAAC;IACtD,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,OAAY,EAAE,MAAkD;IACvF,MAAM,OAAO,GAAG,GAAmC,EAAE;QACnD,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,MAAM,IAAI,MAAM,CAAC,WAAW;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnF,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW;gBAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,KAAU,EAAU,EAAE;QACvC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,WAAW,CAAC;QAC5C,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;QAC1B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QAChH,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvF,IAAI,IAAI,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;QAC1D,IAAI,KAAK,YAAY,IAAI;YAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;QACtD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,IAAI,KAAK;YAAE,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9F,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,GAAG,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,MAAW,EAAE,IAA+B,EAA0B,EAAE;QACvF,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC;QACtD,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC;gBAAE,SAAS;YAChC,IAAI,KAAK,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAChC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC;gBACjD,MAAM;YACR,CAAC;YACD,IAAI,KAAU,CAAC;YACf,IAAI,CAAC;gBACH,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,KAAK,GAAG,SAAS,CAAC;YACpB,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC5B,KAAK,EAAE,CAAC;QACV,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,QAAa,EAAU,EAAE;QACvC,MAAM,IAAI,GAAG,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC;QACvC,IAAI,CAAC,IAAI;YAAE,OAAO,WAAW,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpF,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;IACxD,CAAC,CAAC;IAEF,iEAAiE;IACjE,IAAI,IAAI,GAAQ,OAAO,CAAC;IACxB,OAAO,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnC,IAAI,sBAAsB,IAAI,IAAI,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC;YAC3C,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,OAAO,MAAM,EAAE,CAAC;gBACd,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC1B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC;gBACtB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC9B,KAAK,EAAE;oBACL,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;oBACpF,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBAC/E;gBACD,IAAI;aACL,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,wDAAwD;IACxD,IAAI,GAAG,OAAO,CAAC;IACf,OAAO,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;QACjF,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;QACjG,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;IACtH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,MAAiD;IACnE,MAAM,OAAO,GAAG,GAAmC,EAAE;QACnD,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,MAAM,IAAI,MAAM,CAAC,WAAW;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnF,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW;gBAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,MAAM,GAAG,CAAC,QAAa,EAAU,EAAE;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpF,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;IACxD,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,KAAU,EAAE,IAAqB,EAAQ,EAAE;QACxD,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,MAAM,CAAC,SAAS;YAAE,OAAO;QAChD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;YACjC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YACnD,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ;gBAAE,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;IACzC,MAAM,IAAI,GAAkB,EAAE,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACzE,KAAK,GAAG,CAAC,CAAC;IACV,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,MAAwB;IACtD,MAAM,OAAO,GAAG,GAAmC,EAAE;QACnD,MAAM,GAAG,GAAI,UAAkB,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QACjD,IAAI,MAAM,IAAI,MAAM,CAAC,WAAW;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnF,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW;gBAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;IACxB,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;IACpE,MAAM,MAAM,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;IACtC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;IAC3G,IAAI,CAAC;QACH,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YACjE,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACrL,CAAC;QACD,MAAM,GAAG,GAAI,UAAkB,CAAC,qBAAqB,CAAC;QACtD,IAAI,OAAO,GAAG,KAAK,UAAU;YAAE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACrG,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC;QACjE,MAAM,KAAK,GAAoC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1G,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACtF,CAAC;AACH,CAAC","sourcesContent":["import type { Locator, Page } from \"playwright\";\nimport { MAX_COMPONENT_ENTRIES, MAX_COMPONENT_TREE_NODES, MAX_COMPONENT_VALUE_LENGTH } from \"../constants.js\";\nimport type { ComponentInfo, ComponentNode, ComponentUnavailable, VueInfo } from \"../utils/vue-rules.js\";\n\n/**\n * What a Vue app on the page is willing to tell us.\n *\n * Vue 3 leaves two handles behind in the DOM: the app on its container\n * (`__vue_app__`, and `data-v-app` on the same element), and on every element\n * a dev build rendered, the component instance that rendered it\n * (`__vueParentComponent`). From those come the version, the router and its\n * current route, the component name, props and state behind any element, the\n * whole component tree, and a way to navigate through the router instead of\n * the address bar. Production builds keep only the app handle, and say so.\n *\n * Everything in-page below is serialised into Chromium: it may not close over\n * a module value (CLAUDE.md, decision 50), so every cap is passed in.\n */\n\nexport async function detectVue(page: Page): Promise<VueInfo | null> {\n  try {\n    return await page.evaluate(detectInPage);\n  } catch {\n    return null;\n  }\n}\n\nexport interface ReadyOptions {\n  /** How long to keep looking for a mounted app. */\n  detect_ms: number;\n  /** Once found, how long to give the router to be ready. */\n  ready_ms: number;\n}\n\nexport interface ReadyResult {\n  vue: VueInfo | null;\n  /** Wall time spent, whichever way it ended. */\n  waited_ms: number;\n}\n\n/**\n * Wait for a Vue app to be mounted and its router (if any) to have resolved\n * its first navigation, then two frames so the first render is painted.\n * Returns as soon as that is true; a page with no Vue is given `detect_ms`\n * and then handed back untouched — no slower than the sleep it replaces.\n */\nexport async function waitForVueReady(page: Page, options: ReadyOptions): Promise<ReadyResult> {\n  const started = Date.now();\n  const deadline = started + Math.max(0, options.detect_ms);\n  let vue: VueInfo | null = null;\n  for (;;) {\n    vue = await detectVue(page);\n    if (vue !== null || Date.now() >= deadline) break;\n    await page.waitForTimeout(Math.min(50, Math.max(1, deadline - Date.now())));\n  }\n  if (vue !== null) {\n    await page.evaluate(readyInPage, { timeout_ms: options.ready_ms }).catch(() => undefined);\n    vue = (await detectVue(page)) ?? vue;\n  }\n  return { vue, waited_ms: Date.now() - started };\n}\n\n/** The component that rendered the element `locator` points at, or why there is none. */\nexport async function componentOf(locator: Locator): Promise<ComponentInfo | ComponentUnavailable | null> {\n  try {\n    return await locator.evaluate(componentInPage, { max_value: MAX_COMPONENT_VALUE_LENGTH, max_entries: MAX_COMPONENT_ENTRIES });\n  } catch {\n    return null;\n  }\n}\n\nexport interface ComponentTree {\n  root: ComponentNode;\n  total: number;\n}\n\nexport async function componentTree(page: Page): Promise<ComponentTree | null> {\n  try {\n    return await page.evaluate(treeInPage, {\n      max_nodes: MAX_COMPONENT_TREE_NODES,\n      builtins: [\"RouterView\", \"RouterLink\", \"Transition\", \"TransitionGroup\", \"KeepAlive\", \"BaseTransition\", \"Teleport\", \"Suspense\"],\n    });\n  } catch {\n    return null;\n  }\n}\n\nexport type RouterOutcome = { ok: true; route: { path: string; name?: string } } | { ok: false; error: string };\n\n/** `router.push(path)`, awaited, on the app's own router. */\nexport async function routerNavigate(page: Page, path: string): Promise<RouterOutcome> {\n  try {\n    return await page.evaluate(routerPushInPage, { path });\n  } catch (error) {\n    return { ok: false, error: (error instanceof Error ? error.message : String(error)).split(\"\\n\")[0] };\n  }\n}\n\n/* ── In-page ──────────────────────────────────────────────────────────────\n * Each function below is serialised whole into Chromium, so each carries its\n * own copy of `findApp`: a shared module-level helper would be a\n * ReferenceError in the page (CLAUDE.md, decision 50).\n */\n\nfunction detectInPage(): VueInfo | null {\n  const doc = (globalThis as any).document;\n  if (!doc) return null;\n  const findApp = (): { app: any; root: any } | null => {\n    const doc = (globalThis as any).document;\n    if (!doc) return null;\n    const marked = doc.querySelector(\"[data-v-app]\");\n    if (marked && marked.__vue_app__) return { app: marked.__vue_app__, root: marked };\n    const all = doc.querySelectorAll(\"*\");\n    for (let i = 0; i < all.length; i++) {\n      if (all[i].__vue_app__) return { app: all[i].__vue_app__, root: all[i] };\n    }\n    return null;\n  };\n\n  const found = findApp();\n  if (found) {\n    const { app, root } = found;\n    // A dev build keeps the root instance on the app; a production build does\n    // not, but both stamp `data-v-app` on the container at mount.\n    const instance = app._instance;\n    const mounted = instance ? instance.isMounted === true : root.hasAttribute(\"data-v-app\");\n    if (!mounted) return null;\n    const props = app.config && app.config.globalProperties;\n    const router = props && props.$router;\n    let route: { path: string; name?: string } | undefined;\n    if (router && router.currentRoute && router.currentRoute.value) {\n      const current = router.currentRoute.value;\n      route = { path: String(current.fullPath) };\n      if (current.name !== undefined && current.name !== null) route.name = String(current.name);\n    }\n    // A dev build stamps every rendered element with its component; a\n    // production build stamps none. Look at what the app rendered.\n    let production = true;\n    const rendered = root.querySelectorAll(\"*\");\n    for (let i = 0; i < rendered.length && i < 50; i++) {\n      if (\"__vueParentComponent\" in rendered[i]) {\n        production = false;\n        break;\n      }\n    }\n    if (rendered.length === 0) production = !(\"__vueParentComponent\" in root);\n    const version = String(app.version || \"3\");\n    const out: VueInfo = { version, major: Number(version.split(\".\")[0]) || 3, router: !!router, production };\n    if (route) out.route = route;\n    return out;\n  }\n\n  // Vue 2 leaves `__vue__` on component root elements.\n  const all = doc.querySelectorAll(\"*\");\n  for (let i = 0; i < all.length; i++) {\n    const vm = all[i].__vue__;\n    if (!vm || !vm.$root) continue;\n    const ctor = vm.$root.constructor;\n    const version = String((ctor && ctor.version) || ((globalThis as any).Vue && (globalThis as any).Vue.version) || \"2\");\n    const router = vm.$root.$router;\n    const out: VueInfo = { version, major: 2, router: !!router, production: false };\n    if (router && vm.$root.$route) {\n      out.route = { path: String(vm.$root.$route.fullPath) };\n      if (vm.$root.$route.name) out.route.name = String(vm.$root.$route.name);\n    }\n    return out;\n  }\n  return null;\n}\n\nasync function readyInPage(config: { timeout_ms: number }): Promise<boolean> {\n  const findApp = (): { app: any; root: any } | null => {\n    const doc = (globalThis as any).document;\n    if (!doc) return null;\n    const marked = doc.querySelector(\"[data-v-app]\");\n    if (marked && marked.__vue_app__) return { app: marked.__vue_app__, root: marked };\n    const all = doc.querySelectorAll(\"*\");\n    for (let i = 0; i < all.length; i++) {\n      if (all[i].__vue_app__) return { app: all[i].__vue_app__, root: all[i] };\n    }\n    return null;\n  };\n  const found = findApp();\n  if (!found) return false;\n  const props = found.app.config && found.app.config.globalProperties;\n  const router = props && props.$router;\n  let ready = true;\n  if (router && typeof router.isReady === \"function\") {\n    ready = await Promise.race<boolean>([\n      router.isReady().then(() => true, () => false),\n      new Promise<boolean>((resolve) => setTimeout(() => resolve(false), config.timeout_ms)),\n    ]);\n  }\n  const raf = (globalThis as any).requestAnimationFrame;\n  if (typeof raf === \"function\") {\n    await new Promise<void>((resolve) => raf(() => raf(() => resolve())));\n  }\n  return ready;\n}\n\nfunction componentInPage(element: any, config: { max_value: number; max_entries: number }): ComponentInfo | ComponentUnavailable | null {\n  const findApp = (): { app: any; root: any } | null => {\n    const doc = (globalThis as any).document;\n    if (!doc) return null;\n    const marked = doc.querySelector(\"[data-v-app]\");\n    if (marked && marked.__vue_app__) return { app: marked.__vue_app__, root: marked };\n    const all = doc.querySelectorAll(\"*\");\n    for (let i = 0; i < all.length; i++) {\n      if (all[i].__vue_app__) return { app: all[i].__vue_app__, root: all[i] };\n    }\n    return null;\n  };\n  const serialise = (value: any): string => {\n    if (value === null) return \"null\";\n    if (value === undefined) return \"undefined\";\n    const type = typeof value;\n    if (type === \"string\") {\n      const quoted = JSON.stringify(value);\n      return quoted.length > config.max_value + 2 ? JSON.stringify(value.slice(0, config.max_value)) + \"…\" : quoted;\n    }\n    if (type === \"number\" || type === \"boolean\" || type === \"bigint\") return String(value);\n    if (type === \"function\") return \"fn\";\n    if (type === \"symbol\") return \"symbol\";\n    if (Array.isArray(value)) return \"[\" + value.length + \"]\";\n    if (value instanceof Date) return value.toISOString();\n    if (value && typeof value === \"object\" && \"__v_isRef\" in value) return serialise(value.value);\n    try {\n      const keys = Object.keys(value);\n      const shown = keys.slice(0, 4).join(\", \");\n      return \"{\" + shown + (keys.length > 4 ? \", …\" : \"\") + \"}\";\n    } catch {\n      return \"{…}\";\n    }\n  };\n  const entries = (source: any, skip?: (key: string) => boolean): Record<string, string> => {\n    const out: Record<string, string> = {};\n    if (!source || typeof source !== \"object\") return out;\n    let keys: string[] = [];\n    try {\n      keys = Object.keys(source);\n    } catch {\n      return out;\n    }\n    let count = 0;\n    for (const key of keys) {\n      if (skip && skip(key)) continue;\n      if (count >= config.max_entries) {\n        out[\"…\"] = \"+\" + (keys.length - count) + \" more\";\n        break;\n      }\n      let value: any;\n      try {\n        value = source[key];\n      } catch {\n        value = undefined;\n      }\n      out[key] = serialise(value);\n      count++;\n    }\n    return out;\n  };\n  const nameOf = (instance: any): string => {\n    const type = instance && instance.type;\n    if (!type) return \"Anonymous\";\n    if (type.name) return String(type.name);\n    if (type.__name) return String(type.__name);\n    if (type.__file) return String(type.__file).split(\"/\").pop()!.replace(/\\.vue$/, \"\");\n    return instance.parent === null ? \"App\" : \"Anonymous\";\n  };\n\n  // Vue 3 dev build: the nearest element that knows its component.\n  let node: any = element;\n  while (node && node.nodeType === 1) {\n    if (\"__vueParentComponent\" in node && node.__vueParentComponent) {\n      const instance = node.__vueParentComponent;\n      const path: string[] = [];\n      let parent = instance.parent;\n      while (parent) {\n        path.push(nameOf(parent));\n        parent = parent.parent;\n      }\n      return {\n        name: nameOf(instance),\n        props: entries(instance.props),\n        state: {\n          ...entries(instance.setupState, (key) => key.startsWith(\"_\") || key.startsWith(\"$\")),\n          ...entries(instance.data, (key) => key.startsWith(\"_\") || key.startsWith(\"$\")),\n        },\n        path,\n      };\n    }\n    node = node.parentElement;\n  }\n\n  // No component data. Say which kind of nothing this is.\n  node = element;\n  while (node && node.nodeType === 1) {\n    if (node.__vue__) return { unavailable: \"Vue 2 — component details need Vue 3\" };\n    if (node.__vue_app__) return { unavailable: \"production build — no component data on elements\" };\n    node = node.parentElement;\n  }\n  const found = findApp();\n  if (found && found.root.contains(element)) return { unavailable: \"production build — no component data on elements\" };\n  return null;\n}\n\nfunction treeInPage(config: { max_nodes: number; builtins: string[] }): { root: ComponentNode; total: number } | null {\n  const findApp = (): { app: any; root: any } | null => {\n    const doc = (globalThis as any).document;\n    if (!doc) return null;\n    const marked = doc.querySelector(\"[data-v-app]\");\n    if (marked && marked.__vue_app__) return { app: marked.__vue_app__, root: marked };\n    const all = doc.querySelectorAll(\"*\");\n    for (let i = 0; i < all.length; i++) {\n      if (all[i].__vue_app__) return { app: all[i].__vue_app__, root: all[i] };\n    }\n    return null;\n  };\n  const found = findApp();\n  if (!found || !found.app._instance) return null;\n  const builtins = new Set(config.builtins);\n  let total = 0;\n  const nameOf = (instance: any): string => {\n    const type = instance.type || {};\n    if (type.name) return String(type.name);\n    if (type.__name) return String(type.__name);\n    if (type.__file) return String(type.__file).split(\"/\").pop()!.replace(/\\.vue$/, \"\");\n    return instance.parent === null ? \"App\" : \"Anonymous\";\n  };\n  const visit = (vnode: any, into: ComponentNode[]): void => {\n    if (!vnode || total >= config.max_nodes) return;\n    if (vnode.component) {\n      const instance = vnode.component;\n      const name = nameOf(instance);\n      if (builtins.has(name)) {\n        visit(instance.subTree, into);\n        return;\n      }\n      const node: ComponentNode = { name, children: [] };\n      total++;\n      into.push(node);\n      visit(instance.subTree, node.children);\n      return;\n    }\n    if (vnode.suspense) {\n      visit(vnode.suspense.activeBranch, into);\n      return;\n    }\n    if (Array.isArray(vnode.children)) {\n      for (const child of vnode.children) visit(child, into);\n    }\n  };\n  const rootInstance = found.app._instance;\n  const root: ComponentNode = { name: nameOf(rootInstance), children: [] };\n  total = 1;\n  visit(rootInstance.subTree, root.children);\n  return { root, total };\n}\n\nasync function routerPushInPage(config: { path: string }): Promise<RouterOutcome> {\n  const findApp = (): { app: any; root: any } | null => {\n    const doc = (globalThis as any).document;\n    if (!doc) return null;\n    const marked = doc.querySelector(\"[data-v-app]\");\n    if (marked && marked.__vue_app__) return { app: marked.__vue_app__, root: marked };\n    const all = doc.querySelectorAll(\"*\");\n    for (let i = 0; i < all.length; i++) {\n      if (all[i].__vue_app__) return { app: all[i].__vue_app__, root: all[i] };\n    }\n    return null;\n  };\n  const found = findApp();\n  if (!found) return { ok: false, error: \"no Vue app on this page\" };\n  const props = found.app.config && found.app.config.globalProperties;\n  const router = props && props.$router;\n  if (!router || typeof router.push !== \"function\") return { ok: false, error: \"no vue-router on this app\" };\n  try {\n    if (typeof router.resolve === \"function\") {\n      const resolved = router.resolve(config.path);\n      if (!resolved || !resolved.matched || resolved.matched.length === 0) {\n        return { ok: false, error: \"no route matched \" + config.path };\n      }\n    }\n    const failure = await router.push(config.path);\n    if (failure) {\n      return { ok: false, error: \"navigation \" + (failure.type === 8 ? \"cancelled\" : failure.type === 16 ? \"duplicated\" : \"aborted\") + (failure.message ? \": \" + failure.message : \"\") };\n    }\n    const raf = (globalThis as any).requestAnimationFrame;\n    if (typeof raf === \"function\") await new Promise<void>((resolve) => raf(() => raf(() => resolve())));\n    const current = router.currentRoute && router.currentRoute.value;\n    const route: { path: string; name?: string } = { path: current ? String(current.fullPath) : config.path };\n    if (current && current.name !== undefined && current.name !== null) route.name = String(current.name);\n    return { ok: true, route };\n  } catch (error) {\n    return { ok: false, error: error instanceof Error ? error.message : String(error) };\n  }\n}\n"]}

package/dist/index.js

@@ -25,13 +25,57 @@ export function createServer() {
             "Pass `interactions` to replay a click/type/scroll/tap/swipe script while it records — that is how you " +
             "test a flow such as a login. Use framewatch_interact for one action at a time: it keeps the page open " +
             "between calls, so you can click, look at the result, type, and look again without replaying the flow. " +
+            "Before acting, use framewatch_snapshot to read that page as a tree of named elements — every field, button " +
+            "and link with its accessible name and a ref like `e8` — and pass the ref as `ref` to framewatch_interact " +
+            "instead of guessing a selector from a screenshot (mode `interactive` lists only what can be acted on; " +
+            "`include_snapshot` on interact returns fresh refs after each action). When you are building or checking UI, " +
+            "use framewatch_inspect on refs or selectors to measure how elements are really built: box in viewport px, " +
+            "font, text and background colour with the WCAG contrast ratio, padding, margin, gap, border, radius, " +
+            "clipping and overflow, and alignment to parent and previous sibling, with each target boxed on a " +
+            "screenshot; call it with no targets for a design inventory of the page (fonts, sizes, colours, spacing " +
+            "and radii in use, with counts) to spot the odd one out. On a Vue app, inspect also names the component " +
+            "behind each element with its props and state, snapshot's `include_components` returns the component tree, " +
+            "and every session tool reads the page the moment the app is mounted and its router ready instead of " +
+            "sleeping. After you save a file, use framewatch_wait_for (`until: hot_update`) to return the moment Vite " +
+            "has patched the open page — no reload, no replayed flow — and `navigate` goes through vue-router when the " +
+            "app has one, keeping its state. Every tool that returns frames states the viewport " +
+            "and image scale: coordinates and regions are always in viewport px, not image px. " +
             "Both capture and interact can attach the context behind a frame — console output and uncaught errors " +
             "(on by default), plus network requests, DOM mutations and paint timing via `include_network`, " +
             "`include_dom` and `include_performance` — which is how you find out why a frame looks wrong. " +
             "Use framewatch_responsive to see one page at mobile, tablet and desktop widths at once (it also " +
             "reports content that overflows its viewport), framewatch_accessibility to run an axe-core WCAG audit, " +
             "and framewatch_compare to diff two URLs — or the page interact has open against a URL — with an " +
-            "overlay of every pixel that differs. If the app is not running yet, framewatch_start_server runs its " +
+            "overlay of every pixel that differs. Use framewatch_form_test on anything with fields in it: it fills " +
+            "every form with valid data, with nothing, with special characters, with Arabic and with harmless XSS " +
+            "payloads, one fresh page per strategy, and reports what each one produced — the validation shown, the " +
+            "requests made, the console output, the values silently truncated. Use framewatch_seo to audit what a search " +
+            "engine and a link preview make of a page: title and description with their lengths, canonical, robots " +
+            "directives and robots.txt, Open Graph tags with the share image fetched and measured, the heading outline, " +
+            "images with no alt text, and JSON-LD structured data — all read from the rendered DOM, so a client-rendered " +
+            "app is measured properly. Use framewatch_dead_clicks to find the controls that look clickable and do " +
+            "nothing: it clicks every link, button, click role and pointer-cursor element on the page and reports the " +
+            "ones where absolutely nothing happened — no navigation, no DOM change, no request, no console output — " +
+            "plus the ones whose handler threw, with a screenshot of them boxed in red. It really does press every " +
+            "button, so pass `exclude` or `selector` to keep it away from anything destructive. " +
+            "Use framewatch_links to check where every link on a page actually goes: 404s, server errors, redirect " +
+            "chains, redirects that end on an error page, and `#fragment` links that point at no element. It reuses " +
+            "the browser's own result for the images, scripts and stylesheets the page already loaded, retries a " +
+            "refused HEAD as a GET before calling anything broken, and reports a 401/403/429 as a refused check " +
+            "rather than a dead link. Raise `depth` to follow the site's internal links a level at a time. " +
+            "Use framewatch_api_mock to answer the page's own API calls yourself and record what it does with the " +
+            "answer: the empty list, the 500, the 401, the response that takes five seconds, the body that is not " +
+            "valid JSON, the request that fails outright — one word each via `scenario`, or set the status, body, " +
+            "headers and delay by hand. It returns the same diff cards as framewatch_capture, plus a report of " +
+            "what each mock actually served, including any that matched nothing — which is how you find out a " +
+            "pattern was wrong instead of trusting a page that looked fine. " +
+            "Use framewatch_rtl to test a page in LTR and RTL and get back only what failed to mirror — a box that " +
+            "did not move, text that stayed left-aligned, padding that did not swap, an icon that did not flip — with " +
+            "both screenshots and every finding boxed. " +
+            "For an app behind a login, run the flow once with " +
+            "framewatch_save_auth and pass the file it writes as `storage_state` to any of these tools — they then " +
+            "open the page already signed in instead of replaying the login every time. " +
+            "If the app is not running yet, framewatch_start_server runs its " +
             "dev server (e.g. `npm run dev`) and waits for the port; framewatch_stop_server stops it again.",
     });
     registerAllTools(server);