@promptbook/markdown-utils 0.111.0-7 → 0.112.0-100

package/esm/src/book-components/Chat/Chat/useChatMessageSpeechPlayback.d.ts

@@ -0,0 +1,29 @@
+import { type RefObject } from 'react';
+/**
+ * Inputs needed to manage speech playback for one chat message.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export type UseChatMessageSpeechPlaybackOptions = {
+    readonly trimmedMessageContent: string;
+    readonly contentRef: RefObject<HTMLElement | null>;
+    readonly shouldShowPlayButton: boolean;
+    readonly elevenLabsVoiceId?: string;
+};
+/**
+ * Speech playback state and actions returned to `<ChatMessageItem/>`.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export type UseChatMessageSpeechPlaybackResult = {
+    readonly audioError: string | null;
+    readonly isAudioLoading: boolean;
+    readonly isAudioPlaying: boolean;
+    readonly handlePlayMessage: () => Promise<void>;
+};
+/**
+ * Handles ElevenLabs speech playback, caching, and audio element lifecycle for one message.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export declare function useChatMessageSpeechPlayback(options: UseChatMessageSpeechPlaybackOptions): UseChatMessageSpeechPlaybackResult;

package/esm/src/book-components/Chat/Chat/useChatPostprocessedMessages.d.ts

@@ -0,0 +1,17 @@
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Inputs required to normalize rendered chat messages.
+ *
+ * @private function of `useChatPostprocessedMessages`
+ */
+type UseChatPostprocessedMessagesProps = {
+    messages: ReadonlyArray<ChatMessage>;
+    isAiTextHumanizedAndPromptbookified: boolean;
+};
+/**
+ * Memoizes the render-only message normalization used by `<Chat/>`.
+ *
+ * @private function of `<Chat/>`
+ */
+export declare function useChatPostprocessedMessages({ messages, isAiTextHumanizedAndPromptbookified, }: UseChatPostprocessedMessagesProps): ReadonlyArray<ChatMessage>;
+export {};

package/esm/src/book-components/Chat/Chat/useChatScrollState.d.ts

@@ -0,0 +1,34 @@
+import { type MutableRefObject, type UIEvent } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Inputs required to coordinate Chat scroll behavior.
+ *
+ * @private function of `useChatScrollState`
+ */
+type UseChatScrollStateProps = {
+    messages: ReadonlyArray<ChatMessage>;
+};
+/**
+ * Public result consumed by `<Chat/>`.
+ *
+ * @private function of `useChatScrollState`
+ */
+type UseChatScrollStateResult = {
+    readonly actionsRef: MutableRefObject<HTMLDivElement | null>;
+    readonly ariaLabel: string;
+    readonly badgeLabel: string;
+    readonly handleChatScroll: (event: UIEvent<HTMLDivElement>) => void;
+    readonly isMobile: boolean;
+    readonly scrollToBottom: (behavior?: 'smooth' | 'auto') => void;
+    readonly setChatMessagesElement: (element: HTMLDivElement | null) => void;
+    readonly shouldDisableActions: boolean;
+    readonly shouldFadeActions: boolean;
+    readonly shouldShowScrollToBottom: boolean;
+};
+/**
+ * Coordinates auto-scroll, overlap tracking, and the scroll-to-bottom indicator for `<Chat/>`.
+ *
+ * @private function of `<Chat/>`
+ */
+export declare function useChatScrollState({ messages }: UseChatScrollStateProps): UseChatScrollStateResult;
+export {};

package/esm/src/book-components/Chat/Chat/useChatToolCallModalState.d.ts

