@nicorp/nui 0.3.1 → 0.5.0

package/dist/index.d.ts

@@ -220,6 +220,13 @@ export declare const ChartTooltip: typeof Tooltip_2;
 
 export declare const ChatBubble: React_2.ForwardRefExoticComponent<ChatBubbleProps & React_2.RefAttributes<HTMLDivElement>>;
 
+export declare const ChatBubbleActions: React_2.ForwardRefExoticComponent<ChatBubbleActionsProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatBubbleActionsProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Show always or on hover @default "hover" */
+    visibility?: "always" | "hover";
+}
+
 export declare const ChatBubbleAvatar: React_2.ForwardRefExoticComponent<ChatBubbleAvatarProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface ChatBubbleAvatarProps extends React_2.HTMLAttributes<HTMLDivElement> {
@@ -232,6 +239,8 @@ export declare const ChatBubbleMessage: React_2.ForwardRefExoticComponent<ChatBu
 export declare interface ChatBubbleMessageProps extends React_2.HTMLAttributes<HTMLDivElement> {
     variant?: "sent" | "received";
     isLoading?: boolean;
+    /** Delivery status indicator */
+    status?: "sending" | "sent" | "delivered" | "read" | "error";
 }
 
 export declare interface ChatBubbleProps extends React_2.HTMLAttributes<HTMLDivElement> {
@@ -248,6 +257,44 @@ export declare const ChatContainer: React_2.ForwardRefExoticComponent<ChatContai
 export declare interface ChatContainerProps extends React_2.HTMLAttributes<HTMLDivElement> {
 }
 
+export declare const ChatFollowUp: React_2.ForwardRefExoticComponent<ChatFollowUpProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatFollowUpProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
+    /** The question AI is asking */
+    question: string;
+    /** Answer options to display as buttons */
+    options: FollowUpOption[];
+    /** Called when user picks an option */
+    onSelect?: (optionId: string, label: string) => void;
+    /** Currently selected option id (disables further selection) */
+    selected?: string;
+    /** Allow user to type a custom answer @default false */
+    allowFreeText?: boolean;
+    /** Called when user submits free-text answer */
+    onFreeTextSubmit?: (text: string) => void;
+    /** Grid columns for options @default 1 */
+    columns?: 1 | 2;
+}
+
+export declare const ChatHeader: React_2.ForwardRefExoticComponent<ChatHeaderProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatHeaderProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Chat title */
+    title?: string;
+    /** Model name to display */
+    model?: string;
+    /** Model icon (emoji or URL) */
+    modelIcon?: string;
+    /** Connection/typing status */
+    status?: "online" | "offline" | "typing";
+    /** Clear conversation handler */
+    onClear?: () => void;
+    /** Settings handler */
+    onSettings?: () => void;
+    /** Back button handler (mobile) */
+    onBack?: () => void;
+}
+
 export declare const ChatInput: React_2.ForwardRefExoticComponent<ChatInputProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface ChatInputProps {
@@ -256,6 +303,22 @@ export declare interface ChatInputProps {
     disabled?: boolean;
     isLoading?: boolean;
     showAttach?: boolean;
+    /** Handler for file attachment — triggers hidden file input */
+    onAttach?: (files: FileList) => void;
+    /** Accept attribute for file input @default "*" */
+    acceptFiles?: string;
+    /** Stop/cancel handler — shows stop button instead of spinner when loading */
+    onStop?: () => void;
+    /** Controlled mode value */
+    value?: string;
+    /** Controlled mode change handler */
+    onChange?: (value: string) => void;
+    /** Content rendered above the textarea (e.g. ModelSelector, ChatModeSelector) */
+    headerSlot?: React_2.ReactNode;
+    /** Content rendered below the textarea (e.g. FilePreview, char counter) */
+    footerSlot?: React_2.ReactNode;
+    /** Max character length — shows counter when set */
+    maxLength?: number;
     className?: string;
 }
 
@@ -266,8 +329,133 @@ export declare interface ChatListProps extends React_2.HTMLAttributes<HTMLDivEle
     autoScroll?: boolean;
 }
 
