@teaflask/assistant 0.3.0 → 0.6.0

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

@@ -1,26 +1,7 @@
 "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();
@@ -39,9 +20,6 @@ export function usePerchClearance(dockRef, active) {
         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);
@@ -52,11 +30,6 @@ function _hostObstructionProbeFor(dock) {
         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) {
@@ -73,8 +46,6 @@ function _hitBoxRectOf(dock, appliedLift) {
         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") {
@@ -83,10 +54,6 @@ function _watchPerchClearance(dock) {
     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);
@@ -104,10 +71,6 @@ function _watchPerchClearance(dock) {
             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);
         }
     };
@@ -117,8 +80,6 @@ function _watchPerchClearance(dock) {
         }
         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;
@@ -160,4 +121,3 @@ function _watchPerchClearance(dock) {
         dock.style.removeProperty("--_tf-companion-lift");
     };
 }
-//# sourceMappingURL=use-perch-clearance.js.map

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

@@ -13,11 +13,8 @@ interface QuestionPanelKeysInput {
     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;
@@ -33,4 +30,3 @@ interface QuestionPanelKeys extends ActiveChoiceWriters {
 }
 export declare function useQuestionPanelKeys(input: QuestionPanelKeysInput): QuestionPanelKeys;
 export {};
-//# sourceMappingURL=use-question-panel-keys.d.ts.map

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

@@ -1,22 +1,11 @@
 "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) {
@@ -35,9 +24,6 @@ export function useQuestionPanelKeys(input) {
         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) {
@@ -93,9 +79,6 @@ export function useQuestionPanelKeys(input) {
         },
     };
 }
-// "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) {
@@ -105,8 +88,6 @@ function proceedFrom(input, goTo) {
     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);
@@ -126,25 +107,6 @@ function proceedFrom(input, goTo) {
     }
     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() !== "";
@@ -193,8 +155,6 @@ function optionRowKey({ question, selectOption, focusRow, proceed }, index, even
             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;
@@ -213,11 +173,7 @@ function customRowKey({ question, selectOption, focusRow, proceed }, event) {
         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-register-assistant-surface.d.ts

@@ -1,10 +1,2 @@
 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.js

@@ -1,13 +1,6 @@
 "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) {
@@ -16,4 +9,3 @@ export function useRegisterAssistantSurface(kind, active = true) {
         return assistantSurfaceRegistry.register(kind);
     }, [kind, active]);
 }
-//# sourceMappingURL=use-register-assistant-surface.js.map

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

@@ -1,4 +1,3 @@
 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.js

@@ -1,38 +1,12 @@
 "use client";
 import { useEffect, useLayoutEffect, useState } from "react";
