publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/dist/src/browser/ax-snapshot.js

@@ -1,217 +1,2 @@
-/**
- * AX-backed browser snapshot prototype.
- *
- * This is intentionally additive to the current DOM snapshot. It learns from
- * agent-browser's accessibility-tree refs without changing default `state`
- * output until the AX path proves itself on fixtures and real SaaS workflows.
- */
-const INTERACTIVE_ROLES = new Set([
-    'button',
-    'link',
-    'textbox',
-    'searchbox',
-    'checkbox',
-    'radio',
-    'combobox',
-    'listbox',
-    'menuitem',
-    'menuitemcheckbox',
-    'menuitemradio',
-    'option',
-    'slider',
-    'spinbutton',
-    'switch',
-    'tab',
-    'treeitem',
-]);
-const CONTENT_ROLES = new Set([
-    'article',
-    'cell',
-    'columnheader',
-    'gridcell',
-    'heading',
-    'listitem',
-    'main',
-    'navigation',
-    'region',
-    'rowheader',
-]);
-const STRUCTURAL_ROLES = new Set([
-    'generic',
-    'group',
-    'list',
-    'none',
-    'presentation',
-    'RootWebArea',
-    'WebArea',
-]);
-export function buildAxSnapshot(axTree, opts = {}) {
-    return buildAxSnapshotFromTrees([{ tree: axTree }], opts);
-}
-export function buildAxSnapshotFromTrees(trees, opts = {}) {
-    const lines = ['source: ax', '---'];
-    const refs = new Map();
-    let nextRef = 1;
-    for (const [index, entry] of trees.entries()) {
-        if (index > 0) {
-            const label = entry.frame?.url ? JSON.stringify(entry.frame.url) : JSON.stringify(entry.frame?.frameId ?? `frame:${index}`);
-            lines.push(`frame ${label}:`);
-        }
-        nextRef = renderAxTree(entry.tree, lines, refs, nextRef, {
-            ...opts,
-            frame: entry.frame,
-            baseDepth: index > 0 ? 1 : 0,
-        });
-    }
-    lines.push('---');
-    lines.push(`interactive: ${refs.size}`);
-    return { text: lines.join('\n'), refs };
-}
-function renderAxTree(axTree, lines, refs, nextRef, opts) {
-    const rawNodes = Array.isArray(axTree?.nodes)
-        ? axTree.nodes
-        : [];
-    const nodes = rawNodes.filter((node) => node && !node.ignored);
-    const byId = new Map();
-    const parentIds = new Set();
-    for (const node of nodes) {
-        if (typeof node.nodeId === 'string')
-            byId.set(node.nodeId, node);
-        for (const childId of node.childIds ?? [])
-            parentIds.add(childId);
-    }
-    const roots = nodes.filter((node) => {
-        if (!node.nodeId)
-            return false;
-        const role = axString(node.role);
-        return !parentIds.has(node.nodeId) || role === 'RootWebArea' || role === 'WebArea';
-    });
-    const root = roots[0] ?? nodes[0];
-    const maxDepth = Math.max(1, Math.min(Number(opts.maxDepth) || 50, 200));
-    const roleNameCounts = countRoleNames(nodes);
-    const roleNameSeen = new Map();
-    function render(node, depth) {
-        if (!node || depth > maxDepth)
-            return false;
-        const role = axString(node.role) || 'generic';
-        const name = cleanText(axString(node.name));
-        const value = cleanText(axString(node.value) || propertyValue(node, 'value'));
-        const disabled = propertyValue(node, 'disabled');
-        const checked = propertyValue(node, 'checked');
-        const expanded = propertyValue(node, 'expanded');
-        const selected = propertyValue(node, 'selected');
-        const refEligible = shouldRef(role, name, node.backendDOMNodeId);
-        const shouldShowSelf = refEligible
-            || !!name
-            || !!value
-            || CONTENT_ROLES.has(role)
-            || (!opts.interactiveOnly && !STRUCTURAL_ROLES.has(role));
-        const childStart = lines.length;
-        let hasVisibleChild = false;
-        for (const childId of node.childIds ?? []) {
-            if (render(byId.get(childId), depth + 1))
-                hasVisibleChild = true;
-        }
-        if (!shouldShowSelf && !hasVisibleChild) {
-            lines.length = childStart;
-            return false;
-        }
-        if (shouldShowSelf) {
-            const indent = '  '.repeat(depth);
-            const parts = [];
-            let prefix = '';
-            if (refEligible) {
-                const ref = String(nextRef++);
-                prefix = `[${ref}]`;
-                const key = roleNameKey(role, name);
-                const seen = roleNameSeen.get(key) ?? 0;
-                roleNameSeen.set(key, seen + 1);
-                refs.set(ref, {
-                    ref,
-                    backendNodeId: node.backendDOMNodeId,
-                    role,
-                    name,
-                    ...(roleNameCounts.get(key) > 1 ? { nth: seen } : {}),
-                    ...(opts.frame ? { frame: opts.frame } : {}),
-                });
-            }
-            if (name)
-                parts.push(JSON.stringify(name));
-            if (value && value !== name)
-                parts.push(`value=${JSON.stringify(value)}`);
-            if (checked)
-                parts.push(`checked=${checked}`);
-            if (expanded)
-                parts.push(`expanded=${expanded}`);
-            if (selected)
-                parts.push(`selected=${selected}`);
-            if (disabled === 'true')
-                parts.push('disabled');
-            lines.splice(childStart, 0, `${indent}${prefix}${role}${parts.length ? ` ${parts.join(' ')}` : ''}`);
-        }
-        return true;
-    }
-    render(root, opts.baseDepth);
-    return nextRef;
-}
-export function findAxRefReplacement(axTree, ref) {
-    const nodes = Array.isArray(axTree?.nodes)
-        ? axTree.nodes
-        : [];
-    const targetNth = ref.nth ?? 0;
-    let seen = 0;
-    for (const node of nodes) {
-        if (!node || node.ignored)
-            continue;
-        const role = axString(node.role);
-        const name = cleanText(axString(node.name));
-        if (role !== ref.role || name !== ref.name)
-            continue;
-        if (seen === targetNth) {
-            if (typeof node.backendDOMNodeId !== 'number')
-                return null;
-            return { ...ref, backendNodeId: node.backendDOMNodeId };
-        }
-        seen++;
-    }
-    return null;
-}
-function shouldRef(role, name, backendNodeId) {
-    if (typeof backendNodeId !== 'number')
-        return false;
-    if (INTERACTIVE_ROLES.has(role))
-        return true;
-    return CONTENT_ROLES.has(role) && !!name;
-}
-function countRoleNames(nodes) {
-    const counts = new Map();
-    for (const node of nodes) {
-        if (!node || node.ignored)
-            continue;
-        const role = axString(node.role);
-        const name = cleanText(axString(node.name));
-        if (!shouldRef(role, name, node.backendDOMNodeId))
-            continue;
-        const key = roleNameKey(role, name);
-        counts.set(key, (counts.get(key) ?? 0) + 1);
-    }
-    return counts;
-}
-function roleNameKey(role, name) {
-    return `${role}\u0000${name}`;
-}
-function axString(value) {
-    const raw = value?.value;
-    if (typeof raw === 'string')
-        return raw;
-    if (typeof raw === 'number' || typeof raw === 'boolean')
-        return String(raw);
-    return '';
-}
-function propertyValue(node, name) {
-    const prop = node.properties?.find((candidate) => candidate.name === name);
-    return axString(prop?.value);
-}
-function cleanText(value) {
-    return value.replace(/\s+/g, ' ').trim().slice(0, 160);
-}
+const _=new Set(["button","link","textbox","searchbox","checkbox","radio","combobox","listbox","menuitem","menuitemcheckbox","menuitemradio","option","slider","spinbutton","switch","tab","treeitem"]),T=new Set(["article","cell","columnheader","gridcell","heading","listitem","main","navigation","region","rowheader"]),j=new Set(["generic","group","list","none","presentation","RootWebArea","WebArea"]);export function buildAxSnapshot(n,e={}){return buildAxSnapshotFromTrees([{tree:n}],e)}export function buildAxSnapshotFromTrees(n,e={}){const r=["source: ax","---"],i=new Map;let o=1;for(const[s,a]of n.entries()){if(s>0){const d=a.frame?.url?JSON.stringify(a.frame.url):JSON.stringify(a.frame?.frameId??`frame:${s}`);r.push(`frame ${d}:`)}o=U(a.tree,r,i,o,{...e,frame:a.frame,baseDepth:s>0?1:0})}r.push("---");r.push(`interactive: ${i.size}`);return{text:r.join(`
+`),refs:i}}function U(n,e,r,i,o){const a=(Array.isArray(n?.nodes)?n.nodes:[]).filter((t)=>t&&!t.ignored),d=new Map,S=new Set;for(const t of a){if(typeof t.nodeId==="string")d.set(t.nodeId,t);for(const f of t.childIds??[])S.add(f)}const J=a.filter((t)=>{if(!t.nodeId)return!1;const f=c(t.role);return!S.has(t.nodeId)||f==="RootWebArea"||f==="WebArea"})[0]??a[0],L=Math.max(1,Math.min(Number(o.maxDepth)||50,200)),W=X(a),N=new Map;function I(t,f){if(!t||f>L)return!1;const h=c(t.role)||"generic",u=b(c(t.name)),m=b(c(t.value)||p(t,"value")),V=p(t,"disabled"),w=p(t,"checked"),k=p(t,"expanded"),A=p(t,"selected"),O=E(h,u,t.backendDOMNodeId),$=O||!!u||!!m||T.has(h)||!o.interactiveOnly&&!j.has(h),M=e.length;let R=!1;for(const g of t.childIds??[])if(I(d.get(g),f+1))R=!0;if(!$&&!R){e.length=M;return!1}if($){const g="  ".repeat(f),l=[];let v="";if(O){const x=String(i++);v=`[${x}]`;const y=C(h,u),D=N.get(y)??0;N.set(y,D+1);r.set(x,{ref:x,backendNodeId:t.backendDOMNodeId,role:h,name:u,...W.get(y)>1?{nth:D}:{},...o.frame?{frame:o.frame}:{}})}if(u)l.push(JSON.stringify(u));if(m&&m!==u)l.push(`value=${JSON.stringify(m)}`);if(w)l.push(`checked=${w}`);if(k)l.push(`expanded=${k}`);if(A)l.push(`selected=${A}`);if(V==="true")l.push("disabled");e.splice(M,0,`${g}${v}${h}${l.length?` ${l.join(" ")}`:""}`)}return!0}I(J,o.baseDepth);return i}export function findAxRefReplacement(n,e){const r=Array.isArray(n?.nodes)?n.nodes:[],i=e.nth??0;let o=0;for(const s of r){if(!s||s.ignored)continue;const a=c(s.role),d=b(c(s.name));if(a!==e.role||d!==e.name)continue;if(o===i){if(typeof s.backendDOMNodeId!=="number")return null;return{...e,backendNodeId:s.backendDOMNodeId}}o++}return null}function E(n,e,r){if(typeof r!=="number")return!1;if(_.has(n))return!0;return T.has(n)&&!!e}function X(n){const e=new Map;for(const r of n){if(!r||r.ignored)continue;const i=c(r.role),o=b(c(r.name));if(!E(i,o,r.backendDOMNodeId))continue;const s=C(i,o);e.set(s,(e.get(s)??0)+1)}return e}function C(n,e){return`${n}\x00${e}`}function c(n){const e=n?.value;if(typeof e==="string")return e;if(typeof e==="number"||typeof e==="boolean")return String(e);return""}function p(n,e){const r=n.properties?.find((i)=>i.name===e);return c(r?.value)}function b(n){return n.replace(/\s+/g," ").trim().slice(0,160)}