@pinecall/dot 0.0.0-stage → 0.11.21

package/dist/page/page.d.ts

@@ -0,0 +1,34 @@
+/** The page as the agent reads it: Playwright's aria snapshot, kept small, with a ref on what can be pointed at. */
+import type { Line } from "../wire/index.js";
+/** What `seen()` returns: the text the agent reads, and its size. */
+export interface Seen {
+    text: string;
+    bytes: number;
+    lines: number;
+}
+export declare class Page {
+    #private;
+    constructor(document: Document);
+    /** The page as text, now. Refs given before are given again to the same elements. */
+    seen(): Seen;
+    /**
+     * What the site wrote for the agent to say, each beside the element it is about: `data-pinecall-say`,
+     * in `data-pinecall-order` and then in the page's order, with the move `data-pinecall-do` names
+     * (`point` unless it says `highlight` or `scroll_to`).
+     */
+    lines(): Line[];
+    /** The ref the agent knows `element` by. */
+    refOf(element: Element): string;
+    /** The element a ref names, while it is on the page; null once it is gone. */
+    element(ref: string): Element | null;
+    /** The ref of the first element of `role` whose name holds `name`, in the last `seen()`. */
+    find(role: string, name: string): string | null;
+    /**
+     * The ref of what a person would mean by `name`, anywhere on the page, on the screen or not (a section
+     * out of view is one line of the snapshot, and the things in it can still be named): the name said
+     * exactly, else one that starts with it, else one that holds it, a section before a heading before
+     * a card, a button or a link when several share it.
+     */
+    named(name: string): string | null;
+}
+//# sourceMappingURL=page.d.ts.map

package/dist/page/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/page/page.ts"],"names":[],"mappings":"AAAA,oHAAoH;AAWpH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,qEAAqE;AACrE,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,qBAAa,IAAI;;IASf,YAAY,QAAQ,EAAE,QAAQ,EAE7B;IAED,qFAAqF;IACrF,IAAI,IAAI,IAAI,CAUX;IAED;;;;OAIG;IACH,KAAK,IAAI,IAAI,EAAE,CAYd;IAED,4CAA4C;IAC5C,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE9B;IAED,8EAA8E;IAC9E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAGnC;IAED,4FAA4F;IAC5F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO9C;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBjC;CAgDF"}

package/dist/page/page.js

