@teaflask/assistant 0.0.0 → 0.3.0

package/dist/components/use-member-toggle-outrank.d.ts

@@ -0,0 +1,46 @@
+import { type MouseEvent, type RefObject } from "react";
+/**
+ * The member's outrank, permanent for the fold: one explicit toggle of
+ * the fold's OWN summary pins the disclosure to native <details> for the
+ * component's lifetime — a later view-bearing call, a fresh decision, a
+ * first failure, and the decay release all stop writing the open
+ * attribute. The pin is session state, not derived state: it records the
+ * member's gesture, which no replay re-derives (Law 9 governs the DEFAULT
+ * state).
+ *
+ * The gesture is recognized in TWO stages: the capture click on the
+ * group wrapper writes a REF only — keyboard activation dispatches the
+ * same click, and only the fold's own summary matches (a member row's
+ * summary has its own parent <details>) — and the state flips from the
+ * fold <details>' own toggle event. Committing state in the capture
+ * handler races the summary's activation behaviour: React 19 flushes a
+ * discrete update at the microtask checkpoint the browser reaches DURING
+ * propagation, so on a held-open fold the commit would remove the open
+ * attribute before the activation behaviour ran — which then toggles the
+ * now-absent attribute back ON, swallowing the member's collapse.
+ *
+ * The premise this ordering rests on: the DOM queues the toggle event
+ * AFTER the activation behaviour has applied the attribute change
+ * (HTML's details toggle steps), so by the time the pin commits, the
+ * <details> already holds the member's chosen state — and the pin's own
+ * re-render releases the prop to undefined, whose only DOM effect is
+ * removing an attribute the collapse case has already removed (a no-op
+ * writes no mutation and queues no second toggle). In the window between
+ * the activation and the toggle task, an unrelated re-render still holds
+ * the prop's OLD value — and React re-writes the open attribute only on
+ * a prop VALUE change (see primitives/disclosure.tsx), so it cannot fight
+ * the member there either. preventDefault is no fix: it would keep a
+ * held fold collapsible and make a decayed fold un-expandable.
+ *
+ * The census of every activation handler in the class this guards is
+ * the activation-commit class census record.
+ *
+ * `groupRef` goes on the group wrapper, `onGroupActivation` on its
+ * capture click; the fold's <details> must be the wrapper's direct child.
+ */
+export declare function useMemberToggleOutrank(): {
+    groupRef: RefObject<HTMLDivElement | null>;
+    memberToggled: boolean;
+    onGroupActivation: (event: MouseEvent<HTMLDivElement>) => void;
+};
+//# sourceMappingURL=use-member-toggle-outrank.d.ts.map

package/dist/components/use-member-toggle-outrank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-member-toggle-outrank.d.ts","sourceRoot":"","sources":["../../src/components/use-member-toggle-outrank.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;CAChE,CAsCA"}

package/dist/components/use-member-toggle-outrank.js

