forlogic-core 2.1.5 → 2.2.0

package/dist/components/ui/command.d.ts

@@ -1,21 +1,87 @@
+/**
+ * @module Command
+ * Menu de comandos (command palette / autocomplete) inspirado no `cmdk`.
+ * Composto por `Command` (raiz) + `CommandInput` + `CommandList` (com `CommandGroup`,
+ * `CommandItem`, `CommandSeparator`, `CommandEmpty`). Use `CommandDialog` como wrapper modal.
+ *
+ * @example
+ * ```tsx
+ * <Command>
+ *   <CommandInput placeholder="Buscar..." />
+ *   <CommandList>
+ *     <CommandEmpty>Nenhum resultado.</CommandEmpty>
+ *     <CommandGroup heading="Ações">
+ *       <CommandItem onSelect={() => navigate('/users')}>Ir para usuários</CommandItem>
+ *     </CommandGroup>
+ *   </CommandList>
+ * </Command>
+ * ```
+ *
+ * @see `docs/design-system/selectors.md`
+ */
 import * as React from "react";
+/**
+ * Container raiz do command (popover, fundo `bg-popover`).
+ * @example
+ * <Command><CommandInput /><CommandList>...</CommandList></Command>
+ */
 declare const Command: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 interface CommandDialogProps {
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
     children: React.ReactNode;
 }
