@acornly/ui 0.1.0 → 0.3.0

package/dist/chat-protocol.js

@@ -0,0 +1,113 @@
+/**
+ * The app context protocol, version 0.1: what an app tells the in-app chat about where the person
+ * is (docs/design/app-context-protocol.md). Experimental: it ships with the chat in
+ * `@acornly/ui/chat` and moves to `@acornly/core` once the chat's checks pass.
+ */
+export const PROTOCOL_VERSION = "0.1";
+/** Limits on one snapshot and one turn (design doc, sections 3 and 10). */
+export const CHAT_LIMITS = {
+    items: 500,
+    around: 50,
+    /** Characters of text parts sent with one turn. */
+    textChars: 64_000,
+    images: 4,
+    imageBytes: 2_000_000,
+    loadsPerTurn: 10,
+    roundsPerTurn: 3,
+    turns: 20,
+    /** Input tokens a conversation may reach, estimated at four characters a token. */
+    conversationTokens: 100_000,
+    replyTokens: 1024,
+};
+/**
+ * Checks a snapshot against the protocol and its limits: items beyond the limit, repeated ids,
+ * parents listed after their children, focus ids not in the items, and links beyond the limit
+ * are dropped, each named in `dropped`. A snapshot with no usable item throws.
+ */
+export function checkSnapshot(input) {
+    if (input?.protocol !== PROTOCOL_VERSION) {
+        throw new Error(`Unsupported app context protocol "${String(input?.protocol)}"`);
+    }
+    const dropped = [];
+    const items = [];
+    const seen = new Set();
+    for (const item of input.items ?? []) {
+        if (typeof item?.id !== "string" || item.id === "" || typeof item.label !== "string") {
+            dropped.push("an item without an id or a label");
+        }
+        else if (seen.has(item.id)) {
+            dropped.push(`a second item "${item.id}"`);
+        }
+        else if (item.parent !== undefined && !seen.has(item.parent)) {
+            dropped.push(`"${item.id}", listed before its parent "${item.parent}"`);
+        }
+        else if (items.length >= CHAT_LIMITS.items) {
+            dropped.push(`"${item.id}" and the items after it (over ${CHAT_LIMITS.items})`);
+            break;
+        }
+        else {
+            items.push(item);
+            seen.add(item.id);
+        }
+    }
+    if (items.length === 0)
+        throw new Error("A context snapshot needs at least one item");
+    let focus = (input.focus ?? []).filter((id) => {
+        if (seen.has(id))
+            return true;
+        dropped.push(`the focus "${id}", which is not an item`);
+        return false;
+    });
+    if (focus.length === 0)
+        focus = [items[0].id];
+    const around = (input.around ?? []).filter((link) => typeof link?.id === "string");
+    if (around.length > CHAT_LIMITS.around) {
+        dropped.push(`${around.length - CHAT_LIMITS.around} links beyond the first ${CHAT_LIMITS.around}`);
+    }
+    return {
+        snapshot: { ...input, items, focus, around: around.slice(0, CHAT_LIMITS.around) },
+        dropped,
+    };
+}
+/** The items in tree order, each with its depth, for the text tree and the model's outline. */
+export function treeRows(snapshot) {
+    const depth = new Map();
+    return snapshot.items.map((item) => {
+        const d = item.parent === undefined ? 0 : (depth.get(item.parent) ?? -1) + 1;
+        depth.set(item.id, d);
+        return { item, depth: d };
+    });
+}
+/** The item and its ancestors, nearest first. */
+export function lineage(snapshot, id) {
+    const byId = new Map(snapshot.items.map((item) => [item.id, item]));
+    const out = [];
+    for (let item = byId.get(id); item !== undefined; item = byId.get(item.parent ?? "")) {
+        if (out.includes(item))
+            break;
+        out.push(item);
+    }
+    return out;
+}
+/** The chip's words for a focus: one label, or the first and last joined ("John 3:16 – 3:18"). */
+export function focusLabel(snapshot, focus) {
+    const labels = focus
+        .map((id) => snapshot.items.find((item) => item.id === id)?.label)
+        .filter((label) => label !== undefined);
+    if (labels.length <= 1)
+        return labels[0] ?? "";
+    return `${labels[0]} – ${labels[labels.length - 1]}`;
+}
+/** Parts that may go to the model. */
+export function sendableParts(parts) {
+    return (parts ?? []).filter((part) => part.use !== "label-only");
+}
+/** Whether an item has a part kept from the model, so the model is told it is withheld. */
+export function hasWithheld(parts) {
+    return (parts ?? []).some((part) => part.use === "label-only");
+}
+/** The hand-backs that apply to an item, by its kind. */
+export function handBacksFor(snapshot, item) {
+    return (snapshot.handBacks ?? []).filter((hb) => hb.kinds === undefined || (item?.kind !== undefined && hb.kinds.includes(item.kind)));
+}
+//# sourceMappingURL=chat-protocol.js.map

