@mieweb/ui 0.10.0-dev.10 → 0.10.0-dev.12

package/dist/motion.d.cts

@@ -1,5 +1,4 @@
 import * as React from 'react';
-export { A as Animated, a as AnimatedPresence, b as AnimatedProps, M as MotionEdge, c as MotionPreset, d as MotionRuntime, m as motionPresets, u as useMotionRuntime } from './Animated-XmH6k8pZ.cjs';
 
 /**
  * `<MotionProvider>` — the opt-in switch.
@@ -49,4 +48,189 @@ declare namespace MotionProvider {
     var displayName: string;
 }
 
-export { MotionProvider, type MotionProviderProps };
+/**
+ * Motion presets — the shared vocabulary of animations.
+ *
+ * This module is intentionally **free of any `motion` import**. It ships in the
+ * main `@mieweb/ui` entry so components can describe *what* they animate
+ * without pulling in a runtime to actually do it. The `@mieweb/ui/motion` entry
+ * is what turns these descriptions into real animations.
+ *
+ * Every preset is expressed as an open/closed variant pair so the same
+ * definition serves both usages:
+ *
+ * - **toggle** — the element stays mounted and animates between `open` and
+ *   `closed` (a drawer sliding in and out).
+ * - **presence** — the element mounts and unmounts, entering on `open` and
+ *   exiting back to `closed` (a modal).
+ */
+/** Named animation recipes shared by components. */
+type MotionPreset = 'drawerStart' | 'overlay' | 'modalContent' | 'sidebarLabel' | 'menu' | 'collapse' | 'toast' | 'fade' | 'pop';
+/**
+ * A physical edge, already resolved from any logical (`start`/`end`) position
+ * and from writing direction.
+ *
+ * Presets that move an element along an axis take one of these as `custom`.
+ * Resolution is the component's job, not the preset's: only the component knows
+ * whether its `end` means right or left, and — for anything anchored — which
+ * side it actually landed on after flipping away from a viewport edge.
+ */
+type MotionEdge = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * A variant value. Either a plain target object or a function of the element's
+ * `custom` value — the latter lets a single preset adapt to context, e.g. a
+ * drawer flipping its off-canvas direction in RTL.
+ */
+type MotionVariant = Record<string, unknown> | ((custom: unknown) => Record<string, unknown>);
+interface MotionPresetDefinition {
+    variants: {
+        open: MotionVariant;
+        closed: MotionVariant;
+    };
+    transition: Record<string, unknown>;
+}
+/**
+ * `custom` contract per preset:
+ *
+ * - `drawerStart` — `boolean`, whether the document direction is RTL.
+ * - `menu`, `toast` — a {@link MotionEdge}, already resolved from logical
+ *   position and writing direction by the component.
+ * - `overlay`, `modalContent`, `sidebarLabel`, `collapse`, `fade`, `pop` —
+ *   unused.
+ */
+declare const motionPresets: Record<MotionPreset, MotionPresetDefinition>;
+
+/**
+ * Motion runtime — the seam between components and an optional animation library.
+ *
+ * Components in the main entry never import `motion`. They ask this module for
+ * a runtime; if an app has opted in by rendering `<MotionProvider>` from
+ * `@mieweb/ui/motion`, they get one and animate. If not, `useMotionRuntime()`
+ * returns `null` and they fall back to their existing CSS transitions. That is
+ * what keeps `motion` out of the bundle of every app that hasn't asked for it —
+ * the opt-in is resolved in the *module graph*, not by a prop.
+ *
+ * Like `presets`, this module must stay free of any `motion` import.
+ */
+
+interface MotionPresenceProps {
+    children?: React.ReactNode;
+    /** Suppress the initial mount animation. */
+    initial?: boolean;
+    /**
+     * Fires once every exiting child has finished and been removed.
+     *
+     * Needed by anything that guards the DOM while it is open — a focus trap, a
+     * scroll lock — because those guards must outlive `open` for as long as the
+     * subtree is still on screen. Never fires when no runtime is active, since
+     * there is no exit to wait for.
+     */
+    onExitComplete?: () => void;
+}
+/**
+ * The capabilities a motion library must supply. Deliberately small: element
+ * factories, a presence wrapper, and prop builders. Components depend on this
+ * interface, never on a concrete library, so swapping or dropping the library
+ * stays a one-file change.
+ */
+interface MotionRuntime {
+    /**
+     * Whether animations should actually run.
+     *
+     * A disabled provider still supplies a runtime rather than `null` so that
+     * consumers can tell "disabled" apart from "never opted in": `Modal` uses it
+     * to decide whether an exit animation will ever report completion, and
+     * `AnimatedPresence` keeps its wrapper element stable across the flip.
+     * `Animated` itself renders the plain fallback tag whenever this is false —
+     * withholding animation props from a mounted motion component corrupts
+     * `toggle`-mode elements, so the swap (and the remount it implies) is the
+     * correct behaviour. See the render branches in `Animated`.
+     */
+    enabled: boolean;
+    /** Animated `div`. */
+    Div: React.ElementType;
+    /** Animated `nav`. */
+    Nav: React.ElementType;
+    /** Animated `span`, for inline content that must not become a block. */
+    Span: React.ElementType;
+    /** Enables exit animations for conditionally rendered children. */
+    Presence: React.ComponentType<MotionPresenceProps>;
+    /**
+     * Props for an element that stays mounted and animates between states.
+     * Skips the initial animation so a closed drawer doesn't slide out on load.
+     */
+    toggle: (preset: MotionPreset, open: boolean, custom?: unknown) => Record<string, unknown>;
+    /** Props for an element that mounts and unmounts inside `Presence`. */
+    presence: (preset: MotionPreset, custom?: unknown) => Record<string, unknown>;
+}
+/**
+ * The active motion runtime, or `null` when the app has not opted in.
+ *
+ * Components must treat `null` as the normal case and keep a CSS path that
+ * looks good on its own — motion is an enhancement, never a requirement.
+ */
+declare function useMotionRuntime(): MotionRuntime | null;
+
+/**
+ * `Animated` / `AnimatedPresence` — the ergonomic layer components use.
+ *
+ * These exist so an individual component never has to branch on whether motion
+ * is available. It declares the preset it wants and the CSS classes that stand
+ * in when motion is absent; this module picks the element to render.
+ *
+ * Adding motion to a further component should be a matter of swapping its
+ * root `<div>` for an `<Animated>` and naming a preset — no new imports, no
+ * new dependency, and no behavior change for apps that have not opted in.
+ */
+
+interface AnimatedProps extends React.HTMLAttributes<HTMLElement> {
+    /** Intrinsic element to render. */
+    as?: 'div' | 'nav' | 'span';
+    /** Which shared animation recipe to use. */
+    preset: MotionPreset;
+    /**
+     * - `toggle` — element stays mounted and animates between open and closed.
+     * - `presence` — element mounts and unmounts; wrap it in `<AnimatedPresence>`
+     *   so the exit animation gets a chance to run.
+     */
+    mode: 'toggle' | 'presence';
+    /** Current state. Only read in `toggle` mode. */
+    open?: boolean;
+    /** Per-preset context value — see the `custom` contract in `presets.ts`. */
+    custom?: unknown;
+    /**
+     * Classes applied whenever this element is **not** animating — no provider,
+     * a disabled provider, or `enabled={false}`. This is where a component's
+     * existing CSS transition lives, so the two paths never both try to drive
+     * the same property.
+     */
+    fallbackClassName?: string;
+    /**
+     * Set `false` to stop this element animating even when a runtime is active.
+     *
+     * For states where an animated element would be wrong rather than merely
+     * unnecessary. Motion writes a `transform` to hold an element at its resting
+     * position, and a transformed ancestor becomes the containing block for any
+     * `position: fixed` descendant — so an element that is only sometimes
+     * animated should opt out the rest of the time.
+     *
+     * Flipping this (or the provider's `disabled`) swaps the element back to a
+     * plain tag, which **remounts** it — deliberately. See the note on the
+     * render branches below.
+     */
+    enabled?: boolean;
+}
+declare const Animated: React.ForwardRefExoticComponent<AnimatedProps & React.RefAttributes<HTMLElement>>;
+/**
+ * Keeps unmounting children on screen long enough to animate out.
+ *
+ * Without a runtime this is a pass-through, so children disappear immediately —
+ * which is exactly what they do today. Children rendered conditionally inside
+ * it need a stable `key`.
+ */
+declare function AnimatedPresence({ children, initial, onExitComplete, }: MotionPresenceProps): React.JSX.Element;
+declare namespace AnimatedPresence {
+    var displayName: string;
+}
+
+export { Animated, AnimatedPresence, type AnimatedProps, type MotionEdge, type MotionPreset, MotionProvider, type MotionProviderProps, type MotionRuntime, motionPresets, useMotionRuntime };

