@qilin-agent/client-ui-primitives 3.1.6 → 3.1.8

package/lib/markdown/CodeBlock.module.css

@@ -104,6 +104,29 @@
   color: var(--qilin-alias-label-primary);
 }
 
+/* Line-level hover: the source line under the pointer takes the interactive
+   wash so a reader can follow one line across a wide block. The rule paints a
+   background only — selection, the copy button's textContent read, and the
+   gutter's counters are untouched. Shiki, the plain arm, and the streaming arm
+   all emit one `span.line` per source line, so the selector covers every arm. */
+.block :where(pre) code > :global(.line) {
+  border-radius: 4px;
+  transition: background-color 120ms ease;
+}
+
+@media (hover: hover) {
+  .block :where(pre) code > :global(.line):hover {
+    background-color: var(--qilin-alias-interactive-bg-hover);
+  }
+}
+
+/* A reader who asked for less motion gets the wash without the fade. */
+@media (prefers-reduced-motion: reduce) {
+  .block :where(pre) code > :global(.line) {
+    transition: none;
+  }
+}
+
 .numbered :where(pre) code {
   display: block;
   counter-reset: source-line;

package/lib/markdown/JsonBlock.module.css

@@ -23,7 +23,7 @@
   max-height: 200px;
   overflow: auto;
   background: var(--qilin-alias-markdown-code-block);
-  border: 0.5px solid var(--qilin-alias-border-l1);
+  border: 1px solid var(--qilin-alias-border-l1);
   border-radius: 6px;
   font-family: var(--ds-font-family-code);
   font-size: 11px;

package/lib/markdown/MarkdownText.module.css

@@ -143,7 +143,7 @@
 .markdown hr {
   display: block;
   border: none;
-  height: 0.5px;
+  height: 1px;
   margin: 32px 0;
   background: var(--qilin-alias-border-l2);
 }
@@ -168,7 +168,7 @@
   font-family: var(--ds-font-family-code);
   font-size: 0.875em !important;
   background-color: var(--qilin-alias-markdown-inline-code);
-  border: 0.5px solid var(--qilin-alias-border-l1);
+  border: 1px solid var(--qilin-alias-border-l1);
   border-radius: 6px;
   padding: 0 5px;
 }
