@tenancy.nz/chat-ui 0.1.63 → 0.1.65

package/dist/esm/index.d.ts

@@ -1,9 +1,12 @@
+import { default as AiAvatarSrc } from './assets/ai-avatar.png';
 import { default as ChatInlineStyles } from './styles.css?inline';
 import { default as default_2 } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
-export declare function Chat({ user, generateToken, clientId, apiBase, docsBase, hideConversations, agentName, agentAvatarSrc, agentRole, tagline, description, initialConversationId, onConversationChange, }: {
+export { AiAvatarSrc }
+
+export declare function Chat({ user, generateToken, clientId, apiBase, docsBase, hideConversations, agentName, agentAvatarSrc, agentRole, tagline, description, initialConversationId, onConversationChange, onApiReady, }: {
     apiBase: string;
     docsBase?: string;
     user?: ChatUser;
@@ -17,10 +20,77 @@ export declare function Chat({ user, generateToken, clientId, apiBase, docsBase,
     description?: string;
     initialConversationId?: string;
     onConversationChange?: (id: string | null) => void;
+    onApiReady?: (api: ChatApi) => void;
 }): JSX_2.Element;
 
+export declare type ChatApi = {
+    sendMessage: (text: string) => Promise<void>;
+    setInput: (text: string) => void;
+    startNewConversation: () => void;
+    getCurrentConversationId: () => string | null;
+};
+
+export declare type ChatConversationSession = {
+    conversationId: string | undefined;
+    onConversationChange: (id: string | null) => void;
+    startNewChat: () => void;
+    /**
+     * Key to pass as the `key` prop on `<Chat>` when starting a new chat —
+     * remounts Chat so it picks up the cleared conversation state.
+     */
+    resetKey: number;
+};
+
+export declare function ChatHeader({ name, role, avatarSrc, showOnlineDot, leftActions, rightActions, onClick, }: ChatHeaderProps): JSX_2.Element;
+
+export declare type ChatHeaderProps = {
+    name: string;
+    role?: string;
+    avatarSrc?: string;
+    showOnlineDot?: boolean;
+    leftActions?: ReactNode;
+    rightActions?: ReactNode;
+    onClick?: () => void;
+};
+
 export { ChatInlineStyles }
 
+/**
+ * Standalone full-page wrapper that re-applies the chrome (border, radius,
+ * shadow, viewport-relative height) Chat used to render itself. Wrap a Chat
+ * in this when mounting it as the main content of a page.
+ */
+export declare function ChatPage({ children, className, style }: ChatPageProps): JSX_2.Element;
+
+export declare type ChatPageProps = {
+    children: ReactNode;
+    className?: string;
+    style?: default_2.CSSProperties;
+};
+
+/**
+ * Chat panel layout primitive.
+ *
+ * - `position`: 'relative' (in flex layout, can push siblings) or 'fixed' (overlay).
+ * - `resizable`: shows a drag handle on the inner edge that calls onWidthChange.
+ * - `width`: controlled width (number = px, string = any css width).
+ * - The panel does not own open/close state — render conditionally from parent.
+ */
+export declare function ChatPanel({ children, position, resizable, width, onWidthChange, minWidth, maxWidth, anchor, className, style, }: ChatPanelProps): JSX_2.Element;
+
+export declare type ChatPanelProps = {
+    children: ReactNode;
+    position?: 'relative' | 'fixed';
+    resizable?: boolean;
+    width: number | string;
+    onWidthChange?: (width: number) => void;
+    minWidth?: number;
+    maxWidth?: number;
+    anchor?: 'right';
+    className?: string;
+    style?: default_2.CSSProperties;
+};
+
 export declare type ChatUser = {
     accessToken?: string;
     name?: string;
@@ -30,32 +100,17 @@ export declare type ChatUser = {
 
 export declare const PortalTargetProvider: default_2.Provider<Element | null>;
 
-export declare function Widget({ name, role, avatarSrc, sessionKey, children, }: WidgetProps): JSX_2.Element;
-
-export declare function WidgetChat({ name, role, avatarSrc, tagline, description, initialPrompt, sessionKey, apiBase, docsBase, clientId, generateToken, user, }: WidgetChatProps): JSX_2.Element;
-
-export declare type WidgetChatProps = {
-    name: string;
-    role: string;
-    avatarSrc?: string;
-    tagline?: string;
-    description?: string;
-    initialPrompt?: string;
-    sessionKey?: string;
-    apiBase: string;
-    docsBase?: string;
-    clientId?: string;
-    generateToken?: () => Promise<string> | string;
-    user?: ChatUser;
-};
-
-export declare type WidgetProps = {
-    name: string;
-    role: string;
-    avatarSrc?: string;
-    initialPrompt?: string;
-    sessionKey?: string;
-    children: ReactNode;
-};
+/**
+ * Persistent single-conversation session for embedded chat usage.
+ *
+ * - Reads/writes sessionStorage under `widget-conv-${sessionKey}`.
+ * - `conversationId` is the persisted convo id (undefined if none). Pass to
+ *   `<Chat initialConversationId={conversationId} />`.
+ * - `onConversationChange` should be passed to `<Chat onConversationChange>`
+ *   so newly-created conversations get persisted automatically.
+ * - `startNewChat()` clears the persisted conversation and bumps `resetKey`.
+ *   Pass `resetKey` as the React key on `<Chat>` so it remounts cleanly.
+ */
+export declare function useChatConversationSession(sessionKey: string): ChatConversationSession;
 
 export { }