+/**
+ * Wrapper modal do `Command`. Aplica estilos cmdk para uso em command palette.
+ * @example
+ * <CommandDialog open={open} onOpenChange={setOpen}><CommandInput />...</CommandDialog>
+ */
 declare const CommandDialog: ({ children, ...props }: CommandDialogProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Campo de busca do command. Usa `<input>` nativo com ícone slot.
+ * @example
+ * <CommandInput placeholder="Pesquisar comando..." value={q} onChange={...} />
+ */
 declare const CommandInput: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & React.RefAttributes<HTMLInputElement>>;
+/**
+ * Lista scrollável (max 300px). Container dos `CommandGroup` / `CommandItem`.
+ * @example
+ * <CommandList><CommandGroup>...</CommandGroup></CommandList>
+ */
 declare const CommandList: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Estado vazio (exibido quando não há resultados na busca).
+ * @example
+ * <CommandEmpty>Nenhum resultado encontrado.</CommandEmpty>
+ */
 declare const CommandEmpty: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Grupo de items com cabeçalho opcional (`heading`).
+ * @example
+ * <CommandGroup heading="Sugestões"><CommandItem>...</CommandItem></CommandGroup>
+ */
 declare const CommandGroup: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Linha divisória entre grupos.
+ * @example
+ * <CommandSeparator />
+ */
 declare const CommandSeparator: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Item selecionável do command. Recebe `value` e `onSelect(value)`.
+ * @example
+ * <CommandItem value="users" onSelect={(v) => navigate(`/${v}`)}>Usuários</CommandItem>
+ */
 declare const CommandItem: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
     disabled?: boolean;
     onSelect?: (value: string) => void;
     value?: string;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Atalho de teclado exibido à direita do item (estilo monospace, muted).
+ * @example
+ * <CommandItem>Salvar<CommandShortcut>⌘S</CommandShortcut></CommandItem>
+ */
 declare const CommandShortcut: {
     ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;

package/dist/components/ui/context-menu.d.ts

@@ -1,25 +1,120 @@
+/**
+ * @module ContextMenu
+ * Menu acionado por clique direito (right-click). Composto por `ContextMenu` + `ContextMenuTrigger`
+ * (área que captura o right-click) + `ContextMenuContent` (com `ContextMenuItem`,
+ * `ContextMenuCheckboxItem`, `ContextMenuRadioItem`, `ContextMenuSub`, etc).
+ *
+ * @example
+ * ```tsx
+ * <ContextMenu>
+ *   <ContextMenuTrigger>Clique direito aqui</ContextMenuTrigger>
+ *   <ContextMenuContent>
+ *     <ContextMenuItem onSelect={onCopy}>Copiar<ContextMenuShortcut>⌘C</ContextMenuShortcut></ContextMenuItem>
+ *     <ContextMenuSeparator />
+ *     <ContextMenuItem onSelect={onDelete}>Excluir</ContextMenuItem>
+ *   </ContextMenuContent>
+ * </ContextMenu>
+ * ```
+ *
+ * @see `docs/design-system/navigation.md`
+ */
 import * as React from "react";
 import * as ContextMenuPrimitive from "@radix-ui/react-context-menu";
+/**
+ * Raiz do ContextMenu. Controla estado open/onOpenChange.
+ * @example
+ * <ContextMenu><ContextMenuTrigger>...</ContextMenuTrigger><ContextMenuContent>...</ContextMenuContent></ContextMenu>
+ */
 declare const ContextMenu: React.FC<ContextMenuPrimitive.ContextMenuProps>;
+/**
+ * Área que captura o right-click. Use `asChild` para customizar.
+ * @example
+ * <ContextMenuTrigger asChild><div>Right-click here</div></ContextMenuTrigger>
+ */
 declare const ContextMenuTrigger: React.ForwardRefExoticComponent<ContextMenuPrimitive.ContextMenuTriggerProps & React.RefAttributes<HTMLSpanElement>>;
+/**
+ * Agrupa items relacionados (sem visual próprio, apenas semântico).
+ * @example
+ * <ContextMenuGroup><ContextMenuItem>...</ContextMenuItem></ContextMenuGroup>
+ */
 declare const ContextMenuGroup: React.ForwardRefExoticComponent<ContextMenuPrimitive.ContextMenuGroupProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Portal que renderiza o conteúdo fora da árvore DOM atual.
+ * @example
+ * <ContextMenuPortal><ContextMenuContent>...</ContextMenuContent></ContextMenuPortal>
+ */
 declare const ContextMenuPortal: React.FC<ContextMenuPrimitive.ContextMenuPortalProps>;
+/**
+ * Submenu aninhado. Use com `ContextMenuSubTrigger` e `ContextMenuSubContent`.
+ * @example
+ * <ContextMenuSub><ContextMenuSubTrigger>Mais</ContextMenuSubTrigger><ContextMenuSubContent>...</ContextMenuSubContent></ContextMenuSub>
+ */
 declare const ContextMenuSub: React.FC<ContextMenuPrimitive.ContextMenuSubProps>;
+/**
+ * Grupo de `ContextMenuRadioItem` (seleção única).
+ * @example
+ * <ContextMenuRadioGroup value={view} onValueChange={setView}>...</ContextMenuRadioGroup>
+ */
 declare const ContextMenuRadioGroup: React.ForwardRefExoticComponent<ContextMenuPrimitive.ContextMenuRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Trigger de submenu (mostra ChevronRight à direita). Use dentro de `ContextMenuSub`.
+ * @example
+ * <ContextMenuSubTrigger>Compartilhar</ContextMenuSubTrigger>
+ */
 declare const ContextMenuSubTrigger: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuSubTriggerProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Conteúdo do submenu. Renderizado com animação de slide.
+ * @example
+ * <ContextMenuSubContent><ContextMenuItem>...</ContextMenuItem></ContextMenuSubContent>
+ */
 declare const ContextMenuSubContent: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuSubContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Conteúdo principal do ContextMenu. Renderizado em Portal automaticamente.
+ * @example
+ * <ContextMenuContent><ContextMenuItem>...</ContextMenuItem></ContextMenuContent>
+ */
 declare const ContextMenuContent: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Item clicável. Use `inset` para alinhar com items que têm ícone/checkbox.
+ * @example
+ * <ContextMenuItem onSelect={onCopy}>Copiar</ContextMenuItem>
+ */
 declare const ContextMenuItem: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Item com checkbox. Suporta `checked` controlado e `onCheckedChange`.
+ * @example
+ * <ContextMenuCheckboxItem checked={visible} onCheckedChange={setVisible}>Mostrar</ContextMenuCheckboxItem>
+ */
 declare const ContextMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuCheckboxItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Item radio (seleção única). Deve estar dentro de `ContextMenuRadioGroup`.
+ * @example
+ * <ContextMenuRadioItem value="grid">Grid</ContextMenuRadioItem>
+ */
 declare const ContextMenuRadioItem: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuRadioItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Label não-clicável (cabeçalho de seção dentro do menu).
+ * @example
+ * <ContextMenuLabel>Ações</ContextMenuLabel>
+ */
 declare const ContextMenuLabel: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Linha divisória entre grupos de items.
+ * @example
+ * <ContextMenuSeparator />
+ */
 declare const ContextMenuSeparator: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Atalho de teclado exibido à direita do item (estilo monospace, muted).
+ * @example
+ * <ContextMenuItem>Copiar<ContextMenuShortcut>⌘C</ContextMenuShortcut></ContextMenuItem>
+ */
 declare const ContextMenuShortcut: {
     ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;

package/dist/components/ui/date-picker.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Tipo `DatePickerProps` exportado pela lib.
+ * @example
+ * const value: DatePickerProps = {} as DatePickerProps;
+ */
 export interface DatePickerProps {
     date?: Date;
     onDateChange?: (date: Date | undefined) => void;
@@ -6,4 +11,9 @@ export interface DatePickerProps {
     className?: string;
     disabledDates?: (date: Date) => boolean;
 }
+/**
+ * Função utilitária `DatePicker`.
+ * @example
+ * DatePicker();
+ */
 export declare function DatePicker({ date, onDateChange, placeholder, disabled, className, disabledDates, }: DatePickerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/dialog-wizard.d.ts

@@ -1,11 +1,20 @@
 import * as React from 'react';
 import { type DialogVariant, type DialogSize } from './dialog';
 /**
- * DialogWizard — Dialog com stepper vertical lateral (padrão v2)
+ * DialogWizard — Dialog multi-step com stepper vertical lateral (padrão v2 da lib).
  *
- * Substitui o padrão anterior de StepSelector horizontal no footer.
- * Renderiza uma sidebar à esquerda com círculos numerados sobre fundo primário
- * e área de conteúdo à direita com header, body scrollável e footer com navegação.
+ * Substitui o padrão anterior de `StepSelector` horizontal no footer. Renderiza uma sidebar
+ * azul (`bg-primary`) à esquerda com círculos numerados marcando completude, etapa atual e
+ * etapas inacessíveis; à direita, área de conteúdo com header, body scrollável e footer
+ * com navegação automática (Voltar / Próximo / Salvar).
+ *
+ * **Quando usar:** fluxos com 3+ etapas. Para 1-2 etapas, prefira `Dialog` simples.
+ *
+ * **Validação por etapa:** use `canGoToStep(targetStep)` para bloquear avanço.
+ * Voltar para etapas anteriores é sempre permitido (UX padrão de wizard).
+ *
+ * **Confirmação de descarte:** se `isDirty=true`, fechar o diálogo dispara o
+ * AlertDialog de "alterações não salvas" herdado de `DialogContent` (variant='form').
  *
  * @example
  * ```tsx
@@ -16,6 +25,8 @@ import { type DialogVariant, type DialogSize } from './dialog';
  *   onStepChange={setStep}
  *   steps={['Geral', 'Formulário', 'Configuração']}
  *   title={t('new_document')}
+ *   isDirty={form.formState.isDirty}
+ *   canGoToStep={(s) => s <= 2 ? form.formState.isValid : true}
  *   onSave={handleSave}
  * >
  *   {step === 1 && <StepOneContent />}
@@ -23,6 +34,8 @@ import { type DialogVariant, type DialogSize } from './dialog';
  *   {step === 3 && <StepThreeContent />}
  * </DialogWizard>
  * ```
+ *
+ * @see {@link Dialog} Para diálogos sem etapas.
  */
 export interface DialogWizardProps {
     /** Controla se o dialog está aberto */
@@ -78,5 +91,10 @@ export interface DialogWizardProps {
     /** Conteúdo extra no footer (à esquerda dos botões de navegação) */
     footerLeft?: React.ReactNode;
 }
+/**
+ * Função utilitária `DialogWizard`.
+ * @example
+ * DialogWizard();
+ */
 declare function DialogWizard({ open, onOpenChange, currentStep, onStepChange, steps, canGoToStep, children, title, description, onSave, saveLabel, nextLabel, backLabel, variant, isDirty, size, unsavedChangesTitle, unsavedChangesDescription, cancelText, leaveWithoutSavingText, className, disableNext, hideNavigation, footerLeft, }: DialogWizardProps): import("react/jsx-runtime").JSX.Element;
 export { DialogWizard };

package/dist/components/ui/dialog.d.ts

@@ -1,12 +1,126 @@
 import * as React from "react";
 import * as DialogPrimitive from "@radix-ui/react-dialog";
+/**
+ * Dialog — Modal acessível baseado em Radix UI Dialog (composição padrão da lib).
+ *
+ * Estrutura recomendada (obrigatória para garantir scroll e visibilidade do footer):
+ *
+ * ```tsx
+ * <Dialog open={open} onOpenChange={setOpen}>
+ *   <DialogContent size="md" variant="form" isDirty={form.formState.isDirty}>
+ *     <DialogHeader>
+ *       <DialogTitle>Editar usuário</DialogTitle>
+ *       <DialogDescription>Atualize os dados do usuário.</DialogDescription>
+ *     </DialogHeader>
+ *     <DialogBody>
+ *       {/* conteúdo scrollável *\/}
+ *     </DialogBody>
+ *     <DialogFooter>
+ *       <Button variant="outline" onClick={() => setOpen(false)}>Cancelar</Button>
+ *       <Button onClick={handleSave}>Salvar</Button>
+ *     </DialogFooter>
+ *   </DialogContent>
+ * </Dialog>
+ * ```
+ *
+ * **Variantes do `DialogContent`:**
+ * - `informative` (default): fecha ao clicar fora ou ESC.
+ * - `form`: bloqueia clique fora; com `isDirty=true` exibe alerta "alterações não salvas" ao tentar fechar.
+ * - `destructive`: bloqueia clique fora E ESC, oculta o botão de fechar (ações irreversíveis).
+ *
+ * **Tamanhos pré-definidos:** `sm` (320–480px), `md` (480–720px, default), `lg` (1440px / 85vh).
+ * Use `customWidth/customHeight/...` para casos específicos.
+ *
+ * **Importante:** Sempre embrulhar conteúdo em `<DialogBody>` quando houver `<DialogFooter>` —
+ * caso contrário o footer pode ser empurrado para fora do viewport (em dev, um warning é emitido).
+ *
+ * @see {@link DialogWizard} Para diálogos com múltiplas etapas (3+ passos).
+ * @see https://ui.shadcn.com/docs/components/dialog
+ *
+ * @example
+ * <Dialog />
+ */
 declare const Dialog: React.FC<DialogPrimitive.DialogProps>;
+/**
+ * Elemento que dispara a abertura do Dialog. Use `asChild` para reaproveitar seu próprio botão.
+ *
+ * @example
+ * <DialogTrigger asChild>
+ *   <Button variant="outline">Editar</Button>
+ * </DialogTrigger>
+ */
 declare const DialogTrigger: React.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Portal onde o Dialog é renderizado (geralmente `document.body`).
+ * Você raramente precisa usar diretamente — `DialogContent` já o utiliza internamente.
+ *
+ * @example
+ * <DialogPortal container={containerRef.current}>
+ *   <DialogOverlay />
+ *   <DialogContent>...</DialogContent>
+ * </DialogPortal>
+ */
 declare const DialogPortal: React.FC<DialogPrimitive.DialogPortalProps>;
+/**
+ * Botão programático para fechar o Dialog. Útil em ações dentro do body/footer.
+ * Use `asChild` para envolver seu próprio botão.
+ *
+ * @example
+ * <DialogClose asChild>
+ *   <Button variant="outline">Cancelar</Button>
+ * </DialogClose>
+ */
 declare const DialogClose: React.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Camada semitransparente atrás do Dialog. Renderizada automaticamente pelo `DialogContent` —
+ * use diretamente apenas se estiver compondo um Portal customizado.
+ *
+ * @example
+ * <DialogPortal>
+ *   <DialogOverlay className="bg-black/60" />
+ *   <DialogContent>...</DialogContent>
+ * </DialogPortal>
+ */
 declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Tamanhos pré-definidos do `DialogContent`:
+ * - `sm` — 320–480px, ideal para confirmações curtas.
+ * - `md` — 480–720px (default), formulários comuns.
+ * - `lg` — 1440px / 85vh, conteúdo extenso (wizards, listas).
+ *
+ * Para tamanhos arbitrários, use `customWidth/customHeight` em `DialogContentProps`.
+ *
+ * @example
+ * <DialogContent size="lg">...</DialogContent>
+ */
 type DialogSize = 'sm' | 'md' | 'lg';
+/**
+ * Variante do `DialogContent`, controla comportamento de fechamento:
+ * - `informative` (default) — fecha ao clicar fora ou ESC.
+ * - `form` — bloqueia clique fora; com `isDirty=true` confirma "alterações não salvas".
+ * - `destructive` — bloqueia ESC e clique fora; oculta o `X` (ações irreversíveis).
+ *
+ * @example
+ * <DialogContent variant="form" isDirty={form.formState.isDirty}>...</DialogContent>
+ */
 type DialogVariant = 'informative' | 'form' | 'destructive';
+/**
+ * Props do `DialogContent`.
+ *
+ * @property size — Tamanho pré-definido: `sm`, `md` (default), `lg`. Ignorado se `customWidth/Height` forem usados.
+ * @property variant — `informative` (default) | `form` (confirma `isDirty` ao fechar) | `destructive` (bloqueia ESC).
+ * @property isDirty — Quando `variant='form'` e `isDirty=true`, exibe AlertDialog de confirmação ao tentar fechar.
+ * @property customWidth — Width customizado (ex: `'600px'`, `'40vw'`). Sobrescreve `size`.
+ * @property customMaxHeight — Limite de altura. Útil para conteúdo muito longo dentro de `DialogBody`.
+ *
+ * @example
+ * const props: DialogContentProps = {
+ *   size: 'lg',
+ *   variant: 'form',
+ *   isDirty: form.formState.isDirty,
+ *   customMaxHeight: '80vh',
+ * };
+ */
 interface DialogContentProps extends React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
     size?: DialogSize;
     variant?: DialogVariant;
@@ -26,23 +140,90 @@ interface DialogContentProps extends React.ComponentPropsWithoutRef<typeof Dialo
     /** i18n: Leave without saving button text */
     leaveWithoutSavingText?: string;
 }
+/**
+ * Container principal do Dialog. Aplica tamanho, variante e (quando `variant='form'`)
+ * o fluxo de confirmação de "alterações não salvas". Sempre coloque
+ * `DialogHeader` + `DialogBody` + `DialogFooter` como filhos diretos.
+ *
+ * @example
+ * <DialogContent size="md" variant="form" isDirty={form.formState.isDirty}>
+ *   <DialogHeader>
+ *     <DialogTitle>Editar usuário</DialogTitle>
+ *   </DialogHeader>
+ *   <DialogBody>{/* form fields *\/}</DialogBody>
+ *   <DialogFooter>
+ *     <Button variant="outline" onClick={() => setOpen(false)}>Cancelar</Button>
+ *     <Button onClick={handleSave}>Salvar</Button>
+ *   </DialogFooter>
+ * </DialogContent>
+ */
 declare const DialogContent: React.ForwardRefExoticComponent<DialogContentProps & React.RefAttributes<HTMLDivElement>>;
 interface DialogHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Se `true`, exibe uma linha separadora abaixo do título (default: `false`). */
     showSeparator?: boolean;
 }
+/**
+ * Header do Dialog. Contém `DialogTitle` e opcionalmente `DialogDescription`.
+ * Sempre o primeiro filho dentro de `DialogContent`. Não rola — fica fixo no topo.
+ *
+ * @example
+ * <DialogHeader showSeparator>
+ *   <DialogTitle>Editar usuário</DialogTitle>
+ *   <DialogDescription>Atualize os dados abaixo.</DialogDescription>
+ * </DialogHeader>
+ */
 declare const DialogHeader: {
     ({ className, showSeparator, children, ...props }: DialogHeaderProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Container scrollável do Dialog (área entre header e footer).
+ *
+ * **Obrigatório quando há `DialogFooter`** — sem ele, o footer pode sair do viewport.
+ * Usa `px-2 -mx-2` para não recortar focus rings de inputs próximos à borda.
+ *
+ * @example
+ * <DialogBody>
+ *   <Form {...form}>
+ *     <FormField name="email" render={...} />
+ *   </Form>
+ * </DialogBody>
+ */
 declare const DialogBody: {
     ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Footer do Dialog com separador automático e alinhamento à direita.
+ * Tipicamente contém botões de ação (Cancelar, Salvar). Fica fixo no rodapé.
+ *
+ * @example
+ * <DialogFooter>
+ *   <Button variant="outline" onClick={() => setOpen(false)}>Cancelar</Button>
+ *   <Button onClick={handleSave} disabled={form.formState.isSubmitting}>Salvar</Button>
+ * </DialogFooter>
+ */
 declare const DialogFooter: {
     ({ className, children, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Título do Dialog. Renderizado como `<h2>` com estilo `text-xl font-semibold`.
+ * **Obrigatório por acessibilidade** — Radix usa o título para `aria-labelledby` do dialog.
+ *
+ * @example
+ * <DialogTitle>Excluir usuário</DialogTitle>
+ */
 declare const DialogTitle: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Descrição opcional do Dialog (subtítulo). Exibida em texto muted abaixo do título.
+ * Mapeada para `aria-describedby` automaticamente pelo Radix.
+ *
+ * @example
+ * <DialogDescription>
+ *   Esta ação não pode ser desfeita. O usuário será removido permanentemente.
+ * </DialogDescription>
+ */
 declare const DialogDescription: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 export { Dialog, DialogPortal, DialogOverlay, DialogClose, DialogTrigger, DialogContent, DialogHeader, DialogBody, DialogFooter, DialogTitle, DialogDescription };
 export type { DialogVariant, DialogSize, DialogContentProps };

package/dist/components/ui/drawer.d.ts

@@ -1,22 +1,94 @@
+/**
+ * @module Drawer
+ * Painel slide-up mobile-first baseado em `vaul`. Use para fluxos mobile ou painéis
+ * secundários que devem ocupar a base da viewport.
+ *
+ * Para painéis laterais desktop (sidesheets), prefira `Sheet`.
+ *
+ * @example
+ * ```tsx
+ * <Drawer>
+ *   <DrawerTrigger asChild><Button>Abrir</Button></DrawerTrigger>
+ *   <DrawerContent>
+ *     <DrawerHeader>
+ *       <DrawerTitle>Filtros</DrawerTitle>
+ *       <DrawerDescription>Refine os resultados</DrawerDescription>
+ *     </DrawerHeader>
+ *     {children}
+ *     <DrawerFooter><Button>Aplicar</Button></DrawerFooter>
+ *   </DrawerContent>
+ * </Drawer>
+ * ```
+ */
 import * as React from "react";
 import { Drawer as DrawerPrimitive } from "vaul";
+/**
+ * Componente `Drawer` da lib.
+ * @example
+ * <Drawer />
+ */
 declare const Drawer: {
     ({ shouldScaleBackground, ...props }: React.ComponentProps<typeof DrawerPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Componente `DrawerTrigger` da lib.
+ * @example
+ * <DrawerTrigger />
+ */
 declare const DrawerTrigger: React.ForwardRefExoticComponent<import("@radix-ui/react-dialog").DialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `DrawerPortal` da lib.
+ * @example
+ * <DrawerPortal />
+ */
 declare const DrawerPortal: typeof import("vaul").Portal;
+/**
+ * Componente `DrawerClose` da lib.
+ * @example
+ * <DrawerClose />
+ */
 declare const DrawerClose: React.ForwardRefExoticComponent<import("@radix-ui/react-dialog").DialogCloseProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `DrawerOverlay` da lib.
+ * @example
+ * <DrawerOverlay />
+ */
 declare const DrawerOverlay: React.ForwardRefExoticComponent<Omit<Omit<import("@radix-ui/react-dialog").DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `DrawerContent` da lib.
+ * @example
+ * <DrawerContent />
+ */
 declare const DrawerContent: React.ForwardRefExoticComponent<Omit<Omit<import("@radix-ui/react-dialog").DialogContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `DrawerHeader` da lib.
+ * @example
+ * <DrawerHeader />
+ */
 declare const DrawerHeader: {
     ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Componente `DrawerFooter` da lib.
+ * @example
+ * <DrawerFooter />
+ */
 declare const DrawerFooter: {
     ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Componente `DrawerTitle` da lib.
+ * @example
+ * <DrawerTitle />
+ */
 declare const DrawerTitle: React.ForwardRefExoticComponent<Omit<import("@radix-ui/react-dialog").DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Componente `DrawerDescription` da lib.
+ * @example
+ * <DrawerDescription />
+ */
 declare const DrawerDescription: React.ForwardRefExoticComponent<Omit<import("@radix-ui/react-dialog").DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 export { Drawer, DrawerPortal, DrawerOverlay, DrawerTrigger, DrawerClose, DrawerContent, DrawerHeader, DrawerFooter, DrawerTitle, DrawerDescription, };