@factorialco/f0-react 10.6.1 → 10.8.0

package/dist/{exports-B1AxzHkB.d.ts → exports-cU26nMV5.d.ts}

@@ -1,5 +1,5 @@
-import { $ as AiChatCreditWarning, $i as WithDataTestIdReturnType, Ct as WelcomeScreenSuggestion, Fi as FileDef, J as AiChatComposerAction, Ln as Level, Nr as CanvasEntityDefinition, Oi as F0AvatarTeamProps, Tr as PersonProfile, Wi as ModuleId, Yi as IconType, bt as TranscribeFn, et as AiChatCredits, fn as RelaxedNumericWithFormatter, hr as DataAttributes, ht as F0AiChatWelcomeCard, jr as CanvasContent, ki as F0AvatarPersonProps, lt as AiChatUsageLimits, nt as AiChatEmployeeCredits, oi as DataDownloadDataset, rt as AiChatFileAttachmentConfig, s as F0CardHorizontalProps, tt as AiChatDisclaimer, un as Numeric, vi as AvatarVariant, vt as PendingContext, wt as WelcomeScreenSuggestionItem, xt as UploadedFile, yt as PendingQuote, zi as F0AvatarCompanyProps } from "./index-CHpMOnlX.js";
-import { CSSProperties, ComponentProps, ReactNode, RefObject, SVGProps } from "react";
+import { $ as AiChatCreditWarning, Ar as AiChatShowFilesItem, Bi as FileDef, Ci as AvatarVariant, Ct as WelcomeScreenSuggestion, Dr as AiChatFileKind, Er as AiChatFile, Ir as CanvasContent, J as AiChatComposerAction, Ln as Level, Ni as F0AvatarTeamProps, Or as AiChatFilePreviewConfig, Pi as F0AvatarPersonProps, Rr as CanvasEntityDefinition, Tr as PersonProfile, Wi as F0AvatarCompanyProps, Yi as ModuleId, bt as TranscribeFn, di as DataDownloadDataset, ea as IconType, et as AiChatCredits, fn as RelaxedNumericWithFormatter, hr as DataAttributes, ht as F0AiChatWelcomeCard, ia as WithDataTestIdReturnType, lt as AiChatUsageLimits, nt as AiChatEmployeeCredits, rt as AiChatFileAttachmentConfig, s as F0CardHorizontalProps, tt as AiChatDisclaimer, un as Numeric, vt as PendingContext, wt as WelcomeScreenSuggestionItem, xt as UploadedFile, yt as PendingQuote } from "./index-BftFpZQm.js";
+import { CSSProperties, ComponentProps, KeyboardEvent, ReactNode, Ref, RefObject, SVGProps } from "react";
 import { AgentState, TrackReferenceOrPlaceholder } from "@livekit/components-react";
 import { VariantProps } from "cva";
 import { LocalAudioTrack, RemoteAudioTrack } from "livekit-client";
