@arbidocs/react 0.3.100 → 0.3.101

package/dist/index.d.ts

@@ -1,14 +1,21 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
+import * as React from 'react';
+import React__default, { ReactNode } from 'react';
 import { ArbiOptions, Arbi, SSEStreamResult, SSEStreamStartData, AgentStepEvent } from '@arbidocs/sdk/browser';
 export { AgentStepEvent, Arbi, ArbiError, ArbiOptions, ArtifactEvent, MessageMetadataPayload, OutputTokensDetails, QueryOptions, ResponseCompletedEvent, ResponseContentPartAddedEvent, ResponseCreatedEvent, ResponseFailedEvent, ResponseOutputItemAddedEvent, ResponseOutputItemDoneEvent, ResponseOutputTextDeltaEvent, ResponseOutputTextDoneEvent, ResponseUsage, SSEStreamCallbacks, SSEStreamResult, SSEStreamStartData, UserInputRequestEvent, UserMessageEvent } from '@arbidocs/sdk/browser';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import * as _arbidocs_client from '@arbidocs/client';
+import { components } from '@arbidocs/client';
+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';
+import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
+import * as zustand from 'zustand';
+import { ClassValue } from 'clsx';
 
 interface ArbiProviderProps extends ArbiOptions {
     children: ReactNode;
 }
