@gyramais/gyra-design 0.2.49 → 0.2.52

package/dist/components/Rail/labels.d.ts

@@ -1,25 +1,54 @@
-import type { RailDecision, RailGateCondition, RailStepKind, RailStepStatus } from "./types";
+import type { RailDecision, RailGateCondition, RailStepData, RailStepKind, RailStepStatus, RailTone } from "./types";
 import type { StatusTagVariant } from "../StatusTag";
 /**
  * Vocabulario em portugues da esteira. Fica num arquivo so para que o rail, o
- * conector e o (futuro) modo frase leiam exatamente os mesmos rotulos: dois
- * vocabularios para o mesmo enum ja e um debito conhecido do gyra-operation.
+ * conector, a miniatura e o modo frase leiam exatamente os mesmos rotulos:
+ * dois vocabularios para o mesmo enum ja e um debito conhecido do
+ * gyra-operation.
  */
 export declare const KIND_LABEL: Record<RailStepKind, string>;
-/** Glifo do card GYR-1623: ◉ análise · ⊕ aprofundar · ✋ checkpoint · ⌘ vínculos. */
+/** Glifo textual do card GYR-1623: ◉ análise · ⊕ aprofundar · ✋ checkpoint · ⌘ vínculos. */
 export declare const KIND_GLYPH: Record<RailStepKind, string>;
+/**
+ * O que cada tipo FAZ, na voz da frase ("1. Analisa com X · 2. se aprovada,
+ * pede decisão do analista"). E o mesmo vocabulario do KIND_LABEL, conjugado.
+ */
+export declare const KIND_SENTENCE: Record<RailStepKind, (subject?: string) => string>;
+/** Frase curta da linha 2 do checkpoint quando o consumer nao manda `subtitle`. */
+export declare const CHECKPOINT_HINT = "Pausa e pergunta ao analista";
 export declare const GATE_LABEL: Record<RailGateCondition, string>;
 export declare const GATE_DESCRIPTION: Record<RailGateCondition, string>;
 export declare const GATE_ORDER: Array<RailGateCondition>;
+/** Estado da etapa, na voz do analista ("aguardando você", "não rodou"). */
 export declare const STATUS_LABEL: Record<RailStepStatus, string>;
 export declare const DECISION_LABEL: Record<RailDecision, string>;
+export declare const DECISION_TONE: Record<RailDecision, RailTone>;
+export declare const STATUS_TONE: Record<RailStepStatus, RailTone>;
+/** Mantidos por compatibilidade com quem lia a pilula (StatusTag) da v1. */
 export declare const DECISION_VARIANT: Record<RailDecision, StatusTagVariant>;
 export declare const STATUS_VARIANT: Record<RailStepStatus, StatusTagVariant>;
 /**
- * O que a pilula de estado mostra: quando a etapa terminou e registrou uma
+ * O que o ponto de estado mostra: quando a etapa terminou e registrou uma
  * decisao, a decisao vence o "concluida" (e o que o analista quer ler).
  */
+export declare const resolveStatusDot: (status?: RailStepStatus, decision?: RailDecision) => {
+    label: string;
+    tone: RailTone;
+} | undefined;
+/** Compatibilidade com a v1 (mesma regra, no formato do StatusTag). */
 export declare const resolveStatusTag: (status?: RailStepStatus, decision?: RailDecision) => {
     title: string;
     variant: StatusTagVariant;
 } | undefined;
+/**
+ * Modo frase: a esteira lida em uma linha, para a pessoa confirmar o que vai
+ * disparar antes de gastar dinheiro.
+ *
+ *   "1. Analisa com PJ Essencial v4 · 2. se aprovada, pede decisão do
+ *    analista · 3. se aprovada, deriva para sócios"
+ *
+ * A primeira etapa nunca tem conector. Nas demais, o conector vem do
+ * GATE_LABEL: "sempre" entra sem virgula ("2. sempre deriva para sócios"),
+ * as condicoes entram com virgula ("2. se aprovada, deriva para sócios").
+ */
+export declare const railToSentence: (steps: Array<RailStepData>) => string;

package/dist/components/Rail/types.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 /**
- * Rail — vocabulario da esteira Gyra+.
+ * Rail, vocabulario da esteira Gyra+.
  *
  * O modelo espelha 1:1 o `OperationStep` do gyra-operation (kind + runIf +
  * order), de proposito: o construtor e o acompanhamento ao vivo leem o MESMO
@@ -9,7 +9,7 @@ import React from "react";
 /** edit = construtor. run = acompanhamento ao vivo. Mesma arvore. */
 export type RailMode = "edit" | "run";
 /** Os 4 tipos de etapa. Espelha `StepKind` do gyra-operation. */
-export type RailStepKind = "ANALYSIS" | "DEEPEN" | "CHECKPOINT" | "RELATIONSHIPS";
+export type RailStepKind = "ANALYSIS" | "DEEPEN" | "CHECKPOINT" | "RELATIONSHIPS" | "RESULT" | "OFFER_REVIEW" | "COMMITTEE" | "AUTHORITY";
 /**
  * A condicao do conector: sempre avaliada contra a ULTIMA decisao registrada
  * na esteira. Espelha `Gate` do gyra-operation.
@@ -19,6 +19,8 @@ export type RailGateCondition = "ALWAYS" | "IF_APPROVED" | "IF_APPROVED_OR_ALERT
 export type RailStepStatus = "PENDING" | "RUNNING" | "WAITING" | "DONE" | "SKIPPED" | "ERROR";
 /** A decisao que a etapa registrou (nem toda etapa decide). */
 export type RailDecision = "APPROVED" | "ALERT" | "REPROVED";