@@ -1024,7 +1024,7 @@ type F0AiChatTextAreaProps = {
   /**
    * Optional ReactNode rendered in place of the input. When present the
    * composer enters "clarifying" mode: form submission is blocked, the
-   * gradient border activates, and a nav-hint replaces the disclaimer.
+   * border takes a static accent, and a nav-hint replaces the disclaimer.
    * The host owns the panel (typically `F0ClarifyingPanel`) and its
    * state — F0 just renders the slot.
    */
@@ -1144,7 +1144,7 @@ type F0AiChatTextAreaProps = {
    *   empty space.
    *
    * - `"inside"` — the row moves INTO the field, at its foot, so the field's own
-   *   border and AI focus highlight enclose it and the composer reads as a
+   *   border encloses it and the composer reads as a
    *   single bar about two lines tall. Its popover opens downward, because up is
    *   now the text you are about to type.
    *
@@ -1215,13 +1215,12 @@ type F0AiChatTextAreaProps = {
    *
    * - `"default"` — the gutter the chat layouts expect (16px sides, 8px top,
    *   12px bottom). It is what keeps the field off the chat window's edges and
-   *   leaves room for the focus glow, which bleeds a few pixels outside the
-   *   field's border box.
+   *   leaves room for the surface's shadow.
    *
    * - `"none"` — no inset, for hosts that place the composer inside a container
    *   that already owns the spacing (a landing/home hero, a card). The host then
    *   owns BOTH sides of that bargain: give the composer some room of your own,
-   *   and don't clip overflow around it, or the focus glow gets cut at the edge.
+   *   and don't clip overflow around it, or the surface's shadow gets cut.
    *
    * Only the outer inset changes; the gap between the composer and the blocks
    * below it (suggestions, cards, footer, disclaimer) is unaffected.
@@ -1240,15 +1239,12 @@ type F0AiChatTextAreaProps = {
 //#endregion
 //#region src/addons/ai/ai/F0AiChatTextArea/F0AiChatTextArea.d.ts
 /**
- * Headless chat composer.
- *
- * Owns local UI state (text, cursor, attached files, mention popover) and
- * emits a structured payload via `onSubmit`. The consumer decides what to
- * do with it (forward to CopilotKit, log it, mock it…). It carries no
- * coupling to `useAiChat()` or CopilotKit — wrappers like F0AiChat
- * provide the wiring.
+ * The AI chat's composer for the hosts that render it directly (the home bar,
+ * ticket creation, connected chat inputs): the shared chat composer with the
+ * AI chat around it, and the field named `one-ai-input`, which those hosts
+ * query.
  */
-declare const F0AiChatTextArea: ({ onSubmit, onStop, inProgress, onBeforeSubmit, placeholders, creditWarning, clarifyingUI, pendingContext, onPendingContextChange, pendingQuote, onPendingQuoteChange, fileAttachments, toolbarStart, composerActions, onComposerActionsOpenChange, onTranscribe, searchPersons, mentionSources, onProcessFilesRef, disclaimer, usageLimits, footer, isWelcomeScreen, fullscreen, welcomeScreenSuggestions, onSuggestionClick, welcomeScreenSuggestionsPlacement, welcomeScreenSuggestionsCollapsedByDefault, welcomeScreenCards, padding, ref }: F0AiChatTextAreaProps) => import("react").JSX.Element;
+declare const F0AiChatTextArea: (props: F0AiChatTextAreaProps) => import("react").JSX.Element;
 //#endregion
 //#region src/addons/ai/ai/F0AiChatTextArea/components/DropOverlay.d.ts
 interface DropOverlayProps {
@@ -1274,6 +1270,360 @@ declare function createPersonMentionSource(searchPersons: (query: string) => Pro
   order?: MentionSource["order"];
 }): MentionSource;
 //#endregion
+//#region src/elements/primitives/_primitives/F0ChatComposer/mentions/types.d.ts
+/** One row of the mention popover, as a source returns it. */
+type ComposerMentionItem = {
+  /** What kind of thing it is (`person`, an entity type…). */
+  type: string;
+  id: string;
+  /** Inserted after the `@` and painted as the mention. */
+  label: string;
+  /** Secondary line under the label. */
+  description?: string;
+  /** Leading slot of the row: an avatar, or an icon for entities. */
+  avatar?: AvatarVariant;
+  /** Host data carried through untouched (e.g. a chat user's profile link). */
+  data?: unknown;
+};
+/**
+ * A mention in the composer text, anchored where its `@` is.
+ *
+ * The anchor is maintained across edits instead of being re-derived from the
+ * text, so a mention survives whatever follows it (a comma, the end of the
+ * message) and an edit that lands inside it removes the whole token.
+ */
+type ComposerMention = ComposerMentionItem & {
+  /** Index of the `@` in the composer text. */
+  start: number;
+  /**
+   * Length of the `@label` occurrence as spelled in the text. Recorded rather
+   * than derived from `label.length`: a saved body can spell a name in another
+   * Unicode normal form than the entry does.
+   */
+  length: number;
+};
+/** A mention as the search context exposes it: no extent, no host data. */
+type ComposerMentionRef = {
+  type: string;
+  id: string;
+  label: string;
+  start: number;
+};
+/** What a source knows about the message when it is asked to search. */
+type ComposerMentionSearchContext = {
+  text: string;
+  cursor: number;
+  /** Completed mentions that end before the `@` being typed, in text order. */
+  mentionsBefore: ComposerMentionRef[];
+};
+/** A typed source of mention suggestions: one popover group each. */
+type ComposerMentionSource = {
+  type: string;
+  /** Heading of the group, shown when more than one source is configured. */
+  label: string;
+  search: (query: string, context: ComposerMentionSearchContext) => Promise<ComposerMentionItem[]>;
+  /** Groups sort ascending (`0` when unset); ties keep the array order. */
+  order?: number | ((context: ComposerMentionSearchContext) => number);
+};
+/** A source and the rows it returned for the current query. */
+type ComposerMentionGroup = {
+  source: ComposerMentionSource;
+  items: ComposerMentionItem[];
+};
+/**
+ * A row pinned above every group and matched without a search — the chat's
+ * `@here`. It is not a source: it answers synchronously and never dismisses.
+ */
+type ComposerMentionPinned = {
+  item: ComposerMentionItem;
+  matches: (query: string) => boolean;
+};
+type PopoverPosition = {
+  left: number;
+  bottom: number;
+} | null;
+//#endregion
+//#region src/elements/primitives/_primitives/F0ChatComposer/mentions/useComposerMentions.d.ts
+/** A popover row: the pinned one, or an item from a source's group. */
+type ComposerMentionRow = {
+  item: ComposerMentionItem;
+  /** The source the row came from; absent for the pinned row. */
+  source?: ComposerMentionSource;
+};
+type UseComposerMentionsReturn = {
+  isOpen: boolean;
+  query: string;
+  /** Non-empty groups in display order (the pinned row is not one). */
+  groups: ComposerMentionGroup[];
+  /** Every row in display order: the pinned row first, then the groups'. */
+  rows: ComposerMentionRow[];
+  isLoading: boolean;
+  selectedIndex: number;
+  setSelectedIndex: (index: number) => void;
+  /** Mentions anchored in the current text. */
+  mentions: ComposerMention[];
+  popoverPosition: PopoverPosition;
+  /** Ghost-text completion for the selected row, or null. */
+  inlineCompletion: string | null;
+  /** Handle a keydown — returns true when consumed. */
+  handleKeyDown: (e: React.KeyboardEvent<HTMLTextAreaElement>) => boolean;
+  /** Insert `row` at the active `@`. */
+  selectRow: (row: ComposerMentionRow) => void;
+  /** Replace the anchors from a set of entries found in `forText`. */
+  seedMentions: (entries: ComposerMentionItem[], forText?: string) => void;
+  /** Put back an exact set of anchors for `forText` (undo/redo). */
+  restoreMentions: (anchored: ComposerMention[], forText: string) => void;
+  close: () => void;
+  /** Keep the popover shut for the current `@` until the caret leaves it. */
+  dismissCurrentTrigger: () => void;
+};
+//#endregion
+//#region src/elements/primitives/_primitives/F0ChatComposer/useComposerEditor.d.ts
+type ComposerEditor = {
+  value: string;
+  setValue: (value: string) => void;
+  cursorPosition: number;
+  setCursorPosition: (position: number) => void;
+  textareaRef: React.RefObject<HTMLTextAreaElement>;
+  highlightRef: React.RefObject<HTMLDivElement>;
+  mentions: UseComposerMentionsReturn;
+  /** Field `onChange`. */
+  handleChange: (next: string, cursorPos: number) => void;
+  updateCursorPosition: () => void;
+  syncHighlightScroll: () => void;
+  /** Put the caret at `caret` once `forText` is committed. */
+  requestSelection: (caret: number, forText: string, focus?: boolean) => void;
+  /** Cmd/Ctrl+Z, Shift+Cmd+Z and Ctrl+Y. Returns true when consumed. */
+  handleUndoRedoKeyDown: (e: KeyboardEvent<HTMLTextAreaElement>) => boolean;
+  /**
+   * Escape on a field with text: the first press arms, a second one within
+   * {@link ESCAPE_CLEAR_WINDOW_MS} clears (undoable). An empty field leaves the
+   * key to the host. Returns true when consumed.
+   */
+  handleClearKeyDown: (e: KeyboardEvent<HTMLTextAreaElement>) => boolean;
+  /** Whether the next Escape clears the text. */
+  escapeArmed: boolean;
+  /** Empty the text and its mentions. Undo can bring it back. */
+  clearText: () => void;
+  /** Load a new draft: undo does not walk back into the previous one. */
+  loadDraft: (draft: {
+    value: string;
+    mentions?: ComposerMentionItem[];
+  }) => void;
+  /** Start the undo stack afresh from the next change (after a send). */
+  breakHistory: () => void;
+};
+//#endregion
+//#region src/elements/primitives/_primitives/F0ChatComposer/voice/types.d.ts
+/** Options handed to a {@link ComposerTranscribeFn}. */
+type ComposerTranscribeOptions = {
+  /** Cumulative transcript as it streams in. */
+  onPartial: (text: string) => void;
+  /** Aborted when the user cancels an in-flight transcription. */
+  signal?: AbortSignal;
+};
+/** Transcribes a recorded audio blob to text (voice dictation). */
+type ComposerTranscribeFn = (audio: Blob, options: ComposerTranscribeOptions) => Promise<string>;
+//#endregion
+//#region src/elements/primitives/_primitives/F0ChatComposer/voice/useAudioRecorder.d.ts
+type RecorderStatus = "idle" | "recording" | "transcribing";
+//#endregion
+//#region src/elements/primitives/_primitives/F0ChatComposer/types.d.ts
+/** What the composer hands to `onSend`: the text as typed and its mentions. */
+type F0ChatComposerDraft = {
+  text: string;
+  mentions: ComposerMention[];
+};
+type F0ChatComposerLabels = {
+  /** The field's accessible name, and its placeholder when no `placeholders`. */
+  placeholder: string;
+  /** The placeholder while the microphone is recording. */
+  listening: string;
+  send: string;
+  /** Send, when `sendKind` is `save` (editing a sent message). */
+  save: string;
+  /** Send turned into stop while a response streams (`inProgress`). */
+  stop: string;
+  recordAudio: string;
+  /** The microphone while a voice note uploads (`voice.busy`). */
+  sendingVoice: string;
+  cancelRecording: string;
+  /** The confirm button of a recording: send the note, or transcribe it. */
+  confirmRecording: string;
+  micPermissionDenied: string;
+  micError: string;
+  transcriptionError: string;
+  /** The mention list's accessible name. */
+  mentionSuggestions?: string;
+  /** Second line of the pinned mention row (`@here`). */
+  mentionPinnedDescription?: string;
+};
+/** A second autocomplete next to mentions (emoji `:shortcodes:`). */
+type ComposerAutocomplete = {
+  isOpen: boolean;
+  listboxId: string;
+  activeDescendantId?: string;
+  /** Returns true when it consumed the key. */
+  handleKeyDown: (event: KeyboardEvent<HTMLTextAreaElement>) => boolean;
+  handleFocus?: () => void;
+  handleBlur?: () => void;
+  /** Its list, rendered over the field. */
+  popover: ReactNode;
+};
+type ComposerAutocompletePlugin = {
+  /**
+   * Called on every render with the composer's editor, so it must be a hook
+   * with a stable identity: a module-level function, never an inline one.
+   */
+  useAutocomplete: (editor: ComposerEditor) => ComposerAutocomplete;
+  /** Rewrites a change before it lands (a closed `:shortcode:` → emoji). */
+  transformChange?: (next: string, caret: number) => {
+    value: string;
+    cursorPosition: number;
+  } | null;
+};
+type F0ChatComposerVoice = {
+  /** Dictation: the recording is transcribed into the field. */
+  onTranscribe?: ComposerTranscribeFn;
+  /** Voice notes: the recording is handed over as audio, text untouched. */
+  onAudio?: (audio: Blob, durationMs: number) => void;
+  /** Shown but not usable (editing a sent message). */
+  disabled?: boolean;
+  /** A recording is still being delivered (a voice note uploading). */
+  busy?: boolean;
+  /** The microphone was pressed — before any permission prompt. */
+  onPress?: () => void;
+  /** Capture actually began. */
+  onStarted?: () => void;
+  /** The reader threw a recording away. */
+  onCancelled?: () => void;
+};
+type F0ChatComposerState = {
+  /** No text in the field. */
+  isEmpty: boolean;
+  recorder: RecorderStatus;
+};
+type F0ChatComposerHandle = {
+  /** Focus the field, caret at the end. No-op while `replacement` shows. */
+  focus: (options?: {
+    preventScroll?: boolean;
+  }) => void;
+  /** Empty the text and its mentions (undoable). */
+  clear: () => void;
+  /** Replace the draft; undo does not walk back into the previous one. */
+  loadDraft: (draft: {
+    value: string;
+    mentions?: ComposerMentionItem[];
+  }) => void;
+  /** Insert at the caret (or over the selection) and focus. */
+  insertText: (text: string) => void;
+  /** Throw away a recording or transcription in flight. */
+  cancelRecording: () => void;
+  /** Start the undo stack afresh from the next change. */
+  breakHistory: () => void;
+};
+type F0ChatComposerProps = {
+  /** Called with the draft on Enter or send. Return (or resolve) `false` to
+   * keep the draft; a rejection keeps it too. An async send clears the field
+   * once it resolves, unless the text changed meanwhile: then the field keeps
+   * all of it, the sent part included, for the reader to edit. */
+  onSend: (draft: F0ChatComposerDraft) => void | boolean | Promise<void | boolean>;
+  /** While true, send turns into stop and calls `onStop`. */
+  inProgress?: boolean;
+  onStop?: () => void;
+  /** `save` while editing a sent message. @default "send" */
+  sendKind?: "send" | "save";
+  /** Attachments ready to go: sendable with no text. */
+  hasAttachments?: boolean;
+  /** Send stays disabled (files still uploading). */
+  sendBlocked?: boolean;
+  /** Longer text is refused on send, with `maxLengthError` shown. */
+  maxLength?: number;
+  maxLengthError?: string;
+  /** The host's error (an upload that failed). */
+  error?: string | null;
+  labels?: Partial<F0ChatComposerLabels>;
+  /** Rotating placeholders painted on one line; without them, the native
+   * placeholder shows `labels.placeholder`. */
+  placeholders?: string[];
+  /** Stop typing the placeholders out (a response streams). */
+  placeholdersPaused?: boolean;
+  /** `combobox` (the chat) or `textbox`. @default "combobox" */
+  role?: "combobox" | "textbox";
+  /** The textarea's `name`. */
+  name?: string;
+  mentions?: {
+    sources: ComposerMentionSource[];
+    pinned?: ComposerMentionPinned;
+    /** Results from another scope (a channel) never land in this one. */
+    scopeKey?: string;
+    onInserted?: (item: ComposerMentionItem, options: {
+      pinned: boolean;
+    }) => void;
+    /** Group headings in the list (more than one source). */
+    showGroupLabels?: boolean;
+  };
+  autocomplete?: ComposerAutocompletePlugin;
+  voice?: F0ChatComposerVoice;
+  /** Every change the reader makes to the text. */
+  onTextChange?: (value: string) => void;
+  /** The double Escape cleared the text. */
+  onCleared?: () => void;
+  /** Escape, before the composer's own layers (recording, clear). Return true
+   * when consumed — dismissing a reply chip. */
+  onEscape?: (event: KeyboardEvent<HTMLTextAreaElement>) => boolean;
+  /** ↑ on an empty field. Return true when consumed (edit the last message). */
+  onArrowUpWhenEmpty?: () => boolean;
+  /** Files pasted into the field. Without it, a paste is always text. */
+  onPasteFiles?: (files: File[]) => void;
+  /** A clipboard with text and an image pastes the text. */
+  pastePreferText?: boolean;
+  onStateChange?: (state: F0ChatComposerState) => void;
+  /** Above the field: reply/edit chips, a quoted fragment. */
+  header?: ReactNode;
+  /** Attachments being sent. */
+  tray?: ReactNode;
+  /** Before the text, on its line. */
+  leading?: ReactNode;
+  /** The action row's start: attach, emoji, host controls. Called with the
+   * recorder status so controls can step aside while it transcribes. */
+  toolbarStart?: ReactNode | ((recorder: RecorderStatus) => ReactNode);
+  /** The action row's middle, taking its slack. */
+  toolbarCenter?: ReactNode;
+  /** The action row can collapse (animated). */
+  collapsible?: boolean;
+  /** Collapsed: no action row; microphone and send trail the text. */
+  collapsed?: boolean;
+  /** Shown instead of the field and its rows (a question the reader answers
+   * first). The draft survives it. */
+  replacement?: ReactNode;
+  /** A static accent border. */
+  accent?: boolean;
+  /** Render the surface as a `<form>`: send/stop submit it. */
+  asForm?: boolean;
+  className?: string;
+  surfaceRef?: Ref<HTMLFormElement & HTMLDivElement>;
+  onSurfaceFocus?: () => void;
+  onSurfaceBlur?: () => void;
+  handleRef?: Ref<F0ChatComposerHandle>;
+  reducedMotion?: boolean;
+  "data-testid"?: string;
+};
+//#endregion
+//#region src/elements/primitives/_primitives/F0ChatComposer/F0ChatComposer.d.ts
+/**
+ * The chat composer F0Chat and the AI chat share: a floating surface with
+ * the field (anchored `@mentions`, undo/redo, double Escape to clear, IME-safe
+ * Enter), its error line, the attachments tray, the microphone (dictation or
+ * voice notes) and send — which turns into save while editing and into stop
+ * while a response streams.
+ *
+ * It owns the draft and the keyboard. Everything about where a message goes
+ * stays with the host: `onSend` gets the text and its mentions, and the
+ * slots carry the host's chips, tray and controls.
+ */
+declare const F0ChatComposer: ({ onSend, inProgress, onStop, sendKind, hasAttachments, sendBlocked, maxLength, maxLengthError, error, labels: labelOverrides, placeholders, placeholdersPaused, role, name, mentions: mentionOptions, autocomplete: autocompletePlugin, voice, onTextChange, onCleared, onEscape, onArrowUpWhenEmpty, onPasteFiles, pastePreferText, onStateChange, header, tray, leading, toolbarStart, toolbarCenter, collapsible, collapsed, replacement, accent, asForm, className, surfaceRef, onSurfaceFocus, onSurfaceBlur, handleRef, reducedMotion, "data-testid": testId }: F0ChatComposerProps) => ReactNode;
+//#endregion
 //#region src/addons/ai/ai/F0AiChatUsageLimits/F0AiChatUsageLimitsButton.d.ts
 /**
  * Headless usage-limits popover with its ring trigger. `F0AiChatTextArea`
@@ -1281,6 +1631,89 @@ declare function createPersonMentionSource(searchPersons: (query: string) => Pro
  */
 declare const F0AiChatUsageLimitsButton: ({ usage, error, onOpenChange, trigger, side }: F0AiChatUsageLimitsButtonProps) => import("react").JSX.Element;
 //#endregion
+//#region src/addons/ai/ai/F0AiFileAttachments/adapters.d.ts
+/** An uploaded file as returned by `fileAttachments.onUploadFiles`. */
+declare const aiChatFileFromUploadedFile: (file: UploadedFile) => AiChatFile;
+/**
+ * Every file attached to a message, in order and without duplicates (a
+ * restored thread can carry the same image as a vision line and as a part).
+ * Reads the content parts first and falls back to `rawData.uploadedFiles`.
+ */
+declare const aiChatFilesFromMessage: (message: {
+  content?: unknown;
+  rawData?: unknown;
+}) => AiChatFile[];
+/**
+ * The text of a message. A user message shows only its last text part (the
+ * earlier ones are context the host prepends); an assistant message shows all
+ * of them.
+ */
+declare const aiChatMessageText: (content: unknown, role?: "user" | "assistant") => string | undefined;
+/**
+ * A file from an agent's `showFiles` tool. Those items carry workspace paths;
+ * `urlFor` turns a path into the URL the host serves it from (it is also used
+ * for the PDF rendering in `preview`).
+ */
+declare const aiChatFileFromShowFilesItem: (item: AiChatShowFilesItem, { urlFor }?: {
+  urlFor?: (path: string) => string;
+}) => AiChatFile;
+//#endregion
+//#region src/addons/ai/ai/F0AiFileAttachments/F0AiFileAttachments.d.ts
+type F0AiFileAttachmentsProps = {
+  /** Files to show, in order. Build them with the `aiChatFile*` adapters. */
+  files: AiChatFile[];
+  /**
+   * Which side of the transcript the files sit on: "end" for the person's own
+   * message, "start" for the assistant.
+   * @default "start"
+   */
+  align?: "start" | "end";
+  /**
+   * A file is about to open. Return `false` to handle it yourself (for
+   * example in your own canvas) instead of the built-in viewer.
+   */
+  onOpenFile?: (file: AiChatFile, kind: AiChatFileKind) => void | false;
+  /** A file was downloaded from its chip or full-size card (not from a viewer). */
+  onFileDownloaded?: (file: AiChatFile) => void;
+  /**
+   * "compact" shows small square thumbnails that open the preview on click,
+   * for the files a person sends: they already know what they attached and
+   * only need a glance. "default" lays photos out as an album and documents
+   * as full cards, for files the assistant returns.
+   * @default "default"
+   */
+  size?: "default" | "compact";
+};
+/**
+ * Files in an AI chat message, shown the way F0Chat shows them: photos as an
+ * album that opens a lightbox, documents as cards with a snapshot of their
+ * content that open fullscreen, videos inline, anything else as a download
+ * chip.
+ *
+ * Remote files only get previews when the chat can load them (see
+ * `filePreviews` on the AI chat provider); otherwise they stay as chips, which
+ * is what the chat showed before.
+ */
+declare const F0AiFileAttachmentsComponent: (props: F0AiFileAttachmentsProps) => ReactNode;
+/**
+ * @experimental This is an experimental component use it at your own risk
+ */
+declare const F0AiFileAttachments: typeof F0AiFileAttachmentsComponent;
+//#endregion
+//#region src/addons/ai/ai/F0AiFileAttachments/F0AiFilePreviewsProvider.d.ts
+/**
+ * File previews for an AI chat: how file URLs are loaded, and the image
+ * lightbox and document viewer every file in it opens.
+ *
+ * `F0AiChat` mounts one from its `filePreviews` prop. Hosts that render the
+ * transcript on their own (or need a resolver that only exists deeper in their
+ * tree, below their runtime) can mount another one; the innermost wins.
+ */
+declare const F0AiFilePreviewsProvider: ({ filePreviews, children }: {
+  filePreviews?: AiChatFilePreviewConfig;
+  children: ReactNode;
+}) => ReactNode;
+//#endregion
 //#region src/addons/ai/ai/F0AiPong/F0AiPong.d.ts
 interface F0AiPongProps {
   onClose: () => void;
@@ -1354,4 +1787,4 @@ interface F0AiProcessingOverlayProps {
  */
 declare const F0AiProcessingOverlay: import("react").MemoExoticComponent<({ active, label, className, children }: F0AiProcessingOverlayProps) => import("react").JSX.Element>;
 //#endregion
-export { SparklineDataPoint as $, ThreadActionHandlers as A, F0CanvasCardProps as At, F0AiMessageSource as B, usageLimitsPopoverSides as C, ClarifyingQuestionState as Ct, F0AiChatHistory as D, ResolvedStepAnswer as Dt, CollapsibleGroup as E, ClarifyingStepState as Et, F0AiChatHeader as F, F0AiProposalCardBaseProps as G, F0AiMessageSourcesProps as H, F0AiChatHeaderAction as I, F0AiInsightCard as J, F0AiProposalCardHiddenActions as K, F0AiChatHeaderProps as L, ChatThread as M, useChatHistory as N, DateGroup as O, useCanvasEntity as Ot, F0AiChatCreditsButton as P, F0AiInsightCardProps as Q, F0AiTableCard as R, UsageLimitsPopoverSide as S, ClarifyingOption as St, ThreadItem as T, ClarifyingStepData as Tt, F0AiProposalCard as U, F0AiMessageSources as V, F0AiProposalCardActions as W, BalanceConfig as X, AiInsightCardContent as Y, ContentType as Z, MentionItem as _, F0ActionItem as _t, PongBall as a, F0OneIcon as at, TrackedMention as b, actionItemStatuses as bt, createPersonMentionSource as c, oneIconSizes as ct, AiChatTextAreaUsageLimits as d, F0AuraVoiceAnimation as dt, contentTypes as et, AttachedFile as f, F0AuraVoiceAnimationProps as ft, UserTextPart as g, ChatSpinner as gt, UserBinaryPart as h, MaskOptions as ht, F0CanvasPanelProps as i, F0OneSwitchProps as it, ThreadGroup as j, F0AiChatHistoryProps as k, F0CanvasCard as kt, DropOverlay as l, F0HILActionConfirmation as lt, F0AiChatTextAreaSubmitPayload as m, F0AiMask as mt, F0AiProcessingOverlayProps as n, F0AvatarCompany as nt, F0AiPong as o, F0OneIconProps as ot, F0AiChatTextAreaProps as p, CSSRgbString as pt, F0AiProposalCardProps as q, F0CanvasPanel as r, F0OneSwitch as rt, F0AiChatUsageLimitsButton as s, OneIconSize as st, F0AiProcessingOverlay as t, F0AvatarPerson as tt, F0AiChatTextArea as u, F0HILActionConfirmationProps as ut, MentionSearchContext as v, ActionItemStatus as vt, ThreadListSkeleton as w, ClarifyingSelectionMode as wt, F0AiChatUsageLimitsButtonProps as x, F0ClarifyingPanel as xt, MentionSource as y, F0ActionItemProps as yt, F0AiTableCardProps as z };
+export { DateGroup as $, useCanvasEntity as $t, ComposerMentionRef as A, F0OneIcon as At, UserBinaryPart as B, MaskOptions as Bt, F0ChatComposerVoice as C, F0AiInsightCardProps as Ct, ComposerMention as D, F0AvatarCompany as Dt, ComposerEditor as E, F0AvatarPerson as Et, F0AiChatTextArea as F, F0HILActionConfirmationProps as Ft, TrackedMention as G, actionItemStatuses as Gt, MentionItem as H, F0ActionItem as Ht, AiChatTextAreaUsageLimits as I, F0AuraVoiceAnimation as It, usageLimitsPopoverSides as J, ClarifyingQuestionState as Jt, F0AiChatUsageLimitsButtonProps as K, F0ClarifyingPanel as Kt, AttachedFile as L, F0AuraVoiceAnimationProps as Lt, ComposerMentionSource as M, OneIconSize as Mt, createPersonMentionSource as N, oneIconSizes as Nt, ComposerMentionItem as O, F0OneSwitch as Ot, DropOverlay as P, F0HILActionConfirmation as Pt, F0AiChatHistory as Q, ResolvedStepAnswer as Qt, F0AiChatTextAreaProps as R, CSSRgbString as Rt, F0ChatComposerState as S, ContentType as St, ComposerTranscribeFn as T, contentTypes as Tt, MentionSearchContext as U, ActionItemStatus as Ut, UserTextPart as V, ChatSpinner as Vt, MentionSource as W, F0ActionItemProps as Wt, ThreadItem as X, ClarifyingStepData as Xt, ThreadListSkeleton as Y, ClarifyingSelectionMode as Yt, CollapsibleGroup as Z, ClarifyingStepState as Zt, ComposerAutocompletePlugin as _, F0AiProposalCardHiddenActions as _t, PongBall as a, F0AiChatCreditsButton as at, F0ChatComposerLabels as b, AiInsightCardContent as bt, F0AiFileAttachments as c, F0AiChatHeaderProps as ct, aiChatFileFromUploadedFile as d, F0AiMessageSource as dt, F0CanvasCard as en, F0AiChatHistoryProps as et, aiChatFilesFromMessage as f, F0AiMessageSources as ft, ComposerAutocomplete as g, F0AiProposalCardBaseProps as gt, F0ChatComposer as h, F0AiProposalCardActions as ht, F0CanvasPanelProps as i, useChatHistory as it, ComposerMentionSearchContext as j, F0OneIconProps as jt, ComposerMentionPinned as k, F0OneSwitchProps as kt, F0AiFileAttachmentsProps as l, F0AiTableCard as lt, F0AiChatUsageLimitsButton as m, F0AiProposalCard as mt, F0AiProcessingOverlayProps as n, ThreadGroup as nt, F0AiPong as o, F0AiChatHeader as ot, aiChatMessageText as p, F0AiMessageSourcesProps as pt, UsageLimitsPopoverSide as q, ClarifyingOption as qt, F0CanvasPanel as r, ChatThread as rt, F0AiFilePreviewsProvider as s, F0AiChatHeaderAction as st, F0AiProcessingOverlay as t, F0CanvasCardProps as tn, ThreadActionHandlers as tt, aiChatFileFromShowFilesItem as u, F0AiTableCardProps as ut, F0ChatComposerDraft as v, F0AiProposalCardProps as vt, RecorderStatus as w, SparklineDataPoint as wt, F0ChatComposerProps as x, BalanceConfig as xt, F0ChatComposerHandle as y, F0AiInsightCard as yt, F0AiChatTextAreaSubmitPayload as z, F0AiMask as zt };