@brainfish-ai/components 0.23.10 → 0.23.13

package/dist/index.d.ts

@@ -5,6 +5,11 @@ import { ClassProp } from 'class-variance-authority/types';
 import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
 import { ColumnDef } from '@tanstack/react-table';
 import { ComponentProps } from 'react';
+import { ConversationActionsProps } from './ConversationActions';
+import { ConversationInputProps } from './ConversationInput';
+import { ConversationLoadingProps } from './ConversationLoading';
+import { ConversationMessagesProps } from './ConversationMessages';
+import { ConversationSuggestionsProps } from './ConversationSuggestions';
 import { DayPicker } from 'react-day-picker';
 import { default as default_2 } from 'react';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
@@ -129,6 +134,11 @@ declare type ActionButtonsBlock = {
     type: 'action-buttons';
 };
 
+export declare type ActionButtonsPart = {
+    type: 'action-buttons';
+    actions: ConversationAction[];
+};
+
 declare type ActionInput = {
     name: string;
     required: boolean;
@@ -347,9 +357,31 @@ declare type AppendNewAnswer = {
 export declare interface ArticleNavItem extends Omit<SidebarNavItem, 'Icon' | 'items'> {
     status?: 'discovery' | 'unpublished' | 'draft';
     hasChildren?: boolean;
+    isLoadingChildren?: boolean;
     items?: ArticleNavItem[];
 }
 
+export declare type Attachment = {
+    id: string;
+    type: 'image' | 'file';
+    name: string;
+    url: string;
+    file?: File;
+};
+
+export declare type AttachmentAction = {
+    type: 'select-collection';
+    collection: Collection_2;
+} | {
+    type: 'attach-tab';
+} | {
+    type: 'screenshot';
+} | {
+    type: 'record-video';
+} | {
+    type: 'add-file';
+};
+
 declare type AttachmentType = 'image' | 'file';
 
 export declare function Avatar({ className, size, ...props }: React_2.ComponentProps<typeof AvatarPrimitive.Root> & {
@@ -626,7 +658,7 @@ export declare interface ChatSearchHandle {
 }
 
 export declare interface ChatSearchProps {
-    suggestions?: Suggestion[];
+    suggestions?: Suggestion_2[];
     collections?: Array<Collection>;
     selectedCollectionId?: string;
     onCollectionChange?: (collectionId: string) => void;
@@ -695,6 +727,18 @@ export declare interface ChatSearchState {
     error?: string;
 }
 
+export declare type Citation = {
+    id: string;
+    index: number;
+    title: string;
+    url: string;
+};
+
+export declare type CitationPart = {
+    type: 'citation';
+    citations: Citation[];
+};
+
 declare type ClearAll = {
     type: typeof AnswersActions.CLEAR_ALL;
 };
@@ -726,6 +770,11 @@ export declare interface Collection {
     siteEnabled?: boolean;
 }
 
+declare type Collection_2 = {
+    id: string;
+    label: string;
+};
+
 export declare function Combobox<T extends ComboboxItem = ComboboxItem>({ options, defaultValueLabel, placeholder, noResultsLabel, className, onOpenChange, onChange, dropdownWidth, value: controlledValue, disabled, renderItem, renderValue, renderTrigger, }: ComboboxProps<T>): React_2.JSX.Element;
 
 export declare interface ComboboxItem {
@@ -871,16 +920,139 @@ declare namespace Compounds {
     }
 }
 
+export declare type ContextPill = {
+    id: string;
+    label: string;
+    icon?: string;
+};
+
+export declare const ContextPillBadge: ({ pill, onRemove }: ContextPillBadgeProps) => default_2.JSX.Element;
+
+declare interface ContextPillBadgeProps {
+    pill: ContextPill;
+    onRemove?: (pill: ContextPill) => void;
+}
+
+export declare const Conversation: (({ messages, callbacks, children, suggestions, actions, placeholder, attachments, collections, contextPills, showBranding, className, }: ConversationProps) => default_2.JSX.Element) & {
+    Messages: ({ className, bottomPadding, onContentBehind }: ConversationMessagesProps) => default_2.JSX.Element;
+    Input: ({ placeholder, attachments, collections, contextPills, disabled, isElevated, className, }: ConversationInputProps) => default_2.JSX.Element;
+    Suggestions: ({ items, className }: ConversationSuggestionsProps) => default_2.JSX.Element | null;
+    Actions: ({ actions, onActionClick, className }: ConversationActionsProps) => default_2.JSX.Element | null;
+    Loading: ({ className }: ConversationLoadingProps) => default_2.JSX.Element;
+};
+
+export declare type ConversationAction = {
+    id: string;
+    label: string;
+    icon?: string;
+    description?: string;
+};
+
+export declare const ConversationActions: ({ actions, onActionClick, className }: ConversationActionsProps_2) => default_2.JSX.Element | null;
+
+declare interface ConversationActionsProps_2 {
+    actions: ConversationAction[];
+    onActionClick?: (action: ConversationAction) => void;
+    className?: string;
+}
+
+export declare type ConversationCallbacks = {
+    onSend?: (text: string, attachments?: Attachment[]) => void;
+    onStop?: () => void;
+    onSuggestionClick?: (suggestion: Suggestion) => void;
+    onActionClick?: (action: ConversationAction, messageId: string) => void;
+    onFeedback?: (messageId: string, feedback: 'positive' | 'negative') => void;
+    onCitationClick?: (citation: Citation) => void;
+    onAttachmentAction?: (action: AttachmentAction) => void;
+    onContextPillRemove?: (pill: ContextPill) => void;
+    onCopy?: (messageId: string, content: string) => void;
+};
+
 export declare type ConversationContext = {
     conversationId?: string;
     messages: ConversationMessage[];
 };
 
+export declare interface ConversationContextValue {
+    messages: Message[];
+    callbacks: ConversationCallbacks;
+    isStreaming: boolean;
+}
+
+export declare const ConversationInput: ({ placeholder, attachments, collections, contextPills, disabled, isElevated, className, }: ConversationInputProps_2) => default_2.JSX.Element;
+
+declare interface ConversationInputProps_2 {
+    placeholder?: string;
+    attachments?: Attachment[];
+    collections?: Collection_2[];
+    contextPills?: ContextPill[];
+    disabled?: boolean;
+    isElevated?: boolean;
+    className?: string;
+}
+
+export declare const ConversationLoading: ({ className }: ConversationLoadingProps_2) => default_2.JSX.Element;
+
+declare interface ConversationLoadingProps_2 {
+    className?: string;
+}
+
 export declare type ConversationMessage = {
     question: string;
     answer: string;
 };
 
+export declare const ConversationMessageAssistant: ({ message, className }: ConversationMessageAssistantProps) => default_2.JSX.Element;
+
+declare interface ConversationMessageAssistantProps {
+    message: Message;
+    className?: string;
+}
+
+export declare const ConversationMessages: ({ className, bottomPadding, onContentBehind }: ConversationMessagesProps_2) => default_2.JSX.Element;
+
+declare interface ConversationMessagesProps_2 {
+    className?: string;
+    bottomPadding?: number;
+    onContentBehind?: (isBehind: boolean) => void;
+}
+
+export declare const ConversationMessageUser: ({ message, className }: ConversationMessageUserProps) => default_2.JSX.Element;
+
+declare interface ConversationMessageUserProps {
+    message: Message;
+    className?: string;
+}
+
+declare interface ConversationProps {
+    messages: Message[];
+    callbacks: ConversationCallbacks;
+    children?: ReactNode;
+    suggestions?: Suggestion[];
+    actions?: ConversationAction[];
+    placeholder?: string;
+    attachments?: Attachment[];
+    collections?: Collection_2[];
+    contextPills?: ContextPill[];
+    showBranding?: boolean;
+    className?: string;
+}
+
+export declare function ConversationProvider({ messages, callbacks, children }: ConversationProviderProps): default_2.JSX.Element;
+
+declare interface ConversationProviderProps {
+    messages: Message[];
+    callbacks: ConversationCallbacks;
+    children: default_2.ReactNode;
+}
+
+export declare const ConversationSuggestions: ({ items, className }: ConversationSuggestionsProps_2) => default_2.JSX.Element | null;
+
+declare interface ConversationSuggestionsProps_2 {
+    items: Suggestion[];
+    className?: string;
+}
+
 export declare function DataTable<TData extends Record<string, any> & {
     id?: string | number;
 }, TValue>({ columns, data, getRowCanExpand, className, expandeRowClassName, isLoading, skeletonRowCount, ...props }: DataTableProps<TData, TValue>): default_2.JSX.Element;
@@ -1155,7 +1327,9 @@ export declare const formatFileSize: (bytes: number) => string;
 
 export declare const FormattedMessage: FC<Props>;
 
-export declare const FullLayout: typeof FullLayoutWithFlags & {
+export declare const FullLayout: FullLayoutCompound;
+
+declare type FullLayoutCompound = typeof FullLayoutWithFlags & {
     MainArea: typeof Compounds.MainArea;
     Body: typeof Compounds.Body;
     Header: typeof Compounds.Header;
@@ -1183,6 +1357,8 @@ export declare interface FullLayoutContextValue {
     ariaValuenow: number;
     ariaValuemin: number;
     ariaValuemax: number;
+    /** Mirrors `FullLayout` prop; `FullLayout.Main` uses it for viewport height when Radix ScrollArea is off. */
+    disableMainScrollArea: boolean;
 }
 
 export declare const FullLayoutHeader: default_2.ForwardRefExoticComponent<FullLayoutHeaderProps & default_2.RefAttributes<HTMLElement>>;
@@ -1236,6 +1412,8 @@ export declare interface FullLayoutRightSidebarProps extends Omit<default_2.Comp
 export declare interface FullLayoutRootProps {
     children?: default_2.ReactNode;
     disableLeftSideNav?: boolean;
+    /** When true, main column uses a plain div (no Radix ScrollArea); viewport height is applied on `FullLayout.Main`. */
+    disableMainScrollArea?: boolean;
     className?: string;
 }
 
@@ -1287,6 +1465,12 @@ declare interface HeaderNavProps extends React_2.ComponentPropsWithoutRef<'heade
 
 export declare const Icon: default_2.ForwardRefExoticComponent<Omit<PhosphorIconProps, "ref"> & default_2.RefAttributes<SVGSVGElement>>;
 
+export declare type ImagePart = {
+    type: 'image';
+    url: string;
+    alt?: string;
+};
+
 export declare const Input: default_2.ForwardRefExoticComponent<InputProps & default_2.RefAttributes<HTMLInputElement>>;
 
 export declare interface InputProps extends default_2.InputHTMLAttributes<HTMLInputElement> {
@@ -1394,8 +1578,9 @@ export declare interface LogoProps extends React_2.SVGProps<SVGSVGElement> {
 
 export declare type LogoVariant = 'mark' | 'text' | 'full';
 
-declare function Main({ children }: {
+declare function Main({ children, className }: {
     children?: default_2.ReactNode;
+    className?: string;
 }): default_2.JSX.Element;
 
 declare namespace Main {
@@ -1438,11 +1623,26 @@ declare interface MermaidDiagramProps {
     content: string;
 }
 
-declare type Message = {
+export declare type Message = {
+    id: string;
+    role: MessageRole;
+    parts: MessagePart[];
+    status: MessageStatus;
+    createdAt?: Date;
+    feedback?: 'positive' | 'negative';
+};
+
+declare type Message_2 = {
     content: string;
     uncertaintyFallbackText?: Record<string, string>;
 };
 
+export declare type MessagePart = TextPart | ImagePart | CitationPart | ToolCallPart | ThinkingPart | ActionButtonsPart;
+
+export declare type MessageRole = 'user' | 'assistant';
+
+export declare type MessageStatus = 'pending' | 'streaming' | 'completed' | 'error';
+
 declare type NextBestAction = {
     id?: string;
     label: string;
@@ -1501,7 +1701,7 @@ export declare const Progress: React_2.ForwardRefExoticComponent<Omit<ProgressPr
 } & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface Props {
-    message: Message;
+    message: Message_2;
     isStreaming?: boolean;
     redirectRules?: RedirectRule[];
     contentTypeEndpoint?: string;
@@ -1747,6 +1947,7 @@ export declare interface SidebarProps extends React_2.ComponentPropsWithoutRef<'
     appNavItems?: SidebarNavItem[];
     appNavActiveId?: string;
     showArticles?: boolean;
+    isLoadingArticles?: boolean;
     articles?: ArticleNavItem[];
     sectionNavItems?: SidebarNavItem[];
     sectionNavActiveId?: string;
@@ -1766,7 +1967,13 @@ export declare interface SimpleSelectProps {
 
 export declare function Spinner({ className, ...props }: default_2.ComponentProps<"svg">): default_2.JSX.Element;
 
-declare interface Suggestion {
+export declare type Suggestion = {
+    id: string;
+    text: string;
+    icon?: string;
+};
+
+declare interface Suggestion_2 {
     id: string;
     question: string;
     conversationId?: string;
@@ -1817,6 +2024,24 @@ declare interface TextConfig {
     uncertaintyFallbackText?: Record<string, string>;
 }
 
+export declare type TextPart = {
+    type: 'text';
+    text: string;
+};
+
+export declare type ThinkingPart = {
+    type: 'thinking';
+    text: string;
+};
+
+export declare type ToolCallPart = {
+    type: 'tool-call';
+    toolName: string;
+    status: 'pending' | 'running' | 'completed' | 'error';
+    args?: Record<string, unknown>;
+    result?: string;
+};
+
 export declare const Tooltip: React_2.FC<TooltipPrimitive.TooltipProps>;
 
 export declare const TooltipContent: React_2.ForwardRefExoticComponent<TooltipContentProps & React_2.RefAttributes<HTMLDivElement>>;
@@ -1878,6 +2103,8 @@ declare type UrlString = string & {
 
 export declare const useChatSearch: () => ChatSearchContextProps;
 
+export declare function useConversation(): ConversationContextValue;
+
 /**
  * Hook to fetch and manage Google Fonts options
  * Handles caching, loading state, and font stylesheet loading

package/dist/sidebar.d.ts

@@ -4,6 +4,7 @@ import * as React_2 from 'react';
 export declare interface ArticleNavItem extends Omit<SidebarNavItem, 'Icon' | 'items'> {
     status?: 'discovery' | 'unpublished' | 'draft';
     hasChildren?: boolean;
+    isLoadingChildren?: boolean;
     items?: ArticleNavItem[];
 }
 
@@ -59,6 +60,7 @@ export declare interface SidebarProps extends React_2.ComponentPropsWithoutRef<'
     appNavItems?: SidebarNavItem[];
     appNavActiveId?: string;
     showArticles?: boolean;
+    isLoadingArticles?: boolean;
     articles?: ArticleNavItem[];
     sectionNavItems?: SidebarNavItem[];
     sectionNavActiveId?: string;