@@ -244,7 +244,7 @@
 .tableScroll th {
   text-align: start;
   padding: 10px 16px;
-  border-bottom: 0.5px solid var(--qilin-alias-border-l3);
+  border-bottom: 1px solid var(--qilin-alias-border-l3);
   border-top: none;
   font: var(--qilin-font-markdown-table-head);
   max-width: 320px;
@@ -254,7 +254,7 @@
 
 .tableScroll td {
   padding: 10px 16px;
-  border-bottom: 0.5px solid var(--qilin-alias-border-l2);
+  border-bottom: 1px solid var(--qilin-alias-border-l2);
   font: var(--qilin-font-markdown-table);
   max-width: 320px;
   max-width: min(30vw, 320px);
@@ -305,10 +305,14 @@
    on hover/focus. An underline at rest reads badly inside the code chip, where
    it collides with monospace descenders and the pill background. */
 .fileMention {
-  margin: 0;
-  padding: 0;
+  /* A mention of a file the agent produced highlights its code chip: the
+     negative margins fill the chip's own padding so the accent pill covers
+     the whole chip rather than nesting inside it. */
+  margin: 0 -5px;
+  padding: 0 5px;
   border: none;
-  background: none;
+  border-radius: 6px;
+  background: var(--qilin-specific-bubble-highlight);
   font: inherit;
   font-weight: 500;
   color: var(--qilin-alias-link);

package/lib/settings-form/fields.module.css

@@ -8,7 +8,7 @@
 }
 
 .field + .field {
-  border-top: 0.5px solid var(--qilin-alias-border-l2);
+  border-top: 1px solid var(--qilin-alias-border-l2);
 }
 
 .head {
@@ -107,7 +107,7 @@
 .input {
   height: 34px;
   padding: 0 12px;
-  border: 0.5px solid var(--qilin-alias-border-l4);
+  border: 1px solid var(--qilin-alias-border-l4);
   border-radius: var(--qilin-radius-md);
   background: var(--qilin-alias-bg-layer-3);
   font: inherit;

package/lib/types/AnimatedRows.d.ts

@@ -0,0 +1,46 @@
+/** React-commit-driven movement and entry/exit fades for keyed rows. */
+import { Component, type AriaRole, type ReactNode } from 'react';
+/** Keyed row content, list semantics, and animation readiness. */
+export interface AnimatedRowsProps {
+    children: ReactNode;
+    className: string;
+    role?: AriaRole;
+    label?: string;
+    /** Unique DOM-order keys matching the rendered data-row-key attributes. */
+    rowKeys: readonly string[];
+    ready: boolean;
+    /** Changes that replace the view or reveal hidden rows settle immediately. */
+    resetKey: string;
+}
+interface RowPosition {
+    element: HTMLElement;
+    rect: DOMRect;
+    opacity: number;
+}
+interface RowSnapshot {
+    positions: Map<string, RowPosition>;
+    removed: Map<string, RowPosition>;
+}
+/**
+ * Animates keyed rows only when their rendered membership or order changes.
+ * Motion starts after the first pointer or keyboard input inside the mounted list.
+ * The parent supplies a positioned container for the inert exit overlay.
+ */
+export declare class AnimatedRows extends Component<AnimatedRowsProps> {
+    private armed;
+    private readonly list;
+    private readonly overlay;
+    private readonly movements;
+    private readonly exits;
+    getSnapshotBeforeUpdate(previous: AnimatedRowsProps): RowSnapshot | null;
+    componentDidUpdate(previous: AnimatedRowsProps, _state: unknown, snapshot: RowSnapshot | null): void;
+    componentWillUnmount(): void;
+    private readPositions;
+    private move;
+    private cancelMovements;
+    private removeExit;
+    private clear;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=AnimatedRows.d.ts.map

package/lib/types/Button.d.ts

@@ -1,18 +1,27 @@
-import type { ButtonHTMLAttributes, ReactNode } from 'react';
+import { type ButtonHTMLAttributes, type ReactNode } from 'react';
 /** Visual variant, each backed by its --qilin-alias-button-* token family. */
 export type ButtonVariant = 'primary' | 'ghost' | 'outline' | 'toolbar';
+/** Props accepted by {@link Button}. */
+export type ButtonProps = {
+    variant?: ButtonVariant;
+    size?: 'md' | 'sm';
+    icon?: ReactNode;
+    className?: string | undefined;
+    children?: ReactNode;
+} & ButtonHTMLAttributes<HTMLButtonElement>;
 /**
  * Render a button.
  * @param props.variant - visual family (default 'ghost').
  * @param props.size - 'md' 36px capsule (figma Button) or 'sm' 28px compact.
  * @param props.icon - optional leading 16px icon node.
+ * @param ref - native button for focus management and overlay anchors.
  * @returns the button element; native button attributes pass through.
  */
-export declare function Button({ variant, size, icon, className, children, ...rest }: {
+export declare const Button: import("react").ForwardRefExoticComponent<{
     variant?: ButtonVariant;
-    size?: 'md' | 'sm';
+    size?: "md" | "sm";
     icon?: ReactNode;
     className?: string | undefined;
     children?: ReactNode;
-} & ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
+} & ButtonHTMLAttributes<HTMLButtonElement> & import("react").RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=Button.d.ts.map

package/lib/types/DetailDocument.d.ts

@@ -0,0 +1,79 @@
+import { type ReactNode } from 'react';
+import { type MarkdownLabels, type MarkdownPathImages } from './markdown/MarkdownText.tsx';
+/** One read of a long Markdown description, such as a plugin's detail document. */
+export type DetailDocumentState = {
+    readonly status: 'loading';
+} | {
+    readonly status: 'found';
+    readonly markdown: string;
+} | {
+    readonly status: 'none';
+} | {
+    readonly status: 'error';
+    readonly message: string;
+};
+/** A read as owners track it: in flight, settled with a document or none, or failed with a localized message. */
+export type DetailDocumentRead = undefined | {
+    readonly status: 'loading';
+} | {
+    readonly status: 'ready';
+    readonly markdown: string | undefined;
+} | {
+    readonly status: 'error';
+    readonly message: string;
+};
+/**
+ * The state {@link DetailDocument} shows for an owner's read: loading until it settles, then the document, none, or the
+ * failure.
+ * @param read - the owner's read; undefined before it starts.
+ * @returns the state to show.
+ */
+export declare function detailDocumentState(read: DetailDocumentRead): DetailDocumentState;
+/** Translated strings of a detail document's chrome, as an owner's dictionary supplies them. */
+export interface DetailDocumentCopy {
+    readonly title: string;
+    readonly loading: string;
+    readonly retry: string;
+    readonly copy: string;
+    readonly copied: string;
+    /** Alt text naming an on-page Mermaid diagram. */
+    readonly diagram: string;
+    /** Alt text naming an enlarged Mermaid diagram. */
+    readonly enlarged: string;
+    readonly footnotes: string;
+}
+/**
+ * Assemble reference-stable labels for {@link DetailDocument} from translated strings.
+ * @param copy - the translated strings.
+ * @returns labels that keep their identity while the strings stay equal.
+ */
+export declare function useDetailDocumentLabels(copy: DetailDocumentCopy): DetailDocumentLabels;
+/** Localized chrome of a detail document. */
+export interface DetailDocumentLabels {
+    /** Accessible name of the scrollable document region; the section shows no heading of its own. */
+    readonly title: string;
+    /** Accessible name of the loading placeholder. */
+    readonly loading: string;
+    /** Retry button text. */
+    readonly retry: string;
+    readonly markdown: MarkdownLabels;
+}
+/**
+ * A section showing a long Markdown description, without a heading of its own: three skeleton lines while it loads, the
+ * document once found, or the owner's failure message with a retry. Nothing renders for `none`. A document taller than
+ * the section's height limit scrolls inside it, and the scroll region, named by `labels.title`, takes keyboard focus.
+ * Raw HTML is omitted, relative links stay text, and only images the owner's `images` resolver accepts, or absolute
+ * HTTP(S) images, load.
+ * @param props.state - the read to show.
+ * @param props.labels - localized region name, placeholder name, retry text, and Markdown chrome; keep `markdown` reference-stable.
+ * @param props.images - resolves the document's relative image destinations to displayable URLs.
+ * @param props.onRetry - reads the document again after a failure.
+ * @returns the section, or null.
+ */
+export declare function DetailDocument({ state, labels, images, onRetry }: {
+    readonly state: DetailDocumentState;
+    readonly labels: DetailDocumentLabels;
+    readonly images?: MarkdownPathImages | undefined;
+    readonly onRetry: () => void;
+}): ReactNode;
+//# sourceMappingURL=DetailDocument.d.ts.map

package/lib/types/ImageLightbox.d.ts

@@ -1,3 +1,4 @@
+import type { HTMLAttributes } from 'react';
 /** Lightbox strings the owner resolves from its own locale namespace. */
 export interface ImageLightboxLabels {
     /** Accessible name of the preview dialog. */
@@ -18,10 +19,11 @@ export interface ImageLightboxLabels {
  * @param props.onClose - dismiss callback owned by the opener.
  * @returns the modal preview dialog.
  */
-export declare function ImageLightbox({ src, alt, labels, onClose }: {
+export declare function ImageLightbox({ src, alt, labels, onClose, contextMenuProps }: {
     src: string;
     alt: string;
     labels: ImageLightboxLabels;
     onClose: () => void;
+    contextMenuProps?: Pick<HTMLAttributes<HTMLElement>, 'onContextMenu' | 'onKeyDown' | 'tabIndex'> | undefined;
 }): import("react").ReactPortal;
 //# sourceMappingURL=ImageLightbox.d.ts.map

package/lib/types/LinkIcon.d.ts

@@ -1,34 +1,15 @@
 /**
- * Leading category glyph for clickable artifact links (anchors, file
- * mentions, produced-file chips). One component keyed by link category;
- * every glyph renders fill="currentColor" and so rides the link's own
- * color. Glyphs stay private to this module: the public surface is the
- * category vocabulary, not the individual glyph components, so consumers
- * cannot compose a glyph outside a link. Design sources:
- * ic_globe_language_outline_20, ic_code_outline_20, ic_folder_outline_20,
- * ic_photo_outline_20, ic_paper_doc_outline_20, ic_paper_outline_20.
- *
- * A `url` glyph whose destination names a well-known site is that site's own
- * mark instead of the globe (`SiteGlyph.tsx`); every mark keeps the same
- * currentColor-only rule.
+ * Leading current-color category glyphs for clickable artifact links. The
+ * public component keeps individual artwork private to the link vocabulary.
  */
 import type { ReactNode } from 'react';
 import type { IconProps } from './icons/props.ts';
-/**
- * Link categories with distinct leading glyphs. `url` and `folder` are
- * destination categories the consumer states directly; the rest are file
- * categories `classifyLinkPath` derives from a path. Code, web, and data
- * files share the `code` glyph by design.
- */
+/** Link categories with distinct leading glyphs. */
 export type LinkIconKind = 'url' | 'folder' | 'code' | 'image' | 'document' | 'other';
-/** Props for {@link LinkIcon}: the category plus the shared icon sizing seat. */
+/** Props for link icons: the category plus the shared icon sizing seat. */
 export interface LinkIconProps extends IconProps {
     kind: LinkIconKind;
-    /**
-     * Destination of a `url` link. A well-known site draws its own mark, so
-     * callers that know the destination should pass it; anything else keeps the
-     * globe. Other kinds ignore it — their destination is a path, not a site.
-     */
+    /** Destination of a URL link; known HTTP(S) hosts render their site mark. */
     href?: string | undefined;
 }
 /**
@@ -39,11 +20,15 @@ export interface LinkIconProps extends IconProps {
  */
 export declare function classifyLinkPath(path: string): LinkIconKind;
 /**
- * Render the leading glyph for one clickable artifact link.
- * @param props - The link category, the optional destination that can select a
- * site mark, optional size (default 14px — the inline link text size these
- * glyphs sit beside), and optional CSS class.
- * @returns The category's SVG glyph, riding currentColor.
+ * Render a regular one-pixel link icon.
+ * @param props - Link category, size, and optional class.
+ * @returns The regular decorative link glyph.
+ */
+export declare function LinkIconRegular(props: LinkIconProps): ReactNode;
+/**
+ * Render a medium 1.3px link icon.
+ * @param props - Link category, size, and optional class.
+ * @returns The medium decorative link glyph.
  */
-export declare function LinkIcon({ kind, href, size, className }: LinkIconProps): ReactNode;
+export declare function LinkIconMedium(props: LinkIconProps): ReactNode;
 //# sourceMappingURL=LinkIcon.d.ts.map

package/lib/types/Menu.d.ts

@@ -14,7 +14,7 @@ export interface MenuItem {
     /** Destructive row: error-colored text/icon and danger hover fill. */
     danger?: boolean;
     /** Nested card opened to the right on hover/focus. */
-    submenu?: readonly MenuItem[];
+    submenu?: readonly MenuEntry[];
 }
 /** Hairline between item groups (not selectable). */
 export interface MenuSeparator {
@@ -37,8 +37,16 @@ export interface MenuItemButtonProps {
     shortcut?: MenuItem['shortcut'];
     /** Leading icon (figma .Menu_cell gap 8). */
     icon?: ReactNode;
+    /** Whether this row identifies the currently displayed page or view. */
+    current?: boolean;
     /** Whether the row cannot be activated. */
     disabled?: boolean;
+    /**
+     * Why the disabled row cannot be activated. The row then stays hoverable and
+     * focusable, shows the reason in a tooltip, and exposes it as the row's
+     * description; an enabled row ignores it.
+     */
+    disabledReason?: string | undefined;
     /** Destructive row: error-colored text/icon and danger hover fill. */
     danger?: boolean;
     /**
@@ -60,13 +68,15 @@ export interface MenuItemButtonProps {
  * @param props.children - visible row label.
  * @param props.shortcut - effective key labels and accessible combination.
  * @param props.icon - optional leading icon.
+ * @param props.current - whether the row identifies the currently displayed page or view.
  * @param props.disabled - whether the row cannot be activated.
+ * @param props.disabledReason - why a disabled row cannot be activated, shown in a tooltip and read as its description.
  * @param props.danger - whether to use the destructive row colors.
  * @param props.separatorBefore - whether this row starts a new group (hairline above it).
  * @param props.onSelect - row activation callback.
  * @returns one menu-item row.
  */
-export declare function MenuItemButton({ children, shortcut, icon, disabled, danger, separatorBefore, onSelect, }: MenuItemButtonProps): import("react").JSX.Element;
+export declare function MenuItemButton({ children, shortcut, icon, current, disabled, disabledReason, danger, separatorBefore, onSelect, }: MenuItemButtonProps): import("react").JSX.Element;
 /**
  * Render an anchored dropdown menu. While the list is open its keys mirror the
  * composer's: Tab settles the focused row — from the trigger, Tab enters the
@@ -74,6 +84,9 @@ export declare function MenuItemButton({ children, shortcut, icon, disabled, dan
  * anchor's first button, and selecting a row does the same — the rows unmount
  * with the list. Only a keyboard on the trigger or inside the list is
  * intercepted; Tab presses elsewhere on the page stay the browser's.
+ * @param props.contextual - cursor positioning, context dismissal, and per-divider icon alignment.
+ * @param props.exiting - retain an inert popup during dismissal or replacement fade.
+ * @param props.returnFocus - original control captured before asynchronous menu preparation.
  * @param props.autoFocus - focus the first item on open; the arrow keys walk the list either way.
  * @param props.open - whether the list is showing (owner-controlled).
  * @param props.anchor - the trigger element (rendered in place).
@@ -87,9 +100,9 @@ export declare function MenuItemButton({ children, shortcut, icon, disabled, dan
  * @param props.align - list alignment against the anchor (default 'start').
  * @param props.side - open below (`bottom`, default) or above (`top`) the anchor.
  * @param props.portal - render the list into document.body, fixed-positioned
- * from the anchor rect (follows movement and resizing while open). Use when an
- * ancestor's overflow clipping would crop the in-place list; default false
- * keeps the pure-CSS in-place behavior.
+ * synchronously (follows movement, resizing, and browser zoom while open)
+ * and clamped inside the visual viewport. Use when an ancestor's overflow clipping would crop the
+ * in-place list; default false keeps the pure-CSS in-place behavior.
  * @param props.closeOnPointerLeave - close the list once the pointer has left
  * both trigger and list for the pointer grace (default false keeps it open
  * until outside click/Escape/selection). The grace makes the 4px trigger->list
@@ -100,10 +113,11 @@ export declare function MenuItemButton({ children, shortcut, icon, disabled, dan
  * directly (e.g. from a host-owned trigger button) instead of measuring the
  * Menu's own wrapper span. Required when the wrapper isn't itself laid out at
  * the trigger (render-prop anchors, effect-positioned proxies — measuring the
- * wrapper there races the host's layout effects). Called on open, each animation
- * frame, and scroll/resize; return null to skip placement for that frame.
+ * wrapper there races the host's layout effects). Called while tracking the
+ * anchor and on scroll/resize; return null to defer placement.
+ * @param props.minWidthFromAnchor - in portal mode, keep the menu at least as wide as its anchor, bounded by viewport margins.
  * @param props.footer - rows pinned below the scrolling items area, separated
- * by a hairline; they stay visible while the items above scroll.
+ * by a hairline; contextual menus reuse an explicit leading separator. These rows stay visible while the items above scroll.
  * @param props.children - component rows rendered after `items` in the same
  * list, each a `role="menuitem"` button such as {@link MenuItemButton}; they
  * share the keyboard walk, the submenu exclusivity, and the post-selection
@@ -118,8 +132,14 @@ export declare function MenuItemButton({ children, shortcut, icon, disabled, dan
  * document.body outside the owner's DOM subtree.
  * @returns anchor wrapper with the conditional list.
  */
-export declare function Menu({ open, anchor, items, children, selectedId, selectedIds, onSelect, onClose, align, side, portal, closeOnPointerLeave, dense, compact, autoFocus, selection, getAnchorRect, footer, className, listClassName }: {
+export declare function Menu({ open, anchor, items, children, selectedId, selectedIds, onSelect, onClose, align, side, portal, closeOnPointerLeave, dense, compact, autoFocus, selection, getAnchorRect, minWidthFromAnchor, footer, className, listClassName, contextual, exiting, returnFocus }: {
     open: boolean;
+    /** Pointer-positioned popup: cursor clearance, grouped icons, and context gestures. */
+    contextual?: boolean;
+    /** Resolve the original control for focus restoration and inert/hidden dismissal. */
+    returnFocus?: (() => HTMLElement | null) | undefined;
+    /** Retain a dismissed context popup during its short fade. */
+    exiting?: 'dismiss' | 'replace' | undefined;
     autoFocus?: boolean;
     anchor: ReactNode;
     items?: readonly MenuEntry[];
@@ -137,6 +157,7 @@ export declare function Menu({ open, anchor, items, children, selectedId, select
     compact?: boolean;
     selection?: 'check' | 'fill';
     getAnchorRect?: () => DOMRect | null;
+    minWidthFromAnchor?: boolean;
     className?: string | undefined;
     listClassName?: string | undefined;
 }): import("react").JSX.Element;

package/lib/types/MenuSurface.d.ts

@@ -1,9 +1,18 @@
 /** Shared menu material and the macOS backing that lets Chromium blur transparent windows. */
 import { type ComponentPropsWithoutRef } from 'react';
+/** Context-menu transition durations in milliseconds, shared with its lifecycle owner. */
+export declare const MENU_TRANSITION_MS: Readonly<{
+    enter: 40;
+    dismiss: 80;
+    replace: 10;
+    prepare: 20;
+}>;
 /** Menu containers preserve native div props and refs. */
 export interface MenuSurfaceProps extends ComponentPropsWithoutRef<'div'> {
     /** Match the shared compact menu's smaller outer radius. */
     compact?: boolean;
+    /** Fade direct content, material, and native backing without isolating the material's backdrop. */
+    phase?: 'enter' | 'dismiss' | 'replace' | undefined;
 }
 /**
  * Paint a menu and, on macOS, an opaque backing behind the page content within its bounds.

package/lib/types/PermissionIcon.d.ts

@@ -0,0 +1,51 @@
+import type { ReactNode } from 'react';
+import type { IconProps } from './icons/props.ts';
+/**
+ * Render the read-only permission icon with a one-pixel stroke.
+ * @param props - Size and optional class.
+ * @returns The regular decorative permission glyph.
+ */
+export declare function PermissionIconReadOnlyRegular(props: IconProps): ReactNode;
+/**
+ * Render the read-only permission icon with a 1.3px stroke.
+ * @param props - Size and optional class.
+ * @returns The medium decorative permission glyph.
+ */
+export declare function PermissionIconReadOnlyMedium(props: IconProps): ReactNode;
+/**
+ * Render the workspace-write permission icon with a one-pixel stroke.
+ * @param props - Size and optional class.
+ * @returns The regular decorative permission glyph.
+ */
+export declare function PermissionIconWorkspaceWriteRegular(props: IconProps): ReactNode;
+/**
+ * Render the workspace-write permission icon with a 1.3px stroke.
+ * @param props - Size and optional class.
+ * @returns The medium decorative permission glyph.
+ */
+export declare function PermissionIconWorkspaceWriteMedium(props: IconProps): ReactNode;
+/**
+ * Render the full-access permission icon with a one-pixel stroke.
+ * @param props - Size and optional class.
+ * @returns The regular decorative permission glyph.
+ */
+export declare function PermissionIconFullAccessRegular(props: IconProps): ReactNode;
+/**
+ * Render the full-access permission icon with a 1.3px stroke.
+ * @param props - Size and optional class.
+ * @returns The medium decorative permission glyph.
+ */
+export declare function PermissionIconFullAccessMedium(props: IconProps): ReactNode;
+/**
+ * Render the auto-review permission icon with a one-pixel stroke.
+ * @param props - Size and optional class.
+ * @returns The regular decorative permission glyph.
+ */
+export declare function PermissionIconAutoReviewRegular(props: IconProps): ReactNode;
+/**
+ * Render the auto-review permission icon with a 1.3px stroke.
+ * @param props - Size and optional class.
+ * @returns The medium decorative permission glyph.
+ */
+export declare function PermissionIconAutoReviewMedium(props: IconProps): ReactNode;
+//# sourceMappingURL=PermissionIcon.d.ts.map

package/lib/types/QuotePreview.d.ts

@@ -0,0 +1,26 @@
+import type { JSX } from 'react';
+/** Localized names of the quote controls; a caller owns every string. */
+export interface QuotePreviewLabels {
+    /** Accessible name of the copy control. */
+    readonly copy: string;
+    /** Accessible name after an accepted copy. */
+    readonly copied: string;
+    /** Accessible name of the jump control. */
+    readonly jump: string;
+}
+/** Presentation inputs for one quoted excerpt. */
+export interface QuotePreviewProps {
+    /** Excerpt text as decoded from the message, without its source marker line. */
+    readonly text: string;
+    /** Localized control names. */
+    readonly labels: QuotePreviewLabels;
+    /** Reveal the quoted source; omission hides the jump control. */
+    readonly onJump?: (() => void) | undefined;
+}
+/**
+ * Render one quoted excerpt with its copy and optional jump controls.
+ * @param props - excerpt text, control names, and the reveal action.
+ * @returns the quote surface, with the full text on hover while clipped.
+ */
+export declare function QuotePreview({ text, labels, onJump }: QuotePreviewProps): JSX.Element;
+//# sourceMappingURL=QuotePreview.d.ts.map

package/lib/types/ReferenceIcon.d.ts

@@ -1,16 +1,21 @@
 import type { ReactNode } from 'react';
+import type { IconProps } from './icons/props.ts';
 /** Reference domains with distinct composer and transcript glyphs. */
 export type ReferenceIconKind = 'session' | 'file' | 'folder';
 /** Props shared by inline reference glyphs. */
-export interface ReferenceIconProps {
+export interface ReferenceIconProps extends IconProps {
     kind: ReferenceIconKind;
-    size?: number;
-    className?: string | undefined;
 }
 /**
- * Render the icon that identifies one inline reference domain.
- * @param props - Reference kind, optional size, and optional CSS class.
- * @returns The corresponding current-color SVG glyph.
+ * Render a regular one-pixel reference icon.
+ * @param props - Reference kind, size, and optional class.
+ * @returns The regular decorative reference glyph.
  */
-export declare function ReferenceIcon({ kind, size, className }: ReferenceIconProps): ReactNode;
+export declare function ReferenceIconRegular(props: ReferenceIconProps): ReactNode;
+/**
+ * Render a medium 1.3px reference icon.
+ * @param props - Reference kind, size, and optional class.
+ * @returns The medium decorative reference glyph.
+ */
+export declare function ReferenceIconMedium(props: ReferenceIconProps): ReactNode;
 //# sourceMappingURL=ReferenceIcon.d.ts.map

package/lib/types/SegmentedTabs.d.ts

@@ -14,13 +14,15 @@ export interface SegmentedTab<Value extends string = string> {
  * Keyboard selection also moves focus; only the selected tab is a tab stop.
  * @param props.label - localized accessible name for the tab list.
  * @param props.className - layout placement; panels remain caller-owned.
+ * @param props.size - `sm` draws 30px tabs with a 2px inset (34px tall); the default `md` draws 34px tabs with a 4px inset (42px tall).
  * @returns the tab list, without its panels.
  */
-export declare function SegmentedTabs<Value extends string>({ items, value, onChange, label, className }: {
+export declare function SegmentedTabs<Value extends string>({ items, value, onChange, label, className, size }: {
     items: readonly [SegmentedTab<Value>, ...SegmentedTab<Value>[]];
     value: Value;
     onChange: (value: Value) => void;
     label: string;
     className?: string | undefined;
+    size?: 'sm' | 'md' | undefined;
 }): ReactNode;
 //# sourceMappingURL=SegmentedTabs.d.ts.map

package/lib/types/SiteGlyph.d.ts

@@ -1,5 +1,5 @@
 /**
- * Site marks for well-known external link hosts. {@link LinkIcon} renders one in
+ * Site marks for well-known external link hosts. {@link LinkIconMedium} renders one in
  * the leading glyph seat, so a familiar destination leads with its own mark
  * instead of the generic globe. The marks are the `simple-icons` artwork set
  * (CC0-1.0), pinned by this package's dependency on it; each mark takes the

package/lib/types/Toast.d.ts

@@ -7,6 +7,16 @@ import type { ReactNode } from 'react';
  * transformed or filtered ancestor cannot trap the fixed banner in that
  * ancestor's box.
  *
+ * Actions extend the sentence with inline choices: each renders its plain-text
+ * `prefix` (a connective such as "or") followed by its localized `label` as
+ * clickable text inside the banner. Each press is the owner's to handle (undo
+ * the reported change, then unmount the toast). The banner surface stays
+ * click-through — only the action text takes the pointer — and a fully faded
+ * banner takes no input at all.
+ *
+ * With an unchanged holdMs, a parent rerender does not extend the lifetime:
+ * the completion call reaches the latest onDone handler.
+ *
  * The hold is the owner's to set, because how long a banner has to stay
  * depends on how much there is to read: a one-line limit lands in the default
  * window, while a failure that names what broke does not. One value drives
@@ -18,6 +28,9 @@ import type { ReactNode } from 'react';
  * under `tone="success"`, which brings its own glyph.
  * @param props.tone - 'success' renders the success check as the leading
  * glyph; omitted, the icon seat keeps its warning tint.
+ * @param props.actions - optional inline actions continuing the sentence;
+ * each renders its plain-text `prefix` followed by its localized `label`
+ * as clickable text flowing after `text` as one sentence.
  * @param props.holdMs - full-opacity hold before the fade; defaults to 3000.
  * @param props.anchor - optional element whose horizontal center the banner
  * follows (e.g. the composer card, so the banner centers over the chat column
@@ -25,12 +38,17 @@ import type { ReactNode } from 'react';
  * @param props.onDone - called once the fade completes; unmount the toast here.
  * @returns the floating banner.
  */
-export declare function Toast({ text, icon, tone, anchor, holdMs, onDone }: {
+export declare function Toast({ text, icon, tone, anchor, holdMs, actions, onDone }: {
     text: string;
     icon?: ReactNode;
     tone?: 'success';
     anchor?: HTMLElement | null;
     holdMs?: number;
+    actions?: readonly {
+        label: string;
+        prefix?: string;
+        onClick: () => void;
+    }[];
     onDone: () => void;
 }): import("react").ReactPortal;
 //# sourceMappingURL=Toast.d.ts.map