@@ -0,0 +1,77 @@
+"use client";
+import { useEffect, useRef, useState, } from "react";
+/**
+ * The member's outrank, permanent for the fold: one explicit toggle of
+ * the fold's OWN summary pins the disclosure to native <details> for the
+ * component's lifetime — a later view-bearing call, a fresh decision, a
+ * first failure, and the decay release all stop writing the open
+ * attribute. The pin is session state, not derived state: it records the
+ * member's gesture, which no replay re-derives (Law 9 governs the DEFAULT
+ * state).
+ *
+ * The gesture is recognized in TWO stages: the capture click on the
+ * group wrapper writes a REF only — keyboard activation dispatches the
+ * same click, and only the fold's own summary matches (a member row's
+ * summary has its own parent <details>) — and the state flips from the
+ * fold <details>' own toggle event. Committing state in the capture
+ * handler races the summary's activation behaviour: React 19 flushes a
+ * discrete update at the microtask checkpoint the browser reaches DURING
+ * propagation, so on a held-open fold the commit would remove the open
+ * attribute before the activation behaviour ran — which then toggles the
+ * now-absent attribute back ON, swallowing the member's collapse.
+ *
+ * The premise this ordering rests on: the DOM queues the toggle event
+ * AFTER the activation behaviour has applied the attribute change
+ * (HTML's details toggle steps), so by the time the pin commits, the
+ * <details> already holds the member's chosen state — and the pin's own
+ * re-render releases the prop to undefined, whose only DOM effect is
+ * removing an attribute the collapse case has already removed (a no-op
+ * writes no mutation and queues no second toggle). In the window between
+ * the activation and the toggle task, an unrelated re-render still holds
+ * the prop's OLD value — and React re-writes the open attribute only on
+ * a prop VALUE change (see primitives/disclosure.tsx), so it cannot fight
+ * the member there either. preventDefault is no fix: it would keep a
+ * held fold collapsible and make a decayed fold un-expandable.
+ *
+ * The census of every activation handler in the class this guards is
+ * the activation-commit class census record.
+ *
+ * `groupRef` goes on the group wrapper, `onGroupActivation` on its
+ * capture click; the fold's <details> must be the wrapper's direct child.
+ */
+export function useMemberToggleOutrank() {
+    const groupRef = useRef(null);
+    const [memberToggled, setMemberToggled] = useState(false);
+    const memberToggleIntentRef = useRef(false);
+    const onGroupActivation = (event) => {
+        const summary = event.target instanceof Element ? event.target.closest("summary") : null;
+        if (summary !== null &&
+            summary.parentElement ===
+                groupRef.current?.querySelector(":scope > details")) {
+            memberToggleIntentRef.current = true;
+        }
+    };
+    useEffect(() => {
+        const details = groupRef.current?.querySelector(":scope > details");
+        if (details === null || details === undefined) {
+            return;
+        }
+        // toggle does not bubble, so the listener rides the <details>
+        // itself (the element is stable for this component's lifetime).
+        // Programmatic toggles — decay's release, an arrival's re-open —
+        // find the ref unarmed and commit nothing; the member's activation
+        // is the only path that arms it, and its own toggle consumes it.
+        const commitMemberToggle = () => {
+            if (memberToggleIntentRef.current) {
+                memberToggleIntentRef.current = false;
+                setMemberToggled(true);
+            }
+        };
+        details.addEventListener("toggle", commitMemberToggle);
+        return () => {
+            details.removeEventListener("toggle", commitMemberToggle);
+        };
+    }, []);
+    return { groupRef, memberToggled, onGroupActivation };
+}
+//# sourceMappingURL=use-member-toggle-outrank.js.map

package/dist/components/use-member-toggle-outrank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-member-toggle-outrank.js","sourceRoot":"","sources":["../../src/components/use-member-toggle-outrank.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EACL,SAAS,EACT,MAAM,EACN,QAAQ,GAGT,MAAM,OAAO,CAAC;AAEf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,sBAAsB;IAKpC,MAAM,QAAQ,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACrD,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,iBAAiB,GAAG,CAAC,KAAiC,EAAE,EAAE;QAC9D,MAAM,OAAO,GACX,KAAK,CAAC,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3E,IACE,OAAO,KAAK,IAAI;YAChB,OAAO,CAAC,aAAa;gBACnB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,kBAAkB,CAAC,EACrD,CAAC;YACD,qBAAqB,CAAC,OAAO,GAAG,IAAI,CAAC;QACvC,CAAC;IACH,CAAC,CAAC;IACF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GACX,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAqB,kBAAkB,CAAC,CAAC;QAC1E,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,8DAA8D;QAC9D,gEAAgE;QAChE,iEAAiE;QACjE,mEAAmE;QACnE,iEAAiE;QACjE,MAAM,kBAAkB,GAAG,GAAG,EAAE;YAC9B,IAAI,qBAAqB,CAAC,OAAO,EAAE,CAAC;gBAClC,qBAAqB,CAAC,OAAO,GAAG,KAAK,CAAC;gBACtC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;QACF,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QACvD,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;AACxD,CAAC"}

package/dist/components/use-perch-clearance.d.ts

@@ -0,0 +1,3 @@
+import { type RefObject } from "react";
+export declare function usePerchClearance(dockRef: RefObject<HTMLDivElement | null>, active: boolean): void;
+//# sourceMappingURL=use-perch-clearance.d.ts.map

