forlogic-core 2.2.8 → 2.3.1

package/dist/places/components/ui/table-resize-handle.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+interface TableResizeHandleProps {
+    direction: 'horizontal' | 'vertical';
+    onMouseDown: (e: React.MouseEvent) => void;
+    isDragging?: boolean;
+    className?: string;
+}
+/**
+ * Handle visual para resize de colunas (horizontal) ou linhas (vertical) em tabelas.
+ * Segue o padrão visual do `ResizableHandle` do Design System. Use junto de
+ * `useColumnResize` ou `useRowResize`.
+ *
+ * @example
+ * ```tsx
+ * <th className="relative">
+ *   Coluna
+ *   <TableResizeHandle direction="horizontal" onMouseDown={handleMouseDown} isDragging={isDragging} />
+ * </th>
+ * ```
+ */
+export declare const TableResizeHandle: React.ForwardRefExoticComponent<TableResizeHandleProps & React.RefAttributes<HTMLDivElement>>;
+export { TableResizeHandle as default };

package/dist/places/components/ui/table.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @module Table
+ * Componente primitivo de tabela com customizações Forlogic sobre o shadcn base:
+ * - `table-fixed` obrigatório (preserva integridade do layout em drag-and-drop e resize).
+ * - `TableHeader` é **sticky** por padrão (`sticky top-0 z-[1]`) — funciona com scroll do contêiner.
+ * - Densidade visual aumentada: `text-[13px]`, `TableHead h-9`, `TableCell py-2`.
+ * - Linhas zebradas via `even:bg-table-stripe`.
+ *
+ * Para CRUDs com filtros, paginação e column manager, use `CrudTable` ou `DataTable`
+ * (aliases) ao invés deste primitivo.
+ *
+ * @see `docs/design-system/tables-grids.md`
+ */
+import * as React from "react";
+/**
+ * Raiz da tabela. Aplica `w-full table-fixed text-[13px]`.
+ *
+ * @example
+ * ```tsx
+ * <Table>
+ *   <TableHeader>...</TableHeader>
+ *   <TableBody>...</TableBody>
+ * </Table>
+ * ```
+ */
+declare const Table: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableElement> & React.RefAttributes<HTMLTableElement>>;
+/**
+ * Cabeçalho da tabela (`<thead>`). Sticky por padrão (`sticky top-0 z-[1]`),
+ * funciona quando o contêiner pai possui `overflow-y-auto`.
+ *
+ * @example
+ * ```tsx
+ * <TableHeader>
+ *   <TableRow>
+ *     <TableHead>Nome</TableHead>
+ *     <TableHead>Email</TableHead>
+ *   </TableRow>
+ * </TableHeader>
+ * ```
+ */
+declare const TableHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * Corpo da tabela (`<tbody>`). Remove a borda inferior da última linha automaticamente.
+ *
+ * @example
+ * ```tsx
+ * <TableBody>
+ *   {rows.map(r => <TableRow key={r.id}>...</TableRow>)}
+ * </TableBody>
+ * ```
+ */
+declare const TableBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * Rodapé da tabela (`<tfoot>`). Útil para linhas de totalização.
+ *
+ * @example
+ * ```tsx
+ * <TableFooter>
+ *   <TableRow>
+ *     <TableCell colSpan={2}>Total</TableCell>
+ *     <TableCell>{total}</TableCell>
+ *   </TableRow>
+ * </TableFooter>
+ * ```
+ */
+declare const TableFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * Linha (`<tr>`). Aplica zebra automática (`even:bg-table-stripe`) e estado
+ * `data-[state=selected]` para seleção via checkbox.
+ *
+ * @example
+ * ```tsx
+ * <TableRow data-state={selected ? 'selected' : undefined}>
+ *   <TableCell>...</TableCell>
+ * </TableRow>
+ * ```
+ */
+declare const TableRow: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableRowElement> & React.RefAttributes<HTMLTableRowElement>>;
+/**
+ * Célula de cabeçalho (`<th>`). Altura `h-9` e padding `py-2 px-4` por padrão
+ * (densidade visual da lib).
+ *
+ * @example
+ * ```tsx
+ * <TableHead className="w-[200px]">Nome</TableHead>
+ * ```
+ */
+declare const TableHead: React.ForwardRefExoticComponent<React.ThHTMLAttributes<HTMLTableCellElement> & React.RefAttributes<HTMLTableCellElement>>;
+/**
+ * Célula de dado (`<td>`). Padding `py-2 px-4` e `overflow-hidden`
+ * (combinar com `TruncatedCell` para texto longo).
+ *
+ * @example
+ * ```tsx
+ * <TableCell>{user.name}</TableCell>
+ * <TableCell><TruncatedCell>{user.bio}</TruncatedCell></TableCell>
+ * ```
+ */
+declare const TableCell: React.ForwardRefExoticComponent<React.TdHTMLAttributes<HTMLTableCellElement> & React.RefAttributes<HTMLTableCellElement>>;
+/**
+ * Legenda da tabela (`<caption>`). Renderiza abaixo (`caption-bottom`).
+ *
+ * @example
+ * ```tsx
+ * <Table>
+ *   <TableCaption>Lista de usuários ativos no sistema.</TableCaption>
+ *   ...
+ * </Table>
+ * ```
+ */
+declare const TableCaption: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableCaptionElement> & React.RefAttributes<HTMLTableCaptionElement>>;
+export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, };