-// The runtime answer to "which palette is painted here?" for the
-// tool-view props' `themeMode`. The stylesheet is the ground truth; its
-// theme grammar is three rules computed AT THE WIDGET ROOT
-// (`[data-tf-assistant]`): (1) an ancestor's or the root's own
-// `data-tf-theme="dark"` paints dark; (2) the root's OWN "light"/"auto"
-// re-pin light at equal specificity, out-cascading an ancestor's dark —
-// root level ONLY; (3) prefers-color-scheme upgrades "auto" to dark at
-// root level only. Resolution mirrors that exactly, never a nearest-
-// carrier walk: carriers inside the root are inert, and no carrier
-// paints light — reporting the OS preference would lie about the pixels.
 const DARK_SCHEME_QUERY = "(prefers-color-scheme: dark)";
 export function useResolvedThemeMode(ref) {
-    // "light" before the first resolution: SSR-safe (no window at module
-    // scope or render time) and the honest default for the no-carrier
-    // case.
     const [mode, setMode] = useState("light");
-    // The initial resolution is a LAYOUT effect on purpose: a passive
-    // effect runs after paint and would hand every renderer one painted
-    // light frame per mount in a dark-pinned host — every mid-stream row,
-    // not an SSR-only artifact.
     useLayoutEffect(() => {
         setMode(_resolvedThemeModeFor(ref.current));
     }, [ref]);
     useEffect(() => {
-        // The ref is read at decision time, never captured. This value has no
-        // CSS backstop — it is handed to host code as the only channel — so
-        // BOTH change paths re-resolve live: the attribute can flip on any
-        // ancestor, written by anyone (a host theme library writing <html>
-        // imperatively), hence a document-wide observer, not a render-time
-        // read; and a slot whose root node is a shadow root watches that root
-        // too — a set `mode` prop lands `data-tf-theme` INSIDE it. One
-        // observer pair per mounted slot: linear in custom-rendered rows, and
-        // `attributeFilter` keeps each dispatch cheap.
         const resolve = () => {
             setMode(_resolvedThemeModeFor(ref.current));
         };
@@ -53,8 +27,6 @@ export function useResolvedThemeMode(ref) {
                 subtree: true,
             });
         }
-        // jsdom ships no matchMedia; a host page always has one. Without
-        // it, "auto" and the OS flip degrade to light rather than throwing.
         if (typeof window.matchMedia !== "function") {
             return () => {
                 observer.disconnect();
@@ -75,9 +47,6 @@ function _resolvedThemeModeFor(element) {
     if (element === null) {
         return "light";
     }
-    // The stylesheet computes the palette at the widget root; a bare test
-    // or fixture mount with no root falls back to the slot element itself,
-    // which the same rules then treat as the root.
     const root = element.closest("[data-tf-assistant]") ?? element;
     const own = root.getAttribute("data-tf-theme");
     if (own === "dark") {
@@ -89,8 +58,6 @@ function _resolvedThemeModeFor(element) {
     if (own === "auto") {
         return _prefersDark() ? "dark" : "light";
     }
-    // A bare root: any strict ancestor's "dark" paints dark (rule 1's
-    // descendant combinator); ancestor "light"/"auto" match no rule.
     const ancestorDark = root.parentElement?.closest('[data-tf-theme="dark"]') ?? null;
     return ancestorDark === null ? "light" : "dark";
 }
@@ -98,4 +65,3 @@ function _prefersDark() {
     return (typeof window.matchMedia === "function" &&
         window.matchMedia(DARK_SCHEME_QUERY).matches);
 }
-//# sourceMappingURL=use-resolved-theme-mode.js.map

package/dist/components/use-roster-disclosure.d.ts

@@ -12,15 +12,9 @@ interface RosterDisclosure {
     onTriggerFocus: () => void;
     onTriggerClick: () => void;
     onTriggerKeyDown: (event: React.KeyboardEvent<HTMLButtonElement>) => void;
-    /** The card's close. */
     close: () => void;
-    /** The card handing focus back on its own Esc. */
     refocusTrigger: () => void;
 }
-/** The roster's open/close choreography across the pill wrapper and its
- *  trigger: hover for mice and pens, tap and keyboard for the rest, with
- *  the one-shot focus-open mute that keeps a tap from toggling twice. */
 export declare function useRosterDisclosure(): RosterDisclosure;
 export declare function useFloatingDismiss(floatingRef: RefObject<HTMLDivElement | null>, triggerRef: RefObject<HTMLButtonElement | null>, onClose: () => void): void;
 export {};
-//# sourceMappingURL=use-roster-disclosure.d.ts.map

package/dist/components/use-roster-disclosure.js

@@ -2,30 +2,16 @@
 import { useEffect, useId, useRef, useState } from "react";
 import { focusIfRestorable } from "./subagent-delegation-surface.js";
 import { useSubagentDrillIn } from "./subagent-drill-in.js";
-/** The roster's open/close choreography across the pill wrapper and its
- *  trigger: hover for mice and pens, tap and keyboard for the rest, with
- *  the one-shot focus-open mute that keeps a tap from toggling twice. */
 export function useRosterDisclosure() {
     const [open, setOpen] = useState(false);
     const rosterId = useId();
     const triggerRef = useRef(null);
     const wrapperRef = useRef(null);
-    // At most one child preview surface at a time: opening the
-    // roster dismisses an open inline drill-in through its own seam —
-    // otherwise the roster's defocus blur would land on the drill-in
-    // popover (a conversation-body child) and the two previews would
-    // contend for the capacity-1 tail lease. Null outside a delegation
-    // surface (tests, bare hosts): nothing to dismiss.
     const drillIn = useSubagentDrillIn();
     const openRoster = () => {
         drillIn?.dismiss();
         setOpen(true);
     };
-    // The one-shot mute on the trigger's focus-open. Two writers: a
-    // pointerdown (a tap fires focus BEFORE click — an unguarded focus-open
-    // would flip the state the click then toggles straight back closed),
-    // and the card handing focus back on its own Esc (a close, not an
-    // arrival). Consumed at the next focus either way.
     const muteFocusOpenRef = useRef(false);
     return {
         open,
@@ -33,32 +19,13 @@ export function useRosterDisclosure() {
         triggerRef,
         wrapperRef,
         onWrapperPointerEnter: (event) => {
-            // Hover opens for mice and pens; a touch pointer waits for
-            // the tap so a scroll-past never flashes the roster open.
             if (event.pointerType !== "touch") {
                 openRoster();
             }
         },
         onWrapperPointerLeave: (event) => {
-            // Touch fires pointerleave between pointerup and the compat
-            // click: an unguarded close here would flip the state the
-            // click then toggles straight back open, breaking
-            // tap-to-close. Only hover-capable pointers close on leave —
-            // and a hover-capable pointer leaving also abandons any
-            // press in flight, so the stale mute goes with it (its focus
-            // consumer already ran at mousedown if the press was real).
             if (event.pointerType !== "touch") {
                 muteFocusOpenRef.current = false;
-                // …but never out from under a keyboard user: the preview
-                // rows are focusable, and unmounting the card
-                // would drop their place to <body>. Only genuinely
-                // keyboard-reachable elements count (tabIndex >= 0): the
-                // card ITSELF carries tabIndex -1 and takes focus from a
-                // click on its passive ink — that focus must not park the
-                // roster open past the hover. Read through getRootNode() —
-                // in the script-tag shadow root, document.activeElement
-                // names the HOST and a contains() guard would always fail
-                // (the floating-panel read).
                 const wrapper = wrapperRef.current;
                 const root = wrapper?.getRootNode();
                 const active = root instanceof Document || root instanceof ShadowRoot
@@ -75,8 +42,6 @@ export function useRosterDisclosure() {
             }
         },
         onWrapperBlur: (event) => {
-            // Focus leaving the pair (Tab away) closes the roster; a
-            // move within it (trigger to a drill-in row) does not.
             const next = event.relatedTarget;
             if (wrapperRef.current !== null &&
                 (!(next instanceof Node) || !wrapperRef.current.contains(next))) {
@@ -84,35 +49,20 @@ export function useRosterDisclosure() {
             }
         },
         onTriggerPointerDown: (event) => {
-            // Primary presses only: a right-click fires no click to
-            // consume the flag, so it must never set it. NOT cleared on
-            // pointerup — touch fires its compat focus AFTER pointerup,
-            // and an early clear would resurrect the open-then-closed
-            // tap (the interaction matrix pins that order).
             if (event.button === 0) {
                 muteFocusOpenRef.current = true;
             }
         },
         onTriggerPointerCancel: () => {
-            // A press the browser took back (touch became a scroll)
-            // fires neither focus nor click — nothing else will
-            // consume the flag.
             muteFocusOpenRef.current = false;
         },
         onTriggerFocus: () => {
-            // Keyboard focus opens; pointer-initiated focus defers to
-            // the click that follows it. The flag is one-shot so an
-            // abandoned press never mutes a later Tab.
             if (!muteFocusOpenRef.current) {
                 openRoster();
             }
             muteFocusOpenRef.current = false;
         },
         onTriggerClick: () => {
-            // The tap/keyboard toggle — the touch path's only opener.
-            // The flag also clears here: a second tap fires no focus
-            // (the trigger already holds it), and a stale flag would
-            // mute the next keyboard Tab once.
             muteFocusOpenRef.current = false;
             if (open) {
                 setOpen(false);
@@ -122,9 +72,6 @@ export function useRosterDisclosure() {
             }
         },
         onTriggerKeyDown: (event) => {
-            // Escape with focus on the trigger closes the roster, not
-            // the surface — stopped so the panel's own Esc never sees
-            // it while the roster is open.
             if (!open || event.key !== "Escape") {
                 return;
             }
@@ -136,22 +83,11 @@ export function useRosterDisclosure() {
             setOpen(false);
         },
         refocusTrigger: () => {
-            // Handing focus back is a close, not an arrival: mute the
-            // focus-open the trigger would otherwise fire, or the
-            // card's own Esc would reopen what it just closed. Through
-            // the shared restorable guard: a scrollback-yielded
-            // trigger is visibility:hidden, where a bare focus()
-            // silently no-ops and strands focus — the guard hands it
-            // to the merged jump affordance instead.
             muteFocusOpenRef.current = true;
             focusIfRestorable(triggerRef.current);
         },
     };
 }
-// Light dismissal for the tap-opened roster: any pointer down outside
-// the card and its trigger closes it. Judged by composedPath(), not
-// contains() — the script-tag distribution runs in an open shadow
-// root, where document-level events retarget to the host element.
 export function useFloatingDismiss(floatingRef, triggerRef, onClose) {
     useEffect(() => {
         const floating = floatingRef.current;
@@ -176,4 +112,3 @@ export function useFloatingDismiss(floatingRef, triggerRef, onClose) {
         };
     }, [floatingRef, onClose, triggerRef]);
 }
-//# sourceMappingURL=use-roster-disclosure.js.map

package/dist/components/use-roster-preview.d.ts

@@ -3,22 +3,14 @@ interface PreviewChoreography {
     previewKey: string | null;
     setPreviewKey: (key: string | null) => void;
     previewRef: RefObject<HTMLDivElement | null>;
-    /** The row that opened the current preview — where Esc hands focus. */
     previewOpenerRef: RefObject<HTMLButtonElement | null>;
-    /** One-shot: the opener's focus after an Esc hand-back is a return,
-     *  not an arrival, and must not reopen the preview it just closed. */
     mutePreviewFocusOpenRef: RefObject<boolean>;
     onPreviewChange: (key: string, open: boolean) => void;
     onPreviewOpener: (opener: HTMLButtonElement) => void;
     onPreviewFocus: (key: string, opener: HTMLButtonElement) => void;
     focusPreview: () => void;
 }
-/** Which row's preview is open, who opened it, and the row callbacks
- *  that move it: hover and tap open, focus opens unless muted. */
 export declare function usePreviewChoreography(): PreviewChoreography;
-/** Escape inside the card or its preview: closes the open preview first
- *  (handing focus back to its opener row, muted so the hand-back does not
- *  reopen it), the roster itself otherwise. */
 export declare function usePreviewEscape(wires: {
     floatingRef: RefObject<HTMLDivElement | null>;
     previewRef: RefObject<HTMLDivElement | null>;
@@ -30,4 +22,3 @@ export declare function usePreviewEscape(wires: {
     refocusTrigger: () => void;
 }): void;
 export {};
-//# sourceMappingURL=use-roster-preview.d.ts.map

package/dist/components/use-roster-preview.js

@@ -1,7 +1,5 @@
 "use client";
 import { useEffect, useRef, useState } from "react";
-/** Which row's preview is open, who opened it, and the row callbacks
- *  that move it: hover and tap open, focus opens unless muted. */
 export function usePreviewChoreography() {
     const previewRef = useRef(null);
     const previewOpenerRef = useRef(null);
@@ -32,9 +30,6 @@ export function usePreviewChoreography() {
         },
     };
 }
-/** Escape inside the card or its preview: closes the open preview first
- *  (handing focus back to its opener row, muted so the hand-back does not
- *  reopen it), the roster itself otherwise. */
 export function usePreviewEscape(wires) {
     const { floatingRef, previewRef, previewOpenerRef, mutePreviewFocusOpenRef, previewKey, setPreviewKey, onClose, refocusTrigger, } = wires;
     useEffect(() => {
@@ -85,4 +80,3 @@ export function usePreviewEscape(wires) {
         refocusTrigger,
     ]);
 }
-//# sourceMappingURL=use-roster-preview.js.map

package/dist/components/use-store-cell.d.ts

@@ -1,5 +1,2 @@
 import type { ReadonlyCell } from "../core/observable-cell.js";
-/** The one React seam onto the store's cells: the cached snapshot doubles
- *  as the server snapshot, so SSR renders the store's initial state. */
 export declare function useCell<T>(cell: ReadonlyCell<T>): T;
-//# sourceMappingURL=use-store-cell.d.ts.map

package/dist/components/use-store-cell.js

@@ -1,8 +1,5 @@
 "use client";
 import { useSyncExternalStore } from "react";
-/** The one React seam onto the store's cells: the cached snapshot doubles
- *  as the server snapshot, so SSR renders the store's initial state. */
 export function useCell(cell) {
     return useSyncExternalStore(cell.subscribe, cell.get, cell.get);
 }
-//# sourceMappingURL=use-store-cell.js.map

package/dist/components/use-thread-dispatches.d.ts

@@ -1,33 +1,8 @@
 import { type ThreadDispatch } from "../contract/dispatches.js";
 import type { TranscriptRow } from "../core/transcript-rows.js";
 import type { TokenSession } from "../transport/token-session.js";
-/**
- * The thread's dispatch rows keyed by ordinal — the ask's identity (a
- * resume chain shares one child_session_id) — shared across every surface
- * of one session. Reads once when a delegation appears, polls while any
- * join-keyed coworker is unsettled, and stops when the family settled, the
- * last surface unmounts, or nothing could be corrected. Transient failures
- * keep the last good map; a persistent one trips the cap (fail closed)
- * until a demand change re-arms. Thread-keyed: a switch reads as the empty
- * map until the new thread's first read lands. onDispatchSettled fires
- * once per read observing a settle on the demanded thread; pass a stable
- * identity — same-valued listeners collapse to one.
- */
 export declare function useThreadDispatches(session: TokenSession, threadId: string | null, rows: readonly TranscriptRow[], onDispatchSettled?: () => void, onDispatchPaused?: () => void): ReadonlyMap<number, ThreadDispatch>;
-/**
- * One coworker's ledger row, live, for the drill-in panel: the same
- * shared cell and demand-driven poll, but the demand is the panel's own —
- * a member can drill into a running child whose wire receipt never
- * streamed, and the transcript's rows-derived demand would not keep the
- * poll alive for it. refreshLedger is the settle tap: the panel's stream
- * watching its own ending must not wait a poll tick for the row to agree.
- */
 export declare function useChildDispatch(session: TokenSession, threadId: string | null, childSessionId: string): {
     dispatch: ThreadDispatch | undefined;
-    /** The settle tap. Resolves with the child's newest row AS THE
-     *  CATCH-UP LANDED IT — the row a stream-end verdict judges against —
-     *  or, when the read's bound fired, the last good snapshot; never
-     *  rejects, so the judge always lands. */
     refreshLedger: () => Promise<ThreadDispatch | undefined>;
 };
-//# sourceMappingURL=use-thread-dispatches.d.ts.map