package/dist/components/use-perch-clearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-perch-clearance.d.ts","sourceRoot":"","sources":["../../src/components/use-perch-clearance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAwClD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,EACzC,MAAM,EAAE,OAAO,GACd,IAAI,CAQN"}

package/dist/components/use-perch-clearance.js

@@ -0,0 +1,163 @@
+"use client";
+import { useEffect } from "react";
+import { firstClearLiftFor, INTERACTIVE_OBSTRUCTION_SELECTOR, } from "../core/perch-clearance.js";
+/**
+ * Collision awareness for the fixed corner perch: a page that already
+ * owns the corner — a composer's send button, a copy control — must keep
+ * its clicks. The hook probes what the page stacks beneath the perch's
+ * hit box (document.elementsFromPoint sees through the top layer) and
+ * lifts the dock by the smallest clear step (core/perch-clearance owns
+ * the verdict). Re-measured on resize, any scroll, and DOM mutations —
+ * route swaps included — all coalesced to one measurement per frame.
+ * Browsers without elementsFromPoint keep the unlifted corner; the
+ * transparent dock itself never obstructs anything (pointer-events:
+ * none).
+ */
+// How long the settle fallback waits out the dock's 180ms bottom glide
+// when transitionend cannot fire, with room for a busy frame.
+const LIFT_SETTLE_FALLBACK_MS = 400;
+// When the dock lives inside a shadow root (the script-tag custom
+// element), document.elementsFromPoint retargets in-shadow hits to the
+// shadow host — an element the dock neither contains nor shares a tree
+// with, so the self-exclusion checks below can't recognize it and the
+// dock would read itself as an obstruction.
+function _shadowHostChainOf(node) {
+    const hosts = [];
+    let root = node.getRootNode();
+    while (root instanceof ShadowRoot) {
+        hosts.push(root.host);
+        root = root.host.getRootNode();
+    }
+    return hosts;
+}
+export function usePerchClearance(dockRef, active) {
+    useEffect(() => {
+        const dock = dockRef.current;
+        if (!active || dock === null) {
+            return;
+        }
+        return _watchPerchClearance(dock);
+    }, [dockRef, active]);
+}
+/** Whether the PAGE stacks an interactive control under a point: the
+ *  dock's own elements, its shadow hosts and every other assistant
+ *  surface are never obstructions. */
+function _hostObstructionProbeFor(dock) {
+    const doc = dock.ownerDocument;
+    const shadowHostsOfDock = _shadowHostChainOf(dock);
+    return (point) => doc
+        .elementsFromPoint(point.x, point.y)
+        .some((element) => !dock.contains(element) &&
+        !shadowHostsOfDock.includes(element) &&
+        element.closest("[data-tf-assistant]") === null &&
+        element.closest(INTERACTIVE_OBSTRUCTION_SELECTOR) !== null);
+}
+// The dock's one click target: the mark's hit box.
+// The rect is re-based to lift 0 (the natural corner) so the verdict is
+// absolute, not relative to wherever the dock sits right now — valid
+// because a settled dock sits exactly at appliedLift. Null while the
+// box has no size (unmounted, or a dock the browser never showed).
+function _hitBoxRectOf(dock, appliedLift) {
+    const body = dock.querySelector("[data-tf-companion-body]");
+    if (body === null) {
+        return null;
+    }
+    const rect = body.getBoundingClientRect();
+    if (rect.width === 0 || rect.height === 0) {
+        return null;
+    }
+    return {
+        left: rect.left,
+        top: rect.top + appliedLift,
+        width: rect.width,
+        height: rect.height,
+    };
+}
+/** Measures, lifts and re-measures the dock for as long as it is shown;
+ *  returns the teardown. */
+function _watchPerchClearance(dock) {
+    const doc = dock.ownerDocument;
+    if (typeof doc.elementsFromPoint !== "function") {
+        return;
+    }
+    const view = doc.defaultView ?? window;
+    let frame = null;
+    let appliedLift = 0;
+    // A lift change glides there over the dock's bottom transition, and
+    // getBoundingClientRect reads the in-flight position — re-basing with
+    // appliedLift is only exact once the glide lands. While settling,
+    // every trigger defers to the single post-settle measure.
+    let settling = false;
+    let settleTimer = null;
+    const hostObstructionAt = _hostObstructionProbeFor(dock);
+    const measure = () => {
+        frame = null;
+        if (settling) {
+            return;
+        }
+        const rect = _hitBoxRectOf(dock, appliedLift);
+        if (rect === null) {
+            return;
+        }
+        const lift = firstClearLiftFor({ rect, probe: hostObstructionAt });
+        if (lift !== appliedLift) {
+            appliedLift = lift;
+            settling = true;
+            dock.style.setProperty("--_tf-companion-lift", `${String(lift)}px`);
+            // Belt-and-braces settle: transitionend is the precise clock, but
+            // it never fires when the transition doesn't run (a hidden dock,
+            // a browser without the property) — the timer outlasts the 180ms
+            // glide either way.
+            settleTimer = view.setTimeout(settle, LIFT_SETTLE_FALLBACK_MS);
+        }
+    };
+    const scheduleMeasure = () => {
+        if (settling) {
+            return;
+        }
+        frame ??= view.requestAnimationFrame(measure);
+    };
+    // Landing re-measures once: anything the page did mid-glide was
+    // deferred, and the verdict must be re-checked from exact geometry.
+    const settle = () => {
+        if (!settling) {
+            return;
+        }
+        settling = false;
+        if (settleTimer !== null) {
+            view.clearTimeout(settleTimer);
+            settleTimer = null;
+        }
+        scheduleMeasure();
+    };
+    const settleOnBottomTransition = (event) => {
+        if (event.target === dock && event.propertyName === "bottom") {
+            settle();
+        }
+    };
+    scheduleMeasure();
+    view.addEventListener("resize", scheduleMeasure);
+    doc.addEventListener("scroll", scheduleMeasure, {
+        capture: true,
+        passive: true,
+    });
+    dock.addEventListener("transitionend", settleOnBottomTransition);
+    dock.addEventListener("transitioncancel", settleOnBottomTransition);
+    const observer = new MutationObserver(scheduleMeasure);
+    observer.observe(doc.body, { childList: true, subtree: true });
+    return () => {
+        if (frame !== null) {
+            view.cancelAnimationFrame(frame);
+        }
+        if (settleTimer !== null) {
+            view.clearTimeout(settleTimer);
+        }
+        view.removeEventListener("resize", scheduleMeasure);
+        doc.removeEventListener("scroll", scheduleMeasure, { capture: true });
+        dock.removeEventListener("transitionend", settleOnBottomTransition);
+        dock.removeEventListener("transitioncancel", settleOnBottomTransition);
+        observer.disconnect();
+        dock.style.removeProperty("--_tf-companion-lift");
+    };
+}
+//# sourceMappingURL=use-perch-clearance.js.map