+export declare const ChatMessage: React_2.ForwardRefExoticComponent<ChatMessageProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatMessageAction {
+    type: "copy" | "retry" | "edit" | "like" | "dislike" | "share";
+    handler?: () => void;
+}
+
+export declare interface ChatMessageCitation {
+    index: number;
+    title: string;
+    url: string;
+    snippet?: string;
+}
+
+export declare interface ChatMessageFollowUp {
+    question: string;
+    options: {
+        id: string;
+        label: string;
+        description?: string;
+    }[];
+    selected?: string;
+    allowFreeText?: boolean;
+}
+
+export declare interface ChatMessageProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'content'> {
+    /** Message direction */
+    variant?: "sent" | "received";
+    /** Avatar image URL */
+    avatar?: string;
+    /** Avatar fallback text */
+    avatarFallback?: string;
+    /** Message content */
+    content?: React_2.ReactNode;
+    /** Timestamp text (e.g. "2:30 PM") */
+    timestamp?: string;
+    /** Loading state (bouncing dots) */
+    isLoading?: boolean;
+    /** Message delivery status */
+    status?: "sending" | "sent" | "delivered" | "read" | "error";
+    /** Action buttons to show */
+    actions?: ("copy" | "retry" | "edit" | "like" | "dislike" | "share")[];
+    /** Raw text content for copy action */
+    textContent?: string;
+    /** Like/dislike state */
+    likeState?: "liked" | "disliked" | null;
+    /** Action handlers */
+    onCopy?: () => void;
+    onRetry?: () => void;
+    onEdit?: () => void;
+    onLike?: () => void;
+    onDislike?: () => void;
+    onShare?: () => void;
+    /** Follow-up question */
+    followUp?: ChatMessageFollowUp;
+    onFollowUpSelect?: (optionId: string, label: string) => void;
+    onFollowUpFreeText?: (text: string) => void;
+    /** Reasoning/thinking block */
+    reasoning?: ChatMessageReasoning;
+    /** Tool calls */
+    toolCalls?: ChatMessageToolCall[];
+    /** Source citations */
+    citations?: ChatMessageCitation[];
+}
+
+export declare interface ChatMessageReasoning {
+    content: string;
+    isThinking?: boolean;
+    duration?: number;
+}
+
+export declare interface ChatMessageToolCall {
+    name: string;
+    args?: Record<string, unknown>;
+    result?: string;
+    status: "running" | "success" | "error";
+    error?: string;
+}
+
+export declare const ChatModeSelector: React_2.ForwardRefExoticComponent<ChatModeSelectorProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatModeSelectorProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    modes: ModeOption[];
+    value?: string;
+    onChange?: (modeId: string) => void;
+    /** Visual size @default "default" */
+    size?: "sm" | "default";
+}
+
+export declare const ChatToolCall: React_2.ForwardRefExoticComponent<ChatToolCallProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ChatToolCallProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Tool/function name */
+    name: string;
+    /** Arguments passed to the tool */
+    args?: Record<string, unknown>;
+    /** Result from the tool */
+    result?: string;
+    /** Call status */
+    status: "running" | "success" | "error";
+    /** Error message (when status=error) */
+    error?: string;
+    /** Start in open state @default false */
+    defaultOpen?: boolean;
+}
+
 export declare const Checkbox: React_2.ForwardRefExoticComponent<Omit<CheckboxPrimitive.CheckboxProps & React_2.RefAttributes<HTMLButtonElement>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
 
+export declare interface Citation {
+    /** Citation index (displayed as [1], [2], etc.) */
+    index: number;
+    /** Source title */
+    title: string;
+    /** Source URL */
+    url: string;
+    /** Optional text snippet from source */
+    snippet?: string;
+    /** Favicon or icon URL */
+    favicon?: string;
+}
+
+export declare const CitationBadge: React_2.ForwardRefExoticComponent<CitationBadgeProps & React_2.RefAttributes<HTMLButtonElement>>;
+
+export declare interface CitationBadgeProps extends React_2.HTMLAttributes<HTMLButtonElement> {
+    citation: Citation;
+}
+
 export declare function cn(...inputs: ClassValue[]): string;
 
 export declare function Code({ className, ...props }: CodeProps): JSX_2.Element;