@@ -0,0 +1,61 @@
+import { type MutableRefObject } from 'react';
+import type { AgentChipData } from '../AgentChip/AgentChip';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { TeamToolCallSummary, TransitiveToolCall } from '../utils/collectTeamToolCallSummary';
+import type { AgentProfileData } from '../utils/loadAgentProfile';
+import type { TeamToolResult } from '../utils/toolCallParsing/TeamToolResult';
+/**
+ * Tool-call snapshot rendered by the modal.
+ *
+ * @private function of `ChatToolCallModal`
+ */
+type ToolCallModalToolCall = NonNullable<ChatMessage['toolCalls']>[number];
+/**
+ * Export target used by the advanced tool-call report controls.
+ *
+ * @private function of `ChatToolCallModal`
+ */
+type ToolCallReportDestination = 'clipboard' | 'file';
+/**
+ * Inputs required to coordinate `<ChatToolCallModal/>` state.
+ *
+ * @private function of `useChatToolCallModalState`
+ */
+type UseChatToolCallModalStateProps = {
+    readonly isOpen: boolean;
+    readonly toolCall: ToolCallModalToolCall | null;
+    /**
+     * Stable identity of the selected tool call.
+     */
+    readonly toolCallIdentity?: string | null;
+    readonly onClose: () => void;
+    readonly toolTitles?: Record<string, string>;
+    readonly teamAgentProfiles?: Record<string, AgentChipData>;
+};
+/**
+ * State and callbacks consumed by `<ChatToolCallModal/>`.
+ *
+ * @private function of `useChatToolCallModalState`
+ */
+type UseChatToolCallModalStateResult = {
+    readonly clearSelectedTeamToolCall: () => void;
+    readonly exportAdvancedToolCallReport: (destination: ToolCallReportDestination) => Promise<void>;
+    readonly focusedToolCall: ToolCallModalToolCall | null;
+    readonly isAdvancedView: boolean;
+    readonly modalDialogRef: MutableRefObject<HTMLDivElement | null>;
+    readonly openAdvancedView: () => void;
+    readonly selectTeamToolCall: (toolCall: TransitiveToolCall) => void;
+    readonly selectedTeamToolCall: TransitiveToolCall | null;
+    readonly teamProfiles: Record<string, AgentProfileData>;
+    readonly teamResult: TeamToolResult | null;
+    readonly teamToolCallSummary: TeamToolCallSummary;
+    readonly toggleViewMode: () => void;
+    readonly toolCallDate: Date | null;
+};
+/**
+ * Coordinates derived data, modal lifecycle, and advanced-export actions for `<ChatToolCallModal/>`.
+ *
+ * @private function of `ChatToolCallModal`
+ */
+export declare function useChatToolCallModalState({ isOpen, toolCall, toolCallIdentity, onClose, toolTitles, teamAgentProfiles, }: UseChatToolCallModalStateProps): UseChatToolCallModalStateResult;
+export {};

package/esm/src/book-components/Chat/Chat/useChatToolCallState.d.ts

@@ -0,0 +1,35 @@
+import type { ToolCall } from '../../../types/ToolCall';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ParsedCitation } from '../utils/parseCitationsFromContent';
+/**
+ * Inputs required to keep Chat tool-call and citation modals in sync.
+ *
+ * @private function of `useChatToolCallState`
+ */
+type UseChatToolCallStateProps = {
+    messages: ReadonlyArray<ChatMessage>;
+};
+/**
+ * State and callbacks exposed back to `<Chat/>`.
+ *
+ * @private function of `useChatToolCallState`
+ */
+type UseChatToolCallStateResult = {
+    readonly citationModalOpen: boolean;
+    readonly closeCitationModal: () => void;
+    readonly closeToolCallModal: () => void;
+    readonly openCitation: (citation: ParsedCitation) => void;
+    readonly openToolCall: (toolCall: ToolCall) => void;
+    readonly selectedCitation: ParsedCitation | null;
+    readonly selectedMessageAvailableTools: ChatMessage['availableTools'];
+    readonly selectedToolCall: ToolCall | null;
+    readonly selectedToolCallIdentity: string | null;
+    readonly toolCallModalOpen: boolean;
+};
+/**
+ * Keeps Chat modal state focused on one selected tool call or citation.
+ *
+ * @private function of `<Chat/>`
+ */
+export declare function useChatToolCallState({ messages }: UseChatToolCallStateProps): UseChatToolCallStateResult;
+export {};

