@gyramais/gyra-design 0.2.21 → 0.2.23

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

@@ -0,0 +1 @@
+export * from "./RichInput";

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

@@ -0,0 +1,18 @@
+import React from "react";
+import "./index.css";
+type Gap = {
+    mobile?: 0 | 4 | 8 | 12 | 16 | 20 | 24 | 28 | 32 | 36 | 40 | 44 | 48 | 52 | 56 | 60 | 64 | 68 | 72 | 76 | 80;
+    tablet?: 0 | 4 | 8 | 12 | 16 | 20 | 24 | 28 | 32 | 36 | 40 | 44 | 48 | 52 | 56 | 60 | 64 | 68 | 72 | 76 | 80;
+    desktop?: 0 | 4 | 8 | 12 | 16 | 20 | 24 | 28 | 32 | 36 | 40 | 44 | 48 | 52 | 56 | 60 | 64 | 68 | 72 | 76 | 80;
+    wide?: 0 | 4 | 8 | 12 | 16 | 20 | 24 | 28 | 32 | 36 | 40 | 44 | 48 | 52 | 56 | 60 | 64 | 68 | 72 | 76 | 80;
+};
+type RowProps = {
+    id?: string;
+    className?: string;
+    columns?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+    gap?: 0 | 4 | 8 | 12 | 16 | 20 | 24 | 28 | 32 | 36 | 40 | 44 | 48 | 52 | 56 | 60 | 64 | 68 | 72 | 76 | 80 | Gap;
+    align?: 'start' | 'center' | 'end';
+    children: React.ReactNode;
+};
+declare const Row: ({ id, className, columns, gap, align, children, }: RowProps) => React.JSX.Element;
+export { Row };

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

@@ -0,0 +1 @@
+export * from "./Row";

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

@@ -0,0 +1,46 @@
+import React from "react";
+import "./index.css";
+type RuleSearchItem = {
+    key: string;
+    label: string;
+    /** Descrição curta abaixo do label. */
+    sublabel?: string;
+    icon?: React.ReactNode;
+    /** Tag opcional à direita (ex.: "custom"). */
+    tag?: string | React.ReactNode;
+    disabled?: boolean;
+};
+type RuleSearchSection = {
+    key: string;
+    label: string;
+    items: RuleSearchItem[];
+};
+type RuleSearchPickerProps = {
+    id?: string;
+    className?: string;
+    visible?: boolean;
+    title?: string;
+    searchPlaceholder?: string;
+    sections: RuleSearchSection[];
+    onSelect?: (itemKey: string, sectionKey: string) => void;
+    trigger: React.ReactNode;
+    /** Quando true, fecha após seleção. Caller deve controlar `visible`. */
+    closeOnSelect?: boolean;
+    /** Callback chamado quando o popover quer ser fechado (esc, seleção). */
+    onClose?: () => void;
+    /** Filtro custom (substitui o default que olha label + sublabel + section). */
+    filter?: (item: RuleSearchItem, section: RuleSearchSection, query: string) => boolean;
+    width?: number | string;
+    align?: "start" | "center" | "end";
+    side?: "top" | "right" | "bottom" | "left";
+    /** Hint de teclado mostrado à direita do search. Default "↵ adicionar". */
+    searchAccessory?: React.ReactNode;
+    /** Hint do footer (esquerda). Default mostra ↑↓ navegar / ↵ adicionar / esc fechar. */
+    footerKeys?: React.ReactNode;
+    /** Texto à direita do footer (ex.: "9 regras"). Default = contagem. */
+    footerCount?: React.ReactNode;
+    onPointerDownOutside?: () => void;
+};
+declare const RuleSearchPicker: ({ id, className, visible, title, searchPlaceholder, sections, onSelect, trigger, closeOnSelect, onClose, filter, width, align, side, searchAccessory, footerKeys, footerCount, onPointerDownOutside, }: RuleSearchPickerProps) => React.JSX.Element;
+export { RuleSearchPicker };
+export type { RuleSearchItem, RuleSearchSection, RuleSearchPickerProps, };

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

@@ -0,0 +1 @@
+export * from "./RuleSearchPicker";

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

