@adatechnology/conversations-ui 0.1.0-rc.3 → 0.1.0-rc.30

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',
+}

package/src/emojiCatalog.test.ts

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'bun:test'
+import { EMOJI_CATEGORIES, searchEmojis } from './emojiCatalog'
+
+describe('searchEmojis', () => {
+  it('devolve o catálogo inteiro quando não há termo', () => {
+    const total = EMOJI_CATEGORIES.reduce((sum, category) => sum + category.entries.length, 0)
+    expect(searchEmojis('').length).toBe(total)
+    expect(searchEmojis('   ').length).toBe(total)
+  })
+
+  it('acha pela palavra sem acento e com acento', () => {
+    const semAcento = searchEmojis('coracao').map((entry) => entry.emoji)
+    const comAcento = searchEmojis('coração').map((entry) => entry.emoji)
+
+    expect(semAcento).toContain('❤️')
+    expect(comAcento).toContain('❤️')
+  })
+
+  it('ignora caixa e casa por prefixo, não pelo meio da palavra', () => {
+    expect(searchEmojis('CASA').map((entry) => entry.emoji)).toContain('🏠')
+    // "sa" está dentro de "casa", mas não é prefixo de nenhuma palavra-chave dela.
+    expect(searchEmojis('sa').map((entry) => entry.emoji)).not.toContain('🏠')
+  })
+
+  it('atravessa categorias, não só a aberta', () => {
+    const resultados = searchEmojis('pagamento').map((entry) => entry.emoji)
+
+    expect(resultados).toContain('💳')
+    expect(resultados.length).toBeGreaterThan(1)
+  })
+
+  it('devolve vazio quando nada casa, em vez de cair no catálogo inteiro', () => {
+    expect(searchEmojis('xyzabc')).toEqual([])
+  })
+})

package/src/emojiCatalog.ts