package/dist/places/components/ui/tabs.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @module Tabs
+ * Sistema de abas para alternar entre visões. Use `defaultValue` para modo não controlado
+ * ou `value` + `onValueChange` para controle externo (sincronizar com URL, por exemplo).
+ *
+ * Composição: `Tabs` (raiz) + `TabsList` + `TabsTrigger` (um por aba) + `TabsContent` (conteúdo).
+ *
+ * @see `docs/design-system/navigation.md`
+ */
+import * as React from "react";
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+/**
+ * Raiz do sistema de abas. Re-exporta `TabsPrimitive.Root` do Radix.
+ *
+ * @example Não controlado
+ * ```tsx
+ * <Tabs defaultValue="geral">
+ *   <TabsList>
+ *     <TabsTrigger value="geral">Geral</TabsTrigger>
+ *     <TabsTrigger value="avancado">Avançado</TabsTrigger>
+ *   </TabsList>
+ *   <TabsContent value="geral">...</TabsContent>
+ *   <TabsContent value="avancado">...</TabsContent>
+ * </Tabs>
+ * ```
+ *
+ * @example Controlado (sincronizado com URL)
+ * ```tsx
+ * <Tabs value={tab} onValueChange={setTab}>...</Tabs>
+ * ```
+ */
+declare const Tabs: React.ForwardRefExoticComponent<TabsPrimitive.TabsProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Container horizontal dos triggers de aba. Aparência de "pill group" com fundo `muted`.
+ *
+ * @example
+ * ```tsx
+ * <TabsList>
+ *   <TabsTrigger value="a">A</TabsTrigger>
+ *   <TabsTrigger value="b">B</TabsTrigger>
+ * </TabsList>
+ * ```
+ */
+declare const TabsList: React.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsListProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Botão de uma aba. O `value` deve corresponder a um `TabsContent` irmão.
+ *
+ * @example
+ * ```tsx
+ * <TabsTrigger value="settings">Configurações</TabsTrigger>
+ * ```
+ */
+declare const TabsTrigger: React.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Conteúdo associado a um `TabsTrigger`. O `value` deve casar com o trigger.
+ * Renderizado apenas quando a aba está ativa (forceMount=false por padrão).
+ *
+ * @example
+ * ```tsx
+ * <TabsContent value="settings">
+ *   <SettingsForm />
+ * </TabsContent>
+ * ```
+ */
+declare const TabsContent: React.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { Tabs, TabsList, TabsTrigger, TabsContent };

