@teaflask/assistant 0.0.0 → 0.3.0

package/dist/reader/roles.js

@@ -0,0 +1,263 @@
+// Role resolution for the page reader: which ARIA role a rendered
+// element effectively carries. Explicit role attributes win when they
+// name a real role; everything else falls back to the tag's implicit
+// role. role="presentation"/"none" deliberately fall back too — sites
+// slap presentation on styled tables and lists whose semantics the
+// reader still wants. Pure attribute logic, no layout reads.
+// Tag → implicit ARIA role, consulted when the element is not an input
+// and not contentEditable.
+const IMPLICIT_ROLE_BY_TAG = {
+    a: "link",
+    button: "button",
+    iframe: "iframe",
+    select: "combobox",
+    textarea: "textbox",
+    h1: "heading",
+    h2: "heading",
+    h3: "heading",
+    h4: "heading",
+    h5: "heading",
+    h6: "heading",
+    canvas: "canvas",
+    svg: "image",
+    img: "image",
+    nav: "navigation",
+    main: "main",
+    header: "banner",
+    footer: "contentinfo",
+    section: "region",
+    article: "article",
+    aside: "complementary",
+    form: "form",
+    fieldset: "group",
+    table: "table",
+    ul: "list",
+    ol: "list",
+    li: "listitem",
+    p: "paragraph",
+    label: "label",
+};
+// An explicit role="…" is honored only when it names a role in this
+// allowlist (first valid token wins).
+const VALID_ARIA_ROLES = new Set([
+    "alert",
+    "alertdialog",
+    "application",
+    "article",
+    "banner",
+    "blockquote",
+    "button",
+    "caption",
+    "cell",
+    "checkbox",
+    "code",
+    "columnheader",
+    "combobox",
+    "complementary",
+    "contentinfo",
+    "definition",
+    "deletion",
+    "dialog",
+    "directory",
+    "document",
+    "emphasis",
+    "feed",
+    "figure",
+    "form",
+    "generic",
+    "grid",
+    "gridcell",
+    "group",
+    "heading",
+    "img",
+    "insertion",
+    "link",
+    "list",
+    "listbox",
+    "listitem",
+    "log",
+    "main",
+    "mark",
+    "marquee",
+    "math",
+    "meter",
+    "menu",
+    "menubar",
+    "menuitem",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "navigation",
+    "none",
+    "note",
+    "option",
+    "paragraph",
+    "presentation",
+    "progressbar",
+    "radio",
+    "radiogroup",
+    "region",
+    "row",
+    "rowgroup",
+    "rowheader",
+    "scrollbar",
+    "search",
+    "searchbox",
+    "separator",
+    "slider",
+    "spinbutton",
+    "status",
+    "strong",
+    "subscript",
+    "superscript",
+    "switch",
+    "tab",
+    "table",
+    "tablist",
+    "tabpanel",
+    "term",
+    "textbox",
+    "time",
+    "timer",
+    "toolbar",
+    "tooltip",
+    "tree",
+    "treegrid",
+    "treeitem",
+]);
+// Roles whose nodes carry the bracketed state that matches the set.
+const ARIA_LEVEL_ROLES = new Set(["heading", "listitem", "row", "treeitem"]);
+export const ARIA_SELECTED_ROLES = new Set([
+    "gridcell",
+    "option",
+    "row",
+    "tab",
+    "rowheader",
+    "columnheader",
+    "treeitem",
+]);
+export const ARIA_CHECKED_ROLES = new Set([
+    "checkbox",
+    "radio",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "switch",
+]);
+export const ARIA_DISABLED_ROLES = new Set([
+    "application",
+    "button",
+    "composite",
+    "gridcell",
+    "group",
+    "input",
+    "link",
+    "menuitem",
+    "scrollbar",
+    "separator",
+    "tab",
+    "checkbox",
+    "columnheader",
+    "combobox",
+    "grid",
+    "listbox",
+    "menu",
+    "menubar",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "option",
+    "radio",
+    "radiogroup",
+    "row",
+    "rowheader",
+    "searchbox",
+    "select",
+    "slider",
+    "spinbutton",
+    "switch",
+    "tablist",
+    "textbox",
+    "toolbar",
+    "tree",
+    "treegrid",
+    "treeitem",
+]);
+const NATIVE_HEADING_LEVELS = {
+    h1: 1,
+    h2: 2,
+    h3: 3,
+    h4: 4,
+    h5: 5,
+    h6: 6,
+};
+/** The element's effective role: explicit when valid, implicit otherwise. */
+export function roleOf(element) {
+    const explicit = explicitRoleOf(element);
+    if (explicit === null) {
+        return _implicitRoleOf(element);
+    }
+    if (explicit === "presentation" || explicit === "none") {
+        return _implicitRoleOf(element);
+    }
+    return explicit;
+}
+/** The first valid token of role="…", or null when none names a role. */
+export function explicitRoleOf(element) {
+    const tokens = (element.getAttribute("role") ?? "")
+        .split(" ")
+        .map((token) => token.trim().toLowerCase())
+        .filter((token) => token !== "");
+    return tokens.find((token) => VALID_ARIA_ROLES.has(token)) ?? null;
+}
+/** The heading/listitem/row/treeitem level, or null when the role has none. */
+export function ariaLevelOf(element, role) {
+    if (!ARIA_LEVEL_ROLES.has(role)) {
+        return null;
+    }
+    if (role === "heading") {
+        const native = NATIVE_HEADING_LEVELS[element.tagName.toLowerCase()];
+        if (native !== undefined) {
+            return native;
+        }
+    }
+    const declared = Number(element.getAttribute("aria-level"));
+    return Number.isInteger(declared) && declared >= 1 ? declared : null;
+}
+/** aria-* boolean tri-state: true / false / absent. */
+export function ariaBooleanOf(attribute) {
+    if (attribute === null) {
+        return undefined;
+    }
+    return attribute.toLowerCase() === "true";
+}
+function _implicitRoleOf(element) {
+    const tag = element.tagName.toLowerCase();
+    if (isContentEditableElement(element)) {
+        return "textbox";
+    }
+    if (tag === "input") {
+        const type = element.getAttribute("type");
+        if (type === "submit" || type === "button" || type === "file") {
+            return "button";
+        }
+        if (type === "checkbox") {
+            return "checkbox";
+        }
+        if (type === "radio") {
+            return "radio";
+        }
+        return "textbox";
+    }
+    return IMPLICIT_ROLE_BY_TAG[tag] ?? "generic";
+}
+/** Editable regions read as textboxes. The attribute fallback covers
+ * engines that don't reflect the contentEditable property (jsdom). */
+export function isContentEditableElement(element) {
+    if (element instanceof HTMLElement) {
+        const reflected = element.contentEditable;
+        if (reflected === "true" || reflected === "plaintext-only") {
+            return true;
+        }
+    }
+    const attribute = element.getAttribute("contenteditable");
+    return (attribute === "" || attribute === "true" || attribute === "plaintext-only");
+}
+//# sourceMappingURL=roles.js.map

