@aria-cli/tools 1.0.12 → 1.0.14

package/dist/definitions/browser/pw-snapshot.js

@@ -1,301 +0,0 @@
-// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
-// https://github.com/openclaw/openclaw
-// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
-// ── Role classification sets ──────────────────────────────────────────
-const INTERACTIVE_ROLES = new Set([
-    "button",
-    "link",
-    "textbox",
-    "checkbox",
-    "radio",
-    "combobox",
-    "listbox",
-    "menuitem",
-    "menuitemcheckbox",
-    "menuitemradio",
-    "option",
-    "searchbox",
-    "slider",
-    "spinbutton",
-    "switch",
-    "tab",
-    "treeitem",
-]);
-const CONTENT_ROLES = new Set([
-    "heading",
-    "cell",
-    "gridcell",
-    "columnheader",
-    "rowheader",
-    "listitem",
-    "article",
-    "region",
-    "main",
-    "navigation",
-]);
-const STRUCTURAL_ROLES = new Set([
-    "generic",
-    "group",
-    "list",
-    "table",
-    "row",
-    "rowgroup",
-    "grid",
-    "treegrid",
-    "menu",
-    "menubar",
-    "toolbar",
-    "tablist",
-    "tree",
-    "directory",
-    "document",
-    "application",
-    "presentation",
-    "none",
-]);
-// ── Stats ─────────────────────────────────────────────────────────────
-export function getRoleSnapshotStats(snapshot, refs) {
-    const interactive = Object.values(refs).filter((r) => INTERACTIVE_ROLES.has(r.role)).length;
-    return {
-        lines: snapshot.split("\n").length,
-        chars: snapshot.length,
-        refs: Object.keys(refs).length,
-        interactive,
-    };
-}
-// ── Internal helpers ──────────────────────────────────────────────────
-function getIndentLevel(line) {
-    const match = line.match(/^(\s*)/);
-    return match ? Math.floor(match[1].length / 2) : 0;
-}
-function createRoleNameTracker() {
-    const counts = new Map();
-    const refsByKey = new Map();
-    return {
-        counts,
-        refsByKey,
-        getKey(role, name) {
-            return `${role}:${name ?? ""}`;
-        },
-        getNextIndex(role, name) {
-            const key = this.getKey(role, name);
-            const current = counts.get(key) ?? 0;
-            counts.set(key, current + 1);
-            return current;
-        },
-        trackRef(role, name, ref) {
-            const key = this.getKey(role, name);
-            const list = refsByKey.get(key) ?? [];
-            list.push(ref);
-            refsByKey.set(key, list);
-        },
-        getDuplicateKeys() {
-            const out = new Set();
-            for (const [key, refs] of refsByKey) {
-                if (refs.length > 1) {
-                    out.add(key);
-                }
-            }
-            return out;
-        },
-    };
-}
-function removeNthFromNonDuplicates(refs, tracker) {
-    const duplicates = tracker.getDuplicateKeys();
-    for (const [ref, data] of Object.entries(refs)) {
-        const key = tracker.getKey(data.role, data.name);
-        if (!duplicates.has(key)) {
-            delete refs[ref]?.nth;
-        }
-    }
-}
-function compactTree(tree) {
-    const lines = tree.split("\n");
-    const result = [];
-    for (let i = 0; i < lines.length; i += 1) {
-        const line = lines[i];
-        if (line.includes("[ref=")) {
-            result.push(line);
-            continue;
-        }
-        if (line.includes(":") && !line.trimEnd().endsWith(":")) {
-            result.push(line);
-            continue;
-        }
-        const currentIndent = getIndentLevel(line);
-        let hasRelevantChildren = false;
-        for (let j = i + 1; j < lines.length; j += 1) {
-            const childIndent = getIndentLevel(lines[j]);
-            if (childIndent <= currentIndent) {
-                break;
-            }
-            if (lines[j]?.includes("[ref=")) {
-                hasRelevantChildren = true;
-                break;
-            }
-        }
-        if (hasRelevantChildren) {
-            result.push(line);
-        }
-    }
-    return result.join("\n");
-}
-function matchInteractiveSnapshotLine(line, options) {
-    const depth = getIndentLevel(line);
-    if (options.maxDepth !== undefined && depth > options.maxDepth) {
-        return null;
-    }
-    const match = line.match(/^(\s*-\s*)(\w+)(?:\s+"([^"]*)")?(.*)$/);
-    if (!match) {
-        return null;
-    }
-    const [, , roleRaw, name, suffix] = match;
-    if (roleRaw.startsWith("/")) {
-        return null;
-    }
-    const role = roleRaw.toLowerCase();
-    return {
-        roleRaw: roleRaw,
-        role,
-        ...(name ? { name } : {}),
-        suffix: suffix,
-    };
-}
-function processLine(line, refs, options, tracker, nextRef) {
-    const depth = getIndentLevel(line);
-    if (options.maxDepth !== undefined && depth > options.maxDepth) {
-        return null;
-    }
-    const match = line.match(/^(\s*-\s*)(\w+)(?:\s+"([^"]*)")?(.*)$/);
-    if (!match) {
-        return options.interactive ? null : line;
-    }
-    const [, prefix, roleRaw, name, suffix] = match;
-    if (roleRaw.startsWith("/")) {
-        return options.interactive ? null : line;
-    }
-    const role = roleRaw.toLowerCase();
-    const isInteractive = INTERACTIVE_ROLES.has(role);
-    const isContent = CONTENT_ROLES.has(role);
-    const isStructural = STRUCTURAL_ROLES.has(role);
-    if (options.interactive && !isInteractive) {
-        return null;
-    }
-    if (options.compact && isStructural && !name) {
-        return null;
-    }
-    const shouldHaveRef = isInteractive || (isContent && !!name);
-    if (!shouldHaveRef) {
-        return line;
-    }
-    const ref = nextRef();
-    const nth = tracker.getNextIndex(role, name);
-    tracker.trackRef(role, name, ref);
-    refs[ref] = { role, name, nth };
-    let enhanced = `${prefix}${roleRaw}`;
-    if (name) {
-        enhanced += ` "${name}"`;
-    }
-    enhanced += ` [ref=${ref}]`;
-    if (nth > 0) {
-        enhanced += ` [nth=${nth}]`;
-    }
-    if (suffix) {
-        enhanced += suffix;
-    }
-    return enhanced;
-}
-// ── Public API ────────────────────────────────────────────────────────
-/**
- * Build a role-ref snapshot from Playwright's ariaSnapshot() output.
- * This is the core transform: raw ARIA tree text -> annotated tree + ref map.
- */
-export function buildRoleSnapshotFromAriaSnapshot(ariaSnapshot, options = {}) {
-    const lines = ariaSnapshot.split("\n");
-    const refs = {};
-    const tracker = createRoleNameTracker();
-    let counter = 0;
-    const nextRef = () => {
-        counter += 1;
-        return `e${counter}`;
-    };
-    if (options.interactive) {
-        const result = [];
-        for (const line of lines) {
-            const parsed = matchInteractiveSnapshotLine(line, options);
-            if (!parsed) {
-                continue;
-            }
-            const { roleRaw, role, name, suffix } = parsed;
-            if (!INTERACTIVE_ROLES.has(role)) {
-                continue;
-            }
-            const ref = nextRef();
-            const nth = tracker.getNextIndex(role, name);
-            tracker.trackRef(role, name, ref);
-            refs[ref] = { role, name, nth };
-            let enhanced = `- ${roleRaw}`;
-            if (name) {
-                enhanced += ` "${name}"`;
-            }
-            enhanced += ` [ref=${ref}]`;
-            if (nth > 0) {
-                enhanced += ` [nth=${nth}]`;
-            }
-            if (suffix.includes("[")) {
-                enhanced += suffix;
-            }
-            result.push(enhanced);
-        }
-        removeNthFromNonDuplicates(refs, tracker);
-        return {
-            snapshot: result.join("\n") || "(no interactive elements)",
-            refs,
-        };
-    }
-    const result = [];
-    for (const line of lines) {
-        const processed = processLine(line, refs, options, tracker, nextRef);
-        if (processed !== null) {
-            result.push(processed);
-        }
-    }
-    removeNthFromNonDuplicates(refs, tracker);
-    const tree = result.join("\n") || "(empty)";
-    return {
-        snapshot: options.compact ? compactTree(tree) : tree,
-        refs,
-    };
-}
-/**
- * Take a role-based accessibility snapshot of a page.
- * Uses Playwright's built-in ariaSnapshot() on the :root locator,
- * then annotates elements with [ref=eN] markers.
- */
-export async function snapshotPage(page, options) {
-    const locator = page.locator(":root");
-    const ariaSnapshot = await locator.ariaSnapshot();
-    const built = buildRoleSnapshotFromAriaSnapshot(String(ariaSnapshot ?? ""), options);
-    const stats = getRoleSnapshotStats(built.snapshot, built.refs);
-    return {
-        snapshot: built.snapshot,
-        refs: built.refs,
-        stats,
-        url: page.url(),
-        title: await page.title(),
-    };
-}
-/**
- * Navigate a page to a URL.
- */
-export async function navigatePage(page, url, timeoutMs) {
-    const target = String(url ?? "").trim();
-    if (!target) {
-        throw new Error("url is required");
-    }
-    await page.goto(target, {
-        timeout: Math.max(1000, Math.min(120_000, timeoutMs ?? 20_000)),
-        waitUntil: "domcontentloaded",
-    });
-    return { url: page.url() };
-}