package/dist/places/components/ui/terms-of-use-dialog.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Termo de uso a ser exibido. `file` é base64 (PDF/imagem); `description` aceita HTML.
+ *
+ * @example
+ * ```tsx
+ * const term: TermOfUse = { id: 'v3', description: '<p>Atualizamos...</p>', hasUserSignature: false };
+ * ```
+ */
+export interface TermOfUse {
+    /** Unique identifier */
+    id: string;
+    /** Optional description/summary (may contain HTML) */
+    description?: string;
+    /** Base64-encoded file content */
+    file?: string;
+    /** MIME type of the file (e.g. 'application/pdf') */
+    type?: string;
+    /** Whether the current user has already signed this term */
+    hasUserSignature?: boolean;
+}
+/**
+ * Props do `TermsOfUseDialog`. `onAgree` recebe o `term.id` para
+ * registrar a assinatura no backend.
+ *
+ * @example
+ * ```tsx
+ * const props: TermsOfUseDialogProps = { term, open, onClose, onAgree: signTerm };
+ * ```
+ */
+export interface TermsOfUseDialogProps {
+    /** The term of use to display */
+    term: TermOfUse;
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Called when the user clicks t('terms_see_later') or closes */
+    onClose: () => void;
+    /** Called when the user agrees to the terms. Receives the term ID. */
+    onAgree: (termId: string) => void;
+    /** Override title */
+    title?: string;
+    /** Override t('terms_see_later') button text */
+    seeLaterLabel?: string;
+    /** Override "I have read and agree" button text */
+    agreeLabel?: string;
+    /** Override t('terms_view_short') button text */
+    viewTermLabel?: string;
+}
+/**
+ * Props do `TermsOfUseViewer`. Use `viewOnly` para esconder o botão de assinar.
+ *
+ * @example
+ * ```tsx
+ * const props: TermsOfUseViewerProps = { term, open, onClose, viewOnly: true };
+ * ```
+ */
+export interface TermsOfUseViewerProps {
+    /** The term of use to display */
+    term: TermOfUse;
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Called when closing the viewer */
+    onClose: () => void;
+    /** Called when the user signs the term from inside the viewer. Receives the term ID. */
+    onSign?: (termId: string) => void;
+    /** If true, hides the sign button (view-only mode) */
+    viewOnly?: boolean;
+    /** Override title */
+    title?: string;
+    /** Override sign button text */
+    signLabel?: string;
+}
+/**
+ * Dialog que notifica o usuário sobre uma versão atualizada dos termos de uso.
+ * Mostra a descrição (HTML) e botões para visualizar o arquivo completo,
+ * adiar ("ver depois") ou concordar.
+ *
+ * @example
+ * ```tsx
+ * <TermsOfUseDialog
+ *   term={currentTerm}
+ *   open={hasNewTerm}
+ *   onClose={() => setHasNewTerm(false)}
+ *   onAgree={(id) => api.signTerm(id)}
+ * />
+ * ```
+ */
+export declare function TermsOfUseDialog({ term, open, onClose, onAgree, title, seeLaterLabel, agreeLabel, viewTermLabel, }: TermsOfUseDialogProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Visualizador full-screen do arquivo do termo de uso (PDF etc.) em iframe.
+ * Mostra opcionalmente um botão de assinar (oculto se `viewOnly` ou se já assinado).
+ *
+ * @example
+ * ```tsx
+ * <TermsOfUseViewer
+ *   term={term}
+ *   open={open}
+ *   onClose={() => setOpen(false)}
+ *   onSign={(id) => api.signTerm(id)}
+ * />
+ * ```
+ */
+export declare function TermsOfUseViewer({ term, open, onClose, onSign, viewOnly, title, signLabel, }: TermsOfUseViewerProps): import("react/jsx-runtime").JSX.Element;

package/dist/places/components/ui/textarea.d.ts

@@ -0,0 +1,33 @@
+import * as React from "react";
+/**
+ * Props do `Textarea`. Estende todos os atributos HTML padrão.
+ *
+ * @example
+ * ```tsx
+ * const props: TextareaProps = { showCharCount: true, maxLength: 200 };
+ * ```
+ */
+export interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /**
+     * Quando `true` e `maxLength` for definido, exibe contador `N / max`
+     * abaixo do textarea (alinhado à direita).
+     */
+    showCharCount?: boolean;
+}
+/**
+ * Textarea padrão da lib com hover/focus refinados (border-primary no hover).
+ * Aceita `showCharCount` + `maxLength` para exibir contador automaticamente.
+ *
+ * @example
+ * ```tsx
+ * <Textarea
+ *   placeholder="Descreva o ocorrido..."
+ *   maxLength={500}
+ *   showCharCount
+ * />
+ * ```
+ *
+ * @see `docs/design-system/inputs.md`
+ */
+declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
+export { Textarea };