package/dist/reader/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../src/reader/roles.ts"],"names":[],"mappings":"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"}

package/dist/reader/snapshot-compaction.d.ts

@@ -0,0 +1,11 @@
+import type { SnapshotNode } from "./snapshot.js";
+/** Merge adjacent string children, fold bare paragraphs into the run,
+ * and drop a lone text child that just repeats the node's name. */
+export declare function _mergeStringChildren(node: SnapshotNode): void;
+/** Drop hidden ref-less subtrees and unwrap anonymous wrappers whose
+ * only content is a single ref-bearing child. */
+export declare function _unwrapBareGenerics(node: SnapshotNode, showHidden: boolean): void;
+/** Fold a ref-bearing node's few text-only children into its own name. */
+export declare function _foldTextLeaves(node: SnapshotNode): void;
+export declare function _duplicateRefOf(node: SnapshotNode): string | null;
+//# sourceMappingURL=snapshot-compaction.d.ts.map

package/dist/reader/snapshot-compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-compaction.d.ts","sourceRoot":"","sources":["../../src/reader/snapshot-compaction.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD;mEACmE;AACnE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAoC7D;AAYD;iDACiD;AACjD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,OAAO,GAClB,IAAI,CA4CN;AAaD,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAoCxD;AA+BD,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAoBjE"}

package/dist/reader/snapshot-compaction.js