@@ -0,0 +1,30 @@
+import React from "react";
+import "./index.css";
+export type ScoreBarVariant = "success" | "warning" | "danger" | "info" | "neutral";
+export type ScoreThreshold = {
+    /** Minimum value (inclusive) at which this variant applies. */
+    at: number;
+    variant: ScoreBarVariant;
+};
+type ScoreBarProps = {
+    id?: string;
+    className?: string;
+    value?: number | null;
+    /** Maximum value of the scale. Default 1000 (matches Brazilian credit bureaus). */
+    max?: number;
+    /** Thresholds, evaluated highest -> lowest. The first threshold whose `at`
+     *  is <= value wins. Anything below the lowest threshold falls back to
+     *  the bar's default `belowVariant`. */
+    thresholds?: ScoreThreshold[];
+    /** Variant when value is null/0 or below the lowest threshold. Default: "danger". */
+    belowVariant?: ScoreBarVariant;
+    /** Width of the inline bar in pixels. Default 36. */
+    barWidth?: number;
+    /** Render the numeric value next to the bar. Default true. */
+    showValue?: boolean;
+    /** Replaces the numeric when value is missing. Default "—". */
+    emptyText?: string;
+};
+declare const ScoreBar: ({ id, className, value, max, thresholds, belowVariant, barWidth, showValue, emptyText, }: ScoreBarProps) => React.JSX.Element;
+export { ScoreBar };
+export type { ScoreBarProps };

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

@@ -0,0 +1 @@
+export * from "./ScoreBar";

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

@@ -0,0 +1,27 @@
+import React from "react";
+import "./index.css";
+type SegmentedPickerOption = {
+    value: string;
+    title: string;
+    description?: string;
+    icon?: React.ReactNode;
+    className?: string;
+    /** When true, the option is recognized for the *current* selection
+     *  lookup but is NOT shown in the dropdown menu. Useful for terminal
+     *  states (e.g. NOT_APPLIED) that must be displayed when stored but
+     *  shouldn't be offered as a manual choice. */
+    hidden?: boolean;
+};
+type SegmentedPickerProps = {
+    id?: string;
+    className?: string;
+    value?: string;
+    options: Array<SegmentedPickerOption>;
+    onChange?: (value: string) => void;
+    /** primary: solid filled trigger; secondary: outlined/ghost trigger. */
+    variant?: "primary" | "secondary";
+    disabled?: boolean;
+};
+declare const SegmentedPicker: ({ id, className, value, options, onChange, variant, disabled, }: SegmentedPickerProps) => React.JSX.Element | null;
+export { SegmentedPicker };
+export type { SegmentedPickerProps, SegmentedPickerOption };

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

@@ -0,0 +1 @@
+export * from "./SegmentedPicker";

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

@@ -0,0 +1,25 @@
+import React from "react";
+import "./index.css";
+type Kind = "primary" | "success" | "warning" | "danger" | "info" | "neutral";
+type SegmentedToggleOption<T extends string> = {
+    value: T;
+    label: string;
+    icon?: React.ReactNode;
+    /** Cor aplicada quando a opção está ativa. */
+    kind?: Kind;
+    disabled?: boolean;
+};
+type SegmentedToggleProps<T extends string> = {
+    id?: string;
+    className?: string;
+    value: T;
+    options: Array<SegmentedToggleOption<T>>;
+    onChange?: (value: T) => void;
+    /** Tamanho do toggle. Default "md". */
+    size?: "sm" | "md";
+    /** Label invisível pra screen readers (a11y). */
+    ariaLabel?: string;
+};
+declare function SegmentedToggle<T extends string>({ id, className, value, options, onChange, size, ariaLabel, }: SegmentedToggleProps<T>): React.JSX.Element;
+export { SegmentedToggle };
+export type { SegmentedToggleOption, SegmentedToggleProps };

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

@@ -0,0 +1 @@
+export * from "./SegmentedToggle";

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