package/dist/components/use-perch-clearance.js.map

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

package/dist/components/use-question-panel-keys.d.ts

@@ -0,0 +1,36 @@
+import { type KeyboardEvent, type RefObject } from "react";
+import type { QuestionSetCardModel } from "../core/elicitation-cards.js";
+import type { QuestionModel } from "../core/elicitation-pickers.js";
+import { type QuestionAnswerDraft, type QuestionDraftStore } from "../core/question-drafts.js";
+import type { ElicitationSurface } from "./elicitation-context.js";
+type ActiveChoice = QuestionAnswerDraft["active"];
+interface QuestionPanelKeysInput {
+    card: QuestionSetCardModel;
+    drafts: QuestionDraftStore;
+    submitQuestionAnswers: ElicitationSurface["submitQuestionAnswers"];
+    cursor: number;
+    question: QuestionModel;
+    active: ActiveChoice;
+    customText: string;
+    answerable: boolean;
+    /** Paging closes any open suggestion description. */
+    closeDescription: () => void;
+}
+/** The draft writes the rows make: an option chosen, the custom row
+ *  re-activated, the custom text typed. */
+interface ActiveChoiceWriters {
+    selectOption: (text: string) => void;
+    activateCustomIfDrafted: () => void;
+    setCustomText: (text: string) => void;
+}
+interface QuestionPanelKeys extends ActiveChoiceWriters {
+    rowsRef: RefObject<HTMLDivElement | null>;
+    customRef: RefObject<HTMLTextAreaElement | null>;
+    goTo: (next: number) => void;
+    proceed: () => void;
+    optionKeys: (index: number) => (event: KeyboardEvent<HTMLElement>) => void;
+    customKeys: (event: KeyboardEvent<HTMLTextAreaElement>) => void;
+}
+export declare function useQuestionPanelKeys(input: QuestionPanelKeysInput): QuestionPanelKeys;
+export {};
+//# sourceMappingURL=use-question-panel-keys.d.ts.map