@@ -0,0 +1,189 @@
+/**
+ * Catálogo de emojis com palavras-chave em português, usado pela busca do seletor.
+ *
+ * Fica em módulo próprio (e não dentro do `EmojiPicker`) porque a busca precisa varrer TODAS as
+ * categorias, não só a aberta — o índice é montado uma vez, no carregamento, e não a cada tecla.
+ *
+ * As palavras-chave são de busca, não legendas: incluem sinônimos e formas sem acento, porque quem
+ * digita rápido escreve "coracao" e "polegar" com a mesma frequência que a forma correta.
+ */
+
+export type EmojiEntry = {
+  readonly emoji: string
+  readonly keywords: readonly string[]
+}
+
+export type EmojiCategory = {
+  readonly name: string
+  readonly entries: readonly EmojiEntry[]
+}
+
+export const EMOJI_CATEGORIES: readonly EmojiCategory[] = [
+  {
+    name: 'Smileys',
+    entries: [
+      { emoji: '😀', keywords: ['sorriso', 'feliz', 'alegre'] },
+      { emoji: '😃', keywords: ['sorriso', 'feliz', 'animado'] },
+      { emoji: '😄', keywords: ['sorriso', 'feliz', 'risada'] },
+      { emoji: '😁', keywords: ['sorriso', 'dentes', 'feliz'] },
+      { emoji: '😅', keywords: ['alivio', 'alívio', 'suor', 'nervoso'] },
+      { emoji: '😂', keywords: ['risada', 'chorando', 'engracado', 'engraçado'] },
+      { emoji: '🤣', keywords: ['risada', 'rolando', 'engracado', 'engraçado'] },
+      { emoji: '😊', keywords: ['sorriso', 'timido', 'tímido', 'feliz'] },
+      { emoji: '😇', keywords: ['anjo', 'inocente', 'santo'] },
+      { emoji: '🙂', keywords: ['sorriso', 'leve', 'ok'] },
+      { emoji: '😉', keywords: ['piscada', 'piscar', 'flerte'] },
+      { emoji: '😌', keywords: ['aliviado', 'calmo', 'tranquilo'] },
+      { emoji: '😍', keywords: ['amor', 'apaixonado', 'coracao', 'coração', 'olhos'] },
+      { emoji: '🥰', keywords: ['amor', 'apaixonado', 'carinho'] },
+      { emoji: '😘', keywords: ['beijo', 'amor', 'carinho'] },
+      { emoji: '😋', keywords: ['gostoso', 'delicia', 'delícia', 'lingua', 'língua'] },
+      { emoji: '😜', keywords: ['lingua', 'língua', 'brincadeira', 'piscada'] },
+      { emoji: '🤪', keywords: ['maluco', 'doido', 'brincadeira'] },
+      { emoji: '🤔', keywords: ['pensando', 'duvida', 'dúvida', 'hmm'] },
+      { emoji: '🤗', keywords: ['abraco', 'abraço', 'carinho'] },
+      { emoji: '😐', keywords: ['neutro', 'serio', 'sério', 'indiferente'] },
+      { emoji: '😴', keywords: ['dormindo', 'sono', 'cansado'] },
+      { emoji: '😭', keywords: ['chorando', 'triste', 'lagrima', 'lágrima'] },
+      { emoji: '😢', keywords: ['triste', 'chorando', 'lagrima', 'lágrima'] },
+      { emoji: '😡', keywords: ['raiva', 'bravo', 'irritado'] },
+      { emoji: '😱', keywords: ['susto', 'medo', 'assustado'] },
+      { emoji: '🤯', keywords: ['explodindo', 'chocado', 'surpresa'] },
+      { emoji: '😎', keywords: ['oculos', 'óculos', 'legal', 'estiloso'] },
+      { emoji: '🥳', keywords: ['festa', 'comemorar', 'aniversario', 'aniversário'] },
+      { emoji: '😷', keywords: ['mascara', 'máscara', 'doente', 'saude', 'saúde'] },
+    ],
+  },
+  {
+    name: 'Gestos',
+    entries: [
+      { emoji: '👍', keywords: ['joia', 'jóia', 'polegar', 'ok', 'positivo', 'curtir'] },
+      { emoji: '👎', keywords: ['polegar', 'negativo', 'ruim', 'nao', 'não'] },
+      { emoji: '👌', keywords: ['ok', 'certo', 'perfeito'] },
+      { emoji: '✌️', keywords: ['paz', 'vitoria', 'vitória', 'dois'] },
+      { emoji: '🤞', keywords: ['sorte', 'dedos', 'cruzados', 'torcendo'] },
+      { emoji: '🤙', keywords: ['chama', 'ligar', 'shaka'] },
+      { emoji: '👋', keywords: ['tchau', 'ola', 'olá', 'aceno', 'oi'] },
+      { emoji: '✋', keywords: ['mao', 'mão', 'parar', 'pare'] },
+      { emoji: '👏', keywords: ['palmas', 'aplauso', 'parabens', 'parabéns'] },
+      { emoji: '🙌', keywords: ['comemorar', 'maos', 'mãos', 'sucesso'] },
+      { emoji: '🤝', keywords: ['acordo', 'aperto', 'mao', 'mão', 'negocio', 'negócio', 'parceria'] },
+      { emoji: '🙏', keywords: ['obrigado', 'reza', 'oracao', 'oração', 'por favor'] },
+      { emoji: '✍️', keywords: ['escrever', 'assinar', 'assinatura'] },
+      { emoji: '💪', keywords: ['forca', 'força', 'musculo', 'músculo', 'braco', 'braço'] },
+      { emoji: '👇', keywords: ['abaixo', 'baixo', 'apontar', 'seta'] },
+      { emoji: '👉', keywords: ['direita', 'apontar', 'seta'] },
+      { emoji: '☝️', keywords: ['acima', 'cima', 'apontar', 'atencao', 'atenção'] },
+    ],
+  },
+  {
+    name: 'Corações',
+    entries: [
+      { emoji: '❤️', keywords: ['coracao', 'coração', 'amor', 'vermelho'] },
+      { emoji: '🧡', keywords: ['coracao', 'coração', 'laranja'] },
+      { emoji: '💛', keywords: ['coracao', 'coração', 'amarelo'] },
+      { emoji: '💚', keywords: ['coracao', 'coração', 'verde'] },
+      { emoji: '💙', keywords: ['coracao', 'coração', 'azul'] },
+      { emoji: '💜', keywords: ['coracao', 'coração', 'roxo'] },
+      { emoji: '🖤', keywords: ['coracao', 'coração', 'preto'] },
+      { emoji: '🤍', keywords: ['coracao', 'coração', 'branco'] },
+      { emoji: '💔', keywords: ['coracao', 'coração', 'partido', 'triste'] },
+      { emoji: '💕', keywords: ['coracao', 'coração', 'amor', 'casal'] },
+      { emoji: '💖', keywords: ['coracao', 'coração', 'brilho', 'amor'] },
+      { emoji: '💝', keywords: ['coracao', 'coração', 'presente', 'laco', 'laço'] },
+    ],
+  },
+  {
+    name: 'Negócios',
+    entries: [
+      { emoji: '🏠', keywords: ['casa', 'imovel', 'imóvel', 'residencia', 'residência', 'moradia'] },
+      { emoji: '🏡', keywords: ['casa', 'imovel', 'imóvel', 'jardim', 'moradia'] },
+      { emoji: '🏢', keywords: ['predio', 'prédio', 'empresa', 'escritorio', 'escritório'] },
+      { emoji: '🏦', keywords: ['banco', 'financiamento', 'agencia', 'agência'] },
+      { emoji: '🔑', keywords: ['chave', 'casa', 'entrega', 'imovel', 'imóvel'] },
+      { emoji: '📄', keywords: ['documento', 'papel', 'contrato', 'arquivo'] },
+      { emoji: '📋', keywords: ['prancheta', 'lista', 'documento', 'checklist'] },
+      { emoji: '📝', keywords: ['anotar', 'escrever', 'nota', 'formulario', 'formulário'] },
+      { emoji: '✅', keywords: ['ok', 'certo', 'aprovado', 'concluido', 'concluído', 'check'] },
+      { emoji: '❌', keywords: ['errado', 'negado', 'recusado', 'cancelar'] },
+      { emoji: '⚠️', keywords: ['atencao', 'atenção', 'alerta', 'cuidado'] },
+      { emoji: '💰', keywords: ['dinheiro', 'valor', 'saco', 'grana', 'pagamento'] },
+      { emoji: '💵', keywords: ['dinheiro', 'nota', 'valor', 'pagamento'] },
+      { emoji: '💳', keywords: ['cartao', 'cartão', 'credito', 'crédito', 'pagamento'] },
+      { emoji: '🧾', keywords: ['recibo', 'nota', 'fiscal', 'comprovante'] },
+      { emoji: '📊', keywords: ['grafico', 'gráfico', 'relatorio', 'relatório', 'dados'] },
+      { emoji: '📈', keywords: ['grafico', 'gráfico', 'subindo', 'crescimento', 'alta'] },
+      { emoji: '📉', keywords: ['grafico', 'gráfico', 'caindo', 'queda', 'baixa'] },
+      { emoji: '🗓️', keywords: ['calendario', 'calendário', 'data', 'agenda', 'prazo'] },
+      { emoji: '⏰', keywords: ['relogio', 'relógio', 'hora', 'prazo', 'alarme'] },
+      { emoji: '📞', keywords: ['telefone', 'ligar', 'contato', 'chamada'] },
+      { emoji: '📱', keywords: ['celular', 'telefone', 'whatsapp', 'contato'] },
+      { emoji: '📧', keywords: ['email', 'e-mail', 'mensagem', 'contato'] },
+      { emoji: '📎', keywords: ['anexo', 'clipe', 'arquivo'] },
+      { emoji: '🔍', keywords: ['buscar', 'procurar', 'lupa', 'pesquisa', 'consulta'] },
+      { emoji: '🤖', keywords: ['robo', 'robô', 'bot', 'assistente', 'automatico', 'automático'] },
+      { emoji: '💬', keywords: ['mensagem', 'conversa', 'balao', 'balão', 'chat'] },
+    ],
+  },
+  {
+    name: 'Objetos',
+    entries: [
+      { emoji: '🎁', keywords: ['presente', 'brinde', 'surpresa'] },
+      { emoji: '🎉', keywords: ['festa', 'comemorar', 'parabens', 'parabéns'] },
+      { emoji: '🎊', keywords: ['festa', 'confete', 'comemorar'] },
+      { emoji: '🎂', keywords: ['bolo', 'aniversario', 'aniversário', 'festa'] },
+      { emoji: '💡', keywords: ['ideia', 'ideía', 'lampada', 'lâmpada', 'dica'] },
+      { emoji: '🔔', keywords: ['sino', 'aviso', 'notificacao', 'notificação', 'lembrete'] },
+      { emoji: '⭐', keywords: ['estrela', 'favorito', 'avaliacao', 'avaliação'] },
+      { emoji: '🔥', keywords: ['fogo', 'quente', 'destaque', 'top'] },
+      { emoji: '🚀', keywords: ['foguete', 'rapido', 'rápido', 'lancamento', 'lançamento'] },
+      { emoji: '💻', keywords: ['computador', 'notebook', 'trabalho'] },
+      { emoji: '📷', keywords: ['foto', 'camera', 'câmera', 'imagem'] },
+      { emoji: '🚗', keywords: ['carro', 'veiculo', 'veículo', 'automovel', 'automóvel'] },
+      { emoji: '✈️', keywords: ['aviao', 'avião', 'viagem', 'voo'] },
+    ],
+  },
+  {
+    name: 'Comida',
+    entries: [
+      { emoji: '🍔', keywords: ['hamburguer', 'hambúrguer', 'lanche', 'comida'] },
+      { emoji: '🍕', keywords: ['pizza', 'comida', 'lanche'] },
+      { emoji: '🍟', keywords: ['batata', 'frita', 'lanche'] },
+      { emoji: '🍿', keywords: ['pipoca', 'cinema', 'filme'] },
+      { emoji: '🍞', keywords: ['pao', 'pão', 'padaria'] },
+      { emoji: '🧀', keywords: ['queijo', 'comida'] },
+      { emoji: '🥗', keywords: ['salada', 'saudavel', 'saudável', 'comida'] },
+      { emoji: '☕', keywords: ['cafe', 'café', 'bebida', 'quente'] },
+      { emoji: '🍺', keywords: ['cerveja', 'bebida', 'chopp'] },
+      { emoji: '🍷', keywords: ['vinho', 'bebida', 'taca', 'taça'] },
+      { emoji: '🥂', keywords: ['brinde', 'comemorar', 'champanhe'] },
+      { emoji: '🥤', keywords: ['refrigerante', 'bebida', 'copo'] },
+    ],
+  },
+] as const
+
+/**
+ * Índice achatado: a busca ignora categoria, porque quem digita "casa" quer o resultado venha de
+ * onde vier. A ordem preserva a das categorias, então o resultado sai agrupado por afinidade sem
+ * precisar ordenar.
+ */
+const ALL_ENTRIES: readonly EmojiEntry[] = EMOJI_CATEGORIES.flatMap((category) => category.entries)
+
+function normalize(value: string): string {
+  return value
+    .toLowerCase()
+    .normalize('NFD')
+    .replace(/\p{Diacritic}/gu, '')
+    .trim()
+}
+
+/**
+ * Busca por prefixo de palavra-chave, não por substring: "ca" traz "casa" e "cartão", mas "sa" não
+ * traz "casa" — casar no meio da palavra devolvia resultado que ninguém consegue explicar.
+ */
+export function searchEmojis(query: string): readonly EmojiEntry[] {
+  const term = normalize(query)
+  if (!term) return ALL_ENTRIES
+
+  return ALL_ENTRIES.filter((entry) => entry.keywords.some((keyword) => normalize(keyword).startsWith(term)))
+}