@@ -0,0 +1,27 @@
+import React from "react";
+import "./index.css";
+type SelectItem = {
+    label: string | React.ReactNode;
+    value?: any;
+    options?: Array<{
+        label: string;
+        value: any;
+    }>;
+    disabled?: boolean;
+};
+type SelectProps = {
+    id?: string;
+    className?: string;
+    menuClassName?: string;
+    loading?: boolean;
+    disabled?: boolean;
+    placeholder?: string;
+    floatingPlaceholder?: boolean;
+    mode?: "bordered" | "shadowed" | "table";
+    multiple?: boolean;
+    value?: any;
+    options: Array<SelectItem>;
+    onChange?: (value: any) => void;
+};
+declare const Select: ({ id, className, menuClassName, loading, disabled, placeholder, floatingPlaceholder, mode, multiple, value, options, onChange, }: SelectProps) => React.JSX.Element;
+export { Select };

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

@@ -0,0 +1 @@
+export * from "./Select";

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

@@ -0,0 +1,35 @@
+import React from "react";
+import "./index.css";
+type TreeInputType = 'text' | 'number' | 'boolean' | 'select' | 'select-multiple' | 'currency' | 'date' | 'month' | 'date-range';
+type TreeProps = {
+    key: string;
+    name: string;
+    input?: {
+        type: TreeInputType;
+        placeholder?: string;
+        options?: Array<{
+            label: string;
+            value: string;
+        }>;
+    };
+    value?: string;
+    tree?: Array<TreeProps>;
+    category?: string;
+};
+type SelectTreeProps = {
+    id?: string;
+    placeholder?: string;
+    className?: string;
+    tree: Array<TreeProps>;
+    initialValue?: {
+        keys?: Array<string>;
+        value?: any;
+    };
+    onChange?: (params: {
+        keys: Array<string>;
+        value: any;
+    }) => void;
+    rows?: number;
+};
+declare const SelectTree: ({ id, placeholder, className, tree, initialValue: controlledValue, onChange, rows, }: SelectTreeProps) => React.JSX.Element;
+export { SelectTree };

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

@@ -0,0 +1 @@
+export * from "./SelectTree";

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

@@ -0,0 +1,27 @@
+import React from "react";
+import "./index.css";
+type SelectorItem = {
+    key: string;
+    title?: string | React.ReactNode;
+    disabled?: boolean;
+    separator?: boolean;
+    items?: Array<{
+        key: string;
+        title?: string | React.ReactNode;
+        disabled?: boolean;
+        separator?: boolean;
+        items?: Array<SelectorItem>;
+    }>;
+};
+type SelectorProps = {
+    id?: string;
+    className?: string;
+    borderless?: boolean;
+    orientation?: 'horizontal' | 'vertical';
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    items?: Array<SelectorItem>;
+    onClick?: (keys: Array<string>) => void;
+    children: React.ReactNode;
+};
+declare const Selector: ({ id, className, side, items, onClick, children, }: SelectorProps) => React.JSX.Element;
+export { Selector };

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

@@ -0,0 +1 @@
+export * from "./Selector";

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

@@ -0,0 +1,16 @@
+import React from "react";
+import "./index.css";
+type StatusTagVariant = 'success' | 'danger' | 'warning' | 'info' | 'neutral' | 'primary';
+type StatusTagProps = {
+    id?: string;
+    className?: string;
+    /** Semantic variant (preferred). */
+    variant?: StatusTagVariant;
+    /** Legacy: any css color. Rendered as subtle tint + the color as text. */
+    color?: string;
+    title?: string;
+    icon?: React.ReactNode;
+};
+declare const StatusTag: ({ id, className, variant, color, title, icon, }: StatusTagProps) => React.JSX.Element;
+export { StatusTag };
+export type { StatusTagVariant };

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

@@ -0,0 +1 @@
+export * from "./StatusTag";

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

@@ -0,0 +1,15 @@
+import React from "react";
+import "./index.css";
+type StatusTagProps = {
+    id?: string;
+    className?: string;
+    currentStepValue?: string;
+    steps: {
+        value: string;
+        title: string;
+        subtitle: string;
+        position?: string;
+    }[];
+};
+declare const Stepper: ({ id, className, currentStepValue, steps, }: StatusTagProps) => React.JSX.Element;
+export { Stepper };

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

@@ -0,0 +1 @@
+export * from "./Stepper";

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

