@estiva-app/ui 0.8.0 → 0.10.0

package/dist/Menu.d.ts

@@ -1,79 +1,14 @@
-import { type ComponentPropsWithRef, type ReactNode } from 'react';
-/**
- * THE menu shell (2026-09-01) — extracted once, for every menu in every app.
- *
- * Peek has no single Menu file; its topic menu, conversation menus, files
- * menu and the top bar's account menu each hand-roll the same thing, and
- * they disagree: some close on Escape, most do not, and row heights and
- * minimum widths drift copy by copy. Ship extracted the shape so it would
- * not become the next copy; the package exists so nobody becomes the one
- * after that.
- *
- * What every menu shares, kept exactly: an elevated container with a
- * hairline border, 8px radius, 8px padding and the large shadow; items that
- * are 8px-radius rows, `px-2 py-1.5`, hover fill, 14px text, destructive
- * ones in the error colour; section headings as a SectionLabel in a 32px
- * row; and the two exits every menu has — Escape and a click outside —
- * owned by the menu, never copied into a caller.
- *
- * Where it goes is owned here too (2026-09-03), because the two ways a menu
- * goes wrong are both placement: it opens inside a stacking context or a
- * scroll container and something covers or clips it, or it opens near an
- * edge and runs off the screen. Both shipped — the identity menu vanished
- * under a z-indexed panel header, a submenu was cut by the right edge — so
- * the shell now portals to the body (nothing in an app can cover the body's
- * last child at z-50) and fits itself to the viewport (fit.ts, the same
- * measured geometry Select uses). A caller hands over a trigger, not
- * coordinates.
- *
- * Three anchorings, in order of preference:
- * - `anchor` (an element, usually the trigger): portalled, measured, and
- *   placed by `fitMenu` — under the anchor, flipped above when the room
- *   below is worse, clamped inside the viewport, height-capped with its own
- *   scrollbar. `align="right"` hangs the menu's right edge from the
- *   anchor's. Closes on resize and on any page scroll, because both move
- *   the anchor out from under it.
- * - `position` (viewport coordinates the caller computed): portalled and
- *   clamped (`clampBox`) — the caller's corner survives, but can no longer
- *   land off screen.
- * - neither: in-flow under a `relative` wrapper, right-aligned. For stories
- *   and static surfaces only — inside an app this mode inherits every
- *   ancestor's stacking context and clip, which is how the identity menu
- *   got covered.
- */
-export interface MenuProps {
-    onClose: () => void;
-    /** The trigger — an element, or the rect a click handler already measured.
-     *  The menu portals to the body and places itself against it. */
-    anchor?: HTMLElement | DOMRect | null;
-    /** With `anchor`: which of the menu's edges hangs from the anchor's. Default left. */
-    align?: 'left' | 'right';
-    /** Viewport coordinates; the menu is portalled, hung from `top`, aligned to whichever edge is given, and clamped on screen. */
-    position?: {
-        top: number;
-        right: number;
-    } | {
-        top: number;
-        left: number;
-    };
-    /** Close 150ms after the pointer leaves the menu — the hover-flow menus
-     *  (quick-menu cards) dismiss this way. The grace period is shared with any
-     *  open MenuSub panel, so crossing into a portalled submenu never counts as
-     *  leaving. */
-    closeOnLeave?: boolean;
-    children: ReactNode;
-    className?: string;
-}
+import { type ComponentPropsWithRef, type ReactElement, type ReactNode, type RefObject } from 'react';
 /**
  * The menu's surface, with none of its behaviour — an elevated box with a
  * hairline border, 8px radius, 8px padding and the large shadow.
  *
- * Split out of `Menu` on 2026-09-05. `Menu` owns Escape, outside-click and
- * placement, and that is right for a menu opened from a trigger — but a
- * type-ahead popup inside a text editor cannot have them: the editor's
- * suggestion plugin already owns the keyboard and positions the popup, and a
- * second Escape handler fights it. So Peek's `@`, `/` and `[` menus each drew
- * this box by hand, and the three had already drifted apart.
+ * Split out of `Menu` on 2026-09-05. `Menu` owns Escape, outside-click,
+ * placement and now the keyboard, and that is right for a menu opened from a
+ * trigger — but a type-ahead popup inside a text editor cannot have them: the
+ * editor's suggestion plugin already owns the keyboard and positions the
+ * popup, and a second Escape handler fights it. So Peek's `@`, `/` and `[`
+ * menus each drew this box by hand, and the three had already drifted apart.
  *
  * `Menu` renders this, so there is still exactly one definition of the
  * surface — change it here and every menu in every app follows.
@@ -82,20 +17,60 @@ export interface MenuProps {
  * people is not the width of one that lists verbs.
  */
 export interface MenuPanelProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