package/dist/places/components/ui/timepicker.d.ts

@@ -0,0 +1,34 @@
+import * as React from 'react';
+/**
+ * Props do `Timepicker`. Estende `<input>` (exceto `type`/`onChange`/`value`,
+ * que são gerenciados internamente).
+ *
+ * @example
+ * ```tsx
+ * const props: TimepickerProps = { value: '14:30', onChange: setHora, label: 'Horário' };
+ * ```
+ */
+export interface TimepickerProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'onChange' | 'value'> {
+    value?: string;
+    onChange?: (value: string) => void;
+    onTimeChange?: (value: string) => void;
+    label?: string;
+    error?: string;
+    format?: '12h' | '24h';
+}
+/**
+ * Campo de seleção de horário (`<input type="time">`) com label, ícone de relógio
+ * e mensagem de erro integrados. Usa formato 24h por padrão.
+ *
+ * @example
+ * ```tsx
+ * <Timepicker
+ *   label="Início do expediente"
+ *   value={hora}
+ *   onChange={setHora}
+ *   error={errors.hora?.message}
+ * />
+ * ```
+ */
+declare const Timepicker: React.ForwardRefExoticComponent<TimepickerProps & React.RefAttributes<HTMLInputElement>>;
+export { Timepicker };

package/dist/places/components/ui/toggle-group.d.ts

@@ -0,0 +1,37 @@
+import * as React from "react";
+import * as ToggleGroupPrimitive from "@radix-ui/react-toggle-group";
+import { type VariantProps } from "class-variance-authority";
+/**
+ * Grupo de toggles (single ou multiple). Compartilha `variant`/`size` com seus
+ * `ToggleGroupItem` filhos via Context. Use `type="single"` para seleção única
+ * (rádio-like) ou `type="multiple"` para múltipla.
+ *
+ * @example
+ * ```tsx
+ * <ToggleGroup type="single" value={align} onValueChange={setAlign} variant="outline">
+ *   <ToggleGroupItem value="left"><AlignLeft /></ToggleGroupItem>
+ *   <ToggleGroupItem value="center"><AlignCenter /></ToggleGroupItem>
+ *   <ToggleGroupItem value="right"><AlignRight /></ToggleGroupItem>
+ * </ToggleGroup>
+ * ```
+ */
+declare const ToggleGroup: React.ForwardRefExoticComponent<((Omit<ToggleGroupPrimitive.ToggleGroupSingleProps & React.RefAttributes<HTMLDivElement>, "ref"> | Omit<ToggleGroupPrimitive.ToggleGroupMultipleProps & React.RefAttributes<HTMLDivElement>, "ref">) & VariantProps<(props?: {
+    variant?: "outline" | "default";
+    size?: "default" | "sm" | "lg";
+} & import("class-variance-authority/types").ClassProp) => string>) & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Item individual de um `ToggleGroup`. Herda `variant`/`size` do grupo, mas
+ * pode sobrescrever localmente.
+ *
+ * @example
+ * ```tsx
+ * <ToggleGroupItem value="bold" aria-label="Negrito">
+ *   <Bold className="h-4 w-4" />
+ * </ToggleGroupItem>
+ * ```
+ */
+declare const ToggleGroupItem: React.ForwardRefExoticComponent<Omit<ToggleGroupPrimitive.ToggleGroupItemProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: {
+    variant?: "outline" | "default";
+    size?: "default" | "sm" | "lg";
+} & import("class-variance-authority/types").ClassProp) => string> & React.RefAttributes<HTMLButtonElement>>;
+export { ToggleGroup, ToggleGroupItem };

package/dist/places/components/ui/toggle.d.ts