@@ -0,0 +1,11 @@
+import React from "react";
+import "./index.css";
+type SwitchProps = {
+    id?: string;
+    className?: string;
+    disabled?: boolean;
+    checked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+};
+declare const Switch: ({ id, className, disabled, checked, onCheckedChange, }: SwitchProps) => React.JSX.Element;
+export { Switch };

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

@@ -0,0 +1 @@
+export * from "./Switch";

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

@@ -0,0 +1,17 @@
+import React from "react";
+import "./index.css";
+type SyncChipProps = {
+    id?: string;
+    className?: string;
+    loading?: boolean;
+    date?: string | Date;
+    error?: boolean | string;
+    verified?: boolean;
+    /** Optional override for the error tooltip when error is true. */
+    errorTooltip?: string;
+    /** Optional override for the tooltip when verified is false. */
+    notVerifiedTooltip?: string;
+};
+declare const SyncChip: ({ id, className, loading, date, error, verified, errorTooltip, notVerifiedTooltip, }: SyncChipProps) => React.JSX.Element;
+export { SyncChip };
+export type { SyncChipProps };

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

@@ -0,0 +1 @@
+export * from "./SyncChip";

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

@@ -0,0 +1,29 @@
+import React from "react";
+import "./index.css";
+type TableColumnProps = {
+    key: string;
+    header: string;
+    render?: (value: any, data: any) => React.ReactNode | string;
+    align?: 'left' | 'center' | 'right';
+    width?: string | number;
+};
+type TableProps = {
+    id?: string;
+    className?: string;
+    height?: number;
+    type?: 'list' | 'card' | 'bordered';
+    columns: Array<TableColumnProps>;
+    data: Array<any>;
+    empty?: {
+        icon?: React.ReactNode;
+        text?: string;
+    };
+    headlesss?: boolean;
+    onRowClick?: (e: React.MouseEvent<HTMLTableRowElement, MouseEvent>, data: any) => void;
+    /** Optional per-row className. Receives the row's data object and its
+     *  zero-based index. Useful for transient state highlights (e.g. a row
+     *  that just finished processing in real-time). */
+    rowClassName?: (data: any, index: number) => string | undefined;
+};
+declare const Table: ({ id, className, height, type, columns, data, empty, headlesss, onRowClick, rowClassName, }: TableProps) => React.JSX.Element;
+export { Table };

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

@@ -0,0 +1 @@
+export * from "./Table";

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

@@ -0,0 +1,20 @@
+import React from "react";
+import "./index.css";
+type TabsProps = {
+    id?: string;
+    className?: string;
+    defaultValue?: string;
+    value?: string;
+    align?: 'start' | 'center' | 'end';
+    clickable?: boolean;
+    tabs: Array<{
+        key: string;
+        title: string | React.ReactNode;
+        disabled?: boolean;
+        hidden?: boolean;
+        content: React.ReactNode;
+    }>;
+    onTabChange?: (tab: any) => void;
+};
+declare const Tabs: ({ id, className, defaultValue, value, align, clickable, tabs, onTabChange, }: TabsProps) => React.JSX.Element;
+export { Tabs };

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

@@ -0,0 +1 @@
+export * from "./Tabs";

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

@@ -0,0 +1,10 @@
+import React from "react";
+import "./index.css";
+type TagProps = {
+    id?: string;
+    className?: string;
+    icon?: React.ReactNode;
+    children?: React.ReactNode | string;
+};
+declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<unknown>>;
+export { Tag };

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

@@ -0,0 +1 @@
+export * from "./Tag";

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

@@ -0,0 +1,4 @@
+import React from 'react';
+import { toast } from "react-toastify";
+declare function ToastContainer(): React.JSX.Element;
+export { toast, ToastContainer, };

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

@@ -0,0 +1 @@
+export * from './Toast';

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

@@ -0,0 +1,16 @@
+import React from "react";
+import "./index.css";
+type TooltipProps = {
+    id?: string;
+    className?: string;
+    align?: "start" | "center" | "end";
+    side?: "top" | "right" | "bottom" | "left";
+    sideOffset?: number;
+    visible?: boolean;
+    content: string | React.ReactNode;
+    width?: string | number;
+    delayDuration?: number;
+    children?: React.ReactNode;
+};
+declare const Tooltip: ({ id, className, align, side, sideOffset, visible, content, width, delayDuration, children, }: TooltipProps) => React.JSX.Element;
+export { Tooltip };

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

