@gntik-ai/chat 0.0.0-stage → 0.7.0

package/dist/index.d.ts

@@ -0,0 +1,829 @@
+
+import { ComponentDoc } from "@gntik-ai/ui";
+import { ComponentType, ReactNode, Ref } from "react";
+//#region src/Attachment/AttachmentChip.d.ts
+/** A file attached to a message or waiting in the composer. */
+interface ChatAttachment {
+  id: string;
+  name: string;
+  /** Size in bytes. */
+  size?: number;
+  /** MIME type; picks the icon (falls back to the extension). */
+  type?: string;
+  /** Image preview URL (e.g. from URL.createObjectURL); shown as a thumbnail for images. */
+  previewUrl?: string;
+  /** Upload progress 0–100 (`null` = indeterminate). Omit when not uploading. */
+  progress?: number | null;
+  /** Upload failed; a string replaces the default message. */
+  error?: boolean | string;
+}
+type AttachmentStatus = 'idle' | 'uploading' | 'error';
+interface AttachmentChipProps {
+  attachment: ChatAttachment;
+  /** `chip` (composer, compact row) or `tile` (message, larger image preview). */
+  variant?: 'chip' | 'tile';
+  /** Shows the remove button. */
+  onRemove?: (id: string) => void;
+  /** Shows a retry button in the error state. */
+  onRetry?: (id: string) => void;
+  disabled?: boolean;
+  className?: string;
+  ref?: Ref<HTMLDivElement>;
+}
+/** Status of an attachment from its progress and error fields. */
+export declare function attachmentStatus(a: ChatAttachment): AttachmentStatus;
+/**
+ * One attached file: image thumbnail or file-type icon, name, size, upload progress
+ * (a progressbar), error with retry, and a remove button.
+ */
+export declare function AttachmentChip({ attachment: a, variant, onRemove, onRetry, disabled, className, ref }: AttachmentChipProps): import("react").JSX.Element;
+//#endregion
+//#region src/Attachment/AttachmentList.d.ts
+interface AttachmentListProps {
+  attachments: ChatAttachment[];
+  /** `chip` for the composer, `tile` for larger image previews in a message. */
+  variant?: 'chip' | 'tile';
+  onRemove?: (id: string) => void;
+  onRetry?: (id: string) => void;
+  disabled?: boolean;
+  /** Accessible name of the list. Default "Attachments". */
+  label?: string;
+  className?: string;
+  ref?: Ref<HTMLUListElement>;
+}
+/** A labelled list of AttachmentChips. Renders nothing when empty. */
+export declare function AttachmentList({ attachments, variant, onRemove, onRetry, disabled, label, className, ref }: AttachmentListProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/Attachment/validateFiles.d.ts
+type AttachmentRejectionReason = 'type' | 'size' | 'count';
+interface AttachmentRejection {
+  file: File;
+  reason: AttachmentRejectionReason;
+  /** Human-readable message (set by ChatComposer from the i18n catalog). */
+  message: string;
+}
+interface ValidateFilesOptions {
+  /** Same syntax as `<input accept>`: ".pdf,.csv,image/*,application/json". */
+  accept?: string;
+  /** Largest allowed file, in bytes. */
+  maxSize?: number;
+  /** Most files allowed in total, counting `current`. */
+  maxFiles?: number;
+  /** Files already attached. */
+  current?: number;
+}
+/** Whether a file matches an `accept` list (extensions, exact MIME types and `type/*`). */
+export declare function matchesAccept(file: Pick<File, 'name' | 'type'>, accept?: string): boolean;
+/** Splits files into accepted ones and rejections (without messages) by type, size and count. */
+export declare function validateFiles(files: File[], { accept, maxSize, maxFiles, current }: ValidateFilesOptions): {
+  accepted: File[];
+  rejected: {
+    file: File;
+    reason: AttachmentRejectionReason;
+  }[];
+};
+//#endregion
+//#region src/Attachment/attachment.variants.d.ts
+/** Slot classes for AttachmentChip / AttachmentList. */
+export declare const attachmentStyles: {
+  readonly list: "flex flex-wrap gap-1.5";
+  readonly item: "min-w-0";
+  readonly chip: string;
+  readonly tile: string;
+  readonly media: "grid size-7 shrink-0 place-items-center overflow-hidden rounded bg-background text-muted-foreground";
+  readonly mediaError: "text-destructive-text";
+  readonly tileMedia: "grid aspect-square w-full place-items-center overflow-hidden bg-secondary/50 text-muted-foreground";
+  readonly img: "size-full object-cover";
+  readonly text: "flex min-w-0 flex-1 flex-col leading-4";
+  readonly tileText: "flex min-w-0 flex-col gap-0.5 px-2 py-1.5 leading-4";
+  readonly name: "truncate font-medium";
+  readonly meta: "truncate font-mono text-[10.5px] text-muted-foreground";
+  readonly metaError: "truncate text-[11px] text-destructive-chip-text";
+  readonly button: "grid size-6 shrink-0 place-items-center rounded text-muted-foreground hover:bg-foreground/10 hover:text-foreground disabled:pointer-events-none disabled:opacity-50 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring";
+  readonly tileActions: "absolute end-1 top-1 flex gap-0.5 rounded-md bg-card/90";
+  readonly track: "absolute inset-x-0 bottom-0 h-0.5 bg-border";
+  readonly bar: "h-full bg-primary transition-[width] duration-200 motion-reduce:transition-none";
+  readonly barIndeterminate: "h-full w-1/3 bg-primary animate-pulse motion-reduce:animate-none";
+};
+//#endregion
+//#region src/Attachment/Attachment.doc.d.ts
+declare const doc: ComponentDoc;
+//#endregion
+//#region src/ChatComposer/ChatComposer.d.ts
+/** A file in the composer: name and size, plus optional type, preview, progress and error. */
+type ComposerAttachment = ChatAttachment;
+interface ChatComposerProps {
+  /** Controlled text. Pair with `onValueChange`. */
+  value?: string;
+  defaultValue?: string;
+  onValueChange?: (value: string) => void;
+  /** Called with the trimmed text when the user sends. Uncontrolled composers clear themselves. */
+  onSubmit: (text: string, attachments: ComposerAttachment[]) => void;
+  /** A reply is streaming: Send turns into Stop, Enter no longer sends, Escape stops. */
+  streaming?: boolean;
+  onStop?: () => void;
+  disabled?: boolean;
+  placeholder?: string;
+  /** Accessible name of the text box. */
+  label?: string;
+  /** Soft limit: shows a counter near the limit and blocks sending above it. */
+  maxLength?: number;
+  /** Attached files shown as removable chips (thumbnail, progress, error + retry). */
+  attachments?: ComposerAttachment[];
+  /**
+   * Shows the attach button and enables paste and drag-and-drop of files; called with the
+   * files that pass `accept`, `maxSize` and `maxFiles`.
+   */
+  onAttach?: (files: File[]) => void;
+  onRemoveAttachment?: (id: string) => void;
+  /** Shows Retry on attachments in the error state. */
+  onRetryAttachment?: (id: string) => void;
+  /** Allowed types, `<input accept>` syntax (e.g. ".pdf,.csv,image/*"). Also checked on paste and drop. */
+  accept?: string;
+  /** Largest allowed file, in bytes. */
+  maxSize?: number;
+  /** Most files attached at once. */
+  maxFiles?: number;
+  /** Called with the files that failed validation (their messages are also shown under the box). */
+  onReject?: (rejections: AttachmentRejection[]) => void;
+  /** Slot left of the send button, e.g. a model Select. */
+  modelPicker?: ReactNode;
+  /** Extra tools after the attach button. */
+  tools?: ReactNode;
+  /** Small line under the box. Defaults to the keyboard hint; pass null to hide it. */
+  hint?: ReactNode;
+  className?: string;
+  ref?: Ref<HTMLTextAreaElement>;
+}
+/**
+ * Message box for a chat: grows with its content, Enter sends and Shift+Enter adds a line,
+ * files (picked, pasted or dropped, validated against accept / maxSize / maxFiles) show as
+ * removable chips with previews and upload progress, a model picker can sit in the toolbar, and while a reply
+ * streams the send button becomes Stop (Escape also stops).
+ */
+export declare function ChatComposer({ value, defaultValue, onValueChange, onSubmit, streaming, onStop, disabled, placeholder: placeholderProp, label: labelProp, maxLength, attachments, onAttach, onRemoveAttachment, onRetryAttachment, accept, maxSize, maxFiles, onReject, modelPicker, tools, hint, className, ref }: ChatComposerProps): import("react").JSX.Element;
+//#endregion
+//#region src/ChatComposer/chatComposer.variants.d.ts
+/** Slot classes for ChatComposer (focus ring on the frame, like the legacy composer). */
+export declare const chatComposerStyles: {
+  readonly root: string;
+  readonly dropOverlay: "pointer-events-none absolute inset-0 z-10 flex items-center justify-center gap-2 rounded-xl border-2 border-dashed border-primary/60 bg-card/95 text-[13px] font-medium text-primary-text";
+  readonly errors: "mx-3 mt-3 flex items-start gap-2 rounded-md border border-destructive/40 bg-destructive/8 px-2.5 py-1.5 text-[12px] text-destructive-chip-text";
+  readonly errorList: "flex min-w-0 flex-1 flex-col gap-0.5";
+  readonly errorDismiss: "-me-1 grid size-5 shrink-0 place-items-center rounded text-destructive-chip-text hover:bg-foreground/10 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring";
+  readonly attachments: "flex flex-wrap gap-1.5 px-3 pt-3";
+  /** @deprecated Chips render AttachmentChip (see attachmentStyles). */
+  readonly chip: "inline-flex h-7 max-w-60 items-center gap-1.5 rounded-md border border-border bg-secondary/50 ps-2 pe-1 text-[12px] text-foreground";
+  readonly chipName: "truncate font-medium";
+  readonly chipSize: "shrink-0 font-mono text-[10.5px] text-muted-foreground";
+  readonly chipRemove: "grid size-5 shrink-0 place-items-center rounded text-muted-foreground hover:bg-foreground/10 hover:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring";
+  readonly textarea: string;
+  readonly toolbar: "flex items-center justify-between gap-2 px-2 pb-2";
+  readonly tools: "flex min-w-0 items-center gap-1";
+  readonly end: "flex shrink-0 items-center gap-2";
+  readonly count: "font-mono text-[11px] text-muted-foreground tabular-nums";
+  readonly countOver: "text-destructive-text";
+  readonly hint: "mt-1.5 px-1 text-center text-[11.5px] text-muted-foreground";
+};
+//#endregion
+//#region src/ChatComposer/ChatComposer.doc.d.ts
+declare const doc$1: ComponentDoc;
+//#endregion
+//#region src/ChatDemo/ChatDemo.d.ts
+interface ChatDemoProps {
+  /** Show the resizable details panel. */
+  withPanel?: boolean;
+  /** Milliseconds between streamed chunks. */
+  tickMs?: number;
+  className?: string;
+}
+/**
+ * End-to-end example: suggestions, a user turn with attachments, a tool call, a streamed
+ * markdown reply with sources, Stop, Regenerate and feedback, and a compact model picker. Streaming is mocked with timers that are cleared on
+ * Stop and on unmount.
+ */
+export declare function ChatDemo({ withPanel, tickMs, className }: ChatDemoProps): import("react").JSX.Element;
+//#endregion
+//#region src/ChatDemo/ChatDemo.doc.d.ts
+declare const doc$2: ComponentDoc;
+//#endregion
+//#region src/ChatLayout/ChatLayout.d.ts
+interface ChatLayoutProps {
+  /** The messages (ChatMessage list, suggestions, …). */
+  children?: ReactNode;
+  /** Pinned at the bottom of the thread column, outside the scroll area (usually ChatComposer). */
+  composer?: ReactNode;
+  /** Optional header above the thread (title, model, actions). */
+  header?: ReactNode;
+  /** Optional side panel (artifact preview, details). Omit to hide it and its resize handle. */
+  panel?: ReactNode;
+  /** Accessible name of the side panel landmark. */
+  panelLabel?: string;
+  /** Initial panel width in px. */
+  defaultPanelWidth?: number;
+  minPanelWidth?: number;
+  maxPanelWidth?: number;
+  onPanelWidthChange?: (width: number) => void;
+  /** Accessible name of the thread region. */
+  label?: string;
+  /** Label of the "jump to latest" button. */
+  scrollButtonLabel?: string;
+  /** Extra classes on the root. */
+  className?: string;
+  /** Extra classes on the centred content column. */
+  contentClassName?: string;
+  ref?: Ref<HTMLDivElement>;
+}
+/**
+ * Full-height chat frame: a scrollable thread with auto-scroll that respects scrolling up,
+ * a "jump to latest" button, the composer pinned below, and an optional side panel that the
+ * user can resize by dragging or with the arrow keys on its separator.
+ */
+export declare function ChatLayout({ children, composer, header, panel, panelLabel: panelLabelProp, defaultPanelWidth, minPanelWidth, maxPanelWidth, onPanelWidthChange, label: labelProp, scrollButtonLabel: scrollButtonLabelProp, className, contentClassName, ref }: ChatLayoutProps): import("react").JSX.Element;
+//#endregion
+//#region src/ChatLayout/chatLayout.variants.d.ts
+/** Slot classes for ChatLayout (plain strings: this package does not ship tailwind-variants). */
+export declare const chatLayoutStyles: {
+  readonly root: "flex h-full min-h-0 w-full bg-background text-foreground";
+  readonly thread: "flex min-w-0 flex-1 flex-col";
+  readonly header: "shrink-0 border-b border-border";
+  readonly viewport: "relative min-h-0 flex-1";
+  readonly scroller: "h-full overflow-y-auto overscroll-contain focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring focus-visible:-outline-offset-2";
+  readonly content: "mx-auto flex w-full max-w-3xl flex-col gap-6 px-4 py-6 sm:px-6";
+  readonly jump: "pointer-events-none absolute inset-x-0 bottom-3 flex justify-center";
+  readonly jumpButton: "pointer-events-auto rounded-full shadow-md";
+  readonly composer: "shrink-0 bg-background px-4 pb-4 pt-2 sm:px-6";
+  readonly composerInner: "mx-auto w-full max-w-3xl";
+  readonly handle: string;
+  readonly panel: "flex min-h-0 shrink-0 flex-col overflow-hidden border-s border-border bg-card";
+};
+//#endregion
+//#region src/ChatLayout/ChatLayout.doc.d.ts
+declare const doc$3: ComponentDoc;
+//#endregion
+//#region src/ChatMessage/ChatMessage.d.ts
+/**
+ * Who wrote a turn. `participant` is another person in the conversation (a teammate, an agent
+ * handing over): not the current user and not the assistant.
+ */
+type ChatRole = 'user' | 'assistant' | 'participant' | 'system' | 'tool';
+type ChatFeedback = 'up' | 'down' | null;
+interface ChatMessageProps {
+  role: ChatRole;
+  /** Display name; defaults per role ("You", "Assistant", "Participant", "System", "Tool"). Pass it for `participant`. */
+  author?: string;
+  /** Replaces the default avatar. Pass `null` to hide it. */
+  avatar?: ReactNode;
+  /** Image URL for the default avatar of `user` and `participant` turns (initials show while it loads or if it fails). */
+  avatarSrc?: string;
+  /** When the message was sent. A Date renders as a local short time. */
+  timestamp?: Date | string;
+  /** The body: a string, a <Markdown>, a ToolCallCard… */
+  children?: ReactNode;
+  /**
+   * Text is still arriving: marks the message aria-busy, hides the actions, shows a
+   * TypingIndicator while empty and a caret after plain-text children (a streaming
+   * <Markdown> draws its own caret).
+   */
+  streaming?: boolean;
+  /** Draw the caret after streamed plain-text children. Default true. */
+  showCaret?: boolean;
+  /** Plain text to copy; shows the Copy action. */
+  copyText?: string;
+  /** Shows the Retry action (assistant replies). */
+  onRetry?: () => void;
+  /** Current feedback (controlled). */
+  feedback?: ChatFeedback;
+  /** Shows the thumbs; called with the new value (clicking the active thumb clears it). */
+  onFeedback?: (value: ChatFeedback) => void;
+  /** Extra actions appended to the action group. */
+  actions?: ReactNode;
+  /** Keep the actions visible instead of revealing them on hover/focus. */
+  alwaysShowActions?: boolean;
+  className?: string;
+  ref?: Ref<HTMLElement>;
+}
+/**
+ * One turn in a conversation. User turns are right-aligned bubbles, participant turns (another
+ * person) are start-aligned outlined bubbles, assistant turns are full-width prose, system notes are centred pills and tool turns hold a ToolCallCard. Copy,
+ * retry and feedback actions appear on hover or keyboard focus and are reachable with Tab.
+ */
+export declare function ChatMessage({ role, author, avatar, avatarSrc, timestamp, children, streaming, showCaret, copyText, onRetry, feedback, onFeedback, actions, alwaysShowActions, className, ref }: ChatMessageProps): import("react").JSX.Element;
+//#endregion
+//#region src/ChatMessage/ChatAnnouncer.d.ts
+interface ChatAnnouncerProps {
+  /** A reply is being generated. */
+  streaming: boolean;
+  /** Plain text of the latest completed reply (announced once, when streaming ends). */
+  lastReply?: string;
+  /** Who is replying, used in the "is responding" status. */
+  author?: string;
+  /** Max characters of the completed reply to announce. */
+  maxLength?: number;
+}
+/**
+ * Screen-reader strategy for streaming: the thread itself is not a live region (it would
+ * re-announce every token). This single polite, atomic status says "Assistant is responding…"
+ * when a stream starts and reads the finished reply once when it ends.
+ */
+export declare function ChatAnnouncer({ streaming, lastReply, author, maxLength }: ChatAnnouncerProps): import("react").JSX.Element;
+//#endregion
+//#region src/ChatMessage/chatMessage.variants.d.ts
+/** Slot classes for ChatMessage, per role. */
+export declare const chatMessageStyles: {
+  readonly root: "group/message relative flex gap-3 outline-none";
+  readonly avatar: "mt-0.5 shrink-0";
+  readonly body: "flex min-w-0 flex-1 flex-col gap-1";
+  readonly meta: "flex items-baseline gap-2 text-[12px] leading-5";
+  readonly author: "font-semibold text-foreground";
+  readonly time: "font-mono text-[11px] text-muted-foreground";
+  readonly content: "min-w-0 text-[14px] leading-[1.7] text-foreground";
+  readonly actions: string;
+  readonly actionsVisible: "opacity-100";
+  /** @deprecated The empty streaming state renders TypingIndicator (see typingIndicatorStyles). */
+  readonly typing: "inline-flex h-6 items-center gap-1";
+  /** @deprecated See typingIndicatorStyles.dot. */
+  readonly typingDot: "size-1.5 rounded-full bg-muted-foreground animate-pulse motion-reduce:animate-none";
+  readonly role: {
+    readonly user: {
+      readonly root: "flex-row-reverse";
+      readonly body: "items-end";
+      readonly meta: "flex-row-reverse";
+      readonly content: "max-w-[85%] rounded-2xl rounded-se-md bg-secondary px-4 py-2.5 whitespace-pre-wrap [overflow-wrap:anywhere]";
+    };
+    readonly assistant: {
+      readonly root: "";
+      readonly body: "";
+      readonly meta: "";
+      readonly content: "";
+    };
+    readonly participant: {
+      readonly root: "";
+      readonly body: "items-start";
+      readonly meta: "";
+      readonly content: "max-w-[85%] rounded-2xl rounded-ss-md border border-border bg-card px-4 py-2.5 whitespace-pre-wrap [overflow-wrap:anywhere]";
+    };
+    readonly system: {
+      readonly root: "justify-center";
+      readonly body: "items-center";
+      readonly meta: "sr-only";
+      readonly content: "rounded-full border border-border bg-card px-3 py-1 text-center text-[12px] leading-5 text-muted-foreground";
+    };
+    readonly tool: {
+      readonly root: "";
+      readonly body: "";
+      readonly meta: "";
+      readonly content: "text-[13px]";
+    };
+  };
+};
+//#endregion
+//#region src/ChatMessage/ChatMessage.doc.d.ts
+declare const doc$4: ComponentDoc;
+//#endregion
+//#region src/Citation/Citation.d.ts
+interface CitationSource {
+  /** Source title. */
+  title: string;
+  /** Where it lives; shown as its host name and linked. */
+  url?: string;
+  /** Short excerpt that supports the claim. */
+  snippet?: string;
+  /** Publisher or site name; defaults to the URL host. */
+  publisher?: string;
+}
+/** Host name of a URL ("docs.example.com"), or undefined if it cannot be parsed. */
+export declare function sourceHost(url?: string): string | undefined;
+/** Only http(s) sources become links. */
+export declare function safeSourceUrl(url?: string): string | undefined;
+interface CitationProps {
+  /** 1-based number shown in the marker. */
+  index: number;
+  source: CitationSource;
+  /** Hover delay before the preview opens (keyboard and click open it immediately). */
+  delay?: number;
+  className?: string;
+}
+/**
+ * Inline numbered reference ([1]). Hovering, focusing + Enter or clicking opens a preview
+ * card with the title, host, snippet and a link to the source.
+ */
+export declare function Citation({ index, source, delay, className }: CitationProps): import("react").JSX.Element;
+interface CitationListProps {
+  sources: CitationSource[];
+  /** Visible heading; also the list's accessible name. */
+  heading?: ReactNode;
+  className?: string;
+}
+/** Numbered list of the sources cited in a reply, matching the inline markers. */
+export declare function CitationList({ sources, heading: headingProp, className }: CitationListProps): import("react").JSX.Element | null;
+//#endregion
+//#region src/Citation/citation.variants.d.ts
+/** Slot classes for Citation and CitationList. */
+export declare const citationStyles: {
+  readonly trigger: string;
+  readonly popup: "w-80";
+  readonly head: "flex items-center gap-2 text-[11.5px] text-muted-foreground";
+  readonly index: "grid h-[18px] min-w-[18px] place-items-center rounded-md bg-secondary px-1 font-mono text-[10.5px] font-semibold text-foreground";
+  readonly title: "mt-1.5 text-[13px] font-semibold leading-snug text-foreground";
+  readonly snippet: "mt-1 line-clamp-4 text-[12.5px] leading-relaxed text-muted-foreground";
+  readonly open: "mt-2.5 inline-flex items-center gap-1 rounded-sm text-[12.5px] font-medium text-primary-text hover:underline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring";
+  readonly list: "flex flex-col gap-1.5";
+  readonly heading: "mb-1 text-[11.5px] font-semibold tracking-wide text-muted-foreground uppercase";
+  readonly item: "flex gap-2.5 rounded-lg border border-border bg-card px-3 py-2.5";
+  readonly itemBody: "min-w-0 flex-1";
+  readonly itemTitle: "rounded-sm text-[13px] font-medium text-foreground hover:text-primary-text hover:underline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring";
+  readonly itemHost: "mt-0.5 truncate font-mono text-[11px] text-muted-foreground";
+};
+//#endregion
+//#region src/Citation/Citation.doc.d.ts
+declare const doc$5: ComponentDoc;
+//#endregion
+//#region src/Markdown/Markdown.d.ts
+interface MarkdownProps {
+  /** Markdown source (GitHub-flavoured: tables, task lists, strikethrough, autolinks). */
+  children: string;
+  /** Text is still arriving: closes a dangling code fence and draws the caret. */
+  streaming?: boolean;
+  className?: string;
+}
+/**
+ * URL policy: relative URLs, anchors and http(s)/mailto/tel only. Everything else
+ * (javascript:, data:, vbscript:, …) is dropped, on top of react-markdown's own transform.
+ */
+export declare function safeUrl(url: string): string;
+/**
+ * Makes partial streamed markdown render sanely: a fence that has opened but not closed is
+ * closed at the end, so the tail renders as code instead of flashing as paragraphs.
+ */
+export declare function repairStreamingMarkdown(text: string): string;
+/**
+ * Safe markdown for model output: raw HTML is never rendered (skipped, not parsed), links are
+ * restricted to http(s)/mailto/tel/relative, external links open in a new tab with a marker,
+ * and fenced code gets a copy button. Partial input from a stream is tolerated.
+ */
+export declare const Markdown: import("react").MemoExoticComponent<({ children, streaming, className }: MarkdownProps) => import("react").JSX.Element>;
+//#endregion
+//#region src/Markdown/CodeBlock.d.ts
+interface CodeBlockProps {
+  /** Source text. */
+  code: string;
+  /** Language tag from the fence (```ts). */
+  language?: string;
+  className?: string;
+}
+/** Fenced code with a language label and a copy button. */
+export declare function CodeBlock({ code, language, className }: CodeBlockProps): import("react").JSX.Element;
+//#endregion
+//#region src/Markdown/markdown.variants.d.ts
+/**
+ * Blinking caret drawn after the last block while text streams in. Pure CSS (an ::after on the
+ * last child), so it follows paragraphs, list items and code without extra DOM.
+ */
+export declare const streamingCaretClass: string;
+/** Element classes for Markdown (token colours only). */
+export declare const markdownStyles: {
+  readonly root: "min-w-0 text-[14px] leading-[1.7] text-foreground [overflow-wrap:anywhere] [&>:first-child]:mt-0 [&>:last-child]:mb-0";
+  readonly h1: "mt-5 mb-2 text-[18px] font-semibold tracking-tight";
+  readonly h2: "mt-5 mb-2 text-[16px] font-semibold tracking-tight";
+  readonly h3: "mt-4 mb-1.5 text-[14.5px] font-semibold";
+  readonly h4: "mt-4 mb-1.5 text-[13.5px] font-semibold text-muted-foreground";
+  readonly p: "my-2.5";
+  readonly ul: "my-2.5 list-disc space-y-1 ps-5 marker:text-muted-foreground";
+  readonly ol: "my-2.5 list-decimal space-y-1 ps-5 marker:text-muted-foreground";
+  readonly li: "ps-1 [&>ul]:my-1 [&>ol]:my-1 [&.task-list-item]:list-none [&.task-list-item]:-ms-5";
+  readonly blockquote: "my-3 border-s-2 border-primary/50 ps-3.5 text-muted-foreground";
+  readonly hr: "my-5 border-border";
+  readonly link: "rounded-sm font-medium text-primary-text underline decoration-primary/40 underline-offset-2 hover:decoration-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring";
+  readonly linkIcon: "ms-0.5 inline-block align-[-1px]";
+  readonly inlineCode: "rounded-md border border-border bg-secondary/60 px-1.5 py-px font-mono text-[12.5px]";
+  readonly tableWrap: "my-3 overflow-x-auto rounded-lg border border-border";
+  readonly table: "w-full border-collapse text-start text-[13px]";
+  readonly th: "border-b border-border bg-secondary/50 px-3 py-2 font-semibold";
+  readonly td: "border-b border-border px-3 py-2 align-top [tr:last-child_&]:border-b-0";
+  readonly checkbox: "me-1.5 align-[-2px] accent-primary";
+  readonly image: "text-muted-foreground italic";
+  readonly code: {
+    readonly root: "my-3 overflow-hidden rounded-lg border border-border bg-secondary/40";
+    readonly header: "flex h-9 items-center justify-between border-b border-border bg-secondary/50 ps-3 pe-1.5";
+    readonly lang: "font-mono text-[11px] tracking-wide text-muted-foreground uppercase";
+    readonly pre: "overflow-x-auto p-3 font-mono text-[12.5px] leading-6";
+  };
+};
+//#endregion
+//#region src/Markdown/Markdown.doc.d.ts
+declare const doc$6: ComponentDoc;
+//#endregion
+//#region src/MessageFeedback/MessageFeedback.d.ts
+type FeedbackRating = 'up' | 'down';
+interface FeedbackValue {
+  /** `null` = no rating. */
+  rating: FeedbackRating | null;
+  /** Reason picked after a thumbs down (a `FeedbackReason.value`). */
+  reason?: string;
+  /** Free-text comment after a thumbs down. */
+  comment?: string;
+}
+interface FeedbackReason {
+  value: string;
+  label: string;
+}
+interface MessageFeedbackProps {
+  /** Current feedback (controlled). Uncontrolled when omitted. */
+  value?: FeedbackValue;
+  /**
+   * Called on every change: `{ rating: 'up' }`, `{ rating: 'down' }` right away on thumbs down,
+   * then `{ rating: 'down', reason, comment }` when the details form is sent, and
+   * `{ rating: null }` when the active thumb is pressed again.
+   */
+  onFeedback?: (value: FeedbackValue) => void;
+  /** Reasons offered after a thumbs down. Defaults to a generic list; `[]` hides the picker. */
+  reasons?: FeedbackReason[];
+  /** Open the reason/comment popover on thumbs down. Default true. */
+  askDetails?: boolean;
+  /** Plain text to copy; shows the Copy action. */
+  copyText?: string;
+  /** Shows the Regenerate action. */
+  onRegenerate?: () => void;
+  /** Accessible name of the group. Default "Response feedback". */
+  label?: string;
+  disabled?: boolean;
+  className?: string;
+  ref?: Ref<HTMLDivElement>;
+}
+/**
+ * Feedback for an assistant reply: thumbs up / down toggles (aria-pressed), and on thumbs down
+ * a popover asking for a reason and an optional comment. Copy and Regenerate sit alongside.
+ */
+export declare function MessageFeedback({ value: valueProp, onFeedback, reasons: reasonsProp, askDetails, copyText, onRegenerate, label, disabled, className, ref }: MessageFeedbackProps): import("react").JSX.Element;
+//#endregion
+//#region src/MessageFeedback/messageFeedback.variants.d.ts
+/** Slot classes for MessageFeedback. */
+export declare const messageFeedbackStyles: {
+  readonly root: "inline-flex items-center gap-0.5";
+  readonly up: "text-primary-text";
+  readonly down: "text-destructive-text";
+  readonly popup: "w-80 max-w-[calc(100vw-2rem)]";
+  readonly form: "flex flex-col gap-3";
+  readonly title: "text-[13px] font-semibold text-foreground";
+  readonly label: "mb-1.5 block text-[12.5px] font-medium text-foreground";
+  readonly footer: "flex justify-end gap-2";
+};
+//#endregion
+//#region src/MessageFeedback/MessageFeedback.doc.d.ts
+declare const doc$7: ComponentDoc;
+//#endregion
+//#region src/ModelPicker/ModelPicker.d.ts
+type ModelCapability = 'vision' | 'tools' | 'reasoning' | 'files' | 'web' | 'audio';
+interface ChatModel {
+  /** Value reported by `onValueChange`. */
+  id: string;
+  name: string;
+  /** Group heading, e.g. the provider or the deployment. Models are grouped in first-seen order. */
+  provider: string;
+  description?: string;
+  capabilities?: ModelCapability[];
+  /** Context window in tokens; shown as "128K context". */
+  contextWindow?: number;
+  disabled?: boolean;
+  /** Why it is disabled ("Needs an upgraded plan"); shown under the name. */
+  disabledReason?: string;
+}
+interface ModelPickerProps {
+  models: ChatModel[];
+  /** Selected model id (controlled). */
+  value: string | null;
+  onValueChange: (id: string) => void;
+  /** Small borderless trigger with only the model name, for the composer toolbar. */
+  compact?: boolean;
+  /** Accessible name of the trigger. Default "Model". */
+  label?: string;
+  placeholder?: string;
+  disabled?: boolean;
+  /** Hide the provider next to the name in the full trigger. */
+  hideProvider?: boolean;
+  className?: string;
+  ref?: Ref<HTMLButtonElement>;
+}
+/** Models grouped by provider, keeping first-seen order. */
+export declare function groupModels(models: ChatModel[]): {
+  provider: string;
+  items: ChatModel[];
+}[];
+/**
+ * Model / provider select for a chat: options grouped by provider with capability badges
+ * (vision, tools, context size…) and disabled models that say why. `compact` renders a small
+ * borderless trigger for the composer toolbar. Built on Select (Base UI).
+ */
+export declare function ModelPicker({ models, value, onValueChange, compact, label, placeholder, disabled, hideProvider, className, ref }: ModelPickerProps): import("react").JSX.Element;
+//#endregion
+//#region src/ModelPicker/modelPicker.variants.d.ts
+/** Slot classes for ModelPicker. */
+export declare const modelPickerStyles: {
+  readonly trigger: "w-auto max-w-full min-w-0";
+  readonly compactTrigger: "h-7 w-auto max-w-56 min-w-0 gap-1 border-transparent bg-transparent ps-2 pe-1.5 shadow-none hover:bg-secondary/70 hover:border-transparent";
+  readonly triggerValue: "flex min-w-0 items-center gap-1.5";
+  readonly triggerIcon: "shrink-0 text-muted-foreground";
+  readonly triggerName: "truncate font-medium";
+  readonly triggerProvider: "truncate text-muted-foreground";
+  readonly popup: "w-80 max-w-[calc(100vw-2rem)]";
+  readonly item: "items-start";
+  readonly itemBody: "flex min-w-0 flex-col gap-1 py-0.5 whitespace-normal";
+  readonly itemName: "font-medium text-foreground";
+  readonly itemDescription: "text-[11.5px] leading-4 text-muted-foreground";
+  readonly badges: "flex flex-wrap gap-1";
+  readonly reason: "text-[11.5px] leading-4 text-muted-foreground italic";
+};
+//#endregion
+//#region src/ModelPicker/fixtures.d.ts
+/** Generic, product-agnostic models for examples and the demo. */
+export declare const DEMO_MODELS: ChatModel[];
+//#endregion
+//#region src/ModelPicker/ModelPicker.doc.d.ts
+declare const doc$8: ComponentDoc;
+//#endregion
+//#region src/SuggestionChips/SuggestionChips.d.ts
+type IconComponent = ComponentType<{
+  size?: number;
+  className?: string;
+  'aria-hidden'?: boolean;
+}>;
+interface Suggestion {
+  /** Stable key; defaults to the label. */
+  id?: string;
+  /** Short title shown on the chip. */
+  label: string;
+  /** Second line (card layout only). */
+  description?: string;
+  /** Prompt sent when chosen; defaults to the label. */
+  prompt?: string;
+  icon?: IconComponent;
+}
+interface SuggestionChipsProps {
+  suggestions: ReadonlyArray<Suggestion | string>;
+  onSelect: (prompt: string, suggestion: Suggestion) => void;
+  /** `cards` (two-column grid with descriptions) for an empty thread, `chips` (pills) for follow-ups. */
+  layout?: 'cards' | 'chips';
+  /** Heading above the group; also its accessible name. */
+  heading?: ReactNode;
+  /** Accessible name when there is no visible heading. */
+  label?: string;
+  disabled?: boolean;
+  className?: string;
+}
+/** Prompt suggestions for an empty conversation (cards) or as follow-ups after a reply (chips). */
+export declare function SuggestionChips({ suggestions, onSelect, layout, heading, label: labelProp, disabled, className }: SuggestionChipsProps): import("react").JSX.Element;
+//#endregion
+//#region src/SuggestionChips/suggestionChips.variants.d.ts
+/** Slot classes for SuggestionChips. */
+export declare const suggestionChipsStyles: {
+  readonly root: "w-full";
+  readonly heading: "mb-2.5 text-[12px] font-semibold tracking-wide text-muted-foreground uppercase";
+  readonly grid: "grid gap-2 sm:grid-cols-2";
+  readonly row: "flex flex-wrap gap-2";
+  readonly card: string;
+  readonly chip: string;
+  readonly icon: "mt-0.5 shrink-0 text-muted-foreground group-hover:text-primary-text";
+  readonly label: "block text-[13px] font-medium text-foreground";
+  readonly description: "mt-0.5 block text-[12px] leading-5 text-muted-foreground";
+};
+//#endregion
+//#region src/SuggestionChips/SuggestionChips.doc.d.ts
+declare const doc$9: ComponentDoc;
+//#endregion
+//#region src/ToolCallCard/ToolCallCard.d.ts
+type ToolCallStatus = 'running' | 'succeeded' | 'failed';
+interface ToolCallCardProps {
+  /** Tool / function name, e.g. "search_invoices". */
+  name: string;
+  status: ToolCallStatus;
+  /** Elapsed time in ms. */
+  durationMs?: number;
+  /** Arguments the model passed. */
+  args?: unknown;
+  /** What the tool returned. */
+  result?: unknown;
+  /** Error message for a failed call. */
+  error?: string;
+  /** Start expanded. Failed calls open by default. */
+  defaultOpen?: boolean;
+  /** Controlled open state. */
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  className?: string;
+  ref?: Ref<HTMLDivElement>;
+}
+/**
+ * A tool invocation inside an assistant turn: name, status, duration, and a collapsible body
+ * with the arguments and the result (or error) as small JSON views.
+ */
+export declare function ToolCallCard({ name, status, durationMs, args, result, error, defaultOpen, open, onOpenChange, className, ref }: ToolCallCardProps): import("react").JSX.Element;
+//#endregion
+//#region src/ToolCallCard/JsonView.d.ts
+interface JsonViewProps {
+  /** Section title ("Arguments", "Result"). */
+  label: string;
+  /** Any value: objects are pretty-printed, strings shown as-is. */
+  value: unknown;
+  defaultOpen?: boolean;
+}
+/** A small collapsible, scrollable JSON block. */
+export declare function JsonView({ label, value, defaultOpen }: JsonViewProps): import("react").JSX.Element;
+//#endregion
+//#region src/ToolCallCard/toolCallCard.variants.d.ts
+/** Slot classes for ToolCallCard and JsonView. */
+export declare const toolCallCardStyles: {
+  readonly root: "w-full overflow-hidden rounded-lg border border-border bg-card text-[13px]";
+  readonly trigger: string;
+  readonly icon: "grid size-6 shrink-0 place-items-center rounded-md bg-secondary text-muted-foreground";
+  readonly iconFailed: "bg-destructive/15 text-destructive-chip-text";
+  readonly label: "flex min-w-0 flex-1 items-baseline gap-1.5";
+  readonly verb: "shrink-0 text-muted-foreground";
+  readonly name: "truncate font-mono text-[12.5px] font-semibold text-foreground";
+  readonly meta: "flex shrink-0 items-center gap-2";
+  readonly duration: "font-mono text-[11px] text-muted-foreground tabular-nums";
+  readonly body: "flex flex-col gap-2 border-t border-border px-3 pb-3 pt-1";
+  readonly error: "rounded-md border border-destructive/40 bg-destructive/10 px-3 py-2 text-[12.5px] text-destructive-chip-text";
+  readonly json: {
+    readonly trigger: "mx-0 h-7 px-1 text-[11.5px] font-semibold tracking-wide text-muted-foreground uppercase";
+    readonly content: "pt-1";
+    readonly pre: "max-h-64 overflow-auto rounded-md border border-border bg-secondary/40 p-2.5 font-mono text-[12px] leading-5 text-foreground";
+  };
+};
+//#endregion
+//#region src/ToolCallCard/ToolCallCard.doc.d.ts
+declare const doc$10: ComponentDoc;
+//#endregion
+//#region src/TypingIndicator/TypingIndicator.d.ts
+interface TypingIndicatorProps {
+  /** Who is typing; used in the accessible text ("Assistant is typing"). */
+  author?: string;
+  /** Show the text next to the dots instead of keeping it screen-reader only. */
+  showLabel?: boolean;
+  /** Overrides the text entirely. */
+  label?: string;
+  size?: 'sm' | 'md';
+  /**
+   * Announce the text through its own polite status region. Off by default: in a thread,
+   * ChatAnnouncer already announces "is responding" once.
+   */
+  announce?: boolean;
+  className?: string;
+  ref?: Ref<HTMLSpanElement>;
+}
+/**
+ * Three dots that pulse while a reply is being written. The dots are decorative; the text
+ * ("Assistant is typing") is always in the accessibility tree. Under reduced motion the dots
+ * hold still.
+ */
+export declare function TypingIndicator({ author, showLabel, label, size, announce, className, ref }: TypingIndicatorProps): import("react").JSX.Element;
+//#endregion
+//#region src/TypingIndicator/typingIndicator.variants.d.ts
+/** Slot classes for TypingIndicator. Dots pulse in sequence; static under reduced motion. */
+export declare const typingIndicatorStyles: {
+  readonly root: "inline-flex items-center gap-2 text-muted-foreground";
+  readonly dots: "inline-flex h-6 items-center gap-1";
+  readonly dot: "size-1.5 rounded-full bg-muted-foreground animate-pulse motion-reduce:animate-none";
+  readonly label: "text-[12.5px]";
+  readonly size: {
+    readonly sm: {
+      readonly dots: "h-4 gap-0.5";
+      readonly dot: "size-1";
+    };
+    readonly md: {
+      readonly dots: "";
+      readonly dot: "";
+    };
+  };
+};
+/** Thin blinking caret after streamed plain text (static under reduced motion). */
+export declare const streamingCaret = "ms-0.5 inline-block h-[1.05em] w-[2px] translate-y-[2px] bg-primary animate-pulse motion-reduce:animate-none";
+//#endregion
+//#region src/TypingIndicator/TypingIndicator.doc.d.ts
+declare const doc$11: ComponentDoc;
+//#endregion
+//#region src/useChatScroll/useChatScroll.d.ts
+interface UseChatScrollOptions {
+  /** Distance from the bottom (px) still treated as "at the bottom". */
+  threshold?: number;
+}
+interface UseChatScrollResult {
+  /** Callback ref for the scrolling element. */
+  scrollRef: (el: HTMLElement | null) => void;
+  /** Callback ref for the content inside it (watched for growth, e.g. streamed tokens). */
+  contentRef: (el: HTMLElement | null) => void;
+  /** True while the viewport is pinned to the latest message. */
+  isAtBottom: boolean;
+  /** Scrolls to the latest message and re-pins auto-scroll. */
+  scrollToBottom: (behavior?: ScrollBehavior) => void;
+}
+/**
+ * Auto-scroll for a chat thread that respects the reader: new content keeps the view pinned
+ * to the bottom only while the user is already there. Scrolling up unpins it (and
+ * `isAtBottom` turns false, so a "scroll to latest" button can show); `scrollToBottom()`
+ * pins it again.
+ */
+export declare function useChatScroll({ threshold }?: UseChatScrollOptions): UseChatScrollResult;
+//#endregion
+export { type AttachmentChipProps, type AttachmentListProps, type AttachmentRejection, type AttachmentRejectionReason, type AttachmentStatus, type ChatAnnouncerProps, type ChatAttachment, type ChatComposerProps, type ChatDemoProps, type ChatFeedback, type ChatLayoutProps, type ChatMessageProps, type ChatModel, type ChatRole, type CitationListProps, type CitationProps, type CitationSource, type CodeBlockProps, type ComposerAttachment, type FeedbackRating, type FeedbackReason, type FeedbackValue, type JsonViewProps, type MarkdownProps, type MessageFeedbackProps, type ModelCapability, type ModelPickerProps, type Suggestion, type SuggestionChipsProps, type ToolCallCardProps, type ToolCallStatus, type TypingIndicatorProps, type UseChatScrollOptions, type UseChatScrollResult, type ValidateFilesOptions, doc as attachmentListDoc, doc$1 as chatComposerDoc, doc$2 as chatDemoDoc, doc$3 as chatLayoutDoc, doc$4 as chatMessageDoc, doc$5 as citationDoc, doc$6 as markdownDoc, doc$7 as messageFeedbackDoc, doc$8 as modelPickerDoc, doc$9 as suggestionChipsDoc, doc$10 as toolCallCardDoc, doc$11 as typingIndicatorDoc };
+//# sourceMappingURL=index.d.ts.map