@promptbook/documents 0.111.0-7 → 0.112.0-101

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

@@ -0,0 +1,39 @@
+import { type ReactElement } from 'react';
+import { Color } from '../../../utils/color/Color';
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { ChatParticipant } from '../types/ChatParticipant';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Rendering options for self-learning tool calls.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderSelfLearningToolCallDetailsOptions = {
+    /**
+     * Tool call being rendered.
+     */
+    toolCall: NonNullable<ChatMessage['toolCalls']>[number];
+    /**
+     * Parsed tool result payload.
+     */
+    resultRaw: TODO_any;
+    /**
+     * Optional agent metadata used for the header avatars.
+     */
+    agentParticipant?: ChatParticipant;
+    /**
+     * Fallback color used when participant metadata is incomplete.
+     */
+    buttonColor: WithTake<Color>;
+};
+/**
+ * Renders the self-learning-specific tool call detail view.
+ *
+ * @param options - Self-learning tool call data.
+ * @returns Self-learning summary UI.
+ *
+ * @private function of ChatToolCallModal
+ */
+export declare function renderSelfLearningToolCallDetails(options: RenderSelfLearningToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -0,0 +1,39 @@
+import { type ReactElement } from 'react';
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+/**
+ * Rendering options for time tool calls.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderTimeToolCallDetailsOptions = {
+    /**
+     * Parsed tool call arguments.
+     */
+    args: Record<string, TODO_any>;
+    /**
+     * Parsed tool result payload.
+     */
+    resultRaw: TODO_any;
+    /**
+     * Timestamp of the tool call itself.
+     */
+    toolCallDate: Date | null;
+    /**
+     * Optional locale override used for date formatting.
+     */
+    locale?: string;
+    /**
+     * Optional translation overrides.
+     */
+    chatUiTranslations?: import('./ChatProps').ChatUiTranslations;
+};
+/**
+ * Renders the time-specific tool call detail view.
+ *
+ * @param options - Time tool call data.
+ * @returns Time visualization UI.
+ *
+ * @private function of ChatToolCallModal
+ */
+export declare function renderTimeToolCallDetails(options: RenderTimeToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -0,0 +1,53 @@
+import { type ReactElement } from 'react';
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+/**
+ * Translation overrides used by timeout detail rendering.
+ *
+ * @private function of ChatToolCallModal
+ */
+type TimeoutToolCallTranslations = import('./ChatProps').ChatUiTranslations;
+/**
+ * Rendering options for timeout tool calls.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderTimeoutToolCallDetailsOptions = {
+    /**
+     * Tool name used to resolve timeout presentation details.
+     */
+    toolCallName: string;
+    /**
+     * Parsed tool call arguments.
+     */
+    args: Record<string, TODO_any>;
+    /**
+     * Parsed tool result payload.
+     */
+    resultRaw: TODO_any;
+    /**
+     * Timestamp of the tool call itself.
+     */
+    toolCallDate: Date | null;
+    /**
+     * Optional callback for switching to advanced mode.
+     */
+    onRequestAdvancedView?: () => void;
+    /**
+     * Optional locale override used for date formatting.
+     */
+    locale?: string;
+    /**
+     * Optional translation overrides.
+     */
+    chatUiTranslations?: TimeoutToolCallTranslations;
+};
+/**
+ * Renders the timeout-specific tool call detail view.
+ *
+ * @param options - Timeout tool call data.
+ * @returns Timeout visualization UI.
+ *
+ * @private function of ChatToolCallModal
+ */
+export declare function renderTimeoutToolCallDetails(options: RenderTimeoutToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -0,0 +1,34 @@
+import { type ReactElement } from 'react';
+/**
+ * Configuration for the shared clock panel used by time and timeout popups.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderToolCallClockPanelOptions = {
+    /**
+     * Date rendered by the analog clock and local labels.
+     */
+    date: Date;
+    /**
+     * Optional relative label.
+     */
+    relativeLabel?: string | null;
+    /**
+     * Optional timezone label shown below the date.
+     */
+    timezoneLabel?: string | null;
+    /**
+     * Optional BCP-47 locale string used to format the local time display.
+     */
+    locale?: string;
+};
+/**
+ * Renders a shared analog-clock panel used by time and timeout tool views.
+ *
+ * @param options - Clock panel rendering options.
+ * @returns Clock section with local date/time labels.
+ *
+ * @private function of ChatToolCallModal
+ */
+export declare function renderToolCallClockPanel(options: RenderToolCallClockPanelOptions): ReactElement;
+export {};

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