package/dist/chat-protocol.js.map

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

package/dist/chat-speech.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Speech to text for the chat's composer (#734): the browser's own recognizer, the Web Speech API,
+ * so the words land in the text box and the person edits them before sending. Acornly never gets
+ * the audio; the browser may send it to its maker's speech service (Chrome, Edge and Safari do,
+ * Safari not for every language). A lazy chunk, fetched the first time the person taps Speak; see
+ * docs/design/app-context-protocol.md, 9.
+ */
+/** What the panel uses of a `SpeechRecognition`. */
+export interface Recognition {
+    lang: string;
+    continuous: boolean;
+    interimResults: boolean;
+    onresult: ((event: {
+        results: ArrayLike<ArrayLike<{
+            transcript: string;
+        }>>;
+    }) => void) | null;
+    onerror: ((event: {
+        error: string;
+    }) => void) | null;
+    onend: (() => void) | null;
+    start(): void;
+    stop(): void;
+    abort(): void;
+}
+export type Recognizer = new () => Recognition;
+export interface Dictation {
+    /** Stops listening; the last words heard still arrive through `onText`, then `onEnd`. */
+    stop(): void;
+    /** Stops listening at once and drops what was not heard yet; `onEnd` still follows. */
+    abort(): void;
+}
+/** The messages for speaking, kept in this chunk so apps that never speak don't load them. */
+export interface SpeechLabels {
+    listening: string;
+    micBlocked: string;
+    noMic: string;
+    speechOff: string;
+    noSpeech: string;
+    speechFailed: string;
+}
+export declare const DEFAULT_SPEECH_LABELS: SpeechLabels;
+/** The message for a recognizer's error code. */
+export declare function speechError(error: string, labels: SpeechLabels): string;
+/**
+ * Joins what was heard. A phrase that repeats the one before and goes on (Android's Chrome sends
+ * "why", "why does", "why does the river" as separate results) replaces it.
+ */
+export declare function joinHeard(phrases: readonly string[]): string;
+/**
+ * Listens until the person stops (or the browser does, after a pause on some phones). `onText`
+ * gets the whole transcript so far each time it changes, the words still being heard included.
+ * `onEnd` comes once, with the recognizer's error code (`"not-allowed"`, `"no-speech"`, ...)
+ * unless it ended cleanly or was aborted.
+ */
+export declare function dictate(Recognizer: Recognizer, options: {
+    lang?: string | undefined;
+    onText: (text: string) => void;
+    onEnd: (error?: string) => void;
+}): Dictation;
+//# sourceMappingURL=chat-speech.d.ts.map

package/dist/chat-speech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-speech.d.ts","sourceRoot":"","sources":["../src/chat-speech.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9F,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACrD,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,WAAW,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,yFAAyF;IACzF,IAAI,IAAI,IAAI,CAAC;IACb,uFAAuF;IACvF,KAAK,IAAI,IAAI,CAAC;CACf;AAED,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAOnC,CAAC;AAEF,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAMvE;AAQD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAc5D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GACA,SAAS,CAqDX"}

package/dist/chat-speech.js