package/dist/motion.d.ts

@@ -1,5 +1,4 @@
 import * as React from 'react';
-export { A as Animated, a as AnimatedPresence, b as AnimatedProps, M as MotionEdge, c as MotionPreset, d as MotionRuntime, m as motionPresets, u as useMotionRuntime } from './Animated-XmH6k8pZ.js';
 
 /**
  * `<MotionProvider>` — the opt-in switch.
@@ -49,4 +48,189 @@ declare namespace MotionProvider {
     var displayName: string;
 }
 
-export { MotionProvider, type MotionProviderProps };
+/**
+ * Motion presets — the shared vocabulary of animations.
+ *
+ * This module is intentionally **free of any `motion` import**. It ships in the
+ * main `@mieweb/ui` entry so components can describe *what* they animate
+ * without pulling in a runtime to actually do it. The `@mieweb/ui/motion` entry
+ * is what turns these descriptions into real animations.
+ *
+ * Every preset is expressed as an open/closed variant pair so the same
+ * definition serves both usages:
+ *
+ * - **toggle** — the element stays mounted and animates between `open` and
+ *   `closed` (a drawer sliding in and out).
+ * - **presence** — the element mounts and unmounts, entering on `open` and
+ *   exiting back to `closed` (a modal).
+ */
+/** Named animation recipes shared by components. */
+type MotionPreset = 'drawerStart' | 'overlay' | 'modalContent' | 'sidebarLabel' | 'menu' | 'collapse' | 'toast' | 'fade' | 'pop';
+/**
+ * A physical edge, already resolved from any logical (`start`/`end`) position
+ * and from writing direction.
+ *
+ * Presets that move an element along an axis take one of these as `custom`.
+ * Resolution is the component's job, not the preset's: only the component knows
+ * whether its `end` means right or left, and — for anything anchored — which
+ * side it actually landed on after flipping away from a viewport edge.
+ */
+type MotionEdge = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * A variant value. Either a plain target object or a function of the element's
+ * `custom` value — the latter lets a single preset adapt to context, e.g. a
+ * drawer flipping its off-canvas direction in RTL.
+ */
+type MotionVariant = Record<string, unknown> | ((custom: unknown) => Record<string, unknown>);
+interface MotionPresetDefinition {
+    variants: {
+        open: MotionVariant;
+        closed: MotionVariant;
+    };
+    transition: Record<string, unknown>;
+}
+/**
+ * `custom` contract per preset:
+ *
+ * - `drawerStart` — `boolean`, whether the document direction is RTL.
+ * - `menu`, `toast` — a {@link MotionEdge}, already resolved from logical
+ *   position and writing direction by the component.
+ * - `overlay`, `modalContent`, `sidebarLabel`, `collapse`, `fade`, `pop` —
+ *   unused.
+ */
+declare const motionPresets: Record<MotionPreset, MotionPresetDefinition>;
+
+/**
+ * Motion runtime — the seam between components and an optional animation library.
+ *
+ * Components in the main entry never import `motion`. They ask this module for
+ * a runtime; if an app has opted in by rendering `<MotionProvider>` from
+ * `@mieweb/ui/motion`, they get one and animate. If not, `useMotionRuntime()`
+ * returns `null` and they fall back to their existing CSS transitions. That is
+ * what keeps `motion` out of the bundle of every app that hasn't asked for it —
+ * the opt-in is resolved in the *module graph*, not by a prop.
+ *
+ * Like `presets`, this module must stay free of any `motion` import.
+ */
+
+interface MotionPresenceProps {
+    children?: React.ReactNode;
+    /** Suppress the initial mount animation. */
+    initial?: boolean;
+    /**
+     * Fires once every exiting child has finished and been removed.
+     *
+     * Needed by anything that guards the DOM while it is open — a focus trap, a
+     * scroll lock — because those guards must outlive `open` for as long as the
+     * subtree is still on screen. Never fires when no runtime is active, since
+     * there is no exit to wait for.
+     */
+    onExitComplete?: () => void;
+}
+/**
+ * The capabilities a motion library must supply. Deliberately small: element
+ * factories, a presence wrapper, and prop builders. Components depend on this
+ * interface, never on a concrete library, so swapping or dropping the library
+ * stays a one-file change.
+ */
+interface MotionRuntime {
+    /**
+     * Whether animations should actually run.
+     *
+     * A disabled provider still supplies a runtime rather than `null` so that
+     * consumers can tell "disabled" apart from "never opted in": `Modal` uses it
+     * to decide whether an exit animation will ever report completion, and
+     * `AnimatedPresence` keeps its wrapper element stable across the flip.
+     * `Animated` itself renders the plain fallback tag whenever this is false —
+     * withholding animation props from a mounted motion component corrupts
+     * `toggle`-mode elements, so the swap (and the remount it implies) is the
+     * correct behaviour. See the render branches in `Animated`.
+     */
+    enabled: boolean;
+    /** Animated `div`. */
+    Div: React.ElementType;
+    /** Animated `nav`. */
+    Nav: React.ElementType;
+    /** Animated `span`, for inline content that must not become a block. */
+    Span: React.ElementType;
+    /** Enables exit animations for conditionally rendered children. */
+    Presence: React.ComponentType<MotionPresenceProps>;
+    /**
+     * Props for an element that stays mounted and animates between states.
+     * Skips the initial animation so a closed drawer doesn't slide out on load.
+     */
+    toggle: (preset: MotionPreset, open: boolean, custom?: unknown) => Record<string, unknown>;
+    /** Props for an element that mounts and unmounts inside `Presence`. */
+    presence: (preset: MotionPreset, custom?: unknown) => Record<string, unknown>;
+}
+/**
+ * The active motion runtime, or `null` when the app has not opted in.
+ *
+ * Components must treat `null` as the normal case and keep a CSS path that
+ * looks good on its own — motion is an enhancement, never a requirement.
+ */
+declare function useMotionRuntime(): MotionRuntime | null;
+
+/**
+ * `Animated` / `AnimatedPresence` — the ergonomic layer components use.
+ *
+ * These exist so an individual component never has to branch on whether motion
+ * is available. It declares the preset it wants and the CSS classes that stand
+ * in when motion is absent; this module picks the element to render.
+ *
+ * Adding motion to a further component should be a matter of swapping its
+ * root `<div>` for an `<Animated>` and naming a preset — no new imports, no
+ * new dependency, and no behavior change for apps that have not opted in.
+ */
+
+interface AnimatedProps extends React.HTMLAttributes<HTMLElement> {
+    /** Intrinsic element to render. */
+    as?: 'div' | 'nav' | 'span';
+    /** Which shared animation recipe to use. */
+    preset: MotionPreset;
+    /**
+     * - `toggle` — element stays mounted and animates between open and closed.
+     * - `presence` — element mounts and unmounts; wrap it in `<AnimatedPresence>`
+     *   so the exit animation gets a chance to run.
+     */
+    mode: 'toggle' | 'presence';
+    /** Current state. Only read in `toggle` mode. */
+    open?: boolean;
+    /** Per-preset context value — see the `custom` contract in `presets.ts`. */
+    custom?: unknown;
+    /**
+     * Classes applied whenever this element is **not** animating — no provider,
+     * a disabled provider, or `enabled={false}`. This is where a component's
+     * existing CSS transition lives, so the two paths never both try to drive
+     * the same property.
+     */
+    fallbackClassName?: string;
+    /**
+     * Set `false` to stop this element animating even when a runtime is active.
+     *
+     * For states where an animated element would be wrong rather than merely
+     * unnecessary. Motion writes a `transform` to hold an element at its resting
+     * position, and a transformed ancestor becomes the containing block for any
+     * `position: fixed` descendant — so an element that is only sometimes
+     * animated should opt out the rest of the time.
+     *
+     * Flipping this (or the provider's `disabled`) swaps the element back to a
+     * plain tag, which **remounts** it — deliberately. See the note on the
+     * render branches below.
+     */
+    enabled?: boolean;
+}
+declare const Animated: React.ForwardRefExoticComponent<AnimatedProps & React.RefAttributes<HTMLElement>>;
+/**
+ * Keeps unmounting children on screen long enough to animate out.
+ *
+ * Without a runtime this is a pass-through, so children disappear immediately —
+ * which is exactly what they do today. Children rendered conditionally inside
+ * it need a stable `key`.
+ */
+declare function AnimatedPresence({ children, initial, onExitComplete, }: MotionPresenceProps): React.JSX.Element;
+declare namespace AnimatedPresence {
+    var displayName: string;
+}
+
+export { Animated, AnimatedPresence, type AnimatedProps, type MotionEdge, type MotionPreset, MotionProvider, type MotionProviderProps, type MotionRuntime, motionPresets, useMotionRuntime };

