@gyramais/gyra-design 0.2.49 → 0.2.52

package/dist/emails/email/components/Rail/Rail.d.ts

@@ -2,12 +2,14 @@ import React from "react";
 import "./index.css";
 import type { RailGateCondition, RailLeaf, RailMode, RailStepData } from "./types";
 /**
- * Rail — a esteira Gyra+: uma lista ordenada e vertical de etapas, com um
+ * Rail, a esteira Gyra+: uma lista ordenada e vertical de etapas, com um
  * conector condicional entre elas.
  *
  * Uma linha, nao um grafo: le de cima para baixo na mesma ordem em que a
  * decisao acontece. A referencia e o Atalhos da Apple, nao um editor de
- * diagramas.
+ * diagramas. O rail e a unica fonte de verdade da esteira na UI: a primeira
+ * etapa de Analise E a politica principal, e o conector acima de cada etapa
+ * E a condicao para ela rodar. Nao existe conector acima da primeira etapa.
  *
  * Dois modos, uma arvore so:
  *   - `edit`: inserir etapa entre etapas, trocar a condicao do conector,
@@ -28,7 +30,12 @@ type RailProps = {
     steps: Array<RailStepData>;
     /** Rotulo acessivel da lista. Default: "Esteira". */
     ariaLabel?: string;
-    /** Etapa em foco na execucao ao vivo (modo run). */
+    /**
+     * Etapa em foco na execucao ao vivo (modo run). Sem ela, o proprio Rail
+     * assume a etapa que roda ou aguarda. Execucao encerrada nao tem etapa
+     * atual, e ninguem ganha elevacao: sombra que sobrevive ao fim da execucao
+     * aponta para nada.
+     */
     activeStepId?: string;
     /** Etapa selecionada no construtor (modo edit). */
     selectedStepId?: string;
