@copilotz/chat-ui 0.6.5 → 0.6.7

package/dist/index.d.cts

@@ -2,20 +2,20 @@ import React, { ReactNode } from 'react';
 import { Options, Components } from 'react-markdown';
 
 type MediaAttachment = {
-    kind: 'image';
+    kind: "image";
     dataUrl: string;
     mimeType: string;
     fileName?: string;
     size?: number;
 } | {
-    kind: 'audio';
+    kind: "audio";
     dataUrl: string;
     mimeType: string;
     durationMs?: number;
     fileName?: string;
     size?: number;
 } | {
-    kind: 'video';
+    kind: "video";
     dataUrl: string;
     mimeType: string;
     durationMs?: number;
@@ -24,11 +24,11 @@ type MediaAttachment = {
     poster?: string;
 };
 type AudioAttachment = Extract<MediaAttachment, {
-    kind: 'audio';
+    kind: "audio";
 }>;
-type VoiceComposerState = 'idle' | 'preparing' | 'waiting_for_speech' | 'listening' | 'finishing' | 'review' | 'sending' | 'error';
-type VoiceReviewMode = 'manual' | 'armed';
-type VoiceTranscriptMode = 'none' | 'final-only' | 'partial-and-final';
+type VoiceComposerState = "idle" | "preparing" | "waiting_for_speech" | "listening" | "finishing" | "review" | "sending" | "error";
+type VoiceReviewMode = "manual" | "armed";
+type VoiceTranscriptMode = "none" | "final-only" | "partial-and-final";
 interface VoiceTranscript {
     partial?: string;
     final?: string;
@@ -61,12 +61,12 @@ interface ToolCall {
     name: string;
     arguments: Record<string, any>;
     result?: any;
-    status: 'pending' | 'running' | 'completed' | 'failed';
+    status: "pending" | "running" | "completed" | "failed";
     startTime?: number;
     endTime?: number;
 }
-type ActivityDisplayMode = 'full' | 'summary' | 'hidden';
-type AssistantActivitySummaryKind = 'thinking' | 'working' | 'using_tools' | 'preparing_answer';
+type ActivityDisplayMode = "full" | "summary" | "hidden";
+type AssistantActivitySummaryKind = "thinking" | "working" | "using_tools" | "preparing_answer";
 interface AssistantActivitySummary {
     kind: AssistantActivitySummaryKind;
     toolName?: string;
@@ -81,7 +81,7 @@ interface AssistantActivityState {
 }
 interface ChatMessage {
     id: string;
-    role: 'user' | 'assistant' | 'system';
+    role: "user" | "assistant" | "system";
     content: string;
     timestamp: number;
     attachments?: MediaAttachment[];
@@ -108,8 +108,8 @@ interface ChatThread {
     metadata?: Record<string, any>;
 }
 interface ChatMarkdownConfig {
-    remarkPlugins?: Options['remarkPlugins'];
-    rehypePlugins?: Options['rehypePlugins'];
+    remarkPlugins?: Options["remarkPlugins"];
+    rehypePlugins?: Options["rehypePlugins"];
     components?: Components;
 }
 interface ChatConfig {
@@ -124,7 +124,7 @@ interface ChatConfig {
         label?: string;
         hideIfSingle?: boolean;
         /** 'single' = classic single-agent dropdown (default). 'multi' = participants + target selectors. */
-        mode?: 'single' | 'multi';
+        mode?: "single" | "multi";
     };
     labels?: {
         inputPlaceholder?: string;
@@ -217,7 +217,7 @@ interface ChatConfig {
         maxFileSize?: number;
     };
     ui?: {
-        theme?: 'light' | 'dark' | 'auto';
+        theme?: "light" | "dark" | "auto";
         showTimestamps?: boolean;
         showAvatars?: boolean;
         compactMode?: boolean;
@@ -230,7 +230,7 @@ interface ChatConfig {
     };
     markdown?: ChatMarkdownConfig;
     voiceCompose?: {
-        defaultMode?: 'text' | 'voice';
+        defaultMode?: "text" | "voice";
         reviewMode?: VoiceReviewMode;
         autoSendDelayMs?: number;
         persistComposer?: boolean;
@@ -253,6 +253,20 @@ interface ChatConfig {
     /** Additional actions to render in the header */
     headerActions?: ReactNode;
 }
+interface ChatUserMenuItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    onSelect?: () => void;
+    variant?: "default" | "destructive";
+    checked?: boolean;
+    disabled?: boolean;
+}
+interface ChatUserMenuSection {
+    id: string;
+    label?: string;
+    items: ChatUserMenuItem[];
+}
 interface StateCallback<T = unknown> {
     setState: (state: T | ((prev: T) => T)) => void;
     getState: () => T;
@@ -272,7 +286,7 @@ interface ChatCallbacks {
     onAttachmentRemove?: (attachmentIndex: number, callback?: StateCallback<ChatState>) => void;
     onViewProfile?: () => void;
     onOpenSettings?: () => void;
-    onThemeChange?: (theme: 'light' | 'dark' | 'system') => void;
+    onThemeChange?: (theme: "light" | "dark" | "system") => void;
     onLogout?: () => void;
 }
 interface ChatV2Props {
@@ -281,6 +295,9 @@ interface ChatV2Props {
     currentThreadId?: string | null;
     config?: ChatConfig;
     sidebar?: ReactNode;
+    userMenuSections?: ChatUserMenuSection[];
+    /** @deprecated Prefer userMenuSections for native menu composition */
+    userMenuAdditionalItems?: ReactNode;
     isGenerating?: boolean;
     isMessagesLoading?: boolean;
     isLoadingOlderMessages?: boolean;
@@ -311,7 +328,7 @@ interface ChatV2Props {
     messageSuggestions?: Record<string, string[]>;
     enabledFeatures?: string[];
     className?: string;
-    onAddMemory?: (content: string, category?: MemoryItem['category']) => void;
+    onAddMemory?: (content: string, category?: MemoryItem["category"]) => void;
     onUpdateMemory?: (memoryId: string, content: string) => void;
     onDeleteMemory?: (memoryId: string) => void;
     /**
@@ -345,7 +362,7 @@ interface AgentOption {
     /** Custom color for multi-agent display. Auto-assigned if not provided. */
     color?: string;
 }
-type MessageAction = 'copy' | 'edit' | 'delete' | 'regenerate' | 'retry';
+type MessageAction = "copy" | "edit" | "delete" | "regenerate" | "retry";
 interface MessageActionEvent {
     action: MessageAction;
     messageId: string;
@@ -354,7 +371,7 @@ interface MessageActionEvent {
 interface FileUploadProgress {
     fileName: string;
     progress: number;
-    status: 'uploading' | 'completed' | 'failed';
+    status: "uploading" | "completed" | "failed";
 }
 interface StreamingUpdate {
     messageId: string;
@@ -365,14 +382,14 @@ interface UserCustomField {
     key: string;
     label: string;
     value: string | number | boolean | null | undefined;
-    type?: 'text' | 'email' | 'phone' | 'url' | 'date' | 'number' | 'boolean';
+    type?: "text" | "email" | "phone" | "url" | "date" | "number" | "boolean";
     icon?: ReactNode;
 }
 interface MemoryItem {
     id: string;
     content: string;
-    category?: 'preference' | 'fact' | 'goal' | 'context' | 'other';
-    source: 'agent' | 'user';
+    category?: "preference" | "fact" | "goal" | "context" | "other";
+    source: "agent" | "user";
     createdAt: string;
     updatedAt?: string;
 }
@@ -410,4 +427,4 @@ declare function useChatUserContext(): ChatUserContextValue;
 declare const defaultChatConfig: Required<ChatConfig>;
 declare function mergeConfig(_baseConfig: ChatConfig, userConfig?: Partial<ChatConfig>): Required<ChatConfig>;
 
-export { type ActivityDisplayMode, type AgentOption, AssistantActivity, type AssistantActivityState, type AssistantActivitySummary, type AssistantActivitySummaryKind, type AudioAttachment, type ChatCallbacks, type ChatConfig, type ChatMarkdownConfig, type ChatMessage, type ChatState, type ChatThread, ChatUI, type ChatUserContext, ChatUserContextProvider, type ChatV2Props, type CreateVoiceProvider, type FileUploadProgress, type MediaAttachment, type MemoryItem, type MessageAction, type MessageActionEvent, type StateCallback, type StreamingUpdate, type ToolCall, type UserCustomField, type VoiceComposerState, type VoiceProvider, type VoiceProviderHandlers, type VoiceProviderOptions, type VoiceReviewMode, type VoiceSegment, type VoiceTranscript, type VoiceTranscriptMode, defaultChatConfig, mergeConfig, useChatUserContext };
+export { type ActivityDisplayMode, type AgentOption, AssistantActivity, type AssistantActivityState, type AssistantActivitySummary, type AssistantActivitySummaryKind, type AudioAttachment, type ChatCallbacks, type ChatConfig, type ChatMarkdownConfig, type ChatMessage, type ChatState, type ChatThread, ChatUI, type ChatUserContext, ChatUserContextProvider, type ChatUserMenuItem, type ChatUserMenuSection, type ChatV2Props, type CreateVoiceProvider, type FileUploadProgress, type MediaAttachment, type MemoryItem, type MessageAction, type MessageActionEvent, type StateCallback, type StreamingUpdate, type ToolCall, type UserCustomField, type VoiceComposerState, type VoiceProvider, type VoiceProviderHandlers, type VoiceProviderOptions, type VoiceReviewMode, type VoiceSegment, type VoiceTranscript, type VoiceTranscriptMode, defaultChatConfig, mergeConfig, useChatUserContext };

package/dist/index.d.ts

@@ -2,20 +2,20 @@ import React, { ReactNode } from 'react';
 import { Options, Components } from 'react-markdown';
 
 type MediaAttachment = {
-    kind: 'image';
+    kind: "image";
     dataUrl: string;
     mimeType: string;
     fileName?: string;
     size?: number;
 } | {
-    kind: 'audio';
+    kind: "audio";
     dataUrl: string;
     mimeType: string;
     durationMs?: number;
     fileName?: string;
     size?: number;
 } | {
-    kind: 'video';
+    kind: "video";
     dataUrl: string;
     mimeType: string;
     durationMs?: number;
@@ -24,11 +24,11 @@ type MediaAttachment = {
     poster?: string;
 };
 type AudioAttachment = Extract<MediaAttachment, {
-    kind: 'audio';
+    kind: "audio";
 }>;
-type VoiceComposerState = 'idle' | 'preparing' | 'waiting_for_speech' | 'listening' | 'finishing' | 'review' | 'sending' | 'error';
-type VoiceReviewMode = 'manual' | 'armed';
-type VoiceTranscriptMode = 'none' | 'final-only' | 'partial-and-final';
+type VoiceComposerState = "idle" | "preparing" | "waiting_for_speech" | "listening" | "finishing" | "review" | "sending" | "error";
+type VoiceReviewMode = "manual" | "armed";
+type VoiceTranscriptMode = "none" | "final-only" | "partial-and-final";
 interface VoiceTranscript {
     partial?: string;
     final?: string;
@@ -61,12 +61,12 @@ interface ToolCall {
     name: string;
     arguments: Record<string, any>;
     result?: any;
-    status: 'pending' | 'running' | 'completed' | 'failed';
+    status: "pending" | "running" | "completed" | "failed";
     startTime?: number;
     endTime?: number;
 }
-type ActivityDisplayMode = 'full' | 'summary' | 'hidden';
-type AssistantActivitySummaryKind = 'thinking' | 'working' | 'using_tools' | 'preparing_answer';
+type ActivityDisplayMode = "full" | "summary" | "hidden";
+type AssistantActivitySummaryKind = "thinking" | "working" | "using_tools" | "preparing_answer";
 interface AssistantActivitySummary {
     kind: AssistantActivitySummaryKind;
     toolName?: string;
@@ -81,7 +81,7 @@ interface AssistantActivityState {
 }
 interface ChatMessage {
     id: string;
-    role: 'user' | 'assistant' | 'system';
+    role: "user" | "assistant" | "system";
     content: string;
     timestamp: number;
     attachments?: MediaAttachment[];
@@ -108,8 +108,8 @@ interface ChatThread {
     metadata?: Record<string, any>;
 }
 interface ChatMarkdownConfig {
-    remarkPlugins?: Options['remarkPlugins'];
-    rehypePlugins?: Options['rehypePlugins'];
+    remarkPlugins?: Options["remarkPlugins"];
+    rehypePlugins?: Options["rehypePlugins"];
     components?: Components;
 }
 interface ChatConfig {
@@ -124,7 +124,7 @@ interface ChatConfig {
         label?: string;
         hideIfSingle?: boolean;
         /** 'single' = classic single-agent dropdown (default). 'multi' = participants + target selectors. */
-        mode?: 'single' | 'multi';
+        mode?: "single" | "multi";
     };
     labels?: {
         inputPlaceholder?: string;
@@ -217,7 +217,7 @@ interface ChatConfig {
         maxFileSize?: number;
     };
     ui?: {
-        theme?: 'light' | 'dark' | 'auto';
+        theme?: "light" | "dark" | "auto";
         showTimestamps?: boolean;
         showAvatars?: boolean;
         compactMode?: boolean;
@@ -230,7 +230,7 @@ interface ChatConfig {
     };
     markdown?: ChatMarkdownConfig;
     voiceCompose?: {
-        defaultMode?: 'text' | 'voice';
+        defaultMode?: "text" | "voice";
         reviewMode?: VoiceReviewMode;
         autoSendDelayMs?: number;
         persistComposer?: boolean;
@@ -253,6 +253,20 @@ interface ChatConfig {
     /** Additional actions to render in the header */
     headerActions?: ReactNode;
 }
+interface ChatUserMenuItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    onSelect?: () => void;
+    variant?: "default" | "destructive";
+    checked?: boolean;
+    disabled?: boolean;
+}
+interface ChatUserMenuSection {
+    id: string;
+    label?: string;
+    items: ChatUserMenuItem[];
+}
 interface StateCallback<T = unknown> {
     setState: (state: T | ((prev: T) => T)) => void;
     getState: () => T;
@@ -272,7 +286,7 @@ interface ChatCallbacks {
     onAttachmentRemove?: (attachmentIndex: number, callback?: StateCallback<ChatState>) => void;
     onViewProfile?: () => void;
     onOpenSettings?: () => void;
-    onThemeChange?: (theme: 'light' | 'dark' | 'system') => void;
+    onThemeChange?: (theme: "light" | "dark" | "system") => void;
     onLogout?: () => void;
 }
 interface ChatV2Props {
@@ -281,6 +295,9 @@ interface ChatV2Props {
     currentThreadId?: string | null;
     config?: ChatConfig;
     sidebar?: ReactNode;
+    userMenuSections?: ChatUserMenuSection[];
+    /** @deprecated Prefer userMenuSections for native menu composition */
+    userMenuAdditionalItems?: ReactNode;
     isGenerating?: boolean;
     isMessagesLoading?: boolean;
     isLoadingOlderMessages?: boolean;
@@ -311,7 +328,7 @@ interface ChatV2Props {
     messageSuggestions?: Record<string, string[]>;
     enabledFeatures?: string[];
     className?: string;
-    onAddMemory?: (content: string, category?: MemoryItem['category']) => void;
+    onAddMemory?: (content: string, category?: MemoryItem["category"]) => void;
     onUpdateMemory?: (memoryId: string, content: string) => void;
     onDeleteMemory?: (memoryId: string) => void;
     /**
@@ -345,7 +362,7 @@ interface AgentOption {
     /** Custom color for multi-agent display. Auto-assigned if not provided. */
     color?: string;
 }
-type MessageAction = 'copy' | 'edit' | 'delete' | 'regenerate' | 'retry';
+type MessageAction = "copy" | "edit" | "delete" | "regenerate" | "retry";
 interface MessageActionEvent {
     action: MessageAction;
     messageId: string;
@@ -354,7 +371,7 @@ interface MessageActionEvent {
 interface FileUploadProgress {
     fileName: string;
     progress: number;
-    status: 'uploading' | 'completed' | 'failed';
+    status: "uploading" | "completed" | "failed";
 }
 interface StreamingUpdate {
     messageId: string;
@@ -365,14 +382,14 @@ interface UserCustomField {
     key: string;
     label: string;
     value: string | number | boolean | null | undefined;
-    type?: 'text' | 'email' | 'phone' | 'url' | 'date' | 'number' | 'boolean';
+    type?: "text" | "email" | "phone" | "url" | "date" | "number" | "boolean";
     icon?: ReactNode;
 }
 interface MemoryItem {
     id: string;
     content: string;
-    category?: 'preference' | 'fact' | 'goal' | 'context' | 'other';
-    source: 'agent' | 'user';
+    category?: "preference" | "fact" | "goal" | "context" | "other";
+    source: "agent" | "user";
     createdAt: string;
     updatedAt?: string;
 }
@@ -410,4 +427,4 @@ declare function useChatUserContext(): ChatUserContextValue;
 declare const defaultChatConfig: Required<ChatConfig>;
 declare function mergeConfig(_baseConfig: ChatConfig, userConfig?: Partial<ChatConfig>): Required<ChatConfig>;
 
-export { type ActivityDisplayMode, type AgentOption, AssistantActivity, type AssistantActivityState, type AssistantActivitySummary, type AssistantActivitySummaryKind, type AudioAttachment, type ChatCallbacks, type ChatConfig, type ChatMarkdownConfig, type ChatMessage, type ChatState, type ChatThread, ChatUI, type ChatUserContext, ChatUserContextProvider, type ChatV2Props, type CreateVoiceProvider, type FileUploadProgress, type MediaAttachment, type MemoryItem, type MessageAction, type MessageActionEvent, type StateCallback, type StreamingUpdate, type ToolCall, type UserCustomField, type VoiceComposerState, type VoiceProvider, type VoiceProviderHandlers, type VoiceProviderOptions, type VoiceReviewMode, type VoiceSegment, type VoiceTranscript, type VoiceTranscriptMode, defaultChatConfig, mergeConfig, useChatUserContext };
+export { type ActivityDisplayMode, type AgentOption, AssistantActivity, type AssistantActivityState, type AssistantActivitySummary, type AssistantActivitySummaryKind, type AudioAttachment, type ChatCallbacks, type ChatConfig, type ChatMarkdownConfig, type ChatMessage, type ChatState, type ChatThread, ChatUI, type ChatUserContext, ChatUserContextProvider, type ChatUserMenuItem, type ChatUserMenuSection, type ChatV2Props, type CreateVoiceProvider, type FileUploadProgress, type MediaAttachment, type MemoryItem, type MessageAction, type MessageActionEvent, type StateCallback, type StreamingUpdate, type ToolCall, type UserCustomField, type VoiceComposerState, type VoiceProvider, type VoiceProviderHandlers, type VoiceProviderOptions, type VoiceReviewMode, type VoiceSegment, type VoiceTranscript, type VoiceTranscriptMode, defaultChatConfig, mergeConfig, useChatUserContext };