package/dist/q.d.cts

@@ -1,5 +1,27 @@
-export { Q, QProps, createQAgentConfig, createQTwilioAgentConfig, qAgentSchema, qLandingPageAgentConfig, qTwilioAgentSchema } from './components/Q/index.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { AgentConfigGeneratorProps, QConfig, QSchema } from '@mieweb/q';
 export { AgentConfigGenerator, AgentConfigGeneratorProps, ConfigEditor, ConfigEditorProps, FormBuilder, FormBuilderProps, GENERIC_TOOLS, Header, HeaderProps, QConfig, QDownloadMode, QSchema, TIMEZONES, ToolBuilder, ToolBuilderProps, configToQuestionnaire, configToYaml, copyToClipboard, defaultSchema, deriveDefaultConfig, downloadConfig, questionnaireToConfig, validateConfig, yamlToConfig } from '@mieweb/q';
 export { UniversalAgentConfigGenerator, UniversalAgentConfigGeneratorOptions, brands, generateBrandCSS } from '@mieweb/q/universal';
-import 'react/jsx-runtime';
-import 'react';
+
+interface QProps extends AgentConfigGeneratorProps {
+    /** Additional class name for the Q container. */
+    className?: string;
+    /** Inline styles for the Q container. */
+    style?: React.CSSProperties;
+}
+/**
+ * Q is the agent config generator form surface.
+ *
+ * It wraps the published @mieweb/q form generator so it can be consumed through
+ * @mieweb/ui/q while keeping Q's heavier dependencies out of the main UI entry.
+ */
+declare function Q({ className, style, ...props }: QProps): react_jsx_runtime.JSX.Element;
+
+declare const qTwilioAgentSchema: QSchema;
+declare const qAgentSchema: QSchema;
+declare const qLandingPageAgentConfig: QConfig;
+declare function createQAgentConfig(): QConfig;
+declare function createQTwilioAgentConfig(): QConfig;
+
+export { Q, type QProps, createQAgentConfig, createQTwilioAgentConfig, qAgentSchema, qLandingPageAgentConfig, qTwilioAgentSchema };