@@ -0,0 +1,33 @@
+import * as React from "react";
+import * as TogglePrimitive from "@radix-ui/react-toggle";
+import { type VariantProps } from "class-variance-authority";
+/**
+ * Variantes do `Toggle` (cva). Combina `variant` (`default` | `outline`) e
+ * `size` (`default` | `sm` | `lg`). Reutilizado por `ToggleGroupItem`.
+ *
+ * @example
+ * ```tsx
+ * <button className={toggleVariants({ variant: 'outline', size: 'sm' })}>B</button>
+ * ```
+ */
+declare const toggleVariants: (props?: {
+    variant?: "outline" | "default";
+    size?: "default" | "sm" | "lg";
+} & import("class-variance-authority/types").ClassProp) => string;
+/**
+ * Botão alternável (on/off). Use para ações binárias como "Negrito", "Itálico"
+ * em editores ou "Modo escuro" em preferências. Estado controlado via `pressed` +
+ * `onPressedChange` (Radix Toggle).
+ *
+ * @example
+ * ```tsx
+ * <Toggle variant="outline" pressed={bold} onPressedChange={setBold}>
+ *   <Bold className="h-4 w-4" />
+ * </Toggle>
+ * ```
+ */
+declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: {
+    variant?: "outline" | "default";
+    size?: "default" | "sm" | "lg";
+} & import("class-variance-authority/types").ClassProp) => string> & React.RefAttributes<HTMLButtonElement>>;
+export { Toggle, toggleVariants };

package/dist/places/components/ui/tooltip.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @module Tooltip
+ * Tooltip por hover/focus. Composição: `TooltipProvider` (envolve a árvore — pode ser global)
+ * + `Tooltip` (raiz por instância) + `TooltipTrigger` (use `asChild` para reaproveitar elemento)
+ * + `TooltipContent` (texto, com `side`, `sideOffset`, etc).
+ *
+ * `delayDuration` padrão de **300ms** (override do shadcn). Reduz flicker em listas densas.
+ */
+import * as React from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+/**
+ * Provider global de tooltips. Envolva a árvore uma única vez (já incluso em `CoreProviders`).
+ * `delayDuration` padrão: **300ms**.
+ *
+ * @example
+ * ```tsx
+ * <TooltipProvider delayDuration={300}>
+ *   <App />
+ * </TooltipProvider>
+ * ```
+ */
+declare const TooltipProvider: ({ delayDuration, ...props }: React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Raiz de uma instância de tooltip. Re-exporta `TooltipPrimitive.Root` do Radix.
+ *
+ * @example
+ * ```tsx
+ * <Tooltip>
+ *   <TooltipTrigger asChild><Button>?</Button></TooltipTrigger>
+ *   <TooltipContent>Ajuda</TooltipContent>
+ * </Tooltip>
+ * ```
+ */
+declare const Tooltip: React.FC<TooltipPrimitive.TooltipProps>;
+/**
+ * Trigger do tooltip. Use `asChild` para herdar o elemento filho (recomendado para botões/ícones).
+ *
+ * @example
+ * ```tsx
+ * <TooltipTrigger asChild>
+ *   <Button variant="icon"><Info /></Button>
+ * </TooltipTrigger>
+ * ```
+ */
+declare const TooltipTrigger: React.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Conteúdo do tooltip. Aceita `side` (`top`/`right`/`bottom`/`left`) e `sideOffset` (padrão 4).
+ *
+ * Renderizado via `TooltipPrimitive.Portal` (default: `document.body`) para evitar clipping
+ * em containers com `overflow-auto`/`overflow-hidden` (sidebars, cards com scroll, dialogs).
+ * Use a prop opcional `container` para portar para um nó específico (casos avançados).
+ *
+ * @example
+ * ```tsx
+ * <TooltipContent side="right" sideOffset={8}>Texto explicativo</TooltipContent>
+ * ```
+ */
+declare const TooltipContent: React.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    container?: HTMLElement | null;
+} & React.RefAttributes<HTMLDivElement>>;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/places/components/ui/truncated-cell.d.ts

