@djangocfg/ui-tools 2.1.376 → 2.1.378

package/dist/index.d.cts

@@ -1927,6 +1927,14 @@ interface UseChatComposerOptions {
      * exactly as before. Plan64.
      */
     persistKey?: string;
+    /**
+     * Skip pre-submit draft sanitation (trim + line-ending normalise +
+     * zero-width strip). Default `false` — sanitation matches what
+     * ChatGPT / Claude / Telegram ship and is what consumers want 99% of
+     * the time. Set to `true` for niche flows that need byte-perfect
+     * passthrough (clipboard inspector, raw-prompt debug tool).
+     */
+    preserveExactValue?: boolean;
 }
 interface UseChatComposerReturn {
     value: string;
@@ -2034,9 +2042,28 @@ interface ToolCallsProps {
     renderStreaming?: (text: string, call: ChatToolCall) => ReactNode;
     /** Single override for all three; specific renderers above take precedence. */
     renderPayload?: (value: unknown, kind: ToolPayloadKind, call: ChatToolCall) => ReactNode;
+    /**
+     * Rendered once **after** all tool-call panels — always visible, outside
+     * the collapsible panels. Use for rich UI derived from tool outputs (e.g.
+     * vehicle cards, map pins, tax breakdowns). Receives the full calls array
+     * so the renderer can aggregate across multiple tool calls.
+     */
+    renderAfterCalls?: (calls: ChatToolCall[]) => ReactNode;
+    /**
+     * Custom renderer for each individual tool-call panel. When provided,
+     * replaces the default collapsible `<ToolCallItem>`. Return `null` to
+     * suppress a specific call while still letting others render.
+     */
+    renderToolCall?: (call: ChatToolCall) => ReactNode;
+    /**
+     * When `true`, the collapsible tool-call panels are not rendered at all.
+     * `renderAfterCalls` still runs — use together to show only rich UI with
+     * no raw accordion panels visible.
+     */
+    hideToolCalls?: boolean;
     className?: string;
 }
-declare function ToolCalls({ calls, defaultExpanded, expandWhileStreaming, renderInput, renderOutput, renderStreaming, renderPayload, className, }: ToolCallsProps): react_jsx_runtime.JSX.Element;
+declare function ToolCalls({ calls, defaultExpanded, expandWhileStreaming, renderInput, renderOutput, renderStreaming, renderPayload, renderAfterCalls, renderToolCall, hideToolCalls, className, }: ToolCallsProps): react_jsx_runtime.JSX.Element;
 
 interface ChatRootProps {
     transport: ChatTransport;
@@ -2425,6 +2452,60 @@ declare function isStringValue(v: unknown): v is string;
 /** Walk the conversation and collect image attachments in chronological order. */
 declare function collectImageAttachments(messages: ChatMessage[]): ChatAttachment[];
 
+/**
+ * sanitizeDraft — minimal pre-submit cleanup for chat-composer drafts.
+ *
+ * Mirrors the conservative behaviour ChatGPT / Claude / Telegram
+ * actually ship: clean the obvious junk the user didn't intend to
+ * send, touch nothing that *could* be intentional.
+ *
+ * **What we DO touch:**
+ *
+ *   1. Trim leading/trailing whitespace (spaces, tabs, newlines,
+ *      NBSP). The user typing `\n\n   hello   \n` meant `hello`.
+ *   2. Normalise line endings — `\r\n` / `\r` → `\n`. Pasted Windows
+ *      / old-mac text gets the same internal shape, so the LLM
+ *      tokeniser and markdown renderer see one canonical form.
+ *   3. Strip zero-width / invisible characters that web-paste
+ *      smuggles in: ZWSP (U+200B), ZWNJ (U+200C), ZWJ (U+200D),
+ *      BOM / ZWNBSP (U+FEFF). They're invisible, break LLM
+ *      tokenisation, and the user never meant to type them.
+ *
+ * **What we DO NOT touch (and why):**
+ *
+ *   - **Internal whitespace runs** (3+ spaces, tabs, blank lines).
+ *     Code indentation depends on these. ChatGPT preserves them as
+ *     typed — "  if (x):\n    return" stays four-space-indented.
+ *     Collapsing them is the path to subtly broken code snippets.
+ *
+ *   - **Bidi override marks** (U+200E LRM, U+200F RLM, U+202A..U+202E).
+ *     Legitimately used in Arabic / Hebrew / mixed-direction text.
+ *     Stripping silently breaks RTL users. If a specific deployment
+ *     wants to block them as a security measure, do it at that layer
+ *     with explicit user-visible feedback.
+ *
+ *   - **Tabs vs spaces** beyond rule 1. Could be either code or
+ *     prose; without parsing markdown we can't tell.
+ *
+ *   - **Emoji, mentions, URLs, code spans** — passthrough text.
+ *
+ * The function is intentionally tiny — every rule earns its keep
+ * with a concrete "user pasted X from Y, got nonsense" story.
+ *
+ * **Idempotent**: `sanitizeDraft(sanitizeDraft(x)) === sanitizeDraft(x)`.
+ */
+declare function sanitizeDraft(input: string): string;
+/**
+ * Convenience predicate: true when the draft is non-empty AFTER
+ * sanitation. Use to gate Send buttons / Enter submits so an empty
+ * or whitespace-only draft never produces a real message.
+ *
+ * Cheaper than sanitizeDraft(input).length > 0 only marginally —
+ * we still allocate the cleaned string. Kept as a named helper for
+ * call-site clarity.
+ */
+declare function isSubmittableDraft(input: string): boolean;
+
 /**
  * Chat dev logger.
  *
@@ -3466,8 +3547,27 @@ interface MarkdownEditorProps {
     mentions?: MentionConfig;
     /** Called when mentioned IDs change */
     onMentionIdsChange?: (ids: string[]) => void;
+    /**
+     * Called when the user presses Enter (without Shift, no IME
+     * composition, no mention popover open). When set, Enter submits
+     * and Shift+Enter inserts a newline — ChatGPT / Telegram chat
+     * behaviour. When omitted, Enter behaves as Tiptap default
+     * (HardBreak).
+     *
+     * Implementation lives in `submitOnEnter.ts` — it's a Tiptap
+     * keymap extension, NOT a React wrapper handler. Wrapper-level
+     * onKeyDown fires AFTER ProseMirror's keymap commits HardBreak in
+     * the same tick; routing through the extension lets us intercept
+     * before HardBreak runs.
+     *
+     * Return value (optional): truthy / undefined = consume the key
+     * (default). Return `false` from onSubmit to let Tiptap fall
+     * through to HardBreak — useful for guards like "don't submit an
+     * empty draft".
+     */
+    onSubmit?: () => boolean | void;
 }
-declare function MarkdownEditor({ value, onChange, placeholder, minHeight, className, disabled, showToolbar, mentions, onMentionIdsChange, }: MarkdownEditorProps): react_jsx_runtime.JSX.Element;
+declare function MarkdownEditor({ value, onChange, placeholder, minHeight, className, disabled, showToolbar, mentions, onMentionIdsChange, onSubmit, }: MarkdownEditorProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Built-in serializers for the `MentionConfig.renderMarkdown` callback.
@@ -3676,4 +3776,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AttachmentRenderer, type AttachmentRendererArgs, type AttachmentRendererMap, Attachments, AttachmentsGrid, type AttachmentsGridProps, AttachmentsList, type AttachmentsListProps, type AttachmentsProps, Player as AudioPlayer, type PlayerProps as AudioPlayerProps, AudioToggle, type AudioToggleProps, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatConfig, type ChatContextValue, type ChatDisplayMode, type ChatEventDetail, type ChatLabels, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, ChatProvider, type ChatProviderProps, type ChatRole, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, type ChatUserContext, CheckboxWidget, ColorWidget, Composer, type ComposerProps, type CreateLazyComponentOptions, type CreateSessionOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, type DisabledWhenRule, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, type Focusable, type HLSSource, HOTKEYS, type HistoryPage, type HttpTransportConfig, type ImageFile, ImageViewer, type ImageViewerProps, type JsonFormContext, type JsonFormDensity, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, JumpToLatest, type JumpToLatestProps, LIMITS, LazyPlayer as LazyAudioPlayer, LazyChat, type ChatRootProps as LazyChatProps, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, TreeRootProps as LazyTreeProps, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, type LinkRule, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListHandle, type MessageListProps, type MockTransportOptions, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, type ParseSSEOptions, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, STORAGE_KEYS, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SendOptions, type SessionInfo, type SimpleStreamSource, SliderWidget, Sources, type SourcesProps, Spinner, type StreamOptions, StreamProvider, type StreamSource, StreamingIndicator, type StreamingIndicatorProps, SwitchWidget, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseAutoFocusOnStreamEndOptions, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type WeekDay, type YouTubeSource, buildCron, collectImageAttachments, createHttpTransport, createId, createLazyComponent, createMockTransport, createTokenBuffer, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useAutoFocusOnStreamEnd, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatLightbox, useChatScroll, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useRegisterComposer, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, validateRequiredFields, validateSchema };
+export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AttachmentRenderer, type AttachmentRendererArgs, type AttachmentRendererMap, Attachments, AttachmentsGrid, type AttachmentsGridProps, AttachmentsList, type AttachmentsListProps, type AttachmentsProps, Player as AudioPlayer, type PlayerProps as AudioPlayerProps, AudioToggle, type AudioToggleProps, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatConfig, type ChatContextValue, type ChatDisplayMode, type ChatEventDetail, type ChatLabels, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, ChatProvider, type ChatProviderProps, type ChatRole, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, type ChatUserContext, CheckboxWidget, ColorWidget, Composer, type ComposerProps, type CreateLazyComponentOptions, type CreateSessionOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, type DisabledWhenRule, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, type Focusable, type HLSSource, HOTKEYS, type HistoryPage, type HttpTransportConfig, type ImageFile, ImageViewer, type ImageViewerProps, type JsonFormContext, type JsonFormDensity, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, JumpToLatest, type JumpToLatestProps, LIMITS, LazyPlayer as LazyAudioPlayer, LazyChat, type ChatRootProps as LazyChatProps, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, TreeRootProps as LazyTreeProps, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, type LinkRule, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListHandle, type MessageListProps, type MockTransportOptions, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, type ParseSSEOptions, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, STORAGE_KEYS, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SendOptions, type SessionInfo, type SimpleStreamSource, SliderWidget, Sources, type SourcesProps, Spinner, type StreamOptions, StreamProvider, type StreamSource, StreamingIndicator, type StreamingIndicatorProps, SwitchWidget, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseAutoFocusOnStreamEndOptions, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type WeekDay, type YouTubeSource, buildCron, collectImageAttachments, createHttpTransport, createId, createLazyComponent, createMockTransport, createTokenBuffer, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isSubmittableDraft, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, sanitizeDraft, useAudioCache, useAutoFocusOnStreamEnd, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatLightbox, useChatScroll, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useRegisterComposer, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, validateRequiredFields, validateSchema };