package/dist/q.d.ts

@@ -1,5 +1,27 @@
-export { Q, QProps, createQAgentConfig, createQTwilioAgentConfig, qAgentSchema, qLandingPageAgentConfig, qTwilioAgentSchema } from './components/Q/index.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { AgentConfigGeneratorProps, QConfig, QSchema } from '@mieweb/q';
 export { AgentConfigGenerator, AgentConfigGeneratorProps, ConfigEditor, ConfigEditorProps, FormBuilder, FormBuilderProps, GENERIC_TOOLS, Header, HeaderProps, QConfig, QDownloadMode, QSchema, TIMEZONES, ToolBuilder, ToolBuilderProps, configToQuestionnaire, configToYaml, copyToClipboard, defaultSchema, deriveDefaultConfig, downloadConfig, questionnaireToConfig, validateConfig, yamlToConfig } from '@mieweb/q';
 export { UniversalAgentConfigGenerator, UniversalAgentConfigGeneratorOptions, brands, generateBrandCSS } from '@mieweb/q/universal';
-import 'react/jsx-runtime';
-import 'react';
+
+interface QProps extends AgentConfigGeneratorProps {
+    /** Additional class name for the Q container. */
+    className?: string;
+    /** Inline styles for the Q container. */
+    style?: React.CSSProperties;
+}
+/**
+ * Q is the agent config generator form surface.
+ *
+ * It wraps the published @mieweb/q form generator so it can be consumed through
+ * @mieweb/ui/q while keeping Q's heavier dependencies out of the main UI entry.
+ */
+declare function Q({ className, style, ...props }: QProps): react_jsx_runtime.JSX.Element;
+
+declare const qTwilioAgentSchema: QSchema;
+declare const qAgentSchema: QSchema;
+declare const qLandingPageAgentConfig: QConfig;
+declare function createQAgentConfig(): QConfig;
+declare function createQTwilioAgentConfig(): QConfig;
+
+export { Q, type QProps, createQAgentConfig, createQTwilioAgentConfig, qAgentSchema, qLandingPageAgentConfig, qTwilioAgentSchema };