package/dist/components/use-question-panel-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-question-panel-keys.d.ts","sourceRoot":"","sources":["../../src/components/use-question-panel-keys.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAcnE,KAAK,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAElD,UAAU,sBAAsB;IAC9B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qBAAqB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;2CAC2C;AAC3C,UAAU,mBAAmB;IAC3B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,uBAAuB,EAAE,MAAM,IAAI,CAAC;IACpC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,UAAU,iBAAkB,SAAQ,mBAAmB;IACrD,OAAO,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC1C,SAAS,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IACjD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC3E,UAAU,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,mBAAmB,CAAC,KAAK,IAAI,CAAC;CACjE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,sBAAsB,GAC5B,iBAAiB,CA6FnB"}

package/dist/components/use-question-panel-keys.js

@@ -0,0 +1,223 @@
+"use client";
+import { useEffect, useLayoutEffect, useRef, } from "react";
+import { answersOf, firstUnansweredIndexOf, MAX_ANSWER_TEXT_CHARS, overLimitOf, } from "../core/question-drafts.js";
+// Keyboard (the a11y bar of the decision-surface coverage record):
+// the suggestions are a radiogroup with APG roving focus — arrows move
+// focus and selection, Space selects, Enter selects and continues; the
+// custom textarea takes Enter as a newline (never a send) and ⌘/Ctrl+Enter
+// to continue, ↑ at its start returns to the last suggestion, and its
+// row wears the focus ring while the caret is inside (focus is always
+// visible, even before the row is the active choice). The panel never
+// steals focus on arrival (the suspension surface's premise); after the
+// member pages, focus follows to the shown question's row.
+const CUSTOM_TEXTAREA_MAX_HEIGHT_PX = 192;
+export function useQuestionPanelKeys(input) {
+    const { card, drafts, cursor, active, customText, closeDescription } = input;
+    const rowsRef = useRef(null);
+    const customRef = useRef(null);
+    // Focus follows a member's own paging, never an arrival: the flag is
+    // set by the Prev/Next handlers alone and consumed once.
+    const focusAfterPageRef = useRef(false);
+    useEffect(() => {
+        if (!focusAfterPageRef.current) {
+            return;
+        }
+        focusAfterPageRef.current = false;
+        if (active?.kind === "custom") {
+            customRef.current?.focus();
+            return;
+        }
+        const rows = rowsRef.current?.querySelectorAll("[role=radio]");
+        if (rows === undefined || rows.length === 0) {
+            customRef.current?.focus();
+            return;
+        }
+        const checked = [...rows].find((row) => row.getAttribute("aria-checked") === "true");
+        (checked ?? rows[0]).focus();
+    }, [cursor, active]);
+    // Autosize the custom row: one line at rest, growing with a pasted
+    // paragraph to a cap, then scrolling inside (the composer's own
+    // pattern). Layout-effect timing keeps it in step with the keystroke.
+    useLayoutEffect(() => {
+        const textarea = customRef.current;
+        if (textarea === null) {
+            return;
+        }
+        textarea.style.height = "auto";
+        if (textarea.scrollHeight === 0) {
+            return;
+        }
+        textarea.style.height = `${String(Math.min(textarea.scrollHeight, CUSTOM_TEXTAREA_MAX_HEIGHT_PX))}px`;
+    }, [customText, cursor]);
+    const goTo = (next) => {
+        if (next < 0 || next >= card.questions.length) {
+            return;
+        }
+        focusAfterPageRef.current = true;
+        closeDescription();
+        drafts.setCursor(card.interruptId, next);
+    };
+    const writers = activeChoiceWritersOf(input);
+    const focusRow = (index) => {
+        const rows = rowsRef.current?.querySelectorAll("[role=radio]");
+        if (rows === undefined) {
+            return;
+        }
+        if (index >= rows.length) {
+            writers.activateCustomIfDrafted();
+            customRef.current?.focus();
+            return;
+        }
+        rows[Math.max(index, 0)].focus();
+    };
+    const proceed = () => {
+        proceedFrom(input, goTo);
+    };
+    const gestures = {
+        question: input.question,
+        selectOption: writers.selectOption,
+        focusRow,
+        proceed,
+    };
+    return {
+        rowsRef,
+        customRef,
+        goTo,
+        proceed,
+        ...writers,
+        optionKeys: (index) => (event) => {
+            optionRowKey(gestures, index, event);
+        },
+        customKeys: (event) => {
+            customRowKey(gestures, event);
+        },
+    };
+}
+// "Continue" — the footer primary and the Enter/⌘Enter gesture share
+// one meaning: advance locally; from the last question, submit the
+// complete set — or, when a question is still open, go to it.
+function proceedFrom(input, goTo) {
+    const { card, drafts, cursor, answerable, submitQuestionAnswers } = input;
+    if (cursor !== card.questions.length - 1) {
+        goTo(cursor + 1);
+        return;
+    }
+    const current = drafts.get(card.interruptId);
+    const over = overLimitOf(card.questions, current, MAX_ANSWER_TEXT_CHARS);
+    if (over.length > 0) {
+        // Never a silent no-op: go to the over-bound question so the member
+        // can shorten it.
+        const at = card.questions.findIndex((entry) => entry.id === over[0]);
+        if (at >= 0 && at !== cursor) {
+            goTo(at);
+        }
+        return;
+    }
+    const complete = answersOf(card.questions, current);
+    if (complete === null) {
+        const open = firstUnansweredIndexOf(card.questions, current);
+        if (open >= 0 && open !== cursor) {
+            goTo(open);
+        }
+        return;
+    }
+    if (!answerable) {
+        return;
+    }
+    void submitQuestionAnswers(card, complete);
+}
+// THE ACTIVE CHOICE, EVERY WAY IT CAN CHANGE — pointer and keyboard
+// agree at every row:
+//   pointer down on an option row / Space / Enter on it → that option;
+//     the custom text is kept.
+//   ↑ / ↓ between option rows → the row arrived at; text kept.
+//   ↓ from the last option onto the custom row, or pointer down on the
+//     custom row or its textarea → custom ONLY IF it already holds a
+//     usable (non-blank) answer; an EMPTY custom row is not an answer,
+//     so reaching it never un-answers the question — focus moves, the
+//     option stays chosen. (The defect this closes: a click on the empty
+//     row flipped the question to unanswered while ↓ did not.)
+//   ↑ from the custom row's start → the last option, chosen (an arrow
+//     always chooses the row it lands on); text kept.
+//   Tab / focus arriving from the pager or a remount → focus only,
+//     never a choice: navigation is not intent.
+//   typing or pasting in the custom row → custom (the one implicit
+//     switch, and it is the member's own content).
+//   Nothing in this table ever discards custom text or a chosen option:
+//   both live in the draft until the member changes them.
+function activeChoiceWritersOf(input) {
+    const { card, drafts, question, customText, answerable } = input;
+    const customIsDrafted = customText.trim() !== "";
+    return {
+        selectOption: (text) => {
+            if (!answerable) {
+                return;
+            }
+            drafts.selectOption(card.interruptId, question.id, text);
+        },
+        activateCustomIfDrafted: () => {
+            if (answerable && customIsDrafted) {
+                drafts.selectCustom(card.interruptId, question.id);
+            }
+        },
+        setCustomText: (text) => {
+            drafts.setCustomText(card.interruptId, question.id, text);
+        },
+    };
+}
+function optionRowKey({ question, selectOption, focusRow, proceed }, index, event) {
+    switch (event.key) {
+        case "ArrowDown":
+        case "ArrowRight": {
+            event.preventDefault();
+            const next = index + 1;
+            if (next < question.options.length) {
+                selectOption(question.options[next].text);
+            }
+            focusRow(next);
+            return;
+        }
+        case "ArrowUp":
+        case "ArrowLeft": {
+            event.preventDefault();
+            const previous = index - 1;
+            if (previous >= 0) {
+                selectOption(question.options[previous].text);
+                focusRow(previous);
+            }
+            return;
+        }
+        case " ":
+            event.preventDefault();
+            selectOption(question.options[index].text);
+            return;
+        case "Enter":
+            event.preventDefault();
+            // The selection lands in the store synchronously; the continue
+            // reads the updated draft itself.
+            selectOption(question.options[index].text);
+            proceed();
+            return;
+        default:
+            return;
+    }
+}
+function customRowKey({ question, selectOption, focusRow, proceed }, event) {
+    if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) {
+        event.preventDefault();
+        proceed();
+        return;
+    }
+    if (event.key === "ArrowUp" &&
+        event.currentTarget.selectionStart === 0 &&
+        event.currentTarget.selectionEnd === 0 &&
+        question.options.length > 0) {
+        event.preventDefault();
+        // An arrow chooses the row it lands on, as between option rows.
+        selectOption(question.options[question.options.length - 1].text);
+        focusRow(question.options.length - 1);
+    }
+    // A plain Enter stays a newline — a pasted explanation is multi-line
+    // by nature and must never send by accident.
+}
+//# sourceMappingURL=use-question-panel-keys.js.map