package/esm/src/book-components/Chat/CodeBlock/CodeBlock.d.ts

@@ -1,13 +1,19 @@
+/**
+ * Props for `<CodeBlock/>`.
+ *
+ * @private Internal utility of `<ChatMessage />` component
+ */
 type CodeBlockProps = {
     code: string;
     language?: string;
     className?: string;
     onCreateAgent?: (bookContent: string) => void;
+    theme?: 'LIGHT' | 'DARK';
 };
 /**
  * Component to render a code block with syntax highlighting, copy, download, and create agent options.
  *
  * @private Internal utility of `<ChatMessage />` component
  */
-export declare function CodeBlock({ code, language, className, onCreateAgent }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
+export declare function CodeBlock({ code, language, className, onCreateAgent, theme }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/esm/src/book-components/Chat/CodeBlock/resolveCodeBlockLanguage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Monaco language identifiers supported for markdown code snippets.
+ *
+ * @private internal helper of `<CodeBlock/>`
+ */
+export type MonacoCodeBlockLanguage = 'javascript' | 'typescript' | 'html' | 'css' | 'python' | 'shell' | 'json' | 'sql' | 'book' | 'plaintext';
+/**
+ * Resolves a markdown fenced-code language label into a Monaco language identifier.
+ *
+ * Unknown languages intentionally resolve to `plaintext` so unsupported snippets render
+ * as readable text without syntax highlighting.
+ *
+ * @param language - Raw markdown code fence language label (for example `ts`, `typescript`, `bash`).
+ * @returns Canonical Monaco language identifier.
+ *
+ * @private internal helper of `<CodeBlock/>`
+ */
+export declare function resolveCodeBlockLanguage(language: string | undefined): MonacoCodeBlockLanguage;

package/esm/src/book-components/Chat/CodeBlock/resolveCodeBlockLanguage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/book-components/Chat/LlmChat/LlmChatProps.d.ts

@@ -1,5 +1,6 @@
 import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
-import type { id } from '../../../types/typeAliases';
+import type { id } from '../../../types/string_token';
+import type { AgentChipData } from '../AgentChip/AgentChip';
 import type { ChatProps } from '../Chat/ChatProps';
 import type { SendMessageToLlmChatFunction } from '../hooks/useSendMessageToLlmChat';
 import type { ChatMessage } from '../types/ChatMessage';
@@ -39,6 +40,13 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * Called when the chat state changes (messages, participants, etc.)
      */
     onChange?(messages: ReadonlyArray<ChatMessage>, participants: ReadonlyArray<ChatParticipant>): void;
+    /**
+     * Called every time the user types in the input field (for draft message persistence).
+     * This is passed through to the underlying Chat component's onChange handler.
+     *
+     * @private internal utility of <AgentChatHistoryClient/>
+     */
+    onInputTextChange?(messageContent: string): void;
     /**
      * Optional external sendMessage function produced by useSendMessageToLlmChat hook.
      * When provided, LlmChat will attach its internal handler to it (no React context needed).
@@ -61,11 +69,19 @@ export type LlmChatProps = Omit<ChatProps, 'messages' | 'onMessage' | 'onChange'
      * This is useful for seamless transitions from other pages.
      */
     readonly autoExecuteMessage?: string;
+    /**
+     * Optional attachments that should be sent alongside the auto-executed message.
+     */
+    readonly autoExecuteMessageAttachments?: ChatMessage['attachments'];
     /**
      * Optional mapping of technical tool names to human-readable titles.
      * e.g., { "web_search": "Searching the web..." }
      */
     readonly toolTitles?: Record<string, string>;
+    /**
+     * Optional pre-fetched team agent metadata keyed by TEAM tool name.
+     */
+    readonly teamAgentProfiles?: Record<string, AgentChipData>;
     /**
      * Custom variants for the placeholder thinking message shown while the agent buffers its response.
      *

package/esm/src/book-components/Chat/LlmChat/defaults.d.ts

@@ -4,6 +4,3 @@
  * @private internal fallback for `LlmChat` so the same string can be reused across the stack without repetition.
  */
 export declare const DEFAULT_CHAT_FAIL_MESSAGE = "Sorry, I encountered an error processing your message. Please, try again later.";
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/book-components/Chat/LlmChat/useLlmChatMessageHandler.d.ts

@@ -0,0 +1,58 @@
+import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
+import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
+import type { id } from '../../../types/string_token';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { LlmChatProps } from './LlmChatProps';
+/**
+ * Minimal task-progress item rendered by `<Chat/>`.
+ *
+ * @private function of `useLlmChatMessageHandler`
+ */
+type LlmChatTaskProgress = {
+    readonly id: string;
+    readonly name: string;
+    readonly progress?: number;
+};
+/**
+ * Internal send signature shared across retry and visibility-recovery flows.
+ *
+ * @private function of `useLlmChatMessageHandler`
+ */
+type HandleMessageFn = (messageContent: string, attachments?: ChatMessage['attachments']) => Promise<void>;
+/**
+ * Inputs required by `useLlmChatMessageHandler`.
+ *
+ * @private function of `useLlmChatMessageHandler`
+ */
+type UseLlmChatMessageHandlerProps = {
+    readonly chatFailMessage: string;
+    readonly hasUserInteractedRef: MutableRefObject<boolean>;
+    readonly llmParticipantName: id;
+    readonly llmTools: LlmExecutionTools;
+    readonly messages: ReadonlyArray<ChatMessage>;
+    readonly onError?: LlmChatProps['onError'];
+    readonly promptParameters: Record<string, string>;
+    readonly setMessages: Dispatch<SetStateAction<Array<ChatMessage>>>;
+    readonly setTasksProgress: Dispatch<SetStateAction<Array<LlmChatTaskProgress>>>;
+    readonly thinkingVariants: ReadonlyArray<string>;
+    readonly thread?: ReadonlyArray<ChatMessage>;
+    readonly userParticipantName: id;
+};
+/**
+ * State and handlers returned by `useLlmChatMessageHandler`.
+ *
+ * @private function of `useLlmChatMessageHandler`
+ */
+type UseLlmChatMessageHandlerResult = {
+    readonly clearLastFailedMessage: () => void;
+    readonly handleMessage: HandleMessageFn;
+    readonly handleStopStreaming: () => void;
+    readonly isStreaming: boolean;
+};
+/**
+ * Manages send, stream, retry, and background-recovery flows for `<LlmChat/>`.
+ *
+ * @private function of `useLlmChatState`
+ */
+export declare function useLlmChatMessageHandler(props: UseLlmChatMessageHandlerProps): UseLlmChatMessageHandlerResult;
+export {};

package/esm/src/book-components/Chat/LlmChat/useLlmChatMessages.d.ts

@@ -0,0 +1,29 @@
+import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Inputs required to manage the persisted `<LlmChat/>` message list.
+ *
+ * @private function of `useLlmChatMessages`
+ */
+type UseLlmChatMessagesProps = {
+    readonly initialMessages?: ReadonlyArray<ChatMessage>;
+    readonly persistenceKey?: string;
+};
+/**
+ * State and helpers returned by `useLlmChatMessages`.
+ *
+ * @private function of `useLlmChatMessages`
+ */
+type UseLlmChatMessagesResult = {
+    readonly buildInitialMessages: () => Array<ChatMessage>;
+    readonly hasUserInteractedRef: MutableRefObject<boolean>;
+    readonly messages: Array<ChatMessage>;
+    readonly setMessages: Dispatch<SetStateAction<Array<ChatMessage>>>;
+};
+/**
+ * Manages initial seeding plus optional local persistence for `<LlmChat/>`.
+ *
+ * @private function of `useLlmChatState`
+ */
+export declare function useLlmChatMessages(props: UseLlmChatMessagesProps): UseLlmChatMessagesResult;
+export {};

package/esm/src/book-components/Chat/LlmChat/useLlmChatState.d.ts

@@ -0,0 +1,53 @@
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+import type { LlmChatProps } from './LlmChatProps';
+/**
+ * Metadata for a teammate agent tool.
+ *
+ * @private function of `useLlmChatState`
+ */
+type TeammateMetadata = {
+    readonly url: string;
+    readonly label?: string;
+    readonly instructions?: string;
+    readonly toolName: string;
+};
+/**
+ * Lookup map of teammate metadata by tool name.
+ *
+ * @private function of `useLlmChatState`
+ */
+type TeammatesMap = Record<string, TeammateMetadata>;
+/**
+ * Minimal task-progress item rendered by `<Chat/>`.
+ *
+ * @private function of `useLlmChatState`
+ */
+type LlmChatTaskProgress = {
+    readonly id: string;
+    readonly name: string;
+    readonly progress?: number;
+};
+/**
+ * State returned by `useLlmChatState`.
+ *
+ * @private function of `useLlmChatState`
+ */
+type UseLlmChatStateResult = {
+    readonly handleMessage: (messageContent: string, attachments?: ChatMessage['attachments']) => Promise<void>;
+    readonly handleReset: () => Promise<void>;
+    readonly handleStopStreaming: () => void;
+    readonly isStreaming: boolean;
+    readonly isVoiceCalling: boolean;
+    readonly messages: Array<ChatMessage>;
+    readonly participants: ReadonlyArray<ChatParticipant>;
+    readonly tasksProgress: Array<LlmChatTaskProgress>;
+    readonly teammates: TeammatesMap | undefined;
+};
+/**
+ * Coordinates derived state and handlers consumed by `<LlmChat/>`.
+ *
+ * @private function of `<LlmChat/>`
+ */
+export declare function useLlmChatState(props: LlmChatProps): UseLlmChatStateResult;
+export {};

package/esm/src/book-components/Chat/MarkdownContent/MarkdownContent.d.ts

@@ -1,4 +1,8 @@
-import type { string_markdown } from '../../../types/typeAliases';
+/// <reference types="react" />
+import type { string_markdown } from '../../../types/string_markdown';
+/**
+ * Props for markdown content.
+ */
 type MarkdownContentProps = {
     content: string_markdown;
     className?: string;
@@ -9,8 +13,5 @@ type MarkdownContentProps = {
  *
  * @public exported from `@promptbook/components`
  */
-export declare function MarkdownContent(props: MarkdownContentProps): import("react/jsx-runtime").JSX.Element;
+export declare const MarkdownContent: import("react").NamedExoticComponent<MarkdownContentProps>;
 export {};
-/**
- * TODO: !!! Split into multiple files
- */

package/esm/src/book-components/Chat/MarkdownContent/MarkdownContent.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/MockedChat/MockedChat.d.ts

@@ -53,7 +53,7 @@ export type MockedChatDelayConfig = {
  *
  * @public exported from `@promptbook/components`
  */
-export type MockedChatProps = Omit<ChatProps, 'onReset' | /*'onMessage' | */ 'onUseTemplate' | 'isVoiceRecognitionButtonShown'> & {
+export type MockedChatProps = Omit<ChatProps, 'onReset' | 'newChatButtonHref' | /*'onMessage' | */ 'onUseTemplate' | 'isVoiceRecognitionButtonShown'> & {
     /**
      * Whether the chat can be reset via the "New chat" button.
      *
@@ -75,6 +75,26 @@ export type MockedChatProps = Omit<ChatProps, 'onReset' | /*'onMessage' | */ 'on
      * @default true
      */
     isPausable?: boolean;
+    /**
+     * Optional absolute offsets (in milliseconds) for each message.
+     *
+     * When provided, playback waits according to these deterministic offsets
+     * instead of random delay heuristics.
+     */
+    readonly messageOffsetsMs?: ReadonlyArray<number>;
+    /**
+     * When true, messages typed in the input are appended only in local UI state.
+     *
+     * This is useful for demo/recording flows where user interaction should not
+     * mutate the persisted mocked-chat preset.
+     *
+     * @default false
+     */
+    readonly appendMessagesLocallyOnSend?: boolean;
+    /**
+     * Optional callback invoked whenever one full simulation run completes.
+     */
+    onSimulationComplete?(): void;
 };
 /**
  * MockedChat component that shows the same chat as Chat but emulates ongoing discussion

package/esm/src/book-components/Chat/MockedChat/constants.d.ts

@@ -37,6 +37,3 @@ export declare const RANDOM_FLOW: MockedChatDelayConfig;
  * @public exported from `@promptbook/components`
  */
 export declare const MOCKED_CHAT_DELAY_CONFIGS: Record<string, MockedChatDelayConfig>;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/book-components/Chat/SourceChip/SourceChip.d.ts

@@ -19,6 +19,10 @@ export type SourceChipProps = {
      * Optional suffix text to display after the citation label.
      */
     suffix?: string;
+    /**
+     * Controls whether the technical citation id is shown inside the chip label.
+     */
+    isCitationIdVisible?: boolean;
 };
 /**
  * SourceChip component - displays a chip with source document information
@@ -26,14 +30,15 @@ export type SourceChipProps = {
  * This component is used to display RAG source citations in chat messages.
  * It displays the source document name and citation ID.
  *
- * @example
  * ```tsx
  * <SourceChip
- *   citation={{ id: '5:13', source: 'document.pdf' }}
- *   onClick={(citation) => console.log('clicked', citation)}
+ * citation={{ id: '5:13', source: 'document.pdf' }}
+ * onClick={(citation) => console.log('clicked', citation)}
  * />
  * ```
  *
+ * @example
+ *
  * @private utility of `ChatMessageItem` component
  */
-export declare function SourceChip({ citation, onClick, className, suffix }: SourceChipProps): import("react/jsx-runtime").JSX.Element;
+export declare function SourceChip({ citation, onClick, className, suffix, isCitationIdVisible }: SourceChipProps): import("react/jsx-runtime").JSX.Element;

package/esm/src/book-components/Chat/effects/components/ConfettiEffect.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Props for confetti effect.
+ */
 type ConfettiEffectProps = {
     /**
      * Unique identifier for this effect instance

package/esm/src/book-components/Chat/effects/components/HeartsEffect.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Props for hearts effect.
+ */
 type HeartsEffectProps = {
     /**
      * Unique identifier for this effect instance

package/esm/src/book-components/Chat/effects/index.d.ts

@@ -12,7 +12,3 @@ export type { ChatEffectConfig } from './types/ChatEffectConfig';
 export type { ChatEffectsSystemProps } from './types/ChatEffectsSystemProps';
 export type { ChatEffectType } from './types/ChatEffectType';
 export { detectEffects } from './utils/detectEffects';
-/**
- * TODO: !!!!! To rules: Do not create index files that re-ex-port from multiple files, import directly instead or use full register
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/book-components/Chat/effects/utils/detectEffects.d.ts

@@ -7,6 +7,7 @@ import type { ChatEffectType } from '../types/ChatEffectType';
  * @param message - The chat message to analyze
  * @param effectConfigs - Array of effect configurations
  * @returns Array of unique effect types to trigger
+ *
  * @private utility function of Effects system
  */
 export declare function detectEffects(message: ChatMessage, effectConfigs: ReadonlyArray<ChatEffectConfig>): ChatEffectType[];

package/esm/src/book-components/Chat/hooks/useChatAutoScroll.d.ts

@@ -1,5 +1,8 @@
+import { type UIEvent } from 'react';
 /**
- * Configuration for the auto-scroll behavior
+ * Configuration for the auto-scroll behavior.
+ *
+ * @public exported from `@promptbook/components`
  */
 export type ChatAutoScrollConfig = {
     /**
@@ -32,8 +35,8 @@ export type ChatAutoScrollConfig = {
 export declare function useChatAutoScroll(config?: ChatAutoScrollConfig): {
     isAutoScrolling: boolean;
     chatMessagesRef: (element: HTMLDivElement | null) => void;
-    handleScroll: (event: React.UIEvent<HTMLDivElement>) => void;
-    handleMessagesChange: () => void;
+    handleScroll: (event: UIEvent<HTMLDivElement, globalThis.UIEvent>) => void;
+    handleMessagesChange: (isStreaming?: boolean | undefined) => void;
     scrollToBottom: () => void;
     enableAutoScroll: () => void;
     disableAutoScroll: () => void;

package/esm/src/book-components/Chat/hooks/useChatAutoScroll.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/book-components/Chat/hooks/useChatCompleteNotification.d.ts

@@ -0,0 +1,20 @@
+import type { ChatSoundSystem } from '../Chat/ChatProps';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Plays the "message received" sound + vibration exactly once when the last
+ * assistant message transitions to a completed / finalized state.
+ *
+ * Notifications are suppressed for:
+ * - Every streaming chunk / intermediate content update
+ * - `message_typing` lifecycle events before the message is finalized
+ * - Re-renders of an already-notified completed message (idempotent)
+ * - Initial mount hydration with preloaded completed chat history
+ * - Switching to another chat thread that already contains completed history
+ * - User-originated messages
+ *
+ * @param messages - Current list of chat messages
+ * @param soundSystem - Optional sound system instance; no-op when absent
+ *
+ * @private internal hook of `<Chat/>`
+ */
+export declare function useChatCompleteNotification(messages: ReadonlyArray<ChatMessage>, soundSystem: ChatSoundSystem | undefined): void;

package/esm/src/book-components/Chat/hooks/useChatCompleteNotification.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/hooks/useChatRatings.d.ts

@@ -1,7 +1,7 @@
 import type { Promisable } from 'type-fest';
-import type { id } from '../../../types/typeAliases';
+import type { id } from '../../../types/string_token';
+import type { ChatFeedbackMode, ChatFeedbackResponse, ChatProps } from '../Chat/ChatProps';
 import type { ChatMessage } from '../types/ChatMessage';
-import type { ChatFeedbackResponse } from '../Chat/ChatProps';
 /**
  * Input parameters for the chat rating hook.
  *
@@ -23,6 +23,14 @@ export type UseChatRatingsOptions = {
         expectedAnswer: string | null;
         url: string;
     }) => Promisable<ChatFeedbackResponse | void>;
+    /**
+     * Feedback mode currently used by the chat UI.
+     */
+    feedbackMode: ChatFeedbackMode;
+    /**
+     * Optional localized labels and status messages used by the feedback UI.
+     */
+    feedbackTranslations?: ChatProps['feedbackTranslations'];
     /**
      * Whether the UI should apply mobile-specific behavior.
      */

package/esm/src/book-components/Chat/hooks/useSendMessageToLlmChat.d.ts

@@ -28,10 +28,10 @@ export type SendMessageToLlmChatFunction = {
  * ```tsx
  * const sendMessage = useSendMessageToLlmChat();
  * return (
- *   <>
- *     <button onClick={() => sendMessage('Hello!')}>Hello</button>
- *     <LlmChat llmTools={llmTools} sendMessage={sendMessage} />
- *   </>
+ * <>
+ * <button onClick={() => sendMessage('Hello!')}>Hello</button>
+ * <LlmChat llmTools={llmTools} sendMessage={sendMessage} />
+ * </>
  * );
  * ```
  *

package/esm/src/book-components/Chat/save/_common/ChatSaveFormatDefinition.d.ts

@@ -1,5 +1,6 @@
 import type { Promisable } from 'type-fest';
-import type { string_file_extension, string_mime_type } from '../../../../types/typeAliases';
+import type { string_mime_type } from '../../../../types/string_mime_type';
+import type { string_file_extension } from '../../../../types/string_sha256';
 import type { ChatMessage } from '../../types/ChatMessage';
 import type { ChatParticipant } from '../../types/ChatParticipant';
 /**