@djangocfg/ui-tools 2.1.390 → 2.1.393

package/dist/index.d.cts

@@ -1,4929 +0,0 @@
-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 { ViewState } from 'react-map-gl/maplibre';
-import { Language } from 'prism-react-renderer';
-export { Language } from 'prism-react-renderer';
-import { RJSFSchema, UiSchema, WidgetProps, FieldTemplateProps, ObjectFieldTemplateProps, ArrayFieldTemplateProps, ArrayFieldItemTemplateProps, ErrorListProps } from '@rjsf/utils';
-export { RJSFSchema, UiSchema } from '@rjsf/utils';
-import { FormProps, IChangeEvent } from '@rjsf/core';
-import { CustomJsonSchema7, CustomJsonUiSchema7, CustomJsonUiDisabledWhenRule, CustomJsonUiGroup } from '@djangocfg/ui-core/lib';
-export { CustomJsonSchema7, CustomJsonSchema7Type, CustomJsonUiDisabledWhenRule, CustomJsonUiGroup, CustomJsonUiSchema7 } from '@djangocfg/ui-core/lib';
-import { CommonExternalProps } from 'react-json-tree';
-import { b as TreeRootProps } from './types-CevSbyfD.cjs';
-export { c as DEFAULT_TREE_APPEARANCE, D as DEFAULT_TREE_LABELS, F as FlatRow, R as ResolvedAppearance, m as TreeAccentIntensity, k as TreeAppearance, e as TreeContextMenuSlot, l as TreeDensity, f as TreeItemId, g as TreeLabels, j as TreeLoadChildren, T as TreeNode, n as TreeRadius, i as TreeRowRenderProps, a as TreeRowSlot, h as TreeSelectionMode, d as appearanceToStyle, r as resolveAppearance } from './types-CevSbyfD.cjs';
-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';
-export { ChildCache, ChildEntry, ChildEntryStatus, DemoNode, FlattenInput, PersistedTreeState, TreeRoot as Tree, TreeChevron, TreeChevronProps, TreeContent, TreeContentProps, TreeContextValue, TreeEmpty, TreeEmptyProps, TreeError, TreeErrorProps, TreeIcon, TreeIconProps, TreeIndentGuides, TreeIndentGuidesProps, TreeLabel, TreeLabelProps, TreeProvider, TreeProviderProps, TreeRoot, TreeRow, TreeRowProps, TreeSearchInput, TreeSearchInputProps, TreeSkeleton, TreeSkeletonProps, UseTreeKeyboardOptions, UseTreeTypeAheadOptions, clearTreeState, createChildCache, createDemoTree, flattenTree, loadTreeState, resolveChildren, saveTreeState, useTreeActions, useTreeContext, useTreeExpansion, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead } from './tree/index.cjs';
-import * as zustand_middleware from 'zustand/middleware';
-
-interface LoadingFallbackProps {
-    /** Minimum height of the loading container */
-    minHeight?: string | number;
-    /** Show loading text */
-    showText?: boolean;
-    /** Custom loading text */
-    text?: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-/**
- * Spinner - Simple spinning loader
- */
-declare function Spinner({ className }: {
-    className?: string;
-}): react_jsx_runtime.JSX.Element;
-/**
- * LoadingFallback - Default loading state for lazy components
- */
-declare function LoadingFallback({ minHeight, showText, text, className, }: LoadingFallbackProps): react_jsx_runtime.JSX.Element;
-/**
- * CardLoadingFallback - Loading state styled as a card
- */
-declare function CardLoadingFallback({ title, description, minHeight, className, }: {
-    title?: string;
-    description?: string;
-    minHeight?: string | number;
-    className?: string;
-}): react_jsx_runtime.JSX.Element;
-/**
- * MapLoadingFallback - Loading state for map components
- */
-declare function MapLoadingFallback({ minHeight, className, }: {
-    minHeight?: string | number;
-    className?: string;
-}): react_jsx_runtime.JSX.Element;
-interface LazyWrapperProps {
-    children: ReactNode;
-    /** Custom fallback component */
-    fallback?: ReactNode;
-    /** Use card-style fallback */
-    card?: boolean;
-    /** Card title (when card=true) */
-    cardTitle?: string;
-    /** Card description (when card=true) */
-    cardDescription?: string;
-    /** Minimum height for fallback */
-    minHeight?: string | number;
-    /** Additional CSS classes for fallback */
-    className?: string;
-}
-/**
- * LazyWrapper - Suspense wrapper with configurable fallbacks
- *
- * @example
- * // Basic usage
- * <LazyWrapper>
- *   <LazyComponent />
- * </LazyWrapper>
- *
- * @example
- * // Card style fallback
- * <LazyWrapper card cardTitle="Diagram" minHeight={300}>
- *   <Mermaid chart={...} />
- * </LazyWrapper>
- *
- * @example
- * // Custom fallback
- * <LazyWrapper fallback={<MyCustomLoader />}>
- *   <HeavyComponent />
- * </LazyWrapper>
- */
-declare function LazyWrapper({ children, fallback, card, cardTitle, cardDescription, minHeight, className, }: LazyWrapperProps): react_jsx_runtime.JSX.Element;
-interface CreateLazyComponentOptions<P> {
-    /** Loading fallback component */
-    fallback?: ReactNode | ((props: P) => ReactNode);
-    /** Display name for the component */
-    displayName?: string;
-}
-/**
- * createLazyComponent - Factory for creating lazy-loaded components
- *
- * @example
- * const LazyMermaid = createLazyComponent(
- *   () => import('./Mermaid.client'),
- *   {
- *     displayName: 'Mermaid',
- *     fallback: <CardLoadingFallback title="Diagram" />,
- *   }
- * );
- */
-declare function createLazyComponent<P extends object>(loader: () => Promise<{
-    default: ComponentType<P>;
-}>, options?: CreateLazyComponentOptions<P>): ComponentType<P>;
-
-interface MarkerData {
-    id: string;
-    longitude: number;
-    latitude: number;
-    data?: Record<string, unknown>;
-}
-interface MapViewport extends Partial<ViewState> {
-    longitude: number;
-    latitude: number;
-    zoom: number;
-    bearing?: number;
-    pitch?: number;
-    transitionDuration?: number;
-}
-type MapStyleKey = 'light' | 'dark' | 'streets' | 'satellite';
-
-interface MapContainerProps {
-    children?: ReactNode;
-    initialViewport?: Partial<MapViewport>;
-    mapStyle?: MapStyleKey | string;
-    interactiveLayerIds?: string[];
-    className?: string;
-    style?: React.CSSProperties;
-    cursor?: string;
-    attributionControl?: boolean;
-    reuseMaps?: boolean;
-    /** URL to open in external maps app (shows "Open in Maps" button if provided) */
-    openInMapsUrl?: string;
-    /** Label for the open in maps button */
-    openInMapsLabel?: string;
-    /** Auto-reset to initial viewport after N ms of inactivity (0 = disabled) */
-    autoResetDelay?: number;
-    /** Show reset button */
-    showResetButton?: boolean;
-}
-
-/**
- * LazyMapContainer - Lazy-loaded map container
- *
- * Automatically shows loading state while MapLibre GL loads (~800KB)
- */
-declare const LazyMapContainer: react.ComponentType<MapContainerProps>;
-/**
- * LazyMapView - Lazy-loaded map view (alias for MapContainer)
- */
-declare const LazyMapView: react.ComponentType<Omit<MapContainerProps, "initialViewport">>;
-
-/**
- * Mermaid Component - Dynamic Import Wrapper
- *
- * Lazy loads the heavy Mermaid library (~800KB) only when needed.
- * This significantly reduces the initial bundle size.
- */
-
-interface MermaidProps {
-    chart: string;
-    className?: string;
-    isCompact?: boolean;
-    /** Enable click-to-fullscreen functionality (default: true) */
-    fullscreen?: boolean;
-    /**
-     * Enable the FloatingToolbar's "click to scroll" lock overlay.
-     * Defaults to `false` — Mermaid diagrams don't scroll internally,
-     * so the lock overlay just steals page wheel events. See the
-     * Mermaid.client implementation for the full rationale.
-     */
-    scrollIsolation?: boolean;
-}
-declare const Mermaid: react__default.FC<MermaidProps>;
-
-/**
- * LazyMermaid - Lazy-loaded Mermaid diagram renderer
- *
- * Automatically shows loading state while Mermaid loads (~800KB)
- */
-declare const LazyMermaid: react.ComponentType<MermaidProps>;
-
-interface PrettyCodeProps$1 {
-    data: string | object;
-    language: Language;
-    className?: string;
-    mode?: 'dark' | 'light';
-    inline?: boolean;
-    customBg?: string;
-    isCompact?: boolean;
-    scrollIsolation?: boolean;
-    maxLines?: number;
-    /** ``'card'`` (default) ships the full chrome. ``'plain'`` is
-     *  chrome-less — for embedding inside another scroll container. */
-    variant?: 'card' | 'plain';
-}
-
-/**
- * LazyPrettyCode - Lazy-loaded code syntax highlighter
- *
- * Automatically shows loading state while Prism loads (~500KB)
- */
-declare const LazyPrettyCode: react.ComponentType<PrettyCodeProps$1>;
-
-interface ApiKey {
-    id: string;
-    name: string;
-    /** Raw key value sent in the ``X-API-Key`` request header. */
-    secret: string;
-    created_at?: string;
-    last_used_at?: string | null;
-}
-interface OpenApiSchema {
-    openapi: string;
-    info: {
-        title: string;
-        version: string;
-        description?: string;
-    };
-    servers?: Array<{
-        url: string;
-        description?: string;
-    }>;
-    paths: Record<string, Record<string, any>>;
-    components?: {
-        schemas?: Record<string, any>;
-    };
-}
-interface SchemaSource {
-    id: string;
-    name: string;
-    /** URL to fetch the OpenAPI schema from. Required when ``data`` is not
-     *  provided; ignored when ``data`` is present. */
-    url?: string;
-    /** Pre-loaded OpenAPI schema object. When provided the viewer uses it
-     *  directly and never makes a network request — ideal for statically
-     *  imported JSON files. Either ``url`` or ``data`` must be set. */
-    data?: OpenApiSchema;
-    /** Per-schema override for the request base URL. Wins over the
-     *  global ``PlaygroundConfig.baseUrl`` and over ``schema.servers[0].url``
-     *  from the OpenAPI document. Use when a single playground hosts
-     *  several APIs that live on different domains. */
-    baseUrl?: string;
-}
-interface PlaygroundConfig {
-    schemas: SchemaSource[];
-    defaultSchemaId?: string;
-    /** Global override for the request base URL. Used when the OpenAPI
-     *  document has no ``servers`` entry, or when docs are hosted on a
-     *  different origin than the API. Resolution order (highest wins):
-     *  ``SchemaSource.baseUrl`` → ``PlaygroundConfig.baseUrl`` →
-     *  ``schema.servers[0].url`` → empty string (relative paths). */
-    baseUrl?: string;
-    /** Optional API keys the user can pick from in the request panel.
-     *  When provided, the playground auto-selects the first one and
-     *  syncs the ``X-API-Key`` header from ``ApiKey.secret``. Pass
-     *  the loading flag if your source is async — the picker shows
-     *  a spinner instead of "no keys yet". */
-    apiKeys?: ApiKey[];
-    apiKeysLoading?: boolean;
-    /** How multiple schemas are presented in the sidebar.
-     *  - ``'selector'`` (default): a Combobox switches between schemas, the
-     *    docs column shows endpoints of the active schema only.
-     *  - ``'sections'``: the Combobox is hidden and every schema becomes a
-     *    top-level heading in the sidebar, with endpoints of all schemas
-     *    rendered back-to-back in the docs column. Scrollspy picks the
-     *    active schema based on what's visible. */
-    schemaGrouping?: 'selector' | 'sections';
-    /** URL-hash sync. When enabled, the viewer reads/writes
-     *  ``#<schemaId>/<anchor>`` on the browser location so deep-links
-     *  to a specific endpoint work out of the box. Defaults to ``true`` —
-     *  pass ``false`` (or ``{ enabled: false }``) to opt out if the host
-     *  page already manages the hash itself. */
-    urlSync?: boolean | {
-        enabled: boolean;
-    };
-}
-
-/**
- * Lazy-loaded OpenapiViewer Component
- *
- * Heavy OpenAPI viewer (~400KB) is loaded only when component is rendered.
- * Use this for automatic code-splitting with Suspense fallback.
- *
- * For direct imports without lazy loading, use:
- *   import OpenapiViewer from '@djangocfg/ui-tools/openapi'
- */
-
-interface PlaygroundProps$1 {
-    config: PlaygroundConfig;
-}
-
-declare const LazyOpenapiViewer: react.FC<PlaygroundProps$1>;
-
-/** Visual density for form controls. */
-type JsonFormDensity = 'comfortable' | 'compact';
-/**
- * Aliases that point to the portable schema types in `@djangocfg/ui-core/lib`.
- * Kept under their old short names for back-compat — new code can import the
- * `CustomJson*` originals directly from ui-core.
- */
-type DisabledWhenRule = CustomJsonUiDisabledWhenRule;
-type UiGroup = CustomJsonUiGroup;
-/** What we put into RJSF's `formContext` so widgets/templates can react to global form state. */
-interface JsonFormContext {
-    density: JsonFormDensity;
-    /** Latest form data — used by `evaluateDisabledWhen`. */
-    formData: unknown;
-}
-/**
- * JSON Schema Form props interface
- */
-interface JsonSchemaFormProps<T = any> extends Omit<Partial<FormProps<T>>, 'schema' | 'uiSchema'> {
-    /**
-     * JSON Schema that defines the form structure. Accepts either RJSF's
-     * `RJSFSchema` directly or our portable `CustomJsonSchema7` from
-     * `@djangocfg/ui-core/lib` — both are cast to RJSF internally.
-     */
-    schema: RJSFSchema | CustomJsonSchema7;
-    /** UI Schema for customizing the form appearance. Same dual-shape acceptance as `schema`. */
-    uiSchema?: UiSchema | CustomJsonUiSchema7;
-    /** Initial form data */
-    formData?: T;
-    /** Callback when form is submitted */
-    onSubmit?: (data: IChangeEvent<T>) => void;
-    /** Callback when form data changes */
-    onChange?: (data: IChangeEvent<T>) => void;
-    /** Callback when form has validation errors */
-    onError?: (errors: any[]) => void;
-    /** Whether to show error list at the top of form */
-    showErrorList?: false | 'top' | 'bottom';
-    /** Whether to live validate on change */
-    liveValidate?: boolean;
-    /** Whether the form is disabled */
-    disabled?: boolean;
-    /** Whether the form is read-only */
-    readonly?: boolean;
-    /** Custom CSS class name */
-    className?: string;
-    /** Whether to show submit button */
-    showSubmitButton?: boolean;
-    /** Submit button text */
-    submitButtonText?: string;
-    /** Visual density preset. `'compact'` shrinks rows and hides description text (moves it to label `title=` tooltip). */
-    density?: JsonFormDensity;
-}
-
-/**
- * LazyJsonSchemaForm - Lazy-loaded JSON Schema form generator
- *
- * Automatically shows loading state while RJSF loads (~300KB)
- */
-declare const LazyJsonSchemaForm: react.ComponentType<JsonSchemaFormProps<any>>;
-
-/**
- * JSON Schema Form Component
- *
- * A fully-featured form generator that creates forms from JSON Schema.
- * Built on top of react-jsonschema-form with custom widgets and templates
- * using @djangocfg/ui components.
- *
- * @example
- * ```tsx
- * const schema = {
- *   type: 'object',
- *   required: ['name'],
- *   properties: {
- *     name: { type: 'string', title: 'Name' },
- *     age: { type: 'number', title: 'Age' },
- *     active: { type: 'boolean', title: 'Active' }
- *   }
- * };
- *
- * <JsonSchemaForm
- *   schema={schema}
- *   onSubmit={(data) => console.log(data.formData)}
- * />
- * ```
- */
-declare function JsonSchemaForm<T = any>(props: JsonSchemaFormProps<T>): react_jsx_runtime.JSX.Element;
-
-/**
- * Utility functions for JSON Schema Form
- */
-/**
- * Safely validates and normalizes JSON Schema
- * Ensures schema is valid before rendering
- */
-declare function validateSchema(schema: any): RJSFSchema | null;
-/**
- * Safely normalizes form data
- * Removes undefined values and ensures data structure matches schema
- */
-declare function normalizeFormData<T = any>(formData: any, schema: RJSFSchema): T;
-/**
- * Merges schema defaults with form data
- */
-declare function mergeDefaults(formData: any, schema: RJSFSchema): any;
-/**
- * Safely parses JSON string with error handling
- */
-declare function safeJsonParse<T = any>(jsonString: string, fallback: T): T;
-/**
- * Safely stringifies object to JSON
- */
-declare function safeJsonStringify(obj: any, pretty?: boolean): string;
-/**
- * Checks if schema has required fields
- */
-declare function hasRequiredFields(schema: RJSFSchema): boolean;
-/**
- * Gets all required field paths from schema
- */
-declare function getRequiredFields(schema: RJSFSchema, prefix?: string): string[];
-/**
- * Validates form data against required fields
- */
-declare function validateRequiredFields(formData: any, schema: RJSFSchema): {
-    valid: boolean;
-    missing: string[];
-};
-
-/**
- * Evaluates a `ui:disabledWhen` rule against form data. Returns `true` when the
- * field should be disabled. If `rule` is undefined, returns `false`.
- *
- * Supported rule shapes:
- *   { path, eq } | { path, notEq } | { path, in } | { path, notIn }
- *   | { path, truthy: true } | { path, falsy: true }
- */
-declare function evaluateDisabledWhen(rule: DisabledWhenRule | undefined, formData: unknown): boolean;
-
-/**
- * Text input widget for JSON Schema Form
- * Handles string fields with optional textarea for multiline
- */
-declare function TextWidget(props: WidgetProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Number input widget for JSON Schema Form
- * Handles integer and number fields
- */
-declare function NumberWidget(props: WidgetProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Checkbox widget for JSON Schema Form
- * Handles boolean fields
- */
-declare function CheckboxWidget(props: WidgetProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Select dropdown widget for JSON Schema Form
- * Handles enum fields
- */
-declare function SelectWidget(props: WidgetProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Switch toggle widget for JSON Schema Form
- * Alternative boolean input
- */
-declare function SwitchWidget(props: WidgetProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Color input widget for JSON Schema Form
- * Supports HSL format (h s% l%) and HEX format
- * Click on color box to open native color picker directly
- */
-declare function ColorWidget(props: WidgetProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Slider widget for JSON Schema Form
- *
- * Supports:
- * - number/integer types
- * - min/max from schema
- * - step from schema or options
- * - unit suffix (e.g., "rem", "px", "%")
- * - optional text input for precise values
- *
- * Usage in uiSchema:
- * ```json
- * {
- *   "radius": {
- *     "ui:widget": "slider",
- *     "ui:options": {
- *       "unit": "rem",
- *       "showInput": true,
- *       "step": 0.125
- *     }
- *   }
- * }
- * ```
- */
-declare function SliderWidget(props: WidgetProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Field template for JSON Schema Form
- * Controls the layout and styling of individual form fields
- */
-declare function FieldTemplate(props: FieldTemplateProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Object field template for JSON Schema Form
- *
- * Supports:
- * - Collapsible groups via ui:collapsible option
- * - Grid layout via ui:grid option
- * - Custom styling via ui:className
- *
- * Usage in uiSchema:
- * ```json
- * {
- *   "colors": {
- *     "ui:collapsible": true,
- *     "ui:collapsed": false,
- *     "ui:grid": 2
- *   }
- * }
- * ```
- */
-declare function ObjectFieldTemplate(props: ObjectFieldTemplateProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Array field template for JSON Schema Form
- * Renders array items with add/remove controls
- *
- * NOTE: In RJSF v6, `items` is an array of ReactElement (already rendered),
- * NOT an array of objects with {children, hasRemove, etc.}.
- * The actual rendering of each item (including remove buttons) is handled
- * by ArrayFieldItemTemplate.
- */
-declare function ArrayFieldTemplate(props: ArrayFieldTemplateProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Array field item template for JSON Schema Form
- * Renders individual array items with proper styling and action buttons
- *
- * In RJSF v6, this template is responsible for rendering each item in an array,
- * including the item content (children) and the action buttons (remove, move up/down, copy).
- */
-declare function ArrayFieldItemTemplate(props: ArrayFieldItemTemplateProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Error list template for JSON Schema Form
- * Displays validation errors at the top of the form
- */
-declare function ErrorListTemplate(props: ErrorListProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Base input template for JSON Schema Form
- *
- * This template is CRITICAL for rendering primitive types (string, number)
- * inside arrays. Without it, array items with primitive types will render
- * as empty containers.
- *
- * RJSF uses this template for:
- * - Array items with primitive types (e.g., array of strings)
- * - Fields without explicit widget mapping
- * - All text-based widgets internally
- *
- * @see https://rjsf-team.github.io/react-jsonschema-form/docs/advanced-customization/custom-templates/#baseinputtemplate
- */
-declare function BaseInputTemplate(props: WidgetProps): react_jsx_runtime.JSX.Element;
-
-/**
- * LottiePlayer Types
- *
- * Type definitions for the Lottie animation player component
- */
-type LottieSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
-type LottieSpeed = 0.5 | 1 | 1.5 | 2;
-type LottieDirection = 1 | -1;
-interface LottiePlayerProps {
-    /**
-     * Animation data (JSON object) or URL to load from
-     */
-    src: string | object;
-    /**
-     * Size preset for the player
-     * @default 'md'
-     */
-    size?: LottieSize;
-    /**
-     * Custom width (overrides size preset)
-     */
-    width?: number | string;
-    /**
-     * Custom height (overrides size preset)
-     */
-    height?: number | string;
-    /**
-     * Autoplay animation
-     * @default true
-     */
-    autoplay?: boolean;
-    /**
-     * Loop animation
-     * @default true
-     */
-    loop?: boolean | number;
-    /**
-     * Playback speed
-     * @default 1
-     */
-    speed?: LottieSpeed;
-    /**
-     * Direction (1 = forward, -1 = reverse)
-     * @default 1
-     */
-    direction?: LottieDirection;
-    /**
-     * Show playback controls
-     * @default false
-     */
-    controls?: boolean;
-    /**
-     * Background color
-     */
-    background?: string;
-    /**
-     * CSS class name
-     */
-    className?: string;
-    /**
-     * Show loading state
-     * @default true
-     */
-    showLoading?: boolean;
-    /**
-     * Callback when animation completes
-     */
-    onComplete?: () => void;
-    /**
-     * Callback when animation loads
-     */
-    onLoad?: () => void;
-    /**
-     * Callback on error
-     */
-    onError?: (error: Error) => void;
-}
-
-/**
- * LazyLottiePlayer - Lazy-loaded Lottie animation player
- *
- * Automatically shows loading state while Lottie loads (~200KB)
- */
-declare const LazyLottiePlayer: react.ComponentType<LottiePlayerProps>;
-
-type WaveformMode = 'peaks' | 'live' | 'bars' | 'progress' | 'none';
-type WaveformConfig = {
-    mode?: WaveformMode;
-    peaks?: Float32Array;
-    height?: number;
-    barWidth?: number;
-    barGap?: number;
-    bgColor?: string;
-    fgColor?: string;
-    decodeOnMount?: boolean;
-};
-type ReactiveCoverMode = false | 'subtle';
-type PlayerVariant = 'default' | 'compact' | 'auto';
-type PlayerErrorReason = 'network' | 'decode' | 'unsupported' | 'unknown';
-type PlayerProps = {
-    src: string;
-    peaks?: Float32Array;
-    title?: string;
-    artist?: string;
-    album?: string;
-    cover?: string;
-    variant?: PlayerVariant;
-    className?: string;
-    waveform?: WaveformConfig;
-    reactiveCover?: ReactiveCoverMode;
-    autoplay?: boolean;
-    loop?: boolean;
-    initialVolume?: number;
-    muted?: boolean;
-    preload?: 'none' | 'metadata' | 'auto';
-    exclusive?: boolean;
-    onPrev?: () => void;
-    onNext?: () => void;
-    onPlay?: () => void;
-    onPause?: () => void;
-    onEnded?: () => void;
-    onError?: (reason: PlayerErrorReason, e: unknown) => void;
-    onTimeUpdate?: (currentTime: number, duration: number) => void;
-    ariaLabel?: string;
-    enableKeyboardShortcuts?: boolean;
-    seekStartsPlayback?: boolean;
-};
-type PlayerHandle = {
-    audio: HTMLAudioElement;
-    play: () => Promise<void>;
-    pause: () => void;
-    seek: (seconds: number) => void;
-    getCurrentTime: () => number;
-    getDuration: () => number;
-};
-
-declare const LazyPlayer: react.ComponentType<PlayerProps>;
-
-/**
- * Video source type definitions
- */
-/** Simple URL source (mp4, webm, etc.) */
-interface UrlSource {
-    type: 'url';
-    url: string;
-    title?: string;
-    poster?: string;
-}
-/** YouTube embed source */
-interface YouTubeSource {
-    type: 'youtube';
-    /** YouTube video ID (11 characters) */
-    id: string;
-    title?: string;
-    poster?: string;
-}
-/** Vimeo embed source */
-interface VimeoSource {
-    type: 'vimeo';
-    /** Vimeo video ID */
-    id: string;
-    title?: string;
-    poster?: string;
-}
-/** HLS streaming source */
-interface HLSSource {
-    type: 'hls';
-    /** URL to .m3u8 manifest */
-    url: string;
-    title?: string;
-    poster?: string;
-}
-/** DASH streaming source */
-interface DASHSource {
-    type: 'dash';
-    /** URL to .mpd manifest */
-    url: string;
-    title?: string;
-    poster?: string;
-}
-/** HTTP Range streaming source (for large files with auth) */
-interface StreamSource {
-    type: 'stream';
-    /** Session ID for authorization */
-    sessionId: string;
-    /** File path on server */
-    path: string;
-    /** Function to generate stream URL */
-    getStreamUrl: (sessionId: string, path: string) => string;
-    /** MIME type for the video */
-    mimeType?: string;
-    title?: string;
-    poster?: string;
-}
-/** Binary data source (ArrayBuffer) */
-interface BlobSource {
-    type: 'blob';
-    /** Video data as ArrayBuffer */
-    data: ArrayBuffer;
-    /** MIME type (default: video/mp4) */
-    mimeType?: string;
-    title?: string;
-    poster?: string;
-}
-/** Base64 data URL source */
-interface DataUrlSource {
-    type: 'data-url';
-    /** Base64 encoded data URL */
-    data: string;
-    title?: string;
-    poster?: string;
-}
-/** Union of all source types */
-type VideoSourceUnion = UrlSource | YouTubeSource | VimeoSource | HLSSource | DASHSource | StreamSource | BlobSource | DataUrlSource;
-
-/**
- * Player configuration types
- */
-
-/** Player mode - determines which provider to use */
-type PlayerMode = 'auto' | 'vidstack' | 'native' | 'streaming';
-/** Aspect ratio options */
-type AspectRatioValue = number | 'auto' | 'fill';
-/** Common player settings */
-interface CommonPlayerSettings {
-    /** Auto-play video */
-    autoPlay?: boolean;
-    /** Mute video by default */
-    muted?: boolean;
-    /** Loop video */
-    loop?: boolean;
-    /** Play video inline on mobile */
-    playsInline?: boolean;
-    /** Show player controls */
-    controls?: boolean;
-    /**
-     * Aspect ratio:
-     * - number (e.g. 16/9): Fixed aspect ratio
-     * - 'auto': Natural video aspect ratio
-     * - 'fill': Fill parent container (100% width & height)
-     */
-    aspectRatio?: AspectRatioValue;
-    /** Preload strategy */
-    preload?: 'auto' | 'metadata' | 'none';
-}
-/** Common player events */
-interface CommonPlayerEvents {
-    onPlay?: () => void;
-    onPause?: () => void;
-    onEnded?: () => void;
-    onError?: (error: string) => void;
-    onLoadStart?: () => void;
-    onCanPlay?: () => void;
-    onTimeUpdate?: (currentTime: number, duration: number) => void;
-    /** Called when buffering progress changes (buffered seconds, total duration) */
-    onBufferProgress?: (buffered: number, duration: number) => void;
-}
-/** Error fallback render props */
-interface ErrorFallbackProps {
-    error: string;
-    retry?: () => void;
-}
-/** Main VideoPlayer props */
-interface VideoPlayerProps extends CommonPlayerSettings, CommonPlayerEvents {
-    /** Video source configuration */
-    source: VideoSourceUnion;
-    /** Player mode (default: 'auto') */
-    mode?: PlayerMode;
-    /** Player theme (Vidstack only) */
-    theme?: 'default' | 'minimal' | 'modern';
-    /** Show video info below player */
-    showInfo?: boolean;
-    /** Container className */
-    className?: string;
-    /** Video element className (native/streaming only) */
-    videoClassName?: string;
-    /** Disable right-click context menu */
-    disableContextMenu?: boolean;
-    /** Show loading spinner */
-    showPreloader?: boolean;
-    /** Preloader timeout in ms */
-    preloaderTimeout?: number;
-    /** Custom error fallback UI */
-    errorFallback?: react__default.ReactNode | ((props: ErrorFallbackProps) => react__default.ReactNode);
-}
-/** VideoPlayer ref methods */
-interface VideoPlayerRef {
-    /** Play video */
-    play: () => Promise<void> | void;
-    /** Pause video */
-    pause: () => void;
-    /** Toggle play/pause */
-    togglePlay: () => void;
-    /** Seek to time in seconds */
-    seekTo: (time: number) => void;
-    /** Set volume (0-1) */
-    setVolume: (volume: number) => void;
-    /** Toggle mute */
-    toggleMute: () => void;
-    /** Enter fullscreen */
-    enterFullscreen: () => void;
-    /** Exit fullscreen */
-    exitFullscreen: () => void;
-    /** Current playback time in seconds */
-    readonly currentTime: number;
-    /** Video duration in seconds */
-    readonly duration: number;
-    /** Whether video is paused */
-    readonly paused: boolean;
-}
-
-/**
- * Provider-specific types
- */
-
-/** Props passed to Vidstack provider */
-interface VidstackProviderProps extends CommonPlayerSettings, CommonPlayerEvents {
-    source: UrlSource | YouTubeSource | VimeoSource | HLSSource | DASHSource;
-    theme?: 'default' | 'minimal' | 'modern';
-    showInfo?: boolean;
-    className?: string;
-    errorFallback?: react__default.ReactNode | ((props: ErrorFallbackProps) => react__default.ReactNode);
-}
-/** Props passed to Native provider */
-interface NativeProviderProps extends CommonPlayerSettings, CommonPlayerEvents {
-    source: UrlSource | DataUrlSource;
-    className?: string;
-    videoClassName?: string;
-    disableContextMenu?: boolean;
-    showPreloader?: boolean;
-    preloaderTimeout?: number;
-}
-/** Props passed to Stream provider */
-interface StreamProviderProps extends CommonPlayerSettings, CommonPlayerEvents {
-    source: StreamSource | BlobSource | DataUrlSource;
-    className?: string;
-    videoClassName?: string;
-    disableContextMenu?: boolean;
-    showPreloader?: boolean;
-    preloaderTimeout?: number;
-    errorFallback?: react__default.ReactNode | ((props: ErrorFallbackProps) => react__default.ReactNode);
-}
-/** Options for resolving file source */
-interface ResolveFileSourceOptions {
-    /** File content - can be data URL string or binary ArrayBuffer */
-    content: string | ArrayBuffer | null | undefined;
-    /** File path for streaming */
-    path: string;
-    /** MIME type of the file */
-    mimeType?: string;
-    /** Session ID for authenticated streaming */
-    sessionId?: string | null;
-    /** Load method hint - 'http_stream' enables streaming mode */
-    loadMethod?: 'http_stream' | 'rpc' | 'unspecified' | 'skip' | string;
-    /** Function to generate stream URL (required for streaming) */
-    getStreamUrl?: (sessionId: string, path: string) => string;
-    /** Optional title */
-    title?: string;
-    /** Optional poster */
-    poster?: string;
-}
-interface VideoPlayerContextValue {
-    /** Function to generate stream URL (for HTTP Range streaming) */
-    getStreamUrl?: (sessionId: string, path: string) => string;
-    /** Current session ID */
-    sessionId?: string | null;
-}
-interface VideoPlayerProviderProps extends VideoPlayerContextValue {
-    children: react__default.ReactNode;
-}
-/** Simplified stream source (uses context for getStreamUrl) */
-interface SimpleStreamSource {
-    type: 'stream';
-    /** File path on server */
-    path: string;
-    /** Session ID (optional, uses context if not provided) */
-    sessionId?: string;
-    /** MIME type for the video */
-    mimeType?: string;
-    title?: string;
-    poster?: string;
-}
-
-/**
- * LazyVideoPlayer - Lazy-loaded professional video player
- *
- * Automatically shows loading state while Vidstack loads (~150KB)
- */
-declare const LazyVideoPlayer: react.ComponentType<VideoPlayerProps>;
-
-type JsonTreeMode = 'full' | 'compact' | 'inline';
-interface JsonTreeConfig {
-    /** Maximum depth to expand automatically (default: 2) */
-    maxAutoExpandDepth?: number;
-    /** Maximum items in array to auto-expand (default: 10) */
-    maxAutoExpandArrayItems?: number;
-    /** Maximum object keys to auto-expand (default: 5) */
-    maxAutoExpandObjectKeys?: number;
-    /** Maximum string length before truncation (default: 200) */
-    maxStringLength?: number;
-    /** Collection limit for performance (default: 50) */
-    collectionLimit?: number;
-    /** Whether to show collection info (array length, object keys count) */
-    showCollectionInfo?: boolean;
-    /** Whether to show expand/collapse all buttons */
-    showExpandControls?: boolean;
-    /** Whether to show copy/download buttons */
-    showActionButtons?: boolean;
-    /** Custom CSS classes for the container */
-    className?: string;
-    /** Whether to preserve object key order (default: true) */
-    preserveKeyOrder?: boolean;
-    /** Font size for tree nodes (default: '12px' for compact/inline, '13px' for full) */
-    fontSize?: string;
-}
-interface JsonTreeComponentProps {
-    title?: string;
-    data: unknown;
-    /**
-     * Extra top offset in px for the floating toolbar — use when your layout
-     * has a non-sticky header that useNavbarHeight cannot auto-detect.
-     * Adds to the auto-detected navbar height.
-     */
-    toolbarOffset?: number;
-    /**
-     * Display mode:
-     * - "full" (default): With toolbar and border
-     * - "compact": No toolbar, subtle styling
-     * - "inline": Minimal, no border
-     */
-    mode?: JsonTreeMode;
-    config?: JsonTreeConfig;
-    /** Override for react-json-tree props */
-    jsonTreeProps?: Partial<CommonExternalProps>;
-}
-
-/**
- * JsonTreeComponent — JSON viewer with expand/collapse, copy, download.
- *
- * Memoised: re-renders only when `title`, `data`, `mode`, `config` or
- * `jsonTreeProps` change. `data` is compared by reference — the parent
- * should not mutate the object in place.
- */
-declare const JsonTreeComponent: react__default.MemoExoticComponent<({ title, data, mode, config, jsonTreeProps, }: JsonTreeComponentProps) => react_jsx_runtime.JSX.Element>;
-
-interface JsonTreeProps {
-    title?: string;
-    data: unknown;
-    /**
-     * Display mode:
-     * - "full" (default): With toolbar and border
-     * - "compact": No toolbar, subtle styling
-     * - "inline": Minimal, no border
-     */
-    mode?: JsonTreeMode;
-    config?: JsonTreeConfig;
-    jsonTreeProps?: Partial<CommonExternalProps>;
-}
-
-/**
- * LazyJsonTree - Lazy-loaded JSON visualization tree
- *
- * Automatically shows loading state while JsonTree loads (~100KB)
- *
- * @example
- * // Full mode (with toolbar)
- * <LazyJsonTree data={obj} mode="full" />
- *
- * // Compact mode (no toolbar)
- * <LazyJsonTree data={obj} mode="compact" />
- *
- * // Inline mode (minimal, for embedding)
- * <LazyJsonTree data={obj} mode="inline" />
- */
-declare const LazyJsonTree: react.ComponentType<JsonTreeProps>;
-
-/**
- * ImageViewer type definitions
- */
-interface ImageFile {
-    /** Display name for the image */
-    name: string;
-    /** File path used for change detection and caching */
-    path: string;
-    /** Optional MIME type */
-    mimeType?: string;
-}
-interface ImageItem {
-    /** File info for this image */
-    file: ImageFile;
-    /** Direct image URL (use when serving from CDN/server) */
-    src?: string;
-    /** Raw image content — ArrayBuffer or base64/binary string (use when serving from memory) */
-    content?: string | ArrayBuffer;
-}
-interface ImageViewerProps {
-    /**
-     * Gallery images array.
-     * When provided, enables gallery mode with prev/next navigation.
-     * Single-image mode: pass one item.
-     * Each item can have `src` (URL) or `content` (ArrayBuffer/base64) or both.
-     */
-    images: ImageItem[];
-    /**
-     * Initial index to show (default: 0).
-     * Useful when opening a specific image from a grid.
-     */
-    initialIndex?: number;
-    /** Hide expand button when already in dialog */
-    inDialog?: boolean;
-}
-
-/**
- * LazyImageViewer - Lazy-loaded image viewer with zoom/pan/rotate
- *
- * Automatically shows loading state while ImageViewer loads (~50KB)
- */
-declare const LazyImageViewer: react.ComponentType<ImageViewerProps>;
-
-/**
- * CronScheduler Types
- *
- * Unix 5-field cron format: minute hour day-of-month month day-of-week
- */
-type ScheduleType = 'daily' | 'weekly' | 'monthly' | 'custom';
-/** Day of week: 0 = Sunday, 1 = Monday, ..., 6 = Saturday */
-type WeekDay = 0 | 1 | 2 | 3 | 4 | 5 | 6;
-/** Day of month: 1-31 */
-type MonthDay = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31;
-interface CronSchedulerState {
-    /** Current schedule type */
-    type: ScheduleType;
-    /** Hour (0-23) */
-    hour: number;
-    /** Minute (0-59) */
-    minute: number;
-    /** Selected week days (for weekly type) */
-    weekDays: WeekDay[];
-    /** Selected month days (for monthly type) */
-    monthDays: MonthDay[];
-    /** Raw cron expression (for custom type) */
-    customCron: string;
-    /** Whether current state produces valid cron */
-    isValid: boolean;
-}
-interface CronSchedulerComputed {
-    /** Generated cron expression */
-    cronExpression: string;
-    /** Human-readable description */
-    humanDescription: string;
-    /** Initial value from props (null if not provided) */
-    initialValue: string | null;
-}
-interface CronSchedulerActions {
-    /** Set schedule type */
-    setType: (type: ScheduleType) => void;
-    /** Set time (hour and minute) */
-    setTime: (hour: number, minute: number) => void;
-    /** Toggle a week day selection */
-    toggleWeekDay: (day: WeekDay) => void;
-    /** Set all week days at once */
-    setWeekDays: (days: WeekDay[]) => void;
-    /** Toggle a month day selection */
-    toggleMonthDay: (day: MonthDay) => void;
-    /** Set all month days at once */
-    setMonthDays: (days: MonthDay[]) => void;
-    /** Set custom cron expression */
-    setCustomCron: (cron: string) => void;
-    /** Reset to default state */
-    reset: () => void;
-}
-interface CronSchedulerContextValue extends CronSchedulerState, CronSchedulerComputed, CronSchedulerActions {
-}
-interface CronSchedulerProps {
-    /** Current cron expression (Unix 5-field format) */
-    value?: string;
-    /** Callback when schedule changes */
-    onChange?: (cron: string) => void;
-    /** Initial schedule type (default: 'daily') */
-    defaultType?: ScheduleType;
-    /** Show human-readable preview (default: true) */
-    showPreview?: boolean;
-    /** Show raw cron expression in preview (default: false) */
-    showCronExpression?: boolean;
-    /** Allow copying cron expression (default: false) */
-    allowCopy?: boolean;
-    /** 12h or 24h time format (default: '24h') */
-    timeFormat?: '12h' | '24h';
-    /** Disable all interactions */
-    disabled?: boolean;
-    /** Additional CSS classes */
-    className?: string;
-}
-interface CronSchedulerProviderProps {
-    children: React.ReactNode;
-    value?: string;
-    onChange?: (cron: string) => void;
-    defaultType?: ScheduleType;
-}
-
-/**
- * LazyCronScheduler - Lazy-loaded cron expression builder
- *
- * Automatically shows loading state while CronScheduler loads (~15KB).
- * Uses createLazyComponent factory for optimal code-splitting.
- *
- * @example
- * // Basic usage
- * <LazyCronScheduler
- *   value="0 9 * * *"
- *   onChange={handleChange}
- * />
- *
- * @example
- * // With all options
- * <LazyCronScheduler
- *   value={cron}
- *   onChange={setCron}
- *   defaultType="weekly"
- *   showPreview
- *   showCronExpression
- *   allowCopy
- *   timeFormat="24h"
- * />
- */
-declare const LazyCronScheduler: react.ComponentType<CronSchedulerProps>;
-
-declare const LazyTree: react.ComponentType<TreeRootProps<unknown>>;
-
-/**
- * Persona — display identity attached to messages and config.
- *
- * Used by `ChatMessage.sender`, `ChatConfig.user`, `ChatConfig.assistant`.
- */
-type ChatRole = 'user' | 'assistant' | 'system';
-interface ChatPersona {
-    /** Display name. */
-    name?: string;
-    /** Avatar image URL. */
-    avatarUrl?: string;
-    /** Initials fallback when no avatar. Auto-derived from `name` if absent. */
-    initials?: string;
-    /** Tooltip / aria description. */
-    description?: string;
-}
-interface ChatUserContext extends ChatPersona {
-    email?: string;
-    language?: string;
-    role?: string;
-    /** Free-form custom data forwarded to transport metadata. */
-    custom?: Record<string, unknown>;
-}
-interface ChatAssistantContext extends ChatPersona {
-    /** Model identifier (gpt-4o, claude-opus, …). */
-    model?: string;
-}
-
-/**
- * Tool calls — assistant-initiated function/tool invocations during a turn.
- */
-interface ChatToolCall {
-    id: string;
-    name: string;
-    input: unknown;
-    output?: unknown;
-    /** Live buffer accumulated during streaming. Replaced by `output` on completion. */
-    streamingText?: string;
-    status: 'running' | 'success' | 'error' | 'cancelled';
-    startedAt: number;
-    endedAt?: number;
-    /** Optional grouping label for parallel/fan-out execution. */
-    sourceHostname?: string;
-}
-
-/**
- * Attachments + sources attached to a chat message.
- */
-interface ChatAttachment {
-    id: string;
-    type: 'image' | 'file' | 'audio' | 'video';
-    url: string;
-    thumbnailUrl?: string;
-    name?: string;
-    mimeType?: string;
-    sizeBytes?: number;
-    status?: 'uploading' | 'ready' | 'error';
-    /** 0..1 while uploading. */
-    progress?: number;
-    /** Extracted text from images (OCR). */
-    ocrText?: string;
-}
-interface ChatSource {
-    title: string;
-    url: string;
-    snippet?: string;
-    chunkIndex?: number;
-}
-
-/**
- * The atomic unit — a single message in a chat session.
- *
- * Composed of role + content + optional rich-data slots (attachments,
- * sources, tool calls). Serializable: no Date, no Map.
- */
-
-interface ChatMessage {
-    id: string;
-    role: ChatRole;
-    content: string;
-    /** epoch ms — serializable. */
-    createdAt: number;
-    isStreaming?: boolean;
-    isError?: boolean;
-    /** Bumps on edit so memo keys invalidate. */
-    version?: number;
-    /** Per-message persona override (multi-user / multi-bot). Falls back to
-     *  `ChatConfig.user` / `ChatConfig.assistant` when absent. */
-    sender?: ChatPersona;
-    /** Simple status indicator above message ("Searching knowledge base..."). */
-    toolActivity?: string;
-    toolCalls?: ChatToolCall[];
-    attachments?: ChatAttachment[];
-    sources?: ChatSource[];
-    tokensIn?: number;
-    tokensOut?: number;
-}
-
-/**
- * UI label strings — i18n is the host's job. Pass overrides via
- * `ChatConfig.labels` and merge with `DEFAULT_LABELS`.
- */
-interface ChatLabels {
-    send: string;
-    cancel: string;
-    copy: string;
-    regenerate: string;
-    edit: string;
-    delete: string;
-    retry: string;
-    newChat: string;
-    loadMore: string;
-    jumpToLatest: string;
-    attach: string;
-    voice: string;
-    errorGeneric: string;
-    cancelledSuffix: string;
-}
-declare const DEFAULT_LABELS: ChatLabels;
-
-/**
- * Top-level chat configuration — placeholder, suggestions, identities, prefs.
- */
-
-type ChatDisplayMode = 'closed' | 'embedded' | 'floating' | 'sidebar' | 'fullscreen';
-interface ChatPrefs {
-    /** Submit hotkey for the composer. */
-    submitOn?: 'enter' | 'cmd+enter';
-    /** UI density. */
-    density?: 'comfortable' | 'compact';
-    /** Locale forwarded to transport metadata. */
-    locale?: string;
-    /** Show timestamps on each bubble. */
-    showTimestamps?: boolean;
-}
-interface ChatConfig {
-    /** Window title / aria-label. */
-    title?: string;
-    /** Composer placeholder. */
-    placeholder?: string;
-    /** Empty-state greeting. */
-    greeting?: string;
-    /** Empty-state description. */
-    description?: string;
-    /** Suggested prompts shown on empty conversation. */
-    suggestions?: Array<{
-        label: string;
-        prompt: string;
-    }>;
-    /** Locale forwarded to the transport via stream metadata. */
-    locale?: string;
-    /** Project / chat slug forwarded to the transport. */
-    slug?: string;
-    /** UI density. Use `prefs.density` for the same effect; this stays for
-     *  backwards compatibility. */
-    density?: 'comfortable' | 'compact';
-    /** Identity of the human author. Renders avatar / name on user bubbles
-     *  and gets stamped on outgoing messages as `message.sender`. */
-    user?: ChatUserContext;
-    /** Identity of the assistant. Renders avatar / name on assistant bubbles. */
-    assistant?: ChatAssistantContext;
-    /** UI preferences. */
-    prefs?: ChatPrefs;
-    /** Visual labels (i18n is the host's job). */
-    labels?: Partial<ChatLabels>;
-}
-
-/**
- * SSE stream events — the canonical wire shape consumed by the reducer.
- *
- * Backend-specific shapes (e.g. pydantic-AI's `text_delta`) get normalized
- * into this union by `mapPydanticAIEvent` and friends.
- */
-
-type ChatStreamEvent = {
-    type: 'message_start';
-    messageId: string;
-    sessionId: string;
-} | {
-    type: 'resume_start';
-} | {
-    type: 'chunk';
-    delta: string;
-} | {
-    type: 'tool_activity';
-    tool: string;
-    status: string;
-} | {
-    type: 'tool_call_start';
-    toolId: string;
-    name: string;
-    input: unknown;
-    sourceHostname?: string;
-} | {
-    type: 'tool_call_delta';
-    toolId: string;
-    delta: string;
-} | {
-    type: 'tool_call_end';
-    toolId: string;
-    output: unknown;
-    status: 'success' | 'error';
-} | {
-    type: 'message_end';
-    tokensIn?: number;
-    tokensOut?: number;
-    sources?: ChatSource[];
-} | {
-    type: 'error';
-    code: string;
-    message: string;
-};
-
-/**
- * Session info + history page shapes returned by transports.
- */
-
-interface CreateSessionOptions {
-    metadata?: Record<string, unknown>;
-}
-interface SessionInfo {
-    sessionId: string;
-    /** If the server resumed an existing session, it may return prior messages. */
-    messages?: ChatMessage[];
-    hasMore?: boolean;
-    cursor?: string | null;
-    resumed?: boolean;
-    /**
-     * Optional human-readable title (typically derived from the first
-     * user message). Hosts that render a session-list sidebar can read
-     * this directly instead of crawling messages. Plan64.
-     */
-    title?: string;
-}
-interface HistoryPage {
-    messages: ChatMessage[];
-    hasMore: boolean;
-    nextCursor: string | null;
-}
-interface StreamOptions {
-    signal: AbortSignal;
-    attachments?: ChatAttachment[];
-    metadata?: Record<string, unknown>;
-}
-interface SendOptions {
-    signal?: AbortSignal;
-    attachments?: ChatAttachment[];
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * Transport interface — what every chat backend adapter implements.
- *
- * Default web implementation lives in `core/transport/http.ts`.
- * Pydantic-AI adapter lives in `core/transport/pydantic-ai-transport.ts`.
- */
-
-interface ChatTransport {
-    createSession(opts?: CreateSessionOptions): Promise<SessionInfo>;
-    loadHistory(sessionId: string, cursor?: string | null, limit?: number): Promise<HistoryPage>;
-    stream(sessionId: string, content: string, options: StreamOptions): AsyncGenerator<ChatStreamEvent, void, void>;
-    send(sessionId: string, content: string, options?: SendOptions): Promise<ChatMessage>;
-    closeSession(sessionId: string): Promise<void>;
-}
-
-type ChatAudioEvent = 'messageSent' | 'messageReceived' | 'streamStart' | 'error' | 'mention' | 'notification';
-/** Map an event to a sound URL. `false` silences the event explicitly. */
-type ChatAudioSounds = Partial<Record<ChatAudioEvent, string | false>>;
-interface ChatAudioConfig {
-    /** Map event → asset URL. Omit (or set `false`) to silence one event. */
-    sounds?: ChatAudioSounds;
-    /** Master volume 0..1. Persisted via the global prefs store. */
-    volume?: number;
-    /**
-     * Per-event volume multipliers (0..1). Applied on top of `volume`.
-     * Defaults applied by `useChatAudio` if not provided:
-     *   - error: 0.25  (gentle — error UI is the loud signal, not the sound)
-     *   - mention: 1.0 (louder than baseline received)
-     *   - messageSent: 0.5  (subtle self-confirmation)
-     *   - messageReceived: 0.7
-     *   - streamStart: 0.3  (very subtle, fires often)
-     *   - notification: 0.9
-     *
-     * Pass `{}` to disable defaults; pass overrides to tweak.
-     */
-    eventVolumes?: Partial<Record<ChatAudioEvent, number>>;
-    /** Master mute. */
-    muted?: boolean;
-    /** Custom predicate — return `false` to suppress a play call. */
-    shouldPlay?: (event: ChatAudioEvent) => boolean;
-    /** Default-suppress when user prefers reduced motion. Default: true. */
-    respectReducedMotion?: boolean;
-    /** Default-suppress when user prefers reduced data. Default: true. */
-    respectReducedData?: boolean;
-    /** Mute when host page is hidden (`visibilityState === 'hidden'`). Default: true. */
-    muteWhenHidden?: boolean;
-    /**
-     * Skip web playback entirely — `play()` becomes a no-op. Pair with
-     * `onSoundEvent` for native hosts (cmdop_go / Tauri) that play sounds
-     * outside the browser.
-     */
-    silenced?: boolean;
-    /**
-     * Side-channel fired whenever `play(event)` is called. Stays active
-     * even when `silenced=true`. Use to bridge into a native audio backend.
-     */
-    onSoundEvent?: (event: ChatAudioEvent) => void;
-}
-interface UseChatAudioReturn {
-    /** Play a sound for an event. No-ops if the event has no URL or is muted. */
-    play: (event: ChatAudioEvent) => void;
-    /** Eagerly load an event's audio (called automatically on mount). */
-    preload: (event: ChatAudioEvent) => void;
-    /** Manually unlock — useful in stories/tests. */
-    unlock: () => void;
-    /** True after the first user gesture inside the chat root. */
-    isUnlocked: boolean;
-    /** Master mute (persistent). */
-    muted: boolean;
-    setMuted: (m: boolean) => void;
-    /** Flip mute state — convenience. */
-    toggleMute: () => void;
-    /** Master volume 0..1 (persistent). */
-    volume: number;
-    setVolume: (v: number) => void;
-    /** Per-event opt-out (persistent). */
-    isEventEnabled: (event: ChatAudioEvent) => boolean;
-    setEventEnabled: (event: ChatAudioEvent, enabled: boolean) => void;
-    /** True when no sounds are configured (or `silenced`). */
-    isSilent: boolean;
-}
-
-/**
- * Pure chat state machine. Zero React. Zero I/O.
- *
- * Invariants:
- *  - At most one message has `isStreaming === true` at any time. It is always
- *    the last message in the array.
- *  - Messages are immutable; updates produce new objects.
- *  - `version` bumps on edit so memo keys invalidate.
- */
-
-interface ChatState {
-    sessionId: string | null;
-    messages: ChatMessage[];
-    /** Initial history load in flight. */
-    isLoading: boolean;
-    /** Assistant is generating a reply. */
-    isStreaming: boolean;
-    /** Older history page in flight. */
-    isLoadingMore: boolean;
-    hasMore: boolean;
-    oldestCursor: string | null;
-    error: string | null;
-}
-declare const initialState: ChatState;
-type ChatAction = {
-    type: 'SESSION_SET';
-    sessionId: string;
-    messages?: ChatMessage[];
-    hasMore?: boolean;
-    cursor?: string | null;
-} | {
-    type: 'HISTORY_LOAD_START';
-} | {
-    type: 'HISTORY_LOAD_DONE';
-    messages: ChatMessage[];
-    hasMore: boolean;
-    cursor: string | null;
-} | {
-    type: 'HISTORY_MORE_START';
-} | {
-    type: 'HISTORY_MORE_DONE';
-    messages: ChatMessage[];
-    hasMore: boolean;
-    cursor: string | null;
-} | {
-    type: 'MESSAGE_USER_ADD';
-    message: ChatMessage;
-} | {
-    type: 'STREAM_START';
-    id: string;
-    createdAt?: number;
-} | {
-    type: 'STREAM_CHUNK';
-    delta: string;
-} | {
-    type: 'STREAM_TOOL_ACTIVITY';
-    tool: string;
-} | {
-    type: 'TOOL_CALL_START';
-    messageId: string;
-    toolCall: ChatToolCall;
-} | {
-    type: 'TOOL_CALL_DELTA';
-    messageId: string;
-    toolId: string;
-    delta: string;
-} | {
-    type: 'TOOL_CALL_END';
-    messageId: string;
-    toolId: string;
-    output: unknown;
-    status: 'success' | 'error';
-} | {
-    type: 'STREAM_DONE';
-    id: string;
-    tokensIn?: number;
-    tokensOut?: number;
-    sources?: ChatSource[];
-} | {
-    type: 'STREAM_CANCELLED';
-    id: string;
-    partialText: string;
-    label?: string;
-} | {
-    type: 'STREAM_ERROR';
-    id?: string;
-    message: string;
-} | {
-    type: 'STREAM_CANCEL_PLACEHOLDER';
-    id: string;
-} | {
-    type: 'STREAM_RESUME_EXISTING';
-} | {
-    type: 'MESSAGE_EDIT';
-    id: string;
-    content: string;
-} | {
-    type: 'MESSAGE_DELETE';
-    id: string;
-} | {
-    type: 'MESSAGE_INJECT';
-    message: ChatMessage;
-    position?: 'append' | 'prepend';
-} | {
-    type: 'MESSAGE_PATCH';
-    id: string;
-    patch: Partial<ChatMessage>;
-} | {
-    type: 'MESSAGES_CLEAR';
-} | {
-    type: 'ERROR_SET';
-    error: string | null;
-} | {
-    type: 'ATTACHMENT_PROGRESS';
-    messageId: string;
-    attachmentId: string;
-    progress?: number;
-    status?: ChatAttachment['status'];
-};
-declare function reducer(state: ChatState, action: ChatAction): ChatState;
-
-interface UseChatConfig {
-    transport: ChatTransport;
-    initialSessionId?: string;
-    autoCreateSession?: boolean;
-    streaming?: boolean;
-    pageSize?: number;
-    onError?: (err: Error) => void;
-    /** Fires once an assistant message finishes streaming (or buffered send returns). */
-    onMessageEnd?: (msg: ChatMessage) => void;
-    /** Fires after a user message is added to the state (right before streaming starts). */
-    onMessageSent?: (msg: ChatMessage) => void;
-    /** Fires when the assistant placeholder is created (first byte / pre-stream). */
-    onStreamStart?: (assistantMessageId: string) => void;
-    metadata?: Record<string, unknown>;
-    /** Stamped on outgoing user messages as `message.sender`. */
-    userPersona?: ChatPersona;
-    /**
-     * Rewrite the outgoing message content right before it hits the
-     * transport — runs after the user bubble is added (so history shows
-     * the original) but before `transport.stream/send`. Sync or async.
-     * Return the original to opt out for that call.
-     *
-     * Use case: strip rich-display chips (e.g. mention links) so the LLM
-     * sees plain text, while the bubble keeps the chip rendering. Plan64.
-     */
-    onBeforeSend?: (content: string) => string | Promise<string>;
-    /**
-     * Enable verbose dev-mode logging (consola, namespace `chat:*`).
-     * Defaults to `isDev` from `@djangocfg/ui-core/lib`. Pass `false` to silence
-     * even in development; `true` to force on in production.
-     */
-    debug?: boolean;
-}
-interface UseChatReturn extends ChatState {
-    sendMessage: (content: string, attachments?: ChatAttachment[]) => Promise<void>;
-    cancelStream: () => void;
-    regenerate: (messageId?: string) => Promise<void>;
-    editMessage: (id: string, content: string) => Promise<void>;
-    deleteMessage: (id: string) => void;
-    clearMessages: () => void;
-    loadMore: () => Promise<void>;
-    newSession: () => Promise<void>;
-    lastError: Error | null;
-    /**
-     * Inject a complete message from outside (push notification, admin
-     * takeover, system notice). De-duped by id. Position defaults to
-     * `append` — pass `prepend` for retroactive inserts.
-     */
-    injectMessage: (message: ChatMessage, position?: 'append' | 'prepend') => void;
-    /**
-     * Patch fields of an existing message in place (e.g. live-edit the
-     * admin's last reply, mark a message as resolved). No-op if the id
-     * doesn't exist.
-     */
-    updateMessage: (id: string, patch: Partial<ChatMessage>) => void;
-}
-declare function useChat(config: UseChatConfig): UseChatReturn;
-
-interface UseChatLayoutConfig {
-    defaultMode?: ChatDisplayMode;
-    storageKey?: string;
-    sidebarStorageKey?: string;
-    reserveCssVar?: string;
-    defaultSidebarWidth?: number;
-    minSidebarWidth?: number;
-    maxSidebarWidth?: number;
-    /** Mobile breakpoint, e.g. '(max-width: 640px)'. */
-    mobileQuery?: string;
-}
-interface UseChatLayoutReturn {
-    mode: ChatDisplayMode;
-    setMode: (m: ChatDisplayMode) => void;
-    open: () => void;
-    close: () => void;
-    toggle: () => void;
-    sidebarWidth: number;
-    setSidebarWidth: (w: number) => void;
-    isMobile: boolean;
-    /** Mode after mobile collapse rules — sidebar/floating become fullscreen on mobile. */
-    effectiveMode: ChatDisplayMode;
-}
-declare function useChatLayout(config?: UseChatLayoutConfig): UseChatLayoutReturn;
-
-/** Imperative handle a composer (built-in or custom) registers so
- *  other parts of the chat tree can drive it without prop-drilling a
- *  ref. `focus()` is the baseline; the rest is optional so non-textarea
- *  hosts can keep returning `{ focus }` only.
- *
- *  Implemented by:
- *   - built-in `<Composer>` — backed by `useChatComposer.textareaRef`.
- *   - `@djangocfg/ui-tools/markdown-editor` — backed by the TipTap
- *     editor (`editor.commands.focus('end')`).
- *  Consumed by `VoiceComposerSlot` for the focus / move-caret behaviour
- *  during live dictation.
- */
-interface ComposerHandle {
-    focus: () => void;
-    /** Move the caret to the very end of the input. */
-    moveCursorToEnd?: () => void;
-    /** Read the current draft text. Needed by voice dictation to anchor
-     *  partial transcripts onto the user's already-typed prefix. */
-    getValue?: () => string;
-    /** Replace the current draft text. Voice dictation uses this to push
-     *  interim + final transcripts into the composer without owning a
-     *  controlled binding. */
-    setValue?: (value: string) => void;
-}
-interface ChatContextValue extends UseChatReturn {
-    layout: UseChatLayoutReturn;
-    config: ChatConfig;
-    labels: ChatLabels;
-    audio: UseChatAudioReturn;
-    /** True iff the host wired at least one ``audio.sounds[event]`` URL.
-     * Components like ``AudioToggle`` use this to auto-hide when there
-     * is nothing to mute. */
-    hasAudio: boolean;
-    /** Composer registry. The built-in `<Composer>` calls
-     *  `registerComposer({ focus })` on mount; custom composers (e.g.
-     *  cmdop's MarkdownEditor wrapper) do the same via the
-     *  `useRegisterComposer` helper. Read it via `composer?.focus()` —
-     *  null until any composer has mounted. Plan64 follow-up. */
-    composer: ComposerHandle | null;
-    registerComposer: (handle: ComposerHandle | null) => void;
-}
-interface ChatProviderProps {
-    transport: ChatTransport;
-    config?: ChatConfig;
-    initialSessionId?: string;
-    autoCreateSession?: boolean;
-    streaming?: boolean;
-    /** Audio-trigger configuration. Off by default (no `sounds` map). */
-    audio?: ChatAudioConfig;
-    /** Enable verbose dev logging via consola. Defaults to `isDev`. */
-    debug?: boolean;
-    /**
-     * Rewrite outgoing message content before it hits the transport.
-     * History bubble keeps the original; useful for stripping rich-
-     * display chips so the LLM sees plain text. See `useChat`.
-     */
-    onBeforeSend?: (content: string) => string | Promise<string>;
-    children?: ReactNode;
-}
-declare function ChatProvider({ transport, config, initialSessionId, autoCreateSession, streaming, audio, debug, onBeforeSend, children, }: ChatProviderProps): react_jsx_runtime.JSX.Element;
-declare function useChatContext(): ChatContextValue;
-declare function useChatContextOptional(): ChatContextValue | null;
-
-interface UseChatComposerOptions {
-    onSubmit: (content: string, attachments: ChatAttachment[]) => void | Promise<void>;
-    initialValue?: string;
-    maxLength?: number;
-    maxAttachments?: number;
-    disabled?: boolean;
-    /** 'enter' = Enter sends, Shift+Enter newline. 'cmd+enter' = Enter inserts newline, Cmd/Ctrl+Enter sends. */
-    submitOn?: 'enter' | 'cmd+enter';
-    history?: {
-        enabled?: boolean;
-        size?: number;
-    };
-    onPasteFiles?: (files: File[]) => void;
-    /**
-     * Persist the current draft to `sessionStorage` under this key. The
-     * draft is loaded once on mount (overrides `initialValue` if non-
-     * empty) and rewritten on every value change. Cleared on `reset()`.
-     *
-     * Pass a per-conversation id to keep separate drafts per chat. Pass
-     * `undefined` (default) to disable persistence — composer behaves
-     * 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;
-    setValue: (next: string) => void;
-    attachments: ChatAttachment[];
-    addAttachment: (a: ChatAttachment) => void;
-    removeAttachment: (id: string) => void;
-    isSubmitting: boolean;
-    canSubmit: boolean;
-    submit: () => Promise<void>;
-    reset: () => void;
-    focus: () => void;
-    textareaRef: RefObject<HTMLTextAreaElement | null>;
-    textareaProps: {
-        ref: RefObject<HTMLTextAreaElement | null>;
-        value: string;
-        disabled: boolean;
-        onChange: (e: ChangeEvent<HTMLTextAreaElement>) => void;
-        onKeyDown: (e: KeyboardEvent<HTMLTextAreaElement>) => void;
-        onPaste: (e: ClipboardEvent<HTMLTextAreaElement>) => void;
-    };
-    recallPrevious: () => void;
-    recallNext: () => void;
-}
-declare function useChatComposer(options: UseChatComposerOptions): UseChatComposerReturn;
-
-type ComposerSize = 'sm' | 'md' | 'lg';
-interface ComposerProps {
-    composer: UseChatComposerReturn;
-    placeholder?: string;
-    disabled?: boolean;
-    showAttachmentButton?: boolean;
-    onPickFiles?: () => void;
-    toolbarStart?: ReactNode;
-    toolbarEnd?: ReactNode;
-    attachmentTray?: ReactNode;
-    className?: string;
-    textareaClassName?: string;
-    /** Visual size — controls textarea height + button slot size.
-     *
-     * - ``sm``  — 32px slot, dense compact composer (admin sidebars, etc).
-     * - ``md``  — 36px slot, default. Same as the legacy fixed size.
-     * - ``lg``  — 48px slot, generous textarea. Use when the chat is
-     *   the page's primary surface (onboarding, support).
-     */
-    size?: ComposerSize;
-    /** Show "Stop" button instead of "Send" while streaming. */
-    isStreaming?: boolean;
-    onCancel?: () => void;
-}
-declare const Composer: react.ForwardRefExoticComponent<ComposerProps & react.RefAttributes<HTMLDivElement>>;
-
-interface AttachmentRendererArgs {
-    attachment: ChatAttachment;
-    /** True when shown inside the composer's staging tray (denser layout). */
-    isInComposer: boolean;
-    onClick?: () => void;
-    onRemove?: () => void;
-}
-type AttachmentRenderer = (args: AttachmentRendererArgs) => ReactNode;
-interface AttachmentRendererMap {
-    image?: AttachmentRenderer;
-    audio?: AttachmentRenderer;
-    video?: AttachmentRenderer;
-    file?: AttachmentRenderer;
-    /** Fallback renderer when no per-type entry matched. */
-    default?: AttachmentRenderer;
-}
-interface CommonProps {
-    attachments: ChatAttachment[];
-    maxVisible?: number;
-    onClick?: (a: ChatAttachment) => void;
-    onRemove?: (a: ChatAttachment) => void;
-    isInComposer?: boolean;
-    className?: string;
-}
-interface AttachmentsGridProps extends CommonProps {
-    layout?: 'wrap' | 'grid';
-}
-declare function AttachmentsGrid({ attachments, maxVisible, onClick, onRemove, isInComposer, layout, className, }: AttachmentsGridProps): react_jsx_runtime.JSX.Element;
-interface AttachmentsListProps extends CommonProps {
-    /** Per-type renderer overrides. Falls back to the default tile. */
-    renderers?: AttachmentRendererMap;
-}
-declare function AttachmentsList({ attachments, maxVisible, onClick, onRemove, renderers, isInComposer, className, }: AttachmentsListProps): react_jsx_runtime.JSX.Element;
-interface AttachmentsProps extends CommonProps {
-    layout?: 'grid' | 'row';
-    renderers?: AttachmentRendererMap;
-}
-declare function Attachments(props: AttachmentsProps): react_jsx_runtime.JSX.Element;
-
-type ToolPayloadKind = 'input' | 'output' | 'streaming';
-interface ToolCallsProps {
-    calls: ChatToolCall[];
-    /** Open every panel up-front. Default: false (panels are closed). */
-    defaultExpanded?: boolean;
-    /** Auto-open while a tool is running, then auto-close on completion.
-     *  User toggles after that are remembered. Default: true. */
-    expandWhileStreaming?: boolean;
-    /** Override how the tool input payload is rendered. Receives the raw value. */
-    renderInput?: (input: unknown, call: ChatToolCall) => ReactNode;
-    /** Override how the tool output payload is rendered. */
-    renderOutput?: (output: unknown, call: ChatToolCall) => ReactNode;
-    /** Override how the live `streamingText` is rendered. */
-    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, renderAfterCalls, renderToolCall, hideToolCalls, className, }: ToolCallsProps): react_jsx_runtime.JSX.Element;
-
-interface ChatRootProps {
-    transport: ChatTransport;
-    config?: ChatConfig;
-    initialSessionId?: string;
-    autoCreateSession?: boolean;
-    streaming?: boolean;
-    /** Audio-trigger configuration. Off by default (no `sounds` map). */
-    audio?: ChatAudioConfig;
-    /**
-     * Verbose dev-mode logging via `consola` (namespace `chat:*`).
-     * Defaults to `isDev` from `@djangocfg/ui-core/lib`. Pass `false` to silence
-     * even in development, or `true` to force on in production for debugging.
-     */
-    debug?: boolean;
-    className?: string;
-    /** Sticky banner above the message list (e.g. quota warning). */
-    banner?: ReactNode;
-    /** Header row below the banner — title / actions / session switcher. */
-    header?: ReactNode;
-    /** Footer slot below the composer (disclaimers, model picker). */
-    footer?: ReactNode;
-    /** Replaces the default `<EmptyState>` rendered when the conversation is empty. */
-    empty?: ReactNode;
-    /** Slot left of the textarea inside `<Composer>`. */
-    composerToolbarStart?: ReactNode;
-    /** Slot right of the textarea inside `<Composer>`. */
-    composerToolbarEnd?: ReactNode;
-    /** Replaces the default attachment tray inside `<Composer>`. */
-    composerAttachmentTray?: ReactNode;
-    /** Replaces the default `<JumpToLatest>` floating pill. */
-    jumpToLatest?: ReactNode;
-    /** Replace `<MessageBubble>` per message. */
-    renderMessage?: (m: ChatMessage, i: number) => ReactNode;
-    /** Render the header lazily — receives the chat context. */
-    renderHeader?: (ctx: ChatContextValue) => ReactNode;
-    /** Render the empty-state lazily — receives a `setValue` to seed the composer. */
-    renderEmpty?: (api: {
-        setValue: (v: string) => void;
-        focus: () => void;
-    }) => ReactNode;
-    /** Forwarded into `<MessageBubble toolCallsProps>` so hosts can swap payload renderers. */
-    toolCallsProps?: Omit<ToolCallsProps, 'calls'>;
-    /** Per-type attachment renderers — `{ image, audio, video, file, default }`. */
-    attachmentRenderers?: AttachmentRendererMap;
-    /** Called when an attachment tile is clicked (e.g. open lightbox). */
-    onAttachmentOpen?: (attachment: ChatAttachment) => void;
-    /** Show the paperclip "attach" button in the composer. */
-    showAttachmentButton?: boolean;
-    /** Called when the user clicks the attach button (host opens its file picker). */
-    onPickFiles?: () => void;
-    /** Hide the composer input area entirely (e.g. while waiting for human approval). */
-    hideComposer?: boolean;
-    /** Composer size variant. Default ``md`` (36px slot). Use ``lg`` for primary
-     * surfaces (onboarding, full-page chat), ``sm`` for dense sidebars. */
-    composerSize?: ComposerSize;
-    /** Extra className forwarded to the `<MessageList>` scroll container.
-     * Use to add padding inside the scroll area so the scrollbar stays flush
-     * with the edge (e.g. `"px-6 pt-6 sm:px-8"`). */
-    listClassName?: string;
-    /** Extra className forwarded to the `<Composer>` wrapper div. */
-    composerClassName?: string;
-    /**
-     * Click in the message area → focus the composer (Slack / ChatGPT / Linear).
-     * Honours selection drag, interactive elements, and touch input.
-     * @default true
-     */
-    focusOnEmptyClick?: boolean;
-}
-declare function ChatRoot(props: ChatRootProps): react_jsx_runtime.JSX.Element;
-
-type ChatFABPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
-type ChatFABVariant = 'simple' | 'animated' | 'glass';
-type ChatFABSize = 'sm' | 'md' | 'lg' | 'responsive';
-interface ChatFABProps {
-    /** Click handler — typically toggles a `ChatDock`. */
-    onClick: () => void;
-    /** Accessible label. */
-    ariaLabel?: string;
-    /** Icon inside the FAB. Defaults to a bot glyph. */
-    icon?: ReactNode;
-    /** Visual style. @default 'simple' */
-    variant?: ChatFABVariant;
-    /** Button size. @default 'md' */
-    size?: ChatFABSize;
-    /** Fixed-screen position. @default 'bottom-right' */
-    position?: ChatFABPosition;
-    /** Pixel offset from screen edges. @default 24 */
-    offset?: number;
-    /** z-index for the button. @default 9999 */
-    zIndex?: number;
-    /** Show a small attention dot (unread / new). */
-    pulse?: boolean;
-    /**
-     * Numeric badge — unread count. Numbers > 9 render as "9+".
-     * Overrides `pulse` when both set.
-     */
-    badge?: number;
-    /** Hover tooltip text. Shows next to the FAB on hover/focus. */
-    tooltip?: string;
-    /**
-     * Render in-place (no fixed positioning) so the FAB sits inline in the
-     * normal document flow. Useful for stories, screenshots, and previews
-     * inside a contained playground panel. @default false
-     */
-    inline?: boolean;
-    /** Override classes on the button itself. */
-    className?: string;
-    /** Extra style on the button (caller-controlled overrides). */
-    style?: CSSProperties;
-}
-/**
- * Floating action button for opening a chat dock. Pure presentation — owns
- * no state. Wire it to whatever toggles your dock open.
- *
- * For the common "FAB + dock + hotkey" composition, use `<ChatLauncher>` —
- * this primitive is only useful when you need custom triggering.
- */
-declare function ChatFAB({ onClick, ariaLabel, icon, variant, size, position, offset, zIndex, pulse, badge, tooltip, inline, className, style, }: ChatFABProps): react_jsx_runtime.JSX.Element;
-
-type ChatDockMode = 'popover' | 'side';
-type ChatDockSide = 'left' | 'right';
-interface ChatDockProps {
-    /** Controlled open state. */
-    open: boolean;
-    /** Called when the user clicks the close button. */
-    onClose: () => void;
-    /** Dock contents (typically a `<Chat>` component). */
-    children: ReactNode;
-    /**
-     * Visual mode.
-     * - `popover` (default): floating card anchored to a corner, fixed size, FAB-style.
-     * - `side`: docked panel pinned to the left/right edge, full viewport height.
-     */
-    mode?: ChatDockMode;
-    /** Side for `mode='side'`. @default 'right' */
-    side?: ChatDockSide;
-    /** Header title text. */
-    title?: ReactNode;
-    /** Header icon. Defaults to a bot glyph. */
-    icon?: ReactNode;
-    /**
-     * Header actions slot (right side, before the close button).
-     * Use `ChatHeaderActionButton` to keep visual consistency.
-     */
-    headerActions?: ReactNode;
-    /** Hide the header entirely (you render your own inside `children`). */
-    hideHeader?: boolean;
-    /** ARIA label for the close button. @default 'Close' */
-    closeLabel?: string;
-    /** Dock width in px. Clamped to viewport. @default 480 (popover) / 420 (side) */
-    width?: number;
-    /** Dock height in px. Only used in `popover` mode. @default 720 */
-    height?: number;
-    /** Which screen corner to dock to in `popover` mode. @default 'bottom-right' */
-    position?: ChatFABPosition;
-    /** Offset from screen edges in px (popover only). @default 24 / 96 */
-    offset?: {
-        horizontal?: number;
-        vertical?: number;
-    };
-    /** Transition duration in ms — should match CSS animation. @default 200 */
-    exitDurationMs?: number;
-    /** z-index. @default 10000 */
-    zIndex?: number;
-    /** Accessible dialog label. */
-    ariaLabel?: string;
-    /** Extra classes on the dock container. */
-    className?: string;
-    /**
-     * Take over the full viewport on mobile (< 768px). Applies to both modes.
-     * @default true
-     */
-    mobileFullscreen?: boolean;
-    /**
-     * Render in-place (not in `document.body` via a portal). Useful for stories,
-     * screenshots, or wrapping the dock inside a custom container. @default false
-     */
-    disablePortal?: boolean;
-    /**
-     * Drop fixed positioning entirely — the dock renders as a normal flow
-     * element sized by `width`/`height`. Combine with `disablePortal` for
-     * stories/previews where the dock should sit inside the panel instead
-     * of attaching to the viewport. @default false
-     */
-    inline?: boolean;
-    /**
-     * In `mode='side'`, reserve space on the document body so page content
-     * isn't covered by the dock. Sets `padding-{side}` on `<body>` while
-     * the dock is open and exposes the width via the `--chat-dock-reserve`
-     * CSS variable for custom layouts. @default true (when mode='side')
-     */
-    reserveBodySpace?: boolean;
-}
-/**
- * Fixed-position chat surface. Two modes:
- *
- * - `popover` — floating card anchored to a corner. Companion to `<ChatFAB>`.
- * - `side` — full-height panel pinned to the left/right edge. App-shell style.
- *
- * Renders only when `open` is true (plus the leave-transition tail). Uses
- * `useChatPresence` for the four-phase mount/animate/unmount cycle.
- */
-declare function ChatDock({ open, onClose, children, mode, side, title, icon, headerActions, hideHeader, closeLabel, width, height, position, offset, exitDurationMs, zIndex, ariaLabel, className, mobileFullscreen, disablePortal, inline, reserveBodySpace, }: ChatDockProps): react_jsx_runtime.JSX.Element;
-
-interface ChatHeaderProps {
-    /** Window title text. */
-    title?: ReactNode;
-    /** Icon next to the title. Defaults to a bot glyph. */
-    icon?: ReactNode;
-    /**
-     * Action slot — appears to the right of the title, before the close button.
-     * Use for reset / settings / minimize / etc. Compose with `ChatHeaderActionButton`.
-     */
-    actions?: ReactNode;
-    /** Show the close (×) button. @default true */
-    showClose?: boolean;
-    /** Close click handler. */
-    onClose?: () => void;
-    /** ARIA label for the close button. @default 'Close' */
-    closeLabel?: string;
-    /** Replace the close button entirely (rare — most hosts want the default). */
-    closeSlot?: ReactNode;
-    /** Extra classes on the `<header>` element. */
-    className?: string;
-}
-/**
- * Standalone chat header — title + icon + action slot + close button.
- *
- * Used by `<ChatDock>` automatically, but can be rendered standalone when
- * the host owns the chat container (e.g. embedded inline in a page).
- */
-declare function ChatHeader({ title, icon, actions, showClose, onClose, closeLabel, closeSlot, className, }: ChatHeaderProps): react_jsx_runtime.JSX.Element;
-
-interface ChatHeaderActionButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
-    /** Icon (required). */
-    icon: ReactNode;
-    /** Accessible label + native tooltip. */
-    ariaLabel: string;
-    /** Optional unread / status badge — small number on top-right. */
-    badge?: number;
-    /** Mark as destructive — uses destructive hover tokens. */
-    destructive?: boolean;
-    /** Optional visual loading state (e.g. while reset is in flight). */
-    loading?: boolean;
-}
-/**
- * Compact icon button for the chat header actions slot.
- *
- * Standard chrome: 28×28 ghost button, hover bg-accent, focus ring, optional
- * destructive variant, optional numeric badge for unread / pending.
- *
- * @example
- * ```tsx
- * <ChatHeader
- *   title="Assistant"
- *   onClose={close}
- *   actions={
- *     <>
- *       <ChatHeaderActionButton
- *         icon={<RotateCcw className="h-3.5 w-3.5" />}
- *         ariaLabel="Clear context"
- *         onClick={handleReset}
- *         loading={isResetting}
- *       />
- *       <ChatHeaderActionButton
- *         icon={<Settings className="h-3.5 w-3.5" />}
- *         ariaLabel="Settings"
- *         onClick={openSettings}
- *       />
- *     </>
- *   }
- * />
- * ```
- */
-declare const ChatHeaderActionButton: react.ForwardRefExoticComponent<ChatHeaderActionButtonProps & react.RefAttributes<HTMLButtonElement>>;
-
-interface ChatHeaderModeToggleProps {
-    /** Current dock mode. */
-    mode: ChatDockMode;
-    /** Toggle handler. Wire to `useChatDockPrefs().toggleMode`. */
-    onToggle: () => void;
-    /** Override aria/tooltip label for popover→side. */
-    expandLabel?: string;
-    /** Override aria/tooltip label for side→popover. */
-    collapseLabel?: string;
-    /**
-     * Always render — useful for stories. By default the toggle hides itself on
-     * viewports below `lg` (1024px) since side mode falls back to popover there.
-     */
-    forceVisible?: boolean;
-}
-/**
- * "Dock to side" / "back to popover" toggle.
- *
- * Side mode is desktop-only — on viewports below `lg` (1024px) `<ChatDock>`
- * silently falls back to popover anyway, so the toggle has nothing to do
- * and auto-hides. Pass `forceVisible` to override (e.g. in stories).
- */
-declare function ChatHeaderModeToggle({ mode, onToggle, expandLabel, collapseLabel, forceVisible, }: ChatHeaderModeToggleProps): react_jsx_runtime.JSX.Element;
-
-interface ChatHeaderAudioToggleProps {
-    /** Current muted state. */
-    muted: boolean;
-    /** Toggle handler. Wire to `useChatAudio().setMuted` or `toggleMute`. */
-    onToggle: () => void;
-    /** Override tooltip label for muted → unmuted. */
-    unmuteLabel?: string;
-    /** Override tooltip label for unmuted → muted. */
-    muteLabel?: string;
-}
-/**
- * Mute / unmute notification sounds. Drop into a `<ChatHeader>` actions
- * slot or into `<ChatDock headerActions>`.
- *
- * @example
- * ```tsx
- * const audio = useChatAudio({ sounds: {...} });
- * <ChatHeaderAudioToggle muted={audio.muted} onToggle={() => audio.setMuted(!audio.muted)} />
- * ```
- */
-declare function ChatHeaderAudioToggle({ muted, onToggle, unmuteLabel, muteLabel, }: ChatHeaderAudioToggleProps): react_jsx_runtime.JSX.Element;
-
-interface ChatHeaderResetButtonProps {
-    /**
-     * Backend reset call. Should resolve to `true` on success.
-     * Plugged into `useChatReset` for in-flight state.
-     */
-    onReset: () => Promise<boolean>;
-    /** Called after a successful reset (e.g. clear local messages, refetch). */
-    onSuccess?: () => void;
-    /** Called when reset fails (returned `false` or threw). */
-    onError?: (error?: unknown) => void;
-    /**
-     * Show a `window.dialog.confirm` before calling `onReset`. @default true
-     *
-     * Requires the host to mount `<DialogProvider>` from `@djangocfg/ui-core`
-     * — it installs the `window.dialog` API used here.
-     */
-    confirm?: boolean;
-    /** Confirm dialog title. */
-    confirmTitle?: string;
-    /** Confirm dialog message. */
-    confirmMessage?: string;
-    /** Override tooltip / aria label. */
-    ariaLabel?: string;
-}
-/**
- * Standard chat-reset action: prompts the user via `window.dialog.confirm`,
- * then runs the backend reset call through `useChatReset` so the button
- * spins while it's in flight.
- *
- * @example
- * ```tsx
- * <ChatHeaderResetButton
- *   onReset={api.clearChat}
- *   onSuccess={() => chat.clearMessages()}
- * />
- * ```
- */
-declare function ChatHeaderResetButton({ onReset, onSuccess, onError, confirm, confirmTitle, confirmMessage, ariaLabel, }: ChatHeaderResetButtonProps): react_jsx_runtime.JSX.Element;
-
-interface ChatHeaderLanguageButtonProps {
-    /** Override aria-label. Default "Speech language". */
-    ariaLabel?: string;
-    /**
-     * Subset of BCP-47 tags to offer. Default: every entry from the
-     * Web Speech catalogue (~66 tags incl. regional variants). Pass a
-     * tighter list when your backend STT only supports a subset.
-     */
-    allowedTags?: string[];
-    /** Hide the globe-fallback icon when no flag resolves. */
-    hideFallbackIcon?: boolean;
-    className?: string;
-}
-/**
- * Compact flag-button language picker for the chat header. Built on
- * top of the ui-core `<Combobox>` — searchable autocomplete with
- * flags, ~66 BCP-47 tags from the official Chrome Web Speech demo, and
- * a custom 28×28 trigger via `renderTrigger`.
- *
- * The selection persists into `useSpeechPrefs` (zustand+localStorage)
- * so `useSpeechRecognition` picks it up as the second-priority resolver
- * value (above i18n locale, below an explicit `language` prop).
- */
-declare function ChatHeaderLanguageButton({ ariaLabel, allowedTags, hideFallbackIcon, className, }: ChatHeaderLanguageButtonProps): react.ReactElement;
-
-interface ChatGreetingProps {
-    /** Controlled visibility — usually `!chatOpen && !userDismissed`. */
-    open: boolean;
-    /** Greeting text. Pass a string for the default bubble, or any ReactNode. */
-    children: ReactNode;
-    /** Click handler — typically opens the chat. Bubble is clickable when set. */
-    onClick?: () => void;
-    /** Close (×) button handler — typically marks the greeting as dismissed. */
-    onDismiss?: () => void;
-    /** Anchor relative to a FAB on the same side. @default 'bottom-right' */
-    position?: ChatFABPosition;
-    /**
-     * Horizontal pixel offset matching the FAB's `offset` prop, so the greeting
-     * lines up under the FAB. @default 24
-     */
-    fabOffset?: number;
-    /**
-     * Vertical pixel offset above/below the FAB centerline. @default 96
-     * (room for an `md` FAB plus a small gap).
-     */
-    fabClearance?: number;
-    /** Delay before the greeting appears, in ms. @default 1500 */
-    delayMs?: number;
-    /** z-index. @default 9998 (just below the default FAB at 9999). */
-    zIndex?: number;
-    /** Override classes on the bubble. */
-    className?: string;
-    /** Override styles on the bubble. */
-    style?: CSSProperties;
-    /** Optional sender avatar / icon shown on the left. */
-    avatar?: ReactNode;
-    /** Optional sender label rendered above the text. */
-    senderName?: string;
-    /** ARIA label for the dismiss button. @default 'Dismiss' */
-    dismissLabel?: string;
-    /**
-     * Render in-place (no fixed positioning). Useful for stories and inline previews.
-     * @default false
-     */
-    inline?: boolean;
-}
-/**
- * Greeting bubble shown next to a `ChatFAB` to invite the user to start a
- * conversation (LiveChat / Intercom-style proactive prompt).
- *
- * Renders fixed-position, anchored to the same corner as the FAB. Owns its
- * own delayed-mount + presence animation. Hide on chat open and/or after
- * user dismissal.
- *
- * @example
- * ```tsx
- * const [open, setOpen] = useState(false);
- * const [dismissed, setDismissed] = useState(false);
- *
- * <ChatLauncher
- *   open={open}
- *   onOpenChange={setOpen}
- *   fab={{ variant: 'animated' }}
- *   dock={{ title: 'Support' }}
- * >
- *   <SupportChat />
- * </ChatLauncher>
- *
- * <ChatGreeting
- *   open={!open && !dismissed}
- *   onClick={() => setOpen(true)}
- *   onDismiss={() => setDismissed(true)}
- *   senderName="Anna from Support"
- *   delayMs={2000}
- * >
- *   Hi! 👋 Got a question? I'm here to help.
- * </ChatGreeting>
- * ```
- */
-declare function ChatGreeting({ open, children, onClick, onDismiss, position, fabOffset, fabClearance, delayMs, zIndex, className, style, avatar, senderName, dismissLabel, inline, }: ChatGreetingProps): react_jsx_runtime.JSX.Element;
-
-interface ChatUnreadPreviewProps {
-    /** Controlled — usually `!dockOpen && !!message`. */
-    open: boolean;
-    /** Inbound message to preview. `null` hides the bubble. */
-    message: ChatMessage | null;
-    /** Tap → open chat + mark read. */
-    onClick?: () => void;
-    /** × → mark read without opening. */
-    onDismiss?: () => void;
-    /** Anchor corner — match the FAB so the bubble sits above it. @default 'bottom-right' */
-    position?: ChatFABPosition;
-    /** Horizontal offset from screen edge, matches the FAB. @default 24 */
-    fabOffset?: number;
-    /** Vertical clearance above/below the FAB. @default 96 */
-    fabClearance?: number;
-    /** Lines of body text before ellipsis. @default 2 */
-    truncate?: number;
-    /** z-index. @default 9998 */
-    zIndex?: number;
-    /** Render in-place (stories / previews). @default false */
-    inline?: boolean;
-    /** Override classes on the bubble. */
-    className?: string;
-    /** Override styles on the bubble. */
-    style?: CSSProperties;
-    /** ARIA label for the dismiss button. @default 'Mark as read' */
-    dismissLabel?: string;
-    /** Override the avatar — defaults to derived from `message.sender`. */
-    avatar?: ReactNode;
-    /** Override the sender label — defaults to `message.sender?.name`. */
-    senderName?: string;
-}
-/**
- * Push-notification bubble next to the chat FAB.
- *
- * Shows the last inbound message while the chat is closed —
- * Intercom / LiveChat-style. Tap → open chat (host wires `onClick`).
- * Dismiss × → keep chat closed but stop nagging.
- *
- * Pair with `useChatUnread()` (inside `<ChatProvider>`) for state.
- */
-declare function ChatUnreadPreview({ open, message, onClick, onDismiss, position, fabOffset, fabClearance, truncate, zIndex, inline, className, style, dismissLabel, avatar, senderName, }: ChatUnreadPreviewProps): react_jsx_runtime.JSX.Element;
-
-interface ChatLauncherHotkey {
-    /** Key (case-sensitive single char or named like 'Escape'). */
-    key: string;
-    /** Require Cmd (mac) or Ctrl (other). */
-    meta?: boolean;
-    /** Require Shift. */
-    shift?: boolean;
-    /** Require Alt. */
-    alt?: boolean;
-}
-interface ChatLauncherGreeting extends Omit<ChatGreetingProps, 'open' | 'onClick' | 'onDismiss' | 'position' | 'fabOffset' | 'children'> {
-    /** Greeting body — string for the default style, or any ReactNode. */
-    content: ReactNode;
-    /** Persistence key for "user dismissed this greeting" in `localStorage`. Pass `null` to disable persistence. @default null */
-    dismissStorageKey?: string | null;
-    /** Hide the greeting once the user opens the chat. @default true */
-    hideOnOpen?: boolean;
-}
-interface ChatLauncherProps {
-    /** Dock contents — typically a `<Chat>` instance. */
-    children: ReactNode;
-    /** FAB customization (icon, position, label, pulse, badge, tooltip, variant, size). */
-    fab?: Omit<ChatFABProps, 'onClick'>;
-    /** Dock customization (size, title, position, transition, mobileFullscreen). */
-    dock?: Omit<ChatDockProps, 'open' | 'onClose' | 'children'>;
-    /**
-     * Proactive greeting bubble shown next to the FAB before the user opens the chat.
-     * Set to a string or full config object. Omit to disable.
-     */
-    greeting?: string | ChatLauncherGreeting;
-    /** Open/close via a keyboard shortcut. */
-    hotkey?: ChatLauncherHotkey;
-    /** Initial open state for uncontrolled mode. @default false */
-    defaultOpen?: boolean;
-    /** Controlled open state (pair with `onOpenChange`). */
-    open?: boolean;
-    /** Controlled open state setter. */
-    onOpenChange?: (open: boolean) => void;
-    /**
-     * Focus the composer textarea when the dock opens. Saves a click for
-     * every "FAB → start typing" interaction. @default true
-     */
-    autoFocusComposerOnOpen?: boolean;
-    /**
-     * Close the dock on `Escape`. Mirrors standard popover / drawer UX.
-     * Set to `false` to disable (e.g. if you want Escape to do something
-     * else inside the chat). @default true
-     */
-    closeOnEscape?: boolean;
-    /**
-     * Last inbound message (admin reply / system notice / agent push) the
-     * user hasn't seen yet. Drives the `<ChatUnreadPreview>` bubble next
-     * to the FAB and (by default) the FAB badge.
-     *
-     * Source it from `useChatUnread()` inside your `<ChatProvider>`.
-     */
-    unreadMessage?: ChatMessage | null;
-    /**
-     * Called when the user opens the chat via FAB/preview/hotkey or
-     * dismisses the preview with ×. Wire to `useChatUnread().markRead`.
-     */
-    onMarkRead?: () => void;
-    /**
-     * Customize the unread bubble (`truncate`, `dismissLabel`, …).
-     * `open`/`message`/`onClick`/`onDismiss`/`position`/`fabOffset` are
-     * wired automatically.
-     */
-    unreadPreview?: Omit<ChatUnreadPreviewProps, 'open' | 'message' | 'onClick' | 'onDismiss' | 'position' | 'fabOffset'>;
-    /**
-     * Auto-inject a mute / unmute button into the header. Pass the
-     * `useChatAudio()` (or any compatible `{ muted, toggleMute }`)
-     * instance — the launcher renders `<ChatHeaderAudioToggle>` in the
-     * header's actions slot when audio is actually configured (not silent).
-     *
-     * Hosts that manage their own header can ignore this prop and render
-     * `<ChatHeaderAudioToggle>` directly.
-     */
-    audio?: {
-        muted: boolean;
-        toggleMute: () => void;
-        isSilent?: boolean;
-    } | null;
-    /**
-     * Suppress the auto-injected audio toggle even when `audio` is passed.
-     * @default false
-     */
-    hideAudioToggle?: boolean;
-}
-/**
- * Floating chat launcher = FAB + Dock + presence + optional greeting + hotkey.
- *
- * 99% of hosts use this directly. For non-FAB triggers (e.g. an inline
- * link in the page) compose `<ChatDock>` with your own button.
- */
-declare function ChatLauncher({ children, fab, dock, greeting, hotkey, defaultOpen, open: controlledOpen, onOpenChange, autoFocusComposerOnOpen, closeOnEscape, unreadMessage, onMarkRead, unreadPreview, audio, hideAudioToggle, }: ChatLauncherProps): react_jsx_runtime.JSX.Element;
-
-type ChatPresencePhase = 'hidden' | 'entering' | 'visible' | 'leaving';
-/**
- * Presence state machine for floating popovers.
- *
- * Drives a four-phase lifecycle so enter/leave CSS transitions actually fire:
- *
- *   hidden → entering (mount, transition class starts) → visible
- *   visible → leaving (transition runs) → hidden (unmount)
- *
- * Mounting in `entering` and ticking to `visible` on the next paint is what
- * lets transition classes animate. Without it the element appears already
- * at its final state and CSS transitions never observe a change.
- *
- * @param open - controlled open state
- * @param exitDurationMs - how long the leave transition runs; should match CSS
- */
-declare function useChatPresence(open: boolean, exitDurationMs?: number): ChatPresencePhase;
-
-/**
- * Chat defaults and constants.
- */
-declare const STORAGE_KEYS: {
-    readonly mode: "djc-chat-mode";
-    readonly sidebarWidth: "djc-chat-sidebar-width";
-    readonly composerHistory: "djc-chat-composer-history";
-};
-declare const CSS_VARS: {
-    readonly reserve: "--djc-chat-reserve";
-};
-declare const DEFAULT_Z_INDEX = 9000;
-declare const LIMITS: {
-    /** Max characters per single message. */
-    readonly messageMaxLength: 8000;
-    /** Max attachments per message. */
-    readonly attachmentsMax: 10;
-    /** Composer history slots. */
-    readonly composerHistorySize: 50;
-    /** Coalesce stream tokens within this window before dispatching. */
-    readonly streamCoalesceMs: 16;
-    /** Default history page size. */
-    readonly pageSize: 50;
-    /** Virtualize list when >= this many messages (host-controlled threshold). */
-    readonly virtualizeThreshold: 50;
-    /** SSE idle timeout. */
-    readonly sseIdleMs: 45000;
-};
-declare const DEFAULT_SIDEBAR: {
-    readonly width: 420;
-    readonly min: 320;
-    readonly max: 720;
-};
-declare const HOTKEYS: {
-    readonly send: "mod+enter";
-    readonly cancel: "esc";
-    readonly newChat: "mod+shift+n";
-    readonly toggleOpen: "mod+/";
-    readonly focusComposer: "mod+l";
-};
-declare const CHAT_EVENT_NAME = "djc:chat:send";
-interface ChatEventDetail {
-    content: string;
-    sessionId?: string;
-    attachments?: unknown[];
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * ID generation. Uses crypto.randomUUID when available with a fallback
- * for older environments (and SSR bundles that may not have crypto).
- */
-declare function createId(prefix?: string): string;
-
-/**
- * Token coalescer. Buffers stream tokens within a small time window before
- * dispatching a single aggregated chunk. Prevents 60+ re-renders per second
- * on fast streams.
- */
-interface TokenBuffer {
-    /** Append a delta. Returns immediately. */
-    push(delta: string): void;
-    /** Force flush and resolve any pending timer. */
-    flush(): void;
-    /** Stop accepting tokens; flush whatever is buffered. */
-    close(): void;
-}
-declare function createTokenBuffer(onFlush: (delta: string) => void, windowMs?: 16): TokenBuffer;
-
-declare function resolvePersona(message: Pick<ChatMessage, 'role' | 'sender'>, user?: ChatUserContext, assistant?: ChatAssistantContext): ChatPersona;
-/** Compute initials for an avatar fallback. */
-declare function deriveInitials(persona: ChatPersona, role?: string): string;
-
-/**
- * HTTP + SSE transport. Default implementation for web hosts.
- *
- * Backend contract (see @dev/@refactoring7-chat/06-integration.md):
- *   POST   /sessions                     → SessionInfo (JSON)
- *   GET    /sessions/:id/history?cursor= → HistoryPage (JSON)
- *   POST   /sessions/:id/messages        → SSE stream of ChatStreamEvent
- *   POST   /sessions/:id/messages/buffered → ChatMessage (JSON, fallback)
- *   DELETE /sessions/:id                 → 204
- */
-
-interface HttpTransportConfig {
-    /** Base URL without trailing slash, e.g. '/api/chat' or 'https://api.example.com/v1/chat'. */
-    baseUrl: string;
-    /** Optional slug appended/forwarded as project identifier. */
-    slug?: string;
-    /** Returns headers applied to every request — e.g. Authorization. */
-    getAuthHeader?: () => Record<string, string> | Promise<Record<string, string>>;
-    /** Default fetch timeout (per non-streaming request). */
-    timeoutMs?: number;
-    /** Override fetch implementation (useful for tests or custom retry layers). */
-    fetchImpl?: typeof fetch;
-}
-declare function createHttpTransport(config: HttpTransportConfig): ChatTransport;
-
-/**
- * In-memory chat transport for stories and tests. Replays scripted replies.
- */
-
-interface MockTransportOptions {
-    /** Each entry is the assistant's reply for one user turn. Strings are split
-     *  into chunks; arrays are taken as the exact event sequence (after a
-     *  prepended `message_start` and before a synthetic `message_end`). */
-    replies?: Array<string | ChatStreamEvent[]>;
-    latencyMs?: number;
-    /** Initial history returned by `createSession`. */
-    initialMessages?: ChatMessage[];
-    shouldFail?: (attempt: number) => boolean;
-}
-declare function createMockTransport(opts?: MockTransportOptions): ChatTransport;
-
-/**
- * Server-Sent Events parser as an AsyncGenerator.
- *
- * Yields parsed events from a `Response` body. Handles the split-read case
- * where `event:` and `data:` arrive in separate TCP packets. Skips malformed
- * JSON gracefully. Honors AbortSignal (caller passes one to fetch).
- */
-
-interface RawEvent {
-    event?: string;
-    data?: string;
-}
-interface ParseSSEOptions {
-    signal?: AbortSignal;
-    /** Map a raw SSE event to zero, one, or many `ChatStreamEvent`s.
-     *  Default: parse `data` as JSON and assume the JSON shape already
-     *  matches `ChatStreamEvent`. */
-    map?: (raw: RawEvent) => ChatStreamEvent | ChatStreamEvent[] | null;
-    idleTimeoutMs?: number;
-}
-declare function parseSSE(response: Response, options?: ParseSSEOptions): AsyncGenerator<ChatStreamEvent, void, void>;
-
-/**
- * Transport surface re-export. Lives in core so transport implementations
- * never need to reach into the public types module.
- */
-
-declare class TransportError extends Error {
-    code: string;
-    constructor(message: string, code?: string);
-}
-
-/**
- * Pydantic-AI SSE event mapper.
- *
- * Translates the event shape emitted by pydantic-AI–style Django backends
- * (text_delta / tool_call / tool_result / done / error / approval_required)
- * into the canonical `ChatStreamEvent` stream consumed by the Chat reducer.
- *
- * Backends that don't expose a stable `tool_call_id` are supported via a
- * per-stream FIFO queue keyed by tool name. The earlier "Map<name, toolId>"
- * approach lost the first toolId when a tool was invoked twice in one turn
- * (e.g. `list_tasks` for search and again for confirmation) — using a queue
- * keeps each call/result pair correctly matched.
- */
-
-interface PydanticAIEvent {
-    type: 'text_delta' | 'tool_call' | 'tool_result' | 'done' | 'error' | 'approval_required';
-    delta?: string;
-    tool?: string;
-    args?: unknown;
-    result?: unknown;
-    /**
-     * Structured frontend payload — present on `tool_result` when the tool has
-     * a `result_schema`. The LLM sees only `result` (compact text); the
-     * frontend uses `data` to render rich UI (e.g. vehicle cards).
-     */
-    data?: unknown;
-    total_tokens?: number;
-    error?: string;
-    tool_call_id?: string;
-    session_id?: string;
-}
-/** Per-stream FIFO queue keyed by tool name. Created via `createToolIdQueue`. */
-interface ToolIdQueue {
-    /** Allocate a new toolId for a `tool_call` event and enqueue it under `name`. */
-    push(name: string): string;
-    /** Pop the oldest toolId for `name` (or return an orphan marker if none). */
-    shift(name: string): string;
-    /** Reset all queues (e.g. on stream close). */
-    clear(): void;
-}
-declare function createToolIdQueue(): ToolIdQueue;
-/**
- * Translate a single pydantic-AI event into zero or more `ChatStreamEvent`s.
- * Pass a `ToolIdQueue` shared across the lifetime of one stream so that
- * `tool_call` / `tool_result` pairs match correctly.
- */
-declare function mapPydanticAIEvent(ev: PydanticAIEvent, toolIds: ToolIdQueue): Generator<ChatStreamEvent>;
-/**
- * Convenience factory: returns a `ParseSSEOptions['map']` callback that
- * decodes raw SSE frames as `PydanticAIEvent` JSON and yields zero or
- * more `ChatStreamEvent`s through `mapPydanticAIEvent`.
- *
- * Allocates an internal `ToolIdQueue` — call this once per stream.
- */
-declare function createPydanticAISSEMap(): NonNullable<ParseSSEOptions['map']>;
-
-/**
- * High-level transport factory for pydantic-AI–style backends.
- *
- * Composes:
- *   - `parseSSE` for spec-compliant SSE framing (multi-line `data:`, comments, idle timeout).
- *   - `createPydanticAISSEMap` for normalizing pydantic-AI events into `ChatStreamEvent`.
- *
- * Use when your backend speaks the canonical pydantic-AI stream shape
- * (`text_delta` / `tool_call` / `tool_result` / `done` / `error`).
- * URL building, auth headers, history loading, and optional session
- * bootstrapping are caller responsibilities — pass them in.
- */
-
-interface PydanticAIChatTransportOpts {
-    /**
-     * Build the SSE stream URL for a user message turn.
-     * @example (sessionId, message) => `${base}/stream?session_id=${sessionId}&message=${encodeURIComponent(message)}`
-     */
-    buildStreamUrl: (sessionId: string, message: string) => string | URL;
-    /** Optional history loader. If omitted, `loadHistory` returns an empty page. */
-    loadHistory?: (sessionId: string, cursor?: string | null) => Promise<HistoryPage>;
-    /**
-     * Optional session bootstrap. Called from `createSession`. Useful for
-     * backends that need a `POST /sessions` round-trip or want to pre-seed
-     * history.
-     */
-    bootstrapSession?: (opts?: CreateSessionOptions) => Promise<SessionInfo>;
-    /** Optional session teardown. */
-    closeSession?: (sessionId: string) => Promise<void>;
-    /**
-     * Optional non-streaming send (for hosts that need a buffered fallback,
-     * e.g. when the user disables streaming). Defaults to throwing — most
-     * hosts only use streaming.
-     */
-    send?: (sessionId: string, content: string, options?: SendOptions) => Promise<ChatMessage>;
-    /** Request headers (Authorization, content-type, etc.). */
-    buildHeaders?: () => HeadersInit | Promise<HeadersInit>;
-    /** Override fetch (tests, retry layers). */
-    fetchImpl?: typeof fetch;
-    /**
-     * HTTP method for the stream request. Defaults to `'POST'` with
-     * `{ content, attachments, metadata }` JSON body. Set to `'GET'` if
-     * your backend embeds the message in the URL via `buildStreamUrl`.
-     */
-    streamMethod?: 'GET' | 'POST';
-    /** Idle timeout for the SSE connection, in ms. Forwarded to `parseSSE`. */
-    idleTimeoutMs?: number;
-    /**
-     * Side-channel for events that don't translate to `ChatStreamEvent`
-     * (e.g. `approval_required` — surfaces interactive prompts outside the
-     * normal message stream). Called synchronously while parsing the SSE
-     * frame; mutate caller-owned state, don't `await` long work here.
-     */
-    onPydanticEvent?: (event: PydanticAIEvent) => void;
-}
-declare function createPydanticAIChatTransport(opts: PydanticAIChatTransportOpts): ChatTransport;
-
-/**
- * @deprecated Plan64. As of ui-tools 2.1.369, `<MessageList>` is
- * virtualized via react-virtuoso and owns its own scroll viewport.
- * Sticky-bottom + auto-follow on streaming live inside the component;
- * use the new `MessageListProps.onAtBottomChange` prop and the
- * `MessageListHandle.scrollToBottom()` imperative method instead.
- *
- * This hook is kept for hosts that render messages outside
- * `<MessageList>` (e.g. headless story shells, custom non-virtualized
- * scroll containers). It still works against any HTMLElement scroll
- * container, but it does NOT integrate with Virtuoso — passing a
- * Virtuoso-managed element here will read garbage scroll metrics.
- */
-interface UseChatScrollOptions {
-    containerRef: RefObject<HTMLElement | null>;
-    bottomRef: RefObject<HTMLElement | null>;
-    isStreaming?: boolean;
-    /** Distance from bottom (px) considered "at bottom". */
-    bottomThresholdPx?: number;
-    /** Bump key — increment when a new message arrives so the hook re-evaluates auto-scroll. */
-    messagesCount?: number;
-}
-interface UseChatScrollReturn {
-    isAtBottom: boolean;
-    unreadCount: number;
-    scrollToBottom: (smooth?: boolean) => void;
-    resetUnread: () => void;
-}
-declare function useChatScroll(options: UseChatScrollOptions): UseChatScrollReturn;
-
-interface UseChatHistoryOptions {
-    enabled?: boolean;
-    containerRef: RefObject<HTMLElement | null>;
-    topSentinelRef: RefObject<HTMLElement | null>;
-    hasMore: boolean;
-    isLoadingMore: boolean;
-    loadMore: () => Promise<void>;
-}
-/** Triggers `loadMore` when the top sentinel enters the container's viewport.
- *  Preserves scroll anchor: if the container's height grows after load, we
- *  bump scrollTop by the delta so the previously-visible message stays put. */
-declare function useChatHistory(options: UseChatHistoryOptions): void;
-
-/**
- * Chat-specific audio facade. Thin wrapper over `useNotificationSounds`
- * from `@djangocfg/ui-core` — keeps the `ChatAudioEvent` typing while
- * the underlying bus / prefs / Safari-unlock logic lives in ui-core.
- */
-declare function useChatAudio(config?: ChatAudioConfig): UseChatAudioReturn;
-
-interface ChatLightboxState {
-    gallery: ChatAttachment[];
-    index: number;
-}
-interface UseChatLightboxReturn {
-    state: ChatLightboxState | null;
-    open: (att: ChatAttachment, gallery?: ChatAttachment[]) => void;
-    close: () => void;
-}
-/** Tiny state container for an image lightbox. The host owns the modal +
- *  `<LazyImageViewer>` mount; we just track which gallery to show. */
-declare function useChatLightbox(): UseChatLightboxReturn;
-
-/** Anything with a `.focus()` method — covers HTMLElement, the
- *  composer's textareaRef from `useChatComposer`, and any custom
- *  imperative handle exposing the same shape. */
-interface Focusable {
-    focus: () => void;
-}
-interface UseAutoFocusOnStreamEndOptions {
-    /** True while an assistant reply is streaming. The hook fires the
-     *  focus() call on the true → false transition.
-     *
-     *  When omitted, the hook reads `isStreaming` from `useChatContext`.
-     *  Pass it explicitly only if you're driving stream state from your
-     *  own store (cmdop's Wails event bus, for example). */
-    isStreaming?: boolean;
-    /** Ref / handle to focus when the reply lands.
-     *
-     *  When omitted, the hook uses the composer handle registered in
-     *  the chat context — the built-in `<Composer>` registers itself
-     *  automatically, custom composers can opt in via
-     *  `useRegisterComposer`. Pass `targetRef` only when you need to
-     *  focus something other than the composer (e.g. an "approve"
-     *  button, a quick-reply chip). */
-    targetRef?: RefObject<Focusable | HTMLElement | null>;
-    /** Opt-out. Default true. Pass false to disable without unmounting
-     *  the hook (e.g. user preference). */
-    enabled?: boolean;
-    /** Delay the focus call by this many ms. Default 0 = next animation
-     *  frame, which lets the streaming bubble's final commit settle
-     *  before focus pulls scroll. Bump to 50-150ms for layouts that
-     *  re-mount the composer after the final chunk. */
-    delayMs?: number;
-}
-/**
- * Refocus the chat composer the moment the assistant reply finishes
- * streaming. Standard chat UX: the user types → sends → reads the
- * reply → starts typing again without reaching for the mouse.
- *
- * Default (zero-config) usage — works the moment a `<Composer>` is
- * mounted inside a `<ChatProvider>`:
- *
- *   useAutoFocusOnStreamEnd();
- *
- * Custom composer / advanced wiring:
- *
- *   const ref = useRef<{ focus: () => void } | null>(null);
- *   useAutoFocusOnStreamEnd({ targetRef: ref });
- *
- * Driving stream state yourself:
- *
- *   useAutoFocusOnStreamEnd({ isStreaming: myExternalStreaming });
- *
- * Only the true → false transition fires focus — toggling `enabled`
- * mid-stream won't steal focus while the user is reading.
- */
-declare function useAutoFocusOnStreamEnd(options?: UseAutoFocusOnStreamEndOptions): void;
-/**
- * Helper for custom composers (anything that's NOT the built-in
- * `<Composer>`) to register their focus() with the chat context so
- * `useAutoFocusOnStreamEnd()` and other consumers work without
- * prop-drilling.
- *
- * Usage inside your custom composer:
- *
- *   const focus = useCallback(() => {
- *     myEditorRef.current?.commands.focus();
- *   }, []);
- *   useRegisterComposer(focus);
- *
- * No-op when called outside a `<ChatProvider>`.
- */
-declare function useRegisterComposer(handle: ComposerHandle): void;
-
-interface UseChatResetOptions {
-    /**
-     * Backend call that performs the actual reset (e.g. POST /chat/reset).
-     * Should resolve to `true` on success, `false` on failure.
-     * Throwing also counts as failure — caught and logged.
-     */
-    onReset: () => Promise<boolean>;
-    /**
-     * Called after a successful reset (status === true). Use to clear the
-     * local message list, navigate, or fire analytics.
-     */
-    onSuccess?: () => void;
-    /**
-     * Called when reset fails (returned `false` or threw). Defaults to no-op
-     * — wire to a toast/banner if you want to surface it.
-     */
-    onError?: (error?: unknown) => void;
-}
-interface UseChatResetReturn {
-    /** Trigger the reset. Safe to call multiple times — re-entrant guard. */
-    reset: () => Promise<boolean>;
-    /** True while the reset is in flight. */
-    isResetting: boolean;
-}
-/**
- * Generic "clear chat context" hook.
- *
- * Stays generic — the backend call lives in the host (it knows the URL,
- * auth, project slug). Provides the in-flight state and success/error
- * callbacks every consumer wires up the same way.
- *
- * @example
- * ```tsx
- * const { reset, isResetting } = useChatReset({
- *   onReset: async () => {
- *     const res = await fetch('/api/chat/reset', { method: 'POST', credentials: 'include' });
- *     return res.ok;
- *   },
- *   onSuccess: () => chat.clearMessages(),
- * });
- * ```
- */
-declare function useChatReset(opts: UseChatResetOptions): UseChatResetReturn;
-
-interface UseVisitorFingerprintOptions {
-    /** localStorage key. @default 'chat.visitor.fingerprint' */
-    storageKey?: string;
-}
-/**
- * Persistent anonymous visitor id, kept in `localStorage`.
- *
- * Returns `null` on the first render (SSR-safe) and the stable id from
- * the second render onwards. Use as `fingerprint` for public chat
- * transports that need to dedupe sessions per visitor without auth.
- */
-declare function useVisitorFingerprint(opts?: UseVisitorFingerprintOptions): string | null;
-
-interface ChatDockPrefs {
-    /** Popover (FAB-style) or side-docked panel. */
-    mode: ChatDockMode;
-    /** Which edge the side dock attaches to. */
-    side: ChatDockSide;
-    /** Width in px when side-docked (resizable in the future). */
-    sideWidth: number;
-}
-declare const DEFAULT_DOCK_PREFS: ChatDockPrefs;
-interface UseChatDockPrefsOptions {
-    /** localStorage key. @default 'chat.dock.prefs' */
-    storageKey?: string;
-    /** Override the baseline defaults (per-product branding, etc.). */
-    defaults?: Partial<ChatDockPrefs>;
-}
-interface UseChatDockPrefsReturn extends ChatDockPrefs {
-    /** Merge-update — pass only the fields that changed. */
-    setPrefs: (patch: Partial<ChatDockPrefs>) => void;
-    /** Convenience toggle: popover ⇆ side. */
-    toggleMode: () => void;
-    /** Convenience toggle: right ⇆ left (only affects side mode). */
-    toggleSide: () => void;
-    /** Reset to defaults. */
-    reset: () => void;
-}
-/**
- * Persistent dock preferences (mode / side / width) via ui-core localStorage.
- *
- * SSR-safe: returns defaults on the server, hydrates on mount.
- * Survives reloads — power users keep their preferred chat layout.
- */
-declare function useChatDockPrefs(opts?: UseChatDockPrefsOptions): UseChatDockPrefsReturn;
-
-interface UseFocusOnEmptyClickOptions {
-    /**
-     * Custom focus target. Defaults to the composer registered in the chat
-     * context.
-     */
-    targetRef?: RefObject<Focusable | HTMLElement | null>;
-    /** Opt-out without unmounting the hook. @default true */
-    enabled?: boolean;
-    /**
-     * Don't focus if currently streaming (user is reading the reply).
-     * @default true
-     */
-    skipWhileStreaming?: boolean;
-}
-/**
- * "Click anywhere in the chat → focus the composer" — Slack / Linear /
- * ChatGPT behaviour.
- *
- * Returns a single `onMouseUp` handler to attach to the scrollable
- * messages container. Heuristics that mirror the popular chat apps:
- *
- *   1. Ignore clicks on interactive elements (`button`, `a`, `input`,
- *      `textarea`, `[role="button"]`, `[contenteditable]`, …) — they
- *      have their own behaviour.
- *   2. Ignore clicks that produced a text selection (drag-to-select).
- *      Stealing focus would break copy-paste flow.
- *   3. Ignore touch input — on mobile the system focuses the textarea
- *      via tap on the composer itself; touching messages should never
- *      open the keyboard.
- *   4. Optionally skip while the assistant is streaming so the user
- *      can keep reading without the keyboard popping up.
- *
- * @example
- * ```tsx
- * const onMouseUp = useFocusOnEmptyClick();
- * <div ref={scrollRef} onMouseUp={onMouseUp}>{messages}</div>
- * ```
- */
-declare function useFocusOnEmptyClick(options?: UseFocusOnEmptyClickOptions): (event: MouseEvent<HTMLElement>) => void;
-
-interface UseChatUnreadOptions {
-    /**
-     * When true, unread state is auto-cleared (treated as "user is reading
-     * the chat right now"). Pass your dock-open boolean here so the badge
-     * resets the moment the user opens the chat.
-     */
-    open?: boolean;
-    /**
-     * Which message roles count as "unread". Defaults to `['assistant']` —
-     * we only count inbound replies, not the user's own messages.
-     */
-    countRoles?: Array<ChatMessage['role']>;
-}
-interface UseChatUnreadReturn {
-    /** Most-recent inbound message since the last mark-as-read. */
-    unread: ChatMessage | null;
-    /** Total inbound messages since the last mark-as-read. */
-    count: number;
-    /** Manually clear the unread state. */
-    markRead: () => void;
-}
-/**
- * Track inbound chat messages while the user isn't watching.
- *
- * Must be called **inside** the chat's `<ChatProvider>` (i.e. inside the
- * `children` of `ChatLauncher`, alongside `ChatRoot`).
- *
- * @example
- * ```tsx
- * function ChatRootWithUnreadBadge({ open, onUnread }: { open: boolean; onUnread: (m: ChatMessage | null) => void }) {
- *   const { unread, count, markRead } = useChatUnread({ open });
- *   useEffect(() => onUnread(unread), [unread, onUnread]);
- *   // pass `count` to your FAB badge via the host's state
- *   return <ChatRoot transport={transport} />;
- * }
- * ```
- *
- * For end-to-end wiring with `<ChatLauncher unreadMessage onMarkRead>`,
- * see the `Launcher / WithLivePush` story.
- */
-declare function useChatUnread(opts?: UseChatUnreadOptions): UseChatUnreadReturn;
-
-declare const useChatAudioPrefs: zustand.UseBoundStore<zustand.StoreApi<AudioPrefsState<ChatAudioEvent>>>;
-
-/**
- * Built-in chat notification sounds.
- *
- * Sounds are inlined as base64 data URLs inside each `./sounds/<name>.ts`
- * module — no `.mp3` loader / `*.d.ts` shim required on the consumer
- * side. Total ≈ 136KB bundled into the lazy Chat chunk.
- *
- * To re-encode after a source edit:
- *   1. Drop the new mp3 next to this file (e.g. `./sounds/sent.source.mp3`).
- *   2. `base64 -i sent.source.mp3` and paste into `./sounds/sent.ts`.
- *   3. Delete the temporary source mp3 — only the `.ts` ships.
- *
- * Encoding cheat-sheet:
- *   ffmpeg -i in.mp3 -ac 2 -ar 44100 -b:a 128k \
- *     -af 'atrim=0:1.4,afade=t=out:st=1.22:d=0.18' out.mp3
- */
-
-/**
- * Default chat notification sounds. Pass to `useChatAudio` (or spread
- * into a custom map) so hosts don't have to ship assets themselves.
- *
- * @example
- * ```tsx
- * const audio = useChatAudio({ sounds: DEFAULT_CHAT_SOUNDS });
- *
- * // Override one event:
- * const audio = useChatAudio({
- *   sounds: { ...DEFAULT_CHAT_SOUNDS, mention: '/custom-mention.mp3' },
- * });
- * ```
- */
-declare const DEFAULT_CHAT_SOUNDS: ChatAudioSounds;
-
-interface ToolPayloadMatcher {
-    /** Cheap predicate. First match wins. */
-    match: (value: unknown, kind: ToolPayloadKind, call: ChatToolCall) => boolean;
-    render: (value: unknown, kind: ToolPayloadKind, call: ChatToolCall) => ReactNode;
-}
-type ToolPayloadFallback = (value: unknown, kind: ToolPayloadKind, call: ChatToolCall) => ReactNode;
-declare function dispatchToolPayload(matchers: ToolPayloadMatcher[], fallback: ToolPayloadFallback): ToolPayloadFallback;
-declare function isPlainObject(v: unknown): v is Record<string, unknown>;
-declare function isLatLng(v: unknown): v is {
-    lat: number;
-    lng: number;
-};
-declare function isGeoJSONFeatureCollection(v: unknown): v is {
-    type: 'FeatureCollection';
-    features: unknown[];
-};
-declare function isStringValue(v: unknown): v is string;
-
-/**
- * Chat dev logger.
- *
- * A thin namespaced wrapper over `consola` that no-ops in production unless
- * the host app explicitly opts in via `<ChatRoot debug />`. The default
- * detection uses `isDev` from `@djangocfg/ui-core/lib/env` (NODE_ENV).
- *
- * Why a dedicated module: chat is async and event-heavy (bootstrap, transport,
- * SSE chunks, tool calls, regenerate, …). Inline `console.log`s rot fast and
- * leak into prod. A single `getChatLogger()` call gives every layer the same
- * namespaced sub-logger and keeps zero-cost gating in one place.
- *
- * Sub-loggers:
- *   bootstrap  — initial session bootstrap (createSession / loadHistory)
- *   transport  — outbound transport calls + responses
- *   stream     — SSE chunk / tool / message_end events
- *   lifecycle  — sendMessage, regenerate, newSession, edits
- *   tools      — tool_call_start / _delta / _end specifics
- *   error      — caught errors (always emitted as `error` level)
- */
-
-type ChatLogScope = 'bootstrap' | 'transport' | 'stream' | 'lifecycle' | 'tools' | 'error';
-interface ChatLogger {
-    bootstrap: ConsolaInstance;
-    transport: ConsolaInstance;
-    stream: ConsolaInstance;
-    lifecycle: ConsolaInstance;
-    tools: ConsolaInstance;
-    error: ConsolaInstance;
-    /** True when this logger is actually emitting (host opted in or NODE_ENV=development). */
-    enabled: boolean;
-}
-/**
- * Get the chat logger.
- * @param debug Explicit override from the host. `undefined` falls back to `isDev`.
- */
-declare function getChatLogger(debug?: boolean): ChatLogger;
-
-/**
- * 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;
-
-/** Walk the conversation and collect image attachments in chronological order. */
-declare function collectImageAttachments(messages: ChatMessage[]): ChatAttachment[];
-
-/**
- * Chat color tokens — single source of truth.
- *
- * Every role-conditional class for chat surfaces lives here.
- * Components consume via `useChatBubbleStyles` / `useChatRoleStyles`,
- * never via raw Tailwind literals.
- *
- * Why centralize:
- *   1. One file to edit when the design system changes (e.g. light-theme
- *      contrast tweaks, palette swap).
- *   2. Eliminates the "first-token-on-bg-primary-was-text-white" class
- *      of bugs where each call site picks its own foreground.
- *   3. Lets us snapshot-test color decisions later.
- */
-/** Bubble surface classes (background + text), keyed by message state. */
-declare const BUBBLE_SURFACE: {
-    /** User-authored bubble — solid brand color. */
-    readonly user: "bg-primary text-primary-foreground rounded-tr-md";
-    /** Assistant bubble in normal state — neutral muted surface. */
-    readonly assistant: "bg-muted text-foreground rounded-tl-md";
-    /** Assistant bubble when the turn failed — destructive tint. */
-    readonly error: "bg-destructive/10 text-destructive rounded-tl-md border border-destructive/30";
-};
-/**
- * Anchor (link) classes for markdown content rendered inside a bubble.
- *
- * On `bg-primary` the link MUST stay legible against the cyan/brand fill —
- * `text-primary-foreground` matches the bubble's foreground token, so
- * contrast tracks the design system automatically.
- *
- * On the neutral assistant bubble we keep the brand-primary color so links
- * still pop without competing with the body text.
- */
-declare const ANCHOR: {
-    readonly user: string;
-    readonly assistant: "text-primary underline hover:text-primary/80 transition-colors break-all";
-};
-/** Inline secondary action (e.g. "Show more / less"). Same logic as anchors. */
-declare const TOGGLE: {
-    readonly user: "text-primary-foreground/80 hover:text-primary-foreground";
-    readonly assistant: "text-primary hover:text-primary/80";
-};
-/** Destructive surface — used by ErrorBanner and the delete action. */
-declare const DESTRUCTIVE_SURFACE: {
-    /** Banner / card variant: border + tint + text. */
-    readonly banner: "border border-destructive/40 bg-destructive/10 text-destructive";
-    /** Subtle hover for destructive buttons inside the banner / menu. */
-    readonly hover: "hover:bg-destructive/15";
-    /** Strong-hover variant (e.g. trash overlay on attachments). */
-    readonly hoverStrong: "hover:bg-destructive hover:text-destructive-foreground";
-    /** Inline destructive text utility. */
-    readonly text: "text-destructive";
-    /** Hover style for menu items that delete data. */
-    readonly menuItem: "text-destructive focus:text-destructive hover:bg-destructive/15 hover:text-destructive";
-};
-/** Tool-call result text. */
-declare const TOOL_CALL: {
-    readonly errorText: "text-destructive";
-};
-type ChatBubbleSurface = keyof typeof BUBBLE_SURFACE;
-
-/**
- * Role-aware style hooks for chat surfaces.
- *
- * Pure utility hooks — no React state, no side effects, just memoized
- * className strings derived from `bubbleTokens`. They exist so:
- *   - components don't import token constants directly (single facade)
- *   - "the user-bubble link color" can be changed in one file
- *   - tests can mock the hook to assert intent without parsing classNames
- */
-interface ChatBubbleStyles {
-    /** className for the bubble container (background + text + border). */
-    surface: string;
-    /** className for an inline anchor inside markdown. */
-    anchor: string;
-    /** className for a secondary inline action (e.g. show more). */
-    toggle: string;
-}
-/**
- * Resolve bubble + content styles for a single message.
- *
- * @param role        'user' | 'assistant' | 'system' (system defaults to assistant styling)
- * @param isError     marks the bubble as a failed turn (overrides surface)
- *
- * @example
- * ```tsx
- * const { surface, anchor } = useChatBubbleStyles(message.role, !!message.isError);
- * <div className={cn('rounded-2xl px-3.5 py-2', surface)}>…</div>
- * ```
- */
-declare function useChatBubbleStyles(role: 'user' | 'assistant' | 'system', isError: boolean): ChatBubbleStyles;
-interface ChatRoleStyles {
-    anchor: string;
-    toggle: string;
-}
-/**
- * Lightweight variant when only role matters (no error state, no surface).
- * Use in shared markdown renderers that don't know about bubble background.
- */
-declare function useChatRoleStyles(isUser: boolean): ChatRoleStyles;
-interface ChatDestructiveStyles {
-    banner: string;
-    hover: string;
-    hoverStrong: string;
-    text: string;
-    menuItem: string;
-    toolErrorText: string;
-}
-/**
- * Destructive (delete / error) class facade. Hook form keeps the API
- * symmetric with the others; under the hood it returns a frozen object.
- */
-declare function useChatDestructiveStyles(): ChatDestructiveStyles;
-
-interface MessageListProps {
-    messages?: ChatMessage[];
-    renderItem?: (m: ChatMessage, i: number) => ReactNode;
-    renderEmpty?: () => ReactNode;
-    isLoadingMore?: boolean;
-    /**
-     * Fires when the user scrolls within `topThresholdPx` of the top of
-     * the list — wire to your `loadMore()` here. Replaces the previous
-     * `topSentinelRef` API. The callback is gated by Virtuoso, so it
-     * won't fire repeatedly while a load is in flight (Virtuoso pauses
-     * `startReached` until `data` length grows).
-     */
-    onStartReached?: () => void;
-    /**
-     * @deprecated Kept as a no-op for backwards compatibility — wire
-     * `onStartReached` instead. Virtuoso owns the scroll viewport now,
-     * external sentinels never see scroll events.
-     */
-    topSentinelRef?: RefObject<HTMLDivElement | null>;
-    /**
-     * @deprecated Kept as a no-op for backwards compatibility — Virtuoso
-     * exposes `scrollToIndex` via the imperative handle instead. See
-     * `useChatScroll` for the chat-friendly wrapper.
-     */
-    bottomRef?: RefObject<HTMLDivElement | null>;
-    className?: string;
-    itemClassName?: string;
-    /**
-     * Skip virtualization and render through plain `.map()`. Use for
-     * stories / debugging where DevTools needs to see every node, or
-     * when `messages` is guaranteed-tiny. Default: `false` — virtualize
-     * always. Plan64.
-     */
-    noVirtualize?: boolean;
-    /**
-     * @deprecated No-op as of 2.1.373. We intentionally let Virtuoso run
-     * its first-item probe pass: cmdop bubbles vary from 40px (one-line
-     * user message) to 800px (markdown with code blocks), so any single
-     * estimate fed here forces a measure/reshape loop on every render.
-     * The kept prop avoids a breaking-change bump for hosts that still
-     * pass it explicitly.
-     */
-    defaultItemHeight?: number;
-    /**
-     * Fires when the viewport sticky state changes — `true` when the
-     * user is pinned to the bottom (streaming token deltas keep them
-     * there), `false` once they scroll up. Wire to your "Jump to
-     * latest" affordance via the inverse: render the pill when
-     * `!isAtBottom`. Plan64.
-     */
-    onAtBottomChange?: (isAtBottom: boolean) => void;
-    /**
-     * Pixel distance from the bottom that still counts as "at bottom".
-     * Default 120 — generous enough that mid-message users keep getting
-     * sticky-followed (matches ChatGPT / Slack feel) while still letting
-     * a deliberate scroll-up break the lock. Plan11.
-     */
-    atBottomThreshold?: number;
-    /**
-     * Force-scroll to the bottom when this id changes. Wire to the id of
-     * the most-recently-sent user message: every send re-anchors the
-     * viewport so users always see their own bubble + the incoming
-     * reply, even if they were scrolled up. Plan11.
-     */
-    scrollAnchorId?: string | number | null;
-}
-interface MessageListHandle {
-    scrollToBottom: (smooth?: boolean) => void;
-    scrollToIndex: (index: number, smooth?: boolean) => void;
-}
-declare const MessageList: react.ForwardRefExoticComponent<MessageListProps & react.RefAttributes<MessageListHandle>>;
-
-interface MessageBubbleProps {
-    message: ChatMessage;
-    isUser?: boolean;
-    showAvatar?: boolean;
-    /** Override avatar URL (skips persona resolution). */
-    avatarSrc?: string;
-    /** Override avatar fallback (skips persona resolution). */
-    avatarFallback?: ReactNode;
-    /** Personas — when provided, take precedence over context. */
-    user?: ChatUserContext;
-    assistant?: ChatAssistantContext;
-    showTimestamp?: boolean;
-    showActions?: boolean;
-    isCompact?: boolean;
-    className?: string;
-    beforeContent?: ReactNode;
-    afterContent?: ReactNode;
-    toolCallsRenderer?: (calls: ChatToolCall[]) => ReactNode;
-    /** Forwarded to the default `<ToolCalls>` when `toolCallsRenderer` is not set. */
-    toolCallsProps?: Omit<ToolCallsProps, 'calls'>;
-    sourcesRenderer?: (sources: ChatSource[]) => ReactNode;
-    attachmentsRenderer?: (atts: ChatAttachment[]) => ReactNode;
-    /** Per-type attachment renderers forwarded to default `<Attachments>`. */
-    attachmentRenderers?: AttachmentRendererMap;
-    /** Click handler for attachment tiles (e.g. open lightbox). */
-    onAttachmentOpen?: (a: ChatAttachment) => void;
-    onCopy?: () => void;
-    onRegenerate?: () => void;
-    onEdit?: () => void;
-    onDelete?: () => void;
-    /**
-     * Extra content rendered alongside the default copy/regenerate/edit/
-     * delete actions (after them, on the same row). Hosts pass app-
-     * specific affordances here — e.g. "Send to plan", "Add note",
-     * "Open in inspector" — without having to fork `<MessageActions>`.
-     * Receives the message so renderers can branch by id / role / etc.
-     * Plan64.
-     */
-    messageActionsExtra?: (m: ChatMessage) => ReactNode;
-    /**
-     * Override the default streaming indicator (the dots / pulse + tool
-     * activity label). Receives the message so the host can read
-     * `toolActivity`, the running tool call name, etc., and render a
-     * richer affordance ("Running cmd_execute on vps-audi…"). Plan64.
-     *
-     * Renders in two slots: as the in-bubble pre-token affordance, and
-     * as the inline label above the bubble when `toolActivity` is set.
-     * The render-prop is called for both — branch on `m.content` if
-     * you need different behaviour per slot.
-     */
-    streamingIndicator?: (m: ChatMessage) => ReactNode;
-}
-declare const MessageBubble: react.MemoExoticComponent<({ message, isUser: isUserProp, showAvatar, avatarSrc, avatarFallback, user, assistant, showTimestamp, showActions, isCompact, className, beforeContent, afterContent, toolCallsRenderer, toolCallsProps, sourcesRenderer, attachmentsRenderer, attachmentRenderers, onAttachmentOpen, onCopy, onRegenerate, onEdit, onDelete, messageActionsExtra, streamingIndicator, }: MessageBubbleProps) => react_jsx_runtime.JSX.Element>;
-
-interface MessageActionsProps {
-    role: ChatRole;
-    onCopy?: () => void;
-    onRegenerate?: () => void;
-    onEdit?: () => void;
-    onDelete?: () => void;
-    hideOn?: Array<ChatRole>;
-    className?: string;
-}
-/**
- * MessageActions — copy/regenerate/edit/delete buttons for a chat bubble.
- *
- * Memoised: re-renders only when `role`, `hideOn`, `className` or
- * any handler reference changes. Event handlers are compared by
- * reference — callers should stabilise them with useCallback.
- */
-declare function MessageActionsRaw({ role, onCopy, onRegenerate, onEdit, onDelete, hideOn, className, }: MessageActionsProps): react_jsx_runtime.JSX.Element;
-declare const MessageActions: react.MemoExoticComponent<typeof MessageActionsRaw>;
-
-interface SourcesProps {
-    sources: ChatSource[];
-    layout?: 'inline' | 'grid';
-    maxVisible?: number;
-    onClick?: (source: ChatSource) => void;
-    className?: string;
-}
-declare function Sources({ sources, layout, maxVisible, onClick, className }: SourcesProps): react_jsx_runtime.JSX.Element;
-
-interface EmptyStateProps {
-    greeting?: string;
-    description?: string;
-    suggestions?: Array<{
-        label: string;
-        prompt: string;
-    }>;
-    onPickSuggestion?: (prompt: string) => void;
-    className?: string;
-}
-declare function EmptyState({ greeting, description, suggestions, onPickSuggestion, className, }: EmptyStateProps): react_jsx_runtime.JSX.Element;
-
-interface ErrorBannerProps {
-    error: string | null;
-    onDismiss?: () => void;
-    onRetry?: () => void;
-    className?: string;
-}
-declare function ErrorBanner({ error, onDismiss, onRetry, className }: ErrorBannerProps): react_jsx_runtime.JSX.Element;
-
-interface JumpToLatestProps {
-    visible?: boolean;
-    unreadCount?: number;
-    onClick?: () => void;
-    className?: string;
-}
-declare function JumpToLatest({ visible, unreadCount, onClick, className }: JumpToLatestProps): react_jsx_runtime.JSX.Element;
-
-interface StreamingIndicatorProps {
-    variant?: 'dots' | 'pulse';
-    label?: string;
-    className?: string;
-}
-/**
- * StreamingIndicator — animated dots or pulse for streaming state.
- *
- * Memoised: re-renders only when `variant`, `label` or `className`
- * change. All props are primitives, so default shallow comparison is
- * sufficient.
- */
-declare function StreamingIndicatorRaw({ variant, label, className }: StreamingIndicatorProps): react_jsx_runtime.JSX.Element;
-declare const StreamingIndicator: react.MemoExoticComponent<typeof StreamingIndicatorRaw>;
-
-interface AudioToggleProps {
-    /** Visual size — matches Button sizes. Default: ``icon``. */
-    size?: 'sm' | 'icon';
-    /** Variant passed to the underlying Button. Default: ``ghost``. */
-    variant?: 'ghost' | 'outline' | 'secondary';
-    /** Force-show even when no audio config is wired (e.g. for stories). */
-    alwaysShow?: boolean;
-    className?: string;
-}
-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
- *
- * Lazy loads the heavy Prism library (~500KB) only when needed.
- * This significantly reduces the initial bundle size.
- */
-
-interface PrettyCodeProps {
-    data: string | object;
-    language: Language;
-    className?: string;
-    mode?: 'dark' | 'light';
-    inline?: boolean;
-    customBg?: string;
-    isCompact?: boolean;
-    /** Block scroll capture until user clicks (default: true) */
-    scrollIsolation?: boolean;
-    /**
-     * Line count above which the block starts scrolling instead of growing.
-     * ``undefined`` (default) = no cap, block grows to fit. Set e.g. ``50``
-     * to inline short snippets and cap long ones.
-     */
-    maxLines?: number;
-    /**
-     * Visual variant:
-     *   - ``"card"`` (default) — full chrome: border, background, hover
-     *     toolbar (Copy + language tag), optional internal scroll. Suits
-     *     a standalone code block in documentation prose where the block
-     *     is its own surface.
-     *   - ``"plain"`` — chrome-less: no border, no background, no toolbar,
-     *     no internal scroll. Grows to fit its content. Use when
-     *     embedding inside another scroll container (e.g. the Response
-     *     panel) — avoids double-scroll surfaces and lets the parent
-     *     manage copy/language affordances.
-     */
-    variant?: 'card' | 'plain';
-}
-declare const PrettyCode: react__default.FC<PrettyCodeProps>;
-
-/**
- * useLottie Hook
- *
- * Hook for loading and managing Lottie animation data
- */
-interface UseLottieOptions {
-    /**
-     * Animation data (JSON object) or URL to load from
-     */
-    src: string | object;
-    /**
-     * Enable caching of loaded animations
-     * @default true
-     */
-    cache?: boolean;
-}
-interface UseLottieReturn {
-    /**
-     * Loaded animation data
-     */
-    animationData: object | null;
-    /**
-     * Loading state
-     */
-    isLoading: boolean;
-    /**
-     * Error state
-     */
-    error: Error | null;
-    /**
-     * Retry loading the animation
-     */
-    retry: () => void;
-}
-/**
- * Hook for loading Lottie animations from URLs or objects
- *
- * Features:
- * - Loads animations from URLs or accepts animation objects directly
- * - Caching support to prevent re-fetching the same animation
- * - Error handling with retry capability
- * - Loading states
- *
- * Usage:
- * ```tsx
- * const { animationData, isLoading, error, retry } = useLottie({
- *   src: 'https://example.com/animation.json'
- * });
- *
- * if (isLoading) return <div>Loading...</div>;
- * if (error) return <div>Error: {error.message} <button onClick={retry}>Retry</button></div>;
- * if (!animationData) return null;
- *
- * return <LottiePlayer animationData={animationData} />;
- * ```
- */
-declare function useLottie(options: UseLottieOptions): UseLottieReturn;
-
-/**
- * LottiePlayer component wrapper with dynamic import
- *
- * This component automatically handles code splitting and lazy loading
- * of the Lottie player to optimize bundle size.
- *
- * Usage:
- * ```tsx
- * import { LottiePlayer } from '@djangocfg/ui-core/tools';
- *
- * <LottiePlayer
- *   src="https://example.com/animation.json"
- *   size="md"
- *   autoplay
- *   loop
- * />
- * ```
- */
-declare function LottiePlayer(props: LottiePlayerProps): react_jsx_runtime.JSX.Element;
-
-interface PlaygroundProps {
-    config: PlaygroundConfig;
-}
-declare const Playground: react__default.FC<PlaygroundProps>;
-
-/**
- * VideoPlayer - Unified Video Player Component
- *
- * Supports multiple modes:
- * - vidstack: Full-featured player (YouTube, Vimeo, HLS, DASH)
- * - native: Lightweight HTML5 player
- * - streaming: HTTP Range streaming with auth / Blob sources
- *
- * @example
- * // YouTube video
- * <VideoPlayer source={{ type: 'youtube', id: 'dQw4w9WgXcQ' }} />
- *
- * @example
- * // HLS stream
- * <VideoPlayer source={{ type: 'hls', url: 'https://example.com/video.m3u8' }} />
- *
- * @example
- * // HTTP Range streaming with auth (full source)
- * <VideoPlayer
- *   source={{
- *     type: 'stream',
- *     sessionId: 'abc123',
- *     path: '/videos/movie.mp4',
- *     getStreamUrl: (id, path) => `/api/stream/${id}?path=${path}&token=${token}`
- *   }}
- * />
- *
- * @example
- * // HTTP Range streaming (simplified, using VideoPlayerProvider context)
- * <VideoPlayerProvider sessionId={sessionId} getStreamUrl={getStreamUrl}>
- *   <VideoPlayer source={{ type: 'stream', path: '/videos/movie.mp4' }} />
- * </VideoPlayerProvider>
- *
- * @example
- * // Blob/ArrayBuffer
- * <VideoPlayer source={{ type: 'blob', data: arrayBuffer, mimeType: 'video/mp4' }} />
- */
-
-declare const VideoPlayer: react__default.ForwardRefExoticComponent<VideoPlayerProps & {
-    source: VideoSourceUnion | SimpleStreamSource;
-} & react__default.RefAttributes<VideoPlayerRef>>;
-
-interface VideoControlsProps {
-    player: react__default.RefObject<MediaPlayerInstance | null>;
-    className?: string;
-}
-declare function VideoControls({ player, className }: VideoControlsProps): react_jsx_runtime.JSX.Element;
-
-interface VideoErrorFallbackProps extends ErrorFallbackProps {
-    /** URL for download button (if provided, shows download button) */
-    downloadUrl?: string;
-    /** Filename for download */
-    downloadFilename?: string;
-    /** File size to display */
-    fileSize?: string;
-    /** Show retry button */
-    showRetry?: boolean;
-    /** Custom className */
-    className?: string;
-    /** Custom icon */
-    icon?: react__default.ReactNode;
-    /** Custom title (defaults to error message) */
-    title?: string;
-    /** Custom description */
-    description?: string;
-}
-/**
- * Pre-built error fallback component for VideoPlayer
- *
- * @example
- * // Basic usage
- * <VideoPlayer
- *   source={source}
- *   errorFallback={(props) => (
- *     <VideoErrorFallback
- *       {...props}
- *       downloadUrl={getDownloadUrl()}
- *       downloadFilename="video.mp4"
- *     />
- *   )}
- * />
- *
- * @example
- * // With file size
- * <VideoErrorFallback
- *   error="Failed to load video"
- *   downloadUrl="/api/download/video.mp4"
- *   fileSize="125 MB"
- *   showRetry
- *   retry={() => reloadVideo()}
- * />
- */
-declare function VideoErrorFallback({ error, retry, downloadUrl, downloadFilename, fileSize, showRetry, className, icon, title, description, }: VideoErrorFallbackProps): react_jsx_runtime.JSX.Element;
-interface CreateVideoErrorFallbackOptions {
-    /** Function to get download URL from source */
-    getDownloadUrl?: (source: unknown) => string | undefined;
-    /** Function to get filename from source */
-    getFilename?: (source: unknown) => string | undefined;
-    /** Function to get file size from source */
-    getFileSize?: (source: unknown) => string | undefined;
-    /** Show retry button */
-    showRetry?: boolean;
-}
-/**
- * Factory to create error fallback function for VideoPlayer
- *
- * @example
- * const errorFallback = createVideoErrorFallback({
- *   getDownloadUrl: (source) => source.downloadUrl,
- *   getFilename: (source) => source.filename,
- *   showRetry: true,
- * });
- *
- * <VideoPlayer source={source} errorFallback={errorFallback} />
- */
-declare function createVideoErrorFallback(options: CreateVideoErrorFallbackOptions): (props: ErrorFallbackProps, source?: unknown) => react__default.ReactNode;
-
-/**
- * VidstackProvider - Full-featured video player using Vidstack
- * Supports YouTube, Vimeo, HLS, DASH, and direct URLs
- */
-
-declare const VidstackProvider: react__default.ForwardRefExoticComponent<VidstackProviderProps & react__default.RefAttributes<VideoPlayerRef>>;
-
-/**
- * NativeProvider - Lightweight native HTML5 video player
- * For demo videos, background videos, autoplay loop muted scenarios
- */
-
-declare const NativeProvider: react__default.ForwardRefExoticComponent<NativeProviderProps & react__default.RefAttributes<VideoPlayerRef>>;
-
-/**
- * StreamProvider - HTTP Range streaming and Blob video player
- * Supports:
- * - HTTP Range requests with authorization (for large files)
- * - Blob/ArrayBuffer sources
- * - Data URL sources
- * - Fill parent container mode
- * - Custom error fallback
- */
-
-declare const StreamProvider: react__default.ForwardRefExoticComponent<StreamProviderProps & react__default.RefAttributes<VideoPlayerRef>>;
-
-/**
- * Provider for VideoPlayer streaming configuration
- *
- * @example
- * // In your app layout or FileWorkspace
- * <VideoPlayerProvider
- *   sessionId={sessionId}
- *   getStreamUrl={terminalClient.terminal_media.streamStreamRetrieveUrl}
- * >
- *   <VideoPlayer source={{ type: 'stream', path: '/video.mp4' }} />
- * </VideoPlayerProvider>
- */
-declare function VideoPlayerProvider({ children, getStreamUrl, sessionId, }: VideoPlayerProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access VideoPlayer context
- */
-declare function useVideoPlayerContext(): VideoPlayerContextValue | null;
-
-/**
- * Video source and player mode resolvers
- */
-
-/**
- * Determine which provider to use based on source type
- */
-declare function resolvePlayerMode(source: VideoSourceUnion, mode?: PlayerMode): 'vidstack' | 'native' | 'streaming';
-/**
- * Check if source is a simplified stream source (without getStreamUrl)
- */
-declare function isSimpleStreamSource(source: VideoSourceUnion | SimpleStreamSource | undefined | null): source is SimpleStreamSource;
-/**
- * Resolve simplified stream source to full stream source using context
- */
-declare function resolveStreamSource(source: SimpleStreamSource, context: VideoPlayerContextValue | null): StreamSource | null;
-
-/**
- * File source resolution utilities
- */
-
-/**
- * Resolve file content to VideoSourceUnion
- * Useful for FileWorkspace/file manager integrations
- *
- * @example
- * const source = resolveFileSource({
- *   content: file.content,
- *   path: file.path,
- *   mimeType: file.mimeType,
- *   sessionId: sessionId,
- *   loadMethod: file.loadMethod,
- *   getStreamUrl: terminalClient.terminal_media.streamStreamRetrieveUrl
- * });
- *
- * <VideoPlayer source={source} />
- */
-declare function resolveFileSource(options: ResolveFileSourceOptions): VideoSourceUnion | null;
-
-declare const Player: react.ForwardRefExoticComponent<PlayerProps & react.RefAttributes<PlayerHandle>>;
-
-declare function ImageViewer({ images, initialIndex, inDialog, }: ImageViewerProps): react_jsx_runtime.JSX.Element;
-
-declare function CronSchedulerProvider({ children, value, onChange, defaultType, }: CronSchedulerProviderProps): react_jsx_runtime.JSX.Element;
-declare function useCronSchedulerContext(): CronSchedulerContextValue;
-
-/**
- * Hook for schedule type selection
- * Re-renders only when type changes
- */
-declare function useCronType(): {
-    type: ScheduleType;
-    setType: (type: ScheduleType) => void;
-};
-/**
- * Hook for time selection
- * Re-renders only when hour/minute changes
- */
-declare function useCronTime(): {
-    hour: number;
-    minute: number;
-    setTime: (hour: number, minute: number) => void;
-};
-/**
- * Hook for week days selection
- * Re-renders only when weekDays changes
- */
-declare function useCronWeekDays(): {
-    weekDays: WeekDay[];
-    toggleWeekDay: (day: WeekDay) => void;
-    setWeekDays: (days: WeekDay[]) => void;
-};
-/**
- * Hook for month days selection
- * Re-renders only when monthDays changes
- */
-declare function useCronMonthDays(): {
-    monthDays: MonthDay[];
-    toggleMonthDay: (day: MonthDay) => void;
-    setMonthDays: (days: MonthDay[]) => void;
-};
-/**
- * Hook for custom cron input
- * Re-renders only when customCron/isValid changes
- */
-declare function useCronCustom(): {
-    customCron: string;
-    isValid: boolean;
-    setCustomCron: (cron: string) => void;
-};
-/**
- * Hook for preview display
- * Re-renders only when computed values change
- */
-declare function useCronPreview(): {
-    cronExpression: string;
-    humanDescription: string;
-    isValid: boolean;
-    initialValue: string;
-};
-/**
- * Full context access
- * Use sparingly - causes re-render on any state change
- */
-declare function useCronScheduler(): CronSchedulerContextValue;
-
-/**
- * Cron Builder
- *
- * Converts CronSchedulerState to Unix 5-field cron expression
- * Format: minute hour day-of-month month day-of-week
- */
-
-/**
- * Builds Unix 5-field cron expression from state
- *
- * @example
- * // Daily at 9:00
- * buildCron({ type: 'daily', hour: 9, minute: 0, ... }) // '0 9 * * *'
- *
- * // Weekly on Mon, Wed, Fri at 14:30
- * buildCron({ type: 'weekly', hour: 14, minute: 30, weekDays: [1, 3, 5], ... }) // '30 14 * * 1,3,5'
- *
- * // Monthly on 1st and 15th at 0:00
- * buildCron({ type: 'monthly', hour: 0, minute: 0, monthDays: [1, 15], ... }) // '0 0 1,15 * *'
- */
-declare function buildCron(state: CronSchedulerState): string;
-
-/**
- * Cron Parser
- *
- * Parses Unix 5-field cron expression into CronSchedulerState
- * Format: minute hour day-of-month month day-of-week
- */
-
-/**
- * Parses Unix 5-field cron expression into state
- *
- * @param cron - Cron expression to parse
- * @returns Parsed state or null if invalid
- *
- * @example
- * parseCron('0 9 * * *')
- * // { type: 'daily', hour: 9, minute: 0, ... }
- *
- * parseCron('30 14 * * 1,3,5')
- * // { type: 'weekly', hour: 14, minute: 30, weekDays: [1, 3, 5], ... }
- */
-declare function parseCron(cron: string): CronSchedulerState | null;
-/**
- * Validates cron expression syntax
- */
-declare function isValidCron(cron: string): boolean;
-
-/**
- * Cron Humanize
- *
- * Converts cron expressions to human-readable descriptions
- */
-/**
- * Converts cron expression to human-readable description
- *
- * Examples:
- * - humanizeCron('0 9 * * *') returns "Every day at 09:00"
- * - humanizeCron('30 14 * * 1,3,5') returns "Mon, Wed, Fri at 14:30"
- * - humanizeCron('0 0 1 * *') returns "1st of every month at 00:00"
- */
-declare function humanizeCron(cron: string): string;
-
-interface ScheduleTypeSelectorProps {
-    disabled?: boolean;
-    className?: string;
-}
-declare function ScheduleTypeSelector({ disabled, className, }: ScheduleTypeSelectorProps): react_jsx_runtime.JSX.Element;
-
-interface TimeSelectorProps {
-    format?: '12h' | '24h';
-    disabled?: boolean;
-    className?: string;
-}
-declare function TimeSelector({ format, disabled, className, }: TimeSelectorProps): react_jsx_runtime.JSX.Element;
-
-interface DayChipsProps {
-    disabled?: boolean;
-    showPresets?: boolean;
-    className?: string;
-}
-declare function DayChips({ disabled, showPresets, className, }: DayChipsProps): react_jsx_runtime.JSX.Element;
-
-interface MonthDayGridProps {
-    disabled?: boolean;
-    showPresets?: boolean;
-    className?: string;
-}
-declare function MonthDayGrid({ disabled, showPresets, className, }: MonthDayGridProps): react_jsx_runtime.JSX.Element;
-
-interface CustomInputProps {
-    disabled?: boolean;
-    className?: string;
-}
-declare function CustomInput({ disabled, className }: CustomInputProps): react_jsx_runtime.JSX.Element;
-
-interface SchedulePreviewProps {
-    /** Show raw cron expression (default: true) */
-    showCronExpression?: boolean;
-    /** Enable copy to clipboard */
-    allowCopy?: boolean;
-    /** Show initial value when changed (default: true) */
-    showInitialValue?: boolean;
-    /** Additional CSS classes */
-    className?: string;
-}
-declare function SchedulePreview({ showCronExpression, allowCopy, showInitialValue, className, }: SchedulePreviewProps): react_jsx_runtime.JSX.Element;
-
-/**
- * CronScheduler with Suspense wrapper
- */
-declare function CronScheduler(props: CronSchedulerProps): react_jsx_runtime.JSX.Element;
-
-interface EditorFile {
-    /** Unique file path */
-    path: string;
-    /** File content */
-    content: string;
-    /** Detected or specified language */
-    language: string;
-    /** Whether file has unsaved changes */
-    isDirty: boolean;
-    /** Monaco model reference */
-    model?: monaco.editor.ITextModel;
-}
-interface EditorOptions {
-    /** Editor theme: 'vs' | 'vs-dark' | 'hc-black' | custom */
-    theme?: string;
-    /** Font size in pixels */
-    fontSize?: number;
-    /** Font family */
-    fontFamily?: string;
-    /** Tab size */
-    tabSize?: number;
-    /** Insert spaces instead of tabs */
-    insertSpaces?: boolean;
-    /** Word wrap mode */
-    wordWrap?: 'off' | 'on' | 'wordWrapColumn' | 'bounded';
-    /** Show minimap */
-    minimap?: boolean;
-    /** Show line numbers */
-    lineNumbers?: 'on' | 'off' | 'relative' | 'interval';
-    /** Read-only mode */
-    readOnly?: boolean;
-}
-interface EditorProps {
-    /** File content */
-    value?: string;
-    /** Programming language for syntax highlighting */
-    language?: string;
-    /** Called when content changes */
-    onChange?: (value: string) => void;
-    /** Called when editor is mounted */
-    onMount?: (editor: monaco.editor.IStandaloneCodeEditor) => void;
-    /** Editor options */
-    options?: EditorOptions;
-    /** CSS class name */
-    className?: string;
-    /** Height — fixed px, CSS string, or '100%' (default: '100%'). Ignored when autoHeight=true */
-    height?: string | number;
-    /** Width (default: '100%') */
-    width?: string | number;
-    /** Auto-resize height to fit content. Editor grows/shrinks with content lines */
-    autoHeight?: boolean;
-    /** Min height in px when autoHeight is enabled (default: 100) */
-    minHeight?: number;
-    /** Max height in px when autoHeight is enabled (default: 600) */
-    maxHeight?: number;
-}
-interface DiffEditorProps {
-    /** Original content (left side) */
-    original: string;
-    /** Modified content (right side) */
-    modified: string;
-    /** Programming language */
-    language?: string;
-    /** Editor options */
-    options?: EditorOptions;
-    /** CSS class name */
-    className?: string;
-    /** Height (default: '100%') */
-    height?: string | number;
-}
-interface EditorContextValue {
-    /** Currently open files */
-    openFiles: EditorFile[];
-    /** Currently active file */
-    activeFile: EditorFile | null;
-    /** Monaco instance (null during SSR) */
-    monaco: typeof monaco | null;
-    /** Editor instance */
-    editor: monaco.editor.IStandaloneCodeEditor | null;
-    /** Whether editor is ready */
-    isReady: boolean;
-    openFile: (path: string, content: string, language?: string) => void;
-    closeFile: (path: string) => void;
-    setActiveFile: (path: string) => void;
-    updateContent: (path: string, content: string) => void;
-    saveFile: (path: string) => Promise<void>;
-    isDirty: (path: string) => boolean;
-    getContent: (path: string) => string | null;
-    getFile: (path: string) => EditorFile | null;
-}
-interface UseEditorReturn {
-    /** Editor instance */
-    editor: monaco.editor.IStandaloneCodeEditor | null;
-    /** Whether editor is mounted and ready */
-    isReady: boolean;
-    /** Set editor reference */
-    setEditor: (editor: monaco.editor.IStandaloneCodeEditor | null) => void;
-}
-interface UseMonacoReturn {
-    /** Monaco namespace */
-    monaco: typeof monaco | null;
-    /** Whether Monaco is loaded */
-    isLoading: boolean;
-    /** Loading error if any */
-    error: Error | null;
-}
-
-interface EditorRef {
-    /** Get editor instance */
-    getEditor: () => monaco.editor.IStandaloneCodeEditor | null;
-    /** Get current value */
-    getValue: () => string;
-    /** Set value */
-    setValue: (value: string) => void;
-    /** Focus editor */
-    focus: () => void;
-}
-/**
- * Monaco Editor Component
- *
- * A React wrapper around Monaco Editor with full TypeScript support.
- *
- * @example
- * ```tsx
- * <Editor
- *   value={code}
- *   language="typescript"
- *   onChange={(value) => setCode(value)}
- *   options={{ fontSize: 14, minimap: false }}
- * />
- * ```
- */
-declare const Editor: react.ForwardRefExoticComponent<EditorProps & react.RefAttributes<EditorRef>>;
-
-/**
- * Monaco Diff Editor Component
- *
- * Side-by-side or inline diff view for comparing two versions of content.
- *
- * @example
- * ```tsx
- * <DiffEditor
- *   original={originalCode}
- *   modified={modifiedCode}
- *   language="typescript"
- * />
- * ```
- */
-declare function DiffEditor({ original, modified, language, options, className, height, }: DiffEditorProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Hook to access editor context
- * Must be used within EditorProvider
- */
-declare function useEditorContext(): EditorContextValue;
-interface EditorProviderProps {
-    children: React.ReactNode;
-    /** Callback when file save is requested */
-    onSave?: (path: string, content: string) => Promise<void>;
-}
-/**
- * Editor Context Provider
- *
- * Manages multiple open files, active file state, and editor instance.
- *
- * @example
- * ```tsx
- * <EditorProvider onSave={handleSave}>
- *   <EditorTabs />
- *   <Editor />
- * </EditorProvider>
- * ```
- */
-declare function EditorProvider({ children, onSave }: EditorProviderProps): react_jsx_runtime.JSX.Element;
-
-/**
- * Hook to load and access Monaco Editor instance
- *
- * Handles:
- * - Dynamic import of Monaco (client-side only)
- * - Web worker configuration
- * - Loading state management
- *
- * @example
- * ```tsx
- * const { monaco, isLoading, error } = useMonaco();
- *
- * if (isLoading) return <Spinner />;
- * if (error) return <Error message={error.message} />;
- *
- * // Use monaco API
- * monaco.editor.create(...)
- * ```
- */
-declare function useMonaco(): UseMonacoReturn;
-
-/**
- * Hook to manage editor instance reference
- *
- * @example
- * ```tsx
- * const { editor, isReady, setEditor } = useEditor();
- *
- * // Pass setEditor to Editor component's onMount
- * <Editor onMount={setEditor} />
- *
- * // Use editor when ready
- * if (isReady) {
- *   editor.getModel()?.getValue();
- * }
- * ```
- */
-declare function useEditor(): UseEditorReturn;
-
-/**
- * Hook to detect language from filename
- *
- * @param filename - File name or path
- * @returns Monaco language ID
- *
- * @example
- * ```tsx
- * const language = useLanguage('app.tsx');
- * // Returns: 'typescript'
- *
- * const language2 = useLanguage('/path/to/Dockerfile');
- * // Returns: 'dockerfile'
- * ```
- */
-declare function useLanguage(filename: string | undefined): string;
-
-/** Item that can be mentioned via @ trigger */
-interface MentionItem {
-    id: string;
-    label: string;
-    description?: string;
-    thumbnail?: string;
-}
-/**
- * Attributes available when rendering a mention to markdown.
- *
- * Same shape Tiptap stores on the `mention` node — `id` is the stable
- * identifier the suggestion popover injected, `label` is the human text
- * shown to the user. Either field may be empty if the upstream config
- * never populated it; renderers should fall back accordingly.
- */
-interface MentionAttrs {
-    id: string;
-    label: string;
-}
-/**
- * Function that converts a mention node into its markdown serialization.
- *
- * The returned string is what `@tiptap/markdown` writes into the markdown
- * output of `MarkdownEditor.getMarkdown()`.
- */
-type MentionMarkdownRenderer = (attrs: MentionAttrs) => string;
-/** Mention configuration */
-interface MentionConfig {
-    /** Trigger character (default: '@') */
-    trigger?: string;
-    /** Available items */
-    items: MentionItem[];
-    /** Max dropdown items (default: 5) */
-    maxItems?: number;
-    /**
-     * Custom serializer for mentions when `MarkdownEditor.getMarkdown()` runs.
-     *
-     * Defaults to `mentionPresets.plainAt` which yields `@<label>` (or `@<id>`
-     * when `label` is missing). Use one of `mentionPresets`, or supply your
-     * own function for full control over how mentions appear in the output
-     * markdown string.
-     *
-     * Note: this only affects the *markdown* output. `editor.getText()` and
-     * the rendered DOM still go through `renderText` (`@<label>` by default).
-     */
-    renderMarkdown?: MentionMarkdownRenderer;
-}
-
-interface MarkdownEditorProps {
-    value: string;
-    onChange: (value: string) => void;
-    placeholder?: string;
-    minHeight?: number;
-    className?: string;
-    disabled?: boolean;
-    showToolbar?: boolean;
-    /**
-     * `@`-mention autocomplete config.
-     *
-     * IMPORTANT: Tiptap's `useEditor` initialises the editor exactly once.
-     * The `Mention` extension is only registered when `mentions` is truthy
-     * on the FIRST render — handing in a real config later (e.g. after an
-     * async items fetch) silently does nothing, and typing `@` will not
-     * open the popover.
-     *
-     * If you want mentions even with async-loaded items, pass
-     * `{ items: [] }` from the very first render and update the array
-     * when data arrives. Either keep the `MentionConfig` object identity
-     * stable across renders and mutate `items` in place (the suggestion
-     * plugin captures the config by closure and reads `items` on each
-     * query), or accept that swapping the whole object reference is a
-     * no-op for the live editor.
-     */
-    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;
-}
-/**
- * Imperative handle exposed via `ref`. Matches `ComposerHandle` from
- * `@djangocfg/ui-tools/chat` so consumers can forward it straight into
- * `useRegisterComposer({ focus, moveCursorToEnd })` — that's what makes
- * voice dictation (`VoiceComposerSlot`) push live text into a TipTap
- * composer.
- */
-interface MarkdownEditorHandle {
-    /** Move keyboard focus into the editor. */
-    focus: () => void;
-    /** Place the caret at the end of the document (and focus). */
-    moveCursorToEnd: () => void;
-    /** Escape hatch — the underlying TipTap `Editor` instance. */
-    getEditor: () => Editor$1 | null;
-}
-declare const MarkdownEditor: react.ForwardRefExoticComponent<MarkdownEditorProps & react.RefAttributes<MarkdownEditorHandle>>;
-
-/**
- * Built-in serializers for the `MentionConfig.renderMarkdown` callback.
- *
- * Pick one based on what consumes the markdown:
- *
- * - LLM / chat composer    → `plainAt`     (the default)
- * - Plain text export      → `plainLabel`
- * - Web app with deep-link → `markdownLink(baseUrl)`
- * - Notion / Linear-style  → `customUri(scheme, kind)`
- * - Slack-style id refs    → `slackStyle`
- * - HTML-allowing renderer → `htmlSpan(className?)`
- *
- * Or pass a custom function — the type is just `(attrs) => string`.
- */
-declare const mentionPresets: {
-    /** "@Label" — default, ideal for chat where LLMs read the text. */
-    plainAt: MentionMarkdownRenderer;
-    /** "Label" — bare label, no @ prefix. */
-    plainLabel: MentionMarkdownRenderer;
-    /** "[@Label](baseUrl/id)" — clickable markdown link. */
-    markdownLink: (baseUrl: string) => MentionMarkdownRenderer;
-    /** "@[Label](scheme://kind/id)" — Notion / Linear-style custom URI. */
-    customUri: (scheme: string, kind: string) => MentionMarkdownRenderer;
-    /** "<@id>" — Slack-style id-only reference (label dropped — receivers resolve it). */
-    slackStyle: MentionMarkdownRenderer;
-    /** Inline HTML span — for products that consume markdown with raw HTML allowed. */
-    htmlSpan: (className?: string) => MentionMarkdownRenderer;
-};
-
-interface BlobUrlEntry {
-    url: string;
-    refCount: number;
-    createdAt: number;
-}
-interface ImageDimensions {
-    width: number;
-    height: number;
-}
-interface VideoMetadata {
-    duration: number;
-    width: number;
-    height: number;
-    codec?: string;
-}
-interface EffectConfig {
-    opacity: number;
-    scale: number;
-    blur: string;
-}
-/** Video player settings (persisted) */
-interface VideoPlayerSettings {
-    volume: number;
-    isLooping: boolean;
-}
-interface MediaCacheState {
-    blobUrls: Map<string, BlobUrlEntry>;
-    imageDimensions: Map<string, ImageDimensions>;
-    audioPlaybackPositions: Map<string, number>;
-    audioEffectConfigs: Map<string, EffectConfig>;
-    videoStreamUrls: Map<string, {
-        url: string;
-        timestamp: number;
-    }>;
-    videoPosterUrls: Map<string, string>;
-    videoPlaybackPositions: Map<string, number>;
-    videoMetadata: Map<string, VideoMetadata>;
-    videoPlayerSettings: VideoPlayerSettings;
-}
-interface MediaCacheActions {
-    getOrCreateBlobUrl: (key: string, content: ArrayBuffer, mimeType: string) => string;
-    releaseBlobUrl: (key: string) => void;
-    hasBlobUrl: (key: string) => boolean;
-    cacheDimensions: (src: string, dims: ImageDimensions) => void;
-    getDimensions: (src: string) => ImageDimensions | null;
-    saveAudioPosition: (uri: string, time: number) => void;
-    getAudioPosition: (uri: string) => number | null;
-    getEffectConfig: (key: string) => EffectConfig | null;
-    cacheEffectConfig: (key: string, config: EffectConfig) => void;
-    getOrCreateStreamUrl: (sessionId: string, path: string, generator: (sessionId: string, path: string) => string) => string;
-    getPosterUrl: (title: string) => string | null;
-    cachePosterUrl: (title: string, url: string) => void;
-    saveVideoPosition: (key: string, time: number) => void;
-    getVideoPosition: (key: string) => number | null;
-    cacheVideoMetadata: (url: string, meta: VideoMetadata) => void;
-    getVideoMetadata: (url: string) => VideoMetadata | null;
-    invalidateSession: (sessionId: string) => void;
-    getVideoPlayerSettings: () => VideoPlayerSettings;
-    saveVideoPlayerSettings: (settings: Partial<VideoPlayerSettings>) => void;
-    clearCache: () => void;
-    getCacheStats: () => {
-        blobUrls: number;
-        dimensions: number;
-        audioPositions: number;
-        videoPositions: number;
-    };
-}
-type MediaCacheStore = MediaCacheState & MediaCacheActions;
-declare const useMediaCacheStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<MediaCacheStore>, "setState" | "devtools"> & {
-    setState(partial: MediaCacheStore | Partial<MediaCacheStore> | ((state: MediaCacheStore) => MediaCacheStore | Partial<MediaCacheStore>), replace?: false, action?: string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }): void;
-    setState(state: MediaCacheStore | ((state: MediaCacheStore) => MediaCacheStore), replace: true, action?: string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }): void;
-    devtools: {
-        cleanup: () => void;
-    };
-}, "setState" | "persist"> & {
-    setState(partial: MediaCacheStore | Partial<MediaCacheStore> | ((state: MediaCacheStore) => MediaCacheStore | Partial<MediaCacheStore>), replace?: false, action?: string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }): unknown;
-    setState(state: MediaCacheStore | ((state: MediaCacheStore) => MediaCacheStore), replace: true, action?: string | {
-        [x: string]: unknown;
-        [x: number]: unknown;
-        [x: symbol]: unknown;
-        type: string;
-    }): unknown;
-    persist: {
-        setOptions: (options: Partial<zustand_middleware.PersistOptions<MediaCacheStore, {
-            audioPlaybackPositions: [string, number][];
-            videoPlaybackPositions: [string, number][];
-            videoPosterUrls: [string, string][];
-            videoPlayerSettings: VideoPlayerSettings;
-        }, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: MediaCacheStore) => void) => () => void;
-        onFinishHydration: (fn: (state: MediaCacheStore) => void) => () => void;
-        getOptions: () => Partial<zustand_middleware.PersistOptions<MediaCacheStore, {
-            audioPlaybackPositions: [string, number][];
-            videoPlaybackPositions: [string, number][];
-            videoPosterUrls: [string, string][];
-            videoPlayerSettings: VideoPlayerSettings;
-        }, unknown>>;
-    };
-}>;
-/**
- * Hook for image-related cache operations
- * Uses useShallow to prevent infinite re-renders
- */
-declare const useImageCache: () => {
-    getOrCreateBlobUrl: (key: string, content: ArrayBuffer, mimeType: string) => string;
-    releaseBlobUrl: (key: string) => void;
-    hasBlobUrl: (key: string) => boolean;
-    cacheDimensions: (src: string, dims: ImageDimensions) => void;
-    getDimensions: (src: string) => ImageDimensions | null;
-};
-/**
- * Hook for audio-related cache operations
- * Uses useShallow to prevent infinite re-renders
- */
-declare const useAudioCache: () => {
-    getOrCreateBlobUrl: (key: string, content: ArrayBuffer, mimeType: string) => string;
-    releaseBlobUrl: (key: string) => void;
-    hasBlobUrl: (key: string) => boolean;
-    saveAudioPosition: (uri: string, time: number) => void;
-    getAudioPosition: (uri: string) => number | null;
-    getEffectConfig: (key: string) => EffectConfig | null;
-    cacheEffectConfig: (key: string, config: EffectConfig) => void;
-};
-/**
- * Hook for video-related cache operations
- * Uses useShallow to prevent infinite re-renders
- */
-declare const useVideoCache: () => {
-    getOrCreateBlobUrl: (key: string, content: ArrayBuffer, mimeType: string) => string;
-    releaseBlobUrl: (key: string) => void;
-    hasBlobUrl: (key: string) => boolean;
-    getOrCreateStreamUrl: (sessionId: string, path: string, generator: (sessionId: string, path: string) => string) => string;
-    getPosterUrl: (title: string) => string | null;
-    cachePosterUrl: (title: string, url: string) => void;
-    saveVideoPosition: (key: string, time: number) => void;
-    getVideoPosition: (key: string) => number | null;
-    cacheVideoMetadata: (url: string, meta: VideoMetadata) => void;
-    getVideoMetadata: (url: string) => VideoMetadata | null;
-    invalidateSession: (sessionId: string) => void;
-    getVideoPlayerSettings: () => VideoPlayerSettings;
-    saveVideoPlayerSettings: (settings: Partial<VideoPlayerSettings>) => void;
-};
-/**
- * Hook for video player settings only
- * Returns current settings and save function
- */
-declare const useVideoPlayerSettings: () => {
-    settings: VideoPlayerSettings;
-    saveSettings: (settings: Partial<VideoPlayerSettings>) => void;
-};
-/**
- * Hook for blob URL cleanup on unmount
- */
-declare function useBlobUrlCleanup(key: string | null): void;
-/**
- * Generate a cache key from ArrayBuffer content
- * Uses first and last 1KB + length for fast hashing
- */
-declare function generateContentKey(content: ArrayBuffer): 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;
-
-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 };