package/dist/index.d.ts

@@ -1927,6 +1927,14 @@ interface UseChatComposerOptions {
      * exactly as before. Plan64.
      */
     persistKey?: string;
+    /**
+     * Skip pre-submit draft sanitation (trim + line-ending normalise +
+     * zero-width strip). Default `false` — sanitation matches what
+     * ChatGPT / Claude / Telegram ship and is what consumers want 99% of
+     * the time. Set to `true` for niche flows that need byte-perfect
+     * passthrough (clipboard inspector, raw-prompt debug tool).
+     */
+    preserveExactValue?: boolean;
 }
 interface UseChatComposerReturn {
     value: string;
@@ -2034,9 +2042,28 @@ interface ToolCallsProps {
     renderStreaming?: (text: string, call: ChatToolCall) => ReactNode;
     /** Single override for all three; specific renderers above take precedence. */
     renderPayload?: (value: unknown, kind: ToolPayloadKind, call: ChatToolCall) => ReactNode;
+    /**
+     * Rendered once **after** all tool-call panels — always visible, outside
+     * the collapsible panels. Use for rich UI derived from tool outputs (e.g.
+     * vehicle cards, map pins, tax breakdowns). Receives the full calls array
+     * so the renderer can aggregate across multiple tool calls.
+     */
+    renderAfterCalls?: (calls: ChatToolCall[]) => ReactNode;
+    /**
+     * Custom renderer for each individual tool-call panel. When provided,
+     * replaces the default collapsible `<ToolCallItem>`. Return `null` to
+     * suppress a specific call while still letting others render.
+     */
+    renderToolCall?: (call: ChatToolCall) => ReactNode;
+    /**
+     * When `true`, the collapsible tool-call panels are not rendered at all.
+     * `renderAfterCalls` still runs — use together to show only rich UI with
+     * no raw accordion panels visible.
+     */
+    hideToolCalls?: boolean;
     className?: string;
 }
-declare function ToolCalls({ calls, defaultExpanded, expandWhileStreaming, renderInput, renderOutput, renderStreaming, renderPayload, className, }: ToolCallsProps): react_jsx_runtime.JSX.Element;
+declare function ToolCalls({ calls, defaultExpanded, expandWhileStreaming, renderInput, renderOutput, renderStreaming, renderPayload, renderAfterCalls, renderToolCall, hideToolCalls, className, }: ToolCallsProps): react_jsx_runtime.JSX.Element;
 
 interface ChatRootProps {
     transport: ChatTransport;
@@ -2425,6 +2452,60 @@ declare function isStringValue(v: unknown): v is string;
 /** Walk the conversation and collect image attachments in chronological order. */
 declare function collectImageAttachments(messages: ChatMessage[]): ChatAttachment[];
 
+/**
+ * sanitizeDraft — minimal pre-submit cleanup for chat-composer drafts.
+ *
+ * Mirrors the conservative behaviour ChatGPT / Claude / Telegram
+ * actually ship: clean the obvious junk the user didn't intend to
+ * send, touch nothing that *could* be intentional.
+ *
+ * **What we DO touch:**
+ *
+ *   1. Trim leading/trailing whitespace (spaces, tabs, newlines,
+ *      NBSP). The user typing `\n\n   hello   \n` meant `hello`.
+ *   2. Normalise line endings — `\r\n` / `\r` → `\n`. Pasted Windows
+ *      / old-mac text gets the same internal shape, so the LLM
+ *      tokeniser and markdown renderer see one canonical form.
+ *   3. Strip zero-width / invisible characters that web-paste
+ *      smuggles in: ZWSP (U+200B), ZWNJ (U+200C), ZWJ (U+200D),
+ *      BOM / ZWNBSP (U+FEFF). They're invisible, break LLM
+ *      tokenisation, and the user never meant to type them.
+ *
+ * **What we DO NOT touch (and why):**
+ *
+ *   - **Internal whitespace runs** (3+ spaces, tabs, blank lines).
+ *     Code indentation depends on these. ChatGPT preserves them as
+ *     typed — "  if (x):\n    return" stays four-space-indented.
+ *     Collapsing them is the path to subtly broken code snippets.
+ *
+ *   - **Bidi override marks** (U+200E LRM, U+200F RLM, U+202A..U+202E).
+ *     Legitimately used in Arabic / Hebrew / mixed-direction text.
+ *     Stripping silently breaks RTL users. If a specific deployment
+ *     wants to block them as a security measure, do it at that layer
+ *     with explicit user-visible feedback.
+ *
+ *   - **Tabs vs spaces** beyond rule 1. Could be either code or
+ *     prose; without parsing markdown we can't tell.
+ *
+ *   - **Emoji, mentions, URLs, code spans** — passthrough text.
+ *
+ * The function is intentionally tiny — every rule earns its keep
+ * with a concrete "user pasted X from Y, got nonsense" story.
+ *
+ * **Idempotent**: `sanitizeDraft(sanitizeDraft(x)) === sanitizeDraft(x)`.
+ */
+declare function sanitizeDraft(input: string): string;
+/**
+ * Convenience predicate: true when the draft is non-empty AFTER
+ * sanitation. Use to gate Send buttons / Enter submits so an empty
+ * or whitespace-only draft never produces a real message.
+ *
+ * Cheaper than sanitizeDraft(input).length > 0 only marginally —
+ * we still allocate the cleaned string. Kept as a named helper for
+ * call-site clarity.
+ */
+declare function isSubmittableDraft(input: string): boolean;
+
 /**
  * Chat dev logger.
  *
@@ -3466,8 +3547,27 @@ interface MarkdownEditorProps {
     mentions?: MentionConfig;
     /** Called when mentioned IDs change */
     onMentionIdsChange?: (ids: string[]) => void;
+    /**
+     * Called when the user presses Enter (without Shift, no IME
+     * composition, no mention popover open). When set, Enter submits
+     * and Shift+Enter inserts a newline — ChatGPT / Telegram chat
+     * behaviour. When omitted, Enter behaves as Tiptap default
+     * (HardBreak).
+     *
+     * Implementation lives in `submitOnEnter.ts` — it's a Tiptap
+     * keymap extension, NOT a React wrapper handler. Wrapper-level
+     * onKeyDown fires AFTER ProseMirror's keymap commits HardBreak in
+     * the same tick; routing through the extension lets us intercept
+     * before HardBreak runs.
+     *
+     * Return value (optional): truthy / undefined = consume the key
+     * (default). Return `false` from onSubmit to let Tiptap fall
+     * through to HardBreak — useful for guards like "don't submit an
+     * empty draft".
+     */
+    onSubmit?: () => boolean | void;
 }
-declare function MarkdownEditor({ value, onChange, placeholder, minHeight, className, disabled, showToolbar, mentions, onMentionIdsChange, }: MarkdownEditorProps): react_jsx_runtime.JSX.Element;
+declare function MarkdownEditor({ value, onChange, placeholder, minHeight, className, disabled, showToolbar, mentions, onMentionIdsChange, onSubmit, }: MarkdownEditorProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Built-in serializers for the `MentionConfig.renderMarkdown` callback.
@@ -3676,4 +3776,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AttachmentRenderer, type AttachmentRendererArgs, type AttachmentRendererMap, Attachments, AttachmentsGrid, type AttachmentsGridProps, AttachmentsList, type AttachmentsListProps, type AttachmentsProps, Player as AudioPlayer, type PlayerProps as AudioPlayerProps, AudioToggle, type AudioToggleProps, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatConfig, type ChatContextValue, type ChatDisplayMode, type ChatEventDetail, type ChatLabels, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, ChatProvider, type ChatProviderProps, type ChatRole, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, type ChatUserContext, CheckboxWidget, ColorWidget, Composer, type ComposerProps, type CreateLazyComponentOptions, type CreateSessionOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, type DisabledWhenRule, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, type Focusable, type HLSSource, HOTKEYS, type HistoryPage, type HttpTransportConfig, type ImageFile, ImageViewer, type ImageViewerProps, type JsonFormContext, type JsonFormDensity, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, JumpToLatest, type JumpToLatestProps, LIMITS, LazyPlayer as LazyAudioPlayer, LazyChat, type ChatRootProps as LazyChatProps, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, TreeRootProps as LazyTreeProps, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, type LinkRule, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListHandle, type MessageListProps, type MockTransportOptions, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, type ParseSSEOptions, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, STORAGE_KEYS, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SendOptions, type SessionInfo, type SimpleStreamSource, SliderWidget, Sources, type SourcesProps, Spinner, type StreamOptions, StreamProvider, type StreamSource, StreamingIndicator, type StreamingIndicatorProps, SwitchWidget, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseAutoFocusOnStreamEndOptions, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type WeekDay, type YouTubeSource, buildCron, collectImageAttachments, createHttpTransport, createId, createLazyComponent, createMockTransport, createTokenBuffer, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useAutoFocusOnStreamEnd, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatLightbox, useChatScroll, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useRegisterComposer, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, validateRequiredFields, validateSchema };
+export { type ApiKey, ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AttachmentRenderer, type AttachmentRendererArgs, type AttachmentRendererMap, Attachments, AttachmentsGrid, type AttachmentsGridProps, AttachmentsList, type AttachmentsListProps, type AttachmentsProps, Player as AudioPlayer, type PlayerProps as AudioPlayerProps, AudioToggle, type AudioToggleProps, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatConfig, type ChatContextValue, type ChatDisplayMode, type ChatEventDetail, type ChatLabels, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, ChatProvider, type ChatProviderProps, type ChatRole, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, type ChatUserContext, CheckboxWidget, ColorWidget, Composer, type ComposerProps, type CreateLazyComponentOptions, type CreateSessionOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, type DataUrlSource, DayChips, DiffEditor, type DiffEditorProps, type DisabledWhenRule, Editor, type EditorContextValue, type EditorFile, type EditorOptions, type EditorProps, EditorProvider, type EditorRef, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, type Focusable, type HLSSource, HOTKEYS, type HistoryPage, type HttpTransportConfig, type ImageFile, ImageViewer, type ImageViewerProps, type JsonFormContext, type JsonFormDensity, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, JumpToLatest, type JumpToLatestProps, LIMITS, LazyPlayer as LazyAudioPlayer, LazyChat, type ChatRootProps as LazyChatProps, LazyCronScheduler, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyTree, TreeRootProps as LazyTreeProps, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, type LinkRule, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownEditor, type MarkdownEditorProps, MarkdownMessage, type MarkdownMessageProps, type MarkerData, type MentionAttrs, type MentionConfig, type MentionItem, type MentionMarkdownRenderer, Mermaid, type MermaidProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageList, type MessageListHandle, type MessageListProps, type MockTransportOptions, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, type ParseSSEOptions, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, STORAGE_KEYS, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SendOptions, type SessionInfo, type SimpleStreamSource, SliderWidget, Sources, type SourcesProps, Spinner, type StreamOptions, StreamProvider, type StreamSource, StreamingIndicator, type StreamingIndicatorProps, SwitchWidget, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseAutoFocusOnStreamEndOptions, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type WeekDay, type YouTubeSource, buildCron, collectImageAttachments, createHttpTransport, createId, createLazyComponent, createMockTransport, createTokenBuffer, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isSubmittableDraft, isValidCron, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, sanitizeDraft, useAudioCache, useAutoFocusOnStreamEnd, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatHistory, useChatLayout, useChatLightbox, useChatScroll, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useRegisterComposer, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, validateRequiredFields, validateSchema };

package/dist/index.mjs

@@ -5,8 +5,8 @@ export { NativeProvider, StreamProvider, VideoControls, VideoErrorFallback, Vide
 export { ImageViewer } from './chunk-OBRSGM64.mjs';
 export { generateContentKey, useAudioCache, useBlobUrlCleanup, useImageCache, useMediaCacheStore, useVideoCache, useVideoPlayerSettings } from './chunk-C6GXVH5J.mjs';
 export { CronSchedulerProvider, CustomInput, DayChips, MonthDayGrid, SchedulePreview, ScheduleTypeSelector, TimeSelector, buildCron, humanizeCron, isValidCron, parseCron, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays } from './chunk-PVAX67JG.mjs';
-import { LIMITS, createId, useChatContextOptional, useChatAudioPrefs } from './chunk-JXBEKSNT.mjs';
-export { Attachments, AttachmentsGrid, AttachmentsList, CHAT_EVENT_NAME, CSS_VARS, ChatProvider, ChatRoot, Composer, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, EmptyState, ErrorBanner, HOTKEYS, JumpToLatest, LIMITS, MessageActions, MessageBubble, MessageList, STORAGE_KEYS, Sources, StreamingIndicator, ToolCalls, createId, createTokenBuffer, deriveInitials, getChatLogger, initialState, reducer, resolvePersona, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatLayout } from './chunk-JXBEKSNT.mjs';
+import { LIMITS, createId, useChatContextOptional, useChatAudioPrefs } from './chunk-QLMKCSR6.mjs';
+export { Attachments, AttachmentsGrid, AttachmentsList, CHAT_EVENT_NAME, CSS_VARS, ChatProvider, ChatRoot, Composer, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, EmptyState, ErrorBanner, HOTKEYS, JumpToLatest, LIMITS, MessageActions, MessageBubble, MessageList, STORAGE_KEYS, Sources, StreamingIndicator, ToolCalls, createId, createTokenBuffer, deriveInitials, getChatLogger, initialState, isSubmittableDraft, reducer, resolvePersona, sanitizeDraft, useChat, useChatAudio, useChatAudioPrefs, useChatComposer, useChatContext, useChatContextOptional, useChatLayout } from './chunk-QLMKCSR6.mjs';
 export { TreeError, TreeSkeleton, createDemoTree } from './chunk-B6IR5KSC.mjs';
 export { DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, TreeRoot as Tree, TreeChevron, TreeContent, TreeEmpty, TreeIcon, TreeIndentGuides, TreeLabel, TreeProvider, TreeRoot, TreeRow, TreeSearchInput, appearanceToStyle, clearTreeState, createChildCache, flattenTree, loadTreeState, resolveAppearance, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './chunk-ZL7FH4NW.mjs';
 import { PlaygroundProvider } from './chunk-Y6UTOBF6.mjs';
@@ -28,6 +28,7 @@ import Placeholder from '@tiptap/extension-placeholder';
 import Mention from '@tiptap/extension-mention';
 import { Markdown } from '@tiptap/markdown';
 import { autoUpdate, computePosition, offset, flip, shift } from '@floating-ui/dom';
+import { Extension } from '@tiptap/core';
 
 function Spinner({ className }) {
   const t = useAppT();
@@ -348,7 +349,7 @@ var LazyTree = createLazyComponent(
   }
 );
 var LazyChat = createLazyComponent(
-  () => import('./ChatRoot-T7D7QRCH.mjs').then((m) => ({ default: m.ChatRoot })),
+  () => import('./ChatRoot-QOSKJPM6.mjs').then((m) => ({ default: m.ChatRoot })),
   {
     displayName: "LazyChat",
     fallback: /* @__PURE__ */ jsx(LoadingFallback, { minHeight: 320, text: "Loading chat\u2026" })
@@ -1805,6 +1806,33 @@ var mentionPresets = {
   /** Inline HTML span — for products that consume markdown with raw HTML allowed. */
   htmlSpan: /* @__PURE__ */ __name((className = "mention") => ({ label, id }) => `<span class="${className}" data-mention-id="${encodeURIComponent(id)}">@${escapeMd(label || id)}</span>`, "htmlSpan")
 };
+var SubmitOnEnter = Extension.create({
+  name: "submitOnEnter",
+  addOptions() {
+    return {
+      // Default no-op — explicit consumer must override. We never
+      // intercept Enter unless an onSubmit is wired, so leaving the
+      // extension installed with no handler is safe.
+      onSubmit: /* @__PURE__ */ __name(() => false, "onSubmit")
+    };
+  },
+  addKeyboardShortcuts() {
+    return {
+      Enter: /* @__PURE__ */ __name(() => {
+        if (typeof document !== "undefined" && document.querySelector(".markdown-mention-list")) {
+          return false;
+        }
+        const result = this.options.onSubmit();
+        return result !== false;
+      }, "Enter"),
+      // Shift+Enter — always insert a newline. Tiptap's StarterKit
+      // already binds this to HardBreak; we re-bind to `false` (not
+      // handled) so the chain falls through cleanly even if other
+      // extensions try to grab Shift+Enter.
+      "Shift-Enter": /* @__PURE__ */ __name(() => false, "Shift-Enter")
+    };
+  }
+});
 function getMarkdown(editor) {
   const storage = editor.storage.markdown;
   if (!storage?.manager) return editor.getText();
@@ -1830,8 +1858,11 @@ function MarkdownEditor({
   disabled = false,
   showToolbar = true,
   mentions,
-  onMentionIdsChange
+  onMentionIdsChange,
+  onSubmit
 }) {
+  const onSubmitRef = useRef(onSubmit);
+  onSubmitRef.current = onSubmit;
   const isExternalUpdate = useRef(false);
   const initialMentionsDefinedRef = useRef(mentions !== void 0);
   const warnedRef = useRef(false);
@@ -1845,7 +1876,19 @@ function MarkdownEditor({
     const exts = [
       StarterKit.configure({ heading: { levels: [1, 2, 3] } }),
       Placeholder.configure({ placeholder }),
-      Markdown
+      Markdown,
+      // SubmitOnEnter — when the consumer wired an onSubmit, intercept
+      // Enter at the keymap level (before StarterKit's HardBreak).
+      // The extension calls through `onSubmitRef.current` so handler
+      // identity changes don't require an editor rebuild. See
+      // submitOnEnter.ts for the keymap-vs-wrapper-handler rationale.
+      SubmitOnEnter.configure({
+        onSubmit: /* @__PURE__ */ __name(() => {
+          const h = onSubmitRef.current;
+          if (!h) return false;
+          return h();
+        }, "onSubmit")
+      })
     ];
     if (mentions) {
       const renderMarkdown = mentions.renderMarkdown ?? mentionPresets.plainAt;