@@ -40,14 +47,21 @@ type RailProps = {
     defaultExpandedStepIds?: Array<string>;
     /** Rotulo do botao que acrescenta etapa no fim. Default: "Adicionar etapa". */
     addLabel?: string;
-    /** Texto da esteira vazia. */
+    /**
+     * Texto da esteira vazia. E AQUI que mora o tutorial ("Comece pela
+     * análise: a primeira etapa é a política principal"), nunca no cartao.
+     */
     emptyText?: string;
     onSelectStep?: (step: RailStepData) => void;
     onOpenStep?: (step: RailStepData) => void;
     onOpenLeaf?: (leaf: RailLeaf, step: RailStepData) => void;
     /** Trocar a condicao do conector que fica ACIMA da etapa `stepId`. */
     onChangeGate?: (stepId: string, condition: RailGateCondition) => void;
-    /** Inserir etapa na posicao `index` (0 = antes da primeira). */
+    /**
+     * Inserir etapa na posicao `index`. O construtor oferece inserir ENTRE
+     * etapas (index >= 1, no conector) e no fim; a posicao 0 so acontece na
+     * esteira vazia, porque a primeira etapa e a politica principal.
+     */
     onInsertStep?: (index: number) => void;
     onRemoveStep?: (step: RailStepData) => void;
     /** Reordenar. `toIndex` ja vem calculado e dentro dos limites. */

package/dist/emails/email/components/Rail/RailInlineSelect.d.ts

@@ -0,0 +1,44 @@
+import React from "react";
+import "./index.css";
+/**
+ * RailInlineSelect, o gatilho "inline select" da linha 2 do cartao: texto +
+ * chevron, sem borda, no corpo do texto. E o que a politica de uma etapa usa
+ * no modo edit (clicou, vira picker), no lugar de um Input de rotulo
+ * flutuante de 40px.
+ *
+ * Nao abre nada sozinho: e um botao. O consumer o usa como trigger de um
+ * Popover/Select (por isso o forwardRef e o repasse das props restantes,
+ * que o `asChild` do Radix precisa).
+ */
+type RailInlineSelectProps = {
+    id?: string;
+    className?: string;
+    /** O valor escolhido. Sem valor, mostra o `placeholder` em tom terciario. */
+    label?: React.ReactNode;
+    /** Default: "Escolher política". */
+    placeholder?: string;
+    /** Avisa que o valor salvo nao esta disponivel (ex: politica desativada). */
+    tone?: "default" | "warning";
+    disabled?: boolean;
+    /** Estado do picker que este gatilho abre (aria-expanded). */
+    open?: boolean;
+    /** Rotulo acessivel. Default: "Política da etapa: {label ou placeholder}". */
+    ariaLabel?: string;
+} & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "id" | "className" | "disabled">;
+declare const RailInlineSelect: React.ForwardRefExoticComponent<{
+    id?: string;
+    className?: string;
+    /** O valor escolhido. Sem valor, mostra o `placeholder` em tom terciario. */
+    label?: React.ReactNode;
+    /** Default: "Escolher política". */
+    placeholder?: string;
+    /** Avisa que o valor salvo nao esta disponivel (ex: politica desativada). */
+    tone?: "default" | "warning";
+    disabled?: boolean;
+    /** Estado do picker que este gatilho abre (aria-expanded). */
+    open?: boolean;
+    /** Rotulo acessivel. Default: "Política da etapa: {label ou placeholder}". */
+    ariaLabel?: string;
+} & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "className" | "id" | "disabled"> & React.RefAttributes<HTMLButtonElement>>;
+export { RailInlineSelect };
+export type { RailInlineSelectProps };

package/dist/emails/email/components/Rail/RailMini.d.ts

@@ -2,13 +2,13 @@ import React from "react";
 import "./index.css";
 import type { RailStepData } from "./types";
 /**
- * RailMini — a MESMA esteira, do tamanho de uma linha de lista.
+ * RailMini, a MESMA esteira, do tamanho de uma celula de lista.
  *
- * Existe porque o progresso da esteira e a informacao que a listagem de
- * execucoes precisa dar de graca: sem isto, saber que a esteira parou na
- * etapa 1 de 4 custa um clique e uma expansao. E uma miniatura, nao um
- * componente novo: le o mesmo `RailStepData` do `Rail`, so que como uma fila
- * de marcas horizontais.
+ * Uma bolinha de 6px por etapa, ligadas por um fio de 1px, no maximo ~120px
+ * de largura. O resumo ("Parou na etapa 2 de 4: reprovada") vai no
+ * `aria-label` e no `title`; na tela ele so aparece com `showSummary`,
+ * porque a linha da lista ja tem a coluna de status e nao precisa dizer a
+ * mesma coisa duas vezes.
  *
  * Nao e clicavel de proposito. Quem quer detalhe abre a linha; a miniatura e
  * um indicador, e um alvo de clique dentro de outro alvo de clique so cria
@@ -19,7 +19,11 @@ type RailMiniProps = {
     steps: Array<RailStepData>;
     /** Rotulo acessivel. Default: "Progresso da esteira". */
     ariaLabel?: string;
+    /** Mostra o resumo em texto ao lado das bolinhas. Default: false. */
+    showSummary?: boolean;
 };
-declare const RailMini: ({ className, steps, ariaLabel }: RailMiniProps) => React.JSX.Element | null;
+/** O resumo em texto de uma execucao: exportado para a lista reutilizar. */
+export declare const railMiniSummary: (steps: Array<RailStepData>) => string;
+declare const RailMini: ({ className, steps, ariaLabel, showSummary }: RailMiniProps) => React.JSX.Element | null;
 export { RailMini };
 export type { RailMiniProps };

package/dist/emails/email/components/Rail/RailStep.d.ts

@@ -1,17 +1,6 @@
 import React from "react";
 import "./index.css";