@@ -0,0 +1 @@
+export * from "./Tooltip";

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

@@ -0,0 +1,39 @@
+import React from 'react';
+import './index.css';
+export type TourStep = {
+    title: string;
+    body: string;
+    targetSelector: string;
+    navSection?: string;
+    padding?: number;
+    /**
+     * Como alinhar o alvo ao rolar. 'center' (padrão para alvos pequenos) é
+     * imune à altura de toolbars fixas. 'start' é melhor para seções altas.
+     * 'nearest' rola o mínimo possível (bom para elementos flutuantes/portais
+     * que já estão visíveis, como dropdowns). Se omitido, decidimos pela altura.
+     */
+    scrollBlock?: 'start' | 'center' | 'nearest';
+    /**
+     * Efeito colateral ao ENTRAR no passo, disparado depois da navegação e do
+     * mount da seção (ex.: abrir um dropdown para destacá-lo). Use junto com
+     * targetSelector apontando para o conteúdo revelado.
+     */
+    onEnter?: () => void;
+    /** Limpeza ao SAIR do passo (ex.: fechar o dropdown aberto no onEnter). */
+    onLeave?: () => void;
+};
+export type TourGuideProps = {
+    steps: TourStep[];
+    visible: boolean;
+    onClose: () => void;
+    onNavigate?: (navSection: string) => void;
+    /**
+     * Espaço (px) reservado no topo ao rolar alvos altos (block:'start') para que
+     * não fiquem atrás de toolbars fixas. Aceita número ou função (recalculada a
+     * cada passo) — use a função quando a altura da toolbar varia (wrap/mobile).
+     * Alvos pequenos usam block:'center' e ignoram esse valor. Padrão: 0.
+     */
+    scrollOffsetTop?: number | (() => number);
+    className?: string;
+};
+export declare function TourGuide({ steps, visible, onClose, onNavigate, scrollOffsetTop, className, }: TourGuideProps): React.JSX.Element | null;

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

@@ -0,0 +1 @@
+export * from './TourGuide';

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

@@ -0,0 +1,7 @@
+import React from "react";
+type WaypointProps = {
+    onEnter?: () => void;
+    onLeave?: () => void;
+};
+declare const Waypoint: ({ onEnter, onLeave, }: WaypointProps) => React.JSX.Element;
+export { Waypoint };

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

@@ -0,0 +1 @@
+export * from "./Waypoint";

package/dist/emails/email/emails/balance-sheet-finalized/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Preset do email "Análise financeira concluída" enviado quando o gyra-ai
+ * finaliza a extração de um balanço (feature Finsights — CU-86aherfzc).
+ *
+ * Esta é uma **camada fina de mapeamento de domínio** sobre o
+ * `buildEmail` genérico: recebe os campos crus que o gyra-ai produz
+ * (score, risk, recommendation, xlsxUrl, ...) e monta o `EmailLayoutInput`
+ * com as decisões visuais (cor do risco, tom do veredito, textos padrão).
+ *
+ * Pra criar outro preset (ex: `password-reset`, `report-finalized`,
+ * `batch-finalized`), criar uma pasta nova em `src/emails/<name>/` que
+ * importe `buildEmail` e exporte uma função `<name>Email(payload)` com a
+ * mesma assinatura: `{ subject, html }`.
+ */
+export type BalanceSheetFinalizedPayload = {
+    firstName?: string;
+    companyName?: string;
+    score?: number | string;
+    risk?: string;
+    recommendation?: string;
+    xlsxUrl?: string;
+    reportUrl?: string;
+};
+/**
+ * Monta `{ subject, html }` do email "Análise financeira concluída" a
+ * partir do payload do gyra-ai (score, risco, recomendação, XLS, etc).
+ * Usado pelo gyra-communication (envio via SendGrid) e pelo Storybook
+ * (preview).
+ */
+export declare function balanceSheetFinalizedEmail(payload: BalanceSheetFinalizedPayload): {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,94 @@
+/**
+ * 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;