@bdocs/plugin-ask-ai 0.3.0 → 0.3.1

package/dist/client/index.d.mts

@@ -1,9 +1,10 @@
 import * as _$react from "react";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { Ref } from "react";
 
 //#region src/client/use-ask-ai.d.ts
-type MessageStatus = 'reading' | 'streaming' | 'done' | 'error';
+type MessageStatus = 'reading' | 'streaming' | 'done' | 'cancelled' | 'error';
 interface Message {
+  id?: string;
   role: 'user' | 'assistant';
   content: string;
   status?: MessageStatus;
@@ -23,9 +24,39 @@ interface Message {
   };
   errorMessage?: string;
 }
+interface AskAiClassNames {
+  root?: string;
+  panel?: string;
+  trigger?: string;
+  header?: string;
+  messages?: string;
+  message?: string;
+  userMessage?: string;
+  assistantMessage?: string;
+  emptyState?: string;
+  composer?: string;
+  input?: string;
+  markdown?: string;
+}
+interface AskAiPageContext {
+  page: string;
+  content: string;
+}
 interface UseAskAiOptions {
   endpoint?: string;
   currentPage?: string;
+  context?: AskAiPageContext;
+  getContext?: () => AskAiPageContext | null;
+  classNames?: Partial<AskAiClassNames>;
+}
+/** User-facing copy for the widget, configurable via plugin options. */
+interface AskAiUiCopy {
+  title: string;
+  placeholder: string;
+  emptyTitle: string;
+  emptyDescription: string;
+  buttonTooltip: string;
+  composerHint: string;
 }
 declare function useAskAi(options?: UseAskAiOptions): {
   messages: Message[];
@@ -38,13 +69,115 @@ declare function useAskAi(options?: UseAskAiOptions): {
   isOpen: boolean;
   setIsOpen: _$react.Dispatch<_$react.SetStateAction<boolean>>;
   devMode: boolean;
+  ui: AskAiUiCopy;
+  classNames: AskAiClassNames;
 };
 //#endregion
 //#region src/client/components/ask-ai-bubble.d.ts
-declare function AskAiBubble(): _$react_jsx_runtime0.JSX.Element;
+interface AskAiBubbleProps extends UseAskAiOptions {}
+declare function AskAiBubble(props?: AskAiBubbleProps): _$react.JSX.Element;
 //#endregion
 //#region src/client/components/ask-ai-dialog.d.ts
-declare function AskAiDialog(): _$react_jsx_runtime0.JSX.Element | null;
+interface AskAiDialogProps extends UseAskAiOptions {}
+declare function AskAiDialog(props?: AskAiDialogProps): _$react.JSX.Element;
+//#endregion
+//#region src/client/components/chat-header.d.ts
+type ChatVariant = 'bubble' | 'dialog';
+interface ChatHeaderProps {
+  title: string;
+  variant?: ChatVariant;
+  canClear: boolean;
+  onClear?: () => void;
+  onClose: () => void;
+  className?: string;
+  titleId?: string;
+}
+declare function ChatHeader({
+  title,
+  variant,
+  canClear,
+  onClear,
+  onClose,
+  className,
+  titleId
+}: ChatHeaderProps): _$react.JSX.Element;
+//#endregion
+//#region src/client/components/chat-input.d.ts
+interface ChatInputProps {
+  input: string;
+  onInputChange: (value: string) => void;
+  onSubmit: (value: string) => void;
+  onStop: () => void;
+  isLoading: boolean;
+  placeholder?: string;
+  hint?: string;
+  variant?: ChatVariant;
+  inputRef?: Ref<HTMLTextAreaElement>;
+  className?: string;
+  inputClassName?: string;
+}
+declare function ChatInput({
+  input,
+  onInputChange,
+  onSubmit,
+  onStop,
+  isLoading,
+  placeholder,
+  hint,
+  variant,
+  inputRef,
+  className,
+  inputClassName
+}: ChatInputProps): _$react.JSX.Element;
+//#endregion
+//#region src/client/components/chat-message.d.ts
+interface ChatMessageProps {
+  message: Message;
+  variant?: ChatVariant;
+  devMode: boolean;
+  className?: string;
+  userClassName?: string;
+  assistantClassName?: string;
+  markdownClassName?: string;
+}
+declare function ChatMessageImpl({
+  message: msg,
+  variant,
+  devMode,
+  className,
+  userClassName,
+  assistantClassName,
+  markdownClassName
+}: ChatMessageProps): _$react.JSX.Element;
+/**
+ * Memoized so that during streaming only the message whose content actually
+ * changed re-renders. The hook structurally shares the array and replaces the
+ * final assistant message with a new object, so all older siblings keep their
+ * identity and are skipped by the default shallow comparison.
+ */
+declare const ChatMessage: _$react.MemoExoticComponent<typeof ChatMessageImpl>;
+//#endregion
+//#region src/client/components/chat-empty-state.d.ts
+interface ChatEmptyStateProps {
+  description: string;
+  title?: string;
+  variant?: ChatVariant;
+  className?: string;
+}
+declare function ChatEmptyState({
+  description,
+  title,
+  variant,
+  className
+}: ChatEmptyStateProps): _$react.JSX.Element;
+//#endregion
+//#region src/client/components/typing-indicator.d.ts
+interface TypingIndicatorProps {
+  label?: string;
+}
+declare function TypingIndicator({
+  label
+}: TypingIndicatorProps): _$react.JSX.Element;
 //#endregion
 //#region src/client/render-markdown.d.ts
 interface MarkdownRendererProps {
@@ -52,13 +185,16 @@ interface MarkdownRendererProps {
   className?: string;
   parseIncompleteMarkdown?: boolean;
 }
-declare function MarkdownRenderer({
+declare function MarkdownRendererImpl({
   content,
   className,
   parseIncompleteMarkdown
-}: MarkdownRendererProps): _$react_jsx_runtime0.JSX.Element | null;
-//#endregion
-//#region src/client/index.d.ts
-declare const _default: any;
+}: MarkdownRendererProps): _$react.JSX.Element;
+/**
+ * Memoized: while the message streams the same buffered content can be
+ * re-rendered (e.g. a status flip reading → streaming) — this skips the
+ * heavy markdown re-parse when nothing changed.
+ */
+declare const MarkdownRenderer: _$react.MemoExoticComponent<typeof MarkdownRendererImpl>;
 //#endregion
-export { AskAiBubble, AskAiDialog, MarkdownRenderer, type Message, type MessageStatus, type UseAskAiOptions, _default as default, useAskAi };
+export { AskAiBubble, type AskAiBubbleProps, type AskAiClassNames, AskAiDialog, type AskAiDialogProps, type AskAiUiCopy, ChatEmptyState, ChatHeader, type ChatHeaderProps, ChatInput, ChatMessage, type ChatMessageProps, type ChatVariant, MarkdownRenderer, type Message, type MessageStatus, TypingIndicator, type UseAskAiOptions, useAskAi };