@adatechnology/conversations-ui 0.1.0-rc.39 → 0.1.0-rc.40

package/dist/{chunk-DXPSPUWF.js → chunk-DKPXKQGC.js}

@@ -51,7 +51,7 @@ function TooltipLayer() {
       const origin = event.target;
       if (!(origin instanceof Element)) return;
       const target = origin.closest(`[${TOOLTIP_ATTRIBUTE}]`);
-      if (!(target instanceof HTMLElement)) {
+      if (!target) {
         hide();
         return;
       }

package/dist/flows/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { NodeProps } from '@xyflow/react';
+import { NodeProps, EdgeProps } from '@xyflow/react';
 import { LucideIcon } from 'lucide-react';
 import { FlowConditionOperator, FlowGraphData, FlowNodeData, FlowNodeType, FlowQuestionType, FlowActionKind } from '@adatechnology/meta-whatsapp-contracts';
 export { FlowActionKind, FlowConditionOperator, FlowGraphData, FlowNodeData, FlowNodeNext, FlowNodeType, FlowQuestionType } from '@adatechnology/meta-whatsapp-contracts';
@@ -12,6 +12,15 @@ declare const BUILT_IN_ACTION_KINDS: {
     readonly SEND_PRODUCT_LIST: "send_product_list";
     readonly SEND_MEDIA: "send_media";
 };
+/**
+ * Ações depois das quais a conversa CONTINUA no grafo, em vez de terminar.
+ *
+ * A distinção não é estética: o motor do bot só anda para o `next` depois de `send_media` — as
+ * demais ações (handoff, encerrar, simular, catálogo) encerram o passo ali. Dar saída a uma ação
+ * que o motor não atravessa desenharia um fio que o bot ignora em produção, deixando a conversa
+ * parada sem ninguém entender por quê — o mesmo erro que `resolveConnection` recusa cometer.
+ */
+declare const PASS_THROUGH_ACTION_KINDS: readonly string[];
 declare const CROSS_FLOW_PREFIX = "flow:";
 declare const isCrossFlowTarget: (target: string) => boolean;
 declare const crossFlowKey: (target: string) => string;
@@ -50,6 +59,15 @@ declare function validateGraph(graph: FlowGraphData, issueText: {
     conditionIncomplete: (id: string) => string;
     conditionBranchMissing: (id: string, branch: string) => string;
 }): GraphIssue[];
+/**
+ * Auto-layout em cascata: avança para a direita a cada passo do fluxo e desce a cada card.
+ *
+ * **Um card por linha, sempre.** Empilhar por camada — todos do mesmo nível na mesma coluna, todas
+ * as colunas começando na mesma altura — deixava os fios correndo na horizontal, e um fio horizontal
+ * passa por trás de qualquer card que esteja entre a origem e o destino. Descendo um degrau por
+ * card, toda ligação vira uma diagonal curta e visível, e o caminho da conversa se lê de cima para
+ * baixo enquanto avança da esquerda para a direita.
+ */
 declare function computeAutoLayout(graph: FlowGraphData): Record<string, {
     x: number;
     y: number;
@@ -120,6 +138,25 @@ interface FlowEditorLabels {
         media: string;
         mediaUnavailable: string;
     };
+    quickAdd: {
+        fromHandle: string;
+        title: string;
+        disconnect: string;
+    };
+    /** Legenda do canvas: o que cada traço e cada contorno querem dizer. */
+    legendPanel: {
+        title: string;
+        nodes: string;
+        connections: string;
+        linear: string;
+        branch: string;
+        fallback: string;
+        crossFlow: string;
+        live: string;
+        selfLoop: string;
+        detached: string;
+        startNode: string;
+    };
     palette: {
         title: string;
         question: string;
@@ -222,6 +259,18 @@ type FlowNodeCardData = {
     labels: FlowEditorLabels;
     actionKindIcons?: Record<string, LucideIcon>;
     onSelect: (id: string) => void;
+    /**
+     * Criar o próximo nó já ligado nesta saída. Capacidade por ausência: sem o callback, o "+" não
+     * aparece — puxar o fio à mão continua funcionando igual.
+     */
+    onQuickAdd?: ((params: {
+        nodeId: string;
+        handle: string;
+        anchor: {
+            x: number;
+            y: number;
+        };
+    }) => void) | undefined;
 };
 declare function FlowNodeCard({ data }: NodeProps): react.JSX.Element;
 declare const flowNodeTypes: {
@@ -297,8 +346,41 @@ interface FlowPaletteProps {
     labels?: Partial<FlowEditorLabels>;
     actionOptions?: FlowPaletteActionOption[];
 }
+interface FlowPaletteMenuProps {
+    onSelect: (spec: NewNodeSpec) => void;
+    labels: FlowEditorLabels;
+    actionOptions?: FlowPaletteActionOption[];
+}
+/**
+ * A lista de tipos de nó, sem o botão que a abre.
+ *
+ * Separada porque o "+" do card abre exatamente esta lista: duplicar os itens era garantir que um
+ * tipo novo aparecesse num caminho e faltasse no outro.
+ */
+declare function FlowPaletteMenu({ onSelect, labels, actionOptions }: FlowPaletteMenuProps): react.JSX.Element;
 declare function FlowPalette({ onAdd, labels: labelsOverride, actionOptions }: FlowPaletteProps): react.JSX.Element;
 
+type FlowLegendEdgeSample = {
+    readonly color: string;
+    readonly dash?: string | undefined;
+    readonly label: string;
+};
+type FlowLegendProps = {
+    readonly labels: FlowEditorLabels;
+    readonly edgeSamples: readonly FlowLegendEdgeSample[];
+    /** Classe de cor por tipo de card — a mesma que o `FlowNodeCard` usa, para a chave bater. */
+    readonly nodeSwatches: readonly {
+        readonly type: FlowNodeType;
+        readonly className: string;
+    }[];
+};
+declare function FlowLegend({ labels, edgeSamples, nodeSwatches }: FlowLegendProps): react.JSX.Element;
+
+declare function FlowConnectionEdge({ id, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, markerEnd, style, data, interactionWidth, }: EdgeProps): react.JSX.Element;
+declare const flowEdgeTypes: {
+    flowConnection: typeof FlowConnectionEdge;
+};
+
 interface FlowNodePanelProps {
     graph: FlowGraphData;
     node: FlowNodeData;
@@ -388,11 +470,12 @@ declare function countLiveByNode(params: {
     readonly positions: readonly FlowLivePositionInput[] | undefined;
 }): Record<string, number>;
 /**
- * Um layout só para TODOS os nós de TODOS os fluxos abertos juntos.
+ * Um layout só para TODOS os nós de TODOS os fluxos abertos juntos, na mesma cascata do fluxo
+ * único: um passo para a direita a cada avanço da conversa, um degrau para baixo a cada card.
  *
  * Posicionar cada fluxo à parte e deslocar não resolve: nada impede dois fluxos de ocuparem o mesmo
- * espaço, e a altura real de cada card é ignorada. Aqui o ranqueamento por BFS roda sobre o grafo
- * mesclado inteiro, com os saltos `flow:<key>` já resolvidos para o nó inicial do alvo.
+ * espaço, e a altura real de cada card é ignorada. Aqui a travessia roda sobre o grafo mesclado
+ * inteiro, com os saltos `flow:<key>` já resolvidos para o nó inicial do alvo.
  */
 declare function computeMergedLayout(params: {
     readonly openKeys: readonly string[];
@@ -577,4 +660,4 @@ declare function applyConnection(node: FlowNodeData, resolved: ResolvedConnectio
  */
 declare function isGraphDirty(working: FlowGraphData | undefined, published: FlowGraphData | undefined): boolean;
 
-export { BUILT_IN_ACTION_KINDS, CONDITION_OPERATORS, CROSS_FLOW_PREFIX, type CollectionChain, type ConnectionRequest, type CreateFlowInput, DEFAULT_FLOW_EDITOR_LABELS, type FlowEdgeKind, type FlowEdgeSpec, type FlowEditorLabels, FlowGroupFrame, type FlowGroupFrameData, FlowGroupHeader, type FlowGroupHeaderData, type FlowLiveNodeCount, type FlowLivePosition, type FlowLivePositionInput, FlowMapCanvas, type FlowMapCanvasProps, FlowMapNode, type FlowMapNodeData, FlowNodeCard, type FlowNodeCardData, FlowNodePanel, type FlowNodePanelProps, type FlowNodePosition, FlowPalette, type FlowPaletteActionOption, type FlowPaletteProps, FlowPortalNode, type FlowPortalNodeData, type FlowValidationLabels, FlowWhatsAppPreview, type FlowWhatsAppPreviewProps, FlowsWorkspace, type FlowsWorkspaceApi, type FlowsWorkspaceProps, GROUP_HEADER_NODE_ID, type GraphIssue, NODE_CARD_WIDTH, type NewNodeSpec, type ResolvedConnection, WHATSAPP_LIMITS, applyConnection, buildFlowEdges, chainFrameBounds, chainFrameNodeId, computeAutoLayout, computeFlowMapLayout, computeMergedLayout, countLiveByNode, crossFlowKey, crossFlowTargetsOf, detachedNodeIds, estimateNodeHeight, findCollectionChains, flowGroupFrameNodeTypes, flowGroupHeaderNodeTypes, flowMapNodeTypes, flowNodeTypes, flowPortalNodeTypes, isCrossFlowTarget, isGraphDirty, mergeFlowEditorLabels, mergedFlowKeysFrom, namespaceNodeId, newNodeFromSpec, nodeLabel, parseNamespacedId, portalNodeId, removeNodeAndCleanRefs, rendersAsButtons, resolveConnection, slugifyNodeId, targetsOf, validateGraph };
+export { BUILT_IN_ACTION_KINDS, CONDITION_OPERATORS, CROSS_FLOW_PREFIX, type CollectionChain, type ConnectionRequest, type CreateFlowInput, DEFAULT_FLOW_EDITOR_LABELS, FlowConnectionEdge, type FlowEdgeKind, type FlowEdgeSpec, type FlowEditorLabels, FlowGroupFrame, type FlowGroupFrameData, FlowGroupHeader, type FlowGroupHeaderData, FlowLegend, type FlowLiveNodeCount, type FlowLivePosition, type FlowLivePositionInput, FlowMapCanvas, type FlowMapCanvasProps, FlowMapNode, type FlowMapNodeData, FlowNodeCard, type FlowNodeCardData, FlowNodePanel, type FlowNodePanelProps, type FlowNodePosition, FlowPalette, type FlowPaletteActionOption, FlowPaletteMenu, type FlowPaletteProps, FlowPortalNode, type FlowPortalNodeData, type FlowValidationLabels, FlowWhatsAppPreview, type FlowWhatsAppPreviewProps, FlowsWorkspace, type FlowsWorkspaceApi, type FlowsWorkspaceProps, GROUP_HEADER_NODE_ID, type GraphIssue, NODE_CARD_WIDTH, type NewNodeSpec, PASS_THROUGH_ACTION_KINDS, type ResolvedConnection, WHATSAPP_LIMITS, applyConnection, buildFlowEdges, chainFrameBounds, chainFrameNodeId, computeAutoLayout, computeFlowMapLayout, computeMergedLayout, countLiveByNode, crossFlowKey, crossFlowTargetsOf, detachedNodeIds, estimateNodeHeight, findCollectionChains, flowEdgeTypes, flowGroupFrameNodeTypes, flowGroupHeaderNodeTypes, flowMapNodeTypes, flowNodeTypes, flowPortalNodeTypes, isCrossFlowTarget, isGraphDirty, mergeFlowEditorLabels, mergedFlowKeysFrom, namespaceNodeId, newNodeFromSpec, nodeLabel, parseNamespacedId, portalNodeId, removeNodeAndCleanRefs, rendersAsButtons, resolveConnection, slugifyNodeId, targetsOf, validateGraph };