+/** Tom semantico de um ponto de estado (6px + texto). */
+export type RailTone = "neutral" | "info" | "success" | "warning" | "danger";
 /**
  * Folha de uma etapa de Vinculos: um relatorio derivado (socio, 1o nivel,
  * filial...). Cada folha e linkavel.
@@ -28,7 +30,7 @@ export type RailLeaf = {
     title: string;
     /** Ex: "Socia · Socio PF v3". */
     subtitle?: string;
-    /** CPF/CNPJ. Renderizado em IBM Plex Mono. */
+    /** CPF/CNPJ. Renderizado com tabular-nums. */
     document?: string;
     status?: RailStepStatus;
     decision?: RailDecision;
@@ -37,13 +39,52 @@ export type RailLeaf = {
     onOpen?: () => void;
     disabled?: boolean;
 };
-/** Uma etapa da esteira (o dado; o componente que a desenha se chama RailStep). */
+/**
+ * Uma etapa da esteira (o dado; o componente que a desenha se chama RailStep).
+ *
+ * Anatomia do cartao, nas duas linhas que ele tem:
+ *   linha 1: glifo do tipo (chip de 24px na cor do tipo, tooltip com o nome
+ *            do tipo) + `title`
+ *            + `meta` (chips pequenos) e, a direita, o estado (run) ou as
+ *            acoes de ordenar/remover (edit, so no hover).
+ *   linha 2: `policyControl` (edit) ou `policyName` (run) para Analise e
+ *            Aprofundar; `subtitle` para Vinculos (o resumo dos niveis) e para
+ *            o Checkpoint (uma frase curta; default "Pausa e pergunta ao
+ *            analista").
+ * O tipo NUNCA aparece como texto no cartao: so como glifo com tooltip. Quem
+ * precisa do nome do tipo em texto usa `KIND_LABEL` ou `railToSentence`.
+ */
 export type RailStepData = {
     id: string;
     kind: RailStepKind;
+    /** O nome que o usuario deu a etapa (default no consumer: nome da politica, "Checkpoint" ou "Vinculos"). */
     title: string;
-    /** Politica, camada, niveis de vinculo... */
+    /**
+     * Linha 2 quando a etapa nao e uma politica: o resumo dos vinculos
+     * ("Sócios · 1º nível · PF: Sócio PF v3") ou a frase do checkpoint. Em
+     * Analise/Aprofundar so aparece se nao houver `policyControl`/`policyName`.
+     */
     subtitle?: React.ReactNode;
+    /**
+     * O nome da politica desta etapa (Analise/Aprofundar). No modo run vira a
+     * linha 2; no modo frase (`railToSentence`) vira "analisa com {policyName}".
+     */
+    policyName?: string;
+    /**
+     * Seletor inline da politica, injetado pelo consumer no modo edit (ex: um
+     * `RailInlineSelect` abrindo o picker). Ocupa a linha 2 no lugar do
+     * `policyName`. Ignorado no modo run.
+     */
+    policyControl?: React.ReactNode;
+    /**
+     * O nome da etapa E o nome da politica (o caso default, e o mais comum).
+     * Nesse caso a politica NAO ganha uma linha propria: no modo edit o seletor
+     * inline sobe para a linha 1 e vira o proprio nome; no run, a linha 2 some.
+     * Sem isto o cartao imprimia a mesma string duas vezes, empilhada.
+     *
+     * Sem valor, o RailStep compara `title` com `policyName`.
+     */
+    policyIsTitle?: boolean;
     /**
      * A condicao do conector que fica ACIMA desta etapa. A primeira etapa da
      * esteira nao tem conector, entao o campo e ignorado nela.
@@ -56,11 +97,15 @@ export type RailStepData = {
      * contraste cheio: etapa pulada mostra o motivo a vista.
      */
     reason?: string;
-    /** Chips/tags extras no header (camada, custo, tier...). */
+    /** Chips pequenos ao lado do nome (score, custo, camada...). */
     meta?: React.ReactNode;
-    /** Acoes da etapa no modo run (ex: "Decidir agora"). */
+    /** Acoes da etapa no modo run (ex: o botao "Decidir" do checkpoint aguardando). */
     actions?: React.ReactNode;
-    /** Slot livre de conteudo: seletor de politica, niveis, o que o consumer quiser. */
+    /**
+     * Slot livre abaixo das duas linhas. Mantido por compatibilidade; na v2 a
+     * configuracao da etapa mora na linha 2 (`policyControl`/`subtitle`), e
+     * este slot fica para o que nao cabe la.
+     */
     content?: React.ReactNode;
     /** Folhas (relatorios derivados). So faz sentido em RELATIONSHIPS. */
     leaves?: RailLeaf[];