@arbidocs/react 0.3.185 → 0.4.0

package/dist/ui/index.d.cts

@@ -1,6 +1,6 @@
 import { ClassValue } from 'clsx';
 import * as React$1 from 'react';
-import React__default, { ComponentType, ReactNode } from 'react';
+import React__default, { HTMLAttributes, ReactNode, Ref, ComponentType } from 'react';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
@@ -60,6 +60,8 @@ declare function TooltipTrigger({ asChild, children, ...props }: TooltipTriggerP
 interface TooltipContentProps extends React$1.HTMLAttributes<HTMLDivElement> {
     side?: Side;
     sideOffset?: number;
+    /** Minimum gap, in px, kept between the tip and the viewport edges. Default 8. */
+    collisionPadding?: number;
 }
 declare const TooltipContent: React$1.ForwardRefExoticComponent<TooltipContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -248,8 +250,17 @@ declare const DialogTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.D
 declare const DialogPortal: React$1.FC<DialogPrimitive.DialogPortalProps>;
 declare const DialogClose: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DialogOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Where the dialog sits on a PHONE (< 640px). Wider screens always get a centred dialog.
+ *  - `center`: centred box with a 1rem margin (small prompts and confirmations).
+ *  - `sheet`: bottom sheet, full width, rounded top corners (forms and pickers).
+ *  - `full`: full-height sheet that stops below the status bar (large editors, wizards).
+ */
+type DialogPresentation = 'center' | 'sheet' | 'full';
 declare const DialogContent: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & {
     hideCloseButton?: boolean;
+    /** Phone presentation (see {@link DialogPresentation}). Defaults to `center`. */
+    presentation?: DialogPresentation;
 } & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
     ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
@@ -269,6 +280,51 @@ declare const PopoverContent: React$1.ForwardRefExoticComponent<Omit<PopoverPrim
     container?: HTMLElement | null;
 } & React$1.RefAttributes<HTMLDivElement>>;
 