@@ -0,0 +1,50 @@
+import { type ReactElement } from 'react';
+import { Color } from '../../../utils/color/Color';
+import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatParticipant } from '../types/ChatParticipant';
+/**
+ * Options for rendering a tool call detail view.
+ *
+ * @private utility of `<ChatToolCallModal/>`
+ */
+type ToolCallDetailsOptions = {
+    /**
+     * Tool call to render.
+     */
+    toolCall: NonNullable<ChatMessage['toolCalls']>[number];
+    /**
+     * Optional mapping of tool titles.
+     */
+    toolTitles?: Record<string, string>;
+    /**
+     * Agent participant metadata for avatar details.
+     */
+    agentParticipant?: ChatParticipant;
+    /**
+     * Chat button color for fallback styling.
+     */
+    buttonColor: WithTake<Color>;
+    /**
+     * Requests switching the modal into advanced technical mode.
+     */
+    onRequestAdvancedView?: () => void;
+    /**
+     * Optional BCP-47 locale string used to format time labels.
+     */
+    locale?: string;
+    /**
+     * Optional localized label overrides for the tool call modal UI.
+     */
+    chatUiTranslations?: import('./ChatProps').ChatUiTranslations;
+};
+/**
+ * Renders the detail view for a single tool call.
+ *
+ * @param options - Rendering options for the tool call.
+ * @returns Simple tool-call detail JSX.
+ *
+ * @private function of ChatToolCallModal
+ */
+export declare function renderToolCallDetails(options: ToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -0,0 +1,30 @@
+import { type ReactElement } from 'react';
+/**
+ * Rendering options for the shared pending-state placeholder card.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderToolCallProgressPlaceholderOptions = {
+    /**
+     * Title displayed at the top of the placeholder.
+     */
+    title: string;
+    /**
+     * Supporting message explaining the current state.
+     */
+    message: string;
+    /**
+     * Optional badge label shown in the header.
+     */
+    badgeLabel?: string;
+};
+/**
+ * Renders a shared placeholder card for pending and partial tool-call details.
+ *
+ * @param options - Placeholder copy and optional badge label.
+ * @returns Placeholder JSX.
+ *
+ * @private function of ChatToolCallModal
+ */
+export declare function renderToolCallProgressPlaceholder(options: RenderToolCallProgressPlaceholderOptions): ReactElement;
+export {};

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

@@ -0,0 +1,27 @@
+import { type ReactElement } from 'react';
+import type { WalletCredentialToolCallResult } from '../utils/walletCredentialToolCall';
+/**
+ * Rendering options for wallet credential tool calls.
+ *
+ * @private function of ChatToolCallModal
+ */
+type RenderWalletCredentialToolCallDetailsOptions = {
+    /**
+     * Safe credential usage metadata.
+     */
+    credential: WalletCredentialToolCallResult;
+    /**
+     * Optional timestamp of the action.
+     */
+    toolCallDate: Date | null;
+};
+/**
+ * Renders a friendly wallet-credential usage summary for non-technical users.
+ *
+ * @param options - Credential payload and optional timestamp.
+ * @returns Credential details section for the tool modal.
+ *
+ * @private function of ChatToolCallModal
+ */
+export declare function renderWalletCredentialToolCallDetails(options: RenderWalletCredentialToolCallDetailsOptions): ReactElement;
+export {};

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