@@ -0,0 +1,119 @@
+/**
+ * Speech to text for the chat's composer (#734): the browser's own recognizer, the Web Speech API,
+ * so the words land in the text box and the person edits them before sending. Acornly never gets
+ * the audio; the browser may send it to its maker's speech service (Chrome, Edge and Safari do,
+ * Safari not for every language). A lazy chunk, fetched the first time the person taps Speak; see
+ * docs/design/app-context-protocol.md, 9.
+ */
+export const DEFAULT_SPEECH_LABELS = {
+    listening: "Listening. Your words land in the box for you to check before sending.",
+    micBlocked: "The microphone is blocked. Allow it for this site to speak, or type instead.",
+    noMic: "No microphone was found. You can type instead.",
+    speechOff: "Speech recognition is off in this browser (on Safari: Siri and Dictation).",
+    noSpeech: "Nothing was heard. Tap Speak to try again.",
+    speechFailed: "Speaking didn't work this time. You can type instead.",
+};
+/** The message for a recognizer's error code. */
+export function speechError(error, labels) {
+    if (error === "not-allowed")
+        return labels.micBlocked;
+    if (error === "service-not-allowed")
+        return labels.speechOff;
+    if (error === "audio-capture")
+        return labels.noMic;
+    if (error === "no-speech")
+        return labels.noSpeech;
+    return labels.speechFailed;
+}
+/**
+ * How long after Stop, and after each word heard since, to wait for the recognizer's own end,
+ * which some Safari versions skip; then it is aborted, so the microphone is let go.
+ */
+const STOP_WAIT_MS = 5000;
+/**
+ * Joins what was heard. A phrase that repeats the one before and goes on (Android's Chrome sends
+ * "why", "why does", "why does the river" as separate results) replaces it.
+ */
+export function joinHeard(phrases) {
+    const kept = [];
+    for (const raw of phrases) {
+        const phrase = raw.replace(/\s+/g, " ").trim();
+        if (!phrase)
+            continue;
+        const last = kept[kept.length - 1];
+        const lower = phrase.toLowerCase();
+        const before = last?.toLowerCase();
+        // Whole words only: "the" then "there is" are two phrases.
+        if (before !== undefined && (lower === before || lower.startsWith(`${before} `)))
+            kept[kept.length - 1] = phrase;
+        else
+            kept.push(phrase);
+    }
+    return kept.join(" ");
+}
+/**
+ * Listens until the person stops (or the browser does, after a pause on some phones). `onText`
+ * gets the whole transcript so far each time it changes, the words still being heard included.
+ * `onEnd` comes once, with the recognizer's error code (`"not-allowed"`, `"no-speech"`, ...)
+ * unless it ended cleanly or was aborted.
+ */
+export function dictate(Recognizer, options) {
+    let ended = false;
+    let quiet = false;
+    let error;
+    let wait;
+    const end = () => {
+        if (ended)
+            return;
+        ended = true;
+        clearTimeout(wait);
+        options.onEnd(error === "aborted" ? undefined : error);
+    };
+    const recognition = new Recognizer();
+    if (options.lang)
+        recognition.lang = options.lang;
+    recognition.continuous = true;
+    recognition.interimResults = true;
+    const giveUp = () => {
+        recognition.abort();
+        end();
+    };
+    /** Waits again from now, once stopping: final words can still be on their way. */
+    const waitForEnd = () => {
+        clearTimeout(wait);
+        wait = setTimeout(giveUp, STOP_WAIT_MS);
+    };
+    let stopped = false;
+    recognition.onresult = (event) => {
+        if (stopped)
+            waitForEnd();
+        if (quiet)
+            return;
+        options.onText(joinHeard(Array.from(event.results, (result) => result[0]?.transcript ?? "")));
+    };
+    recognition.onerror = (event) => {
+        error = event.error;
+    };
+    recognition.onend = end;
+    try {
+        recognition.start();
+    }
+    catch {
+        // Started twice, or refused outright: end after the caller has its handle.
+        error = "start-failed";
+        queueMicrotask(end);
+    }
+    return {
+        stop() {
+            stopped = true;
+            recognition.stop();
+            waitForEnd();
+        },
+        abort() {
+            stopped = quiet = true;
+            recognition.abort();
+            waitForEnd();
+        },
+    };
+}
+//# sourceMappingURL=chat-speech.js.map

package/dist/chat-speech.js.map

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