+/** One row of a mark's menu. Give it `onSelect`, or an `href` for a real link row. */
+interface MarkMenuItem {
+    id: string;
+    label: string;
+    /** Runs when the row is chosen; the menu closes afterwards. */
+    onSelect?: () => void;
+    /** Renders the row as a link (no `onSelect` needed). */
+    href?: string;
+    /** The headline action: listed first, set a little larger, and run by a plain mouse click. */
+    primary?: boolean;
+    destructive?: boolean;
+    testId?: string;
+}
+interface MarkMenuProps extends Omit<HTMLAttributes<HTMLElement>, 'children' | 'onClick'> {
+    /** The element the mark itself is: a real link or an inline span. */
+    as?: 'a' | 'span';
+    href?: string;
+    /** Rows of the menu. The `primary` one (else the first) is the mark's default action. */
+    items: MarkMenuItem[];
+    /** Optional read-only content above the rows (a quoted passage, a note, a label name). */
+    preview?: ReactNode;
+    /** Accessible name of the menu. */
+    menuLabel: string;
+    /** A plain mouse click runs the primary row (default). Touch and keyboard always open the menu. */
+    shouldClickRunPrimary?: boolean;
+    /** Hover delay before the menu opens (ms). */
+    openDelay?: number;
+    closeDelay?: number;
+    testId?: string;
+    menuTestId?: string;
+    /** The mark element, for hosts that move focus back to it. */
+    triggerRef?: Ref<HTMLElement>;
+    children: ReactNode;
+}
+/**
+ * The ONE contextual menu of every inline mark (link, bookmark, citation, label, note).
+ *
+ * The mark stays quiet text. A compact popover opens on hover (short delay) and on keyboard focus;
+ * on touch a tap opens it instead of acting, so the primary row is one deliberate tap away. A
+ * plain mouse click runs the primary action, so existing click behaviour is unchanged.
+ * Keyboard: Enter/Space/ArrowDown open it and move into it, arrows move, Escape closes and
+ * returns focus to the mark. Rows are 44px high on coarse pointers.
+ */
+declare function MarkMenu({ as, href, items, preview, menuLabel, shouldClickRunPrimary, openDelay, closeDelay, testId, menuTestId, triggerRef: externalRef, className, children, onPointerDown, onPointerEnter, onPointerLeave, onFocus, onBlur, onKeyDown, ...rest }: MarkMenuProps): React$1.JSX.Element;
+
 declare const DropdownMenu: React$1.FC<DropdownMenuPrimitive.DropdownMenuProps>;
 declare const DropdownMenuTrigger: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DropdownMenuGroup: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuGroupProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -439,6 +495,52 @@ declare function AiMarkdown({ children, className, isStreaming, }: {
  */
 declare const markdownBaseComponents: Partial<Components>;
 
+/**
+ * PassageCard — the card ("bubble") a single retrieved passage is rendered as.
+ *
+ * One presentation shared by every surface that lists retrieval hits: the
+ * <SemanticSearch> block here and the ARBI-frontend monolith's SmartSearch
+ * results. Those had drifted into two different looks for the same object; this
+ * is the single one.
+ *
+ * The card owns the chrome only — the rounded border, the AI-accent hover /
+ * focus / selected states, the header row and the relevance dot. What goes in
+ * the header and how the snippet itself is rendered stays with the caller,
+ * because those genuinely differ: the block shows a plain-text excerpt in a
+ * narrow sidebar, the monolith renders markdown with a show-more toggle.
+ *
+ * Theming is semantic tokens only (shadcn + the AI-accent contract).
+ */
+
+/**
+ * A dot conveying relevance — green (high) / amber (mid) / muted (low).
+ *
+ * The band is shown, the raw number is not: scores are not on a normalized 0-1
+ * scale across search modes (BM25 keyword scores can exceed 1), so a printed
+ * figure invites a comparison it cannot support. The value is kept in the
+ * tooltip for anyone debugging a ranking.
+ */
+declare function RelevanceDot({ score }: {
+    score?: number | null;
+}): React__default.JSX.Element | null;
+interface PassageCardProps {
+    /** Left of the header row — the source affordance (document pill, page label). */
+    header: React__default.ReactNode;
+    /** Relevance score for the dot. Omit to hide it. */
+    score?: number | null;
+    /** Extra affordance pinned right of the dot (e.g. a hover-revealed open icon). */
+    headerRight?: React__default.ReactNode;
+    /** Marks the card as the currently open passage. */
+    active?: boolean;
+    onClick?: (e: React__default.MouseEvent) => void;
+    /** Rendered under the snippet, outside the click target's typography. */
+    footer?: React__default.ReactNode;
+    className?: string;
+    children: React__default.ReactNode;
+    'data-testid'?: string;
+}
+declare function PassageCard({ header, score, headerRight, active, onClick, footer, className, children, 'data-testid': testId, }: PassageCardProps): React__default.JSX.Element;
+
 /**
  * EntityPill Component
  *
@@ -557,8 +659,10 @@ interface DocumentEntityProps {
     /** Override the default folder/title hover tooltip. */
     tooltipContent?: React__default.ReactNode;
     className?: string;
+    /** Forwarded to the pill so a surface can address this document's chip. */
+    'data-testid'?: string;
 }
-declare function DocumentEntity({ doc, icon, size, labelMaxWidth, labelClassName, onClick, onIconClick, viewing, iconBadge, actions, tooltipContent, className, fullWidth, noClamp, }: DocumentEntityProps): React__default.JSX.Element;
+declare function DocumentEntity({ doc, icon, size, labelMaxWidth, labelClassName, onClick, onIconClick, viewing, iconBadge, actions, tooltipContent, className, fullWidth, noClamp, 'data-testid': testId, }: DocumentEntityProps): React__default.JSX.Element;
 
 /**
  * TagEntity Component
@@ -1112,6 +1216,103 @@ declare function getEntityColorStyles(entityId: string): {
  */
 declare const getWorkspaceColor: (workspaceId: string | undefined | null, useWorkspaceColors?: boolean) => string;
 
+interface UserMenuItem {
+    label: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    onSelect: () => void;
+    testId?: string;
+    /** A count or short state on the right (e.g. the number of files processing). */
+    badge?: string | number;
+    /** A small unread dot on the icon (e.g. new messages). */
+    dot?: boolean;
+    /** Makes the row a labelled on/off switch (role menuitemcheckbox); selecting it flips the state. */
+    checked?: boolean;
+    /** Draw a divider above this row to start a new group. */
+    separatorBefore?: boolean;
+}
+/** Connection/presence state shown as a dot on the avatar and a line under the
+ *  email — the account menu is where "am I connected" belongs. */
+interface UserMenuStatus {
+    /** Short state word — "Connected", "Working offline". */
+    label: string;
+    tone: 'online' | 'busy' | 'offline';
+    /** Fine print under the label (e.g. the server domain). */
+    detail?: string;
+    testId?: string;
+}
+interface UserMenuProps {
+    user: {
+        name: string;
+        email?: string | null;
+        picture?: string | null;
+    };
+    /** Optional connection status: avatar dot + a line in the dropdown header. */
+    status?: UserMenuStatus;
+    /** Account actions above the sign-out divider (e.g. Settings). */
+    items?: UserMenuItem[];
+    onLogout: () => void;
+    logoutLabel?: string;
+    align?: 'start' | 'center' | 'end';
+    /** Which side of the trigger the menu opens on (a footer trigger opens upward or sideways). */
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    /**
+     * `avatar` (default): avatar + chevron. `account`: a full-width account bar, avatar + display
+     * name + chevron, for a sidebar footer.
+     */
+    variant?: 'avatar' | 'account';
+    /** `avatar` only: draw the chevron (the icon-only rail hides it). */
+    showChevron?: boolean;
+    classNames?: {
+        trigger?: string;
+        fallback?: string;
+    };
+    testId?: string;
+    logoutTestId?: string;
+}
+declare function UserMenu({ user, status, items, onLogout, logoutLabel, align, side, variant, showChevron, classNames, testId, logoutTestId, }: UserMenuProps): React$1.JSX.Element;
+
+/**
+ * DocumentCard — the canonical document thumbnail tile.
+ *
+ * One tile, shared by every app: a full-bleed first-page thumbnail (falling back
+ * to the file-type icon) with the selection checkbox, the actions menu, the
+ * processing state and the document's name pill layered on top of it, rather
+ * than a thumbnail box with a separate meta strip beneath.
+ *
+ * Presentational only — it takes a thumbnail, a status and callbacks, and knows
+ * nothing about how documents are fetched. `DocumentGallery` binds it to data.
+ */
+
+interface DocumentCardProps {
+    /** The document — anything with a file name and optional metadata title. */
+    doc: DocumentLike;
+    /** First-page thumbnail (data URI or URL). Falls back to the file-type icon. */
+    thumbnailUrl?: string | null;
+    /** Processing status, e.g. `parsing` (overlay) or `completed` (corner marker). */
+    status?: string | null;
+    /** Renders the selection checkbox. Omit `onToggleSelect` to hide it entirely. */
+    selected?: boolean;
+    onToggleSelect?: () => void;
+    /** Pins the "eye" on the name pill — this is the document open in the viewer. */
+    viewing?: boolean;
+    onOpen?: () => void;
+    /** Actions menu, pinned to the tile's top-right corner. */
+    actions?: React__default.ReactNode;
+    /** Swaps the name pill for an inline rename field. */
+    renaming?: boolean;
+    onCommitRename?: (name: string) => void;
+    onCancelRename?: () => void;
+    /** Replaces the pill's default hover tooltip (e.g. an AI summary + labels). */
+    tooltipContent?: React__default.ReactNode;
+    /** Bottom-left marker slot (e.g. an "available offline" glyph). */
+    marker?: React__default.ReactNode;
+    testId?: string;
+    className?: string;
+}
+declare function DocumentCard({ doc, thumbnailUrl, status, selected, onToggleSelect, viewing, onOpen, actions, renaming, onCommitRename, onCancelRename, tooltipContent, marker, testId, className, }: DocumentCardProps): React__default.JSX.Element;
+
 /**
  * Core utility: `cn()` — merge class names with Tailwind-aware conflict
  * resolution (clsx + tailwind-merge). Copied faithfully from the ARBI app so the
@@ -1120,4 +1321,4 @@ declare const getWorkspaceColor: (workspaceId: string | undefined | null, useWor
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AgentBadge, AiMarkdown, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type DictateContextValue, DictateProvider, DocumentEntity, type DocumentEntityProps, type DocumentLike, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENTITY_MAPPINGS, EntityIcon, type EntityIconComponent, EntityPill, type EntityRegistryOverride, type EntityType, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, type IconToggleProps, Input, type InputProps, Label, MarkdownRenderer, type MarkdownRendererProps, MarkdownStreamingContext, NEUTRAL_GRAY, PLACEHOLDER_COLOR, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type PresenceDisplayStatus, PresenceLabel, Progress, ProjectEntity, type ProjectEntityProps, type ProjectRelation, RadioGroup, RadioGroupItem, type Rag, RagDot, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, type StatusBadgeComponent, type StatusBadgeProps, StatusPill, type StatusPillProps, type StatusVariant, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, type TagEntityProps, type TagLike, Textarea, type TextareaProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, type UserEntityProps, VISIBILITY_ICONS, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, cn, configureEntityRegistry, configureRagLabels, configureStatusRegistry, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, markdownBaseComponents, splitMarkdownBlocks, toggleVariants };
+export { AgentBadge, AiMarkdown, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogPresentation, DialogTitle, DialogTrigger, type DictateContextValue, DictateProvider, DocumentCard, type DocumentCardProps, DocumentEntity, type DocumentEntityProps, type DocumentLike, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENTITY_MAPPINGS, EntityIcon, type EntityIconComponent, EntityPill, type EntityRegistryOverride, type EntityType, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, type IconToggleProps, Input, type InputProps, Label, MarkMenu, type MarkMenuItem, type MarkMenuProps, MarkdownRenderer, type MarkdownRendererProps, MarkdownStreamingContext, NEUTRAL_GRAY, PLACEHOLDER_COLOR, PassageCard, type PassageCardProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type PresenceDisplayStatus, PresenceLabel, Progress, ProjectEntity, type ProjectEntityProps, type ProjectRelation, RadioGroup, RadioGroupItem, type Rag, RagDot, RelevanceDot, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, type StatusBadgeComponent, type StatusBadgeProps, StatusPill, type StatusPillProps, type StatusVariant, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, type TagEntityProps, type TagLike, Textarea, type TextareaProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, type UserEntityProps, UserMenu, type UserMenuItem, type UserMenuProps, type UserMenuStatus, VISIBILITY_ICONS, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, cn, configureEntityRegistry, configureRagLabels, configureStatusRegistry, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, markdownBaseComponents, splitMarkdownBlocks, toggleVariants };

package/dist/ui/index.d.ts

@@ -1,6 +1,6 @@
 import { ClassValue } from 'clsx';
 import * as React$1 from 'react';
-import React__default, { ComponentType, ReactNode } from 'react';
+import React__default, { HTMLAttributes, ReactNode, Ref, ComponentType } from 'react';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
@@ -60,6 +60,8 @@ declare function TooltipTrigger({ asChild, children, ...props }: TooltipTriggerP
 interface TooltipContentProps extends React$1.HTMLAttributes<HTMLDivElement> {
     side?: Side;
     sideOffset?: number;
+    /** Minimum gap, in px, kept between the tip and the viewport edges. Default 8. */
+    collisionPadding?: number;
 }
 declare const TooltipContent: React$1.ForwardRefExoticComponent<TooltipContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -248,8 +250,17 @@ declare const DialogTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.D
 declare const DialogPortal: React$1.FC<DialogPrimitive.DialogPortalProps>;
 declare const DialogClose: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DialogOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Where the dialog sits on a PHONE (< 640px). Wider screens always get a centred dialog.