@@ -0,0 +1,146 @@
+import type { ToolCallLogEntry, ToolCallState } from '../../../types/ToolCall';
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { RunBrowserToolArtifact, RunBrowserToolError } from '../utils/toolCallParsing/RunBrowserToolResult';
+/**
+ * One browser tool call rendered in the replay modal.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type RunBrowserToolCall = NonNullable<ChatMessage['toolCalls']>[number];
+/**
+ * Rendering options needed to derive browser replay state.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type ResolveRunBrowserToolCallDetailsStateOptions = {
+    /**
+     * Tool call being rendered.
+     */
+    toolCall: RunBrowserToolCall;
+    /**
+     * Parsed tool call arguments.
+     */
+    args: Record<string, TODO_any>;
+    /**
+     * Parsed tool result payload.
+     */
+    resultRaw: TODO_any;
+};
+/**
+ * Current visual state rendered for one browser action row in the modal.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type BrowserActionRowState = 'pending' | 'running' | 'complete' | 'error';
+/**
+ * One browser action row rendered in the simple browser-tool view.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type BrowserActionRow = {
+    /**
+     * Stable row key.
+     */
+    key: string;
+    /**
+     * Human-readable action summary.
+     */
+    label: string;
+    /**
+     * Current action state.
+     */
+    state: BrowserActionRowState;
+};
+/**
+ * One metadata row rendered in the browser replay summary block.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type RunBrowserMetaItem = {
+    /**
+     * Stable key for React rendering.
+     */
+    key: string;
+    /**
+     * User-facing row label.
+     */
+    label: string;
+    /**
+     * User-facing row value.
+     */
+    value: string;
+    /**
+     * Optional link target when the value is a URL.
+     */
+    href?: string;
+};
+/**
+ * Fully derived browser replay state consumed by render helpers.
+ *
+ * @private type of resolveRunBrowserToolCallDetailsState
+ */
+type RunBrowserToolCallDetailsState = {
+    /**
+     * Original tool call currently being rendered.
+     */
+    toolCall: RunBrowserToolCall;
+    /**
+     * Resolved lifecycle state of the tool call snapshot.
+     */
+    toolCallState: ToolCallState;
+    /**
+     * Metadata rows shown at the top of the replay UI.
+     */
+    metaItems: Array<RunBrowserMetaItem>;
+    /**
+     * Browser-session log entry surfaced as a status banner.
+     */
+    browserReadyLog: ToolCallLogEntry | null;
+    /**
+     * Parsed browser warning message, when present.
+     */
+    warning: string | null;
+    /**
+     * Parsed fallback extracted content, when present.
+     */
+    fallbackContent: string | null;
+    /**
+     * Parsed browser error, when present.
+     */
+    runBrowserError: RunBrowserToolError | null;
+    /**
+     * Visual artifacts captured during the browser session.
+     */
+    artifacts: Array<RunBrowserToolArtifact>;
+    /**
+     * Ordered action rows combining requested actions, streamed logs, and final summaries.
+     */
+    actionRows: Array<BrowserActionRow>;
+    /**
+     * Indicates that the visual replay placeholder should be shown.
+     */
+    isVisualReplayPending: boolean;
+    /**
+     * Indicates that the empty visual replay state should be shown.
+     */
+    isVisualReplayEmpty: boolean;
+    /**
+     * Indicates that the action-plan placeholder should be shown.
+     */
+    isActionPlanPending: boolean;
+    /**
+     * Indicates that a streaming issue notice should be shown below the sections.
+     */
+    isStreamingErrorNoticeVisible: boolean;
+};
+/**
+ * Resolves all derived state needed by `renderRunBrowserToolCallDetails`.
+ *
+ * @param options - Raw browser tool-call data.
+ * @returns Derived state ready for focused render helpers.
+ *
+ * @private function of renderRunBrowserToolCallDetails
+ */
+export declare function resolveRunBrowserToolCallDetailsState(options: ResolveRunBrowserToolCallDetailsStateOptions): RunBrowserToolCallDetailsState;
+export {};

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

@@ -0,0 +1,30 @@
+/**
+ * Runtime voice UI states shown on the primary microphone control.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export type DictationUiState = 'idle' | 'listening' | 'processing' | 'error' | 'disabled';
+/**
+ * Visual tone used by the floating speech-status bubble.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export type SpeechStatusBubbleTone = 'neutral' | 'recording' | 'processing' | 'error';
+/**
+ * UI metadata derived from the current speech-recognition state.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export type SpeechRecognitionUiDescriptor = {
+    readonly buttonTitle: string;
+    readonly bubbleText?: string;
+    readonly bubbleTone?: SpeechStatusBubbleTone;
+    readonly isButtonActive: boolean;
+    readonly isButtonDisabled: boolean;
+};
+/**
+ * Resolves voice-button and floating-bubble UI from a speech-recognition state.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function resolveSpeechRecognitionUiDescriptor(state: DictationUiState): SpeechRecognitionUiDescriptor;

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

@@ -0,0 +1,10 @@
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * Maps tool-call state into friendly running copy used by simple modal sections.
+ *
+ * @param toolCall - Tool call currently rendered in the modal.
+ * @returns Friendly progress message for the current tool state.
+ *
+ * @private function of ChatToolCallModal
+ */
+export declare function resolveToolCallProgressMessage(toolCall: NonNullable<ChatMessage['toolCalls']>[number]): string;

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