@@ -453,6 +641,28 @@ export declare const ContextMenuSubTrigger: React_2.ForwardRefExoticComponent<Om
 
 export declare const ContextMenuTrigger: React_2.ForwardRefExoticComponent<ContextMenuPrimitive.ContextMenuTriggerProps & React_2.RefAttributes<HTMLSpanElement>>;
 
+export declare interface Conversation {
+    id: string;
+    title: string;
+    lastMessage?: string;
+    updatedAt: Date;
+    model?: string;
+    icon?: string;
+}
+
+export declare const ConversationList: React_2.ForwardRefExoticComponent<ConversationListProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ConversationListProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    conversations: Conversation[];
+    activeId?: string;
+    onSelect?: (id: string) => void;
+    onNew?: () => void;
+    onDelete?: (id: string) => void;
+    onRename?: (id: string, title: string) => void;
+    /** Show search input @default true */
+    showSearch?: boolean;
+}
+
 export declare const CopyInput: React_2.ForwardRefExoticComponent<CopyInputProps & React_2.RefAttributes<HTMLInputElement>>;
 
 declare interface CopyInputProps extends React_2.InputHTMLAttributes<HTMLInputElement> {
@@ -561,6 +771,31 @@ export declare interface EmptyStateProps {
     className?: string;
 }
 
+export declare const en: NUILocale;
+
+export declare interface FileItem {
+    id?: string;
+    name: string;
+    /** Size in bytes */
+    size: number;
+    /** MIME type */
+    type: string;
+    /** URL for preview (images) or download */
+    url?: string;
+    /** Thumbnail URL (optional, for images) */
+    thumbnail?: string;
+}
+
+export declare const FilePreview: React_2.ForwardRefExoticComponent<FilePreviewProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface FilePreviewProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    files: FileItem[];
+    /** Remove handler — shows X button when provided */
+    onRemove?: (index: number) => void;
+    /** Display variant @default "compact" */
+    variant?: "compact" | "grid";
+}
+
 export declare function FileUpload({ accept, maxSize, multiple, onUpload, disabled, className, }: FileUploadProps): JSX_2.Element;
 
 export declare interface FileUploadProps {
@@ -582,6 +817,12 @@ export declare interface FlexProps extends React_2.HTMLAttributes<HTMLDivElement
     gap?: number | string;
 }
 
+export declare interface FollowUpOption {
+    id: string;
+    label: string;
+    description?: string;
+}
+
 export declare const Grid: React_2.ForwardRefExoticComponent<GridProps & React_2.RefAttributes<HTMLDivElement>>;
 
 export declare interface GridProps extends React_2.HTMLAttributes<HTMLDivElement> {
@@ -648,6 +889,27 @@ export declare interface MarkdownRendererProps extends React_2.HTMLAttributes<HT
     streaming?: boolean;
 }
 
+export declare const MessageActions: React_2.ForwardRefExoticComponent<MessageActionsProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface MessageActionsProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Which actions to show @default ["copy"] */
+    actions?: MessageActionType[];
+    /** Text content to copy (for copy action) */
+    content?: string;
+    /** Current like state */
+    likeState?: "liked" | "disliked" | null;
+    onCopy?: () => void;
+    onRetry?: () => void;
+    onEdit?: () => void;
+    onLike?: () => void;
+    onDislike?: () => void;
+    onShare?: () => void;
+    /** Show always or only on hover @default "hover" */
+    visibility?: "always" | "hover";
+}
+
+export declare type MessageActionType = "copy" | "retry" | "edit" | "like" | "dislike" | "share";
+
 export declare function MetricCard({ title, value, description, trend, trendLabel, icon, className, ...props }: MetricCardProps): JSX_2.Element;
 
 declare interface MetricCardProps extends React_2.HTMLAttributes<HTMLDivElement> {
@@ -659,6 +921,46 @@ declare interface MetricCardProps extends React_2.HTMLAttributes<HTMLDivElement>
     icon?: React_2.ReactNode;
 }
 
