@adatechnology/conversations-ui 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
-import react__default, { ReactNode, CSSProperties, UIEvent, FormEvent, RefObject } from 'react';
-import { U as MessagePayload, a3 as ResolveMediaUrl, P as InteractiveSelection, V as MessageTranscription, N as InteractivePayload, x as ConversationsFeatures, u as ConversationSummary, j as ConversationChannel, Q as ListConversationsParams, w as ConversationsApi, a5 as SSEProvider, aa as TranscriptionMode, R as ListDocumentsParams, k as ConversationDocument, v as ConversationTemplate, f as ChannelFilter, g as ChannelFilterOption, q as ConversationSimulatorClient, s as ConversationSimulatorPanelLabels, Z as PreviewUploadedMedia } from './ConversationSimulatorPanel--5fIzXWY.js';
-export { A as AudioRecorderButton, a as AudioRecorderButtonLabels, b as AudioRecorderButtonProps, C as CHANNEL_CAPABILITIES, c as CHANNEL_FILTER_ALL, d as CONVERSATION_CHANNEL, e as ChannelCapabilities, h as CompanyDocument, i as CompanyDocumentPage, l as ConversationDocumentPage, m as ConversationEventSource, n as ConversationPage, y as ConversationsTheme, z as ConversationsUIConfig, E as DEFAULT_AUDIO_RECORDER_BUTTON_LABELS, F as DEFAULT_CONVERSATION_CHANNEL, H as DEFAULT_MAX_RECORDING_MILLISECONDS, J as FormatContactHandleParams, K as HANDLE_KIND, L as HandleKind, M as InteractiveOption, O as InteractiveSection, S as MediaRenderer, T as MediaRendererProps, a1 as REOPEN_MECHANISM, a2 as ReopenMechanism, a7 as SendSimulatorMediaParams, a8 as SimulatorMediaKind, ab as TranscriptionStatus, ae as capabilitiesOf, af as channelFiltersFor, ag as contactFlag, ak as formatContactHandle } from './ConversationSimulatorPanel--5fIzXWY.js';
+import react__default, { ReactNode, CSSProperties, UIEvent, FormEvent, RefObject, KeyboardEvent } from 'react';
+import { V as MessagePayload, a9 as ResolveMediaUrl, Q as InteractiveSelection, W as MessageTranscription, O as InteractivePayload, y as ConversationsFeatures, a4 as QuickReply$1, u as ConversationSummary, j as ConversationChannel, R as ListConversationsParams, x as ConversationsApi, ab as SSEProvider, ah as TranscriptionMode, S as ListDocumentsParams, k as ConversationDocument, v as ConversationTemplate, a3 as QueuedAttachment, a6 as QuickReplyInput, a5 as QuickReplyAttachment, w as ConversationVariable, f as ChannelFilter, g as ChannelFilterOption, q as ConversationSimulatorClient, s as ConversationSimulatorPanelLabels, _ as PreviewUploadedMedia } from './ConversationSimulatorPanel-ikgmlciE.js';
+export { A as AudioRecorderButton, a as AudioRecorderButtonLabels, b as AudioRecorderButtonProps, C as CHANNEL_CAPABILITIES, c as CHANNEL_FILTER_ALL, d as CONVERSATION_CHANNEL, e as ChannelCapabilities, h as CompanyDocument, i as CompanyDocumentPage, l as ConversationDocumentPage, m as ConversationEventSource, n as ConversationPage, z as ConversationsTheme, B as ConversationsUIConfig, F as DEFAULT_AUDIO_RECORDER_BUTTON_LABELS, G as DEFAULT_CONVERSATION_CHANNEL, I as DEFAULT_MAX_RECORDING_MILLISECONDS, K as FormatContactHandleParams, L as HANDLE_KIND, M as HandleKind, N as InteractiveOption, P as InteractiveSection, T as MediaRenderer, U as MediaRendererProps, a2 as QUICK_REPLY_ATTACHMENT_LIMIT, a7 as REOPEN_MECHANISM, a8 as ReopenMechanism, ad as SendSimulatorMediaParams, ae as SimulatorMediaKind, af as StoredAttachmentSendResult, ai as TranscriptionStatus, al as capabilitiesOf, am as channelFiltersFor, an as contactFlag, ar as formatContactHandle } from './ConversationSimulatorPanel-ikgmlciE.js';
 import '@adatechnology/meta-whatsapp-contracts/testing';
 
 interface MessageBubbleProps {
@@ -186,6 +186,75 @@ declare const EMOJI_CATEGORIES: readonly EmojiCategory[];
  */
 declare function searchEmojis(query: string): readonly EmojiEntry[];
 
+/**
+ * Vocabulário das telas de mensagens prontas. Sobrescrevível campo a campo — mesma convenção de
+ * `documents/labels.ts` e `workspace/labels.ts`.
+ */
+interface QuickRepliesPickerLabels {
+    readonly loading: string;
+    readonly error: string;
+    readonly empty: string;
+    readonly noResults: string;
+    /** Contagem ao lado do clipe na linha (QR-32): "2 anexos". */
+    readonly attachmentsCount: (count: number) => string;
+    /** Mostrado na linha quando a mensagem tem anexo, mas o produto não sabe mandá-lo (QR-33). */
+    readonly attachmentsUnavailable: string;
+}
+declare const DEFAULT_QUICK_REPLIES_PICKER_LABELS: QuickRepliesPickerLabels;
+interface QuickRepliesWorkspaceLabels {
+    readonly title: string;
+    readonly subtitle: (total: number) => string;
+    readonly searchPlaceholder: string;
+    readonly loading: string;
+    readonly failure: string;
+    readonly empty: string;
+    readonly noResults: string;
+    readonly create: string;
+    readonly edit: string;
+    readonly remove: string;
+    readonly removeConfirm: (title: string) => string;
+    readonly save: string;
+    readonly cancel: string;
+    readonly columnTitle: string;
+    readonly columnShortcut: string;
+    readonly columnBody: string;
+    readonly columnActions: string;
+    readonly fieldTitle: string;
+    readonly fieldTitleInvalid: string;
+    readonly fieldShortcut: string;
+    readonly fieldShortcutHint: string;
+    readonly fieldShortcutInvalid: string;
+    readonly fieldBody: string;
+    readonly fieldBodyInvalid: string;
+    readonly insertVariable: string;
+    readonly shortcutTaken: string;
+    readonly readOnlyNotice: string;
+    readonly saveError: string;
+    /** Sem `createQuickReply`/`updateQuickReply` na porta — a tela não deveria nem oferecer o botão,
+     * mas o formulário ainda precisa de um texto caso chame `submit` de outro jeito. */
+    readonly saveUnavailable: string;
+    readonly saving: string;
+    readonly deleting: string;
+    /** Seção de anexos (QR-31) — só aparece com `uploadQuickReplyAttachment` na porta. */
+    readonly attachmentsTitle: string;
+    readonly attachmentsAdd: string;
+    readonly attachmentsEmpty: string;
+    readonly attachmentUploading: (percent: number) => string;
+    /** @deprecated Sem uso: não existe um "processando" observável entre a resposta do upload e o
+     * item entrar em `editing.attachments` — as duas atualizações de estado acontecem no mesmo
+     * commit do React. Mantido no tipo só para não quebrar quem já customiza este campo. */
+    readonly attachmentProcessing: string;
+    readonly attachmentRetry: string;
+    readonly attachmentRemove: string;
+    readonly attachmentCancel: string;
+    readonly attachmentMoveUp: string;
+    readonly attachmentMoveDown: string;
+    readonly attachmentLimitReached: string;
+    readonly attachmentTooLarge: (filename: string) => string;
+    readonly saveBlockedUploading: string;
+}
+declare const DEFAULT_QUICK_REPLIES_WORKSPACE_LABELS: QuickRepliesWorkspaceLabels;
+
 /**
  * Mensagem pronta que o atendente cola no campo com um clique.
  *
@@ -210,8 +279,30 @@ interface MessageComposerLabels {
     attach: string;
     send: string;
     removeAttachment: string;
+    quickReplies: string;
 }
 declare const DEFAULT_MESSAGE_COMPOSER_LABELS: MessageComposerLabels;
+/**
+ * Mensagens prontas do produto, cadastradas pela tela de gestão. **Opcional por capacidade:** sem
+ * esta prop o botão de raio e o atalho `/` simplesmente não existem — não um botão que abre uma
+ * lista vazia.
+ */
+interface MessageComposerSavedQuickReplies {
+    readonly listQuickReplies: (params?: {
+        search?: string;
+    }) => Promise<QuickReply$1[]>;
+    /** Chave do cache do picker — troca de conversa não deve reconsultar o que já carregou. */
+    readonly conversationId: string;
+    readonly variables?: Readonly<Record<string, string>>;
+    readonly labels?: Partial<QuickRepliesPickerLabels>;
+    /**
+     * Avisada antes de inserir o texto, para o host empurrar os anexos da mensagem escolhida na fila
+     * do composer (QR-32). Sem esta prop nada muda — o texto continua sendo inserido do mesmo jeito.
+     */
+    readonly onSelect?: (quickReply: QuickReply$1) => void;
+    /** Sem `sendStoredAttachments` no host, a linha com anexo avisa em vez de prometer envio (QR-33). */
+    readonly hasAttachmentsCapability?: boolean;
+}
 interface MessageComposerProps {
     labels?: Partial<MessageComposerLabels>;
     onSend: (text: string) => void;
@@ -232,6 +323,8 @@ interface MessageComposerProps {
     quickReplies?: readonly QuickReply[];
     /** Valores para `{{variavel}}` — tipicamente nome do cliente, produto, protocolo. */
     quickReplyVariables?: Readonly<Record<string, string>>;
+    /** Botão de raio + atalho `/` para as mensagens prontas cadastradas. Ausente, nenhum dos dois aparece. */
+    savedQuickReplies?: MessageComposerSavedQuickReplies;
     className?: string;
     classNames?: Partial<MessageComposerClassNames>;
 }
@@ -248,7 +341,7 @@ interface MessageComposerClassNames {
  * Produto com regra própria passa `acceptedFileTypes`.
  */
 declare const DEFAULT_ACCEPTED_FILE_TYPES: string;
-declare const MessageComposer: ({ onSend, onAttach, value: externalValue, onChange: externalOnChange, quickReplies, quickReplyVariables, features, placeholder, maxLength, disabled, acceptedFileTypes, idleAction, className, classNames, labels, }: MessageComposerProps) => react.JSX.Element;
+declare const MessageComposer: ({ onSend, onAttach, value: externalValue, onChange: externalOnChange, quickReplies, quickReplyVariables, savedQuickReplies, features, placeholder, maxLength, disabled, acceptedFileTypes, idleAction, className, classNames, labels, }: MessageComposerProps) => react.JSX.Element;
 
 /** Cada ação que a barra sabe oferecer. `toolbar` decide quais delas aparecem. */
 declare const RICH_COMPOSER_ACTION: {
@@ -259,6 +352,7 @@ declare const RICH_COMPOSER_ACTION: {
     readonly EMOJI: "emoji";
     readonly ATTACH: "attach";
     readonly VARIABLES: "variables";
+    readonly QUICK_REPLIES: "quickReplies";
 };
 type RichComposerAction = (typeof RICH_COMPOSER_ACTION)[keyof typeof RICH_COMPOSER_ACTION];
 /** Texto das dicas. O host troca só o que quiser; o resto fica no padrão. */
@@ -273,8 +367,29 @@ interface RichComposerTooltips {
     variables: string;
     /** Botão que abre a formatação recolhida, quando a barra está estreita demais para os quatro. */
     formatting: string;
+    quickReplies: string;
 }
 declare const DEFAULT_RICH_COMPOSER_TOOLTIPS: RichComposerTooltips;
+/**
+ * Mensagens prontas do produto. **Opcional por capacidade:** sem esta prop o botão de raio e o
+ * atalho `/` não existem — não um botão que abre uma lista vazia.
+ */
+interface RichComposerSavedQuickReplies {
+    readonly listQuickReplies: (params?: {
+        search?: string;
+    }) => Promise<QuickReply$1[]>;
+    /** Chave do cache do picker — troca de conversa não deve reconsultar o que já carregou. */
+    readonly conversationId: string;
+    readonly variables?: Readonly<Record<string, string>>;
+    readonly labels?: Partial<QuickRepliesPickerLabels>;
+    /**
+     * Avisada antes de inserir o texto, para o host empurrar os anexos da mensagem escolhida na fila
+     * do composer (QR-32). Sem esta prop nada muda — o texto continua sendo inserido do mesmo jeito.
+     */
+    readonly onSelect?: (quickReply: QuickReply$1) => void;
+    /** Sem `sendStoredAttachments` no host, a linha com anexo avisa em vez de prometer envio (QR-33). */
+    readonly hasAttachmentsCapability?: boolean;
+}
 /**
  * Um valor que o operador pode inserir no texto sem digitar. `value` é o que entra no campo — pode
  * ser o dado já resolvido ("Anderson") ou um marcador a resolver depois ("{{nome}}"): quem decide é
@@ -310,6 +425,8 @@ interface RichMessageComposerProps {
     quickReplies?: RichComposerQuickReply[];
     /** Variáveis que o operador pode inserir no texto. Vazio ou ausente, o botão não aparece. */
     variables?: RichComposerVariable[];
+    /** Botão de raio + atalho `/` para as mensagens prontas cadastradas. Ausente, nenhum dos dois aparece. */
+    savedQuickReplies?: RichComposerSavedQuickReplies;
     /**
      * Quais ações aparecem. Ausente, todas aparecem — menos as que não têm como funcionar (anexo sem
      * `onAttachFiles` some sozinho, porque botão que não faz nada é pior que botão nenhum).
@@ -1622,6 +1739,136 @@ interface AsyncResourceState<T> {
 
 declare function createMediaUrlResolver(api: Pick<ConversationsApi, 'getDocumentUrl' | 'getMediaProxyUrl'>): ResolveMediaUrl;
 
+/**
+ * Anexos de uma mensagem pronta escolhida no picker, prontos para entrar na fila como `stored`
+ * (QR-32). Vazio sem `hasAttachmentsCapability` — sem `sendStoredAttachments` no host, empurrar o
+ * item só encalharia na fila sem jeito de sair; a linha do picker já avisou disso antes do clique.
+ */
+declare function queuedAttachmentsFromQuickReply(quickReply: Pick<QuickReply$1, 'attachments'>, hasAttachmentsCapability: boolean): readonly QueuedAttachment[];
+type AttachmentSendStatus = 'waiting' | 'sending' | 'sent' | 'failed' | 'skipped';
+/** Espelha os tetos da API; o host sobrescreve quando o backend dele aceita outro tamanho. */
+declare const DEFAULT_MAX_ATTACHMENT_SIZE_BYTES: {
+    readonly document: number;
+    readonly image: number;
+    readonly audio: number;
+    readonly video: number;
+};
+type MaxAttachmentSizeBytes = {
+    readonly document: number;
+    readonly image: number;
+    readonly audio: number;
+    readonly video: number;
+};
+type OutgoingItems = {
+    readonly text: string;
+    readonly attachments: readonly QueuedAttachment[];
+};
+declare function resolveMaxAttachmentSizeBytes(mimeType: string, limits?: MaxAttachmentSizeBytes): number;
+
+/**
+ * Funções puras do upload de anexo na tela de cadastro (QR-31): validação antes de subir,
+ * reordenação e o limitador de concorrência. Sem estado de React — testáveis sem montar o hook.
+ */
+
+type AttachmentFileRejection = {
+    readonly file: File;
+    readonly reason: 'limit' | 'size';
+};
+type ValidateAttachmentFilesResult = {
+    readonly accepted: readonly File[];
+    readonly rejected: readonly AttachmentFileRejection[];
+};
+
+/**
+ * Portas que a tela de cadastro precisa. `create`/`update`/`delete` ausentes não impedem a leitura
+ * — só tiram a ação correspondente, a mesma regra de capacidade do resto do pacote.
+ */
+interface QuickRepliesWorkspaceApi {
+    readonly listQuickReplies?: (params?: {
+        search?: string;
+    }) => Promise<QuickReply$1[]>;
+    readonly createQuickReply?: (input: QuickReplyInput) => Promise<QuickReply$1>;
+    readonly updateQuickReply?: (id: string, input: QuickReplyInput) => Promise<QuickReply$1>;
+    readonly deleteQuickReply?: (id: string) => Promise<void>;
+    /** Sem esta porta, a seção de anexos não aparece — nem no formulário. */
+    readonly uploadQuickReplyAttachment?: (file: File, options?: {
+        onProgress?: (fraction: number) => void;
+        signal?: AbortSignal;
+    }) => Promise<QuickReplyAttachment>;
+}
+
+interface QuickRepliesWorkspaceProps {
+    readonly api: QuickRepliesWorkspaceApi;
+    /** Catálogo de variáveis oferecido pelos botões "Inserir variável" do formulário. */
+    readonly variables?: readonly ConversationVariable[];
+    readonly labels?: Partial<QuickRepliesWorkspaceLabels>;
+    readonly className?: string;
+    /** Sobrescreve o teto por tipo de arquivo. Ausente, usa `DEFAULT_MAX_ATTACHMENT_SIZE_BYTES`. */
+    readonly attachmentSizeLimits?: MaxAttachmentSizeBytes;
+}
+/**
+ * Tela de gestão das mensagens prontas: tabela com busca e zebra, formulário de criação/edição, e
+ * exclusão com confirmação. Some o formulário quando o host não passa `createQuickReply` — vira
+ * consulta, a mesma regra de capacidade do resto do pacote.
+ */
+declare function QuickRepliesWorkspace({ api, variables, labels, className, attachmentSizeLimits, }: QuickRepliesWorkspaceProps): react.JSX.Element;
+
+/**
+ * Presente só no modo botão: o picker desenha e é dono da própria busca — focada ao abrir, dona de
+ * seta/Enter/Esc. O campo de mensagem não é tocado (QR-04): abrir pelo raio nunca insere `/` nele.
+ * Ausente, a busca vem do atalho `/termo` digitado no próprio campo, que continua no comando.
+ */
+type QuickRepliesPickerOwnSearch = {
+    readonly value: string;
+    readonly onChange: (value: string) => void;
+    readonly onKeyDown: (event: KeyboardEvent<HTMLInputElement>) => void;
+    readonly label: string;
+};
+type QuickRepliesPickerProps = {
+    /** Id do `listbox`, para o campo (ou a busca própria) apontar `aria-activedescendant`. */
+    readonly id: string;
+    readonly items: readonly QuickReply$1[];
+    readonly search: string;
+    readonly highlightedIndex: number;
+    readonly isLoading: boolean;
+    /** Sinalizador puro — o texto exibido é sempre `labels.error`, nunca mensagem crua de exceção. */
+    readonly hasError?: boolean;
+    readonly onHover: (index: number) => void;
+    readonly onSelect: (quickReply: QuickReply$1) => void;
+    readonly labels?: Partial<QuickRepliesPickerLabels>;
+    readonly className?: string;
+    readonly ownSearch?: QuickRepliesPickerOwnSearch;
+    /** Resolve `{{marcador}}` antes de destacar e mostrar a prévia (QR-04) — quem busca "joão" espera
+     * ver "Olá João" na lista, não o marcador cru. */
+    readonly variables?: Readonly<Record<string, string>>;
+    /** Sem `sendStoredAttachments` no host, a linha com anexo avisa em vez de prometer envio (QR-33). */
+    readonly hasAttachmentsCapability?: boolean;
+};
+/**
+ * Lista flutuante do atalho `/` e do botão de raio. Puramente controlada — todo estado (busca,
+ * destaque, carregamento) vem de `useQuickRepliesPicker`, este componente só desenha.
+ */
+declare function QuickRepliesPicker({ id, items, search, highlightedIndex, isLoading, hasError, onHover, onSelect, labels, className, ownSearch, variables, hasAttachmentsCapability, }: QuickRepliesPickerProps): react.JSX.Element;
+
+declare function normalizeForSearch(value: string): string;
+type FilterQuickRepliesParams = {
+    readonly quickReplies: readonly QuickReply$1[];
+    readonly search: string;
+    /** Resolve `{{marcador}}` antes de comparar — buscar "joão" deve achar quem cita o nome no corpo. */
+    readonly variables?: Readonly<Record<string, string>>;
+};
+/** Busca por título, atalho e corpo (com as variáveis já aplicadas). Termo vazio devolve tudo. */
+declare function filterQuickReplies({ quickReplies, search, variables, }: FilterQuickRepliesParams): readonly QuickReply$1[];
+type MatchSegment = {
+    readonly text: string;
+    readonly isMatch: boolean;
+};
+/**
+ * Segmenta o texto ao redor do termo buscado para o chamador destacar sem HTML — quem cadastrou a
+ * mensagem não deve conseguir injetar marcação pelo próprio corpo ou título.
+ */
+declare function highlightMatch(text: string, search: string): readonly MatchSegment[];
+
 /**
  * Textos da inbox. Todos sobrescrevíveis: o produto troca vocabulário ("cliente" vira "lead") ou
  * o idioma inteiro sem tocar no layout — e sem manter uma cópia da tela para isso.
@@ -1659,6 +1906,14 @@ interface ConversationsWorkspaceLabels {
     readonly attachFailure: string;
     /** Tira um arquivo da fila antes de enviar. */
     readonly attachmentRemove: string;
+    /** Estado de cada item da fila durante o envio (QR-47). */
+    readonly attachmentWaiting: string;
+    readonly attachmentSending: string;
+    readonly attachmentSent: string;
+    readonly attachmentFailed: string;
+    /** Servidor parou antes de tentar este arquivo, por causa de uma falha anterior no mesmo lote. */
+    readonly attachmentSkipped: string;
+    readonly attachmentRetry: string;
     readonly recordFailure: string;
     readonly sendFailure: string;
     readonly takeoverToReply: string;
@@ -1809,6 +2064,7 @@ interface ConversationsWorkspaceProps {
     readonly initialWhatsappNumber?: string | undefined;
     readonly simulator?: ConversationsWorkspaceSimulator;
     readonly quickReplies?: readonly QuickReply[];
+    /** @deprecated Use `conversationVariablesFor`, que alimenta os dois composers com uma lista só. */
     readonly quickReplyVariablesFor?: (conversation: ConversationSummary, context: Record<string, unknown> | undefined) => Record<string, string>;
     /** Etapa do fluxo mostrada no painel de contexto. */
     readonly flowLabelOf?: (conversation: ConversationSummary) => string | undefined;
@@ -1822,8 +2078,16 @@ interface ConversationsWorkspaceProps {
     readonly initialComposerText?: string | undefined;
     /** `rich` troca o campo simples pelo texto com a formatação do WhatsApp desenhada ao escrever. */
     readonly composer?: 'simple' | 'rich';
-    /** Valores que o operador insere sem digitar. Só o composer `rich` os oferece. */
+    /**
+     * Valores que o operador insere sem digitar. Só o composer `rich` os oferece.
+     * @deprecated Use `conversationVariablesFor`.
+     */
     readonly composerVariablesFor?: (conversation: ConversationSummary, context: Record<string, unknown> | undefined) => readonly RichComposerVariable[];
+    /**
+     * Dados da conversa que o texto pode citar, numa lista só. Presente, manda sobre
+     * `quickReplyVariablesFor` e `composerVariablesFor`.
+     */
+    readonly conversationVariablesFor?: (conversation: ConversationSummary, context: Record<string, unknown> | undefined) => readonly ConversationVariable[];
     /** Fila de anexos com legenda, como no WhatsApp. Ausente, o clipe manda cada arquivo na hora. */
     readonly onSendAttachments?: (conversation: ConversationSummary, files: readonly File[], caption: string) => Promise<void>;
     /** Nota de voz. Ausente, o microfone não aparece. */
@@ -1841,7 +2105,7 @@ interface ConversationsWorkspaceProps {
     readonly signInHref?: string;
     readonly className?: string;
 }
-declare function ConversationsWorkspace({ labels: labelsOverride, filters, perPage, markReadOnOpen, serverPaginated, initialConversationId, initialWhatsappNumber, simulator, quickReplies, quickReplyVariablesFor, flowLabelOf, onDownload, requireTakeoverToReply, messageSelection, initialComposerText, composer, composerVariablesFor, onSendAttachments, onRecordAudio, contextEntriesOf, onAttach, extraUtilitiesFor, renderFilters, renderBulkActions, renderRow, renderAboveTranscript, renderHeaderActions, onSendTemplateToSelected, signInHref, className, }: ConversationsWorkspaceProps): react.JSX.Element;
+declare function ConversationsWorkspace({ labels: labelsOverride, filters, perPage, markReadOnOpen, serverPaginated, initialConversationId, initialWhatsappNumber, simulator, quickReplies, quickReplyVariablesFor, flowLabelOf, onDownload, requireTakeoverToReply, messageSelection, initialComposerText, composer, composerVariablesFor, conversationVariablesFor, onSendAttachments, onRecordAudio, contextEntriesOf, onAttach, extraUtilitiesFor, renderFilters, renderBulkActions, renderRow, renderAboveTranscript, renderHeaderActions, onSendTemplateToSelected, signInHref, className, }: ConversationsWorkspaceProps): react.JSX.Element;
 
 interface ConversationPaneProps {
     readonly conversation: ConversationSummary;
@@ -1861,6 +2125,7 @@ interface ConversationPaneProps {
      * Recebe o contexto junto porque o dado que interessa à variável (o nome que o bot perguntou,
      * por exemplo) vive no contexto do fluxo, não no resumo da listagem.
      */
+    /** @deprecated Use `conversationVariablesFor`, que alimenta os dois composers com uma lista só. */
     readonly quickReplyVariablesFor?: (conversation: ConversationSummary, context: Record<string, unknown> | undefined) => Record<string, string>;
     /** Etapa do fluxo ao lado do contexto (ex.: "Anotando o pedido"). */
     readonly flowLabel?: string | undefined;
@@ -1893,8 +2158,16 @@ interface ConversationPaneProps {
      * é menos coisa na tela.
      */
     readonly composer?: 'simple' | 'rich';
-    /** Valores que o operador insere sem digitar. Só o composer `rich` os oferece. */
+    /**
+     * Valores que o operador insere sem digitar. Só o composer `rich` os oferece.
+     * @deprecated Use `conversationVariablesFor`.
+     */
     readonly composerVariablesFor?: (conversation: ConversationSummary, context: Record<string, unknown> | undefined) => readonly RichComposerVariable[];
+    /**
+     * Dados da conversa que o texto pode citar, numa lista só. Presente, manda sobre
+     * `quickReplyVariablesFor` e `composerVariablesFor`.
+     */
+    readonly conversationVariablesFor?: (conversation: ConversationSummary, context: Record<string, unknown> | undefined) => readonly ConversationVariable[];
     /**
      * Fila de anexos com legenda, como no WhatsApp: os arquivos escolhidos ficam visíveis acima da
      * barra e saem junto com o texto escrito. Ausente, o clipe manda cada arquivo na hora — o que
@@ -1904,7 +2177,7 @@ interface ConversationPaneProps {
     /** Grava e envia nota de voz. Ausente, o microfone não aparece. */
     readonly onRecordAudio?: (file: File) => Promise<void>;
 }
-declare function ConversationPane({ conversation, now, busy, labels, onTakeover, onReturnToBot, onFinish, onBack, extraUtilities, contextEntriesOf, quickReplies, quickReplyVariablesFor, flowLabel, onDownload, requireTakeoverToReply, messageSelection, initialComposerText, renderAboveTranscript, onAttach, composer, composerVariablesFor, onSendAttachments, onRecordAudio, }: ConversationPaneProps): react.JSX.Element;
+declare function ConversationPane({ conversation, now, busy, labels, onTakeover, onReturnToBot, onFinish, onBack, extraUtilities, contextEntriesOf, quickReplies, quickReplyVariablesFor, flowLabel, onDownload, requireTakeoverToReply, messageSelection, initialComposerText, renderAboveTranscript, onAttach, composer, composerVariablesFor, conversationVariablesFor, onSendAttachments, onRecordAudio, }: ConversationPaneProps): react.JSX.Element;
 
 interface ConversationsInboxListProps {
     readonly inbox: UseConversationsInboxResult;
@@ -1919,4 +2192,26 @@ interface ConversationsInboxListProps {
 }
 declare function ConversationsInboxList({ inbox, labels, className, renderFilters, renderBulkActions, renderRow, onSendTemplateToSelected, }: ConversationsInboxListProps): react.JSX.Element;
 
-export { type AsyncResourceState, AudioPlayer, type AudioPlayerProps, AudioTranscription, type AudioTranscriptionProps, Avatar, type AvatarLabels, type AvatarProps, type BotMessages, type BuildTranscriptTextParams, BulkActionBar, type BulkActionBarProps, CHANNEL_BRAND_COLOR, CONVERSATIONS_PER_PAGE, CONVERSATION_WINDOW, ChannelFilter, ChannelFilterOption, ChannelIcon, type ChannelIconProps, ConversationChannel, type ConversationContextEntry, ConversationContextPanel, type ConversationContextPanelClassNames, type ConversationContextPanelLabels, type ConversationContextPanelProps, type ConversationContextStatus, ConversationDocument, ConversationDocumentsPanel, type ConversationDocumentsPanelClassNames, type ConversationDocumentsPanelLabels, type ConversationDocumentsPanelProps, ConversationHeader, type ConversationHeaderClassNames, type ConversationHeaderLabels, type ConversationHeaderProps, type ConversationHeaderUtility, ConversationListItem, type ConversationListItemLabels, type ConversationListItemProps, type ConversationLocales, ConversationLocalesProvider, type ConversationLocalesProviderProps, ConversationPane, type ConversationPaneProps, type ConversationRealtimeHandler, ConversationRow, type ConversationRowClassNames, type ConversationRowProps, ConversationSimulatorClient, ConversationSummary, ConversationTemplate, ConversationWallpaper, type ConversationWallpaperProps, type ConversationWindow, ConversationsApi, ConversationsFeatures, ConversationsInboxList, type ConversationsInboxListProps, ConversationsProvider, ConversationsWorkspace, type ConversationsWorkspaceLabels, type ConversationsWorkspaceProps, type ConversationsWorkspaceSimulator, DEFAULT_ACCEPTED_FILE_TYPES, DEFAULT_AVATAR_LABELS, DEFAULT_CONVERSATIONS_WORKSPACE_LABELS, DEFAULT_CONVERSATION_CONTEXT_LABELS, DEFAULT_CONVERSATION_DOCUMENTS_LABELS, DEFAULT_CONVERSATION_HEADER_LABELS, DEFAULT_CONVERSATION_LIST_ITEM_LABELS, DEFAULT_DARK_MODE_TOGGLE_LABELS, DEFAULT_DOCUMENTS_LIBRARY_LABELS, DEFAULT_DOCUMENTS_WORKSPACE_LABELS, DEFAULT_EMOJI_PICKER_LABELS, DEFAULT_INTERACTIVE_MESSAGE_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MESSAGE_COMPOSER_LABELS, DEFAULT_RICH_COMPOSER_TOOLTIPS, DEFAULT_TEMPLATES_SETTINGS_LABELS, DEFAULT_WHATSAPP_MESSAGE_EDITOR_LABELS, DEFAULT_WINDOW_EXPIRED_LABELS, DOCUMENT_SOURCE_FILTER, DarkModeToggle, type DarkModeToggleLabels, type DarkModeToggleProps, DateDivider, type DateDividerClassNames, type DateDividerProps, type DocumentSourceFilter, type DocumentsFiltersContext, DocumentsLibrary, type DocumentsLibraryClassNames, type DocumentsLibraryLabels, type DocumentsLibraryProps, DocumentsWorkspace, type DocumentsWorkspaceClassNames, type DocumentsWorkspaceLabels, type DocumentsWorkspaceProps, EMOJI_CATEGORIES, type EmojiCategory, type EmojiEntry, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, FileIcon, type FileIconProps, type FilterOption, InteractiveMessage, type InteractiveMessageLabels, type InteractiveMessageProps, InteractivePayload, InteractiveSelection, Lightbox, type LightboxLabels, type LightboxProps, ListConversationsParams, ListDocumentsParams, ListingPagination, type ListingPaginationProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerClassNames, type MessageComposerLabels, type MessageComposerProps, MessagePayload, MessageTail, MessageText, type MessageTextProps, MessageTimestamp, MessageTranscription, MessagesWorkspace, type MessagesWorkspaceApi, type MessagesWorkspaceLabels, type MessagesWorkspaceProps, type MessagesWorkspaceTemplateRole, MultiSelectFilter, type MultiSelectFilterProps, NARROW_MAX_WIDTH_PX, type QuickReply, REPLY_LATENCY, REPLY_LATENCY_CRITICAL_HOURS, REPLY_LATENCY_LATE_HOURS, RICH_COMPOSER_ACTION, type ReplyLatency, type ReplyLatencyParams, ResolveMediaUrl, type RichComposerAction, type RichComposerQuickReply, type RichComposerTooltips, type RichComposerVariable, RichMessageComposer, type RichMessageComposerHandle, type RichMessageComposerProps, SSEProvider, SimpleEmojiPicker, type SimpleEmojiPickerProps, type SimulatorTransportFactory, type SimulatorTransportParams, type SortDirection, SortableHead, type SortableHeadProps, StatusTicks, type StatusTicksProps, TEMPLATE_SETTINGS_TAB, TOOLTIP_ATTRIBUTE, type TemplateSettings, type TemplateSettingsTab, ToastProvider, TooltipLayer, type TopicItem, TopicsForm, type TopicsFormLabels, type TopicsFormProps, TranscriptionMode, type TranscriptionSettings, TranscriptionSettingsForm, type TranscriptionSettingsFormLabels, type TranscriptionSettingsFormProps, type UrlStateOptions, type UseConversationActionsResult, type UseConversationContextResult, type UseConversationDocumentsParams, type UseConversationDocumentsResult, type UseConversationListParams, type UseConversationListResult, type UseConversationMessagesResult, type UseConversationsInboxParams, type UseConversationsInboxResult, type UseInboxActionsResult, type UseScrollToLatestMessageParams, type UseScrollToLatestMessageResult, type UseWaitingNotificationsLabels, type UseWaitingNotificationsParams, type UseWaitingNotificationsResult, WINDOW_FILTERS, WelcomeFarewellForm, type WelcomeFarewellFormLabels, type WelcomeFarewellFormProps, WhatsAppCreateTemplateForm, type WhatsAppCreateTemplateFormLabels, type WhatsAppCreateTemplateFormProps, type WhatsAppCreateTemplateResult, type WhatsAppCreateTemplateState, WhatsAppMessageEditor, type WhatsAppMessageEditorLabels, type WhatsAppMessageEditorProps, type WhatsAppTemplateHeaderType, WhatsAppTemplateSettingsForm, type WhatsAppTemplateSettingsFormLabels, type WhatsAppTemplateSettingsFormProps, type WhatsAppTemplateSummary, type WhatsAppTemplateVariableSuggestion, WhatsAppTemplatesSettings, type WhatsAppTemplatesSettingsLabels, type WhatsAppTemplatesSettingsProps, WindowExpiredNotice, type WindowExpiredNoticeLabels, type WindowExpiredNoticeProps, type WindowOfParams, applyQuickReplyVariables, buildTranscriptFilename, buildTranscriptText, createMediaUrlResolver, downloadTextFile, formatDateTime, formatFileSize, formatPhone, formatStalledFor, formatTimestamp, htmlToWA, isReplyOverdue, isSameDay, isWindowBlocking, parseWhatsAppFormatting, phoneInitials, replyLatencyOf, resolveQuickReply, searchEmojis, toast, useConversationActions, useConversationContext, useConversationDocuments, useConversationList, useConversationLocales, useConversationMessages, useConversationRealtime, useConversations, useConversationsInbox, useDarkMode, useDebouncedValue, useGlobalRealtime, useInboxActions, useIsDarkTheme, useIsNarrow, useScrollToLatestMessage, useToast, useUrlArrayState, useUrlNumberState, useUrlStringState, useWaitingNotifications, waToHTML, waToHTMLInline, windowOf };
+type QueuedAttachmentsListLabels = {
+    readonly remove: string;
+    readonly waiting: string;
+    readonly sending: string;
+    readonly sent: string;
+    readonly failed: string;
+    readonly skipped: string;
+    readonly retry: string;
+};
+type QueuedAttachmentsListProps = {
+    readonly items: readonly QueuedAttachment[];
+    readonly statusOf: (key: string) => AttachmentSendStatus;
+    readonly onRemove: (item: QueuedAttachment) => void;
+    readonly onRetry?: (item: QueuedAttachment) => void;
+    /** Chaves com retry avulso em voo — desabilita o botão "Tentar de novo" desse item específico. */
+    readonly retryingKeys?: ReadonlySet<string>;
+    readonly getThumbnailUrl?: (uploadId: string) => Promise<string>;
+    readonly labels: QueuedAttachmentsListLabels;
+    readonly busy: boolean;
+};
+declare function QueuedAttachmentsList({ items, statusOf, onRemove, onRetry, retryingKeys, getThumbnailUrl, labels, busy, }: QueuedAttachmentsListProps): react.JSX.Element | null;
+
+export { type AsyncResourceState, type AttachmentFileRejection, AudioPlayer, type AudioPlayerProps, AudioTranscription, type AudioTranscriptionProps, Avatar, type AvatarLabels, type AvatarProps, type BotMessages, type BuildTranscriptTextParams, BulkActionBar, type BulkActionBarProps, CHANNEL_BRAND_COLOR, CONVERSATIONS_PER_PAGE, CONVERSATION_WINDOW, ChannelFilter, ChannelFilterOption, ChannelIcon, type ChannelIconProps, ConversationChannel, type ConversationContextEntry, ConversationContextPanel, type ConversationContextPanelClassNames, type ConversationContextPanelLabels, type ConversationContextPanelProps, type ConversationContextStatus, ConversationDocument, ConversationDocumentsPanel, type ConversationDocumentsPanelClassNames, type ConversationDocumentsPanelLabels, type ConversationDocumentsPanelProps, ConversationHeader, type ConversationHeaderClassNames, type ConversationHeaderLabels, type ConversationHeaderProps, type ConversationHeaderUtility, ConversationListItem, type ConversationListItemLabels, type ConversationListItemProps, type ConversationLocales, ConversationLocalesProvider, type ConversationLocalesProviderProps, ConversationPane, type ConversationPaneProps, type ConversationRealtimeHandler, ConversationRow, type ConversationRowClassNames, type ConversationRowProps, ConversationSimulatorClient, ConversationSummary, ConversationTemplate, ConversationVariable, ConversationWallpaper, type ConversationWallpaperProps, type ConversationWindow, ConversationsApi, ConversationsFeatures, ConversationsInboxList, type ConversationsInboxListProps, ConversationsProvider, ConversationsWorkspace, type ConversationsWorkspaceLabels, type ConversationsWorkspaceProps, type ConversationsWorkspaceSimulator, DEFAULT_ACCEPTED_FILE_TYPES, DEFAULT_AVATAR_LABELS, DEFAULT_CONVERSATIONS_WORKSPACE_LABELS, DEFAULT_CONVERSATION_CONTEXT_LABELS, DEFAULT_CONVERSATION_DOCUMENTS_LABELS, DEFAULT_CONVERSATION_HEADER_LABELS, DEFAULT_CONVERSATION_LIST_ITEM_LABELS, DEFAULT_DARK_MODE_TOGGLE_LABELS, DEFAULT_DOCUMENTS_LIBRARY_LABELS, DEFAULT_DOCUMENTS_WORKSPACE_LABELS, DEFAULT_EMOJI_PICKER_LABELS, DEFAULT_INTERACTIVE_MESSAGE_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MAX_ATTACHMENT_SIZE_BYTES, DEFAULT_MESSAGE_COMPOSER_LABELS, DEFAULT_QUICK_REPLIES_PICKER_LABELS, DEFAULT_QUICK_REPLIES_WORKSPACE_LABELS, DEFAULT_RICH_COMPOSER_TOOLTIPS, DEFAULT_TEMPLATES_SETTINGS_LABELS, DEFAULT_WHATSAPP_MESSAGE_EDITOR_LABELS, DEFAULT_WINDOW_EXPIRED_LABELS, DOCUMENT_SOURCE_FILTER, DarkModeToggle, type DarkModeToggleLabels, type DarkModeToggleProps, DateDivider, type DateDividerClassNames, type DateDividerProps, type DocumentSourceFilter, type DocumentsFiltersContext, DocumentsLibrary, type DocumentsLibraryClassNames, type DocumentsLibraryLabels, type DocumentsLibraryProps, DocumentsWorkspace, type DocumentsWorkspaceClassNames, type DocumentsWorkspaceLabels, type DocumentsWorkspaceProps, EMOJI_CATEGORIES, type EmojiCategory, type EmojiEntry, EmojiPicker, type EmojiPickerLabels, type EmojiPickerProps, FileIcon, type FileIconProps, type FilterOption, type FilterQuickRepliesParams, InteractiveMessage, type InteractiveMessageLabels, type InteractiveMessageProps, InteractivePayload, InteractiveSelection, Lightbox, type LightboxLabels, type LightboxProps, ListConversationsParams, ListDocumentsParams, ListingPagination, type ListingPaginationProps, type MatchSegment, type MaxAttachmentSizeBytes, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerClassNames, type MessageComposerLabels, type MessageComposerProps, MessagePayload, MessageTail, MessageText, type MessageTextProps, MessageTimestamp, MessageTranscription, MessagesWorkspace, type MessagesWorkspaceApi, type MessagesWorkspaceLabels, type MessagesWorkspaceProps, type MessagesWorkspaceTemplateRole, MultiSelectFilter, type MultiSelectFilterProps, NARROW_MAX_WIDTH_PX, type OutgoingItems, QueuedAttachment, QueuedAttachmentsList, QuickRepliesPicker, type QuickRepliesPickerLabels, type QuickRepliesPickerProps, QuickRepliesWorkspace, type QuickRepliesWorkspaceLabels, type QuickRepliesWorkspaceProps, type QuickReply, QuickReplyAttachment, QuickReplyInput, REPLY_LATENCY, REPLY_LATENCY_CRITICAL_HOURS, REPLY_LATENCY_LATE_HOURS, RICH_COMPOSER_ACTION, type ReplyLatency, type ReplyLatencyParams, ResolveMediaUrl, type RichComposerAction, type RichComposerQuickReply, type RichComposerTooltips, type RichComposerVariable, RichMessageComposer, type RichMessageComposerHandle, type RichMessageComposerProps, SSEProvider, QuickReply$1 as SavedQuickReply, SimpleEmojiPicker, type SimpleEmojiPickerProps, type SimulatorTransportFactory, type SimulatorTransportParams, type SortDirection, SortableHead, type SortableHeadProps, StatusTicks, type StatusTicksProps, TEMPLATE_SETTINGS_TAB, TOOLTIP_ATTRIBUTE, type TemplateSettings, type TemplateSettingsTab, ToastProvider, TooltipLayer, type TopicItem, TopicsForm, type TopicsFormLabels, type TopicsFormProps, TranscriptionMode, type TranscriptionSettings, TranscriptionSettingsForm, type TranscriptionSettingsFormLabels, type TranscriptionSettingsFormProps, type UrlStateOptions, type UseConversationActionsResult, type UseConversationContextResult, type UseConversationDocumentsParams, type UseConversationDocumentsResult, type UseConversationListParams, type UseConversationListResult, type UseConversationMessagesResult, type UseConversationsInboxParams, type UseConversationsInboxResult, type UseInboxActionsResult, type UseScrollToLatestMessageParams, type UseScrollToLatestMessageResult, type UseWaitingNotificationsLabels, type UseWaitingNotificationsParams, type UseWaitingNotificationsResult, type ValidateAttachmentFilesResult, WINDOW_FILTERS, WelcomeFarewellForm, type WelcomeFarewellFormLabels, type WelcomeFarewellFormProps, WhatsAppCreateTemplateForm, type WhatsAppCreateTemplateFormLabels, type WhatsAppCreateTemplateFormProps, type WhatsAppCreateTemplateResult, type WhatsAppCreateTemplateState, WhatsAppMessageEditor, type WhatsAppMessageEditorLabels, type WhatsAppMessageEditorProps, type WhatsAppTemplateHeaderType, WhatsAppTemplateSettingsForm, type WhatsAppTemplateSettingsFormLabels, type WhatsAppTemplateSettingsFormProps, type WhatsAppTemplateSummary, type WhatsAppTemplateVariableSuggestion, WhatsAppTemplatesSettings, type WhatsAppTemplatesSettingsLabels, type WhatsAppTemplatesSettingsProps, WindowExpiredNotice, type WindowExpiredNoticeLabels, type WindowExpiredNoticeProps, type WindowOfParams, applyQuickReplyVariables, buildTranscriptFilename, buildTranscriptText, createMediaUrlResolver, downloadTextFile, filterQuickReplies, formatDateTime, formatFileSize, formatPhone, formatStalledFor, formatTimestamp, highlightMatch, htmlToWA, isReplyOverdue, isSameDay, isWindowBlocking, normalizeForSearch, parseWhatsAppFormatting, phoneInitials, queuedAttachmentsFromQuickReply, replyLatencyOf, resolveMaxAttachmentSizeBytes, resolveQuickReply, searchEmojis, toast, useConversationActions, useConversationContext, useConversationDocuments, useConversationList, useConversationLocales, useConversationMessages, useConversationRealtime, useConversations, useConversationsInbox, useDarkMode, useDebouncedValue, useGlobalRealtime, useInboxActions, useIsDarkTheme, useIsNarrow, useScrollToLatestMessage, useToast, useUrlArrayState, useUrlNumberState, useUrlStringState, useWaitingNotifications, waToHTML, waToHTMLInline, windowOf };