package/dist/chat.d.ts

@@ -0,0 +1,148 @@
+/**
+ * The in-app chat, experimental (0.x): `import { createChat } from "@acornly/ui/chat"`. What an app
+ * loads up front is only this: it keeps the latest context snapshot, and the panel itself is a lazy
+ * chunk fetched the first time the chat opens. The protocol is docs/design/app-context-protocol.md;
+ * math, and the Bible and history trial behind flights (#730), adopt it until its checks pass (#695).
+ */
+import type { Target } from "@acornly/core";
+import { type ContextItem, type ContextSnapshot, type Rect } from "./chat-protocol.js";
+import type { SpeechLabels } from "./chat-speech.js";
+import { type AcornlyRoot } from "./root.js";
+export * from "./chat-protocol.js";
+/** A takeaway the person chose to keep, for the app to save as an acorn. */
+export interface KeptTakeaway {
+    text: string;
+    /** The item it is about. */
+    item: string;
+    /** Where the acorn anchors: the item by id, then by quote and source. */
+    target: Target;
+    /** The item's concept keys, to store as the acorn's tags. */
+    about: string[];
+    /** The item's text on screen (its `anchor.quote`), for `{ context, quote }` in the SDK. */
+    quote?: string;
+}
+/** A comment the person wrote on an item, for the app to save as a note: the same shape. */
+export type ContextComment = KeptTakeaway;
+/** What the panel's form does: ask the chat, or save a comment on the item. */
+export type ChatMode = "ask" | "comment";
+/** The speaking messages' defaults load with speaking itself (`chat-speech.ts`). */
+export interface ChatLabels extends Partial<SpeechLabels> {
+    title: string;
+    close: string;
+    about: string;
+    change: string;
+    rules: string;
+    dropped: string;
+    tree: string;
+    inFocus: string;
+    onScreen: string;
+    pickHint: string;
+    pickList: string;
+    cancel: string;
+    nowOn: (label: string) => string;
+    askInstead: string;
+    nowAsking: (label: string) => string;
+    placeholder: string;
+    send: string;
+    speak: string;
+    stopSpeaking: string;
+    notStored: string;
+    read: (labels: string[]) => string;
+    refused: string;
+    keep: string;
+    drafting: string;
+    /** Read aloud while the reply has not started, or while the model reads an item. */
+    thinking: string;
+    takeaway: string;
+    save: string;
+    kept: string;
+    keepFailed: string;
+    failed: string;
+    capReached: string;
+    /** A failed ask, by the model proxy's reason (#740); the first three link to the hub. */
+    noGrant: string;
+    noKey: string;
+    budgetExhausted: string;
+    inactive: string;
+    rateLimited: string;
+    openAppsYouUse: string;
+    openYourAi: string;
+    newTab: string;
+    noTransport: string;
+    noGuard: string;
+    badContext: string;
+    full: string;
+    newChat: string;
+    modes: string;
+    modeAsk: string;
+    modeComment: string;
+    commentPlaceholder: string;
+    commentSave: string;
+    commentNote: string;
+    commented: (label: string) => string;
+    commentFailed: string;
+    noAnchor: string;
+}
+export declare const DEFAULT_CHAT_LABELS: ChatLabels;
+export interface ChatOptions {
+    /** The model the app's grant allows for chat. */
+    model: string;
+    /** Calls straight from the browser to the model proxy Worker, with the person's app token. */
+    proxy?: {
+        url: string;
+        appId: string;
+        token: () => string | Promise<string>;
+    };
+    /** The app's own endpoint, for snapshots whose rules say `guard: "relay"`. */
+    relay?: {
+        endpoint: string;
+        headers?: () => Record<string, string> | Promise<Record<string, string>>;
+    };
+    /** An item's content, for `read_context`; `null` for anything the person may not see. */
+    load?: (id: string) => Promise<ContextItem | null>;
+    /** An item's rectangle on screen, for what is not an element; `null` when off screen. */
+    rect?: (id: string) => Rect | null;
+    /** True when a sentence breaks the app's rules (with `guard: "callback"`). */
+    guard?: (sentence: string, replySoFar: string) => boolean | Promise<boolean>;
+    /** The person tapped one of the app's hand-backs, about an item. */
+    onHandBack?: (handBack: string, itemId: string) => void;
+    /** Saves a kept takeaway as an acorn. Without it, "Keep" is not offered. */
+    onKeep?: (kept: KeptTakeaway) => Promise<void>;
+    /**
+     * Saves a comment on the item in focus as a note. With it the panel offers "Comment" beside
+     * "Ask" (or alone, with no `proxy` or `relay`); a comment calls no model.
+     */
+    onComment?: (comment: ContextComment) => Promise<void>;
+    /**
+     * Speak in place of typing, through the browser's own speech recognition (shown only where the
+     * browser has it). The words land in the text box to edit before sending. `false` hides it;
+     * `lang` is the language to listen for (default: the page's `lang`, else the browser's).
+     */
+    speech?: false | {
+        lang?: string;
+    };
+    /** The person started (`true`) or stopped speaking to the chat, so the app can pause its audio. */
+    onListening?: (listening: boolean) => void;
+    /** Draws LaTeX in replies; without it, math shows as written. */
+    renderMath?: (tex: string, display: boolean) => Node;
+    onClose?: () => void;
+    labels?: Partial<ChatLabels>;
+    /**
+     * The hub's origin, which a failed ask links to for a missing grant or key. Default:
+     * `https://acornly.ai`. A path on it is dropped: the hub's pages are at its root.
+     */
+    hubUrl?: string;
+}
+export interface Chat {
+    /** The app's context now. Cheap: the latest is kept, and read only while the chat is open. */
+    setContext(snapshot: ContextSnapshot): void;
+    /**
+     * Opens the chat on the current focus, or on `focus` (the app's "Ask about this"), in `mode`
+     * (default: as the person left it, first "ask"; "comment" for an app's own Comment button).
+     */
+    open(focus?: readonly string[], mode?: ChatMode): Promise<void>;
+    close(): void;
+    readonly isOpen: boolean;
+}
+export declare function createChat(root: AcornlyRoot, options: ChatOptions): Chat;
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

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