+export declare interface ModelOption {
+    /** Unique model identifier, e.g. "gpt-4o" */
+    id: string;
+    /** Display name, e.g. "GPT-4o" */
+    name: string;
+    /** Provider name, e.g. "OpenAI" */
+    provider?: string;
+    /** Description shown below name */
+    description?: string;
+    /** Small icon URL or emoji */
+    icon?: string;
+    /** Capability badges, e.g. ["Fast", "Vision", "128K"] */
+    badges?: string[];
+    /** Whether the model is disabled / unavailable */
+    disabled?: boolean;
+}
+
+export declare const ModelSelector: React_2.ForwardRefExoticComponent<ModelSelectorProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ModelSelectorProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Available models */
+    models: ModelOption[];
+    /** Currently selected model id */
+    value?: string;
+    /** Called when user selects a model */
+    onChange?: (modelId: string) => void;
+    /** Placeholder when nothing selected @default "Select model" */
+    placeholder?: string;
+    /** Compact mode — only icon + name in trigger @default false */
+    compact?: boolean;
+}
+
+export declare interface ModeOption {
+    id: string;
+    label: string;
+    /** Emoji or short icon text */
+    icon?: string;
+    description?: string;
+}
+
 export declare function ModeToggle({ className }: {
     className?: string;
 }): JSX_2.Element;
@@ -709,6 +1011,82 @@ export declare const navigationMenuTriggerStyle: (props?: ClassProp | undefined)
 
 export declare const NavigationMenuViewport: React_2.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuViewportProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
 
+export declare interface NUILocale {
+    chatInput_placeholder: string;
+    chatInput_attachFile: string;
+    chatInput_stopGenerating: string;
+    chatInput_sendMessage: string;
+    conversationList_newChat: string;
+    conversationList_searchPlaceholder: string;
+    conversationList_noResults: string;
+    conversationList_empty: string;
+    conversationList_today: string;
+    conversationList_yesterday: string;
+    conversationList_previous7Days: string;
+    conversationList_older: string;
+    conversationList_rename: string;
+    conversationList_delete: string;
+    chatHeader_online: string;
+    chatHeader_offline: string;
+    chatHeader_typing: string;
+    chatHeader_back: string;
+    chatHeader_clearConversation: string;
+    chatHeader_settings: string;
+    reasoning_title: string;
+    reasoning_thinking: string;
+    /** Use {duration} placeholder, e.g. "Thought for {duration}" */
+    reasoning_thoughtFor: string;
+    /** Use {name} placeholder, e.g. "Calling {name}..." */
+    toolCall_calling: string;
+    /** Use {name} placeholder, e.g. "{name} — failed" */
+    toolCall_failed: string;
+    toolCall_arguments: string;
+    toolCall_result: string;
+    toolCall_error: string;
+    messageActions_copy: string;
+    messageActions_retry: string;
+    messageActions_edit: string;
+    messageActions_like: string;
+    messageActions_dislike: string;
+    messageActions_share: string;
+    messageActions_copied: string;
+    followUp_freeTextPlaceholder: string;
+    followUp_send: string;
+    sourceCitation_sources: string;
+    aiLoading_thinking: string;
+    /** Use {name} placeholder, e.g. "Remove {name}" */
+    filePreview_remove: string;
+    modelSelector_placeholder: string;
+    modelSelector_searchPlaceholder: string;
+    modelSelector_noResults: string;
+}
+
+/**
+ * Provides a locale dictionary to every NUI AI component in the tree.
+ *
+ * @example
+ * ```tsx
+ * <NUIProvider locale="ru">
+ *   <App />
+ * </NUIProvider>
+ * ```
+ *
+ * @example Custom locale
+ * ```tsx
+ * <NUIProvider locale={{ chatInput_placeholder: "Ask anything…" }}>
+ *   <App />
+ * </NUIProvider>
+ * ```
+ */
+export declare function NUIProvider({ locale, children }: NUIProviderProps): JSX_2.Element;
+
+export declare interface NUIProviderProps {
+    /** Built-in locale key ("en" | "ru") or a custom (partial) locale dictionary.
+     *  Missing keys fall back to English. */
+    locale?: "en" | "ru" | (string & {}) | Partial<NUILocale>;
+    children: React_2.ReactNode;
+}
+
 export declare function NumberInput({ value, onChange, min, max, step, disabled, className, }: NumberInputProps): JSX_2.Element;
 
 export declare interface NumberInputProps {
@@ -792,6 +1170,23 @@ export declare const RadioGroup: React_2.ForwardRefExoticComponent<Omit<RadioGro
 
 export declare const RadioGroupItem: React_2.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupItemProps & React_2.RefAttributes<HTMLButtonElement>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
 
+export declare const ReasoningBlock: React_2.ForwardRefExoticComponent<ReasoningBlockProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface ReasoningBlockProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Reasoning/thinking content (plain text or markdown) */
+    content: string;
+    /** Whether the AI is still thinking @default false */
+    isThinking?: boolean;
+    /** Duration in seconds (shown in header) */
+    duration?: number;
+    /** Start in open state @default false */
+    defaultOpen?: boolean;
+    /** Custom title @default "Reasoning" */
+    title?: string;
+}
+
+export declare const ru: NUILocale;
+
 export declare const ScrollArea: React_2.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & {
     orientation?: ScrollAreaOrientation;
 } & React_2.RefAttributes<HTMLDivElement>>;