@@ -0,0 +1,183 @@
+// The compaction passes over a walked tree: merge text runs, unwrap
+// anonymous wrappers, fold text leaves into their parent's name, and
+// refuse a tree that minted one ref twice.
+import { _normalizedNodeName } from "./snapshot-node.js";
+/** Merge adjacent string children, fold bare paragraphs into the run,
+ * and drop a lone text child that just repeats the node's name. */
+export function _mergeStringChildren(node) {
+    for (const child of node.children) {
+        if (typeof child !== "string") {
+            _mergeStringChildren(child);
+        }
+    }
+    const merged = [];
+    let buffer = [];
+    const flush = () => {
+        const text = _mergedTextOf(buffer);
+        if (text !== "") {
+            merged.push(text);
+        }
+        buffer = [];
+    };
+    for (const child of node.children) {
+        if (typeof child === "string") {
+            buffer.push(child);
+        }
+        else if (_isBareTextParagraph(child)) {
+            buffer.push(_mergedTextOf(child.children.filter((c) => typeof c === "string")));
+        }
+        else {
+            flush();
+            merged.push(child);
+        }
+    }
+    flush();
+    node.children = merged;
+    if (node.children.length === 1 &&
+        typeof node.children[0] === "string" &&
+        node.children[0] === node.name) {
+        node.children = [];
+    }
+}
+function _isBareTextParagraph(node) {
+    return (node.role === "paragraph" &&
+        node.refId === null &&
+        !node.hidden &&
+        !node.scrollable &&
+        node.children.every((child) => typeof child === "string"));
+}
+/** Drop hidden ref-less subtrees and unwrap anonymous wrappers whose
+ * only content is a single ref-bearing child. */
+export function _unwrapBareGenerics(node, showHidden) {
+    const result = [];
+    for (const child of node.children) {
+        if (typeof child === "string") {
+            result.push(child);
+            continue;
+        }
+        _unwrapBareGenerics(child, showHidden);
+        // Hidden ref-less noise is pruned from a default read (only the
+        // branded checkbox/radio escape reaches here, and it carries a ref)
+        // — but a show_hidden read exists precisely to surface hidden text
+        // and structure, so there the drop would gut the knob.
+        if (!showHidden &&
+            child.hidden &&
+            child.refId === null &&
+            !_hasRefInSubtree(child)) {
+            continue;
+        }
+        if (child.role === "paragraph" &&
+            child.refId === null &&
+            child.children.length === 1 &&
+            typeof child.children[0] !== "string" &&
+            child.children[0].role === "paragraph") {
+            result.push(child.children[0]);
+            continue;
+        }
+        if (child.role === "generic" &&
+            !child.hidden &&
+            child.name === "" &&
+            child.children.length === 1 &&
+            typeof child.children[0] !== "string" &&
+            child.children[0].refId !== null) {
+            result.push(child.children[0]);
+            continue;
+        }
+        result.push(child);
+    }
+    node.children = result;
+}
+function _hasRefInSubtree(node) {
+    if (node.refId !== null) {
+        return true;
+    }
+    return node.children.some((child) => typeof child !== "string" && _hasRefInSubtree(child));
+}
+const TEXT_LEAF_ROLES = new Set(["generic", "heading", "paragraph", "label"]);
+/** Fold a ref-bearing node's few text-only children into its own name. */
+export function _foldTextLeaves(node) {
+    for (const child of node.children) {
+        if (typeof child !== "string") {
+            _foldTextLeaves(child);
+        }
+    }
+    if (node.refId === null) {
+        return;
+    }
+    if (node.children.length < 1 || node.children.length > 3) {
+        return;
+    }
+    const texts = [];
+    for (const child of node.children) {
+        if (typeof child === "string") {
+            texts.push(child);
+            continue;
+        }
+        const isFoldableLeaf = !child.hidden &&
+            TEXT_LEAF_ROLES.has(child.role) &&
+            child.name !== "" &&
+            child.children.length === 0 &&
+            child.refId === null;
+        if (!isFoldableLeaf) {
+            return;
+        }
+        texts.push(child.name);
+    }
+    const mergedText = _normalizedNodeName(texts.join(" "));
+    if (node.name === "") {
+        node.name = mergedText;
+        node.children = [];
+    }
+    else if (node.name.replace(/\s+/g, "") === mergedText.replace(/\s+/g, "")) {
+        node.children = [];
+    }
+}
+function _mergedTextOf(parts) {
+    let merged = "";
+    for (const part of parts) {
+        if (part === "") {
+            continue;
+        }
+        if (merged === "") {
+            merged = part;
+            continue;
+        }
+        if (_wordsMeetAtTheSeam(merged, part)) {
+            merged += " ";
+        }
+        merged += part;
+    }
+    return merged.trim();
+}
+function _wordsMeetAtTheSeam(left, right) {
+    // Raw boundary characters, not trimmed ends: a fragment that already
+    // carries its own boundary space ("Welcome " + "back") must not gain a
+    // second one — the doubled space would also defeat the repeats-the-name
+    // dedup above.
+    if (/\s$/u.test(left) || /^\s/u.test(right)) {
+        return false;
+    }
+    return /[\p{L}\p{N}]$/u.test(left) && /^[\p{L}\p{N}]/u.test(right);
+}
+export function _duplicateRefOf(node) {
+    const seen = new Set();
+    const walk = (current) => {
+        if (current.refId !== null) {
+            if (seen.has(current.refId)) {
+                return current.refId;
+            }
+            seen.add(current.refId);
+        }
+        for (const child of current.children) {
+            if (typeof child !== "string") {
+                const duplicate = walk(child);
+                if (duplicate !== null) {
+                    return duplicate;
+                }
+            }
+        }
+        return null;
+    };
+    return walk(node);
+}
+//# sourceMappingURL=snapshot-compaction.js.map