@@ -0,0 +1,32 @@
+import { type ChangeEvent, type ClipboardEvent, type DragEvent } from 'react';
+import type { ChatInputUploadedFile } from './ChatInputUploadedFile';
+import type { ChatProps } from './ChatProps';
+/**
+ * Props for `useChatInputAreaAttachments`.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+type UseChatInputAreaAttachmentsProps = {
+    onFileUpload?: ChatProps['onFileUpload'];
+};
+/**
+ * Handles file-upload state and drag/drop events for the chat composer.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+export declare function useChatInputAreaAttachments({ onFileUpload }: UseChatInputAreaAttachmentsProps): {
+    fileInputRef: import("react").RefObject<HTMLInputElement | null>;
+    uploadedFiles: ChatInputUploadedFile[];
+    uploadedFilesRef: import("react").RefObject<ChatInputUploadedFile[]>;
+    isDragOver: boolean;
+    isUploading: boolean;
+    handleDrop: (event: DragEvent) => void;
+    handleDragOver: (event: DragEvent) => void;
+    handleDragLeave: (event: DragEvent) => void;
+    handlePaste: (event: ClipboardEvent) => void;
+    handleFileInputChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    removeUploadedFile: (fileId: string) => void;
+    clearUploadedFiles: () => void;
+    openFilePicker: () => void;
+};
+export {};

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

@@ -0,0 +1,39 @@
+import { type ChangeEvent, type KeyboardEvent as ReactKeyboardEvent, type MutableRefObject } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+import type { ChatInputUploadedFile } from './ChatInputUploadedFile';
+import type { ChatProps, ChatSoundSystem } from './ChatProps';
+/**
+ * Props for `useChatInputAreaComposer`.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+type UseChatInputAreaComposerProps = {
+    readonly onMessage?: ChatProps['onMessage'];
+    readonly onChange?: ChatProps['onChange'];
+    readonly defaultMessage?: string;
+    readonly enterBehavior?: ChatProps['enterBehavior'];
+    readonly resolveEnterBehavior?: ChatProps['resolveEnterBehavior'];
+    readonly isFocusedOnLoad?: boolean;
+    readonly isMobile: boolean;
+    readonly uploadedFiles: ReadonlyArray<ChatInputUploadedFile>;
+    readonly uploadedFilesRef: MutableRefObject<Array<ChatInputUploadedFile>>;
+    readonly clearUploadedFiles: () => void;
+    readonly replyingToMessage?: ChatMessage | null;
+    readonly onCancelReply?: ChatProps['onCancelReply'];
+    readonly soundSystem?: ChatSoundSystem;
+};
+/**
+ * Manages textarea state, send/newline behavior, and deferred Enter resolution for `<ChatInputArea/>`.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+export declare function useChatInputAreaComposer(props: UseChatInputAreaComposerProps): {
+    textareaRef: import("react").RefObject<HTMLTextAreaElement | null>;
+    messageContent: string;
+    messageContentRef: import("react").RefObject<string>;
+    applyMessageContent: (nextContent: string) => void;
+    handleTextInputChange: (event: ChangeEvent<HTMLTextAreaElement, Element>) => void;
+    handleComposerKeyDown: (event: ReactKeyboardEvent<HTMLTextAreaElement>) => void;
+    handleSend: () => Promise<void>;
+};
+export {};

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

@@ -0,0 +1,53 @@
+import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
+import type { SpeechRecognitionErrorCode } from '../../../types/SpeechRecognition';
+import type { ChatProps } from './ChatProps';
+import type { DictationRefinementSettings } from './refineFinalDictationChunk';
+/**
+ * Stable dictation error shape consumed by the correction panel UI.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+type DictationError = {
+    readonly code?: SpeechRecognitionErrorCode;
+    readonly message: string;
+};
+/**
+ * Props for `useChatInputAreaDictation`.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+type UseChatInputAreaDictationProps = {
+    speechRecognition?: ChatProps['speechRecognition'];
+    speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
+    textareaRef: MutableRefObject<HTMLTextAreaElement | null>;
+    messageContentRef: MutableRefObject<string>;
+    applyMessageContent: (nextContent: string) => void;
+};
+/**
+ * Manages speech-recognition state, transcript refinement, and correction UI.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+export declare function useChatInputAreaDictation({ speechRecognition, speechRecognitionLanguage, textareaRef, messageContentRef, applyMessageContent, }: UseChatInputAreaDictationProps): {
+    speechRecognitionUiDescriptor: import("./resolveSpeechRecognitionUiDescriptor").SpeechRecognitionUiDescriptor;
+    shouldShowDictationPanel: boolean;
+    isDictationPanelExpanded: boolean;
+    toggleDictationPanel: () => void;
+    expandDictationPanel: () => void;
+    dictationInterimText: string;
+    dictationError: DictationError | null;
+    dictationLastFinalChunk: string;
+    dictationEditableChunk: string;
+    setDictationEditableChunk: Dispatch<SetStateAction<string>>;
+    canBacktrack: boolean;
+    dictationSettings: DictationRefinementSettings;
+    handleDictationSettingChange: (settingName: keyof DictationRefinementSettings, checked: boolean) => void;
+    handleToggleVoiceInput: () => void;
+    handleBacktrackLastChunk: () => void;
+    handleApplyCorrection: () => void;
+    handleRetryPermissionRequest: () => void;
+    handleOpenBrowserSettings: () => void;
+    canOpenBrowserSettings: boolean;
+    isBrowserSpeechFallbackSupported: boolean;
+};
+export {};

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

@@ -0,0 +1,20 @@
+import { type Dispatch, type SetStateAction } from 'react';
+import type { DictationDictionary, DictationRefinementSettings } from './refineFinalDictationChunk';
+/**
+ * Persistent dictation state shared by the dictation hook and its helpers.
+ *
+ * @private function of `useChatInputAreaDictationPersistence`
+ */
+type UseChatInputAreaDictationPersistenceResult = {
+    readonly dictationSettings: DictationRefinementSettings;
+    readonly setDictationSettings: Dispatch<SetStateAction<DictationRefinementSettings>>;
+    readonly dictationDictionary: DictationDictionary;
+    readonly setDictationDictionary: Dispatch<SetStateAction<DictationDictionary>>;
+};
+/**
+ * Manages local-storage-backed dictation preferences and the learned dictionary.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function useChatInputAreaDictationPersistence(): UseChatInputAreaDictationPersistenceResult;
+export {};

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

@@ -0,0 +1,29 @@
+import type { ChatProps } from './ChatProps';
+import type { DictationUiState, SpeechRecognitionUiDescriptor } from './resolveSpeechRecognitionUiDescriptor';
+/**
+ * Props for `useChatInputAreaDictationSupport`.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+type UseChatInputAreaDictationSupportProps = {
+    readonly dictationUiState: DictationUiState;
+    readonly speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
+};
+/**
+ * Browser-derived metadata used by the dictation UI.
+ *
+ * @private function of `useChatInputAreaDictationSupport`
+ */
+type UseChatInputAreaDictationSupportResult = {
+    readonly speechRecognitionUiDescriptor: SpeechRecognitionUiDescriptor;
+    readonly resolvedSpeechRecognitionLanguage: string;
+    readonly isBrowserSpeechFallbackSupported: boolean;
+    readonly microphoneSettingsUrl?: string;
+};
+/**
+ * Resolves browser and language metadata derived from the current dictation UI state.
+ *
+ * @private function of `useChatInputAreaDictation`
+ */
+export declare function useChatInputAreaDictationSupport({ dictationUiState, speechRecognitionLanguage, }: UseChatInputAreaDictationSupportProps): UseChatInputAreaDictationSupportResult;
+export {};

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

@@ -0,0 +1,31 @@
+import { type RefObject } from 'react';
+/**
+ * Absolute screen position used for the avatar profile tooltip.
+ *
+ * @private internal helper of `<ChatMessageItem/>`
+ */
+type AvatarTooltipPosition = {
+    readonly top: number;
+    readonly left: number;
+};
+/**
+ * State and handlers used by the avatar profile tooltip behavior.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export type UseChatMessageAvatarTooltipResult = {
+    readonly avatarRef: RefObject<HTMLDivElement | null>;
+    readonly tooltipRef: RefObject<HTMLDivElement | null>;
+    readonly isAvatarTooltipVisible: boolean;
+    readonly avatarTooltipPosition: AvatarTooltipPosition | null;
+    readonly showTooltip: () => void;
+    readonly handleMouseEnter: () => void;
+    readonly handleMouseLeave: () => void;
+};
+/**
+ * Manages delayed avatar tooltip display and outside-dismiss behavior.
+ *
+ * @private internal hook of `<ChatMessageItem/>`
+ */
+export declare function useChatMessageAvatarTooltip(): UseChatMessageAvatarTooltipResult;
+export {};