@@ -877,6 +1272,14 @@ export declare function Skeleton({ className, ...props }: React.HTMLAttributes<H
 
 export declare const Slider: React_2.ForwardRefExoticComponent<Omit<SliderPrimitive.SliderProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & React_2.RefAttributes<HTMLSpanElement>>;
 
+export declare const SourceCitation: React_2.ForwardRefExoticComponent<SourceCitationProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface SourceCitationProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    citations: Citation[];
+    /** Display style @default "footer" */
+    variant?: "inline" | "footer";
+}
+
 export declare interface StackProps extends React_2.HTMLAttributes<HTMLDivElement> {
     spacing?: number | string;
     align?: "start" | "end" | "center" | "stretch";
@@ -906,6 +1309,21 @@ export declare interface StepProps {
     description?: string;
 }
 
+export declare const StreamingText: React_2.ForwardRefExoticComponent<StreamingTextProps & React_2.RefAttributes<HTMLSpanElement>>;
+
+export declare interface StreamingTextProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** Full text to render character-by-character */
+    text: string;
+    /** Characters per frame (~60fps) @default 2 */
+    speed?: number;
+    /** Called when typing animation finishes */
+    onComplete?: () => void;
+    /** Show blinking cursor at end @default true */
+    cursor?: boolean;
+    /** Skip animation and show full text immediately @default false */
+    immediate?: boolean;
+}
+
 export declare const Switch: React_2.ForwardRefExoticComponent<Omit<SwitchPrimitive.SwitchProps & React_2.RefAttributes<HTMLButtonElement>, "ref"> & React_2.RefAttributes<HTMLButtonElement>>;
 
 export declare const Table: React_2.ForwardRefExoticComponent<React_2.HTMLAttributes<HTMLTableElement> & React_2.RefAttributes<HTMLTableElement>>;
@@ -1057,8 +1475,25 @@ export declare const TooltipProvider: React_2.FC<TooltipPrimitive.TooltipProvide
 
 export declare const TooltipTrigger: React_2.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React_2.RefAttributes<HTMLButtonElement>>;
 
+/**
+ * Simple template interpolation: replaces `{key}` placeholders.
+ *
+ * @example
+ * ```ts
+ * t("Calling {name}...", { name: "search" })
+ * // → "Calling search..."
+ * ```
+ */
+export declare function tpl(template: string, vars: Record<string, string | number>): string;
+
 declare type UseCarouselParameters = Parameters<typeof default_2>;
 
+/**
+ * Returns the current NUI locale dictionary.
+ * Falls back to English when used outside a `<NUIProvider>`.
+ */
+export declare function useNUILocale(): NUILocale;
+
 export declare function useTheme(): ThemeProviderState;
 
 export declare const VStack: React_2.ForwardRefExoticComponent<StackProps & React_2.RefAttributes<HTMLDivElement>>;