package/dist/chat.js

@@ -0,0 +1,119 @@
+import { checkSnapshot, } from "./chat-protocol.js";
+import { lazyPart } from "./lazy.js";
+import { layerOf } from "./root.js";
+export * from "./chat-protocol.js";
+export const DEFAULT_CHAT_LABELS = {
+    title: "Ask",
+    close: "Close the chat",
+    about: "About:",
+    change: "Change",
+    rules: "What this chat won't do here",
+    dropped: "Left out, over the limits:",
+    tree: "Everything you can ask about",
+    inFocus: "in focus",
+    onScreen: "on screen",
+    pickHint: "Click what you want to ask about.",
+    pickList: "Pick from a list",
+    cancel: "Cancel",
+    nowOn: (label) => `Now on ${label}. `,
+    askInstead: "Ask about that instead?",
+    nowAsking: (label) => `Now asking about ${label}`,
+    placeholder: "Ask about this…",
+    send: "Send",
+    speak: "Speak",
+    stopSpeaking: "Stop",
+    notStored: "Chats aren't saved. Only what you keep is.",
+    read: (labels) => `Read: ${labels.join(", ")}`,
+    refused: "I can't help with that here.",
+    keep: "Keep",
+    drafting: "Drafting a takeaway…",
+    thinking: "Thinking…",
+    takeaway: "Your takeaway",
+    save: "Save as an acorn",
+    kept: "Kept in your acorns.",
+    keepFailed: "It couldn't be saved. Try again.",
+    failed: "The chat couldn't answer. Try again.",
+    capReached: "Chat has used its share for this month; the app's own help still works.",
+    noGrant: "Chat needs your leave to use your AI in this app. Turn it on under Apps you use.",
+    noKey: "Chat needs a key for its model's provider on your Acornly account. Add one under Your AI.",
+    budgetExhausted: "This app has used its AI budget for the month. You can raise it under Apps you use.",
+    inactive: "Chat is turned off for this app or your account.",
+    rateLimited: "Too many asks just now. Wait a minute and try again.",
+    openAppsYouUse: "Open Apps you use",
+    openYourAi: "Open Your AI",
+    newTab: "(opens in a new tab)",
+    noTransport: "The chat isn't set up for this part of the app.",
+    noGuard: "The chat can't answer here: the app's check isn't set up.",
+    badContext: "The chat can't read this screen. It waits for the next.",
+    full: "This chat is long enough.",
+    newChat: "Start a new one here",
+    modes: "Ask or comment",
+    modeAsk: "Ask",
+    modeComment: "Comment",
+    commentPlaceholder: "Comment on this…",
+    commentSave: "Save comment",
+    commentNote: "Comments are saved as your notes on what they're about.",
+    commented: (label) => `Saved as a note on ${label}.`,
+    commentFailed: "The comment couldn't be saved. Try again.",
+    noAnchor: "This can't take a comment here. Pick something else with Change.",
+};
+const panelPart = lazyPart(() => import("./chat-panel.js"));
+/** How long a burst of snapshots (a pan, a scrub) settles before an open panel reads the last. */
+const SETTLE_MS = 120;
+export function createChat(root, options) {
+    const labels = { ...DEFAULT_CHAT_LABELS, ...options.labels };
+    let latest = null;
+    let panel = null;
+    let timer;
+    const push = () => {
+        // Called early by `open`, so the waiting push must not land after it and reset its focus.
+        clearTimeout(timer);
+        timer = undefined;
+        if (!panel || !latest)
+            return;
+        let checked = null;
+        try {
+            checked = checkSnapshot(latest);
+        }
+        catch (error) {
+            // A bad snapshot stops sending until a good one comes; the app hears why in the console.
+            console.error(error);
+        }
+        panel.setContext(checked?.snapshot ?? null, checked?.dropped ?? []);
+    };
+    const chat = {
+        setContext(snapshot) {
+            latest = snapshot;
+            if (panel && timer === undefined)
+                timer = setTimeout(push, SETTLE_MS);
+        },
+        async open(focus, mode) {
+            if (!latest)
+                throw new Error("Call setContext before opening the chat");
+            if (panel) {
+                push();
+                panel.ask(focus, mode);
+                return;
+            }
+            const [{ openChatPanel }, layer] = await Promise.all([panelPart.load(), layerOf(root)]);
+            if (panel)
+                return chat.open(focus, mode);
+            const checked = checkSnapshot(focus ? { ...latest, focus: [...focus] } : latest);
+            panel = openChatPanel(layer, {
+                ...options,
+                onClose: () => {
+                    panel = null;
+                    options.onClose?.();
+                },
+            }, labels, checked, mode);
+        },
+        close() {
+            panel?.close();
+        },
+        get isOpen() {
+            return panel !== null;
+        },
+    };
+    return chat;
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/compose.d.ts

@@ -3,6 +3,6 @@
  * the user selects something, so neither the toolbar nor the composer is on the read path.
  */
 export { DEFAULT_TOOLBAR_LABELS, TOOLBAR_SHORTCUTS, openSelectionToolbar, type SelectionToolbar, type ToolbarAction, type ToolbarChoice, type ToolbarLabels, type ToolbarOptions, type ToolbarTarget, } from "./toolbar.js";
-export { COMPOSER_SHORTCUTS, DEFAULT_COMPOSER_LABELS, DEFAULT_REACTIONS, openComposer, type Composer, type ComposerChoice, type ComposerChoiceGroup, type ComposerDraft, type ComposerLabels, type ComposerMode, type ComposerOption, type ComposerOptions, } from "./composer.js";
+export { COMPOSER_SHORTCUTS, DEFAULT_COMPOSER_LABELS, DEFAULT_REACTIONS, openComposer, type Composer, type ComposerChoice, type ComposerChoiceGroup, type ComposerChoiceItems, type ComposerDraft, type ComposerLabels, type ComposerMode, type ComposerOption, type ComposerOptions, } from "./composer.js";
 export type { FloatAnchor } from "./float.js";
 //# sourceMappingURL=compose.d.ts.map

package/dist/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,GAOrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,GASb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,GAOrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,GAUb,MAAM,eAAe,CAAC"}