@adatechnology/conversations-ui 0.1.0-rc.9 → 0.1.1

package/src/documents/DocumentsWorkspace.tsx

@@ -0,0 +1,550 @@
+/**
+ * Tela completa de Documentos: a biblioteca de arquivos de TODAS as conversas, fora do atendimento.
+ *
+ * Distinta do `ConversationDocumentsPanel`, que parte de uma conversa aberta e vive dentro dela.
+ * Esta varre a empresa, e por isso mostra de qual conversa cada arquivo veio.
+ *
+ * É a tela inteira, não um punhado de peças: ordenação por coluna, filtros de seleção múltipla,
+ * recorte por data, seleção em lote, paginação e espelho na URL já vêm montados. Produto que
+ * remontasse isso à mão voltaria a divergir dos outros — foi o que aconteceu antes desta tela existir.
+ */
+
+import { useEffect, useMemo, useRef, useState, type ReactNode } from 'react'
+import { Download, Eye, MessageSquare, Trash2, Upload, X } from 'lucide-react'
+
+import { useConversations } from '../providers/ConversationsProvider'
+import { FileIcon } from '../FileIcon'
+import { documentTypeLabel } from '../MediaRenderer'
+import { cn } from '../lib/cn'
+import { formatDateTime, formatFileSize } from '../lib/format'
+import { formatPhone } from '../lib/phone'
+import {
+  BulkActionBar,
+  ListingPagination,
+  MultiSelectFilter,
+  SortableHead,
+  type FilterOption,
+  type SortDirection,
+} from '../listing'
+import { useDebouncedValue, useUrlArrayState, useUrlNumberState, useUrlStringState } from '../hooks/useUrlFilterState'
+import type { CompanyDocument } from '../providers/types'
+import { DEFAULT_DOCUMENTS_WORKSPACE_LABELS, type DocumentsWorkspaceLabels } from './labels'
+import { TooltipLayer } from '../Tooltip'
+
+const DEFAULT_PER_PAGE = 20
+const DEFAULT_PER_PAGE_OPTIONS = [10, 20, 50, 100] as const
+const DEFAULT_SORT_FIELD = 'linkedAt'
+
+export interface DocumentsWorkspaceClassNames {
+  root: string
+  header: string
+  filters: string
+  table: string
+  row: string
+  status: string
+}
+
+export interface DocumentsWorkspaceProps {
+  readonly perPage?: number
+  readonly perPageOptions?: readonly number[]
+  /** Abrir a conversa de origem. Ausente, o número aparece como texto e não como link. */
+  readonly onOpenConversation?: (conversationId: string) => void
+  /** Origens filtráveis. Ausente, usa o vocabulário padrão (`customer`, `agent`, `bot`). */
+  readonly sources?: readonly FilterOption[]
+  /** Categorias de arquivo. Lista vazia esconde o filtro — nem todo host classifica anexo. */
+  readonly categories?: readonly FilterOption[]
+  /** Recorte por data. Desligado quando o backend não sabe filtrar por período. */
+  readonly dateFilter?: boolean
+  /**
+   * Filtros do produto (cliente, unidade, campanha). Recebe os parâmetros extras atuais e devolve
+   * os controles; o que o produto guardar aqui viaja em `extra` para o `getAllDocuments`.
+   */
+  readonly renderFilters?: (context: DocumentsFiltersContext) => ReactNode
+  readonly labels?: Partial<DocumentsWorkspaceLabels>
+  readonly className?: string
+  readonly classNames?: Partial<DocumentsWorkspaceClassNames>
+  /** Espelhar filtros e paginação na URL. Desligado em preview, onde não há rota de verdade. */
+  readonly syncUrl?: boolean
+}
+
+export interface DocumentsFiltersContext {
+  readonly extra: Readonly<Record<string, string | number>>
+  readonly setExtra: (next: Readonly<Record<string, string | number>>) => void
+}
+
+export function DocumentsWorkspace({
+  perPage: initialPerPage = DEFAULT_PER_PAGE,
+  perPageOptions = DEFAULT_PER_PAGE_OPTIONS,
+  onOpenConversation,
+  sources,
+  categories,
+  dateFilter = true,
+  renderFilters,
+  labels: labelsOverride,
+  className,
+  classNames,
+  syncUrl = true,
+}: DocumentsWorkspaceProps) {
+  const labels = { ...DEFAULT_DOCUMENTS_WORKSPACE_LABELS, ...labelsOverride }
+  const context = useConversations()
+  const urlOptions = { enabled: syncUrl }
+
+  const [search, setSearch] = useUrlStringState('search', '', urlOptions)
+  const [source, setSource] = useUrlArrayState('source', urlOptions)
+  const [category, setCategory] = useUrlArrayState('fileCategory', urlOptions)
+  const [startDate, setStartDate] = useUrlStringState('startDate', '', urlOptions)
+  const [endDate, setEndDate] = useUrlStringState('endDate', '', urlOptions)
+  const [sortField, setSortField] = useUrlStringState('sortField', DEFAULT_SORT_FIELD, urlOptions)
+  const [sortDirection, setSortDirection] = useUrlStringState('sortDirection', 'desc', urlOptions)
+  const [page, setPage] = useUrlNumberState('page', 1, urlOptions)
+  const [perPage, setPerPage] = useUrlNumberState('limit', initialPerPage, urlOptions)
+  const [extra, setExtra] = useState<Readonly<Record<string, string | number>>>({})
+
+  const [documents, setDocuments] = useState<readonly CompanyDocument[]>([])
+  const [total, setTotal] = useState(0)
+  const [loading, setLoading] = useState(false)
+  const [failed, setFailed] = useState(false)
+  const [selectedIds, setSelectedIds] = useState<ReadonlySet<string>>(new Set())
+  const [reloadToken, setReloadToken] = useState(0)
+  const [busy, setBusy] = useState(false)
+  const [uploading, setUploading] = useState(false)
+  const [uploadFailed, setUploadFailed] = useState(false)
+  const fileInputRef = useRef<HTMLInputElement>(null)
+
+  const debouncedSearch = useDebouncedValue(search)
+  const fetchAll = context?.api.getAllDocuments
+  const removeDocument = context?.api.deleteDocument
+  const downloadArchive = context?.api.downloadDocumentsArchiveByIds
+  const uploadDocument = context?.api.uploadDocument
+  const extraKey = JSON.stringify(extra)
+
+  const sourceOptions = useMemo<readonly FilterOption[]>(
+    () => sources ?? Object.entries(labels.sourceLabels).map(([value, label]) => ({ value, label })),
+    [sources, labels.sourceLabels],
+  )
+  const categoryOptions = useMemo<readonly FilterOption[]>(
+    () => categories ?? Object.entries(labels.categoryLabels).map(([value, label]) => ({ value, label })),
+    [categories, labels.categoryLabels],
+  )
+
+  const hasFilters =
+    debouncedSearch !== '' ||
+    source.length > 0 ||
+    category.length > 0 ||
+    startDate !== '' ||
+    endDate !== '' ||
+    Object.keys(extra).length > 0
+
+  useEffect(() => {
+    if (!fetchAll) return
+    let active = true
+    setLoading(true)
+    setFailed(false)
+
+    void fetchAll({
+      search: debouncedSearch || undefined,
+      page,
+      limit: perPage,
+      sortField,
+      sortDirection: sortDirection === 'asc' ? 'asc' : 'desc',
+      ...(source.length > 0 ? { source: source.join(',') } : {}),
+      ...(category.length > 0 ? { fileCategory: category.join(',') } : {}),
+      ...(startDate ? { startDate } : {}),
+      ...(endDate ? { endDate } : {}),
+      ...(Object.keys(extra).length > 0 ? { extra } : {}),
+    })
+      .then((result) => {
+        // `active` evita que uma resposta antiga sobrescreva a nova: digitar rápido na busca dispara
+        // várias chamadas e a ordem de retorno não é garantida.
+        if (!active) return
+        setDocuments(result.documents)
+        setTotal(result.total)
+      })
+      .catch(() => {
+        if (active) setFailed(true)
+      })
+      .finally(() => {
+        if (active) setLoading(false)
+      })
+
+    return () => {
+      active = false
+    }
+    // `extraKey` no lugar de `extra`: o objeto é remontado a cada render do host e a identidade
+    // sozinha dispararia a busca em loop.
+
+  }, [fetchAll, debouncedSearch, source, category, startDate, endDate, sortField, sortDirection, page, perPage, extraKey, reloadToken])
+
+  // Trocar de filtro mantendo a página 7 mostra "nenhum resultado" com dados existindo na página 1.
+  useEffect(() => {
+    setPage(1)
+    setSelectedIds(new Set())
+
+  }, [debouncedSearch, source, category, startDate, endDate, perPage, extraKey])
+
+  function toggleSort(field: string): void {
+    if (sortField === field) setSortDirection(sortDirection === 'asc' ? 'desc' : 'asc')
+    else {
+      setSortField(field)
+      setSortDirection('asc')
+    }
+  }
+
+  function toggleRow(id: string): void {
+    const next = new Set(selectedIds)
+    if (next.has(id)) next.delete(id)
+    else next.add(id)
+    setSelectedIds(next)
+  }
+
+  const isAllSelected = documents.length > 0 && documents.every((document) => selectedIds.has(document.id))
+
+  function toggleAll(): void {
+    setSelectedIds(isAllSelected ? new Set() : new Set(documents.map((document) => document.id)))
+  }
+
+  function clearFilters(): void {
+    setSearch('')
+    setSource([])
+    setCategory([])
+    setStartDate('')
+    setEndDate('')
+    setExtra({})
+  }
+
+  async function handleOpen(uploadId: string, disposition: 'inline' | 'attachment'): Promise<void> {
+    const url = await context?.api.getDocumentUrl(uploadId, disposition)
+    if (url) window.open(url, '_blank', 'noopener,noreferrer')
+  }
+
+  async function handleRemove(ids: readonly string[]): Promise<void> {
+    if (!removeDocument) return
+    setBusy(true)
+    try {
+      await Promise.all(ids.map((id) => removeDocument(id)))
+      setSelectedIds(new Set())
+      setReloadToken((token) => token + 1)
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  async function handleUpload(file: File): Promise<void> {
+    if (!uploadDocument) return
+    setUploading(true)
+    setUploadFailed(false)
+    try {
+      await uploadDocument(file, Object.keys(extra).length > 0 ? extra : undefined)
+      setReloadToken((token) => token + 1)
+    } catch {
+      setUploadFailed(true)
+    } finally {
+      setUploading(false)
+    }
+  }
+
+  async function handleDownloadArchive(): Promise<void> {
+    if (!downloadArchive) return
+    setBusy(true)
+    try {
+      const blob = await downloadArchive(Array.from(selectedIds))
+      const url = URL.createObjectURL(blob)
+      const anchor = document.createElement('a')
+      anchor.href = url
+      anchor.download = 'documentos.zip'
+      anchor.click()
+      URL.revokeObjectURL(url)
+      setSelectedIds(new Set())
+    } finally {
+      setBusy(false)
+    }
+  }
+
+  // Host sem `getAllDocuments` não tem o que mostrar aqui — some, em vez de renderizar vazio para
+  // sempre e fazer parecer que a empresa não tem arquivo nenhum.
+  if (!fetchAll) return null
+
+  const direction: SortDirection = sortDirection === 'asc' ? 'asc' : 'desc'
+  const canSelect = Boolean(removeDocument ?? downloadArchive)
+
+  return (
+    <div className={cn('space-y-4', classNames?.root, className)}>
+      <TooltipLayer />
+      <header className={cn('space-y-0.5', classNames?.header)}>
+        <h2 className="text-lg font-semibold">{labels.title}</h2>
+        <p className="text-sm text-gray-500 dark:text-gray-400">{labels.subtitle(total)}</p>
+      </header>
+
+      <div className={cn('flex flex-wrap items-center gap-2', classNames?.filters)}>
+        <input
+          type="search"
+          value={search}
+          onChange={(event) => setSearch(event.target.value)}
+          placeholder={labels.searchPlaceholder}
+          aria-label={labels.searchPlaceholder}
+          className="w-full rounded-md border border-gray-300 px-3 py-2 text-sm dark:border-gray-700 dark:bg-gray-900 sm:w-64"
+        />
+
+        <MultiSelectFilter label={labels.sourceFilter} options={sourceOptions} selected={source} onChange={setSource} />
+
+        {categoryOptions.length > 0 ? (
+          <MultiSelectFilter
+            label={labels.categoryFilter}
+            options={categoryOptions}
+            selected={category}
+            onChange={setCategory}
+          />
+        ) : null}
+
+        {dateFilter ? (
+          <>
+            <input
+              type="date"
+              value={startDate}
+              onChange={(event) => setStartDate(event.target.value)}
+              aria-label={labels.startDate}
+              className="rounded-md border border-gray-300 px-2 py-2 text-xs dark:border-gray-700 dark:bg-gray-900"
+            />
+            <input
+              type="date"
+              value={endDate}
+              onChange={(event) => setEndDate(event.target.value)}
+              aria-label={labels.endDate}
+              className="rounded-md border border-gray-300 px-2 py-2 text-xs dark:border-gray-700 dark:bg-gray-900"
+            />
+          </>
+        ) : null}
+
+        {renderFilters?.({ extra, setExtra })}
+
+        {hasFilters ? (
+          <button data-cv-tooltip={labels.clearFilters} aria-label={labels.clearFilters} type="button" onClick={clearFilters} className="cv-header-action inline-flex items-center gap-1">
+            <X size={12} aria-hidden="true" />
+            {labels.clearFilters}
+          </button>
+        ) : null}
+
+        {uploadDocument ? (
+          <>
+            <input
+              ref={fileInputRef}
+              type="file"
+              hidden
+              onChange={(event) => {
+                const file = event.target.files?.[0]
+                event.target.value = ''
+                if (file) void handleUpload(file)
+              }}
+            />
+            <button
+              data-cv-tooltip={labels.upload}
+              aria-label={labels.upload}
+              type="button"
+              onClick={() => fileInputRef.current?.click()}
+              disabled={uploading}
+              className="cv-header-action ml-auto inline-flex items-center gap-1 disabled:opacity-40"
+            >
+              <Upload size={12} aria-hidden="true" />
+              {labels.upload}
+            </button>
+          </>
+        ) : null}
+      </div>
+
+      {uploadFailed ? (
+        <p role="alert" className={cn('text-sm text-red-600 dark:text-red-400', classNames?.status)}>
+          {labels.uploadError}
+        </p>
+      ) : null}
+
+      {canSelect ? (
+        <BulkActionBar
+          selectedCount={selectedIds.size}
+          selectedLabel={labels.bulkSelected}
+          clearLabel={labels.bulkClear}
+          onClear={() => setSelectedIds(new Set())}
+        >
+          {downloadArchive ? (
+            <button
+              data-cv-tooltip={labels.bulkDownloadZip} aria-label={labels.bulkDownloadZip}
+              type="button"
+              onClick={() => void handleDownloadArchive()}
+              disabled={busy}
+              className="cv-header-action inline-flex items-center gap-1 disabled:opacity-40"
+            >
+              <Download size={12} aria-hidden="true" />
+              {labels.bulkDownloadZip}
+            </button>
+          ) : null}
+          {removeDocument ? (
+            <button
+              data-cv-tooltip={labels.bulkRemove(selectedIds.size)} aria-label={labels.bulkRemove(selectedIds.size)}
+              type="button"
+              onClick={() => {
+                if (window.confirm(labels.bulkRemoveConfirm(selectedIds.size))) void handleRemove(Array.from(selectedIds))
+              }}
+              disabled={busy}
+              className="cv-header-action cv-header-action--danger inline-flex items-center gap-1 disabled:opacity-40"
+            >
+              <Trash2 size={12} aria-hidden="true" />
+              {labels.bulkRemove(selectedIds.size)}
+            </button>
+          ) : null}
+        </BulkActionBar>
+      ) : null}
+
+      {loading ? <p className={cn('text-sm text-gray-500', classNames?.status)}>{labels.loading}</p> : null}
+      {failed ? (
+        <p role="alert" className={cn('text-sm text-red-600 dark:text-red-400', classNames?.status)}>
+          {labels.failure}
+        </p>
+      ) : null}
+
+      <div className={cn('cv-table-card', classNames?.table)}>
+        <table className="cv-table">
+          <thead>
+            <tr>
+              {canSelect ? (
+                <th scope="col" className="w-10 px-3 py-2">
+                  <input
+                    type="checkbox"
+                    checked={isAllSelected}
+                    onChange={toggleAll}
+                    aria-label={labels.selectAllPage}
+                    className="cursor-pointer rounded border-gray-300 text-blue-600 dark:border-gray-600"
+                  />
+                </th>
+              ) : null}
+              <SortableHead label={labels.columnFilename} field="filename" activeField={sortField} direction={direction} onSort={toggleSort} />
+              <SortableHead label={labels.columnContact} field="conversationId" activeField={sortField} direction={direction} onSort={toggleSort} className="hidden sm:table-cell" />
+              <SortableHead label={labels.columnType} field="mimeType" activeField={sortField} direction={direction} onSort={toggleSort} className="hidden md:table-cell" />
+              <SortableHead label={labels.columnSize} field="sizeBytes" activeField={sortField} direction={direction} onSort={toggleSort} className="hidden lg:table-cell" />
+              <SortableHead label={labels.columnSource} field="source" activeField={sortField} direction={direction} onSort={toggleSort} className="hidden lg:table-cell" />
+              <SortableHead label={labels.columnDate} field="linkedAt" activeField={sortField} direction={direction} onSort={toggleSort} className="hidden xl:table-cell" />
+              <th scope="col" className="px-3 py-2 text-left text-xs font-medium">
+                {labels.columnActions}
+              </th>
+            </tr>
+          </thead>
+          <tbody>
+            {documents.map((document) => (
+              <tr key={`${document.conversationId}:${document.id}`} className={classNames?.row}>
+                {canSelect ? (
+                  <td className="w-10 px-3 py-2">
+                    <input
+                      type="checkbox"
+                      checked={selectedIds.has(document.id)}
+                      onChange={() => toggleRow(document.id)}
+                      aria-label={`${labels.selectRow}: ${document.filename}`}
+                      className="cursor-pointer rounded border-gray-300 text-blue-600 dark:border-gray-600"
+                    />
+                  </td>
+                ) : null}
+
+                <td className="max-w-xs px-3 py-2">
+                  <div className="flex min-w-0 items-center gap-2">
+                    <FileIcon filename={document.filename} mimeType={document.mimeType} />
+                    <span className="truncate font-medium" data-cv-tooltip={document.filename}>
+                      {document.filename}
+                    </span>
+                  </div>
+                </td>
+
+                {/* A conversa de origem é o dado que só esta tela tem. Vira botão quando o host sabe
+                    navegar; sem handler, fica texto — link que não leva a lugar nenhum é pior. */}
+                <td className="hidden px-3 py-2 sm:table-cell">
+                  {onOpenConversation ? (
+                    <button
+                      type="button"
+                      onClick={() => onOpenConversation(document.conversationId)}
+                      data-cv-tooltip={labels.openConversation} aria-label={labels.openConversation}
+                      className="cv-header-action inline-flex items-center gap-1"
+                    >
+                      <MessageSquare size={12} aria-hidden="true" />
+                      {document.contactName ?? formatPhone(document.conversationId)}
+                    </button>
+                  ) : (
+                    <span className="text-xs text-gray-500">{document.contactName ?? formatPhone(document.conversationId)}</span>
+                  )}
+                </td>
+
+                {/* O tipo curto, não o MIME cru: `.docx` responde
+                    `application/vnd.openxmlformats-officedocument.wordprocessingml.document`, que numa
+                    célula sem quebra esticava a coluna a 556px e espremia todas as outras. O MIME
+                    inteiro continua na dica. */}
+                <td className="hidden px-3 py-2 md:table-cell" data-cv-tooltip={document.mimeType}>
+                  <span className="cv-type-tag">{documentTypeLabel(document.filename, document.mimeType)}</span>
+                </td>
+                <td className="hidden whitespace-nowrap px-3 py-2 text-xs lg:table-cell">{formatFileSize(document.sizeBytes)}</td>
+                <td className="hidden whitespace-nowrap px-3 py-2 text-xs lg:table-cell">
+                  {labels.sourceLabels[document.source] ?? document.source}
+                </td>
+                <td className="hidden whitespace-nowrap px-3 py-2 text-xs xl:table-cell">{formatDateTime(document.linkedAt)}</td>
+
+                <td className="px-3 py-2">
+                  <div className="flex gap-1">
+                    <button
+                      type="button"
+                      onClick={() => void handleOpen(document.id, 'inline')}
+                      data-cv-tooltip={labels.view}
+                      aria-label={`${labels.view}: ${document.filename}`}
+                      className="cv-header-icon"
+                    >
+                      <Eye size={14} />
+                    </button>
+                    <button
+                      type="button"
+                      onClick={() => void handleOpen(document.id, 'attachment')}
+                      data-cv-tooltip={labels.download}
+                      aria-label={`${labels.download}: ${document.filename}`}
+                      className="cv-header-icon"
+                    >
+                      <Download size={14} />
+                    </button>
+                    {removeDocument ? (
+                      <button
+                        type="button"
+                        onClick={() => {
+                          if (window.confirm(labels.removeConfirm(document.filename))) void handleRemove([document.id])
+                        }}
+                        disabled={busy}
+                        data-cv-tooltip={labels.remove}
+                        aria-label={`${labels.remove}: ${document.filename}`}
+                        className="cv-header-icon disabled:opacity-40"
+                      >
+                        <Trash2 size={14} className="text-red-500" />
+                      </button>
+                    ) : null}
+                  </div>
+                </td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+
+        {!loading && documents.length === 0 ? (
+          <p className={cn('py-8 text-center text-sm text-gray-400', classNames?.status)}>
+            {hasFilters ? labels.noResults : labels.empty}
+          </p>
+        ) : null}
+      </div>
+
+      <ListingPagination
+        page={page}
+        total={total}
+        perPage={perPage}
+        perPageOptions={perPageOptions}
+        onPageChange={setPage}
+        onPerPageChange={setPerPage}
+        labels={{
+          show: labels.show,
+          perPage: labels.perPage,
+          total: labels.total,
+          page: labels.page,
+          previous: labels.previousPage,
+          next: labels.nextPage,
+        }}
+      />
+    </div>
+  )
+}

package/src/documents/index.ts

@@ -0,0 +1,8 @@
+export { DocumentsWorkspace } from './DocumentsWorkspace'
+export type {
+  DocumentsWorkspaceProps,
+  DocumentsWorkspaceClassNames,
+  DocumentsFiltersContext,
+} from './DocumentsWorkspace'
+export { DEFAULT_DOCUMENTS_WORKSPACE_LABELS } from './labels'
+export type { DocumentsWorkspaceLabels } from './labels'

package/src/documents/labels.ts

@@ -0,0 +1,92 @@
+/**
+ * Vocabulário da biblioteca de arquivos. Sobrescrevível campo a campo: o produto troca "cliente"
+ * por "lead" ou o idioma inteiro sem manter uma cópia da tela para isso.
+ */
+
+export interface DocumentsWorkspaceLabels {
+  readonly title: string
+  readonly subtitle: (total: number) => string
+  readonly searchPlaceholder: string
+  readonly empty: string
+  readonly noResults: string
+  readonly loading: string
+  readonly failure: string
+  readonly view: string
+  readonly download: string
+  readonly remove: string
+  readonly removeConfirm: (filename: string) => string
+  readonly openConversation: string
+  readonly sourceFilter: string
+  readonly categoryFilter: string
+  readonly startDate: string
+  readonly endDate: string
+  readonly clearFilters: string
+  readonly selectAllPage: string
+  readonly selectRow: string
+  readonly bulkSelected: (count: number) => string
+  readonly bulkClear: string
+  readonly bulkDownloadZip: string
+  readonly bulkRemove: (count: number) => string
+  readonly bulkRemoveConfirm: (count: number) => string
+  readonly upload: string
+  readonly uploadError: string
+  readonly columnFilename: string
+  readonly columnContact: string
+  readonly columnType: string
+  readonly columnSize: string
+  readonly columnSource: string
+  readonly columnDate: string
+  readonly columnActions: string
+  readonly sourceLabels: Readonly<Record<string, string>>
+  readonly categoryLabels: Readonly<Record<string, string>>
+  readonly show: string
+  readonly perPage: string
+  readonly total: (count: number) => string
+  readonly page: (current: number, last: number) => string
+  readonly previousPage: string
+  readonly nextPage: string
+}
+
+export const DEFAULT_DOCUMENTS_WORKSPACE_LABELS: DocumentsWorkspaceLabels = {
+  title: 'Documentos',
+  subtitle: (total) => `${total} arquivo${total === 1 ? '' : 's'} trocado${total === 1 ? '' : 's'}`,
+  searchPlaceholder: 'Buscar por nome do arquivo ou telefone',
+  empty: 'Nenhum arquivo trocado ainda.',
+  noResults: 'Nenhum arquivo encontrado para os filtros aplicados.',
+  loading: 'Carregando arquivos…',
+  failure: 'Não foi possível carregar os arquivos.',
+  view: 'Visualizar',
+  download: 'Baixar',
+  remove: 'Excluir',
+  removeConfirm: (filename) => `Excluir "${filename}"?`,
+  openConversation: 'Abrir conversa',
+  sourceFilter: 'Origem',
+  categoryFilter: 'Tipo',
+  startDate: 'De',
+  endDate: 'Até',
+  clearFilters: 'Limpar filtros',
+  selectAllPage: 'Selecionar todos desta página',
+  selectRow: 'Selecionar arquivo',
+  bulkSelected: (count) => `${count} selecionado${count === 1 ? '' : 's'}`,
+  bulkClear: 'Limpar seleção',
+  bulkDownloadZip: 'Baixar em zip',
+  bulkRemove: (count) => `Excluir ${count}`,
+  bulkRemoveConfirm: (count) => `Excluir ${count} arquivo${count === 1 ? '' : 's'}?`,
+  upload: 'Enviar documento',
+  uploadError: 'Não foi possível enviar o arquivo.',
+  columnFilename: 'Arquivo',
+  columnContact: 'Contato',
+  columnType: 'Tipo',
+  columnSize: 'Tamanho',
+  columnSource: 'Origem',
+  columnDate: 'Recebido em',
+  columnActions: 'Ações',
+  sourceLabels: { customer: 'Cliente', agent: 'Atendente', bot: 'Bot' },
+  categoryLabels: { document: 'Documento', image: 'Imagem', audio: 'Áudio', video: 'Vídeo' },
+  show: 'Mostrar',
+  perPage: 'por página',
+  total: (count) => `${count} no total`,
+  page: (current, last) => `${current} / ${last}`,
+  previousPage: 'Página anterior',
+  nextPage: 'Próxima página',
+}