@gyramais/gyra-design 0.2.48 → 0.2.49

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

@@ -0,0 +1,25 @@
+import type { RailDecision, RailGateCondition, RailStepKind, RailStepStatus } 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.
+ */
+export declare const KIND_LABEL: Record<RailStepKind, string>;
+/** Glifo do card GYR-1623: ◉ análise · ⊕ aprofundar · ✋ checkpoint · ⌘ vínculos. */
+export declare const KIND_GLYPH: Record<RailStepKind, string>;
+export declare const GATE_LABEL: Record<RailGateCondition, string>;
+export declare const GATE_DESCRIPTION: Record<RailGateCondition, string>;
+export declare const GATE_ORDER: Array<RailGateCondition>;
+export declare const STATUS_LABEL: Record<RailStepStatus, string>;
+export declare const DECISION_LABEL: Record<RailDecision, string>;
+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
+ * decisao, a decisao vence o "concluida" (e o que o analista quer ler).
+ */
+export declare const resolveStatusTag: (status?: RailStepStatus, decision?: RailDecision) => {
+    title: string;
+    variant: StatusTagVariant;
+} | undefined;

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

@@ -0,0 +1,75 @@
+import React from "react";
+/**
+ * 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
+ * array. Quem consome so troca `mode`.
+ */
+/** 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";
+/**
+ * A condicao do conector: sempre avaliada contra a ULTIMA decisao registrada
+ * na esteira. Espelha `Gate` do gyra-operation.
+ */
+export type RailGateCondition = "ALWAYS" | "IF_APPROVED" | "IF_APPROVED_OR_ALERT" | "IF_REPROVED";
+/** Estado de execucao de uma etapa (so tem significado no modo run). */
+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";
+/**
+ * Folha de uma etapa de Vinculos: um relatorio derivado (socio, 1o nivel,
+ * filial...). Cada folha e linkavel.
+ */
+export type RailLeaf = {
+    id: string;
+    title: string;
+    /** Ex: "Socia · Socio PF v3". */
+    subtitle?: string;
+    /** CPF/CNPJ. Renderizado em IBM Plex Mono. */
+    document?: string;
+    status?: RailStepStatus;
+    decision?: RailDecision;
+    /** Quando presente, a folha vira ancora. Senao, botao com `onOpen`. */
+    href?: string;
+    onOpen?: () => void;
+    disabled?: boolean;
+};
+/** Uma etapa da esteira (o dado; o componente que a desenha se chama RailStep). */
+export type RailStepData = {
+    id: string;
+    kind: RailStepKind;
+    title: string;
+    /** Politica, camada, niveis de vinculo... */
+    subtitle?: React.ReactNode;
+    /**
+     * A condicao do conector que fica ACIMA desta etapa. A primeira etapa da
+     * esteira nao tem conector, entao o campo e ignorado nela.
+     */
+    runIf?: RailGateCondition;
+    status?: RailStepStatus;
+    decision?: RailDecision;
+    /**
+     * Por que a etapa nao disparou. Renderizado FORA do cartao translucido, em
+     * contraste cheio: etapa pulada mostra o motivo a vista.
+     */
+    reason?: string;
+    /** Chips/tags extras no header (camada, custo, tier...). */
+    meta?: React.ReactNode;
+    /** Acoes da etapa no modo run (ex: "Decidir agora"). */
+    actions?: React.ReactNode;
+    /** Slot livre de conteudo: seletor de politica, niveis, o que o consumer quiser. */
+    content?: React.ReactNode;
+    /** Folhas (relatorios derivados). So faz sentido em RELATIONSHIPS. */
+    leaves?: RailLeaf[];
+    /** Rotulo da lista de folhas. Default: "Relatorios derivados". */
+    leavesLabel?: string;
+    /** Quando presente, o titulo vira link para o relatorio da etapa. */
+    href?: string;
+    /** Etapa desabilitada (nao editavel, nao clicavel). */
+    disabled?: boolean;
+    /** Trava so o conector desta etapa (ex: etapa herdada de um modelo). */
+    gateLocked?: boolean;
+};