@teaflask/assistant 0.0.0 → 0.3.0

package/dist/reader/snapshot-root.js

@@ -0,0 +1,95 @@
+// Root resolution for a read: a pinned element, a remembered ref, a
+// selector match, or the body — refused when the root sits inside a
+// curated (opted-out) subtree.
+import { roleOf } from "./roles.js";
+import { parentAcrossShadowBoundaryOf } from "./visibility.js";
+export const IGNORE_ATTRIBUTE = "data-teaflask-ignore";
+export function _resolvedRootOf(options, elementByRef) {
+    if (options.rootElement !== null) {
+        return _rootUnlessCurated(options.rootElement, options);
+    }
+    if (options.refId !== null) {
+        const remembered = elementByRef.get(options.refId);
+        if (remembered?.isConnected !== true) {
+            return {
+                root: null,
+                error: `The ref "${options.refId}" is not on the current page — ` +
+                    "take a fresh full read and use a ref from it.",
+            };
+        }
+        return _rootUnlessCurated(remembered, options);
+    }
+    if (options.selector !== null) {
+        const matched = _safeQuerySelector(options.selector);
+        if (matched === null) {
+            return {
+                root: null,
+                error: `Nothing on the page matches the selector "${options.selector}" — ` +
+                    "take a full read to see what is there.",
+            };
+        }
+        return _rootUnlessCurated(matched, options);
+    }
+    const body = document.body;
+    if (body === null) {
+        return { root: null, error: "The page has no body to read yet." };
+    }
+    return { root: body, error: null };
+}
+function _rootUnlessCurated(root, options) {
+    // The full-page walk enforces curation top-down — a curated subtree is
+    // never entered, so nothing below it is reachable. A scoped read roots
+    // BELOW the top, so it must check its own ancestry, or a descendant
+    // selector (".private h2") would read inside an opted-out region.
+    for (let current = root; current !== null; current = parentAcrossShadowBoundaryOf(current)) {
+        if (_theSubtreeIsCurated(current, options.ignoreSelectors)) {
+            return {
+                root: null,
+                error: "That part of the page has opted out of page reads — " +
+                    "take a full read to see what is available.",
+            };
+        }
+    }
+    return { root, error: null };
+}
+function _safeQuerySelector(selector) {
+    try {
+        const direct = document.querySelector(selector);
+        if (direct !== null) {
+            return direct;
+        }
+    }
+    catch {
+        return null;
+    }
+    return _firstElementWithImplicitRole(selector);
+}
+function _firstElementWithImplicitRole(selector) {
+    // [role="button"]-shaped selectors should also find elements whose
+    // role is implicit (a bare <button> has no role attribute to match).
+    const match = /^\[role=["'](\w+)["']\]$/.exec(selector);
+    if (match === null) {
+        return null;
+    }
+    const targetRole = match[1];
+    for (const element of Array.from(document.querySelectorAll("*"))) {
+        if (roleOf(element) === targetRole) {
+            return element;
+        }
+    }
+    return null;
+}
+export function _theSubtreeIsCurated(element, ignoreSelectors) {
+    if (element.hasAttribute(IGNORE_ATTRIBUTE)) {
+        return true;
+    }
+    return ignoreSelectors.some((selector) => {
+        try {
+            return element.matches(selector);
+        }
+        catch {
+            return false; // an invalid selector never breaks a read
+        }
+    });
+}
+//# sourceMappingURL=snapshot-root.js.map

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

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

package/dist/reader/snapshot.d.ts

@@ -0,0 +1,82 @@
+import type { LayoutProbe } from "./layout-probe.js";
+import { type AccessibleNameCache } from "./accessible-name.js";
+import { IGNORE_ATTRIBUTE } from "./snapshot-root.js";
+import { type VisibilityOracle } from "./visibility.js";
+export { IGNORE_ATTRIBUTE };
+export declare const DEFAULT_MAX_DEPTH = 50;
+export interface SnapshotOptions {
+    probe: LayoutProbe;
+    /** Grant-configured opt-out selectors; invalid ones are ignored. */
+    ignoreSelectors: string[];
+    maxDepth: number;
+    /** Interactive-elements-only view (with skipped text hoisted). */
+    interactive: boolean;
+    /** Keep invisible elements, marked [hidden]. */
+    showHidden: boolean;
+    /** Root the snapshot at a selector match instead of the body. */
+    selector: string | null;
+    /** Root the snapshot at a previously-minted ref. */
+    refId: string | null;
+    /**
+     * A pre-resolved root, taking precedence over refId/selector. The
+     * size-fitting ladder re-renders one read several times, and each
+     * render rebuilds the ref registry — re-resolving a refId mid-ladder
+     * would fail if the walk just re-minted the element under a new ref,
+     * so the orchestrator resolves once and pins the element.
+     */
+    rootElement: Element | null;
+}
+export interface SnapshotNode {
+    role: string;
+    name: string;
+    level: number | null;
+    hidden: boolean;
+    scrollable: boolean;
+    checked: boolean;
+    selected: boolean;
+    focused: boolean;
+    disabled: boolean;
+    offscreen: boolean;
+    refId: string | null;
+    hints: string[];
+    placeholder: string | null;
+    element: Element | null;
+    children: (SnapshotNode | string)[];
+}
+export type SnapshotOutcome = {
+    tree: SnapshotNode;
+    error: null;
+} | {
+    tree: null;
+    error: string;
+};
+export interface WalkContext {
+    options: SnapshotOptions;
+    oracle: VisibilityOracle;
+    nameCache: AccessibleNameCache;
+}
+export declare function snapshotTreeOf(options: SnapshotOptions): SnapshotOutcome;
+/** Resolve a read's root without walking — for pinning it across the
+ * orchestrator's repeated renders of one read. */
+export declare function resolvedSnapshotRootOf(options: SnapshotOptions): {
+    root: Element;
+    error: null;
+} | {
+    root: null;
+    error: string;
+};
+/**
+ * Resolve a previously-minted ref to its live element — for a capability
+ * that addresses the page by ref (highlight, prefill) instead of reading
+ * it. Liveness and the in-page curation opt-out are checked the same way
+ * a refId-rooted read checks them, and the error is the reader's own
+ * model-actionable sentence.
+ */
+export declare function resolvedElementOfRef(refId: string): {
+    element: Element;
+    error: null;
+} | {
+    element: null;
+    error: string;
+};
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/reader/snapshot.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAkB9B,OAAO,EAGL,gBAAgB,EAEjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAWpC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,oEAAoE;IACpE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,WAAW,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oDAAoD;IACpD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;;OAMG;IACH,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,CAAC,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC;CACrC;AAED,MAAM,MAAM,eAAe,GACzB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAYtE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,mBAAmB,CAAC;CAChC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAyBxE;AAID;kDACkD;AAClD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAYtE"}

package/dist/reader/snapshot.js

@@ -0,0 +1,215 @@
+// The snapshot walk: DOM + shadow DOM in, a compact semantic tree out.
+// Elements earn a place by meaning something — interactive, scrollable,
+// landmark, named, or a non-generic role — and everything else
+// contributes only its text. Curation is opt-out and enforced here, at
+// the walk: a data-teaflask-ignore attribute or a grant-configured
+// selector silently prunes the subtree, and redaction (redaction.ts)
+// guards every value read. Iframes render as leaf nodes: a same-JS
+// bundle cannot see into cross-origin frames, and same-origin recursion
+// is deliberately deferred (the f-prefix ref grammar stays reserved for
+// it — this function is the seam).
+//
+// Ref-ids are minted monotonically and remembered per element across
+// snapshots (WeakMap badge): an unchanged button keeps its ref from read
+// to read, which is what keeps repeat-read diffs small and will let a
+// future capability address elements by ref.
+import { accessibleNameOf, } from "./accessible-name.js";
+import { interactivitySignalsOf, isLandmark, isScrollable, } from "./interactivity.js";
+import { roleOf } from "./roles.js";
+import { _duplicateRefOf, _foldTextLeaves, _mergeStringChildren, _unwrapBareGenerics, } from "./snapshot-compaction.js";
+import { _fragmentNode, _normalizedNodeName, _snapshotNodeOf, } from "./snapshot-node.js";
+import { _resolvedRootOf, _theSubtreeIsCurated, IGNORE_ATTRIBUTE, } from "./snapshot-root.js";
+import { lightAndShadowChildNodesOf, visibilityOracleOf, } from "./visibility.js";
+export { IGNORE_ATTRIBUTE };
+export const DEFAULT_MAX_DEPTH = 50;
+const SKIP_TAGS = new Set([
+    "script",
+    "style",
+    "meta",
+    "link",
+    "title",
+    "noscript",
+]);
+// Monotonic across snapshots on purpose: a ref is never reissued to a
+// different element, and an unchanged element keeps its badge.
+let _refCounter = 0;
+const _refBadgeByElement = new WeakMap();
+// The last snapshot's ref → element registry, for refId-rooted reads.
+const _elementByRef = new Map();
+export function snapshotTreeOf(options) {
+    const context = {
+        options,
+        oracle: visibilityOracleOf(options.probe),
+        nameCache: new Map(),
+    };
+    const rooting = _resolvedRootOf(options, _elementByRef);
+    if (rooting.error !== null) {
+        return { tree: null, error: rooting.error };
+    }
+    const root = rooting.root;
+    _elementByRef.clear();
+    const fragment = _fragmentNode();
+    _traverse(root, 0, fragment, context);
+    _mergeStringChildren(fragment);
+    _unwrapBareGenerics(fragment, options.showHidden);
+    _foldTextLeaves(fragment);
+    const duplicate = _duplicateRefOf(fragment);
+    if (duplicate !== null) {
+        return {
+            tree: null,
+            error: `The snapshot minted the ref "${duplicate}" twice; take a fresh read.`,
+        };
+    }
+    return { tree: fragment, error: null };
+}
+// --- root resolution -------------------------------------------------------
+/** Resolve a read's root without walking — for pinning it across the
+ * orchestrator's repeated renders of one read. */
+export function resolvedSnapshotRootOf(options) {
+    return _resolvedRootOf(options, _elementByRef);
+}
+/**
+ * Resolve a previously-minted ref to its live element — for a capability
+ * that addresses the page by ref (highlight, prefill) instead of reading
+ * it. Liveness and the in-page curation opt-out are checked the same way
+ * a refId-rooted read checks them, and the error is the reader's own
+ * model-actionable sentence.
+ */
+export function resolvedElementOfRef(refId) {
+    const address = {
+        rootElement: null,
+        refId,
+        selector: null,
+        ignoreSelectors: [],
+    };
+    const rooting = _resolvedRootOf(address, _elementByRef);
+    if (rooting.error !== null) {
+        return { element: null, error: rooting.error };
+    }
+    return { element: rooting.root, error: null };
+}
+// --- the walk --------------------------------------------------------------
+function _traverse(element, depth, parentNode, context) {
+    const { options, oracle } = context;
+    const includeAsRoot = options.refId === null && element === document.body;
+    const traversable = _shouldTraverse(element, context);
+    if (!traversable && !includeAsRoot) {
+        // No name hoisting here: a non-traversable subtree is hidden or
+        // curated, and curated content must not leak through its name.
+        return;
+    }
+    const hidden = !oracle.isVisible(element);
+    const include = includeAsRoot ||
+        _shouldIncludeNode(element, context) ||
+        (options.showHidden && hidden);
+    let targetNode = parentNode;
+    if (include) {
+        const node = _snapshotNodeOf(element, context, _refFor);
+        if (node !== null) {
+            parentNode.children.push(node);
+            targetNode = node;
+        }
+    }
+    else if (options.interactive && element.childElementCount === 0) {
+        // A hoisted content name already carries the leaf's text (and its
+        // pseudo content) — descending as well would emit the text twice.
+        if (_hoistSkippedLeafName(element, parentNode, context)) {
+            return;
+        }
+    }
+    const before = options.probe.pseudoContentOf(element, "::before");
+    if (before !== "") {
+        targetNode.children.push(before);
+    }
+    if (_descendsIntoChildren(element) && depth < options.maxDepth) {
+        for (const child of lightAndShadowChildNodesOf(element)) {
+            if (child.nodeType === Node.TEXT_NODE) {
+                // A textbox's value is already seeded; its text would duplicate it.
+                if (targetNode.role !== "textbox" && child.nodeValue !== null) {
+                    targetNode.children.push(child.nodeValue);
+                }
+            }
+            else if (child.nodeType === Node.ELEMENT_NODE) {
+                _traverse(child, depth + 1, targetNode, context);
+            }
+        }
+    }
+    const after = options.probe.pseudoContentOf(element, "::after");
+    if (after !== "") {
+        targetNode.children.push(after);
+    }
+}
+function _descendsIntoChildren(element) {
+    // A <select> renders its own options (render.ts reads element.options
+    // directly) and an <iframe> holds a separate document — walking into
+    // either only does work whose nodes are discarded downstream, and a
+    // select would leak option text as string children the renderer never
+    // shows.
+    const tag = element.tagName.toLowerCase();
+    return tag !== "iframe" && tag !== "select";
+}
+function _shouldTraverse(element, context) {
+    const tag = element.tagName.toLowerCase();
+    if (SKIP_TAGS.has(tag)) {
+        return false;
+    }
+    if (_theSubtreeIsCurated(element, context.options.ignoreSelectors)) {
+        return false;
+    }
+    // No aria-hidden special case: the visibility oracle reads aria-hidden
+    // (inherited) as hidden, so default reads prune these subtrees below
+    // and show_hidden keeps them, marked — same as any other hidden thing.
+    if (!context.options.showHidden && !context.oracle.isVisible(element)) {
+        // Branded-control escape: many designs hide the real radio/checkbox
+        // and render a styled twin; the input still matters.
+        if (element instanceof HTMLInputElement) {
+            const type = element.type;
+            if (type === "radio" || type === "checkbox") {
+                return true;
+            }
+        }
+        return false;
+    }
+    return true;
+}
+function _shouldIncludeNode(element, context) {
+    const { options, nameCache } = context;
+    const role = roleOf(element);
+    const interactive = interactivitySignalsOf(element, options.probe).interactive;
+    const scrollable = isScrollable(element, options.probe);
+    const landmark = isLandmark(element);
+    if (options.interactive) {
+        return role === "canvas" || interactive || scrollable || landmark;
+    }
+    if (interactive || scrollable || landmark) {
+        return true;
+    }
+    if (accessibleNameOf(element, options.probe, nameCache).length > 0) {
+        return true;
+    }
+    return role !== "generic" && role !== "image";
+}
+/** Push a skipped leaf's accessible name as loose text; true when one
+ * was pushed (naming-prohibited roles contribute nothing). */
+function _hoistSkippedLeafName(element, parentNode, context) {
+    const name = _normalizedNodeName(accessibleNameOf(element, context.options.probe, context.nameCache));
+    if (name === "") {
+        return false;
+    }
+    parentNode.children.push(name);
+    return true;
+}
+// --- the ref mint -----------------------------------------------------------
+function _refFor(element, role, name) {
+    const badge = _refBadgeByElement.get(element);
+    if (badge?.role === role && badge.name === name) {
+        _elementByRef.set(badge.ref, element);
+        return badge.ref;
+    }
+    _refCounter += 1;
+    const ref = `e${String(_refCounter)}`;
+    _refBadgeByElement.set(element, { role, name, ref });
+    _elementByRef.set(ref, element);
+    return ref;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/reader/snapshot.js.map

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

package/dist/reader/visibility.d.ts

@@ -0,0 +1,15 @@
+import type { LayoutProbe } from "./layout-probe.js";
+export interface VisibilityOracle {
+    isVisible(element: Element): boolean;
+    isOffscreen(element: Element): boolean;
+}
+export declare function visibilityOracleOf(probe: LayoutProbe): VisibilityOracle;
+/** The parent, crossing a shadow root's boundary to its host. */
+export declare function parentAcrossShadowBoundaryOf(element: Element): Element | null;
+/**
+ * Light-DOM children followed by shadow-DOM children, flat. Slotted
+ * content is traversed at its light-DOM location — the flat view is what
+ * the user perceives; no assignedNodes() projection.
+ */
+export declare function lightAndShadowChildNodesOf(element: Element): Node[];
+//# sourceMappingURL=visibility.d.ts.map

package/dist/reader/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/reader/visibility.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IACrC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CACxC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CA0BvE;AAED,iEAAiE;AACjE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,CAMnE"}

package/dist/reader/visibility.js

@@ -0,0 +1,127 @@
+// Whether an element is actually rendered, and whether what's rendered
+// sits inside the current viewport. The two answers serve different
+// lines: invisible elements are filtered out of the snapshot entirely,
+// while visible-but-scrolled-away elements stay in with an [offscreen]
+// mark — the reader must answer "what is on the user's screen right
+// now", and a toast above the fold and a footer below it are different
+// answers. Verdicts are cached per oracle; one oracle lives exactly one
+// snapshot pass.
+export function visibilityOracleOf(probe) {
+    const visibleByElement = new Map();
+    return {
+        isVisible(element) {
+            const cached = visibleByElement.get(element);
+            if (cached !== undefined) {
+                return cached;
+            }
+            const verdict = _isVisibleUncached(element, probe);
+            visibleByElement.set(element, verdict);
+            return verdict;
+        },
+        isOffscreen(element) {
+            const rect = probe.rectOf(element);
+            if (rect.width <= 0 || rect.height <= 0) {
+                return false;
+            }
+            const viewport = probe.viewportSizeOf();
+            return (rect.bottom <= 0 ||
+                rect.right <= 0 ||
+                rect.top >= viewport.height ||
+                rect.left >= viewport.width);
+        },
+    };
+}
+/** The parent, crossing a shadow root's boundary to its host. */
+export function parentAcrossShadowBoundaryOf(element) {
+    return element.parentElement ?? _containingShadowHostOf(element);
+}
+/**
+ * Light-DOM children followed by shadow-DOM children, flat. Slotted
+ * content is traversed at its light-DOM location — the flat view is what
+ * the user perceives; no assignedNodes() projection.
+ */
+export function lightAndShadowChildNodesOf(element) {
+    const nodes = Array.from(element.childNodes);
+    if (element.shadowRoot !== null) {
+        nodes.push(...Array.from(element.shadowRoot.childNodes));
+    }
+    return nodes;
+}
+function _containingShadowHostOf(element) {
+    const root = element.getRootNode();
+    if (root instanceof ShadowRoot) {
+        return root.host;
+    }
+    return null;
+}
+function _isVisibleUncached(element, probe) {
+    const ownVisibility = probe.styleOf(element).visibility;
+    let hasDisplayContentsAncestor = false;
+    for (let current = element; current !== null && current !== document.documentElement; current = parentAcrossShadowBoundaryOf(current)) {
+        // aria-hidden covers the whole subtree, so an ancestor's counts —
+        // checking only the element itself would read a wrapper's children
+        // as visible while the wrapper reads hidden.
+        if (current.getAttribute("aria-hidden") === "true") {
+            return false;
+        }
+        const style = probe.styleOf(current);
+        if (style.display === "contents") {
+            hasDisplayContentsAncestor = true;
+            continue;
+        }
+        if (style.display === "none") {
+            return false;
+        }
+        if (_hasClippedZeroSizeBox(current, style, probe)) {
+            return false;
+        }
+        if (_isZeroSizedIframe(current, probe)) {
+            return false;
+        }
+        // An explicitly visibility:visible element inside a hidden ancestor
+        // is still rendered — visibility inherits but can be overridden.
+        if (style.visibility === "hidden" && ownVisibility !== "visible") {
+            return false;
+        }
+        if (Number.parseFloat(style.opacity) === 0) {
+            return false;
+        }
+    }
+    const native = probe.nativeVisibilityOf(element);
+    if (native === false && !hasDisplayContentsAncestor) {
+        return false;
+    }
+    return !_isClippedPastTopLeft(element, probe);
+}
+function _hasClippedZeroSizeBox(element, style, probe) {
+    const clips = style.overflowX === "hidden" ||
+        style.overflowX === "clip" ||
+        style.overflowY === "hidden" ||
+        style.overflowY === "clip";
+    if (!clips) {
+        return false;
+    }
+    const size = probe.offsetSizeOf(element);
+    return size.width === 0 || size.height === 0;
+}
+function _isZeroSizedIframe(element, probe) {
+    if (element.tagName.toLowerCase() !== "iframe") {
+        return false;
+    }
+    const size = probe.offsetSizeOf(element);
+    return size.width === 0 || size.height === 0;
+}
+function _isClippedPastTopLeft(element, probe) {
+    // A sized element entirely past the top-left corner whose own overflow
+    // clips is a hidden scroller remnant, not content the user can reach.
+    const rect = probe.rectOf(element);
+    if (rect.width <= 0 || rect.height <= 0) {
+        return false;
+    }
+    if (rect.right > 0 && rect.bottom > 0) {
+        return false;
+    }
+    const style = probe.styleOf(element);
+    return style.overflowX !== "visible" || style.overflowY !== "visible";
+}
+//# sourceMappingURL=visibility.js.map

package/dist/reader/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../src/reader/visibility.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oEAAoE;AACpE,uEAAuE;AACvE,uEAAuE;AACvE,oEAAoE;AACpE,uEAAuE;AACvE,wEAAwE;AACxE,iBAAiB;AASjB,MAAM,UAAU,kBAAkB,CAAC,KAAkB;IACnD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAoB,CAAC;IACrD,OAAO;QACL,SAAS,CAAC,OAAO;YACf,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACnD,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,WAAW,CAAC,OAAO;YACjB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACnC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACxC,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;YACxC,OAAO,CACL,IAAI,CAAC,MAAM,IAAI,CAAC;gBAChB,IAAI,CAAC,KAAK,IAAI,CAAC;gBACf,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,MAAM;gBAC3B,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAC5B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,OAAO,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,MAAM,KAAK,GAAW,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAgB;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAgB,EAAE,KAAkB;IAC9D,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC;IACxD,IAAI,0BAA0B,GAAG,KAAK,CAAC;IACvC,KACE,IAAI,OAAO,GAAmB,OAAO,EACrC,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,QAAQ,CAAC,eAAe,EACxD,OAAO,GAAG,4BAA4B,CAAC,OAAO,CAAC,EAC/C,CAAC;QACD,kEAAkE;QAClE,mEAAmE;QACnE,6CAA6C;QAC7C,IAAI,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,MAAM,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACjC,0BAA0B,GAAG,IAAI,CAAC;YAClC,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,sBAAsB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,oEAAoE;QACpE,iEAAiE;QACjE,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,0BAA0B,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,sBAAsB,CAC7B,OAAgB,EAChB,KAA+C,EAC/C,KAAkB;IAElB,MAAM,KAAK,GACT,KAAK,CAAC,SAAS,KAAK,QAAQ;QAC5B,KAAK,CAAC,SAAS,KAAK,MAAM;QAC1B,KAAK,CAAC,SAAS,KAAK,QAAQ;QAC5B,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAgB,EAAE,KAAkB;IAC9D,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB,EAAE,KAAkB;IACjE,uEAAuE;IACvE,sEAAsE;IACtE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC;AACxE,CAAC"}

package/dist/scroll.d.ts

@@ -0,0 +1,2 @@
+export { ScrollFollowGuards } from "./components/scroll-follow-guards.js";
+//# sourceMappingURL=scroll.d.ts.map

package/dist/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../src/scroll.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/scroll.js

@@ -0,0 +1,17 @@
+// The transcript's scroll-follow guards (fork the composition, share
+// the leaves; the entry has no dashboard importer). Kept public for
+// tarball hosts: use-stick-to-bottom's follow-contract holes (an
+// unobserved scroll element, escapes swallowed while streaming) are
+// wire-agnostic and their repair exists once, here.
+// Public API like "." — additions are cheap until the package publishes,
+// breaking changes are a customer conversation after.
+//
+// Unlike ./markdown, this leaf reads React context ACROSS the package
+// boundary: the host renders its own <StickToBottom> and the guards call
+// useStickToBottomContext() from in here, so both sides must resolve the
+// same use-stick-to-bottom module instance — context identity is per
+// module copy, and a nested duplicate makes the hook throw. That is why
+// use-stick-to-bottom is a peerDependency (beside react/react-dom), not
+// a dependency: the host's copy is the only copy.
+export { ScrollFollowGuards } from "./components/scroll-follow-guards.js";
+//# sourceMappingURL=scroll.js.map

package/dist/scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","sourceRoot":"","sources":["../src/scroll.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,oEAAoE;AACpE,iEAAiE;AACjE,oEAAoE;AACpE,oDAAoD;AACpD,yEAAyE;AACzE,sDAAsD;AACtD,EAAE;AACF,sEAAsE;AACtE,yEAAyE;AACzE,yEAAyE;AACzE,qEAAqE;AACrE,wEAAwE;AACxE,wEAAwE;AACxE,kDAAkD;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC"}