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

package/dist/flows/index.d.ts

@@ -329,13 +329,109 @@ interface FlowWhatsAppPreviewProps {
 }
 declare function FlowWhatsAppPreview({ body, options, labels, }: FlowWhatsAppPreviewProps): react.JSX.Element;
 
-/** Onde cada conversa viva está parada agora, para o card pulsar com a contagem. */
-interface FlowLivePosition {
-    currentState: string;
-    flow: string | null;
-    nodeId: string | null;
-    menuNodeId: string | null;
-}
+/**
+ * Derivações puras do canvas do editor: posições, arestas, contagem de conversas vivas e o nó que
+ * nasce de cada item da paleta.
+ *
+ * Viviam dentro do componente, e é ali que estava o risco. Uma aresta com destino errado não pinta
+ * errado — ela leva a conversa do cliente para o lugar errado, e o sintoma aparece longe de quem
+ * editou. Um card que o layout joga para fora da área visível se lê como "apaguei sem querer".
+ *
+ * A topologia sai daqui em forma neutra (`FlowEdgeSpec`) e o estilo fica no componente: o teste cobra
+ * o que importa e roda sem navegador nem `@xyflow/react`. Cor de traço ninguém quebra sem ver.
+ */
+
+type FlowNodePosition = {
+    readonly x: number;
+    readonly y: number;
+};
+/** Onde cada conversa viva está parada agora. */
+type FlowLivePosition = {
+    readonly currentState: string;
+    readonly flow: string | null;
+    readonly nodeId: string | null;
+    readonly menuNodeId: string | null;
+};
+/**
+ * Pseudo-nó que representa um fluxo alvo ainda não mesclado no canvas.
+ *
+ * Um portal por (nó de origem, fluxo alvo): duas opções do mesmo nó indo para o mesmo fluxo
+ * compartilham o portal, senão o card ficaria cercado de caixas idênticas.
+ */
+declare function portalNodeId(sourceNodeId: string, target: string): string;
+declare function chainFrameNodeId(actionNodeId: string): string;
+declare const GROUP_HEADER_NODE_ID = "__group_header__";
+/**
+ * Quantas conversas estão paradas em cada nó de um fluxo.
+ *
+ * A raiz é caso à parte: o servidor guarda o passo do menu em `menuNodeId`, num campo próprio, e uma
+ * conversa no menu não carrega `flow`. Ler `nodeId` ali daria contagem zero na tela mais visitada do
+ * editor.
+ */
+declare function countLiveByNode(params: {
+    readonly flowKey: string;
+    readonly rootFlowKey: string;
+    readonly positions: readonly FlowLivePosition[] | undefined;
+}): Record<string, number>;
+/**
+ * Um layout só para TODOS os nós de TODOS os fluxos abertos juntos.
+ *
+ * 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.
+ */
+declare function computeMergedLayout(params: {
+    readonly openKeys: readonly string[];
+    readonly graphs: Readonly<Record<string, FlowGraphData>>;
+    readonly primaryFlowKey: string;
+}): Map<string, FlowNodePosition>;
+/** Papel visual da aresta. O componente traduz em traço, cor e seta; o modelo só decide qual é. */
+type FlowEdgeKind = 'linear' | 'branch' | 'fallback';
+type FlowEdgeSpec = {
+    readonly id: string;
+    readonly source: string;
+    readonly target: string;
+    readonly sourceHandle?: string;
+    readonly kind: FlowEdgeKind;
+    /** Salto entre fluxos — tracejado, esteja o alvo mesclado ou num portal. */
+    readonly crossFlow: boolean;
+    readonly live: boolean;
+};
+/**
+ * Arestas de todos os fluxos abertos.
+ *
+ * A regra que não é óbvia: um salto `flow:<key>` vira ligação real até o nó inicial do alvo quando
+ * esse fluxo já está no canvas, e só cai no portal quando não está. Sem isso, abrir dois fluxos
+ * ligados mostrava uma caixa de portal entre dois cards que já estavam ali do lado.
+ */
+declare function buildFlowEdges(params: {
+    readonly openKeys: readonly string[];
+    readonly graphs: Readonly<Record<string, FlowGraphData>>;
+    readonly rootFlowKey: string;
+    readonly livePositions?: readonly FlowLivePosition[] | undefined;
+}): FlowEdgeSpec[];
+/** Nós de um fluxo que ninguém aponta — o card ganha contorno tracejado para cobrar a ligação. */
+declare function detachedNodeIds(graph: FlowGraphData): Set<string>;
+/** Retângulo que envolve uma cadeia de coleta, em coordenadas do canvas. */
+declare function chainFrameBounds(params: {
+    readonly nodeIds: readonly string[];
+    readonly graph: FlowGraphData;
+    readonly positionOf: (nodeId: string) => FlowNodePosition;
+    readonly padding: number;
+}): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * O nó que nasce de cada item da paleta.
+ *
+ * `contextKey` igual ao id porque é o que o motor usa para guardar a resposta: deixá-lo vazio faria a
+ * pergunta ser feita e a resposta descartada, sem erro em lugar nenhum.
+ */
+declare function newNodeFromSpec(spec: NewNodeSpec, existingIds: ReadonlySet<string>): FlowNodeData;
+
 interface CreateFlowInput {
     key: string;
     label: string;
@@ -454,4 +550,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 FlowEditorLabels, FlowGroupFrame, type FlowGroupFrameData, FlowGroupHeader, type FlowGroupHeaderData, type FlowLivePosition, FlowMapCanvas, type FlowMapCanvasProps, FlowMapNode, type FlowMapNodeData, FlowNodeCard, type FlowNodeCardData, FlowNodePanel, type FlowNodePanelProps, FlowPalette, type FlowPaletteActionOption, type FlowPaletteProps, FlowPortalNode, type FlowPortalNodeData, type FlowValidationLabels, FlowWhatsAppPreview, type FlowWhatsAppPreviewProps, FlowsWorkspace, type FlowsWorkspaceApi, type FlowsWorkspaceProps, type GraphIssue, NODE_CARD_WIDTH, type NewNodeSpec, type ResolvedConnection, WHATSAPP_LIMITS, applyConnection, computeAutoLayout, computeFlowMapLayout, crossFlowKey, crossFlowTargetsOf, estimateNodeHeight, findCollectionChains, flowGroupFrameNodeTypes, flowGroupHeaderNodeTypes, flowMapNodeTypes, flowNodeTypes, flowPortalNodeTypes, isCrossFlowTarget, isGraphDirty, mergeFlowEditorLabels, mergedFlowKeysFrom, namespaceNodeId, nodeLabel, parseNamespacedId, 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, type FlowEdgeKind, type FlowEdgeSpec, type FlowEditorLabels, FlowGroupFrame, type FlowGroupFrameData, FlowGroupHeader, type FlowGroupHeaderData, type FlowLivePosition, 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 };