package/dist/{types-B97JNRNQ.d.cts → types-DOxdTwmq.d.cts}

@@ -1,5 +1,173 @@
 import * as React from 'react';
-import { A as AIMessageContent, a as AIMessageStatus } from './types-CnPEwzlp.cjs';
+
+/**
+ * AI Component Types
+ *
+ * Type definitions for AI-related components including MCP (Model Context Protocol)
+ * interactions, tool calls, and chat messages.
+ */
+
+/**
+ * Status of an MCP tool invocation
+ */
+type MCPToolStatus = 'pending' | 'running' | 'success' | 'error' | 'cancelled';
+/**
+ * MCP Tool parameter definition
+ */
+interface MCPToolParameter {
+    name: string;
+    type: string;
+    value: unknown;
+    description?: string;
+}
+/**
+ * MCP Tool invocation
+ */
+interface MCPToolCall {
+    /** Unique identifier for this tool call */
+    id: string;
+    /** Name of the tool being invoked */
+    toolName: string;
+    /** Human-readable description of what the tool does */
+    description?: string;
+    /** Parameters passed to the tool */
+    parameters: MCPToolParameter[];
+    /** Current status of the tool execution */
+    status: MCPToolStatus;
+    /** Timestamp when tool was invoked */
+    startedAt: Date | string;
+    /** Timestamp when tool completed */
+    completedAt?: Date | string;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Result data if successful */
+    result?: MCPToolResult;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Result from an MCP tool execution
+ */
+interface MCPToolResult {
+    /** Type of result data */
+    type: 'text' | 'json' | 'link' | 'resource' | 'error';
+    /** The result data */
+    data: unknown;
+    /** Human-readable summary of the result */
+    summary?: string;
+    /** Link to a resource (for link type) */
+    link?: MCPResourceLink;
+    /** Resources created or modified */
+    resources?: MCPResource[];
+}
+/**
+ * Link to a resource
+ */
+interface MCPResourceLink {
+    /** URL or path to the resource */
+    href: string;
+    /** Display text for the link */
+    label: string;
+    /** Type of resource */
+    type?: 'patient' | 'document' | 'appointment' | 'order' | 'provider' | 'external' | 'internal';
+    /** Icon name or component */
+    icon?: string;
+}
+/**
+ * MCP Resource definition
+ */
+interface MCPResource {
+    /** Unique identifier */
+    id: string;
+    /** Resource type (e.g., 'patient', 'appointment', 'document') */
+    type: string;
+    /** Display name */
+    name: string;
+    /** URL to access the resource */
+    uri?: string;
+    /** Brief description */
+    description?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Role of the message sender
+ */
+type AIMessageRole = 'user' | 'assistant' | 'system' | 'tool';
+/**
+ * Status of an AI message
+ */
+type AIMessageStatus = 'pending' | 'streaming' | 'complete' | 'error';
+/**
+ * Content block within a message
+ */
+interface AIMessageContent {
+    /** Type of content */
+    type: 'text' | 'tool_use' | 'tool_result' | 'thinking' | 'code' | 'image' | 'file' | 'audio' | 'video';
+    /** Text content (also used as the label for `audio` and `video` blocks) */
+    text?: string;
+    /** Tool call reference */
+    toolCall?: MCPToolCall;
+    /** Language for code blocks */
+    language?: string;
+    /** Whether this content is collapsed by default */
+    collapsed?: boolean;
+    /** Image source URL (for `image` blocks) */
+    imageUrl?: string;
+    /** Alt text / file name (for `image` and `file` blocks) */
+    name?: string;
+    /** File size in bytes (for `file` blocks) */
+    fileSize?: number;
+    /** MIME type (for `file`, `audio`, and `video` blocks) */
+    mimeType?: string;
+    /** Download/open URL (for `file` blocks) */
+    fileUrl?: string;
+    /** Source URL for `audio` blocks */
+    audioUrl?: string;
+    /** Source URL for `video` blocks */
+    videoUrl?: string;
+    /** Duration in seconds for `audio` blocks */
+    duration?: number;
+}
+/**
+ * AI Chat Message
+ */
+interface AIMessage {
+    /** Unique identifier */
+    id: string;
+    /** Role of sender */
+    role: AIMessageRole;
+    /** Message content blocks */
+    content: AIMessageContent[];
+    /** Timestamp */
+    timestamp: Date | string;
+    /** Current status */
+    status: AIMessageStatus;
+    /** Model used (for assistant messages) */
+    model?: string;
+    /** Token usage info */
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/** Context passed to a custom text content renderer. */
+interface AITextRenderContext {
+    /** id of the parent message (useful as a render cache key) */
+    messageId: string;
+    /** true while the message is still streaming */
+    streaming: boolean;
+    /** role of the parent message */
+    role: AIMessage['role'];
+}
+/**
+ * Render-prop for customizing `text` content blocks. Host is responsible
+ * for sanitizing untrusted input.
+ */
+type AIRenderTextContent = (text: string, ctx: AITextRenderContext) => React.ReactNode;
 
 /**
  * SuperChat Types
@@ -248,4 +416,4 @@ interface GenUIBlockPayload {
     props?: unknown;
 }
 
-export type { AttachmentKind as A, ComposerAttachment as C, GenUIBlockPayload as G, Participant as P, SuperChatConversation as S, SuperChatRenderPlugin as a, SuperChatLinkBuilder as b, SuperChatCopyFormat as c, SuperChatRef as d, GenUIPrefetchPolicy as e, GenUIRegistry as f, GenUIWidgetEntry as g, GenUIWidgetProps as h, ParticipantKind as i, ParticipantStatus as j, StandardSchemaV1 as k, SuperChatChannel as l, SuperChatItemType as m, SuperChatMessage as n, SuperChatPluggable as o, SuperChatPluggableList as p };
+export type { AIRenderTextContent as A, ComposerAttachment as C, GenUIBlockPayload as G, MCPResourceLink as M, Participant as P, SuperChatConversation as S, SuperChatRenderPlugin as a, AttachmentKind as b, SuperChatLinkBuilder as c, SuperChatCopyFormat as d, SuperChatRef as e, AIMessageContent as f, AIMessageStatus as g, AITextRenderContext as h, GenUIPrefetchPolicy as i, GenUIRegistry as j, GenUIWidgetEntry as k, GenUIWidgetProps as l, ParticipantKind as m, ParticipantStatus as n, StandardSchemaV1 as o, SuperChatChannel as p, SuperChatItemType as q, SuperChatMessage as r, SuperChatPluggable as s, SuperChatPluggableList as t };