-declare function ArbiProvider({ children, ...options }: ArbiProviderProps): react.JSX.Element;
+declare function ArbiProvider({ children, ...options }: ArbiProviderProps): React.JSX.Element;
 
 interface ArbiChatTheme {
     /** Primary action color — buttons, links (default: '#00adef' ARBI cyan) */
@@ -111,6 +118,35 @@ interface ArbiChatProps {
     height?: string | number;
 }
 
+/** Props for {@link ArbiChatPanel} — the provider-less embeddable panel. */
+interface ArbiChatPanelProps {
+    /** Skip workspace selection — go straight to chat */
+    workspaceId?: string;
+    /** Customize colors and appearance */
+    theme?: Partial<ArbiChatTheme>;
+    /** Customize text labels */
+    labels?: ArbiChatLabels;
+    /** Widget width (default: '100%') */
+    width?: string | number;
+    /** Widget height (default: '100%') */
+    height?: string | number;
+}
+/**
+ * The ARBI chat panel **without** its own providers.
+ *
+ * Drop it inside an app that already renders `<ArbiProvider>` and a
+ * `<QueryClientProvider>` to reuse the host's authenticated session — no second
+ * login. When the ambient session is already signed in, the panel skips the
+ * login screen and opens straight into chat.
+ *
+ * ```tsx
+ * // inside your authenticated app tree
+ * <ArbiChatPanel workspaceId="wrk-…" theme={myTheme} />
+ * ```
+ *
+ * For a fully self-contained widget (its own providers + login), use {@link ArbiChat}.
+ */
+declare function ArbiChatPanel({ workspaceId, theme: themeOverrides, labels: labelOverrides, width, height, }: ArbiChatPanelProps): React.JSX.Element;
 /**
  * Self-contained ARBI chat widget.
  *
@@ -123,7 +159,7 @@ interface ArbiChatProps {
  * <ArbiChat url="https://www.arbidocs.com" />
  * ```
  */
-declare function ArbiChat({ url, workspaceId, theme: themeOverrides, labels: labelOverrides, width, height, }: ArbiChatProps): react.JSX.Element;
+declare function ArbiChat({ url, workspaceId, theme: themeOverrides, labels: labelOverrides, width, height, }: ArbiChatProps): React.JSX.Element;
 
 /**
  * Hook to access the Arbi instance from the nearest ArbiProvider.
@@ -341,4 +377,356 @@ declare function useHealth(options?: {
     available_models: string[];
 }>, Error>;
 
-export { ArbiChat, type ArbiChatLabels, type ArbiChatProps, type ArbiChatTheme, ArbiProvider, type ArbiProviderProps, arbiQueryKeys, useAgents, useArbi, useAssistantQuery, useConversations, useDeleteAgents, useDocuments, useHealth, useSessions, useTags, useWorkspaces };
+/**
+ * Minimal, dependency-free tooltip — a drop-in API replacement for a Radix
+ * wrapper (same exports/props: Tooltip, TooltipTrigger, TooltipContent,
+ * TooltipProvider). Promoted verbatim from the ARBI app.
+ *
+ * It attaches the trigger via a STABLE `useCallback` ref (never setStates,
+ * identity never changes), so React 19 never detach/attach-thrashes.
+ */
+type Side = 'top' | 'bottom' | 'left' | 'right';
+interface TooltipProviderProps {
+    children?: React.ReactNode;
+    delayDuration?: number;
+    skipDelayDuration?: number;
+    disableHoverableContent?: boolean;
+}
+declare const TooltipProvider: ({ children }: TooltipProviderProps) => React.JSX.Element;
+interface TooltipProps {
+    children: React.ReactNode;
+    delayDuration?: number;
+}
+declare function Tooltip({ children, delayDuration }: TooltipProps): React.JSX.Element;
+interface TooltipTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    asChild?: boolean;
+}
+declare function TooltipTrigger({ asChild, children, ...props }: TooltipTriggerProps): React.JSX.Element;
+interface TooltipContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    side?: Side;
+    sideOffset?: number;
+}
+declare const TooltipContent: React.ForwardRefExoticComponent<TooltipContentProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const Avatar: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React.RefAttributes<HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+declare const AvatarImage: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarImageProps & React.RefAttributes<HTMLImageElement>, "ref"> & React.RefAttributes<HTMLImageElement>>;
+declare const AvatarFallback: React.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarFallbackProps & React.RefAttributes<HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+
+declare const badgeVariants: (props?: ({
+    variant?: "outline" | "default" | "secondary" | "destructive" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
+}
+declare function Badge({ className, variant, ...props }: BadgeProps): React.JSX.Element;
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "outline" | "default" | "secondary" | "destructive" | "ghost" | null | undefined;
+    size?: "default" | "icon" | "sm" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+}
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
+declare const HoverCard: React.FC<HoverCardPrimitive.HoverCardProps>;
+declare const HoverCardTrigger: React.ForwardRefExoticComponent<HoverCardPrimitive.HoverCardTriggerProps & React.RefAttributes<HTMLAnchorElement>>;
+declare const HoverCardContent: React.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
+/** PDF file icon (red). Promoted from the ARBI app for SDK reuse. */
+
+interface IconProps$5 {
+    size?: number;
+    className?: string;
+}
+declare const PdfIcon: React__default.FC<IconProps$5>;
+
+/** Audio file icon (amber). Promoted from the ARBI app for SDK reuse. */
+
+interface IconProps$4 {
+    size?: number;
+    className?: string;
+}
+declare const AudIcon: React__default.FC<IconProps$4>;
+
+/** Image file icon (violet). Promoted from the ARBI app for SDK reuse. */
+
+interface IconProps$3 {
+    size?: number;
+    className?: string;
+}
+declare const ImgIcon: React__default.FC<IconProps$3>;
+
+/** Video file icon (emerald). Promoted from the ARBI app for SDK reuse. */
+
+interface IconProps$2 {
+    size?: number;
+    className?: string;
+}
+declare const VidIcon: React__default.FC<IconProps$2>;
+
+/** Email file icon (teal). Promoted from the ARBI app for SDK reuse. */
+
+interface IconProps$1 {
+    size?: number;
+    className?: string;
+}
+declare const EmlIcon: React__default.FC<IconProps$1>;
+
+/** Generic file icon (gray, question mark). Promoted from the ARBI app. */
+
+interface IconProps {
+    size?: number;
+    className?: string;
+}
+declare const FileIcon: React__default.FC<IconProps>;
+
+/**
+ * File-type icon colors — the subset of the app's FILE_TYPE_COLORS used by the
+ * promoted file-type icons. Kept self-contained so the SDK icons render with the
+ * same palette as the ARBI app without depending on the app's style constants.
+ */
+declare const FILE_TYPE_COLORS: {
+    pdf: string;
+    img: string;
+    vid: string;
+    aud: string;
+    eml: string;
+    generic: string;
+    white: string;
+};
+
+/**
+ * EntityPill Component
+ *
+ * Base component for pill-style entity displays. Provides consistent styling and
+ * interaction patterns. Promoted verbatim from the ARBI app (import paths only
+ * changed to resolve within the SDK).
+ *
+ * Pattern: [Icon] [Label] [Optional: secondary text] [MoreVertical when interactive]
+ */
+
+interface EntityPillProps {
+    /** The icon element (Avatar, ShieldIcon, FileIcon, etc.) */
+    icon: React__default.ReactNode;
+    /** Primary label text */
+    label: string;
+    /** Optional secondary text (e.g., page notation "p.1") */
+    secondaryText?: React__default.ReactNode;
+    /** Size variant: 'sm' for compact, 'base' for tab headers */
+    size?: 'sm' | 'base';
+    /** Shape variant: 'pill' for rounded-full, 'rounded' for rounded-md */
+    shape?: 'pill' | 'rounded';
+    /** Additional CSS classes */
+    className?: string;
+    /** Max width for label truncation */
+    labelMaxWidth?: string;
+    /** When true, the pill fills its container width (`flex w-full`) and the main
+     *  area flexes + truncates so the trailing control (⋯ menu) pins to the right
+     *  edge — used by the documents table's Document column. Default: shrink-to-fit. */
+    fullWidth?: boolean;
+    /** When true, render the pill with the active/"viewing" highlight — a solid
+     *  dark-navy background with light text, applied LAST so it wins over both the
+     *  default background and the interactive hover. */
+    highlight?: boolean;
+    /** Click handler for main area (icon + label) - primary action */
+    onClick?: (e: React__default.MouseEvent) => void;
+    /** Click handler for icon only — when set, only the icon is clickable (not the label) */
+    onIconClick?: (e: React__default.MouseEvent) => void;
+    /** Click handler for MoreVertical - opens popover/menu. When provided, shows MoreVertical icon */
+    onMoreClick?: (e: React__default.MouseEvent) => void;
+    /** Custom trailing element (e.g. a ⋯ dropdown menu). Rendered in the same
+     *  trailing zone as MoreVertical, but as-is — so it stays outside the pill's
+     *  primary click area. Takes precedence over `onMoreClick`. */
+    moreContent?: React__default.ReactNode;
+    /** Link URL - makes the main area an anchor tag */
+    href?: string;
+    /** Whether the pill is disabled */
+    disabled?: boolean;
+    /** Tooltip for main area (describes primary action, e.g., "View document") */
+    tooltipContent?: React__default.ReactNode;
+    /** Tooltip side placement */
+    tooltipSide?: 'top' | 'bottom' | 'left' | 'right';
+    /** Test ID for testing */
+    'data-testid'?: string;
+}
+declare const EntityPill: React__default.ForwardRefExoticComponent<EntityPillProps & React__default.RefAttributes<HTMLElement>>;
+
+/**
+ * DocumentEntity Component
+ *
+ * Displays a document as a compact entity pill with file-type icon and name.
+ * Promoted from the ARBI app and DECOUPLED from the app store/API: it renders
+ * purely from the `doc` prop and optional `onClick`/`onIconClick` callbacks.
+ */
+
+/** Minimal, decoupled document shape the pill needs. Structurally compatible
+ *  with the SDK's `DocResponse` (from `useDocuments`), but no dependency on it —
+ *  a consumer can pass any object with these fields. */
+interface DocumentLike {
+    file_name?: string | null;
+    folder?: string | null;
+    doc_metadata?: {
+        title?: string | null;
+    } | null;
+}
+interface DocumentEntityProps {
+    doc: DocumentLike;
+    /** Override the default file-type icon */
+    icon?: React__default.ReactNode;
+    /** Size variant — 'sm' (default) for inline/compact contexts, 'base' for a
+     *  larger pill (e.g. the documents grid's primary name column). */
+    size?: 'sm' | 'base';
+    /** Override default label max width */
+    labelMaxWidth?: string;
+    /** Click handler for the whole pill */
+    onClick?: (e: React__default.MouseEvent) => void;
+    /** Click handler for the icon only */
+    onIconClick?: (e: React__default.MouseEvent) => void;
+    /** When true, the file-type icon swaps to an Eye on pill hover — a cue that
+     *  clicking opens (view) the document. */
+    showHoverEye?: boolean;
+    /** When true, the Eye is pinned on (not just hover) — marks the document that
+     *  is currently open/being viewed. Implies the hover-swap behaviour. */
+    viewing?: boolean;
+    /** Small overlay pinned to the icon's corner (e.g. an "available offline" pip). */
+    iconBadge?: React__default.ReactNode;
+    /** Trailing control rendered outside the click area (e.g. a ⋯ actions menu). */
+    actions?: React__default.ReactNode;
+    /** When true, the pill fills the available width and the name truncates via
+     *  CSS so the trailing ⋯ menu pins to the right edge. */
+    fullWidth?: boolean;
+    /** Override the default folder/title hover tooltip. */
+    tooltipContent?: React__default.ReactNode;
+    className?: string;
+}
+declare function DocumentEntity({ doc, icon, size, labelMaxWidth, onClick, onIconClick, showHoverEye, viewing, iconBadge, actions, tooltipContent, className, fullWidth, }: DocumentEntityProps): React__default.JSX.Element;
+
+/**
+ * TagEntity Component
+ *
+ * Single source of truth for tag visual appearance, promoted from the ARBI app
+ * and DECOUPLED from the app store/API. It renders purely from the `tag` prop —
+ * the app-only bits (creator/updater lookup, visibility toggle, live doctag
+ * count from the query cache) are dropped; pass `doctagCount`/`shared` if you
+ * want them shown in the tooltip.
+ */
+
+/** Minimal, decoupled tag shape the pill needs. */
+interface TagLike {
+    external_id: string;
+    name: string;
+    /** Tag type discriminator — drives the icon and the tooltip's "Type" line. */
+    tag_type?: {
+        type: string;
+    } | null;
+    /** Optional explicit color; when omitted it's derived from `external_id`. */
+    color?: string;
+    /** Optional document count shown in the tooltip. */
+    doctag_count?: number | null;
+    /** Optional shared/private flag shown in the tooltip. */
+    shared?: boolean | null;
+}
+interface TagEntityProps {
+    tag: TagLike;
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+    onClick?: (e: React__default.MouseEvent) => void;
+    /** Whether to show the detailed tooltip (default: true) */
+    showTooltip?: boolean;
+}
+declare function TagEntity({ tag, size, className, onClick, showTooltip, }: TagEntityProps): React__default.JSX.Element;
+
+/**
+ * ProjectEntity Component
+ *
+ * Fully-rounded pill for a "project" (a.k.a. a "matter" in some consumer apps).
+ * The viewer's relationship to the project drives an INVERTED (solid-fill)
+ * colour so the kinds read at a glance:
+ *   - your paid project   → primary
+ *   - someone else's      → secondary
+ *   - your free project   → grey
+ * "Common" keeps the neutral, non-inverted muted pill.
+ *
+ * Promoted from the ARBI app and DECOUPLED: no store/stripe deps. The icon
+ * defaults to a generic `Package` glyph and can be overridden via `icon`, and
+ * the display text via `label` (falls back to `name`) so consumers can relabel
+ * a "project" as a "matter", "case", etc.
+ */
+
+type ProjectRelation = 'mine' | 'other' | 'common';
+interface ProjectEntityProps {
+    name: string;
+    /** Display text override (defaults to `name`) — lets a consumer relabel. */
+    label?: string;
+    /** Icon override (defaults to a generic Package glyph). */
+    icon?: React__default.ReactNode;
+    subscription?: string;
+    hasCollaborators?: boolean;
+    size?: 'sm' | 'base';
+    className?: string;
+    onClick?: (e: React__default.MouseEvent) => void;
+    /** Viewer's relationship to the project — drives the inverted pill colour. */
+    relation?: ProjectRelation;
+    /** Whether the given `subscription` should be treated as paid. When omitted,
+     *  it's inferred from the `subscription` value ('active' | 'past_due' | 'dev'). */
+    isPaid?: boolean;
+    /** Hover tooltip. */
+    tooltipContent?: React__default.ReactNode;
+}
+declare function ProjectEntity({ name, label, icon, subscription, hasCollaborators, size, className, onClick, relation, isPaid, tooltipContent, }: ProjectEntityProps): React__default.JSX.Element;
+
+/**
+ * DocumentTable — a reusable AG Grid (community) block that renders a
+ * workspace's documents using the promoted entity pills.
+ *
+ * REUSE-FIRST: this composes AG Grid + `DocumentEntity`/`TagEntity` + the shadcn
+ * `Badge`; it is not a bespoke table. Data comes from the SDK `useDocuments`
+ * hook (or an explicit `documents` prop). Selection is controlled via
+ * `selectedIds`/`onSelectionChange`, falling back to the SDK-owned
+ * `useArbiUiStore` when those props are omitted.
+ */
+
+type DocResponse = components['schemas']['DocResponse'];
+interface DocumentTableProps {
+    /** Workspace to load documents from (used when `documents` is not supplied). */
+    workspaceId?: string;
+    /** Explicit rows. When provided, `useDocuments` is not called. */
+    documents?: DocResponse[];
+    /** Called when a row (document) is opened — row click or name-pill click. */
+    onOpenDocument?: (id: string) => void;
+    /** Controlled selection (external ids). Falls back to the SDK ui store. */
+    selectedIds?: string[];
+    /** Called with the new selection (external ids). Falls back to the SDK ui store. */
+    onSelectionChange?: (ids: string[]) => void;
+    /** Grid height. Number → pixels; string passed through. Default 480. */
+    height?: number | string;
+    className?: string;
+}
+declare function DocumentTable({ workspaceId, documents, onOpenDocument, selectedIds, onSelectionChange, height, className, }: DocumentTableProps): React__default.JSX.Element;
+
+/**
+ * SDK-owned UI store for cross-block coordination.
+ *
+ * This is a SMALL, decoupled zustand store (NOT the ARBI app's multi-slice
+ * store). Blocks such as `DocumentTable` use it as a fallback for selection /
+ * "viewing" state when the consumer does not drive that state via props.
+ */
+interface ArbiUiState {
+    /** External ids of the currently selected documents. */
+    selectedDocIds: string[];
+    setSelectedDocIds: (ids: string[]) => void;
+    /** External id of the document currently being viewed/opened, if any. */
+    viewingDocId: string | null;
+    setViewingDocId: (id: string | null) => void;
+}
+declare const useArbiUiStore: zustand.UseBoundStore<zustand.StoreApi<ArbiUiState>>;
+
+/**
+ * Core utility: `cn()` — merge class names with Tailwind-aware conflict
+ * resolution (clsx + tailwind-merge). Copied faithfully from the ARBI app so the
+ * promoted "lego" components style identically in a consumer app.
+ */
+
+declare function cn(...inputs: ClassValue[]): string;
+
+export { ArbiChat, type ArbiChatLabels, ArbiChatPanel, type ArbiChatPanelProps, type ArbiChatProps, type ArbiChatTheme, ArbiProvider, type ArbiProviderProps, type ArbiUiState, AudIcon, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, type ButtonProps, DocumentEntity, type DocumentEntityProps, type DocumentLike, DocumentTable, type DocumentTableProps, EmlIcon, EntityPill, FILE_TYPE_COLORS, FileIcon, HoverCard, HoverCardContent, HoverCardTrigger, ImgIcon, PdfIcon, ProjectEntity, type ProjectEntityProps, type ProjectRelation, TagEntity, type TagEntityProps, type TagLike, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, VidIcon, arbiQueryKeys, badgeVariants, buttonVariants, cn, useAgents, useArbi, useArbiUiStore, useAssistantQuery, useConversations, useDeleteAgents, useDocuments, useHealth, useSessions, useTags, useWorkspaces };