-    children: ReactNode;
+    /** Optional only because Base UI fills it in when this is a `render`
+     *  target: `Menu.Popup` supplies the children. Every other caller passes
+     *  them. */
+    children?: ReactNode;
 }
 export declare function MenuPanel({ children, className, ...props }: MenuPanelProps): import("react").JSX.Element;
-export declare function Menu({ onClose, anchor, align, position, closeOnLeave, children, className }: MenuProps): import("react").JSX.Element;
+export interface MenuProps {
+    /**
+     * The control that opens the menu. Any element that forwards its ref and
+     * spreads its props — this package's `Button`, `IconButton` and
+     * `PersonTrigger` all do.
+     *
+     * The menu owns it, and that is the point: Base UI can only do the toggle,
+     * the placement, the focus return, the first-item highlight and the whole
+     * hover choreography if it knows which element opened it.
+     */
+    trigger: ReactElement;
+    /** Which of the menu's edges hangs from the trigger's. Default left. */
+    align?: 'left' | 'right';
+    /**
+     * Open on hover, and close shortly after the pointer leaves — for a control
+     * that only appears while the pointer is on a card.
+     *
+     * Base UI owns the whole choreography, including the diagonal from a row
+     * out to a submenu panel. The shell used to hand-write this and got it
+     * wrong in two directions.
+     */
+    openOnHover?: boolean;
+    /** Controlled, for a caller that must know or must force it. Leave both
+     *  off and the menu keeps its own state. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Base UI's imperative handle. `actions.current?.close()` shuts the menu —
+     *  for a row that must close it before opening what it opens. A `MenuItem`
+     *  closes the menu by itself, so this is only for content that is not one. */
+    actionsRef?: RefObject<{
+        close: () => void;
+        unmount: () => void;
+    } | null>;
+    children: ReactNode;
+    /** On the menu's surface — its width, its internal rhythm. */
+    className?: string;
+}
+export declare function Menu({ trigger, align, openOnHover, open, onOpenChange, actionsRef, children, className }: MenuProps): import("react").JSX.Element;
 /**
  * A row that opens another menu beside it — the submenu two Peek menus
  * hand-rolled before this, one of which dropped the ref its edge-flip
  * measured and shipped a submenu cut off by the screen (2026-09-03).
  *
- * Hover-timed like those were: opens at once, closes 150ms after the
- * pointer leaves row and panel both, so the diagonal from row to panel
- * survives. The panel portals to the body and is placed by `fitSubmenu` —
- * right of the row when it fits, left when it does not, never past an edge
- * — so it also escapes whatever container its menu happens to be in.
+ * Hover-timed as those were, and as ours was: it opens at once and closes
+ * 150ms after the pointer leaves, so the diagonal from row to panel survives.
+ * Those two numbers are all that is left of the old implementation — the
+ * placement, the flip at a screen edge, and now the arrow keys (→ opens it,
+ * ← closes it) are Base UI's.
  */
 export interface MenuSubProps {
     /** The trigger row's label. */
@@ -170,9 +145,17 @@ export declare function MenuItem({ label, children, size, description, leading,
 export declare function EnterHint({ target }: {
     target?: string;
 }): import("react").JSX.Element;
-/** A section heading inside a menu: the 32px row with a SectionLabel, read
- *  secondary — a heading inside a menu labels the rows, it is not one of
- *  them (Katerina, 2026-09-01). */
+/**
+ * A section heading inside a menu: the 32px row with a SectionLabel, read
+ * secondary — a heading inside a menu labels the rows, it is not one of
+ * them (Katerina, 2026-09-01).
+ *
+ * Inside a `Menu` it is Base UI's `Menu.Group` with the heading as its
+ * `GroupLabel`, so the rows under it are announced as a named group rather
+ * than as a run of items with a stray line above them. Outside one — the
+ * editor pickers, which draw the surface but not the menu — it is the two
+ * plain elements it has always been.
+ */
 export declare function MenuSection({ label, children, className }: {
     label: string;
     children: ReactNode; /** On the heading row — a surface whose rows are px-3 aligns its heading with px-3. */

package/dist/Menu.d.ts.map

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

package/dist/PersonTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersonTrigger.d.ts","sourceRoot":"","sources":["../src/PersonTrigger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAA;AAKlD,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AAEnD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBACf,SAAQ,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,EACpC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACnD,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,+FAA+F;IAC/F,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAY,EAAE,OAAe,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,+BA8BtI"}
+{"version":3,"file":"PersonTrigger.d.ts","sourceRoot":"","sources":["../src/PersonTrigger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAA;AAKlD,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AAEnD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBACf,SAAQ,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,EACpC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACnD,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,+FAA+F;IAC/F,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAY,EAAE,OAAe,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,+BAoDtI"}

package/dist/Popover.d.ts

@@ -0,0 +1,86 @@
+import { type ReactElement, type ReactNode, type RefObject } from 'react';
+/**
+ * A floating panel from a trigger — the same elevated surface a `Menu` uses,
+ * with none of a menu's semantics. New at stage 4 (2026-09-07).
+ *
+ * **It exists because `Menu` was being used for this.** Peek's selection
+ * toolbar puts a text field inside one, and its debug panel fills one with
+ * toggle rows; neither is a list of actions, and since the menus moved onto
+ * Base UI a `Menu` gives its contents roving focus and typeahead, which is
+ * wrong for both and fights a text field outright. Beyond those two, Peek
+ * hand-writes overlay behaviour in thirteen files — six `createPortal`, five
+ * outside-click listeners, seven position calculations against
+ * `window.innerWidth` (`COMPONENTS-PEEK.md` F5). This is what they become.
+ *
+ * **The API is `Menu`'s**: it takes the `trigger` and owns everything after —
+ * the toggle, the placement, the dismissal and the focus return. What differs
+ * is inside: a `Popover` announces itself as a dialog, its contents are
+ * ordinary content, and Tab walks them in order.
+ *
+ * The one thing a `Menu` has no use for is the second mode below: a panel with
+ * no trigger element at all, hung from a rect the caller measured — a toolbar
+ * over a text selection. That mode is controlled, because there is nothing for
+ * Base UI to watch.
+ */
+export interface PopoverProps {
+    /**
+     * The control that opens the panel. Any element that forwards its ref and
+     * spreads its props — this package's `Button`, `IconButton` and
+     * `PersonTrigger` all do.
+     *
+     * Base UI can only do the toggle, the placement, the dismissal and the focus
+     * return if it knows which element opened the panel. Give it the trigger
+     * unless there is genuinely no element to give — see `anchor`.
+     */
+    trigger?: ReactElement;
+    /**
+     * For a panel with **no trigger element**: an element, or a rect the caller
+     * measured — a text selection's. Pair it with `open`, since there is nothing
+     * for Base UI to watch.
+     *
+     * An anchored panel **does not take focus**, because the person is still in
+     * whatever produced it. That also means it cannot be reached by keyboard, so
+     * everything in one must be reachable another way.
+     *
+     * Render it always and toggle `open`; do not mount it only while it is open.
+     */
+    anchor?: HTMLElement | DOMRect | null;
+    /** Which of the panel's edges hangs from the trigger's. Default left. */
+    align?: 'left' | 'right';
+    /**
+     * Which side of the trigger, or of the anchor, the panel prefers. Default
+     * `bottom`.
+     *
+     * **A toolbar over a text selection wants `top`** (Katerina, 2026-09-08):
+     * below, it covers the line you are about to read next, and it is the line
+     * *after* the selection that tells you what you have selected. It is a
+     * preference, not a promise — Base UI flips it when that side has no room.
+     */
+    side?: 'top' | 'bottom';
+    /** Controlled, for a caller that must know or must force it. Required with
+     *  `anchor`; with a `trigger`, leave both off and the panel keeps its own. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Where focus goes when the panel closes. With a `trigger` it goes back to
+     * the trigger and this is not needed. An anchored panel never took focus, so
+     * this only matters when something inside it did — a field the person tabbed
+     * or clicked into: point it at what they came from, or focus is left on the
+     * document body.
+     */
+    finalFocus?: RefObject<HTMLElement | null>;
+    /** Base UI's imperative handle. `actions.current?.close()` shuts the panel —
+     *  for the Cancel and Save buttons a form panel ends with. */
+    actionsRef?: RefObject<{
+        close: () => void;
+        unmount: () => void;
+    } | null>;
+    /** Names the panel for assistive tech. A panel with a visible heading can
+     *  point at it instead, with `aria-labelledby`. */
+    ariaLabel?: string;
+    children: ReactNode;
+    /** On the panel's surface — its width, its internal rhythm. */
+    className?: string;
+}
+export declare function Popover({ trigger, anchor, align, side, open, onOpenChange, finalFocus, actionsRef, ariaLabel, children, className }: PopoverProps): import("react").JSX.Element;
+//# sourceMappingURL=Popover.d.ts.map

package/dist/Popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../src/Popover.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAKlF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,IAAI,CAAA;IACrC,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACvB;kFAC8E;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC1C;kEAC8D;IAC9D,UAAU,CAAC,EAAE,SAAS,CAAC;QAAE,KAAK,EAAE,MAAM,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACzE;uDACmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAOD,wBAAgB,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAc,EAAE,IAAe,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,YAAY,+BA6DrK"}

package/dist/PreviewCard.d.ts

@@ -0,0 +1,39 @@
+import type { ReactNode } from 'react';
+/**
+ * More of a thing, on hover — a card beside a row that is only a snippet.
+ * New at stage 4 (2026-09-07).
+ *
+ * **It exists because Peek's Screener preview is this, hand-written**: its own
+ * `createPortal`, its own "prefer the right, flip left if it would run off
+ * screen" arithmetic against `window.innerWidth`, and its own clamp against
+ * the bottom edge (`ScreenerPreviewCard.tsx`). Floating UI does all three.
+ *
+ * **Not a Tooltip.** A tooltip is a word for a control, is
+ * `pointer-events: none`, and may hold nothing you can reach. A preview card
+ * holds *content* — faces, text, a link — and you can move the pointer into
+ * it, which is what a preview is for. If what you have is a label, use
+ * `WithTooltip`.
+ *
+ * The surface is the package's elevated panel, the same one a `Menu` draws, so
+ * there is one definition of that box. Width, height and internal rhythm are
+ * the caller's: a preview of a conversation is not the size of a preview of a
+ * person.
+ */
+export interface PreviewCardProps {
+    /** What the card holds. Rendered only while it is open. */
+    content: ReactNode;
+    /** The row, name or avatar the card previews. */
+    children: ReactNode;
+    /** Which side of the trigger to prefer. It flips when that side has no room. Default right. */
+    side?: 'top' | 'bottom' | 'left' | 'right';
+    /** Before it opens, in ms. Long enough that crossing a list does not flash a card at every row. */
+    delay?: number;
+    /** After the pointer leaves, in ms — the grace that lets you cross the gap into the card. */
+    closeDelay?: number;
+    /** On the card's surface: its width, its padding, a max height. */
+    className?: string;
+    /** Extra classes on the trigger wrapper — e.g. `block w-full` for a row. */
+    wrapperClassName?: string;
+}
+export declare function PreviewCard({ content, children, side, delay, closeDelay, className, wrapperClassName }: PreviewCardProps): import("react").JSX.Element;
+//# sourceMappingURL=PreviewCard.d.ts.map

package/dist/PreviewCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewCard.d.ts","sourceRoot":"","sources":["../src/PreviewCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,OAAO,EAAE,SAAS,CAAA;IAClB,iDAAiD;IACjD,QAAQ,EAAE,SAAS,CAAA;IACnB,+FAA+F;IAC/F,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAmBD,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAc,EAAE,KAAkB,EAAE,UAAwB,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,gBAAgB,+BA+B7J"}

package/dist/Reaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Reaction.d.ts","sourceRoot":"","sources":["../src/Reaction.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC9F,0EAA0E;IAC1E,KAAK,EAAE,SAAS,CAAA;IAChB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAe,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BA8BnG"}
+{"version":3,"file":"Reaction.d.ts","sourceRoot":"","sources":["../src/Reaction.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC9F,0EAA0E;IAC1E,KAAK,EAAE,SAAS,CAAA;IAChB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAe,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BAgCnG"}

package/dist/ReactionPicker.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The reactions on offer, to choose one from — Peek's `ReactionPicker`
+ * (2026-09-03), moved in at Katerina's request (2026-09-08).
+ *
+ * **`Reaction` is the answer; this is the question.** A `Reaction` is a pill
+ * that says an emoji, a count and whether it is yours. This is the row you
+ * pick from before any of that exists, and both apps need it: Peek draws one
+ * from a card's action strip (`ConversationQuickMenu`), and Ship draws the
+ * same row in `Reactions.tsx` from its own vocabulary.
+ *
+ * **It is a `Toolbar`** — icon buttons holding emoji, on the strip's own
+ * elevated box — so the whole row is one Tab stop and the arrow keys walk it.
+ * Peek's was five separate stops.
+ *
+ * ## What stays with the app
+ *
+ * **Which emoji, and what each one means.** Peek offers five and names them
+ * ("Makes sense", "Agree", "Thank you", "Let's go!", "Congrats"); Ship will
+ * offer its own. A vocabulary is product knowledge, so it arrives as
+ * `options` — and the name is not optional, because the emoji is decorative
+ * here for the same reason it is on `Reaction`: a glyph read aloud is noise,
+ * and its spoken name differs per screen reader.
+ *
+ * ## Picking, and nothing else
+ *
+ * **It does not show which reactions are yours.** That is `Reaction`'s job —
+ * the pill with the count and the accent fill — and the two live in different
+ * places: the reactions *made* sit in a row on the card, and this row is what
+ * opens over it when you go to add one. A picker that also reported state
+ * would be two components wearing one name (Katerina, 2026-09-08).
+ */
+export interface ReactionOption {
+    /** The emoji itself. Drawn decoratively — `label` names the control. */
+    emoji: string;
+    /** What this reaction *means*: "Makes sense", "Congrats". Required, and it
+     *  is what a screen reader and the tooltip both say. */
+    label: string;
+}
+export interface ReactionPickerProps {
+    /** What is on offer, in the order it is drawn. The app's vocabulary. */
+    options: ReactionOption[];
+    onSelect: (emoji: string) => void;
+    /** Names the row. Default "Reactions". */
+    'aria-label'?: string;
+    /**
+     * The elevated box around the row, from `Toolbar`. **On by default**, which
+     * is how a picker floats over a card. Off inside a `Popover`, which draws
+     * that box already.
+     */
+    surface?: boolean;
+    /** The row's layout — its gap, its padding. */
+    className?: string;
+}
+export declare function ReactionPicker({ options, onSelect, 'aria-label': ariaLabel, surface, className }: ReactionPickerProps): import("react").JSX.Element;
+//# sourceMappingURL=ReactionPicker.d.ts.map

package/dist/ReactionPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactionPicker.d.ts","sourceRoot":"","sources":["../src/ReactionPicker.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAA;IACb;4DACwD;IACxD,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAuB,EAAE,OAAc,EAAE,SAAS,EAAE,EAAE,mBAAmB,+BA6B1I"}

package/dist/SearchInput.d.ts

@@ -11,6 +11,11 @@ import { type InputHTMLAttributes } from 'react';
  * In Peek's top bar this is a launcher affordance rather than a live field:
  * the input is `pointer-events-none` and clicking the surround opens the
  * command launcher. The component is the same either way.
+ *
+ * On Base UI's `Input` since stage 3 of the migration (2026-09-07), so a
+ * search field inside a `Field` is labelled by it without the caller wiring
+ * an id. The surround stays ours: the border, the focus-within rule and the
+ * `Kbd` hint are this component's, not the input's.
  */
 export interface SearchInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'className'> {
     /** A keyboard hint drawn at the right edge, e.g. "Ctrl+K". */

package/dist/SearchInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchInput.d.ts","sourceRoot":"","sources":["../src/SearchInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAIhD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAChG,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAuB,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,+BAkBvG"}
+{"version":3,"file":"SearchInput.d.ts","sourceRoot":"","sources":["../src/SearchInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAKhD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAChG,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAuB,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,+BAkBvG"}

package/dist/Select.d.ts

@@ -1,20 +1,30 @@
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 /**
  * Peek's Select (2026-08-28), verbatim, plus what Ship added: an option may
  * carry a `leading` node — an avatar beside a person's name — shown in the
- * trigger and in the list.
+ * trigger and in the list. On Base UI's `Select` since stage 4 of the
+ * migration (2026-09-07).
  *
- * A button that opens a portalled listbox under itself: arrows move (and keep
- * the active option scrolled into view), Home and End jump, Enter and Space
- * pick, Escape closes and returns focus to the trigger, Tab closes, a click
- * outside closes, a PAGE scroll or resize closes (the list is fixed to where
- * the trigger was) — a scroll *inside* the list is the list's own business
- * and must not dismiss it. The menu keeps itself on screen: clamped to the
- * viewport's sides, height capped to the space it actually has, opening
- * upward when the room below is worse than the room above (Katerina,
- * 2026-09-01 — the files-panel picker was cut right and bottom, and its own
- * scroll closed it). Two sizes; `disabled` explains nothing by itself — wrap
- * it in a tooltip that does.
+ * A button that shows the choice and opens a listbox under it. **Under it:
+ * Base UI would rather lay the list over the trigger so the chosen option's
+ * text covers the trigger's, the way macOS does — `alignItemWithTrigger` is
+ * off, because every Select in both apps opens below one today (Katerina,
+ * D24).**
+ *
+ * What the port deleted: `createPortal`, the whole `onKeyDown` switch, the
+ * outside-click, resize and scroll listeners, the `aria-activedescendant`
+ * bookkeeping, the `scrollIntoView` that kept the highlight visible, and
+ * `fit.ts` — the pure geometry this component grew and then shared with the
+ * Menu shell. Floating UI does the fitting; `--available-height` is where the
+ * old 288px cap now meets the room the screen actually has.
+ *
+ * What it gained, and none of it was written here: **typeahead** — type the
+ * first letters of an option and the list jumps to it — a listbox whose
+ * highlight is managed rather than counted, and a value that can be part of a
+ * form.
+ *
+ * Two sizes; `disabled` explains nothing by itself — wrap it in a tooltip
+ * that does.
  */
 export interface SelectOption {
     value: string;
@@ -28,11 +38,11 @@ export interface SelectProps {
     options: SelectOption[];
     size?: 'default' | 'small';
     ariaLabel?: string;
+    /** Set by a `Field` with `required`; a caller inside one owes nothing. */
+    'aria-required'?: boolean | 'true' | 'false';
     placeholder?: string;
     disabled?: boolean;
     className?: string;
 }
-import { fitMenu } from './fit';
-export { fitMenu };
-export declare function Select({ value, onChange, options, size, ariaLabel, placeholder, disabled, className }: SelectProps): import("react").JSX.Element;
+export declare function Select({ value, onChange, options, size, ariaLabel, placeholder, disabled, className, ...aria }: SelectProps): import("react").JSX.Element;
 //# sourceMappingURL=Select.d.ts.map

package/dist/Select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../src/Select.tsx"],"names":[],"mappings":"AACA,OAAO,EAAiG,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIrI;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,OAAO,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAKD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,OAAO,EAAE,CAAA;AAElB,wBAAgB,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAgB,EAAE,SAAS,EAAE,WAAuB,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,WAAW,+BAwO1I"}
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../src/Select.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,OAAO,CAAC,EAAE,SAAS,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAOD,wBAAgB,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAgB,EAAE,SAAS,EAAE,WAAuB,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,WAAW,+BAgGnJ"}

package/dist/Tabs.d.ts

@@ -30,8 +30,18 @@ export interface TabsProps<T extends string> {
     onChange: (id: T) => void;
     /** `default` 14px; `small` 12px, the denser geometry. */
     size?: 'default' | 'small';
+    /**
+     * Names the row for assistive tech — "Views", "Filters".
+     *
+     * A `tablist` with no name is announced as a bare "tab list", which says
+     * nothing and says the same nothing twice on a page with two of them
+     * (measured 2026-09-08: no name, and no way to give one). Where a visible
+     * heading already names it, point at that with `aria-labelledby` instead.
+     */
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
     /** Lands on the outer box, around the row. */
     className?: string;
 }
-export declare function Tabs<T extends string>({ tabs, active, onChange, size, className }: TabsProps<T>): import("react").JSX.Element;
+export declare function Tabs<T extends string>({ tabs, active, onChange, size, className, ...aria }: TabsProps<T>): import("react").JSX.Element;
 //# sourceMappingURL=Tabs.d.ts.map

package/dist/Tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../src/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,MAAM;IACtC,EAAE,EAAE,CAAC,CAAA;IACL,KAAK,EAAE,MAAM,CAAA;IACb,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM;IACzC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IACjB,MAAM,EAAE,CAAC,CAAA;IACT,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAA;IACzB,yDAAyD;IACzD,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAC1B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAgB,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,+BA2C3G"}
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../src/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,MAAM;IACtC,EAAE,EAAE,CAAC,CAAA;IACL,KAAK,EAAE,MAAM,CAAA;IACb,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM;IACzC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IACjB,MAAM,EAAE,CAAC,CAAA;IACT,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAA;IACzB,yDAAyD;IACzD,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IAC1B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAgB,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,+BAgDpH"}

package/dist/TextInput.d.ts

@@ -4,7 +4,13 @@ import { type InputHTMLAttributes } from 'react';
  * text, the focus border in every theme (Katerina, 2026-08-28: Ship's inputs
  * focus like Signal's) — and Signal's glow on top.
  * Plus a disabled look (Ship's addition): the disabled surface and text,
- * no pointer.
+ * no pointer. On Base UI's `Input` since stage 3 of the migration
+ * (2026-09-07).
+ *
+ * Base UI's `Input` is a native `<input>` that finds a surrounding `Field` on
+ * its own, so the id plumbing this used to do — `useFieldControlId`, and the
+ * context behind it — is gone. Outside a `Field` it behaves as before: the
+ * field context has a default, so nothing has to be wrapped.
  */
 export type TextInputProps = InputHTMLAttributes<HTMLInputElement>;
 export declare const TextInput: import("react").ForwardRefExoticComponent<TextInputProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/TextInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../src/TextInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAI5D;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAA;AAElE,eAAO,MAAM,SAAS,6GAmBpB,CAAA"}
+{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../src/TextInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAI5D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAA;AAElE,eAAO,MAAM,SAAS,6GAgBpB,CAAA"}

package/dist/Textarea.d.ts

@@ -1,7 +1,14 @@
 import { type TextareaHTMLAttributes } from 'react';
 /**
  * Peek's Textarea (2026-08-28), verbatim: TextInput's look on a textarea
- * that does not resize. Plus a disabled look (Ship's addition).
+ * that does not resize. Plus a disabled look (Ship's addition). On Base UI's
+ * `Field.Control` since stage 3 of the migration (2026-09-07).
+ *
+ * Base UI has an `Input` part but no textarea, so this is `Field.Control`
+ * rendering a `<textarea>` — the same part `Input` is built on, told which
+ * element to be. It finds a surrounding `Field` on its own, which is what
+ * retired `useFieldControlId`; outside one it renders a plain textarea, as
+ * before.
  */
 export type TextareaProps = TextareaHTMLAttributes<HTMLTextAreaElement>;
 export declare const Textarea: import("react").ForwardRefExoticComponent<TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;

package/dist/Textarea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../src/Textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,sBAAsB,EAAE,MAAM,OAAO,CAAA;AAI/D;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,sBAAsB,CAAC,mBAAmB,CAAC,CAAA;AAEvE,eAAO,MAAM,QAAQ,+GAkBnB,CAAA"}
+{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../src/Textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,sBAAsB,EAAE,MAAM,OAAO,CAAA;AAI/D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,sBAAsB,CAAC,mBAAmB,CAAC,CAAA;AAEvE,eAAO,MAAM,QAAQ,+GAgBnB,CAAA"}