package/dist/reader/snapshot-compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-compaction.js","sourceRoot":"","sources":["../../src/reader/snapshot-compaction.ts"],"names":[],"mappings":"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"}

package/dist/reader/snapshot-node.d.ts

@@ -0,0 +1,5 @@
+import type { SnapshotNode, WalkContext } from "./snapshot.js";
+export declare function _snapshotNodeOf(element: Element, context: WalkContext, refFor: (element: Element, role: string, name: string) => string): SnapshotNode | null;
+export declare function _normalizedNodeName(name: string): string;
+export declare function _fragmentNode(): SnapshotNode;
+//# sourceMappingURL=snapshot-node.d.ts.map

package/dist/reader/snapshot-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-node.d.ts","sourceRoot":"","sources":["../../src/reader/snapshot-node.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK/D,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,GAC/D,YAAY,GAAG,IAAI,CA8CrB;AA4DD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,IAAI,YAAY,CAkB5C"}

package/dist/reader/snapshot-node.js

@@ -0,0 +1,117 @@
+// One element becomes one node: role, name, state bits, and a ref when
+// the element is addressable. The ref mint is the caller's — the ref
+// registries stay single-homed in snapshot.ts.
+import { accessibleNameOf } from "./accessible-name.js";
+import { CONTENT_REF_ROLES, INTERACTIVE_REF_ROLES, interactivitySignalsOf, isScrollable, } from "./interactivity.js";
+import { textboxValueOf } from "./redaction.js";
+import { ariaBooleanOf, ariaLevelOf, ARIA_CHECKED_ROLES, ARIA_DISABLED_ROLES, ARIA_SELECTED_ROLES, roleOf, } from "./roles.js";
+import { parentAcrossShadowBoundaryOf } from "./visibility.js";
+const MAX_NODE_NAME_LENGTH = 100;
+export function _snapshotNodeOf(element, context, refFor) {
+    const { options, oracle, nameCache } = context;
+    const role = roleOf(element);
+    const roleLower = role.toLowerCase();
+    const interactivity = interactivitySignalsOf(element, options.probe);
+    const name = _normalizedNodeName(accessibleNameOf(element, options.probe, nameCache));
+    const hidden = !oracle.isVisible(element);
+    const scrollable = isScrollable(element, options.probe);
+    const shouldHaveRef = roleLower === "iframe" ||
+        roleLower === "canvas" ||
+        scrollable ||
+        interactivity.interactive ||
+        INTERACTIVE_REF_ROLES.has(roleLower) ||
+        (CONTENT_REF_ROLES.has(roleLower) && name.length > 0);
+    const refId = shouldHaveRef ? refFor(element, role, name) : null;
+    if (role === "generic" && refId === null && !hidden) {
+        return null; // an anonymous wrapper adds nothing; its children speak
+    }
+    const hints = interactivity.interactive && !interactivity.isInteractiveTag
+        ? interactivity.hints
+        : [];
+    const value = textboxValueOf(element);
+    return {
+        role,
+        name,
+        level: ariaLevelOf(element, role),
+        hidden,
+        scrollable,
+        checked: _checkedStateOf(element, roleLower),
+        selected: _selectedStateOf(element, roleLower),
+        focused: element.ownerDocument.activeElement === element,
+        disabled: _disabledStateOf(element, roleLower),
+        offscreen: !hidden && oracle.isOffscreen(element),
+        refId,
+        hints,
+        placeholder: element.getAttribute("placeholder"),
+        element,
+        children: value !== null && value !== "" ? [value] : [],
+    };
+}
+function _checkedStateOf(element, role) {
+    if (element instanceof HTMLInputElement &&
+        (element.type === "checkbox" || element.type === "radio")) {
+        return element.checked;
+    }
+    if (!ARIA_CHECKED_ROLES.has(role)) {
+        return false;
+    }
+    return ariaBooleanOf(element.getAttribute("aria-checked")) === true;
+}
+function _selectedStateOf(element, role) {
+    if (element instanceof HTMLOptionElement) {
+        return element.selected;
+    }
+    if (!ARIA_SELECTED_ROLES.has(role)) {
+        return false;
+    }
+    return ariaBooleanOf(element.getAttribute("aria-selected")) === true;
+}
+function _disabledStateOf(element, role) {
+    if (!ARIA_DISABLED_ROLES.has(role)) {
+        return false;
+    }
+    if (_isNativelyDisabled(element)) {
+        return true;
+    }
+    for (let current = element; current !== null; current = parentAcrossShadowBoundaryOf(current)) {
+        if (ariaBooleanOf(current.getAttribute("aria-disabled")) === true) {
+            return true;
+        }
+    }
+    return false;
+}
+function _isNativelyDisabled(element) {
+    const tag = element.tagName.toLowerCase();
+    if (!["button", "input", "select", "textarea", "option", "optgroup"].includes(tag)) {
+        return false;
+    }
+    try {
+        return element.matches(":disabled");
+    }
+    catch {
+        return false;
+    }
+}
+export function _normalizedNodeName(name) {
+    return name.replace(/\s+/g, " ").trim().substring(0, MAX_NODE_NAME_LENGTH);
+}
+export function _fragmentNode() {
+    return {
+        role: "fragment",
+        name: "",
+        level: null,
+        hidden: false,
+        scrollable: false,
+        checked: false,
+        selected: false,
+        focused: false,
+        disabled: false,
+        offscreen: false,
+        refId: null,
+        hints: [],
+        placeholder: null,
+        element: null,
+        children: [],
+    };
+}
+//# sourceMappingURL=snapshot-node.js.map

package/dist/reader/snapshot-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-node.js","sourceRoot":"","sources":["../../src/reader/snapshot-node.ts"],"names":[],"mappings":"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"}

package/dist/reader/snapshot-root.d.ts

@@ -0,0 +1,19 @@
+export declare const IGNORE_ATTRIBUTE = "data-teaflask-ignore";
+/** The slice of SnapshotOptions that addresses a root — all root
+ * resolution needs, so ref-addressed capabilities resolve without
+ * inventing a probe or read knobs. */
+export interface RootAddress {
+    rootElement: Element | null;
+    refId: string | null;
+    selector: string | null;
+    ignoreSelectors: string[];
+}
+export declare function _resolvedRootOf(options: RootAddress, elementByRef: ReadonlyMap<string, Element>): {
+    root: Element;
+    error: null;
+} | {
+    root: null;
+    error: string;
+};
+export declare function _theSubtreeIsCurated(element: Element, ignoreSelectors: string[]): boolean;
+//# sourceMappingURL=snapshot-root.d.ts.map

package/dist/reader/snapshot-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-root.d.ts","sourceRoot":"","sources":["../../src/reader/snapshot-root.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD;;sCAEsC;AACtC,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiChE;AAuDD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAWT"}