package/dist/components/use-question-panel-keys.js.map

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

package/dist/components/use-register-assistant-surface.d.ts

@@ -0,0 +1,10 @@
+import { type AssistantSurfaceKind } from "../core/surface-registry.js";
+/**
+ * Announces a mounted chrome to the page-wide surface registry while
+ * `active` — the signal the companion yields to. A plain effect (not a
+ * layout effect) means the announcement lands one frame after paint;
+ * whether that frame matters for companion flicker is the companion's
+ * call to make, beside its consumer.
+ */
+export declare function useRegisterAssistantSurface(kind: AssistantSurfaceKind, active?: boolean): void;
+//# sourceMappingURL=use-register-assistant-surface.d.ts.map

package/dist/components/use-register-assistant-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-register-assistant-surface.d.ts","sourceRoot":"","sources":["../../src/components/use-register-assistant-surface.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,oBAAoB,EAC1B,MAAM,UAAO,GACZ,IAAI,CAON"}

package/dist/components/use-register-assistant-surface.js

@@ -0,0 +1,19 @@
+"use client";
+import { useEffect } from "react";
+import { assistantSurfaceRegistry, } from "../core/surface-registry.js";
+/**
+ * Announces a mounted chrome to the page-wide surface registry while
+ * `active` — the signal the companion yields to. A plain effect (not a
+ * layout effect) means the announcement lands one frame after paint;
+ * whether that frame matters for companion flicker is the companion's
+ * call to make, beside its consumer.
+ */
+export function useRegisterAssistantSurface(kind, active = true) {
+    useEffect(() => {
+        if (!active) {
+            return;
+        }
+        return assistantSurfaceRegistry.register(kind);
+    }, [kind, active]);
+}
+//# sourceMappingURL=use-register-assistant-surface.js.map

package/dist/components/use-register-assistant-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-register-assistant-surface.js","sourceRoot":"","sources":["../../src/components/use-register-assistant-surface.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EACL,wBAAwB,GAEzB,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAA0B,EAC1B,MAAM,GAAG,IAAI;IAEb,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACrB,CAAC"}

package/dist/components/use-resolved-theme-mode.d.ts

@@ -0,0 +1,4 @@
+import { type RefObject } from "react";
+import type { ToolViewThemeMode } from "../core/tool-view.js";
+export declare function useResolvedThemeMode(ref: RefObject<HTMLElement | null>): ToolViewThemeMode;
+//# sourceMappingURL=use-resolved-theme-mode.d.ts.map

package/dist/components/use-resolved-theme-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-resolved-theme-mode.d.ts","sourceRoot":"","sources":["../../src/components/use-resolved-theme-mode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAe9D,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GACjC,iBAAiB,CA2DnB"}