@djangocfg/ui-tools 2.1.387 → 2.1.390

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType, RefObject, ChangeEvent, KeyboardEvent, ClipboardEvent, CSSProperties, ButtonHTMLAttributes, MouseEvent } from 'react';
-import { Components } from 'react-markdown';
 import { ViewState } from 'react-map-gl/maplibre';
 import { Language } from 'prism-react-renderer';
 export { Language } from 'prism-react-renderer';
@@ -16,6 +15,7 @@ export { c as DEFAULT_TREE_APPEARANCE, D as DEFAULT_TREE_LABELS, F as FlatRow, R
 import * as zustand from 'zustand';
 import { AudioPrefsState } from '@djangocfg/ui-core/hooks';
 import { ConsolaInstance } from 'consola';
+import { Components } from 'react-markdown';
 import { MediaPlayerInstance } from '@vidstack/react';
 import * as monaco from 'monaco-editor';
 import { Editor as Editor$1 } from '@tiptap/react';
@@ -117,220 +117,6 @@ declare function createLazyComponent<P extends object>(loader: () => Promise<{
     default: ComponentType<P>;
 }>, options?: CreateLazyComponentOptions<P>): ComponentType<P>;
 
-/**
- * Declarative rule for handling a custom URL scheme inside markdown.
- *
- * Each rule owns one href shape (e.g. `cmdop://machine/<uuid>`,
- * `obsidian://open?path=…`) and decides:
- *
- *   1. Whether the URL scheme survives sanitize (`protocols`).
- *   2. How to massage the source markdown before render
- *      (`preprocess` — optional; useful for stripping decorative
- *      prefixes like the `@` in `@[label](href)` so the chip alone
- *      reads as the mention indicator).
- *   3. Which links it owns (`match`), and how to render them
- *      (`render`, returning JSX).
- *
- * Rules compose: pass an array, and the renderer iterates top-to-bottom
- * picking the first `match` hit per `<a>`. Anything no rule claims
- * falls through to the built-in chat-link styling (or to a custom
- * `customComponents.a` if both are provided).
- *
- * Prefer `linkRules` over `customComponents` + `extraHrefProtocols` —
- * it's the same pieces with the boilerplate removed.
- */
-interface LinkRule {
-    /** Pre-process the raw markdown source before any rendering happens.
-     *  Pure / synchronous; identity-return when no transform applies. */
-    preprocess?: (source: string) => string;
-    /** Predicate against the resolved href. */
-    match: (href: string) => boolean;
-    /** Render the link this rule owns. `children` is the link's label
-     *  (markdown-rendered React content). */
-    render: (props: {
-        href: string;
-        children: react__default.ReactNode;
-        isUser: boolean;
-    }) => react__default.ReactNode;
-    /** URL scheme(s) to whitelist on the sanitize side, e.g. `['cmdop']`.
-     *  Bare schemes only — no `://`. Optional; omit for `http(s)` rules. */
-    protocols?: readonly string[];
-    /** Diagnostic label, surfaced in dev warnings. Optional. */
-    name?: string;
-}
-interface MarkdownMessageProps {
-    /** Markdown content to render */
-    content: string;
-    /** Additional CSS classes */
-    className?: string;
-    /** Whether the message is from the user (affects styling) */
-    isUser?: boolean;
-    /** Use compact size (text-xs instead of text-sm) */
-    isCompact?: boolean;
-    /**
-     * Force the plain-text rendering path (single `<div>` with
-     * `white-space: pre-wrap`, no ReactMarkdown). Use this for
-     * user-authored content where markdown shouldn't be parsed.
-     *
-     * When `undefined` (default) we run a small heuristic
-     * (`looksLikePlainProse`): short single-paragraph text without
-     * markdown markers → plain; everything else → ReactMarkdown.
-     *
-     * Pass an explicit `true` / `false` to opt out of the heuristic
-     * entirely.
-     */
-    plainText?: boolean;
-    /**
-     * Per-tag overrides merged on top of the built-in renderers.
-     *
-     * Use this when you need custom rendering for a specific tag without
-     * losing the chat-tuned defaults (links, code blocks with copy, etc).
-     *
-     * For custom URL-scheme link handling, prefer `linkRules` — it's the
-     * same ergonomics with the per-consumer boilerplate removed.
-     */
-    customComponents?: Partial<Components>;
-    /**
-     * Extra URL protocols allowed in `<a href>` after sanitize.
-     *
-     * The default schema strips anything that isn't
-     * `http(s)/mailto/xmpp/irc(s)` — your custom renderer would receive
-     * `href={undefined}` for `cmdop://…` / `obsidian://…` etc. Listing
-     * the bare scheme here (e.g. `'cmdop'`, NOT `'cmdop://'`) opts it in.
-     *
-     * Use carefully: every protocol you add increases what the rendered
-     * HTML can do via clicks. Stick to schemes you control.
-     */
-    extraHrefProtocols?: readonly string[];
-    /**
-     * Declarative link rules — preferred over `customComponents` +
-     * `extraHrefProtocols` for chat-style apps that want pluggable
-     * URL-scheme handling without re-implementing the custom-`a`
-     * boilerplate per consumer.
-     *
-     * If you provide both `linkRules` and `extraHrefProtocols`, the
-     * effective protocol list is the union of the two.
-     */
-    linkRules?: readonly LinkRule[];
-    /**
-     * Enable collapsible "Read more..." functionality
-     * @default false
-     */
-    collapsible?: boolean;
-    /** Maximum character length before showing "Read more...". */
-    maxLength?: number;
-    /** Maximum number of lines before showing "Read more...". */
-    maxLines?: number;
-    /** Custom "Read more" button text. @default "Read more..." */
-    readMoreLabel?: string;
-    /** Custom "Show less" button text. @default "Show less" */
-    showLessLabel?: string;
-    /** Start expanded (only when `collapsible` is true). @default false */
-    defaultExpanded?: boolean;
-    /** Callback when collapsed state changes */
-    onCollapseChange?: (isCollapsed: boolean) => void;
-}
-
-/**
- * MarkdownMessage — chat-tuned markdown renderer.
- *
- * Features:
- * - GitHub Flavored Markdown (GFM) via remark-gfm
- * - Syntax-highlighted code blocks with Copy button
- * - Mermaid diagram rendering (` ```mermaid ` fence)
- * - Tables, lists, blockquotes scaled for chat density
- * - User vs assistant styling modes (`isUser`)
- * - Plain-text fast path: skips ReactMarkdown when content has no
- *   markdown syntax (cheaper render, preserves newlines via CSS)
- * - Optional collapsible "Read more..." for long messages
- *
- * Custom URL schemes (chat mentions, deep-links, custom file viewers)
- * are best handled with the declarative `linkRules` prop — see the
- * type definition in `./types.ts` and the storybook for examples.
- *
- * @example
- * ```tsx
- * <MarkdownMessage content="# Hello\n\nThis is **bold** text." />
- *
- * // User message styling
- * <MarkdownMessage content="Some content" isUser />
- *
- * // Custom URL scheme via linkRules
- * <MarkdownMessage
- *   content="Talk to [Vps-audi](cmdop://machine/abc-123)"
- *   linkRules={[machineMentionRule]}
- * />
- * ```
- *
- * Memoised: re-renders only when props change. `content` is the main
- * trigger — all other props (className, isUser, isCompact, etc.) are
- * compared by value/reference. `onCollapseChange` is compared by
- * reference — callers should stabilise it with useCallback.
- */
-declare function MarkdownMessageRaw({ content, className, isUser, isCompact, plainText, customComponents, extraHrefProtocols, linkRules, collapsible, maxLength, maxLines, readMoreLabel, showLessLabel, defaultExpanded, onCollapseChange, }: MarkdownMessageProps): react_jsx_runtime.JSX.Element;
-declare const MarkdownMessage: react__default.MemoExoticComponent<typeof MarkdownMessageRaw>;
-
-/** Recursively concatenate the text content of a React.ReactNode tree.
- *  Used by the markdown renderers (e.g. `<pre>` extracting code) and
- *  by consumers that need a plain-string label out of link children. */
-declare function extractTextFromChildren(children: react__default.ReactNode): string;
-
-interface UseCollapsibleContentOptions {
-    /**
-     * Maximum character length before collapsing
-     * If both maxLength and maxLines are set, the stricter limit applies
-     */
-    maxLength?: number;
-    /**
-     * Maximum number of lines before collapsing
-     * If both maxLength and maxLines are set, the stricter limit applies
-     */
-    maxLines?: number;
-    /**
-     * Start in expanded state (default: false - starts collapsed)
-     */
-    defaultExpanded?: boolean;
-}
-interface UseCollapsibleContentResult {
-    /** Whether content is currently collapsed */
-    isCollapsed: boolean;
-    /** Toggle between collapsed/expanded state */
-    toggleCollapsed: () => void;
-    /** Set collapsed state directly */
-    setCollapsed: (collapsed: boolean) => void;
-    /** Content to display (truncated if collapsed, full if expanded) */
-    displayContent: string;
-    /** Whether the content exceeds limits and should be collapsible */
-    shouldCollapse: boolean;
-    /** Original content length */
-    originalLength: number;
-    /** Original line count */
-    originalLineCount: number;
-}
-/**
- * Hook for managing collapsible content with "Read more..." functionality
- *
- * @example
- * ```tsx
- * const { isCollapsed, toggleCollapsed, displayContent, shouldCollapse } = useCollapsibleContent(
- *   longText,
- *   { maxLength: 300, maxLines: 5 }
- * );
- *
- * return (
- *   <div>
- *     <Markdown content={displayContent} />
- *     {shouldCollapse && (
- *       <button onClick={toggleCollapsed}>
- *         {isCollapsed ? 'Read more...' : 'Show less'}
- *       </button>
- *     )}
- *   </div>
- * );
- * ```
- */
-declare function useCollapsibleContent(content: string, options?: UseCollapsibleContentOptions): UseCollapsibleContentResult;
-
 interface MarkerData {
     id: string;
     longitude: number;
@@ -3626,8 +3412,6 @@ interface ChatDestructiveStyles {
  */
 declare function useChatDestructiveStyles(): ChatDestructiveStyles;
 
-declare const LazyChat: react.ComponentType<ChatRootProps>;
-
 interface MessageListProps {
     messages?: ChatMessage[];
     renderItem?: (m: ChatMessage, i: number) => ReactNode;
@@ -3836,6 +3620,203 @@ interface AudioToggleProps {
 }
 declare function AudioToggle({ size, variant, alwaysShow, className, }: AudioToggleProps): react_jsx_runtime.JSX.Element;
 
+declare const LazyChat: react.ComponentType<ChatRootProps>;
+
+/**
+ * Declarative rule for handling a custom URL scheme inside markdown.
+ *
+ * Each rule owns one href shape (e.g. `cmdop://machine/<uuid>`,
+ * `obsidian://open?path=…`) and decides:
+ *
+ *   1. Whether the URL scheme survives sanitize (`protocols`).
+ *   2. How to massage the source markdown before render
+ *      (`preprocess` — optional; useful for stripping decorative
+ *      prefixes like the `@` in `@[label](href)` so the chip alone
+ *      reads as the mention indicator).
+ *   3. Which links it owns (`match`), and how to render them
+ *      (`render`, returning JSX).
+ *
+ * Rules compose: pass an array, and the renderer iterates top-to-bottom
+ * picking the first `match` hit per `<a>`. Anything no rule claims
+ * falls through to the built-in chat-link styling (or to a custom
+ * `customComponents.a` if both are provided).
+ *
+ * Prefer `linkRules` over `customComponents` + `extraHrefProtocols` —
+ * it's the same pieces with the boilerplate removed.
+ */
+interface LinkRule {
+    /** Pre-process the raw markdown source before any rendering happens.
+     *  Pure / synchronous; identity-return when no transform applies. */
+    preprocess?: (source: string) => string;
+    /** Predicate against the resolved href. */
+    match: (href: string) => boolean;
+    /** Render the link this rule owns. `children` is the link's label
+     *  (markdown-rendered React content). */
+    render: (props: {
+        href: string;
+        children: react__default.ReactNode;
+        isUser: boolean;
+    }) => react__default.ReactNode;
+    /** URL scheme(s) to whitelist on the sanitize side, e.g. `['cmdop']`.
+     *  Bare schemes only — no `://`. Optional; omit for `http(s)` rules. */
+    protocols?: readonly string[];
+    /** Diagnostic label, surfaced in dev warnings. Optional. */
+    name?: string;
+}
+interface MarkdownMessageProps {
+    /** Markdown content to render */
+    content: string;
+    /** Additional CSS classes */
+    className?: string;
+    /** Whether the message is from the user (affects styling) */
+    isUser?: boolean;
+    /** Use compact size (text-xs instead of text-sm) */
+    isCompact?: boolean;
+    /**
+     * Force the plain-text rendering path (single `<div>` with
+     * `white-space: pre-wrap`, no ReactMarkdown). Use this for
+     * user-authored content where markdown shouldn't be parsed.
+     *
+     * When `undefined` (default) we run a small heuristic
+     * (`looksLikePlainProse`): short single-paragraph text without
+     * markdown markers → plain; everything else → ReactMarkdown.
+     *
+     * Pass an explicit `true` / `false` to opt out of the heuristic
+     * entirely.
+     */
+    plainText?: boolean;
+    /**
+     * Per-tag overrides merged on top of the built-in renderers.
+     *
+     * Use this when you need custom rendering for a specific tag without
+     * losing the chat-tuned defaults (links, code blocks with copy, etc).
+     *
+     * For custom URL-scheme link handling, prefer `linkRules` — it's the
+     * same ergonomics with the per-consumer boilerplate removed.
+     */
+    customComponents?: Partial<Components>;
+    /**
+     * Extra URL protocols allowed in `<a href>` after sanitize.
+     *
+     * The default schema strips anything that isn't
+     * `http(s)/mailto/xmpp/irc(s)` — your custom renderer would receive
+     * `href={undefined}` for `cmdop://…` / `obsidian://…` etc. Listing
+     * the bare scheme here (e.g. `'cmdop'`, NOT `'cmdop://'`) opts it in.
+     *
+     * Use carefully: every protocol you add increases what the rendered
+     * HTML can do via clicks. Stick to schemes you control.
+     */
+    extraHrefProtocols?: readonly string[];
+    /**
+     * Declarative link rules — preferred over `customComponents` +
+     * `extraHrefProtocols` for chat-style apps that want pluggable
+     * URL-scheme handling without re-implementing the custom-`a`
+     * boilerplate per consumer.
+     *
+     * If you provide both `linkRules` and `extraHrefProtocols`, the
+     * effective protocol list is the union of the two.
+     */
+    linkRules?: readonly LinkRule[];
+    /**
+     * Enable collapsible "Read more..." functionality
+     * @default false
+     */
+    collapsible?: boolean;
+    /** Maximum character length before showing "Read more...". */
+    maxLength?: number;
+    /** Maximum number of lines before showing "Read more...". */
+    maxLines?: number;
+    /** Custom "Read more" button text. @default "Read more..." */
+    readMoreLabel?: string;
+    /** Custom "Show less" button text. @default "Show less" */
+    showLessLabel?: string;
+    /** Start expanded (only when `collapsible` is true). @default false */
+    defaultExpanded?: boolean;
+    /** Callback when collapsed state changes */
+    onCollapseChange?: (isCollapsed: boolean) => void;
+}
+
+/**
+ * MarkdownMessage — chat-tuned markdown renderer.
+ *
+ * Features:
+ * - GitHub Flavored Markdown (GFM) via remark-gfm
+ * - Syntax-highlighted code blocks with Copy button
+ * - Mermaid diagram rendering (` ```mermaid ` fence)
+ * - Tables, lists, blockquotes scaled for chat density
+ * - User vs assistant styling modes (`isUser`)
+ * - Plain-text fast path: skips ReactMarkdown when content has no
+ *   markdown syntax (cheaper render, preserves newlines via CSS)
+ * - Optional collapsible "Read more..." for long messages
+ *
+ * Custom URL schemes (chat mentions, deep-links, custom file viewers)
+ * are best handled with the declarative `linkRules` prop — see the
+ * type definition in `./types.ts` and the storybook for examples.
+ *
+ * @example
+ * ```tsx
+ * <MarkdownMessage content="# Hello\n\nThis is **bold** text." />
+ *
+ * // User message styling
+ * <MarkdownMessage content="Some content" isUser />
+ *
+ * // Custom URL scheme via linkRules
+ * <MarkdownMessage
+ *   content="Talk to [Vps-audi](cmdop://machine/abc-123)"
+ *   linkRules={[machineMentionRule]}
+ * />
+ * ```
+ *
+ * Memoised: re-renders only when props change. `content` is the main
+ * trigger — all other props (className, isUser, isCompact, etc.) are
+ * compared by value/reference. `onCollapseChange` is compared by
+ * reference — callers should stabilise it with useCallback.
+ */
+declare function MarkdownMessageRaw({ content, className, isUser, isCompact, plainText, customComponents, extraHrefProtocols, linkRules, collapsible, maxLength, maxLines, readMoreLabel, showLessLabel, defaultExpanded, onCollapseChange, }: MarkdownMessageProps): react_jsx_runtime.JSX.Element;
+declare const MarkdownMessage: react__default.MemoExoticComponent<typeof MarkdownMessageRaw>;
+
+/** Recursively concatenate the text content of a React.ReactNode tree.
+ *  Used by the markdown renderers (e.g. `<pre>` extracting code) and
+ *  by consumers that need a plain-string label out of link children. */
+declare function extractTextFromChildren(children: react__default.ReactNode): string;
+
+interface ActionRowProps {
+    /** Raw text to copy — pass the same source string used for render. */
+    value: string;
+    /** Bubble side. Just controls flex alignment; nothing is mirrored. */
+    isUser: boolean;
+    /**
+     * Whether the row is currently shown. Owner-controlled (typically
+     * `<ChatMessageRow>` toggles this on hover with a small close delay).
+     * The component is intentionally dumb about visibility — owners
+     * have full control over reveal logic (hover, focus, always-on,
+     * touch behaviour, etc.).
+     */
+    visible: boolean;
+}
+declare function ActionRowRaw({ value, isUser, visible }: ActionRowProps): react_jsx_runtime.JSX.Element;
+declare const ActionRow: react__default.MemoExoticComponent<typeof ActionRowRaw>;
+
+interface ChatMessageRowProps {
+    /** Side of the conversation — drives flex alignment and `isUser`
+     *  passed to `actions`. */
+    isUser: boolean;
+    /** The bubble (your own JSX). Anything goes — `<MarkdownMessage>`,
+     *  custom card, multi-element composition. */
+    children: react__default.ReactNode;
+    /** Render-prop for the action row. Receives `visible` so the row
+     *  knows when to fade in/out. Render `null` to opt out. */
+    actions?: (visible: boolean, isUser: boolean) => react__default.ReactNode;
+    /** Close delay in ms after the cursor leaves the row. Long enough
+     *  to bridge cursor travel from bubble → action button without
+     *  flicker. Default 250ms (Radix Tooltip-ish). */
+    closeDelayMs?: number;
+    /** Optional class on the column container. */
+    className?: string;
+}
+declare function ChatMessageRowRaw({ isUser, children, actions, closeDelayMs, className, }: ChatMessageRowProps): react_jsx_runtime.JSX.Element;
+declare const ChatMessageRow: react__default.MemoExoticComponent<typeof ChatMessageRowRaw>;
+
 /**
  * PrettyCode Component - Dynamic Import Wrapper
  *
@@ -4889,4 +4870,60 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { ANCHOR, 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, BUBBLE_SURFACE, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatBubbleStyles, type ChatBubbleSurface, type ChatConfig, type ChatContextValue, type ChatDestructiveStyles, type ChatDisplayMode, ChatDock, type ChatDockMode, type ChatDockPrefs, type ChatDockProps, type ChatDockSide, type ChatEventDetail, ChatFAB, type ChatFABPosition, type ChatFABProps, type ChatFABSize, type ChatFABVariant, ChatGreeting, type ChatGreetingProps, ChatHeader, ChatHeaderActionButton, type ChatHeaderActionButtonProps, ChatHeaderAudioToggle, type ChatHeaderAudioToggleProps, ChatHeaderLanguageButton, type ChatHeaderLanguageButtonProps, ChatHeaderModeToggle, type ChatHeaderModeToggleProps, type ChatHeaderProps, ChatHeaderResetButton, type ChatHeaderResetButtonProps, type ChatLabels, ChatLauncher, type ChatLauncherGreeting, type ChatLauncherHotkey, type ChatLauncherProps, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, type ChatPersona, type ChatPrefs, type ChatPresencePhase, ChatProvider, type ChatProviderProps, type ChatRole, type ChatRoleStyles, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, ChatUnreadPreview, type ChatUnreadPreviewProps, 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_CHAT_SOUNDS, DEFAULT_DOCK_PREFS, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, DESTRUCTIVE_SURFACE, 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 PydanticAIChatTransportOpts, type PydanticAIEvent, 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, TOGGLE, TOOL_CALL, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolIdQueue, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseAutoFocusOnStreamEndOptions, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatDockPrefsOptions, type UseChatDockPrefsReturn, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatResetOptions, type UseChatResetReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseChatUnreadOptions, type UseChatUnreadReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseFocusOnEmptyClickOptions, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, type UseVisitorFingerprintOptions, 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, createPydanticAIChatTransport, createPydanticAISSEMap, createTokenBuffer, createToolIdQueue, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isSubmittableDraft, isValidCron, mapPydanticAIEvent, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, sanitizeDraft, useAudioCache, useAutoFocusOnStreamEnd, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatBubbleStyles, useChatComposer, useChatContext, useChatContextOptional, useChatDestructiveStyles, useChatDockPrefs, useChatHistory, useChatLayout, useChatLightbox, useChatPresence, useChatReset, useChatRoleStyles, useChatScroll, useChatUnread, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useFocusOnEmptyClick, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useRegisterComposer, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisitorFingerprint, validateRequiredFields, validateSchema };
+interface UseCollapsibleContentOptions {
+    /**
+     * Maximum character length before collapsing
+     * If both maxLength and maxLines are set, the stricter limit applies
+     */
+    maxLength?: number;
+    /**
+     * Maximum number of lines before collapsing
+     * If both maxLength and maxLines are set, the stricter limit applies
+     */
+    maxLines?: number;
+    /**
+     * Start in expanded state (default: false - starts collapsed)
+     */
+    defaultExpanded?: boolean;
+}
+interface UseCollapsibleContentResult {
+    /** Whether content is currently collapsed */
+    isCollapsed: boolean;
+    /** Toggle between collapsed/expanded state */
+    toggleCollapsed: () => void;
+    /** Set collapsed state directly */
+    setCollapsed: (collapsed: boolean) => void;
+    /** Content to display (truncated if collapsed, full if expanded) */
+    displayContent: string;
+    /** Whether the content exceeds limits and should be collapsible */
+    shouldCollapse: boolean;
+    /** Original content length */
+    originalLength: number;
+    /** Original line count */
+    originalLineCount: number;
+}
+/**
+ * Hook for managing collapsible content with "Read more..." functionality
+ *
+ * @example
+ * ```tsx
+ * const { isCollapsed, toggleCollapsed, displayContent, shouldCollapse } = useCollapsibleContent(
+ *   longText,
+ *   { maxLength: 300, maxLines: 5 }
+ * );
+ *
+ * return (
+ *   <div>
+ *     <Markdown content={displayContent} />
+ *     {shouldCollapse && (
+ *       <button onClick={toggleCollapsed}>
+ *         {isCollapsed ? 'Read more...' : 'Show less'}
+ *       </button>
+ *     )}
+ *   </div>
+ * );
+ * ```
+ */
+declare function useCollapsibleContent(content: string, options?: UseCollapsibleContentOptions): UseCollapsibleContentResult;
+
+export { ANCHOR, ActionRow, 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, BUBBLE_SURFACE, BaseInputTemplate, type BlobSource, CHAT_EVENT_NAME, CSS_VARS, CardLoadingFallback, type ChatAction, type ChatAssistantContext, type ChatAttachment, type ChatAudioConfig, type ChatAudioEvent, type ChatAudioSounds, type ChatBubbleStyles, type ChatBubbleSurface, type ChatConfig, type ChatContextValue, type ChatDestructiveStyles, type ChatDisplayMode, ChatDock, type ChatDockMode, type ChatDockPrefs, type ChatDockProps, type ChatDockSide, type ChatEventDetail, ChatFAB, type ChatFABPosition, type ChatFABProps, type ChatFABSize, type ChatFABVariant, ChatGreeting, type ChatGreetingProps, ChatHeader, ChatHeaderActionButton, type ChatHeaderActionButtonProps, ChatHeaderAudioToggle, type ChatHeaderAudioToggleProps, ChatHeaderLanguageButton, type ChatHeaderLanguageButtonProps, ChatHeaderModeToggle, type ChatHeaderModeToggleProps, type ChatHeaderProps, ChatHeaderResetButton, type ChatHeaderResetButtonProps, type ChatLabels, ChatLauncher, type ChatLauncherGreeting, type ChatLauncherHotkey, type ChatLauncherProps, type ChatLightboxState, type ChatLogScope, type ChatLogger, type ChatMessage, ChatMessageRow, type ChatPersona, type ChatPrefs, type ChatPresencePhase, ChatProvider, type ChatProviderProps, type ChatRole, type ChatRoleStyles, ChatRoot, type ChatRootProps, type ChatSource, type ChatState, type ChatStreamEvent, type ChatToolCall, type ChatTransport, ChatUnreadPreview, type ChatUnreadPreviewProps, 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_CHAT_SOUNDS, DEFAULT_DOCK_PREFS, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, DESTRUCTIVE_SURFACE, 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, MarkdownMessage as MarkdownMessageDefault, 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 PydanticAIChatTransportOpts, type PydanticAIEvent, 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, TOGGLE, TOOL_CALL, TextWidget, TimeSelector, type TokenBuffer, ToolCalls, type ToolCallsProps, type ToolIdQueue, type ToolPayloadFallback, type ToolPayloadKind, type ToolPayloadMatcher, TransportError, TreeRootProps, type UiGroup, type UrlSource, type UseAutoFocusOnStreamEndOptions, type UseChatAudioReturn, type UseChatComposerOptions, type UseChatComposerReturn, type UseChatConfig, type UseChatDockPrefsOptions, type UseChatDockPrefsReturn, type UseChatHistoryOptions, type UseChatLayoutConfig, type UseChatLayoutReturn, type UseChatLightboxReturn, type UseChatResetOptions, type UseChatResetReturn, type UseChatReturn, type UseChatScrollOptions, type UseChatScrollReturn, type UseChatUnreadOptions, type UseChatUnreadReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseEditorReturn, type UseFocusOnEmptyClickOptions, type UseLottieOptions, type UseLottieReturn, type UseMonacoReturn, type UseVisitorFingerprintOptions, 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, createPydanticAIChatTransport, createPydanticAISSEMap, createTokenBuffer, createToolIdQueue, createVideoErrorFallback, deriveInitials, dispatchToolPayload, evaluateDisabledWhen, extractTextFromChildren, generateContentKey, getChatLogger, getRequiredFields, hasRequiredFields, humanizeCron, initialState, isGeoJSONFeatureCollection, isLatLng, isPlainObject, isSimpleStreamSource, isStringValue, isSubmittableDraft, isValidCron, mapPydanticAIEvent, mentionPresets, mergeDefaults, normalizeFormData, parseCron, parseSSE, reducer, resolveFileSource, resolvePersona, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, sanitizeDraft, useAudioCache, useAutoFocusOnStreamEnd, useBlobUrlCleanup, useChat, useChatAudio, useChatAudioPrefs, useChatBubbleStyles, useChatComposer, useChatContext, useChatContextOptional, useChatDestructiveStyles, useChatDockPrefs, useChatHistory, useChatLayout, useChatLightbox, useChatPresence, useChatReset, useChatRoleStyles, useChatScroll, useChatUnread, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useEditor, useEditorContext, useFocusOnEmptyClick, useImageCache, useLanguage, useLottie, useMediaCacheStore, useMonaco, useRegisterComposer, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisitorFingerprint, validateRequiredFields, validateSchema };

package/dist/index.mjs

@@ -1,6 +1,8 @@
-import { createLazyComponent, MapLoadingFallback, CardLoadingFallback, LoadingFallback } from './chunk-BVESQTBM.mjs';
-export { CardLoadingFallback, ChatDock, ChatFAB, ChatGreeting, ChatHeader, ChatHeaderActionButton, ChatHeaderAudioToggle, ChatHeaderLanguageButton, ChatHeaderModeToggle, ChatHeaderResetButton, ChatLauncher, ChatUnreadPreview, LazyWrapper, LoadingFallback, MapLoadingFallback, Spinner, createLazyComponent, useChatPresence, useChatReset } from './chunk-BVESQTBM.mjs';
-import './chunk-UNCS5V5F.mjs';
+import { createLazyComponent, MapLoadingFallback, CardLoadingFallback, LoadingFallback } from './chunk-NTVBIIUD.mjs';
+export { CardLoadingFallback, ChatDock, ChatFAB, ChatGreeting, ChatHeader, ChatHeaderActionButton, ChatHeaderAudioToggle, ChatHeaderLanguageButton, ChatHeaderModeToggle, ChatHeaderResetButton, ChatLauncher, ChatUnreadPreview, LazyWrapper, LoadingFallback, MapLoadingFallback, Spinner, createLazyComponent, useChatPresence, useChatReset } from './chunk-NTVBIIUD.mjs';
+export { Attachments, AttachmentsGrid, AttachmentsList, ChatRoot, Composer, EmptyState, ErrorBanner, JumpToLatest, MessageActions, MessageBubble, MessageList, Sources, StreamingIndicator, ToolCalls, deriveInitials, isSubmittableDraft, resolvePersona, sanitizeDraft, useAutoFocusOnStreamEnd, useChatBubbleStyles, useChatComposer, useChatDestructiveStyles, useChatRoleStyles, useFocusOnEmptyClick, useRegisterComposer } from './chunk-6ZX2G25W.mjs';
+import { LIMITS, createId, useChatContext, useChatContextOptional } from './chunk-DMX7W4XZ.mjs';
+export { CHAT_EVENT_NAME, CSS_VARS, ChatProvider, DEFAULT_CHAT_SOUNDS, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, HOTKEYS, LIMITS, STORAGE_KEYS, createId, createTokenBuffer, getChatLogger, initialState, reducer, useChat, useChatAudio, useChatContext, useChatContextOptional, useChatLayout } from './chunk-DMX7W4XZ.mjs';
 export { ArrayFieldItemTemplate, ArrayFieldTemplate, BaseInputTemplate, CheckboxWidget, ColorWidget, ErrorListTemplate, FieldTemplate, JsonSchemaForm, NumberWidget, ObjectFieldTemplate, SelectWidget, SliderWidget, SwitchWidget, TextWidget, evaluateDisabledWhen, getRequiredFields, hasRequiredFields, mergeDefaults, normalizeFormData, safeJsonParse, safeJsonStringify, validateRequiredFields, validateSchema } from './chunk-GYIO7W7M.mjs';
 export { useLottie } from './chunk-ODO4GMW7.mjs';
 export { Player as AudioPlayer } from './chunk-VWQ5WOIL.mjs';
@@ -8,14 +10,12 @@ 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';
-export { Attachments, AttachmentsGrid, AttachmentsList, ChatRoot, Composer, EmptyState, ErrorBanner, JumpToLatest, MessageActions, MessageBubble, MessageList, Sources, StreamingIndicator, ToolCalls, deriveInitials, isSubmittableDraft, resolvePersona, sanitizeDraft, useAutoFocusOnStreamEnd, useChatBubbleStyles, useChatComposer, useChatDestructiveStyles, useChatRoleStyles, useFocusOnEmptyClick, useRegisterComposer } from './chunk-HNIMIIFR.mjs';
-import { LIMITS, createId, useChatContext, useChatContextOptional } from './chunk-DMX7W4XZ.mjs';
-export { CHAT_EVENT_NAME, CSS_VARS, ChatProvider, DEFAULT_CHAT_SOUNDS, DEFAULT_LABELS, DEFAULT_SIDEBAR, DEFAULT_Z_INDEX, HOTKEYS, LIMITS, STORAGE_KEYS, createId, createTokenBuffer, getChatLogger, initialState, reducer, useChat, useChatAudio, useChatContext, useChatContextOptional, useChatLayout } from './chunk-DMX7W4XZ.mjs';
+import './chunk-UNCS5V5F.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 { useMapContext } from './chunk-7CWGZPO3.mjs';
 import { PlaygroundProvider } from './chunk-Y6UTOBF6.mjs';
-export { ANCHOR, BUBBLE_SURFACE, DESTRUCTIVE_SURFACE, MarkdownMessage, Mermaid_default as Mermaid, PrettyCode_default as PrettyCode, TOGGLE, TOOL_CALL, extractTextFromChildren, useCollapsibleContent } from './chunk-HIK6BPL7.mjs';
+export { ANCHOR, ActionRow, BUBBLE_SURFACE, ChatMessageRow, DESTRUCTIVE_SURFACE, MarkdownMessage, MarkdownMessage_default as MarkdownMessageDefault, Mermaid_default as Mermaid, PrettyCode_default as PrettyCode, TOGGLE, TOOL_CALL, extractTextFromChildren, useCollapsibleContent } from './chunk-2NG4SXEP.mjs';
 export { JsonTree_default as JsonTree } from './chunk-ECONRHIG.mjs';
 import './chunk-KNEQRUBA.mjs';
 import { __name, __publicField } from './chunk-N2XQF2OL.mjs';
@@ -926,7 +926,7 @@ function OpenapiLoadingFallback() {
 }
 __name(OpenapiLoadingFallback, "OpenapiLoadingFallback");
 var LazyDocsLayout = createLazyComponent(
-  () => import('./DocsLayout-2P3ONDWJ.mjs').then((mod) => ({ default: mod.DocsLayout })),
+  () => import('./DocsLayout-EKASBSP7.mjs').then((mod) => ({ default: mod.DocsLayout })),
   {
     displayName: "LazyDocsLayout",
     fallback: /* @__PURE__ */ jsx(OpenapiLoadingFallback, {})
@@ -1778,21 +1778,6 @@ function collectImageAttachments(messages) {
   return out;
 }
 __name(collectImageAttachments, "collectImageAttachments");
-var LazyChat = createLazyComponent(
-  () => import('./ChatRoot-4KM2JMGA.mjs').then((m) => ({ default: m.ChatRoot })),
-  {
-    displayName: "LazyChat",
-    fallback: /* @__PURE__ */ jsx(LoadingFallback, { minHeight: 320, text: "Loading chat\u2026" })
-  }
-);
-createLazyComponent(
-  () => import('./launcher-5WYPDPEP.mjs').then((m) => ({ default: m.ChatLauncher })),
-  {
-    displayName: "LazyChatLauncher",
-    // Launcher renders a floating FAB by default — no inline placeholder.
-    fallback: null
-  }
-);
 function AudioToggle({
   size = "icon",
   variant = "ghost",
@@ -1821,6 +1806,21 @@ function AudioToggle({
   );
 }
 __name(AudioToggle, "AudioToggle");
+var LazyChat = createLazyComponent(
+  () => import('./ChatRoot-FITF5RVP.mjs').then((m) => ({ default: m.ChatRoot })),
+  {
+    displayName: "LazyChat",
+    fallback: /* @__PURE__ */ jsx(LoadingFallback, { minHeight: 320, text: "Loading chat\u2026" })
+  }
+);
+createLazyComponent(
+  () => import('./launcher-5Y42OBSN.mjs').then((m) => ({ default: m.ChatLauncher })),
+  {
+    displayName: "LazyChatLauncher",
+    // Launcher renders a floating FAB by default — no inline placeholder.
+    fallback: null
+  }
+);
 var LottiePlayerClient = lazy(
   () => import('./LottiePlayer.client-5LDSSJWS.mjs').then((mod) => ({ default: mod.LottiePlayer }))
 );
@@ -1833,7 +1833,7 @@ function LottiePlayer(props) {
 }
 __name(LottiePlayer, "LottiePlayer");
 var DocsLayout = lazy(
-  () => import('./DocsLayout-2P3ONDWJ.mjs').then((mod) => ({ default: mod.DocsLayout }))
+  () => import('./DocsLayout-EKASBSP7.mjs').then((mod) => ({ default: mod.DocsLayout }))
 );
 var LoadingFallback6 = /* @__PURE__ */ __name(() => /* @__PURE__ */ jsx("div", { className: "flex items-center justify-center min-h-[400px]", children: /* @__PURE__ */ jsx("div", { className: "text-muted-foreground", children: "Loading API Playground..." }) }), "LoadingFallback");
 var Playground = /* @__PURE__ */ __name(({ config }) => {