forlogic-core 2.2.7 → 2.3.0

package/dist/audit-trail/components/ui/command.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @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;
+};
+export { Command, CommandDialog, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem, CommandSeparator, CommandShortcut, };

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

@@ -0,0 +1,122 @@
+/**
+ * @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;
+};
+export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioItem, ContextMenuLabel, ContextMenuSeparator, ContextMenuShortcut, ContextMenuGroup, ContextMenuPortal, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuRadioGroup, };

package/dist/audit-trail/components/ui/data-list.d.ts

@@ -0,0 +1,86 @@
+import { ReactNode } from "react";
+/**
+ * DataListProps
+ *
+ * Propriedades do container raiz do DataList.
+ */
+interface DataListProps {
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * DataListItemProps
+ *
+ * Propriedades de um item individual do DataList.
+ */
+interface DataListItemProps {
+    children: ReactNode;
+    onClick?: () => void;
+    className?: string;
+}
+/**
+ * DataListFieldProps
+ *
+ * Propriedades de um campo (label/value) do DataList.
+ */
+interface DataListFieldProps {
+    label: string;
+    value: ReactNode;
+    className?: string;
+}
+/**
+ * DataListRoot
+ *
+ * Container raiz para uma lista de dados com espaçamento vertical.
+ */
+declare function DataListRoot({ children, className }: DataListProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * DataListItem
+ *
+ * Item individual da lista, renderizado como um Card.
+ * Suporta clique e estados hover quando onClick é fornecido.
+ */
+declare function DataListItem({ children, onClick, className }: DataListItemProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * DataListField
+ *
+ * Campo individual com label e valor, formatado horizontalmente.
+ */
+declare function DataListField({ label, value, className }: DataListFieldProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * DataList Component
+ *
+ * Sistema de lista de dados com composição de componentes.
+ *
+ * @example
+ * ```tsx
+ * <DataList.Root>
+ *   <DataList.Item onClick={() => console.log('clicked')}>
+ *     <DataList.Field label=t('ap_name') value="João Silva" />
+ *     <DataList.Field label="Email" value="joao@exemplo.com" />
+ *     <DataList.Field label="Status" value={<Badge>Ativo</Badge>} />
+ *   </DataList.Item>
+ *   <DataList.Item>
+ *     <DataList.Field label=t('ap_name') value="Maria Santos" />
+ *     <DataList.Field label="Email" value="maria@exemplo.com" />
+ *   </DataList.Item>
+ * </DataList.Root>
+ * ```
+ *
+ * ## Características
+ * - Composição flexível de componentes
+ * - Suporte a valores customizados (ReactNode)
+ * - Estados hover interativos
+ * - Estilos consistentes com Cards
+ *
+ * ## Componentes
+ * - `DataList.Root`: Container principal
+ * - `DataList.Item`: Item individual (Card)
+ * - `DataList.Field`: Par label/value
+ */
+export declare const DataList: {
+    Root: typeof DataListRoot;
+    Item: typeof DataListItem;
+    Field: typeof DataListField;
+};
+export {};

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

@@ -0,0 +1,19 @@
+/**
+ * Tipo `DatePickerProps` exportado pela lib.
+ * @example
+ * const value: DatePickerProps = {} as DatePickerProps;
+ */
+export interface DatePickerProps {
+    date?: Date;
+    onDateChange?: (date: Date | undefined) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    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/audit-trail/components/ui/dialog-wizard.d.ts

@@ -0,0 +1,100 @@
+import * as React from 'react';
+import { type DialogVariant, type DialogSize } from './dialog';
+/**
+ * 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
+ * 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
+ * <DialogWizard
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   currentStep={step}
+ *   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 />}
+ *   {step === 2 && <StepTwoContent />}
+ *   {step === 3 && <StepThreeContent />}
+ * </DialogWizard>
+ * ```
+ *
+ * @see {@link Dialog} Para diálogos sem etapas.
+ */
+export interface DialogWizardProps {
+    /** Controla se o dialog está aberto */
+    open: boolean;
+    /** Callback de abertura/fechamento */
+    onOpenChange: (open: boolean) => void;
+    /** Etapa atual (1-indexed) */
+    currentStep: number;
+    /** Callback chamado quando uma etapa é selecionada */
+    onStepChange: (step: number) => void;
+    /** Labels das etapas */
+    steps: string[];
+    /**
+     * Função que valida se pode navegar para uma etapa específica.
+     * Voltar para etapas anteriores é sempre permitido.
+     * Se não fornecida, todas as etapas são acessíveis.
+     */
+    canGoToStep?: (targetStep: number) => boolean;
+    /** Conteúdo do step atual */
+    children: React.ReactNode;
+    /** Título exibido no header da área de conteúdo */
+    title: string;
+    /** Subtítulo opcional abaixo do título */
+    description?: string;
+    /** Callback do botão "Salvar" no último step */
+    onSave?: () => void;
+    /** Label do botão salvar (default: "Salvar") */
+    saveLabel?: string;
+    /** Label do botão próximo (default: "Próximo") */
+    nextLabel?: string;
+    /** Label do botão voltar (default: "Voltar") */
+    backLabel?: string;
+    /** Variante do DialogContent */
+    variant?: DialogVariant;
+    /** Indica se há alterações não salvas */
+    isDirty?: boolean;
+    /** Tamanho do DialogContent */
+    size?: DialogSize;
+    /** i18n: Title for unsaved changes alert */
+    unsavedChangesTitle?: string;
+    /** i18n: Description for unsaved changes alert */
+    unsavedChangesDescription?: string;
+    /** i18n: Cancel button text */
+    cancelText?: string;
+    /** i18n: Leave without saving button text */
+    leaveWithoutSavingText?: string;
+    /** Classes CSS adicionais no container externo */
+    className?: string;
+    /** Desabilitar botão próximo/salvar (ex: validação do step) */
+    disableNext?: boolean;
+    /** Ocultar botões de navegação do footer (para controle manual) */
+    hideNavigation?: boolean;
+    /** 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/audit-trail/components/ui/dialog.d.ts

@@ -0,0 +1,229 @@
+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;
+    isDirty?: boolean;
+    customWidth?: string;
+    customMinWidth?: string;
+    customMaxWidth?: string;
+    customHeight?: string;
+    customMinHeight?: string;
+    customMaxHeight?: string;
+    /** i18n: Title for unsaved changes alert (default: t('unsaved_changes')) */
+    unsavedChangesTitle?: string;
+    /** i18n: Description for unsaved changes alert */
+    unsavedChangesDescription?: string;
+    /** i18n: Cancel button text */
+    cancelText?: string;
+    /** 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/audit-trail/components/ui/disabled-menu-item.d.ts

@@ -0,0 +1,25 @@
+import * as React from "react";
+interface DisabledMenuItemProps {
+    children: React.ReactNode;
+    disabledReason?: string;
+    className?: string;
+}
+/**
+ * DisabledMenuItem - Item de menu desabilitado com tooltip explicativo
+ *
+ * Renderiza um item visualmente desabilitado que:
+ * - Mantém cursor not-allowed
+ * - Exibe tooltip com motivo do bloqueio no hover
+ * - Previne cliques e interações
+ * - Não dispara toasts ou callbacks
+ *
+ * @example
+ * ```tsx
+ * <DisabledMenuItem disabledReason=t('select_at_least_one_item')>
+ *   <Download className="mr-2 h-4 w-4" />
+ *   Exportar Selecionados
+ * </DisabledMenuItem>
+ * ```
+ */
+export declare const DisabledMenuItem: React.ForwardRefExoticComponent<DisabledMenuItemProps & React.RefAttributes<HTMLDivElement>>;
+export {};