-import type { RailLeaf, RailMode, RailStepData } from "./types";
-/**
- * RailStep — o cartao de uma etapa.
- *
- * E o mesmo cartao nos dois modos: no `edit` ele mostra a barra de ordenacao e
- * o slot de configuracao; no `run` ele mostra o estado e as acoes. Nada de
- * duas arvores: se construir e acompanhar exigissem componentes diferentes, o
- * desenho teria falhado.
- *
- * Etapa que nao disparou fica translucida, mas o MOTIVO fica fora do cartao,
- * em contraste cheio: e a informacao que o analista precisa ler.
- */
+import type { RailLeaf, RailMode, RailStepData, RailTone } from "./types";
 type RailStepProps = {
     id?: string;
     className?: string;
@@ -40,6 +29,12 @@ type RailStepProps = {
     onKeyDown?: (event: React.KeyboardEvent<HTMLDivElement>) => void;
     onFocus?: (event: React.FocusEvent<HTMLDivElement>) => void;
 };
+/** Ponto de 6px + texto: o unico jeito de dizer estado dentro do cartao. */
+declare const StatusDot: ({ label, tone, className, }: {
+    label: string;
+    tone: RailTone;
+    className?: string;
+}) => React.JSX.Element;
 declare const RailStep: React.ForwardRefExoticComponent<RailStepProps & React.RefAttributes<HTMLDivElement>>;
-export { RailStep };
+export { RailStep, StatusDot as RailStatusDot };
 export type { RailStepProps };

package/dist/emails/email/components/Rail/index.d.ts

@@ -2,5 +2,6 @@ export * from "./Rail";
 export * from "./RailStep";
 export * from "./RailMini";
 export * from "./RailGate";
+export * from "./RailInlineSelect";
 export * from "./labels";
 export * from "./types";

package/dist/emails/email/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/emails/email/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[];

package/dist/emails/email/index.d.ts

@@ -1,64 +1,94 @@
-import "./index.css";
-import "react-toastify/dist/ReactToastify.css";
-import "react-modern-drawer/dist/index.css";
-import "react-draft-wysiwyg/dist/react-draft-wysiwyg.css";
-import "react-datepicker/dist/react-datepicker.css";
-import "react-circular-progressbar/dist/styles.css";
-import "./components/AiParecer/index.css";
-import "./components/Avatar/index.css";
-import "./components/Button/index.css";
-import "./components/Card/index.css";
-import "./components/Chart/index.css";
-import "./components/ChatWidget/index.css";
-import "./components/Checkbox/index.css";
-import "./components/Col/index.css";
-import "./components/Collapse/index.css";
-import "./components/Divider/index.css";
-import "./components/DistributionBar/index.css";
-import "./components/Drawer/index.css";
-import "./components/DropdownMenu/index.css";
-import "./components/Empty/index.css";
-import "./components/Filter/index.css";
-import "./components/FloatingCard/index.css";
-import "./components/Form/index.css";
-import "./components/Gauge/index.css";
-import "./components/HoverCard/index.css";
-import "./components/Icon/index.css";
-import "./components/IconDisplay/index.css";
-import "./components/Information/index.css";
-import "./components/Input/index.css";
-import "./components/Layout/index.css";
-import "./components/List/index.css";
-import "./components/Loading/index.css";
-import "./components/Logo/index.css";
-import "./components/Menubar/index.css";
-import "./components/Modal/index.css";
-import "./components/Popover/index.css";
-import "./components/ProcessingChip/index.css";
-import "./components/Progress/index.css";
-import "./components/RadioGroup/index.css";
-import "./components/Rail/index.css";
-import "./components/RichInput/index.css";
-import "./components/Row/index.css";
-import "./components/ScoreBar/index.css";
-import "./components/SegmentedPicker/index.css";
-import "./components/SegmentedToggle/index.css";
-import "./components/Select/index.css";
-import "./components/Selector/index.css";
-import "./components/SelectTree/index.css";
-import "./components/PickerPopover/index.css";
-import "./components/MultiSelectPicker/index.css";
-import "./components/RuleSearchPicker/index.css";
-import "./components/OperatorPicker/index.css";
-import "./components/ContextMenu/index.css";
-import "./components/StatusTag/index.css";
-import "./components/Switch/index.css";
-import "./components/SyncChip/index.css";
-import "./components/Table/index.css";
-import "./components/Tabs/index.css";
-import "./components/Tag/index.css";
-import "./components/Tooltip/index.css";
-import "./components/Stepper/index.css";
-import "./components/TourGuide/index.css";
-import theme from "./theme";
-export default theme;
+/**
+ * Email transacional genérico — Gyra+ design system.
+ *
+ * **FONTE DA VERDADE** dos layouts de email transacional. Usado por
+ * qualquer fluxo que precise mandar email no padrão visual Gyra+:
+ *   - reset de senha, confirmação de cadastro, alertas internos
+ *   - finalização de processamento (Finsights, batch-report, etc)
+ *   - notificações de operação/crédito
+ *   - convites, mudança de plano, alerts de billing...
+ *
+ * **TS puro**: sem React, sem DOM, sem browser globals. Apenas funções que
+ * retornam string HTML. Funciona igual em qualquer runtime Node (Nest) ou
+ * bundle browser (Next).
+ *
+ * **Email-safe**: tabelas + inline-style (clients ignoram <style> externo,
+ * flexbox e Material Symbols). Gradientes têm fallback sólido.
+ *
+ * Tokens visuais alinhados com gyra-design: azul #1256FF (acao/primary),
+ * roxo #7C4EFF (IA/parecer), neutrals Apple-gray, fonte Inter.
+ *
+ * **Como usar:**
+ * ```ts
+ * import { buildEmail } from '@gyramais/gyra-design/dist/emails/email';
+ *
+ * const html = buildEmail({
+ *   preheader: 'Senha redefinida com sucesso',
+ *   greeting: 'Olá, Maria',
+ *   title: 'Sua senha foi redefinida',
+ *   paragraphs: ['Tudo certo. Você já pode entrar com a nova senha.'],
+ *   buttons: [{ label: 'Entrar', url: 'https://app.gyramais.com/login' }],
+ *   footerNote: 'Se não foi você, redefina novamente clicando em "Esqueci minha senha".',
+ * });
+ * ```
+ *
+ * Pra emails recorrentes (mesmo conteudo, payload variavel), criar um
+ * **preset** em `src/emails/<preset-name>/index.ts` que monta o
+ * `EmailLayoutInput` a partir de campos de dominio e delega aqui. Ver
+ * `balance-sheet-finalized` como exemplo.
+ */
+export type EmailButton = {
+    label: string;
+    url: string;
+    /** primary = botão azul preenchido, secondary = outline. Default primary. */
+    variant?: 'primary' | 'secondary';
+};
+export type EmailHighlight = {
+    /** label pequeno em cima (ex: "Score", "Nivel de risco"). */
+    label: string;
+    /** valor grande em baixo (ex: "820", "Baixo"). */
+    value: string;
+    /** cor do valor (ex: cor do risco). Default: tinta padrao Apple-gray. */
+    color?: string;
+};
+/** Tom semantico do chip de veredito do bloco Parecer GYRA+IA. */
+export type AiParecerTone = 'ok' | 'warn' | 'danger' | 'info';
+export type EmailAiParecer = {
+    /** chip de veredito (ex: "Médio", "Consistente"). Opcional. */
+    verdict?: string;
+    verdictTone?: AiParecerTone;
+    /** corpo do parecer. */
+    text: string;
+    /** rodape do bloco (ex: "GYRA+IA · Confiança 96%"). Opcional. */
+    footer?: string;
+};
+export type EmailLayoutInput = {
+    /** Texto invisivel no preheader (preview no inbox). */
+    preheader?: string;
+    /** Linha curta acima do titulo (ex: "Olá, Maria"). */
+    greeting?: string;
+    /** Titulo principal (H1). */
+    title: string;
+    /** Paragrafos de corpo (sub-frases). */
+    paragraphs?: string[];
+    /** Cards lado-a-lado (1 a N). Largura dividida igualmente. */
+    highlights?: EmailHighlight[];
+    /** Bloco "Parecer GYRA+IA" (faixa roxa com chip + texto + rodape). */
+    aiParecer?: EmailAiParecer;
+    /** Botoes de acao. Multiplos viram lado-a-lado. */
+    buttons?: EmailButton[];
+    /** Texto pequeno no rodape do card (disclaimer, instrucoes extras). */
+    footerNote?: string;
+};
+/**
+ * Monta o HTML completo de um email no padrão Gyra+: logo no topo, card
+ * principal com greeting + título + parágrafos + highlights (chips lado a
+ * lado) + bloco "Parecer GYRA+IA" + botões, e rodapé padrão.
+ *
+ * Email-safe (tabelas + inline-style, sem flexbox, sem <style>). Funciona
+ * em Gmail, Outlook (Windows/Web/Mac), Apple Mail, Thunderbird, mobile.
+ *
+ * Todas as seções (greeting, paragraphs, highlights, aiParecer, buttons,
+ * footerNote) são **opcionais** — só `title` é obrigatório.
+ */
+export declare function buildEmail(input: EmailLayoutInput): string;