@@ -0,0 +1,20 @@
+import * as React from "react";
+interface TruncatedCellProps {
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * Célula com `text-overflow: ellipsis` que detecta truncamento via `ResizeObserver`
+ * e exibe automaticamente um `Tooltip` com o conteúdo completo apenas quando há overflow.
+ *
+ * Disponível também como **alias `EllipsisText`** (padrão de mercado, exportado em `forlogic-core`).
+ *
+ * @example
+ * ```tsx
+ * <TruncatedCell>{textoLongo}</TruncatedCell>
+ * ```
+ *
+ * @see `docs/design-system/data-display.md`
+ */
+export declare function TruncatedCell({ children, className }: TruncatedCellProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/places/components/ui/typography.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @module Typography
+ * Conjunto de 11 componentes tipográficos prontos seguindo a escala da lib:
+ * `H1`, `H2`, `H3`, `H4`, `P`, `Lead`, `Large`, `Small`, `Muted`, `InlineCode`, `Blockquote`, `List`.
+ *
+ * Use sempre que possível ao invés de aplicar classes Tailwind soltas em `<h1>`, `<p>`, etc.
+ * Garante consistência com a fonte base Inter (13px) e a escala definida em `index.css`.
+ *
+ * @see `docs/design-system/foundation.md`
+ */
+import * as React from "react";
+/**
+ * Props compartilhadas por todos os componentes tipográficos.
+ * Estende os atributos HTML padrão do elemento (heading, paragraph, etc.).
+ *
+ * @example
+ * ```tsx
+ * const Custom: React.FC<TypographyProps> = (props) => <H2 {...props} />;
+ * ```
+ */
+export interface TypographyProps extends React.HTMLAttributes<HTMLElement> {
+}
+/**
+ * Título principal da página (`<h1>`). Use **uma única vez** por página (regra SEO).
+ *
+ * @example
+ * ```tsx
+ * <H1>Painel de Controle</H1>
+ * ```
+ */
+declare const H1: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Título de seção (`<h2>`). Inclui borda inferior automática para dividir blocos.
+ *
+ * @example
+ * ```tsx
+ * <H2>Configurações gerais</H2>
+ * ```
+ */
+declare const H2: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Subtítulo (`<h3>`). Use dentro de seções marcadas por `H2`.
+ *
+ * @example
+ * ```tsx
+ * <H3>Notificações por email</H3>
+ * ```
+ */
+declare const H3: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Título menor (`<h4>`). Útil para subdivisões de cards/painéis.
+ *
+ * @example
+ * ```tsx
+ * <H4>Detalhes do item</H4>
+ * ```
+ */
+declare const H4: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Parágrafo padrão (`<p>`). Aplica `mt-6` quando não é o primeiro filho.
+ *
+ * @example
+ * ```tsx
+ * <P>Texto descritivo regular.</P>
+ * ```
+ */
+declare const P: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Subtítulo grande/lead (`text-xl`, cor `muted-foreground`). Use logo abaixo de `H1`/`H2`.
+ *
+ * @example
+ * ```tsx
+ * <H1>Bem-vindo</H1>
+ * <Lead>Comece configurando sua primeira unidade.</Lead>
+ * ```
+ */
+declare const Lead: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Texto destacado em tamanho `text-lg` semi-bold. Renderiza um `<div>`.
+ *
+ * @example
+ * ```tsx
+ * <Large>R$ 1.250,00</Large>
+ * ```
+ */
+declare const Large: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Texto secundário em `<small>` (`text-sm font-medium`). Útil para legendas.
+ *
+ * @example
+ * ```tsx
+ * <Small>Atualizado há 5 minutos</Small>
+ * ```
+ */
+declare const Small: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLElement>>;
+/**
+ * Texto auxiliar atenuado (`text-sm text-muted-foreground`). Use para hints e helper text.
+ *
+ * @example
+ * ```tsx
+ * <Muted>Este campo é opcional.</Muted>
+ * ```
+ */
+declare const Muted: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Código inline (`<code>`) com fundo `muted` e fonte mono.
+ *
+ * @example
+ * ```tsx
+ * <P>Use o comando <InlineCode>npm install</InlineCode> para começar.</P>
+ * ```
+ */
+declare const InlineCode: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLElement>>;
+/**
+ * Citação em bloco (`<blockquote>`) com borda lateral esquerda.
+ *
+ * @example
+ * ```tsx
+ * <Blockquote>"O design é como funciona, não como parece."</Blockquote>
+ * ```
+ */
+declare const Blockquote: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLQuoteElement>>;
+/**
+ * Lista não-ordenada (`<ul>`) com `list-disc` e espaçamento padrão entre itens.
+ *
+ * @example
+ * ```tsx
+ * <List>
+ *   <li>Item um</li>
+ *   <li>Item dois</li>
+ * </List>
+ * ```
+ */
+declare const List: React.ForwardRefExoticComponent<TypographyProps & React.RefAttributes<HTMLUListElement>>;
+export { H1, H2, H3, H4, P, Lead, Large, Small, Muted, InlineCode, Blockquote, List, };