package/dist/definitions/browser/pw-state.js

@@ -1,62 +0,0 @@
-// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
-// https://github.com/openclaw/openclaw
-// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
-// ── Cookies ───────────────────────────────────────────────────────────
-export async function cookiesGet(context) {
-    const cookies = await context.cookies();
-    return { cookies };
-}
-export async function cookiesSet(context, cookies) {
-    if (!cookies.length) {
-        throw new Error("cookies are required");
-    }
-    for (const cookie of cookies) {
-        if (!cookie.name || cookie.value === undefined) {
-            throw new Error("cookie name and value are required");
-        }
-        if (!cookie.domain) {
-            throw new Error("cookie domain is required");
-        }
-    }
-    await context.addCookies(cookies.map((c) => ({
-        name: c.name,
-        value: c.value,
-        domain: c.domain,
-        path: c.path ?? "/",
-    })));
-}
-export async function cookiesClear(context) {
-    await context.clearCookies();
-}
-export async function storageGet(page, kind, key) {
-    const script = key
-        ? `(function() {
-        var store = ${kind === "session" ? "window.sessionStorage" : "window.localStorage"};
-        var value = store.getItem(${JSON.stringify(key)});
-        return value === null ? {} : { ${JSON.stringify(key)}: value };
-      })()`
-        : `(function() {
-        var store = ${kind === "session" ? "window.sessionStorage" : "window.localStorage"};
-        var out = {};
-        for (var i = 0; i < store.length; i++) {
-          var k = store.key(i);
-          if (!k) continue;
-          var v = store.getItem(k);
-          if (v !== null) out[k] = v;
-        }
-        return out;
-      })()`;
-    const values = (await page.evaluate(script));
-    return { values: values ?? {} };
-}
-export async function storageSet(page, kind, key, value) {
-    if (!key) {
-        throw new Error("key is required");
-    }
-    const storeName = kind === "session" ? "window.sessionStorage" : "window.localStorage";
-    await page.evaluate(`${storeName}.setItem(${JSON.stringify(key)}, ${JSON.stringify(value)})`);
-}
-export async function storageClear(page, kind) {
-    const storeName = kind === "session" ? "window.sessionStorage" : "window.localStorage";
-    await page.evaluate(`${storeName}.clear()`);
-}

package/dist/definitions/browser/types.js

@@ -1,4 +0,0 @@
-// Originally from OpenClaw (MIT License, Copyright 2025 Peter Steinberger)
-// https://github.com/openclaw/openclaw
-// Modified for ARIA — stripped OpenClaw runtime, rewired to ARIA Tool interface
-export {};