@kitn.ai/ui 0.17.0 → 0.18.1

package/dist/react/runtime.d.ts

@@ -8,8 +8,15 @@ export interface WebComponentProps {
     /** Light-DOM children passed through to the element (slots). */
     children?: ReactNode;
 }
+/** Eagerly register ALL kai-* elements (the register-all bundle). Opt-in escape
+ *  hatch for consumers who prefer no first-mount upgrade delay. Browser-only;
+ *  a no-op on the server. */
+export declare function registerAll(): Promise<unknown> | undefined;
 export declare function createWebComponent<P extends WebComponentProps>(tagName: string, 
 /** DOM-property names to assign from props (incl. `theme`). */
 propNames: readonly string[], 
-/** Map of React handler prop → DOM event name, e.g. `{ onMessageAction: 'kai-message-action' }`. */
-eventMap: Record<string, string>): ForwardRefExoticComponent<PropsWithoutRef<P> & RefAttributes<HTMLElement>>;
+/** Map of React handler prop → DOM event name. */
+eventMap: Record<string, string>, 
+/** Client-only thunk that loads + registers this element (a literal dynamic
+ *  import of its `@kitn.ai/ui/elements/<name>` chunk). */
+register?: () => Promise<unknown>): ForwardRefExoticComponent<PropsWithoutRef<P> & RefAttributes<HTMLElement>>;

package/dist/react/use-kai-chat.d.ts

@@ -0,0 +1,41 @@
+import { Dispatch, SetStateAction } from 'react';
+import { ChatMessage } from '../../src/elements/chat-types';
+import { AttachmentData } from '../../src/components/attachment-types';
+import { AssistantStream } from '../../src/state';
+export type { ChatMessage } from '../../src/elements/chat-types';
+export interface UseKaiChatOptions {
+    /** Seed messages, read once at mount and copied. Later changes are ignored — drive updates through the returned ops. */
+    initialMessages?: ChatMessage[];
+    /** Seed suggestions, read once at mount and copied. Later changes are ignored. */
+    initialSuggestions?: string[];
+    onSubmit?: (detail: {
+        value: string;
+        attachments: AttachmentData[];
+    }) => void | Promise<void>;
+}
+/** Owns chat state in React and exposes ergonomic, fully-typed controlled operations. */
+export interface KaiChatController {
+    messages: ChatMessage[];
+    setMessages: Dispatch<SetStateAction<ChatMessage[]>>;
+    suggestions: string[];
+    setSuggestions: Dispatch<SetStateAction<string[]>>;
+    loading: boolean;
+    append: (msg: ChatMessage) => void;
+    update: (id: string, patch: Partial<ChatMessage> | ((m: ChatMessage) => ChatMessage)) => void;
+    remove: (id: string) => void;
+    addSuggestion: (s: string) => void;
+    removeSuggestion: (s: string) => void;
+    clearSuggestions: () => void;
+    streamAssistant: (init?: Partial<ChatMessage>) => AssistantStream;
+    /** Spread onto `<Chat {...chat.bind} />` — wires messages, loading, suggestions, and kai-submit. */
+    bind: {
+        messages: ChatMessage[];
+        loading: boolean;
+        suggestions: string[];
+        onSubmit: (event: CustomEvent<{
+            value: string;
+            attachments: AttachmentData[];
+        }>) => void;
+    };
+}
+export declare function useKaiChat(options?: UseKaiChatOptions): KaiChatController;