+ *  - `center`: centred box with a 1rem margin (small prompts and confirmations).
+ *  - `sheet`: bottom sheet, full width, rounded top corners (forms and pickers).
+ *  - `full`: full-height sheet that stops below the status bar (large editors, wizards).
+ */
+type DialogPresentation = 'center' | 'sheet' | 'full';
 declare const DialogContent: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & {
     hideCloseButton?: boolean;
+    /** Phone presentation (see {@link DialogPresentation}). Defaults to `center`. */
+    presentation?: DialogPresentation;
 } & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
     ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
@@ -269,6 +280,51 @@ declare const PopoverContent: React$1.ForwardRefExoticComponent<Omit<PopoverPrim
     container?: HTMLElement | null;
 } & React$1.RefAttributes<HTMLDivElement>>;
 
+/** One row of a mark's menu. Give it `onSelect`, or an `href` for a real link row. */
+interface MarkMenuItem {
+    id: string;
+    label: string;
+    /** Runs when the row is chosen; the menu closes afterwards. */
+    onSelect?: () => void;
+    /** Renders the row as a link (no `onSelect` needed). */
+    href?: string;
+    /** The headline action: listed first, set a little larger, and run by a plain mouse click. */
+    primary?: boolean;
+    destructive?: boolean;
+    testId?: string;
+}
+interface MarkMenuProps extends Omit<HTMLAttributes<HTMLElement>, 'children' | 'onClick'> {
+    /** The element the mark itself is: a real link or an inline span. */
+    as?: 'a' | 'span';
+    href?: string;
+    /** Rows of the menu. The `primary` one (else the first) is the mark's default action. */
+    items: MarkMenuItem[];
+    /** Optional read-only content above the rows (a quoted passage, a note, a label name). */
+    preview?: ReactNode;
+    /** Accessible name of the menu. */
+    menuLabel: string;
+    /** A plain mouse click runs the primary row (default). Touch and keyboard always open the menu. */
+    shouldClickRunPrimary?: boolean;
+    /** Hover delay before the menu opens (ms). */
+    openDelay?: number;
+    closeDelay?: number;
+    testId?: string;
+    menuTestId?: string;
+    /** The mark element, for hosts that move focus back to it. */
+    triggerRef?: Ref<HTMLElement>;
+    children: ReactNode;
+}
+/**
+ * The ONE contextual menu of every inline mark (link, bookmark, citation, label, note).
+ *
+ * The mark stays quiet text. A compact popover opens on hover (short delay) and on keyboard focus;
+ * on touch a tap opens it instead of acting, so the primary row is one deliberate tap away. A
+ * plain mouse click runs the primary action, so existing click behaviour is unchanged.
+ * Keyboard: Enter/Space/ArrowDown open it and move into it, arrows move, Escape closes and
+ * returns focus to the mark. Rows are 44px high on coarse pointers.
+ */
+declare function MarkMenu({ as, href, items, preview, menuLabel, shouldClickRunPrimary, openDelay, closeDelay, testId, menuTestId, triggerRef: externalRef, className, children, onPointerDown, onPointerEnter, onPointerLeave, onFocus, onBlur, onKeyDown, ...rest }: MarkMenuProps): React$1.JSX.Element;
+
 declare const DropdownMenu: React$1.FC<DropdownMenuPrimitive.DropdownMenuProps>;
 declare const DropdownMenuTrigger: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DropdownMenuGroup: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuGroupProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -439,6 +495,52 @@ declare function AiMarkdown({ children, className, isStreaming, }: {
  */
 declare const markdownBaseComponents: Partial<Components>;
 
+/**
+ * PassageCard — the card ("bubble") a single retrieved passage is rendered as.
+ *
+ * One presentation shared by every surface that lists retrieval hits: the
+ * <SemanticSearch> block here and the ARBI-frontend monolith's SmartSearch
+ * results. Those had drifted into two different looks for the same object; this
+ * is the single one.
+ *
+ * The card owns the chrome only — the rounded border, the AI-accent hover /
+ * focus / selected states, the header row and the relevance dot. What goes in
+ * the header and how the snippet itself is rendered stays with the caller,
+ * because those genuinely differ: the block shows a plain-text excerpt in a
+ * narrow sidebar, the monolith renders markdown with a show-more toggle.
+ *
+ * Theming is semantic tokens only (shadcn + the AI-accent contract).
+ */
+
+/**
+ * A dot conveying relevance — green (high) / amber (mid) / muted (low).
+ *
+ * The band is shown, the raw number is not: scores are not on a normalized 0-1
+ * scale across search modes (BM25 keyword scores can exceed 1), so a printed
+ * figure invites a comparison it cannot support. The value is kept in the
+ * tooltip for anyone debugging a ranking.
+ */
+declare function RelevanceDot({ score }: {
+    score?: number | null;
+}): React__default.JSX.Element | null;
+interface PassageCardProps {
+    /** Left of the header row — the source affordance (document pill, page label). */
+    header: React__default.ReactNode;
+    /** Relevance score for the dot. Omit to hide it. */
+    score?: number | null;
+    /** Extra affordance pinned right of the dot (e.g. a hover-revealed open icon). */
+    headerRight?: React__default.ReactNode;
+    /** Marks the card as the currently open passage. */
+    active?: boolean;
+    onClick?: (e: React__default.MouseEvent) => void;
+    /** Rendered under the snippet, outside the click target's typography. */
+    footer?: React__default.ReactNode;
+    className?: string;
+    children: React__default.ReactNode;
+    'data-testid'?: string;
+}
+declare function PassageCard({ header, score, headerRight, active, onClick, footer, className, children, 'data-testid': testId, }: PassageCardProps): React__default.JSX.Element;
+
 /**
  * EntityPill Component
  *
@@ -557,8 +659,10 @@ interface DocumentEntityProps {
     /** Override the default folder/title hover tooltip. */
     tooltipContent?: React__default.ReactNode;
     className?: string;
+    /** Forwarded to the pill so a surface can address this document's chip. */
+    'data-testid'?: string;
 }
-declare function DocumentEntity({ doc, icon, size, labelMaxWidth, labelClassName, onClick, onIconClick, viewing, iconBadge, actions, tooltipContent, className, fullWidth, noClamp, }: DocumentEntityProps): React__default.JSX.Element;
+declare function DocumentEntity({ doc, icon, size, labelMaxWidth, labelClassName, onClick, onIconClick, viewing, iconBadge, actions, tooltipContent, className, fullWidth, noClamp, 'data-testid': testId, }: DocumentEntityProps): React__default.JSX.Element;
 
 /**
  * TagEntity Component
@@ -1112,6 +1216,103 @@ declare function getEntityColorStyles(entityId: string): {
  */
 declare const getWorkspaceColor: (workspaceId: string | undefined | null, useWorkspaceColors?: boolean) => string;
 
+interface UserMenuItem {
+    label: string;
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    onSelect: () => void;
+    testId?: string;
+    /** A count or short state on the right (e.g. the number of files processing). */
+    badge?: string | number;
+    /** A small unread dot on the icon (e.g. new messages). */
+    dot?: boolean;
+    /** Makes the row a labelled on/off switch (role menuitemcheckbox); selecting it flips the state. */
+    checked?: boolean;
+    /** Draw a divider above this row to start a new group. */
+    separatorBefore?: boolean;
+}
+/** Connection/presence state shown as a dot on the avatar and a line under the
+ *  email — the account menu is where "am I connected" belongs. */
+interface UserMenuStatus {
+    /** Short state word — "Connected", "Working offline". */
+    label: string;
+    tone: 'online' | 'busy' | 'offline';
+    /** Fine print under the label (e.g. the server domain). */
+    detail?: string;
+    testId?: string;
+}
+interface UserMenuProps {
+    user: {
+        name: string;
+        email?: string | null;
+        picture?: string | null;
+    };
+    /** Optional connection status: avatar dot + a line in the dropdown header. */
+    status?: UserMenuStatus;
+    /** Account actions above the sign-out divider (e.g. Settings). */
+    items?: UserMenuItem[];
+    onLogout: () => void;
+    logoutLabel?: string;
+    align?: 'start' | 'center' | 'end';
+    /** Which side of the trigger the menu opens on (a footer trigger opens upward or sideways). */
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    /**
+     * `avatar` (default): avatar + chevron. `account`: a full-width account bar, avatar + display
+     * name + chevron, for a sidebar footer.
+     */
+    variant?: 'avatar' | 'account';
+    /** `avatar` only: draw the chevron (the icon-only rail hides it). */
+    showChevron?: boolean;
+    classNames?: {
+        trigger?: string;
+        fallback?: string;
+    };
+    testId?: string;
+    logoutTestId?: string;
+}
+declare function UserMenu({ user, status, items, onLogout, logoutLabel, align, side, variant, showChevron, classNames, testId, logoutTestId, }: UserMenuProps): React$1.JSX.Element;
+
+/**
+ * DocumentCard — the canonical document thumbnail tile.
+ *
+ * One tile, shared by every app: a full-bleed first-page thumbnail (falling back
+ * to the file-type icon) with the selection checkbox, the actions menu, the
+ * processing state and the document's name pill layered on top of it, rather
+ * than a thumbnail box with a separate meta strip beneath.
+ *
+ * Presentational only — it takes a thumbnail, a status and callbacks, and knows
+ * nothing about how documents are fetched. `DocumentGallery` binds it to data.
+ */
+
+interface DocumentCardProps {
+    /** The document — anything with a file name and optional metadata title. */
+    doc: DocumentLike;
+    /** First-page thumbnail (data URI or URL). Falls back to the file-type icon. */
+    thumbnailUrl?: string | null;
+    /** Processing status, e.g. `parsing` (overlay) or `completed` (corner marker). */
+    status?: string | null;
+    /** Renders the selection checkbox. Omit `onToggleSelect` to hide it entirely. */
+    selected?: boolean;
+    onToggleSelect?: () => void;
+    /** Pins the "eye" on the name pill — this is the document open in the viewer. */
+    viewing?: boolean;
+    onOpen?: () => void;
+    /** Actions menu, pinned to the tile's top-right corner. */
+    actions?: React__default.ReactNode;
+    /** Swaps the name pill for an inline rename field. */
+    renaming?: boolean;
+    onCommitRename?: (name: string) => void;
+    onCancelRename?: () => void;
+    /** Replaces the pill's default hover tooltip (e.g. an AI summary + labels). */
+    tooltipContent?: React__default.ReactNode;
+    /** Bottom-left marker slot (e.g. an "available offline" glyph). */
+    marker?: React__default.ReactNode;
+    testId?: string;
+    className?: string;
+}
+declare function DocumentCard({ doc, thumbnailUrl, status, selected, onToggleSelect, viewing, onOpen, actions, renaming, onCommitRename, onCancelRename, tooltipContent, marker, testId, className, }: DocumentCardProps): React__default.JSX.Element;
+
 /**
  * Core utility: `cn()` — merge class names with Tailwind-aware conflict
  * resolution (clsx + tailwind-merge). Copied faithfully from the ARBI app so the
@@ -1120,4 +1321,4 @@ declare const getWorkspaceColor: (workspaceId: string | undefined | null, useWor
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AgentBadge, AiMarkdown, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type DictateContextValue, DictateProvider, DocumentEntity, type DocumentEntityProps, type DocumentLike, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENTITY_MAPPINGS, EntityIcon, type EntityIconComponent, EntityPill, type EntityRegistryOverride, type EntityType, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, type IconToggleProps, Input, type InputProps, Label, MarkdownRenderer, type MarkdownRendererProps, MarkdownStreamingContext, NEUTRAL_GRAY, PLACEHOLDER_COLOR, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type PresenceDisplayStatus, PresenceLabel, Progress, ProjectEntity, type ProjectEntityProps, type ProjectRelation, RadioGroup, RadioGroupItem, type Rag, RagDot, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, type StatusBadgeComponent, type StatusBadgeProps, StatusPill, type StatusPillProps, type StatusVariant, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, type TagEntityProps, type TagLike, Textarea, type TextareaProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, type UserEntityProps, VISIBILITY_ICONS, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, cn, configureEntityRegistry, configureRagLabels, configureStatusRegistry, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, markdownBaseComponents, splitMarkdownBlocks, toggleVariants };
+export { AgentBadge, AiMarkdown, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogPresentation, DialogTitle, DialogTrigger, type DictateContextValue, DictateProvider, DocumentCard, type DocumentCardProps, DocumentEntity, type DocumentEntityProps, type DocumentLike, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENTITY_MAPPINGS, EntityIcon, type EntityIconComponent, EntityPill, type EntityRegistryOverride, type EntityType, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, type IconToggleProps, Input, type InputProps, Label, MarkMenu, type MarkMenuItem, type MarkMenuProps, MarkdownRenderer, type MarkdownRendererProps, MarkdownStreamingContext, NEUTRAL_GRAY, PLACEHOLDER_COLOR, PassageCard, type PassageCardProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type PresenceDisplayStatus, PresenceLabel, Progress, ProjectEntity, type ProjectEntityProps, type ProjectRelation, RadioGroup, RadioGroupItem, type Rag, RagDot, RelevanceDot, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, type StatusBadgeComponent, type StatusBadgeProps, StatusPill, type StatusPillProps, type StatusVariant, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, type TagEntityProps, type TagLike, Textarea, type TextareaProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, type UserEntityProps, UserMenu, type UserMenuItem, type UserMenuProps, type UserMenuStatus, VISIBILITY_ICONS, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, cn, configureEntityRegistry, configureRagLabels, configureStatusRegistry, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, markdownBaseComponents, splitMarkdownBlocks, toggleVariants };

package/dist/ui/index.js

@@ -1,3 +1,4 @@
-export { AgentBadge, AiMarkdown, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DictateProvider, DocumentEntity, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENTITY_MAPPINGS, EntityIcon, EntityPill, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, Input, Label, MarkdownRenderer, MarkdownStreamingContext, NEUTRAL_GRAY, PLACEHOLDER_COLOR, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PresenceLabel, Progress, ProjectEntity, RadioGroup, RadioGroupItem, RagDot, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, StatusPill, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, VISIBILITY_ICONS, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, cn, configureEntityRegistry, configureRagLabels, configureStatusRegistry, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, markdownBaseComponents, splitMarkdownBlocks, toggleVariants } from '../chunk-YJAYST7S.js';
+export { AgentBadge, AiMarkdown, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DictateProvider, DocumentCard, DocumentEntity, ENTITY_MAPPINGS, EntityIcon, EntityPill, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, Input, Label, MarkMenu, MarkdownRenderer, MarkdownStreamingContext, NEUTRAL_GRAY, PLACEHOLDER_COLOR, PassageCard, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PresenceLabel, Progress, ProjectEntity, RadioGroup, RadioGroupItem, RagDot, RelevanceDot, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, StatusPill, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, UserMenu, VISIBILITY_ICONS, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, configureEntityRegistry, configureRagLabels, configureStatusRegistry, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, markdownBaseComponents, splitMarkdownBlocks, toggleVariants } from '../chunk-3CLGHHME.js';
+export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ScrollArea, ScrollBar, cn } from '../chunk-6ALMBER7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map