framewatch-mcp-server 0.1.0 → 0.2.0

package/dist/engine/rtl.js

@@ -0,0 +1,540 @@
+import { MAX_ARABIC_INJECTION_NODES, MAX_RTL_ELEMENTS, MAX_RTL_SCAN, MAX_RTL_SELECTOR_LENGTH, MAX_RTL_TEXT_LENGTH, } from "../constants.js";
+import { arabicFor } from "../utils/arabic-text.js";
+/** The trigger used when the caller names none: the way the platform itself defines RTL. */
+export const DEFAULT_RTL_TRIGGER = {
+    type: "attribute",
+    attr: "dir",
+    value: "rtl",
+    target: "html",
+};
+/**
+ * Apply the trigger to an already-loaded page.
+ *
+ * `url` is not applied here — it is a different page and is navigated to by
+ * the caller before this is reached. `locale` likewise is a context option,
+ * fixed when the browser context is created; what this does for it is set
+ * `dir` as well, because a locale alone changes number and date formatting but
+ * does not flip the layout: `Accept-Language: ar` does not put a page in RTL,
+ * and a tool that assumed it did would report a clean bill of health on a
+ * completely broken page.
+ */
+export async function applyRtlTrigger(page, trigger) {
+    if (trigger.type === "url")
+        return;
+    const request = trigger.type === "attribute"
+        ? { target: trigger.target, attr: trigger.attr, value: trigger.value, class_name: "" }
+        : trigger.type === "class"
+            ? { target: trigger.target, attr: "", value: "", class_name: trigger.class }
+            : // A locale is carried by the context; the layout still has to be flipped.
+                { target: "html", attr: "dir", value: "rtl", class_name: "" };
+    await page.evaluate(applyTrigger, request);
+}
+/**
+ * Check that the page really is rendering right-to-left.
+ *
+ * The single most damaging way this tool can fail is quietly: a trigger that
+ * does not match the app under test measures LTR twice, finds every element
+ * identical, and reports that the page has no RTL problems. That is worse than
+ * an error, because it is a confident wrong answer. So the direction that
+ * actually took effect is read back off the document and the body, and the
+ * caller refuses to report anything if it is still `ltr`.
+ */
+export async function readDirection(page) {
+    try {
+        return await page.evaluate(() => {
+            const doc = globalThis.document;
+            const view = doc?.defaultView;
+            const read = (node) => {
+                if (!node || !view?.getComputedStyle)
+                    return "";
+                try {
+                    return String(view.getComputedStyle(node).direction ?? "");
+                }
+                catch {
+                    return "";
+                }
+            };
+            return { html: read(doc?.documentElement), body: read(doc?.body) };
+        });
+    }
+    catch {
+        return { html: "", body: "" };
+    }
+}
+/* ── Arabic injection ─────────────────────────────────────────────────── */
+/**
+ * Replace every visible text node with Arabic of about the same length.
+ *
+ * Run in *both* passes, not just the RTL one. That is not obvious and it is
+ * essential: the two passes are compared to each other, so they have to differ
+ * in exactly one variable. If only the RTL pass got Arabic, every box on the
+ * page would change width for reasons of text metrics rather than direction,
+ * and the mirroring comparison — which asks whether a box moved — would be
+ * measuring the font, not the layout.
+ *
+ * Text inside `<script>`, `<style>` and friends is left alone, as is anything
+ * inside an element the caller excluded. Input `value`s and `placeholder`s are
+ * replaced too, since a form is where RTL text is most likely to be mishandled.
+ */
+export async function injectArabic(page, exclude) {
+    try {
+        const replaced = await page.evaluate(replaceWithArabic, {
+            exclude: exclude ?? "",
+            max_nodes: MAX_ARABIC_INJECTION_NODES,
+            // The generator is pure and lives in Node, so the vocabulary has to be
+            // carried into the page. Passing the built strings instead of the
+            // function keeps one implementation of "what Arabic looks like".
+            words: buildVocabulary(),
+        });
+        return { replaced };
+    }
+    catch (error) {
+        // Never swallowed into a plausible-looking zero. "0 strings replaced"
+        // reads as "this page had no text", and a caller that believed it would
+        // report a page tested with Arabic that never saw any — so the reason
+        // comes back and the tool says which of the two happened.
+        return { replaced: 0, error: (error instanceof Error ? error.message : String(error)).split("\n")[0] };
+    }
+}
+/**
+ * Pre-build the replacement strings the page will choose from.
+ *
+ * The in-page code cannot call `arabicFor` (it lives in Node and would have to
+ * be serialised along with its imports), so instead the Node side builds one
+ * replacement per length bucket and the page picks the bucket that fits the
+ * string it is replacing. Same vocabulary, same determinism, one implementation.
+ */
+function buildVocabulary() {
+    // One entry per length from 1 to the longest string worth matching. Index
+    // `n` holds Arabic text of about `n` characters, so the page's lookup is a
+    // single array access on the original's length.
+    const lengths = [];
+    for (let length = 0; length <= 160; length += 1) {
+        lengths.push(arabicFor("x".repeat(Math.max(1, length)), length));
+    }
+    return lengths;
+}
+/**
+ * Measure every laid-out element on the page.
+ *
+ * "Laid out" is doing a lot of work: elements with no box, no size, or no
+ * visibility are skipped, because an element that is not rendered cannot have
+ * mirrored and reporting it would be noise. So are the structural wrappers
+ * that carry no text and exactly one child — a `<div>` whose only job is to
+ * hold another `<div>` has no independent layout to get wrong, and including
+ * them would multiply every real finding by the depth of the tree it sits in.
+ */
+export async function measureElements(page, options = {}) {
+    const raw = await page.evaluate(collectMeasurements, {
+        root: options.selector ?? "",
+        exclude: options.exclude ?? "",
+        max_scan: MAX_RTL_SCAN,
+        max_elements: Math.min(options.max_elements ?? MAX_RTL_ELEMENTS, MAX_RTL_ELEMENTS),
+        max_text: MAX_RTL_TEXT_LENGTH,
+        max_selector: MAX_RTL_SELECTOR_LENGTH,
+    });
+    return raw;
+}
+/**
+ * Pair up two measurements of the same page.
+ *
+ * An element is only paired when its structural key appears exactly once in
+ * each pass. A key that appears twice in either pass is ambiguous — pairing it
+ * by order would be a guess, and a wrong guess invents a mirroring bug out of
+ * two different elements — so it is dropped along with anything that appears
+ * in only one direction. `unpaired` counts what was dropped so the report can
+ * say so rather than silently measuring less than it claims.
+ */
+export function pairMeasurements(ltr, rtl) {
+    const ltrByKey = indexUnique(ltr);
+    const rtlByKey = indexUnique(rtl);
+    const pairs = [];
+    for (const [key, left] of ltrByKey) {
+        const right = rtlByKey.get(key);
+        if (right)
+            pairs.push({ ltr: left, rtl: right });
+    }
+    const unpaired = ltr.length + rtl.length - pairs.length * 2;
+    return { pairs, unpaired: Math.max(0, unpaired) };
+}
+/** Keys seen more than once are removed entirely — an ambiguous pairing is worse than none. */
+function indexUnique(items) {
+    const byKey = new Map();
+    const duplicates = new Set();
+    for (const item of items) {
+        if (byKey.has(item.key)) {
+            duplicates.add(item.key);
+            continue;
+        }
+        byKey.set(item.key, item);
+    }
+    for (const key of duplicates)
+        byKey.delete(key);
+    return byKey;
+}
+function applyTrigger(request) {
+    const doc = globalThis.document;
+    if (!doc)
+        return;
+    let node = null;
+    try {
+        node = request.target === "html" ? doc.documentElement : doc.querySelector(request.target);
+    }
+    catch {
+        node = null;
+    }
+    if (!node)
+        node = doc.documentElement;
+    if (!node)
+        return;
+    if (request.attr !== "") {
+        try {
+            node.setAttribute(request.attr, request.value);
+        }
+        catch {
+            // A frozen attribute map; the caller's direction check will catch it.
+        }
+    }
+    if (request.class_name !== "") {
+        try {
+            node.classList.add(request.class_name);
+        }
+        catch {
+            // Same.
+        }
+    }
+}
+function replaceWithArabic(request) {
+    const doc = globalThis.document;
+    if (!doc || !doc.body)
+        return 0;
+    // Declared inside the function, not at module scope: this body is
+    // serialised and evaluated inside Chromium, where nothing from this module
+    // exists. A reference to an outer constant here is a ReferenceError in the
+    // page — and one that `injectArabic`'s catch would turn into a silent "0
+    // strings replaced", which is the worst kind of failure this tool can have.
+    const skip = new Set(["SCRIPT", "STYLE", "NOSCRIPT", "TEMPLATE", "CODE", "PRE", "SVG"]);
+    let excluded = [];
+    if (request.exclude !== "") {
+        try {
+            excluded = Array.prototype.slice.call(doc.querySelectorAll(request.exclude));
+        }
+        catch {
+            excluded = [];
+        }
+    }
+    const isExcluded = (node) => {
+        for (const root of excluded) {
+            try {
+                if (root === node || root.contains(node))
+                    return true;
+            }
+            catch {
+                // A node from another document; not excluded.
+            }
+        }
+        return false;
+    };
+    // Same string, same replacement, wherever it appears — so a nav label that
+    // occurs twice does not become two different words and change the layout.
+    const pick = (original) => {
+        const trimmed = original.trim();
+        if (trimmed === "")
+            return original;
+        if (!/\p{L}/u.test(trimmed)) {
+            const digits = ["٠", "١", "٢", "٣", "٤", "٥", "٦", "٧", "٨", "٩"];
+            return original.replace(/[0-9]/g, (d) => digits[Number(d)]);
+        }
+        const index = Math.min(trimmed.length, request.words.length - 1);
+        const built = request.words[index] ?? request.words[request.words.length - 1];
+        const leading = original.slice(0, original.length - original.trimStart().length);
+        const trailing = original.slice(original.trimEnd().length);
+        return `${leading}${built}${trailing}`;
+    };
+    let replaced = 0;
+    // Text nodes.
+    const walker = doc.createTreeWalker(doc.body, 4 /* NodeFilter.SHOW_TEXT */);
+    const nodes = [];
+    let current = walker.nextNode();
+    while (current && nodes.length < request.max_nodes) {
+        nodes.push(current);
+        current = walker.nextNode();
+    }
+    for (const node of nodes) {
+        const parent = node.parentElement;
+        if (!parent)
+            continue;
+        if (skip.has(String(parent.tagName ?? "").toUpperCase()))
+            continue;
+        if (isExcluded(parent))
+            continue;
+        const text = String(node.nodeValue ?? "");
+        if (text.trim() === "")
+            continue;
+        try {
+            node.nodeValue = pick(text);
+            replaced += 1;
+        }
+        catch {
+            // Read-only node; skip it.
+        }
+    }
+    // Form fields: a placeholder and a value are text the user reads too, and a
+    // form is where RTL text most often goes wrong.
+    let fields = [];
+    try {
+        fields = Array.prototype.slice.call(doc.querySelectorAll("input,textarea,[placeholder]"));
+    }
+    catch {
+        fields = [];
+    }
+    for (const field of fields) {
+        if (isExcluded(field))
+            continue;
+        const type = String(field.type ?? "").toLowerCase();
+        // Only free text. A date, a number or a colour has a syntax, and Arabic
+        // is not it — the browser would simply reject the value.
+        if (type !== "" && type !== "text" && type !== "search" && type !== "textarea")
+            continue;
+        try {
+            const placeholder = String(field.placeholder ?? "");
+            if (placeholder.trim() !== "") {
+                field.placeholder = pick(placeholder);
+                replaced += 1;
+            }
+            const value = String(field.value ?? "");
+            if (value.trim() !== "") {
+                field.value = pick(value);
+                replaced += 1;
+            }
+        }
+        catch {
+            // A controlled component that refuses the write; skip it.
+        }
+    }
+    return replaced;
+}
+function collectMeasurements(request) {
+    const doc = globalThis.document;
+    const view = doc?.defaultView;
+    if (!doc || !doc.body || !view)
+        return [];
+    let root = doc.body;
+    if (request.root !== "") {
+        try {
+            root = doc.querySelector(request.root) ?? doc.body;
+        }
+        catch {
+            root = doc.body;
+        }
+    }
+    let excluded = [];
+    if (request.exclude !== "") {
+        try {
+            excluded = Array.prototype.slice.call(doc.querySelectorAll(request.exclude));
+        }
+        catch {
+            excluded = [];
+        }
+    }
+    const viewportWidth = Math.round(doc.documentElement?.clientWidth ?? view.innerWidth ?? 0);
+    const scrollX = view.scrollX ?? 0;
+    const scrollY = view.scrollY ?? 0;
+    const elide = (value, max) => {
+        const text = String(value ?? "").replace(/\s+/g, " ").trim();
+        return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1))}…`;
+    };
+    /**
+     * A CSS selector for the element.
+     *
+     * An id wins outright; otherwise the path is walked up to the nearest
+     * identified ancestor with `:nth-child` at each step. This is for the
+     * *report* and the highlight overlay — the pairing uses `keyFor` instead,
+     * because a selector is not stable across a reload when the page renders a
+     * different number of siblings.
+     */
+    const selectorFor = (node) => {
+        const id = String(node.id ?? "");
+        if (id !== "" && /^[A-Za-z][\w-]*$/.test(id))
+            return `#${id}`;
+        const parts = [];
+        let current = node;
+        let depth = 0;
+        while (current && current.nodeType === 1 && depth < 6) {
+            const tag = String(current.tagName ?? "").toLowerCase();
+            const currentId = String(current.id ?? "");
+            if (currentId !== "" && /^[A-Za-z][\w-]*$/.test(currentId)) {
+                parts.unshift(`#${currentId}`);
+                break;
+            }
+            const parent = current.parentElement;
+            if (!parent) {
+                parts.unshift(tag);
+                break;
+            }
+            let index = 1;
+            let sibling = current.previousElementSibling;
+            while (sibling) {
+                index += 1;
+                sibling = sibling.previousElementSibling;
+            }
+            parts.unshift(`${tag}:nth-child(${index})`);
+            current = parent;
+            depth += 1;
+        }
+        return elide(parts.join(" > "), request.max_selector);
+    };
+    /**
+     * The identity that survives a reload.
+     *
+     * Tag, id, classes and sibling path — everything about *what* the element
+     * is, and nothing about where it ended up, since where it ended up is the
+     * measurement under test. Classes are sorted so a framework that reorders
+     * them between renders does not break the pairing.
+     */
+    const keyFor = (node) => {
+        const parts = [];
+        let current = node;
+        let depth = 0;
+        while (current && current.nodeType === 1 && depth < 12) {
+            const tag = String(current.tagName ?? "").toLowerCase();
+            const id = String(current.id ?? "");
+            if (id !== "") {
+                parts.unshift(`#${id}`);
+                break;
+            }
+            let classes = "";
+            try {
+                classes = Array.prototype.slice
+                    .call(current.classList ?? [])
+                    .map((c) => String(c))
+                    // A class that carries the direction is not part of the element's
+                    // identity — it is the thing being toggled between the two passes.
+                    .filter((c) => !/^(rtl|ltr|dir-rtl|dir-ltr)$/i.test(c))
+                    .sort()
+                    .join(".");
+            }
+            catch {
+                classes = "";
+            }
+            let index = 1;
+            let sibling = current.previousElementSibling;
+            while (sibling) {
+                index += 1;
+                sibling = sibling.previousElementSibling;
+            }
+            parts.unshift(`${tag}${classes === "" ? "" : `.${classes}`}[${index}]`);
+            current = current.parentElement;
+            depth += 1;
+        }
+        return parts.join("/");
+    };
+    /** Text belonging to this element itself, not to its descendants. */
+    const ownText = (node) => {
+        let text = "";
+        for (const child of Array.prototype.slice.call(node.childNodes ?? [])) {
+            if (child.nodeType === 3)
+                text += String(child.nodeValue ?? "");
+        }
+        return text;
+    };
+    /**
+     * Would an author expect this to be mirrored?
+     *
+     * Named by what it is — an arrow, a chevron, a "next" control — rather than
+     * by what it looks like, because deciding from pixels whether a glyph is
+     * directional is not something worth guessing at. A false positive here is
+     * only a warning, and the evidence is printed next to it.
+     */
+    const looksDirectional = (node) => {
+        const haystack = [
+            String(node.className ?? ""),
+            String(node.id ?? ""),
+            String(node.getAttribute?.("aria-label") ?? ""),
+            String(node.getAttribute?.("data-icon") ?? ""),
+        ]
+            .join(" ")
+            .toLowerCase();
+        if (haystack === "")
+            return false;
+        return /(^|[\s_-])(arrow|chevron|caret|next|prev|previous|back|forward|angle)([\s_-]|$)|arrow-|chevron-/.test(haystack);
+    };
+    const out = [];
+    const walker = doc.createTreeWalker(root, 1 /* NodeFilter.SHOW_ELEMENT */);
+    let node = root.nodeType === 1 ? root : walker.nextNode();
+    let scanned = 0;
+    while (node && scanned < request.max_scan && out.length < request.max_elements) {
+        scanned += 1;
+        const element = node;
+        node = walker.nextNode();
+        const tag = String(element.tagName ?? "").toLowerCase();
+        if (tag === "script" || tag === "style" || tag === "noscript" || tag === "template")
+            continue;
+        let skip = false;
+        for (const root2 of excluded) {
+            try {
+                if (root2 === element || root2.contains(element)) {
+                    skip = true;
+                    break;
+                }
+            }
+            catch {
+                // Not excluded.
+            }
+        }
+        if (skip)
+            continue;
+        let rect;
+        let style;
+        try {
+            rect = element.getBoundingClientRect();
+            style = view.getComputedStyle(element);
+        }
+        catch {
+            continue;
+        }
+        if (!rect || !style)
+            continue;
+        // Not rendered: nothing to mirror, and reporting it would be noise.
+        if (rect.width <= 0 || rect.height <= 0)
+            continue;
+        if (style.visibility === "hidden" || style.display === "none" || Number(style.opacity) === 0)
+            continue;
+        const text = ownText(element);
+        const childCount = element.childElementCount ?? 0;
+        // A wrapper with one child and no text of its own has no independent
+        // layout to get wrong; its child is measured instead.
+        if (text.trim() === "" && childCount === 1 && tag !== "img" && tag !== "svg")
+            continue;
+        const x = rect.left + scrollX;
+        const y = rect.top + scrollY;
+        const right = rect.left + rect.width;
+        out.push({
+            key: keyFor(element),
+            selector: selectorFor(element),
+            match_index: 0,
+            tag,
+            text: elide(text, request.max_text),
+            x,
+            y,
+            width: rect.width,
+            height: rect.height,
+            viewport_width: viewportWidth,
+            text_align: String(style.textAlign ?? ""),
+            direction: String(style.direction ?? ""),
+            flex_direction: String(style.display ?? "").includes("flex") ? String(style.flexDirection ?? "") : "",
+            padding_left: parseFloat(style.paddingLeft) || 0,
+            padding_right: parseFloat(style.paddingRight) || 0,
+            margin_left: parseFloat(style.marginLeft) || 0,
+            margin_right: parseFloat(style.marginRight) || 0,
+            scroll_width: Math.round(element.scrollWidth ?? 0),
+            client_width: Math.round(element.clientWidth ?? 0),
+            overflow_right: Math.max(0, Math.round(right - viewportWidth)),
+            overflow_left: Math.max(0, Math.round(-rect.left)),
+            transform: String(style.transform ?? "none"),
+            ...(looksDirectional(element) ? { mirrorable: true } : {}),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=rtl.js.map

package/dist/engine/rtl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl.js","sourceRoot":"","sources":["../../src/engine/rtl.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Page } from \"playwright\";\nimport {\n  MAX_ARABIC_INJECTION_NODES,\n  MAX_RTL_ELEMENTS,\n  MAX_RTL_SCAN,\n  MAX_RTL_SELECTOR_LENGTH,\n  MAX_RTL_TEXT_LENGTH,\n} from \"../constants.js\";\nimport { arabicFor } from \"../utils/arabic-text.js\";\nimport type { ElementMeasurement, ElementPair } from \"../utils/rtl-rules.js\";\n\n/**\n * RTL engine.\n *\n * Puts a page into RTL, optionally replaces its text with Arabic, and measures\n * every laid-out element. Nothing here decides what is *wrong*; that is\n * `utils/rtl-rules.ts`, which is pure and unit-tested without a browser.\n *\n * The whole design rests on one idea: an RTL bug is something that failed to\n * change. So the same page is measured twice — once as it ships, once flipped\n * — and the two measurements are paired element by element. That pairing is\n * the hard part, because the two renders are two separate page loads: element\n * identity has to survive a reload, and it cannot be an ElementHandle, an\n * index, or a position (position is precisely the thing under test).\n *\n * `keyFor` solves that with a structural key — tag, id, class, and the\n * element's path among its siblings — computed identically in both passes.\n * Anything that does not appear in both is simply dropped: an element that\n * exists in only one direction is a page that renders differently, which is\n * interesting but is not a mirroring bug, and guessing at a pairing would\n * invent findings.\n */\n\n/* ── How the page is put into RTL ─────────────────────────────────────── */\n\n/**\n * How to make the page render right-to-left.\n *\n * Four triggers, because apps do this four different ways and picking the\n * wrong one silently measures the page twice in LTR — which reports no\n * findings at all and looks exactly like a page with no RTL bugs. That failure\n * is why `verifyDirection` exists.\n */\nexport type RtlTrigger =\n  | { type: \"attribute\"; attr: string; value: string; target: string }\n  | { type: \"class\"; class: string; target: string }\n  | { type: \"locale\"; locale: string }\n  | { type: \"url\"; rtl_url: string };\n\n/** The trigger used when the caller names none: the way the platform itself defines RTL. */\nexport const DEFAULT_RTL_TRIGGER: RtlTrigger = {\n  type: \"attribute\",\n  attr: \"dir\",\n  value: \"rtl\",\n  target: \"html\",\n};\n\n/**\n * Apply the trigger to an already-loaded page.\n *\n * `url` is not applied here — it is a different page and is navigated to by\n * the caller before this is reached. `locale` likewise is a context option,\n * fixed when the browser context is created; what this does for it is set\n * `dir` as well, because a locale alone changes number and date formatting but\n * does not flip the layout: `Accept-Language: ar` does not put a page in RTL,\n * and a tool that assumed it did would report a clean bill of health on a\n * completely broken page.\n */\nexport async function applyRtlTrigger(page: Page, trigger: RtlTrigger): Promise<void> {\n  if (trigger.type === \"url\") return;\n\n  const request =\n    trigger.type === \"attribute\"\n      ? { target: trigger.target, attr: trigger.attr, value: trigger.value, class_name: \"\" }\n      : trigger.type === \"class\"\n        ? { target: trigger.target, attr: \"\", value: \"\", class_name: trigger.class }\n        : // A locale is carried by the context; the layout still has to be flipped.\n          { target: \"html\", attr: \"dir\", value: \"rtl\", class_name: \"\" };\n\n  await page.evaluate(applyTrigger, request);\n}\n\n/**\n * Check that the page really is rendering right-to-left.\n *\n * The single most damaging way this tool can fail is quietly: a trigger that\n * does not match the app under test measures LTR twice, finds every element\n * identical, and reports that the page has no RTL problems. That is worse than\n * an error, because it is a confident wrong answer. So the direction that\n * actually took effect is read back off the document and the body, and the\n * caller refuses to report anything if it is still `ltr`.\n */\nexport async function readDirection(page: Page): Promise<{ html: string; body: string }> {\n  try {\n    return await page.evaluate(() => {\n      const doc = (globalThis as any).document;\n      const view = doc?.defaultView;\n      const read = (node: any): string => {\n        if (!node || !view?.getComputedStyle) return \"\";\n        try {\n          return String(view.getComputedStyle(node).direction ?? \"\");\n        } catch {\n          return \"\";\n        }\n      };\n      return { html: read(doc?.documentElement), body: read(doc?.body) };\n    });\n  } catch {\n    return { html: \"\", body: \"\" };\n  }\n}\n\n/* ── Arabic injection ─────────────────────────────────────────────────── */\n\n/**\n * Replace every visible text node with Arabic of about the same length.\n *\n * Run in *both* passes, not just the RTL one. That is not obvious and it is\n * essential: the two passes are compared to each other, so they have to differ\n * in exactly one variable. If only the RTL pass got Arabic, every box on the\n * page would change width for reasons of text metrics rather than direction,\n * and the mirroring comparison — which asks whether a box moved — would be\n * measuring the font, not the layout.\n *\n * Text inside `<script>`, `<style>` and friends is left alone, as is anything\n * inside an element the caller excluded. Input `value`s and `placeholder`s are\n * replaced too, since a form is where RTL text is most likely to be mishandled.\n */\nexport async function injectArabic(page: Page, exclude?: string): Promise<InjectionResult> {\n  try {\n    const replaced = await page.evaluate(replaceWithArabic, {\n      exclude: exclude ?? \"\",\n      max_nodes: MAX_ARABIC_INJECTION_NODES,\n      // The generator is pure and lives in Node, so the vocabulary has to be\n      // carried into the page. Passing the built strings instead of the\n      // function keeps one implementation of \"what Arabic looks like\".\n      words: buildVocabulary(),\n    });\n    return { replaced };\n  } catch (error) {\n    // Never swallowed into a plausible-looking zero. \"0 strings replaced\"\n    // reads as \"this page had no text\", and a caller that believed it would\n    // report a page tested with Arabic that never saw any — so the reason\n    // comes back and the tool says which of the two happened.\n    return { replaced: 0, error: (error instanceof Error ? error.message : String(error)).split(\"\\n\")[0] };\n  }\n}\n\n/** What an injection did, or why it did nothing. */\nexport interface InjectionResult {\n  replaced: number;\n  /** Set when the injection could not run at all — never confused with \"no text to replace\". */\n  error?: string;\n}\n\n/**\n * Pre-build the replacement strings the page will choose from.\n *\n * The in-page code cannot call `arabicFor` (it lives in Node and would have to\n * be serialised along with its imports), so instead the Node side builds one\n * replacement per length bucket and the page picks the bucket that fits the\n * string it is replacing. Same vocabulary, same determinism, one implementation.\n */\nfunction buildVocabulary(): string[] {\n  // One entry per length from 1 to the longest string worth matching. Index\n  // `n` holds Arabic text of about `n` characters, so the page's lookup is a\n  // single array access on the original's length.\n  const lengths: string[] = [];\n  for (let length = 0; length <= 160; length += 1) {\n    lengths.push(arabicFor(\"x\".repeat(Math.max(1, length)), length));\n  }\n  return lengths;\n}\n\n/* ── Measuring ────────────────────────────────────────────────────────── */\n\nexport interface MeasureOptions {\n  /** Only measure inside this. Defaults to the whole document. */\n  selector?: string;\n  /** Never measure this, or anything inside it. */\n  exclude?: string;\n  /** Stop after this many elements. */\n  max_elements?: number;\n}\n\n/**\n * Measure every laid-out element on the page.\n *\n * \"Laid out\" is doing a lot of work: elements with no box, no size, or no\n * visibility are skipped, because an element that is not rendered cannot have\n * mirrored and reporting it would be noise. So are the structural wrappers\n * that carry no text and exactly one child — a `<div>` whose only job is to\n * hold another `<div>` has no independent layout to get wrong, and including\n * them would multiply every real finding by the depth of the tree it sits in.\n */\nexport async function measureElements(page: Page, options: MeasureOptions = {}): Promise<ElementMeasurement[]> {\n  const raw = await page.evaluate(collectMeasurements, {\n    root: options.selector ?? \"\",\n    exclude: options.exclude ?? \"\",\n    max_scan: MAX_RTL_SCAN,\n    max_elements: Math.min(options.max_elements ?? MAX_RTL_ELEMENTS, MAX_RTL_ELEMENTS),\n    max_text: MAX_RTL_TEXT_LENGTH,\n    max_selector: MAX_RTL_SELECTOR_LENGTH,\n  });\n  return raw;\n}\n\n/**\n * Pair up two measurements of the same page.\n *\n * An element is only paired when its structural key appears exactly once in\n * each pass. A key that appears twice in either pass is ambiguous — pairing it\n * by order would be a guess, and a wrong guess invents a mirroring bug out of\n * two different elements — so it is dropped along with anything that appears\n * in only one direction. `unpaired` counts what was dropped so the report can\n * say so rather than silently measuring less than it claims.\n */\nexport function pairMeasurements(\n  ltr: readonly ElementMeasurement[],\n  rtl: readonly ElementMeasurement[],\n): { pairs: ElementPair[]; unpaired: number } {\n  const ltrByKey = indexUnique(ltr);\n  const rtlByKey = indexUnique(rtl);\n\n  const pairs: ElementPair[] = [];\n  for (const [key, left] of ltrByKey) {\n    const right = rtlByKey.get(key);\n    if (right) pairs.push({ ltr: left, rtl: right });\n  }\n\n  const unpaired = ltr.length + rtl.length - pairs.length * 2;\n  return { pairs, unpaired: Math.max(0, unpaired) };\n}\n\n/** Keys seen more than once are removed entirely — an ambiguous pairing is worse than none. */\nfunction indexUnique(items: readonly ElementMeasurement[]): Map<string, ElementMeasurement> {\n  const byKey = new Map<string, ElementMeasurement>();\n  const duplicates = new Set<string>();\n  for (const item of items) {\n    if (byKey.has(item.key)) {\n      duplicates.add(item.key);\n      continue;\n    }\n    byKey.set(item.key, item);\n  }\n  for (const key of duplicates) byKey.delete(key);\n  return byKey;\n}\n\n/* ── In-page ──────────────────────────────────────────────────────────────\n * Everything below runs inside Chromium, so it is written against\n * `globalThis` and untyped nodes: this package is compiled with the Node lib\n * only, and the page it lands in may have patched half of these properties.\n */\n\ninterface TriggerRequest {\n  target: string;\n  attr: string;\n  value: string;\n  class_name: string;\n}\n\nfunction applyTrigger(request: TriggerRequest): void {\n  const doc = (globalThis as any).document;\n  if (!doc) return;\n  let node: any = null;\n  try {\n    node = request.target === \"html\" ? doc.documentElement : doc.querySelector(request.target);\n  } catch {\n    node = null;\n  }\n  if (!node) node = doc.documentElement;\n  if (!node) return;\n\n  if (request.attr !== \"\") {\n    try {\n      node.setAttribute(request.attr, request.value);\n    } catch {\n      // A frozen attribute map; the caller's direction check will catch it.\n    }\n  }\n  if (request.class_name !== \"\") {\n    try {\n      node.classList.add(request.class_name);\n    } catch {\n      // Same.\n    }\n  }\n}\n\ninterface InjectRequest {\n  exclude: string;\n  max_nodes: number;\n  words: string[];\n}\n\nfunction replaceWithArabic(request: InjectRequest): number {\n  const doc = (globalThis as any).document;\n  if (!doc || !doc.body) return 0;\n\n  // Declared inside the function, not at module scope: this body is\n  // serialised and evaluated inside Chromium, where nothing from this module\n  // exists. A reference to an outer constant here is a ReferenceError in the\n  // page — and one that `injectArabic`'s catch would turn into a silent \"0\n  // strings replaced\", which is the worst kind of failure this tool can have.\n  const skip = new Set([\"SCRIPT\", \"STYLE\", \"NOSCRIPT\", \"TEMPLATE\", \"CODE\", \"PRE\", \"SVG\"]);\n  let excluded: any[] = [];\n  if (request.exclude !== \"\") {\n    try {\n      excluded = Array.prototype.slice.call(doc.querySelectorAll(request.exclude));\n    } catch {\n      excluded = [];\n    }\n  }\n\n  const isExcluded = (node: any): boolean => {\n    for (const root of excluded) {\n      try {\n        if (root === node || root.contains(node)) return true;\n      } catch {\n        // A node from another document; not excluded.\n      }\n    }\n    return false;\n  };\n\n  // Same string, same replacement, wherever it appears — so a nav label that\n  // occurs twice does not become two different words and change the layout.\n  const pick = (original: string): string => {\n    const trimmed = original.trim();\n    if (trimmed === \"\") return original;\n    if (!/\\p{L}/u.test(trimmed)) {\n      const digits = [\"٠\", \"١\", \"٢\", \"٣\", \"٤\", \"٥\", \"٦\", \"٧\", \"٨\", \"٩\"];\n      return original.replace(/[0-9]/g, (d: string) => digits[Number(d)]);\n    }\n    const index = Math.min(trimmed.length, request.words.length - 1);\n    const built = request.words[index] ?? request.words[request.words.length - 1];\n    const leading = original.slice(0, original.length - original.trimStart().length);\n    const trailing = original.slice(original.trimEnd().length);\n    return `${leading}${built}${trailing}`;\n  };\n\n  let replaced = 0;\n\n  // Text nodes.\n  const walker = doc.createTreeWalker(doc.body, 4 /* NodeFilter.SHOW_TEXT */);\n  const nodes: any[] = [];\n  let current = walker.nextNode();\n  while (current && nodes.length < request.max_nodes) {\n    nodes.push(current);\n    current = walker.nextNode();\n  }\n\n  for (const node of nodes) {\n    const parent = node.parentElement;\n    if (!parent) continue;\n    if (skip.has(String(parent.tagName ?? \"\").toUpperCase())) continue;\n    if (isExcluded(parent)) continue;\n    const text = String(node.nodeValue ?? \"\");\n    if (text.trim() === \"\") continue;\n    try {\n      node.nodeValue = pick(text);\n      replaced += 1;\n    } catch {\n      // Read-only node; skip it.\n    }\n  }\n\n  // Form fields: a placeholder and a value are text the user reads too, and a\n  // form is where RTL text most often goes wrong.\n  let fields: any[] = [];\n  try {\n    fields = Array.prototype.slice.call(doc.querySelectorAll(\"input,textarea,[placeholder]\"));\n  } catch {\n    fields = [];\n  }\n  for (const field of fields) {\n    if (isExcluded(field)) continue;\n    const type = String(field.type ?? \"\").toLowerCase();\n    // Only free text. A date, a number or a colour has a syntax, and Arabic\n    // is not it — the browser would simply reject the value.\n    if (type !== \"\" && type !== \"text\" && type !== \"search\" && type !== \"textarea\") continue;\n    try {\n      const placeholder = String(field.placeholder ?? \"\");\n      if (placeholder.trim() !== \"\") {\n        field.placeholder = pick(placeholder);\n        replaced += 1;\n      }\n      const value = String(field.value ?? \"\");\n      if (value.trim() !== \"\") {\n        field.value = pick(value);\n        replaced += 1;\n      }\n    } catch {\n      // A controlled component that refuses the write; skip it.\n    }\n  }\n\n  return replaced;\n}\n\ninterface CollectRequest {\n  root: string;\n  exclude: string;\n  max_scan: number;\n  max_elements: number;\n  max_text: number;\n  max_selector: number;\n}\n\nfunction collectMeasurements(request: CollectRequest): ElementMeasurement[] {\n  const doc = (globalThis as any).document;\n  const view = doc?.defaultView;\n  if (!doc || !doc.body || !view) return [];\n\n  let root: any = doc.body;\n  if (request.root !== \"\") {\n    try {\n      root = doc.querySelector(request.root) ?? doc.body;\n    } catch {\n      root = doc.body;\n    }\n  }\n\n  let excluded: any[] = [];\n  if (request.exclude !== \"\") {\n    try {\n      excluded = Array.prototype.slice.call(doc.querySelectorAll(request.exclude));\n    } catch {\n      excluded = [];\n    }\n  }\n\n  const viewportWidth = Math.round(doc.documentElement?.clientWidth ?? view.innerWidth ?? 0);\n  const scrollX = view.scrollX ?? 0;\n  const scrollY = view.scrollY ?? 0;\n\n  const elide = (value: string, max: number): string => {\n    const text = String(value ?? \"\").replace(/\\s+/g, \" \").trim();\n    return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1))}…`;\n  };\n\n  /**\n   * A CSS selector for the element.\n   *\n   * An id wins outright; otherwise the path is walked up to the nearest\n   * identified ancestor with `:nth-child` at each step. This is for the\n   * *report* and the highlight overlay — the pairing uses `keyFor` instead,\n   * because a selector is not stable across a reload when the page renders a\n   * different number of siblings.\n   */\n  const selectorFor = (node: any): string => {\n    const id = String(node.id ?? \"\");\n    if (id !== \"\" && /^[A-Za-z][\\w-]*$/.test(id)) return `#${id}`;\n\n    const parts: string[] = [];\n    let current: any = node;\n    let depth = 0;\n    while (current && current.nodeType === 1 && depth < 6) {\n      const tag = String(current.tagName ?? \"\").toLowerCase();\n      const currentId = String(current.id ?? \"\");\n      if (currentId !== \"\" && /^[A-Za-z][\\w-]*$/.test(currentId)) {\n        parts.unshift(`#${currentId}`);\n        break;\n      }\n      const parent = current.parentElement;\n      if (!parent) {\n        parts.unshift(tag);\n        break;\n      }\n      let index = 1;\n      let sibling = current.previousElementSibling;\n      while (sibling) {\n        index += 1;\n        sibling = sibling.previousElementSibling;\n      }\n      parts.unshift(`${tag}:nth-child(${index})`);\n      current = parent;\n      depth += 1;\n    }\n    return elide(parts.join(\" > \"), request.max_selector);\n  };\n\n  /**\n   * The identity that survives a reload.\n   *\n   * Tag, id, classes and sibling path — everything about *what* the element\n   * is, and nothing about where it ended up, since where it ended up is the\n   * measurement under test. Classes are sorted so a framework that reorders\n   * them between renders does not break the pairing.\n   */\n  const keyFor = (node: any): string => {\n    const parts: string[] = [];\n    let current: any = node;\n    let depth = 0;\n    while (current && current.nodeType === 1 && depth < 12) {\n      const tag = String(current.tagName ?? \"\").toLowerCase();\n      const id = String(current.id ?? \"\");\n      if (id !== \"\") {\n        parts.unshift(`#${id}`);\n        break;\n      }\n      let classes = \"\";\n      try {\n        classes = Array.prototype.slice\n          .call(current.classList ?? [])\n          .map((c: any) => String(c))\n          // A class that carries the direction is not part of the element's\n          // identity — it is the thing being toggled between the two passes.\n          .filter((c: string) => !/^(rtl|ltr|dir-rtl|dir-ltr)$/i.test(c))\n          .sort()\n          .join(\".\");\n      } catch {\n        classes = \"\";\n      }\n      let index = 1;\n      let sibling = current.previousElementSibling;\n      while (sibling) {\n        index += 1;\n        sibling = sibling.previousElementSibling;\n      }\n      parts.unshift(`${tag}${classes === \"\" ? \"\" : `.${classes}`}[${index}]`);\n      current = current.parentElement;\n      depth += 1;\n    }\n    return parts.join(\"/\");\n  };\n\n  /** Text belonging to this element itself, not to its descendants. */\n  const ownText = (node: any): string => {\n    let text = \"\";\n    for (const child of Array.prototype.slice.call(node.childNodes ?? [])) {\n      if (child.nodeType === 3) text += String(child.nodeValue ?? \"\");\n    }\n    return text;\n  };\n\n  /**\n   * Would an author expect this to be mirrored?\n   *\n   * Named by what it is — an arrow, a chevron, a \"next\" control — rather than\n   * by what it looks like, because deciding from pixels whether a glyph is\n   * directional is not something worth guessing at. A false positive here is\n   * only a warning, and the evidence is printed next to it.\n   */\n  const looksDirectional = (node: any): boolean => {\n    const haystack = [\n      String(node.className ?? \"\"),\n      String(node.id ?? \"\"),\n      String(node.getAttribute?.(\"aria-label\") ?? \"\"),\n      String(node.getAttribute?.(\"data-icon\") ?? \"\"),\n    ]\n      .join(\" \")\n      .toLowerCase();\n    if (haystack === \"\") return false;\n    return /(^|[\\s_-])(arrow|chevron|caret|next|prev|previous|back|forward|angle)([\\s_-]|$)|arrow-|chevron-/.test(\n      haystack,\n    );\n  };\n\n  const out: ElementMeasurement[] = [];\n  const walker = doc.createTreeWalker(root, 1 /* NodeFilter.SHOW_ELEMENT */);\n  let node: any = root.nodeType === 1 ? root : walker.nextNode();\n  let scanned = 0;\n\n  while (node && scanned < request.max_scan && out.length < request.max_elements) {\n    scanned += 1;\n    const element = node;\n    node = walker.nextNode();\n\n    const tag = String(element.tagName ?? \"\").toLowerCase();\n    if (tag === \"script\" || tag === \"style\" || tag === \"noscript\" || tag === \"template\") continue;\n\n    let skip = false;\n    for (const root2 of excluded) {\n      try {\n        if (root2 === element || root2.contains(element)) {\n          skip = true;\n          break;\n        }\n      } catch {\n        // Not excluded.\n      }\n    }\n    if (skip) continue;\n\n    let rect: any;\n    let style: any;\n    try {\n      rect = element.getBoundingClientRect();\n      style = view.getComputedStyle(element);\n    } catch {\n      continue;\n    }\n    if (!rect || !style) continue;\n    // Not rendered: nothing to mirror, and reporting it would be noise.\n    if (rect.width <= 0 || rect.height <= 0) continue;\n    if (style.visibility === \"hidden\" || style.display === \"none\" || Number(style.opacity) === 0) continue;\n\n    const text = ownText(element);\n    const childCount = element.childElementCount ?? 0;\n    // A wrapper with one child and no text of its own has no independent\n    // layout to get wrong; its child is measured instead.\n    if (text.trim() === \"\" && childCount === 1 && tag !== \"img\" && tag !== \"svg\") continue;\n\n    const x = rect.left + scrollX;\n    const y = rect.top + scrollY;\n    const right = rect.left + rect.width;\n\n    out.push({\n      key: keyFor(element),\n      selector: selectorFor(element),\n      match_index: 0,\n      tag,\n      text: elide(text, request.max_text),\n      x,\n      y,\n      width: rect.width,\n      height: rect.height,\n      viewport_width: viewportWidth,\n      text_align: String(style.textAlign ?? \"\"),\n      direction: String(style.direction ?? \"\"),\n      flex_direction: String(style.display ?? \"\").includes(\"flex\") ? String(style.flexDirection ?? \"\") : \"\",\n      padding_left: parseFloat(style.paddingLeft) || 0,\n      padding_right: parseFloat(style.paddingRight) || 0,\n      margin_left: parseFloat(style.marginLeft) || 0,\n      margin_right: parseFloat(style.marginRight) || 0,\n      scroll_width: Math.round(element.scrollWidth ?? 0),\n      client_width: Math.round(element.clientWidth ?? 0),\n      overflow_right: Math.max(0, Math.round(right - viewportWidth)),\n      overflow_left: Math.max(0, Math.round(-rect.left)),\n      transform: String(style.transform ?? \"none\"),\n      ...(looksDirectional(element) ? { mirrorable: true } : {}),\n    });\n  }\n\n  return out;\n}\n"]}