@estiva-app/ui 0.44.1 → 0.46.0

package/dist/CollapsibleSection.d.ts

@@ -33,6 +33,12 @@ export interface CollapsibleSectionProps {
     /** Beside the title, revealed on hover or focus — `SectionHeader`'s. */
     actions?: SectionAction[];
     showActions?: 'hover' | 'always';
+    /**
+     * `heading` (default): the title is a section heading. `row`: the fold is a
+     * row among rows — a folder in a sidebar — and its rows sit indented under
+     * its title, past the chevron (`SectionHeader`'s `look`).
+     */
+    look?: 'heading' | 'row';
     /** The rows. */
     children: ReactNode;
     /** On the section's box: `mt-2` between groups, `shrink-0` in a scrolling column. */
@@ -40,5 +46,5 @@ export interface CollapsibleSectionProps {
     /** On the box the rows sit in: the gap between them. */
     contentClassName?: string;
 }
-export declare function CollapsibleSection({ title, defaultOpen, open: openProp, onOpenChange, storageKey, trailing, actions, showActions, children, className, contentClassName }: CollapsibleSectionProps): import("react").JSX.Element;
+export declare function CollapsibleSection({ title, defaultOpen, open: openProp, onOpenChange, storageKey, trailing, actions, showActions, look, children, className, contentClassName }: CollapsibleSectionProps): import("react").JSX.Element;
 //# sourceMappingURL=CollapsibleSection.d.ts.map

package/dist/CollapsibleSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CollapsibleSection.d.ts","sourceRoot":"","sources":["../src/CollapsibleSection.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGhD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,wEAAwE;IACxE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAChC,gBAAgB;IAChB,QAAQ,EAAE,SAAS,CAAA;IACnB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAwBD,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,WAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,uBAAuB,+BAyBzM"}
+{"version":3,"file":"CollapsibleSection.d.ts","sourceRoot":"","sources":["../src/CollapsibleSection.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGhD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,wEAAwE;IACxE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAA;IACxB,gBAAgB;IAChB,QAAQ,EAAE,SAAS,CAAA;IACnB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAwBD,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,WAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,IAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,uBAAuB,+BA0B3N"}

package/dist/InlineChip.d.ts

@@ -28,7 +28,7 @@ export declare const INLINE_CHIP_TONE_CLASSES: {
     /** A thing or a place — anything that is not a person. */
     readonly neutral: "bg-bg-active text-text-primary";
     /** A person. */
-    readonly person: "bg-accent-muted text-accent-primary";
+    readonly person: "bg-accent-muted text-accent-text";
     /** A person, called urgently. */
     readonly urgent: "bg-warning-muted text-warning-default";
     /**

package/dist/NavItem.d.ts

@@ -9,6 +9,12 @@ import type { ComponentPropsWithoutRef, ReactNode } from 'react';
  * count draws its zero (see Tabs) — both rulings stand, deliberately.
  *
  * Active is the same fill as a selected tab — `bg-active`, neutral.
+ *
+ * `menu` gives the row a "More options" menu (UIG-44, Katerina, 30
+ * September): a ⋮ that shows while the row is pointed at, focused or its
+ * menu is open, in the count's place — the count steps aside rather than
+ * sitting under it. The ⋮ is beside the link, not inside it (a button inside
+ * an anchor is not a button), and follows it in the Tab order.
  */
 export interface NavItemProps extends Omit<ComponentPropsWithoutRef<'a'>, 'href'> {
     label: string;
@@ -20,7 +26,11 @@ export interface NavItemProps extends Omit<ComponentPropsWithoutRef<'a'>, 'href'
     active?: boolean;
     /** 16px, stroke 1.5. */
     icon?: ReactNode;
+    /** The row's "More options" menu: `MenuItem`s. Absent, the row has no menu and is exactly the plain row. */
+    menu?: ReactNode;
+    /** The ⋮'s accessible name and tooltip. Default "More options for {label}". */
+    menuLabel?: string;
     className?: string;
 }
-export declare function NavItem({ label, href, count, countLabel, active, icon, className, ...props }: NavItemProps): import("react").JSX.Element;
+export declare function NavItem({ label, href, count, countLabel, active, icon, menu, menuLabel, className, ...props }: NavItemProps): import("react").JSX.Element;
 //# sourceMappingURL=NavItem.d.ts.map

package/dist/NavItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavItem.d.ts","sourceRoot":"","sources":["../src/NavItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAIhE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAC/E,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wBAAwB;IACxB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,MAAc,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,+BA6BlH"}
+{"version":3,"file":"NavItem.d.ts","sourceRoot":"","sources":["../src/NavItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQhE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAC/E,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,wBAAwB;IACxB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,4GAA4G;IAC5G,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,MAAc,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,+BAiEnI"}

package/dist/SectionHeader.d.ts

@@ -59,6 +59,14 @@ export interface SectionHeaderProps {
      * where the buttons light up on their own (UIG-14, Katerina, 19 September).
      */
     hover?: 'fill' | 'none';
+    /**
+     * `heading` (default): a section's title, the `SectionLabel`. `quiet`: a
+     * small grey label over a list (12px, muted) — "Folders" over the folders,
+     * which never reads as one of them. `row`: a row among rows — the chevron
+     * and the title at a row's weight and colour, as a sidebar row is (Katerina,
+     * 30 September: Leaf's folders, in Ship).
+     */
+    look?: 'heading' | 'quiet' | 'row';
     /**
      * What the title renders as, in Base UI's manner. A plain button with
      * `onToggle` by default; `CollapsibleSection` hands in `Collapsible.Trigger`.
@@ -66,5 +74,5 @@ export interface SectionHeaderProps {
     render?: useRender.RenderProp;
     className?: string;
 }
-export declare function SectionHeader({ title, chevron, isExpanded, onToggle, trailing, actions, showActions, hover, render, className }: SectionHeaderProps): import("react").JSX.Element;
+export declare function SectionHeader({ title, chevron, isExpanded, onToggle, trailing, actions, showActions, hover, look, render, className }: SectionHeaderProps): import("react").JSX.Element;
 //# sourceMappingURL=SectionHeader.d.ts.map

package/dist/SectionHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionHeader.d.ts","sourceRoot":"","sources":["../src/SectionHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,yCAAyC;IACzC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC,UAAU,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,OAAe,EAAE,UAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAqB,EAAE,KAAc,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,kBAAkB,+BA2DrL"}
+{"version":3,"file":"SectionHeader.d.ts","sourceRoot":"","sources":["../src/SectionHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAMrD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,yCAAyC;IACzC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,KAAK,CAAA;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC,UAAU,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,OAAe,EAAE,UAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAqB,EAAE,KAAc,EAAE,IAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,kBAAkB,+BAuEvM"}

package/dist/SelectionToolbar.d.ts

@@ -0,0 +1,62 @@
+import type { Editor } from '@tiptap/react';
+import { Extension } from '@tiptap/core';
+import { PluginKey } from '@tiptap/pm/state';
+/**
+ * The selection, kept visible while something else has the focus — Peek's
+ * `src/extensions/keptSelection.ts` (PEE-19), moved into the package with the
+ * `SelectionToolbar` that needs it (UIG-31, Katerina's ruling 29 September).
+ *
+ * The toolbar's address field takes the focus, and with it the document's
+ * one selection, so the words being linked lost their highlight the moment
+ * the field opened (measured 2026-09-07). Linear keeps it, and Katerina asked
+ * for the same. The editor's own selection never moved — ProseMirror keeps it
+ * while unfocused — so this only *draws* it: an inline decoration over the
+ * range, in `bg-selected` — the token Peek's composer paints `::selection` in,
+ * mapped through edits and cleared when the field closes.
+ *
+ * A decoration rather than a second selection, because a document has one
+ * and the field needs it. Editor-internal by design (the editor owns its own
+ * drawing); nothing here floats, focuses or handles a key.
+ */
+export interface KeptRange {
+    from: number;
+    to: number;
+}
+/** The plugin's key: read what is being kept, or dispatch a change to it. */
+export declare const keptSelectionKey: PluginKey<KeptRange | null>;
+/** The extension an editor registers so a selection can stay drawn while a field has the focus. */
+export declare const KeptSelection: Extension<any, any>;
+/** Draw the selection as it is now, until `releaseSelection`. */
+export declare function keepSelection(editor: Editor): void;
+/** Stop drawing it. Nothing kept, nothing dispatched. */
+export declare function releaseSelection(editor: Editor): void;
+/** What is being drawn, or null. */
+export declare function keptSelection(editor: Editor): KeptRange | null;
+/** A mark the strip can toggle — the suite's inline vocabulary (SPEC §13.1) less link and reference. */
+export type MarkId = 'bold' | 'italic' | 'underline' | 'code';
+/** The address the selection sits in, or '' — what the link field opens with. */
+export declare function currentLink(editor: Editor): string;
+/**
+ * What somebody typed into the link field → an `href`, or null when it cannot
+ * be one. A bare host (`google.com`) gets `https://`. A scheme is kept only when
+ * SPEC §13.1 lets a reader follow it (http, https, mailto); `javascript:` and
+ * the like are refused here. `localhost:5173` is a host and a port: a scheme is
+ * never followed by a digit.
+ */
+export declare function normalizeHref(raw: string): string | null;
+/**
+ * Apply the link field to the selection. Empty removes the link; an address
+ * sets it, over the whole link when the caret sits inside one. `false` means
+ * the text could not be an address, and the field should stay open.
+ */
+export declare function applyLink(editor: Editor, raw: string): boolean;
+export interface SelectionToolbarProps {
+    /** The editor whose selection the strip follows. `null` while it loads. */
+    editor: Editor | null;
+    /** Which marks the strip toggles, in order. Default bold, italic, underline. */
+    marks?: readonly MarkId[];
+    /** The Link button and its address field. Needs a link mark in the editor and `KeptSelection`. Default off. */
+    link?: boolean;
+}
+export declare function SelectionToolbar({ editor, marks, link }: SelectionToolbarProps): import("react").JSX.Element | null;
+//# sourceMappingURL=SelectionToolbar.d.ts.map

package/dist/SelectionToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionToolbar.d.ts","sourceRoot":"","sources":["../src/SelectionToolbar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAU,SAAS,EAAE,MAAM,kBAAkB,CAAA;AASpD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,6BAAmD,CAAA;AAEhF,mGAAmG;AACnG,eAAO,MAAM,aAAa,qBA8BxB,CAAA;AAEF,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,QAG3C;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,QAG9C;AAED,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE9D;AAED,wGAAwG;AACxG,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;AAkB7D,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ9D;AA2ED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,+GAA+G;IAC/G,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAuC,EAAE,IAAY,EAAE,EAAE,qBAAqB,sCAqQxH"}

package/dist/SuggestionMenu.d.ts

@@ -0,0 +1,75 @@
+import { type ReactNode, type Ref } from 'react';
+import { type MenuItemProps } from './Menu';
+/**
+ * The list a text editor opens as you type — `/` for commands, `@` for people,
+ * `[` for a reference. UIG-31: Peek's four type-ahead menus, made one part.
+ *
+ * **Why it is not a `Combobox` or a `Menu`.** Base UI's lists need a text field
+ * of their own, and the text being completed is an editor, not an `<input>`.
+ * So focus never leaves the text: the editor hands its arrow keys and Enter to
+ * this list through `handle`, and the list tells the editor which row is
+ * active (`aria-activedescendant`), the pattern Base UI's `Combobox` builds.
+ * If Base UI ever adds a list that can be driven from outside its own field,
+ * this part moves onto it.
+ *
+ * **What it owns**, all of it written once here instead of in every menu:
+ *
+ * - the box: the package `Popover`, anchored to the caret, above it and below
+ *   when there is no room, clamped to the window, scrolling in the package's
+ *   `ScrollArea` past `maxHeight`;
+ * - the highlighted row: ↑ and ↓ (wrapping at the ends), Enter to choose, the
+ *   pointer moving the highlight, a press choosing without taking focus from
+ *   the text, the highlight back on the first row whenever the list changes,
+ *   and the highlighted row scrolled into view;
+ * - what a screen reader is told: the list is a `listbox`, each row an
+ *   `option`, and the editor says it completes into this list and which row
+ *   is active — all removed again when the list closes.
+ *
+ * What stays with the app: which rows exist, what choosing one does, and what
+ * each row shows (its label, face, keys, hint) — `row` returns the package
+ * `MenuItem`'s own props. With nothing to show there is no box at all.
+ */
+export interface SuggestionMenuRow {
+    label: string;
+    description?: string;
+    leading?: ReactNode;
+    /** What you would type — drawn as keys at the right, e.g. `#` for a heading. */
+    shortcut?: string;
+    /** Drawn at the right while the row is highlighted, e.g. `<EnterHint />`. */
+    hint?: ReactNode;
+    /** `tall` for a row with a face and a second line — `MenuItem`'s own sizes. */
+    size?: MenuItemProps['size'];
+}
+export interface SuggestionMenuSection<T> {
+    /** The section's heading. Without one, the rows stand alone. */
+    label?: string;
+    items: readonly T[];
+    /** On the heading row, as `MenuSection`'s. */
+    className?: string;
+}
+/** What the editor calls while the list is open. */
+export interface SuggestionMenuHandle {
+    /** ↑, ↓ and Enter. `true` when the list used the key, so the editor must not. */
+    onKeyDown: (event: KeyboardEvent) => boolean;
+}
+export interface SuggestionMenuProps<T> {
+    /** The caret's rect, from the editor. `null` closes the box. */
+    rect: DOMRect | null;
+    /** The editor's own element — told which row is active. Absent in a story. */
+    editorElement?: HTMLElement | null;
+    /** Names the list — "Commands", "People". */
+    ariaLabel: string;
+    /** The box's width, e.g. `w-[300px]`. */
+    width: string;
+    /** The cap before the rows scroll, e.g. `max-h-[400px]`. */
+    maxHeight: string;
+    sections: readonly SuggestionMenuSection<T>[];
+    /** A stable key for a row. */
+    itemKey: (item: T) => string;
+    /** What a row shows. */
+    row: (item: T) => SuggestionMenuRow;
+    onSelect: (item: T) => void;
+    handle?: Ref<SuggestionMenuHandle>;
+}
+export declare function SuggestionMenu<T>({ rect, editorElement, ariaLabel, width, maxHeight, sections, itemKey, row, onSelect, handle }: SuggestionMenuProps<T>): import("react").JSX.Element | null;
+//# sourceMappingURL=SuggestionMenu.d.ts.map

package/dist/SuggestionMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuggestionMenu.d.ts","sourceRoot":"","sources":["../src/SuggestionMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyE,KAAK,SAAS,EAAE,KAAK,GAAG,EAAE,MAAM,OAAO,CAAA;AACvH,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAA;AAGjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAA;CAC7C;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,gEAAgE;IAChE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACpB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7C,8BAA8B;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC5B,wBAAwB;IACxB,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,iBAAiB,CAAA;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IAC3B,MAAM,CAAC,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAA;CACnC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC,sCA6GvJ"}

package/dist/editor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `@estiva-app/ui/editor` — the parts that work inside a Tiptap editor (UIG-31,
+ * Katerina's ruling 29 September: one editor corner in the package, option A).
+ *
+ * Its own entry because it imports Tiptap, which only an app with an editor
+ * installs: the main entry stays free of it, and the Tiptap peers are optional,
+ * as the eslint ones are. The rest of the package it draws with — `Popover`,
+ * `Toolbar`, `MenuItem`, `SuggestionMenu` — is the main entry's own, not a copy.
+ */
+export { KeptSelection, SelectionToolbar, normalizeHref, type MarkId, type SelectionToolbarProps } from './SelectionToolbar';
+export { suggestionPopup, isSuggestionActive, isSuggestionOpen, type SuggestionPopupOptions } from './suggestionPopup';
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC5H,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/editor.js

@@ -0,0 +1,357 @@
+// src/SelectionToolbar.tsx
+import { useCallback, useEffect, useRef, useState } from "react";
+import { Extension } from "@tiptap/core";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { Decoration, DecorationSet } from "@tiptap/pm/view";
+import { IconBold, IconCode, IconItalic, IconLink, IconUnderline } from "@tabler/icons-react";
+import { Form } from "@estiva-app/ui";
+import { Popover } from "@estiva-app/ui";
+import { TextInput } from "@estiva-app/ui";
+import { Toolbar, ToolbarButton } from "@estiva-app/ui";
+import { shortcutLabel } from "@estiva-app/ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+var keptSelectionKey = new PluginKey("keptSelection");
+var KeptSelection = Extension.create({
+  name: "keptSelection",
+  addProseMirrorPlugins() {
+    return [
+      new Plugin({
+        key: keptSelectionKey,
+        state: {
+          init: () => null,
+          apply(tr, previous) {
+            const meta = tr.getMeta(keptSelectionKey);
+            if (meta !== void 0) return meta;
+            if (!previous) return null;
+            return { from: tr.mapping.map(previous.from), to: tr.mapping.map(previous.to) };
+          }
+        },
+        props: {
+          decorations(state) {
+            const range = keptSelectionKey.getState(state);
+            if (!range || range.from === range.to) return null;
+            return DecorationSet.create(state.doc, [
+              Decoration.inline(range.from, range.to, { class: "kept-selection bg-bg-selected" })
+            ]);
+          }
+        }
+      })
+    ];
+  }
+});
+function keepSelection(editor) {
+  const { from, to } = editor.state.selection;
+  editor.view.dispatch(editor.state.tr.setMeta(keptSelectionKey, { from, to }));
+}
+function releaseSelection(editor) {
+  if (editor.isDestroyed || !keptSelectionKey.getState(editor.state)) return;
+  editor.view.dispatch(editor.state.tr.setMeta(keptSelectionKey, null));
+}
+var MARKS = {
+  bold: { label: "Bold", keys: "Mod-B" },
+  italic: { label: "Italic", keys: "Mod-I" },
+  underline: { label: "Underline", keys: "Mod-U" },
+  code: { label: "Code", keys: "Mod-E" }
+};
+function toggleMark(editor, id) {
+  return editor.chain().focus().toggleMark(id).run();
+}
+function currentLink(editor) {
+  const href = editor.getAttributes("link").href;
+  return typeof href === "string" ? href : "";
+}
+function normalizeHref(raw) {
+  const s = raw.trim();
+  if (!s || /\s/.test(s)) return null;
+  if (/^(https?:|mailto:)/i.test(s)) return s;
+  if (/^[a-z][a-z0-9+.-]*:(?!\d)/i.test(s)) return null;
+  return `https://${s}`;
+}
+function applyLink(editor, raw) {
+  const chain = editor.chain().focus().extendMarkRange("link");
+  if (!raw.trim()) return chain.unsetMark("link", { extendEmptyMarkRange: true }).setMeta("preventAutolink", true).run();
+  const href = normalizeHref(raw);
+  if (!href) return false;
+  return chain.setMark("link", { href }).setMeta("preventAutolink", true).run();
+}
+var ICONS = {
+  bold: IconBold,
+  italic: IconItalic,
+  underline: IconUnderline,
+  code: IconCode
+};
+var SETTLE_MS = 250;
+var GAP = 8;
+var POPOVER_GAP = 4;
+function SelectionToolbar({ editor, marks = ["bold", "italic", "underline"], link = false }) {
+  const [anchor, setAnchor] = useState(null);
+  const [mode, setMode] = useState("marks");
+  const [url, setUrl] = useState("");
+  const [, setTick] = useState(0);
+  const timer = useRef(void 0);
+  const pointerDown = useRef(false);
+  const field = useRef(null);
+  const draft = useRef(null);
+  const modeRef = useRef("marks");
+  useEffect(() => {
+    modeRef.current = mode;
+  }, [mode]);
+  const linkOn = useRef(link);
+  linkOn.current = link;
+  const hide = useCallback(() => {
+    clearTimeout(timer.current);
+    draft.current = null;
+    if (editor) releaseSelection(editor);
+    setAnchor(null);
+    setMode("marks");
+  }, [editor]);
+  const commit = useCallback(() => {
+    const text = draft.current;
+    if (text === null || !editor) return;
+    draft.current = null;
+    if (text.trim() && applyLink(editor, text)) {
+      editor.commands.setTextSelection(editor.state.selection.to);
+    }
+    hide();
+  }, [editor, hide]);
+  const settle = useCallback(() => {
+    if (!editor || editor.isDestroyed) return;
+    if (modeRef.current === "link") return;
+    const { state, view } = editor;
+    const { empty, from, to } = state.selection;
+    if (empty || from === to || !view.hasFocus() || pointerDown.current) {
+      setAnchor(null);
+      setMode("marks");
+      return;
+    }
+    const start = view.coordsAtPos(from);
+    const end = view.coordsAtPos(to);
+    const centre = (Math.min(start.left, end.left) + Math.max(start.right, end.right)) / 2;
+    const inLink = linkOn.current && editor.isActive("link");
+    const address = inLink ? currentLink(editor) : "";
+    draft.current = inLink ? address : null;
+    if (inLink) keepSelection(editor);
+    setMode(inLink ? "link" : "marks");
+    setUrl(address);
+    setAnchor({ top: start.top, centre });
+  }, [editor]);
+  useEffect(() => {
+    if (!editor) return;
+    const schedule = () => {
+      if (modeRef.current === "link") return;
+      setTick((t) => t + 1);
+      clearTimeout(timer.current);
+      if (editor.state.selection.empty) {
+        setAnchor(null);
+        return;
+      }
+      timer.current = setTimeout(settle, SETTLE_MS);
+    };
+    const onBlur = () => {
+      if (modeRef.current !== "link") hide();
+    };
+    const startsSelection = (e) => e.target instanceof Node && editor.view.dom.contains(e.target);
+    const onPointerDown = (e) => {
+      if (!startsSelection(e)) return;
+      commit();
+      pointerDown.current = true;
+      hide();
+    };
+    const onPointerUp = () => {
+      if (!pointerDown.current) return;
+      pointerDown.current = false;
+      schedule();
+    };
+    editor.on("selectionUpdate", schedule);
+    editor.on("transaction", schedule);
+    editor.on("blur", onBlur);
+    document.addEventListener("mousedown", onPointerDown, true);
+    document.addEventListener("mouseup", onPointerUp, true);
+    return () => {
+      clearTimeout(timer.current);
+      editor.off("selectionUpdate", schedule);
+      editor.off("transaction", schedule);
+      editor.off("blur", onBlur);
+      document.removeEventListener("mousedown", onPointerDown, true);
+      document.removeEventListener("mouseup", onPointerUp, true);
+    };
+  }, [editor, settle, hide, commit]);
+  useEffect(() => {
+    if (mode !== "link" || !anchor) return;
+    const frame = requestAnimationFrame(() => {
+      field.current?.focus();
+      field.current?.select();
+    });
+    return () => cancelAnimationFrame(frame);
+  }, [mode, anchor]);
+  if (!editor || !anchor) return null;
+  const openField = () => {
+    const address = currentLink(editor);
+    draft.current = address;
+    keepSelection(editor);
+    setUrl(address);
+    setMode("link");
+  };
+  const submit = () => {
+    if (!url.trim()) {
+      applyLink(editor, "");
+      hide();
+      editor.commands.focus();
+      return;
+    }
+    commit();
+  };
+  const discard = () => {
+    hide();
+    editor.commands.focus();
+  };
+  const anchorRect = new DOMRect(anchor.centre, anchor.top - (GAP - POPOVER_GAP), 0, 0);
+  return /* @__PURE__ */ jsx(
+    Popover,
+    {
+      anchor: anchorRect,
+      open: true,
+      side: "top",
+      align: "center",
+      onOpenChange: (next) => {
+        if (!next) commit();
+      },
+      ariaLabel: "Text formatting",
+      className: "w-auto min-w-0",
+      contentClassName: "p-1",
+      children: mode === "link" ? (
+        /* One field, so no strip: a toolbar of one control is a toolbar in
+           name only, and `ToolbarInput` cannot take the ref this field is
+           focused by (ADOPTION B25). */
+        // The package Form (UIG-7): Enter applies the link. `free` and `flex`: one field, which keeps its own height.
+        /* @__PURE__ */ jsx(Form, { onSubmit: submit, layout: "free", className: "flex", children: /* @__PURE__ */ jsx(
+          TextInput,
+          {
+            ref: field,
+            value: url,
+            onChange: (e) => {
+              setUrl(e.target.value);
+              draft.current = e.target.value;
+            },
+            onKeyDown: (e) => {
+              if (e.key === "Escape") {
+                e.stopPropagation();
+                discard();
+              }
+            },
+            placeholder: "Enter link URL",
+            "aria-label": "Link URL",
+            className: "w-[264px]"
+          }
+        ) })
+      ) : (
+        /* Four marks and a link button: one Tab stop, ← → along them (D29). */
+        /* @__PURE__ */ jsxs(Toolbar, { "aria-label": "Text formatting", surface: false, children: [
+          marks.map((id) => {
+            const Icon = ICONS[id];
+            const active = editor.isActive(id);
+            return /* @__PURE__ */ jsx(
+              ToolbarButton,
+              {
+                "aria-label": MARKS[id].label,
+                pressed: active,
+                tooltip: MARKS[id].label,
+                tooltipShortcut: shortcutLabel(MARKS[id].keys),
+                onMouseDown: (e) => e.preventDefault(),
+                onClick: () => toggleMark(editor, id),
+                children: /* @__PURE__ */ jsx(Icon, { size: 16, stroke: 1.5 })
+              },
+              id
+            );
+          }),
+          link && /* @__PURE__ */ jsx(
+            ToolbarButton,
+            {
+              "aria-label": "Link",
+              tooltip: "Link",
+              onMouseDown: (e) => e.preventDefault(),
+              onClick: openField,
+              children: /* @__PURE__ */ jsx(IconLink, { size: 16, stroke: 1.5 })
+            }
+          )
+        ] })
+      )
+    }
+  );
+}
+
+// src/suggestionPopup.tsx
+import { forwardRef, useRef as useRef2, useImperativeHandle } from "react";
+import { ReactRenderer } from "@tiptap/react";
+import { SuggestionMenu } from "@estiva-app/ui";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var openCount = 0;
+var lastClose = 0;
+function isSuggestionActive() {
+  return openCount > 0 || Date.now() - lastClose < 100;
+}
+function isSuggestionOpen() {
+  return openCount > 0;
+}
+var Popup = forwardRef(function Popup2({ options, ...props }, handle) {
+  const menu = useRef2(null);
+  useImperativeHandle(handle, () => ({ onKeyDown: (event) => menu.current?.onKeyDown(event) ?? false }));
+  const sections = options.sections ? options.sections(props.items, props.query) : [{ items: props.items }];
+  return /* @__PURE__ */ jsx2(
+    SuggestionMenu,
+    {
+      handle: menu,
+      rect: props.clientRect?.() ?? null,
+      editorElement: props.editor.view.dom,
+      ariaLabel: options.ariaLabel,
+      width: options.width,
+      maxHeight: options.maxHeight,
+      sections,
+      itemKey: options.itemKey,
+      row: options.row,
+      onSelect: (item) => props.command(item)
+    }
+  );
+});
+function suggestionPopup(options) {
+  return () => {
+    let component = null;
+    let container = null;
+    const exit = () => {
+      if (!component) return;
+      openCount = Math.max(0, openCount - 1);
+      lastClose = Date.now();
+      component.destroy();
+      container?.remove();
+      component = null;
+      container = null;
+    };
+    return {
+      onStart: (props) => {
+        openCount++;
+        component = new ReactRenderer(Popup, { props: { ...props, options }, editor: props.editor });
+        container = document.createElement("div");
+        document.body.appendChild(container);
+        container.appendChild(component.element);
+      },
+      onUpdate: (props) => component?.updateProps({ ...props, options }),
+      onKeyDown: ({ event }) => {
+        if (event.key === "Escape") {
+          exit();
+          return true;
+        }
+        return component?.ref?.onKeyDown(event) ?? false;
+      },
+      onExit: exit
+    };
+  };
+}
+export {
+  KeptSelection,
+  SelectionToolbar,
+  isSuggestionActive,
+  isSuggestionOpen,
+  normalizeHref,
+  suggestionPopup
+};
+//# sourceMappingURL=editor.js.map