@adatechnology/conversations-ui 0.1.0-rc.24 → 0.1.0-rc.25

package/dist/flows/index.d.ts

@@ -69,6 +69,7 @@ declare function slugifyNodeId(label: string, existing: Set<string>): string;
 interface FlowEditorLabels {
     legend: Record<FlowNodeType, string>;
     startNodeTooltip: string;
+    detachedNodeTooltip: string;
     liveCountTooltip: (count: number) => string;
     edgeFallbackLabel: string;
     actionKindLabels: Record<string, string>;
@@ -77,6 +78,9 @@ interface FlowEditorLabels {
     nodePanel: {
         title: string;
         contextKey: string;
+        nodeName: string;
+        nodeNamePlaceholder: string;
+        nodeNameHint: string;
         questionType: string;
         question: string;
         options: string;
@@ -125,6 +129,8 @@ interface FlowEditorLabels {
     flowMap: {
         nodeCount: (count: number) => string;
         openFlow: string;
+        toggleToMap: string;
+        toggleToDetail: string;
     };
     flowGroup: {
         focus: string;
@@ -134,6 +140,66 @@ interface FlowEditorLabels {
         tooltip: string;
         goesTo: (label: string) => string;
     };
+    collectionChain: {
+        feeds: (label: string) => string;
+    };
+    /**
+     * Texto dos problemas encontrados por `validateGraph`. Vive aqui, e não no host, porque a tela
+     * composta é quem valida — deixar de fora obrigaria todo produto a repassar o mesmo mapa de
+     * funções só para a barra de erros aparecer.
+     */
+    validation: FlowValidationLabels;
+    /** Barra de cima, estados de carregamento e ações do editor inteiro. */
+    workspace: {
+        title: string;
+        subtitle: string;
+        loading: string;
+        loadError: string;
+        saveGraph: string;
+        saving: string;
+        saveSuccess: string;
+        saveError: string;
+        organize: string;
+        organizeTooltip: string;
+        discardChanges: string;
+        discardTooltip: string;
+        discardConfirm: string;
+        unsavedChangesConfirm: string;
+    };
+    flowManager: {
+        newFlow: string;
+        createTitle: string;
+        key: string;
+        keyHint: string;
+        keyInvalid: string;
+        label: string;
+        showInMenu: string;
+        menuOptionLabel: string;
+        create: string;
+        creating: string;
+        deleteFlow: string;
+        deleteConfirm: (label: string) => string;
+        createError: string;
+        deleteError: string;
+    };
+}
+interface FlowValidationLabels {
+    title: string;
+    errors: (count: number) => string;
+    warnings: (count: number) => string;
+    noStart: string;
+    brokenRef: (from: string, to: string) => string;
+    choiceWithoutOptions: (id: string) => string;
+    duplicatedOptionId: (id: string, optionId: string) => string;
+    optionWithoutTarget: (id: string, optionLabel: string) => string;
+    tooManyOptions: (id: string, count: number) => string;
+    buttonTitleTooLong: (id: string, label: string) => string;
+    listTitleTooLong: (id: string, label: string) => string;
+    bodyTooLong: (id: string) => string;
+    unreachable: (id: string) => string;
+    deadEndQuestion: (id: string) => string;
+    conditionIncomplete: (id: string) => string;
+    conditionBranchMissing: (id: string, branch: string) => string;
 }
 declare const DEFAULT_FLOW_EDITOR_LABELS: FlowEditorLabels;
 declare function mergeFlowEditorLabels(override?: Partial<FlowEditorLabels>): FlowEditorLabels;
@@ -144,6 +210,12 @@ 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>;
@@ -244,7 +316,7 @@ interface FlowNodePanelProps {
      * URL assinada são dele, e o painel não tem como buscar nada. Ausente, o nó continua editável —
      * só não dá para anexar por aqui.
      */
-    renderMediaPicker?: (node: FlowNodeData) => ReactNode;
+    renderMediaPicker?: (node: FlowNodeData, graph: FlowGraphData) => ReactNode;
 }
 declare function FlowNodePanel({ graph, node, issues, otherFlows, onClose, onChange, onDelete, labels: labelsOverride, renderMediaPicker, }: FlowNodePanelProps): react.JSX.Element;
 
@@ -255,4 +327,58 @@ interface FlowWhatsAppPreviewProps {
 }
 declare function FlowWhatsAppPreview({ body, options, labels, }: FlowWhatsAppPreviewProps): react.JSX.Element;
 
-export { BUILT_IN_ACTION_KINDS, CONDITION_OPERATORS, CROSS_FLOW_PREFIX, type CollectionChain, DEFAULT_FLOW_EDITOR_LABELS, type FlowEditorLabels, FlowGroupFrame, type FlowGroupFrameData, FlowGroupHeader, type FlowGroupHeaderData, FlowMapCanvas, type FlowMapCanvasProps, FlowMapNode, type FlowMapNodeData, FlowNodeCard, type FlowNodeCardData, FlowNodePanel, type FlowNodePanelProps, FlowPalette, type FlowPaletteActionOption, type FlowPaletteProps, FlowPortalNode, type FlowPortalNodeData, FlowWhatsAppPreview, type FlowWhatsAppPreviewProps, type GraphIssue, NODE_CARD_WIDTH, type NewNodeSpec, WHATSAPP_LIMITS, computeAutoLayout, computeFlowMapLayout, crossFlowKey, crossFlowTargetsOf, estimateNodeHeight, findCollectionChains, flowGroupFrameNodeTypes, flowGroupHeaderNodeTypes, flowMapNodeTypes, flowNodeTypes, flowPortalNodeTypes, isCrossFlowTarget, mergeFlowEditorLabels, nodeLabel, rendersAsButtons, slugifyNodeId, targetsOf, validateGraph };
+/** 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;
+}
+interface CreateFlowInput {
+    key: string;
+    label: string;
+    showInMenu: boolean;
+    /** Ausente quando `showInMenu` é falso — não há opção de menu para rotular. */
+    menuOptionLabel?: string;
+}
+/**
+ * Backend de fluxos do host. Funções cruas em vez de um cliente HTTP: o pacote roda em produtos com
+ * axios, fetch e react-query, e nenhum deles precisa entrar como dependência daqui.
+ */
+interface FlowsWorkspaceApi {
+    getGraphs(): Promise<Record<string, FlowGraphData>>;
+    saveGraph(key: string, graph: FlowGraphData): Promise<void>;
+    /**
+     * Criar e excluir fluxo são **opcionais por capacidade**: produto cujos fluxos vêm de um seed
+     * versionado não expõe rota para isso, e a tela simplesmente não desenha os botões — em vez de
+     * oferecer uma ação que estoura no clique.
+     */
+    createFlow?(input: CreateFlowInput): Promise<void>;
+    deleteFlow?(key: string): Promise<void>;
+    /** Contagem de conversas vivas por nó. Ausente, os cards não pulsam e nada é consultado. */
+    getLivePositions?(): Promise<FlowLivePosition[]>;
+}
+interface FlowsWorkspaceProps {
+    readonly api: FlowsWorkspaceApi;
+    /** Fluxo raiz — o que abre por padrão e o único que não pode ser excluído. */
+    readonly rootFlowKey?: string;
+    readonly labels?: Partial<FlowEditorLabels>;
+    /** Kinds de ação do produto oferecidos na paleta (`trigger_simulation`, `abrir_comanda`…). */
+    readonly actionOptions?: readonly FlowPaletteActionOption[];
+    /** Seletor de arquivos do nó `send_media` — a biblioteca é do host, então entra por slot. */
+    readonly renderMediaPicker?: (node: FlowNodeData) => ReactNode;
+    /** Intervalo do polling de posições vivas. Só tem efeito com `getLivePositions`. */
+    readonly livePollIntervalMs?: number;
+    readonly className?: string;
+}
+/**
+ * Editor de fluxograma completo — barra de ações, abas de fluxo, paleta, canvas com fusão
+ * editável, painel de nó, mapa de fluxos e diálogos de criar/excluir.
+ *
+ * É a tela inteira, não as peças: cada produto que remontava esse grid à mão acabava com uma
+ * versão diferente do mesmo editor. Customização entra por `labels`, `actionOptions` e
+ * `renderMediaPicker` — nunca por cópia do arquivo.
+ */
+declare function FlowsWorkspace({ api, rootFlowKey, labels: labelsOverride, actionOptions, renderMediaPicker, livePollIntervalMs, className, }: FlowsWorkspaceProps): react.JSX.Element;
+
+export { BUILT_IN_ACTION_KINDS, CONDITION_OPERATORS, CROSS_FLOW_PREFIX, type CollectionChain, 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, WHATSAPP_LIMITS, computeAutoLayout, computeFlowMapLayout, crossFlowKey, crossFlowTargetsOf, estimateNodeHeight, findCollectionChains, flowGroupFrameNodeTypes, flowGroupHeaderNodeTypes, flowMapNodeTypes, flowNodeTypes, flowPortalNodeTypes, isCrossFlowTarget, mergeFlowEditorLabels, nodeLabel, rendersAsButtons, slugifyNodeId, targetsOf, validateGraph };