@@ -0,0 +1,218 @@
+/** The page as the agent reads it: Playwright's aria snapshot, kept small, with a ref on what can be pointed at. */
+//
+// One line per thing a person would name, indented by what holds it: roles and names, not markup.
+// Words in a box that is only layout, as a price, are a line of text, as Playwright says them.
+// What is on the screen is there in full; a section out of view is one line, its name and whether
+// it is above or below, so the agent knows it is there and can scroll to it. A ref is stable for
+// the page's life. A field is its label and what it holds now, a list its options; passwords, card
+// numbers and anything the site marks `data-pinecall-skip` or `aria-hidden` are left out. What the
+// site wrote for the agent to say (`data-pinecall-say`) is marked, and read by `lines()`.
+import { SAID_WHOLE, clean, nameOf, roleOf } from "./roles.js";
+/** The roles that get a ref: what the agent can point at, scroll to, or highlight. */
+const POINTABLE = new Set(["link", "button", "tab", "textbox", "combobox", "checkbox", "radio", "heading", "article", "region", "img", "form", "group"]);
+/** Kept as a line even with no name, because they say where things are. */
+const LANDMARKS = new Set(["banner", "navigation", "main", "contentinfo", "form", "list", "group"]);
+/** Always walked, on screen or not: a sticky header, the page's frame. */
+const FRAME = new Set(["banner", "navigation", "main"]);
+const IGNORED = "script, style, template, audio, video, svg, noscript";
+export class Page {
+    #document;
+    #refs = new WeakMap();
+    /** Every ref ever given, so one the agent holds still names its element after a scroll took it off the screen. */
+    #given = new Map();
+    /** The refs the last `seen()` showed, which `find()` looks through. */
+    #byRef = new Map();
+    #next = 1;
+    constructor(document) {
+        this.#document = document;
+    }
+    /** The page as text, now. Refs given before are given again to the same elements. */
+    seen() {
+        this.#byRef = new Map();
+        const view = this.#document.defaultView;
+        const height = view?.innerHeight ?? 0;
+        const top = Math.round(view?.scrollY ?? 0);
+        const total = Math.round(this.#document.documentElement.scrollHeight);
+        const lines = [`- page "${this.#document.title}" (scrolled ${top}–${top + Math.round(height)} of ${total}px)`];
+        this.#walk(this.#document.body, 0, height, lines);
+        const text = lines.join("\n");
+        return { text, bytes: new TextEncoder().encode(text).length, lines: lines.length };
+    }
+    /**
+     * What the site wrote for the agent to say, each beside the element it is about: `data-pinecall-say`,
+     * in `data-pinecall-order` and then in the page's order, with the move `data-pinecall-do` names
+     * (`point` unless it says `highlight` or `scroll_to`).
+     */
+    lines() {
+        const marked = [...this.#document.body.querySelectorAll("[data-pinecall-say]")].filter((element) => !element.matches(IGNORED) && !left(element));
+        const order = (element) => Number.parseFloat(element.getAttribute("data-pinecall-order") ?? "") || Number.POSITIVE_INFINITY;
+        return marked
+            .map((element, at) => ({ element, at }))
+            .sort((a, b) => order(a.element) - order(b.element) || a.at - b.at)
+            .map(({ element }) => {
+            const asked = element.getAttribute("data-pinecall-do");
+            const move = asked === "highlight" || asked === "scroll_to" ? asked : "point";
+            return { at: this.#ref(element), say: clean(element.getAttribute("data-pinecall-say"), 400), do: move };
+        })
+            .filter((line) => line.say !== "");
+    }
+    /** The ref the agent knows `element` by. */
+    refOf(element) {
+        return this.#ref(element);
+    }
+    /** The element a ref names, while it is on the page; null once it is gone. */
+    element(ref) {
+        const element = this.#given.get(ref)?.deref();
+        return element !== undefined && element.isConnected ? element : null;
+    }
+    /** The ref of the first element of `role` whose name holds `name`, in the last `seen()`. */
+    find(role, name) {
+        const wanted = name.toLowerCase();
+        for (const [ref, element] of this.#byRef) {
+            const own = roleOf(element);
+            if (own === role && nameOf(element, own).toLowerCase().includes(wanted))
+                return ref;
+        }
+        return null;
+    }
+    /**
+     * The ref of what a person would mean by `name`, anywhere on the page, on the screen or not (a section
+     * out of view is one line of the snapshot, and the things in it can still be named): the name said
+     * exactly, else one that starts with it, else one that holds it, a section before a heading before
+     * a card, a button or a link when several share it.
+     */
+    named(name) {
+        const wanted = name.trim().toLowerCase();
+        if (wanted === "")
+            return null;
+        const candidates = [];
+        for (const element of this.#document.body.querySelectorAll("*")) {
+            if (element.matches(IGNORED) || left(element))
+                continue;
+            const role = roleOf(element);
+            if (role === null || !POINTABLE.has(role))
+                continue;
+            const said = nameOf(element, role).toLowerCase();
+            if (said !== "")
+                candidates.push({ ref: this.#ref(element), role, name: said });
+        }
+        for (const fits of [(one) => one === wanted, (one) => one.startsWith(wanted), (one) => one.includes(wanted)]) {
+            const found = candidates.filter((one) => fits(one.name)).sort((a, b) => rank(a.role) - rank(b.role))[0];
+            if (found !== undefined)
+                return found.ref;
+        }
+        return null;
+    }
+    #ref(element) {
+        let ref = this.#refs.get(element);
+        if (ref === undefined) {
+            ref = `e${this.#next}`;
+            this.#next += 1;
+            this.#refs.set(element, ref);
+            this.#given.set(ref, new WeakRef(element));
+        }
+        this.#byRef.set(ref, element);
+        return ref;
+    }
+    #walk(parent, depth, height, lines) {
+        for (const child of parent.children) {
+            if (child.matches(IGNORED) || left(child))
+                continue;
+            const role = roleOf(child);
+            const name = role === null ? "" : nameOf(child, role);
+            const box = child.getBoundingClientRect();
+            const visible = box.bottom > 0 && box.top < height && box.width > 0 && box.height > 0;
+            const indent = "  ".repeat(depth);
+            if (role === "region" && !visible) {
+                const held = holds(child);
+                const inside = held.length > 0 ? `, holds ${held.map((one) => `"${one}"`).join(", ")}` : "";
+                const line = child.hasAttribute("data-pinecall-say") ? " [has a line]" : "";
+                lines.push(`${indent}- region "${name}" [ref=${this.#ref(child)}] (${box.top > 0 ? "below" : "above"}${inside})${line}`);
+                continue;
+            }
+            const kept = role !== null && (name !== "" || LANDMARKS.has(role));
+            if (!kept) {
+                const words = role === null && visible ? wordsIn(child) : "";
+                if (words !== "")
+                    lines.push(`${indent}- text "${words.replaceAll('"', "'")}"`);
+                else
+                    this.#walk(child, depth, height, lines);
+                continue;
+            }
+            if (!visible && !FRAME.has(role))
+                continue;
+            const parts = [`- ${role}`];
+            if (name !== "")
+                parts.push(`"${name.replaceAll('"', "'")}"`);
+            if (role === "heading")
+                parts.push(`[level=${child.tagName.slice(1)}]`);
+            if (child instanceof HTMLDetailsElement)
+                parts.push(child.open ? "[expanded]" : "[collapsed]");
+            if (POINTABLE.has(role))
+                parts.push(`[ref=${this.#ref(child)}]`);
+            parts.push(...heldBy(child));
+            if (child.hasAttribute("data-pinecall-say"))
+                parts.push("[has a line]");
+            lines.push(indent + parts.join(" "));
+            if (!SAID_WHOLE.has(role))
+                this.#walk(child, depth + 1, height, lines);
+        }
+    }
+}
+/** Which of several things that share a name a person means first: the section, then its heading. */
+const PREFERRED = ["region", "heading", "article", "button", "link", "form", "img", "group"];
+function rank(role) {
+    const at = PREFERRED.indexOf(role);
+    return at === -1 ? PREFERRED.length : at;
+}
+/** How many of a section's things its one line names, when the section is out of view. */
+const HELD_AT_MOST = 8;
+const HELD = new Set(["heading", "article", "button", "link"]);
+/** The things a section out of view holds, by name, so the agent knows what it can scroll to. */
+function holds(region) {
+    const names = [];
+    for (const element of region.querySelectorAll("*")) {
+        if (names.length >= HELD_AT_MOST)
+            break;
+        if (element.matches(IGNORED) || left(element))
+            continue;
+        const role = roleOf(element);
+        if (role === null || !HELD.has(role))
+            continue;
+        const name = nameOf(element, role).replaceAll('"', "'");
+        if (name !== "" && !names.includes(name))
+            names.push(name);
+    }
+    return names;
+}
+/** Out of the snapshot: hidden, marked by the site, or a secret. */
+/** What a field holds now, as the visitor sees it: its value, the option chosen and the others, ticked or not. */
+function heldBy(field) {
+    const quoted = (text) => `"${clean(text, 80).replaceAll('"', "'")}"`;
+    if (field instanceof HTMLSelectElement) {
+        const options = [...field.options].map((option) => quoted(option.text));
+        const chosen = field.selectedOptions[0]?.text ?? "";
+        return [chosen === "" ? "[empty]" : `[value=${quoted(chosen)}]`, `(options ${options.join(", ")})`];
+    }
+    if (field instanceof HTMLInputElement && (field.type === "checkbox" || field.type === "radio"))
+        return [field.checked ? "[checked]" : "[unchecked]"];
+    if (field instanceof HTMLInputElement || field instanceof HTMLTextAreaElement)
+        return [field.value === "" ? "[empty]" : `[value=${quoted(field.value)}]`];
+    return [];
+}
+/** The words of a box holding only words and inline marks, as `<div>$19<small> / month</small></div>`; none when it holds more. */
+function wordsIn(box) {
+    const inner = [...box.children];
+    if (inner.some((child) => roleOf(child) !== null || child.children.length > 0))
+        return "";
+    return clean([...box.childNodes].map((node) => (node instanceof Text || (node instanceof Element && !left(node)) ? node.textContent : "")).join(""), 120);
+}
+function left(element) {
+    if (element.closest("[data-pinecall-skip], [aria-hidden='true']") !== null)
+        return true;
+    if (element instanceof HTMLInputElement && (element.type === "password" || element.autocomplete.startsWith("cc-")))
+        return true;
+    const style = element.ownerDocument.defaultView?.getComputedStyle(element);
+    return style !== undefined && (style.display === "none" || style.visibility === "hidden");
+}
+//# sourceMappingURL=page.js.map

package/dist/page/page.js.map

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

package/dist/page/roles.d.ts

@@ -0,0 +1,10 @@
+/** What an element is to a person, as the accessibility tree says it: its role and its name. */
+/** The role an element plays: its `role`, else the one its tag implies; null for a box that is only layout. */
+export declare function roleOf(element: Element): string | null;
+/** Text on one line, cut at `max` characters. */
+export declare function clean(text: string | null | undefined, max?: number): string;
+/** The roles whose name is their own words: nothing under them is said again. */
+export declare const SAID_WHOLE: Set<string>;
+/** What a person calls the element. A field is its label, never its value: a value never leaves the page. */
+export declare function nameOf(element: Element, role: string): string;
+//# sourceMappingURL=roles.d.ts.map

package/dist/page/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/page/roles.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,+GAA+G;AAC/G,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAuBtD;AASD,iDAAiD;AACjD,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,SAAK,GAAG,MAAM,CAGvE;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,aAA2F,CAAC;AAEnH,6GAA6G;AAC7G,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAS7D"}

package/dist/page/roles.js

@@ -0,0 +1,87 @@
+/** What an element is to a person, as the accessibility tree says it: its role and its name. */
+/** The role an element plays: its `role`, else the one its tag implies; null for a box that is only layout. */
+export function roleOf(element) {
+    const explicit = element.getAttribute("role");
+    if (explicit)
+        return explicit;
+    const tag = element.tagName.toLowerCase();
+    if (tag === "a" && element.hasAttribute("href"))
+        return "link";
+    if (tag === "button" || tag === "summary")
+        return "button";
+    if (/^h[1-6]$/.test(tag))
+        return "heading";
+    if (tag === "nav")
+        return "navigation";
+    if (tag === "header" && element.closest("main, article, section") === null)
+        return "banner";
+    if (tag === "footer" && element.closest("main, article, section") === null)
+        return "contentinfo";
+    if (tag === "main")
+        return "main";
+    if (tag === "section" && (element.hasAttribute("aria-labelledby") || element.hasAttribute("aria-label")))
+        return "region";
+    if (tag === "article")
+        return "article";
+    if (tag === "form")
+        return "form";
+    if (tag === "select")
+        return "combobox";
+    if (tag === "textarea")
+        return "textbox";
+    if (tag === "input")
+        return inputRole(element);
+    if (tag === "img" || tag === "figure")
+        return "img";
+    if (tag === "ul" || tag === "ol")
+        return "list";
+    if (tag === "li")
+        return "listitem";
+    if (tag === "details")
+        return "group";
+    if (tag === "p")
+        return "text";
+    return null;
+}
+function inputRole(input) {
+    const type = (input.getAttribute("type") ?? "text").toLowerCase();
+    if (type === "checkbox" || type === "radio")
+        return type;
+    if (type === "submit" || type === "button")
+        return "button";
+    return "textbox";
+}
+/** Text on one line, cut at `max` characters. */
+export function clean(text, max = 80) {
+    const line = (text ?? "").replace(/\s+/g, " ").trim();
+    return line.length > max ? `${line.slice(0, max - 1)}…` : line;
+}
+/** The roles whose name is their own words: nothing under them is said again. */
+export const SAID_WHOLE = new Set(["link", "button", "tab", "heading", "text", "textbox", "combobox", "listitem"]);
+/** What a person calls the element. A field is its label, never its value: a value never leaves the page. */
+export function nameOf(element, role) {
+    const label = element.getAttribute("aria-label");
+    if (label)
+        return clean(label);
+    const by = element.getAttribute("aria-labelledby");
+    if (by)
+        return clean(by.split(/\s+/).map((id) => element.ownerDocument.getElementById(id)?.textContent ?? "").join(" "));
+    if (role === "img")
+        return clean(element.getAttribute("alt") ?? element.textContent);
+    if (role === "textbox" || role === "combobox")
+        return fieldLabel(element);
+    if (SAID_WHOLE.has(role))
+        return clean(element.textContent, role === "text" ? 120 : 80);
+    return "";
+}
+// The label's own words, without the field inside it: a <label> that wraps its input holds the value too.
+function fieldLabel(field) {
+    const id = field.getAttribute("id");
+    const label = id ? field.ownerDocument.querySelector(`label[for="${CSS.escape(id)}"]`) : field.closest("label");
+    if (label !== null) {
+        const words = [...label.childNodes].filter((node) => node.nodeType === Node.TEXT_NODE).map((node) => node.textContent ?? "");
+        return clean(words.join(" "));
+    }
+    return clean(field.getAttribute("placeholder"));
+}
+//# sourceMappingURL=roles.js.map

package/dist/page/roles.js.map

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

package/dist/pointer/card.d.ts

@@ -0,0 +1,13 @@
+/** A card beside the resting face for what the agent puts on the screen: the free times, a form, a piece of code. */
+export declare class Card {
+    #private;
+    /** The card, hidden, put on a layer by `host`; `label` names its close button. */
+    constructor(document: Document, host: (element: Element) => void, label: string);
+    /** Put something on the card, in place of what it held: `render` draws into the body, and may answer how to take it down. */
+    show(render: (body: HTMLElement) => void | (() => void)): void;
+    /** Put it away. */
+    hide(): void;
+    get shown(): boolean;
+    close(): void;
+}
+//# sourceMappingURL=card.d.ts.map

package/dist/pointer/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/pointer/card.ts"],"names":[],"mappings":"AAAA,qHAAqH;AAoBrH,qBAAa,IAAI;;IAOf,kFAAkF;IAClF,YAAY,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,EAkB9E;IAED,6HAA6H;IAC7H,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAK7D;IAED,mBAAmB;IACnB,IAAI,IAAI,IAAI,CAKX;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,KAAK,IAAI,IAAI,CAKZ;CAOF"}

package/dist/pointer/card.js

@@ -0,0 +1,75 @@
+/** A card beside the resting face for what the agent puts on the screen: the free times, a form, a piece of code. */
+//
+// It stands on the person's layer, above the face's corner, out of what the agent reads. The page
+// draws what is in it (`show` hands it the body); the card keeps it until it is put away, replaced or
+// the call ends. Colours: --pc-card and --pc-card-ink, else the bubble's.
+const STYLE = `
+.pc-card { position: fixed; z-index: 1; right: 22px; bottom: 112px; box-sizing: border-box; width: min(600px, calc(100vw - 32px));
+  max-height: min(78vh, 720px); overflow: auto; padding: 20px 22px; border-radius: 16px; pointer-events: auto;
+  background: var(--pc-card, var(--pc-bubble, #fff)); color: var(--pc-card-ink, var(--pc-bubble-ink, #17201c));
+  border: 1px solid rgb(127 127 127 / .24); box-shadow: 0 18px 50px rgb(0 0 0 / .3);
+  font: 15px/1.55 system-ui, -apple-system, "Segoe UI", sans-serif; transform-origin: bottom right; transition: opacity .22s, transform .22s; }
+.pc-card[hidden] { display: block !important; opacity: 0; transform: translateY(8px) scale(.98); pointer-events: none; }
+.pc-layer.pc-left .pc-card { right: auto; left: 22px; transform-origin: bottom left; }
+.pc-card-x { all: unset; position: absolute; top: 8px; right: 10px; width: 22px; height: 22px; line-height: 22px; text-align: center;
+  border-radius: 50%; cursor: pointer; opacity: .5; font-size: 16px; }
+.pc-card-x:hover, .pc-card-x:focus-visible { opacity: 1; background: rgb(127 127 127 / .2); }
+@media (prefers-reduced-motion: reduce) { .pc-card { transition: none; } }
+`;
+export class Card {
+    #style;
+    #card;
+    #body;
+    #cleanup;
+    #fading;
+    /** The card, hidden, put on a layer by `host`; `label` names its close button. */
+    constructor(document, host, label) {
+        this.#style = document.createElement("style");
+        this.#style.textContent = STYLE;
+        document.head.append(this.#style);
+        this.#card = document.createElement("div");
+        this.#card.className = "pc-card";
+        this.#card.hidden = true;
+        this.#card.setAttribute("role", "dialog");
+        const close = document.createElement("button");
+        close.type = "button";
+        close.className = "pc-card-x";
+        close.textContent = "×";
+        close.setAttribute("aria-label", label);
+        close.title = label;
+        close.addEventListener("click", () => this.hide());
+        this.#body = document.createElement("div");
+        this.#card.append(this.#body, close);
+        host(this.#card);
+    }
+    /** Put something on the card, in place of what it held: `render` draws into the body, and may answer how to take it down. */
+    show(render) {
+        this.#release();
+        clearTimeout(this.#fading);
+        this.#card.hidden = false;
+        this.#cleanup = render(this.#body) ?? undefined;
+    }
+    /** Put it away. */
+    hide() {
+        if (this.#card.hidden)
+            return;
+        this.#card.hidden = true;
+        // What it held goes once it has faded, unless something else was put on it meanwhile.
+        this.#fading = setTimeout(() => this.#release(), 260);
+    }
+    get shown() {
+        return !this.#card.hidden;
+    }
+    close() {
+        clearTimeout(this.#fading);
+        this.#release();
+        this.#card.remove();
+        this.#style.remove();
+    }
+    #release() {
+        this.#cleanup?.();
+        this.#cleanup = undefined;
+        this.#body.replaceChildren();
+    }
+}
+//# sourceMappingURL=card.js.map

package/dist/pointer/card.js.map

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

package/dist/pointer/code.d.ts

@@ -0,0 +1,21 @@
+/** A window of code the tutor opens beside the page while it explains it: written in line by line, coloured, the lines it talks about lit. */
+import type { CodeView } from "../wire/index.js";
+export declare class CodeWindow {
+    #private;
+    /** The window, hidden, put on a layer by `host`; `still` writes its lines in at once (reduced motion). */
+    constructor(document: Document, host: (element: Element) => void, still?: boolean);
+    /**
+     * What a step shows: a window opened (or another in its place) for `code`, closed for `null`, kept as
+     * it is for none; and `lines` lit. Answers the first lit line, for the pointer to go to.
+     */
+    show(code: CodeView | null | undefined, lines: [number, number] | undefined): HTMLElement | null;
+    /** Light lines `from` to `to` (from 1), dim the rest, bring the lit ones into the window; answers the first one's code, past its number. */
+    light([from, to]: [number, number]): HTMLElement | null;
+    /** The box the lit lines fill on the screen, for the person to stand clear of; null with none lit. */
+    litBox(): DOMRect | null;
+    /** Whether a window is open. */
+    get open(): boolean;
+    hide(): void;
+    close(): void;
+}
+//# sourceMappingURL=code.d.ts.map

package/dist/pointer/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/pointer/code.ts"],"names":[],"mappings":"AAAA,8IAA8I;AAS9I,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAmCjD,qBAAa,UAAU;;IAUrB,0GAA0G;IAC1G,YAAY,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,KAAK,UAAQ,EAc9E;IAED;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAO/F;IAED,4IAA4I;IAC5I,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,GAAG,IAAI,CAStD;IAED,sGAAsG;IACtG,MAAM,IAAI,OAAO,GAAG,IAAI,CAQvB;IAED,gCAAgC;IAChC,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,IAAI,IAAI,CAIX;IAED,KAAK,IAAI,IAAI,CAIZ;CA+BF"}