package/src/flows/FlowGroupHeader.tsx

@@ -18,10 +18,20 @@ export function FlowGroupHeader({ data }: NodeProps) {
   return (
     <div className="flex items-center gap-2 rounded-full border border-cyan-300 dark:border-cyan-700 bg-cyan-50 dark:bg-cyan-950/50 px-3 py-1 text-xs font-medium text-cyan-800 dark:text-cyan-200 shadow-sm whitespace-nowrap">
       <span>{label}</span>
-      <button type="button" onClick={onFocus} title={labels.flowGroup.focus} className="hover:text-blue-600 dark:hover:text-blue-400">
+      <button
+        type="button"
+        onClick={onFocus}
+        data-cv-tooltip={labels.flowGroup.focus} aria-label={labels.flowGroup.focus}
+        className="hover:text-blue-600 dark:hover:text-blue-400"
+      >
         <Maximize2 size={12} />
       </button>
-      <button type="button" onClick={onClose} title={labels.flowGroup.close} className="hover:text-red-600 dark:hover:text-red-400">
+      <button
+        type="button"
+        onClick={onClose}
+        data-cv-tooltip={labels.flowGroup.close} aria-label={labels.flowGroup.close}
+        className="hover:text-red-600 dark:hover:text-red-400"
+      >
         <X size={12} />
       </button>
     </div>

package/src/flows/FlowMapCanvas.tsx

@@ -27,18 +27,21 @@ export function FlowMapCanvas({ graphs, rootKey, onOpenFlow, labels: labelsOverr
   const positions = useMemo(() => computeFlowMapLayout(graphs, rootKey), [graphs, rootKey])
 
   const nodes = useMemo<Node[]>(
-    () => Object.values(graphs).map((g): Node => ({
-      id: g.key,
-      type: 'flowMapNode',
-      position: positions[g.key] ?? { x: 0, y: 0 },
-      data: {
-        label: g.label,
-        nodeCount: Object.keys(g.nodes).length,
-        isRoot: g.key === rootKey,
-        labels,
-        onOpen: () => onOpenFlow(g.key),
-      } satisfies FlowMapNodeData,
-    })),
+    () =>
+      Object.values(graphs).map(
+        (g): Node => ({
+          id: g.key,
+          type: 'flowMapNode',
+          position: positions[g.key] ?? { x: 0, y: 0 },
+          data: {
+            label: g.label,
+            nodeCount: Object.keys(g.nodes).length,
+            isRoot: g.key === rootKey,
+            labels,
+            onOpen: () => onOpenFlow(g.key),
+          } satisfies FlowMapNodeData,
+        }),
+      ),
     [graphs, positions, rootKey, onOpenFlow, labels],
   )
 

package/src/flows/FlowMapNode.tsx

@@ -21,10 +21,13 @@ export function FlowMapNode({ data }: NodeProps) {
       <div className="flex items-center gap-1.5 text-emerald-700 dark:text-emerald-300">
         <GitBranch size={14} />
         <span className="text-sm font-semibold truncate">{label}</span>
-        {isRoot && <span className="h-1.5 w-1.5 rounded-full bg-emerald-500 shrink-0" title={labels.startNodeTooltip} />}
+        {isRoot && (
+          <span className="h-1.5 w-1.5 rounded-full bg-emerald-500 shrink-0" data-cv-tooltip={labels.startNodeTooltip} />
+        )}
       </div>
       <p className="text-xs text-gray-500 dark:text-gray-400 mt-1">{labels.flowMap.nodeCount(nodeCount)}</p>
       <button
+        data-cv-tooltip={labels.flowMap.openFlow} aria-label={labels.flowMap.openFlow}
         type="button"
         onClick={onOpen}
         className="mt-2 inline-flex items-center gap-1 text-xs font-medium text-blue-600 dark:text-blue-400 hover:underline"

package/src/flows/FlowNodeCard.tsx

@@ -1,5 +1,17 @@
 import { Handle, Position, type NodeProps } from '@xyflow/react'
-import { MessageCircleQuestion, GitBranch, Zap, ListTree, Diamond, AlertTriangle, AlertCircle, Headset, Clock3, ShoppingBag, type LucideIcon } from 'lucide-react'
+import {
+  MessageCircleQuestion,
+  GitBranch,
+  Zap,
+  ListTree,
+  Diamond,
+  AlertTriangle,
+  AlertCircle,
+  Headset,
+  Clock3,
+  ShoppingBag,
+  type LucideIcon,
+} from 'lucide-react'
 import type { FlowEditorLabels } from './labels'
 import type { FlowNodeData, GraphIssue } from './flowGraph'
 
@@ -31,6 +43,9 @@ const DEFAULT_ACTION_KIND_ICON: Record<string, LucideIcon> = {
 // que só faz sentido para quem escreveu o interpretador do fluxo, não para quem está editando.
 export function nodeLabel(node: FlowNodeData | undefined, labels: FlowEditorLabels): string {
   if (!node) return '—'
+  // Apelido dado no editor manda sobre qualquer texto derivado: dois nós de mesma ação ficam
+  // idênticos no card sem ele, e é exatamente para desempatá-los que o campo existe.
+  if (node.label) return node.label
   if (node.type === 'action') {
     const actionKindLabel = node.actionKind ? labels.actionKindLabels[node.actionKind] : undefined
     // Sempre retorna string: um actionKind futuro sem label mapeado cai no próprio valor bruto
@@ -50,6 +65,12 @@ export type FlowNodeCardData = {
   liveCount: number
   isStart: boolean
   isSelected: boolean
+  /**
+   * Nó sem nenhuma ligação de entrada — o bot nunca chega nele. Contorno tracejado e pulso: sem
+   * isso, desconectar um fio ou criar um card solto passa despercebido até o fluxo quebrar em
+   * produção.
+   */
+  isDetached?: boolean
   issues: GraphIssue[]
   labels: FlowEditorLabels
   actionKindIcons?: Record<string, LucideIcon>
@@ -83,7 +104,9 @@ function sourceRows(node: FlowNodeData, labels: FlowEditorLabels): { id: string;
 function SourceRow({ label, isDefault, handleId }: { label: string; isDefault: boolean; handleId: string }) {
   return (
     <div className="relative flex items-center gap-1.5 rounded-md border border-gray-200 dark:border-gray-600 bg-white/70 dark:bg-gray-900/40 px-2 py-1 pr-3">
-      <span className={`text-xs truncate flex-1 ${isDefault ? 'italic text-gray-400 dark:text-gray-500' : 'text-gray-700 dark:text-gray-200'}`}>
+      <span
+        className={`text-xs truncate flex-1 ${isDefault ? 'italic text-gray-400 dark:text-gray-500' : 'text-gray-700 dark:text-gray-200'}`}
+      >
         {label}
       </span>
       <Handle
@@ -98,18 +121,22 @@ function SourceRow({ label, isDefault, handleId }: { label: string; isDefault: b
 }
 
 export function FlowNodeCard({ data }: NodeProps) {
-  const { node, liveCount, isStart, isSelected, issues, labels, actionKindIcons, onSelect } = data as unknown as FlowNodeCardData
+  const { node, liveCount, isStart, isSelected, isDetached, issues, labels, actionKindIcons, onSelect } =
+    data as unknown as FlowNodeCardData
   const label = nodeLabel(node, labels)
   const iconMap = { ...DEFAULT_ACTION_KIND_ICON, ...actionKindIcons }
-  const Icon = node.type === 'action' && node.actionKind ? (iconMap[node.actionKind] ?? NODE_TYPE_ICON[node.type]) : NODE_TYPE_ICON[node.type]
+  const Icon =
+    node.type === 'action' && node.actionKind
+      ? (iconMap[node.actionKind] ?? NODE_TYPE_ICON[node.type])
+      : NODE_TYPE_ICON[node.type]
   const rows = sourceRows(node, labels)
   const hasError = issues.some((i) => i.severity === 'error')
   const hasWarning = !hasError && issues.some((i) => i.severity === 'warning')
 
   return (
     <div
-      title={label}
-      className={`relative rounded-lg border-2 px-3 py-2 w-60 cursor-pointer shadow-sm hover:shadow-md transition-shadow ${NODE_TYPE_COLOR[node.type]} ${isSelected ? 'ring-2 ring-blue-500 ring-offset-2 dark:ring-offset-gray-900' : ''}`}
+      data-cv-tooltip={isDetached ? labels.detachedNodeTooltip : label}
+      className={`relative rounded-lg border-2 px-3 py-2 w-60 cursor-pointer shadow-sm hover:shadow-md transition-shadow ${NODE_TYPE_COLOR[node.type]} ${isSelected ? 'ring-2 ring-blue-500 ring-offset-2 dark:ring-offset-gray-900' : ''} ${isDetached ? 'border-dashed !border-amber-400 animate-pulse' : ''}`}
       onClick={() => onSelect(node.id)}
     >
       <Handle type="target" position={Position.Top} id="target" className="!bg-gray-400 dark:!bg-gray-500" />
@@ -117,7 +144,7 @@ export function FlowNodeCard({ data }: NodeProps) {
       <div className="flex items-center justify-between gap-2">
         <span className="flex items-center gap-1.5 uppercase tracking-wide font-semibold text-gray-500 dark:text-gray-400 text-xs">
           <Icon size={12} strokeWidth={2.5} />
-          {isStart && <span className="h-1.5 w-1.5 rounded-full bg-emerald-500" title={labels.startNodeTooltip} />}
+          {isStart && <span className="h-1.5 w-1.5 rounded-full bg-emerald-500" data-cv-tooltip={labels.startNodeTooltip} />}
           {labels.legend[node.type]}
         </span>
         <div className="flex items-center gap-1">
@@ -125,7 +152,7 @@ export function FlowNodeCard({ data }: NodeProps) {
           {hasWarning && <AlertTriangle size={13} className="text-amber-500 dark:text-amber-400" />}
           {liveCount > 0 && (
             <span
-              title={labels.liveCountTooltip(liveCount)}
+              data-cv-tooltip={labels.liveCountTooltip(liveCount)}
               className="font-bold bg-blue-600 text-white rounded-full px-1.5 py-0.5 text-xs"
             >
               {liveCount}