forlogic-core 2.1.4 → 2.2.0

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

@@ -1,12 +1,57 @@
 import * as React from "react";
 import * as NavigationMenuPrimitive from "@radix-ui/react-navigation-menu";
+/**
+ * Componente `NavigationMenu` da lib.
+ * @example
+ * <NavigationMenu />
+ */
 declare const NavigationMenu: React.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuProps & React.RefAttributes<HTMLElement>, "ref"> & React.RefAttributes<HTMLElement>>;
+/**
+ * Componente `NavigationMenuList` da lib.
+ * @example
+ * <NavigationMenuList />
+ */
 declare const NavigationMenuList: React.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuListProps & React.RefAttributes<HTMLUListElement>, "ref"> & React.RefAttributes<HTMLUListElement>>;
+/**
+ * Componente `NavigationMenuItem` da lib.
+ * @example
+ * <NavigationMenuItem />
+ */
 declare const NavigationMenuItem: React.ForwardRefExoticComponent<NavigationMenuPrimitive.NavigationMenuItemProps & React.RefAttributes<HTMLLIElement>>;
+/**
+ * `navigationMenuTriggerStyle` exportado pela lib.
+ * @example
+ * navigationMenuTriggerStyle;
+ */
 declare const navigationMenuTriggerStyle: (props?: import("class-variance-authority/types").ClassProp) => string;
+/**
+ * Componente `NavigationMenuTrigger` da lib.
+ * @example
+ * <NavigationMenuTrigger />
+ */
 declare const NavigationMenuTrigger: React.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `NavigationMenuContent` da lib.
+ * @example
+ * <NavigationMenuContent />
+ */
 declare const NavigationMenuContent: React.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `NavigationMenuLink` da lib.
+ * @example
+ * <NavigationMenuLink />
+ */
 declare const NavigationMenuLink: React.ForwardRefExoticComponent<NavigationMenuPrimitive.NavigationMenuLinkProps & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * Componente `NavigationMenuViewport` da lib.
+ * @example
+ * <NavigationMenuViewport />
+ */
 declare const NavigationMenuViewport: React.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuViewportProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `NavigationMenuIndicator` da lib.
+ * @example
+ * <NavigationMenuIndicator />
+ */
 declare const NavigationMenuIndicator: React.ForwardRefExoticComponent<Omit<NavigationMenuPrimitive.NavigationMenuIndicatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { navigationMenuTriggerStyle, NavigationMenu, NavigationMenuList, NavigationMenuItem, NavigationMenuContent, NavigationMenuTrigger, NavigationMenuLink, NavigationMenuIndicator, NavigationMenuViewport, };

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

@@ -1,4 +1,9 @@
 import * as React from "react";
+/**
+ * Tipo `OnboardingStep` exportado pela lib.
+ * @example
+ * const value: OnboardingStep = {} as OnboardingStep;
+ */
 export interface OnboardingStep {
     /** Identificador único do step */
     id: string;
@@ -9,6 +14,11 @@ export interface OnboardingStep {
     /** Descrição do step */
     description: string;
 }
+/**
+ * Tipo `OnboardingDialogProps` exportado pela lib.
+ * @example
+ * const value: OnboardingDialogProps = {} as OnboardingDialogProps;
+ */
 export interface OnboardingDialogProps {
     /** Controla se o dialog está aberto */
     open: boolean;
@@ -39,5 +49,10 @@ export interface OnboardingDialogProps {
     /** Classes adicionais para o container */
     className?: string;
 }
+/**
+ * Componente `OnboardingDialog` da lib.
+ * @example
+ * <OnboardingDialog />
+ */
 declare const OnboardingDialog: React.ForwardRefExoticComponent<OnboardingDialogProps & React.RefAttributes<HTMLDivElement>>;
 export { OnboardingDialog };

package/dist/components/ui/online-editor-dialog.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Tipo `OnlineEditorDialogProps` exportado pela lib.
+ * @example
+ * const value: OnlineEditorDialogProps = {} as OnlineEditorDialogProps;
+ */
 export interface OnlineEditorDialogProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -14,5 +19,10 @@ export interface OnlineEditorDialogProps {
     /** Custom className */
     className?: string;
 }
+/**
+ * Função utilitária `OnlineEditorDialog`.
+ * @example
+ * OnlineEditorDialog();
+ */
 export declare function OnlineEditorDialog({ open, onOpenChange, identifier, fileName, mode, type, onClose, className, }: OnlineEditorDialogProps): import("react/jsx-runtime").JSX.Element;
 export default OnlineEditorDialog;

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

@@ -1,26 +1,79 @@
+/**
+ * @module Pagination
+ * Componentes primitivos de paginação (Previous/Next/Link/Ellipsis).
+ *
+ * **Para uso com CRUD, prefira `CrudPagination` (alias `DataPagination`)** — já integra
+ * com o manager (estado, total, pageSize) e padroniza visual da Forlogic Core.
+ *
+ * @example
+ * ```tsx
+ * <Pagination>
+ *   <PaginationContent>
+ *     <PaginationItem><PaginationPrevious href="#" /></PaginationItem>
+ *     <PaginationItem><PaginationLink href="#" isActive>1</PaginationLink></PaginationItem>
+ *     <PaginationItem><PaginationNext href="#" /></PaginationItem>
+ *   </PaginationContent>
+ * </Pagination>
+ * ```
+ */
 import * as React from "react";
 import { ButtonProps } from "./button";
+/**
+ * Componente `Pagination` da lib.
+ * @example
+ * <Pagination />
+ */
 declare const Pagination: {
     ({ className, ...props }: React.ComponentProps<"nav">): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Componente `PaginationContent` da lib.
+ * @example
+ * <PaginationContent />
+ */
 declare const PaginationContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React.RefAttributes<HTMLUListElement>>;
+/**
+ * Componente `PaginationItem` da lib.
+ * @example
+ * <PaginationItem />
+ */
 declare const PaginationItem: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
 type PaginationLinkProps = {
     isActive?: boolean;
 } & Pick<ButtonProps, "size"> & React.ComponentProps<"a">;
+/**
+ * Componente `PaginationLink` da lib.
+ * @example
+ * <PaginationLink />
+ */
 declare const PaginationLink: {
     ({ className, isActive, size, ...props }: PaginationLinkProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Componente `PaginationPrevious` da lib.
+ * @example
+ * <PaginationPrevious />
+ */
 declare const PaginationPrevious: {
     ({ className, ...props }: React.ComponentProps<typeof PaginationLink>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Componente `PaginationNext` da lib.
+ * @example
+ * <PaginationNext />
+ */
 declare const PaginationNext: {
     ({ className, ...props }: React.ComponentProps<typeof PaginationLink>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Componente `PaginationEllipsis` da lib.
+ * @example
+ * <PaginationEllipsis />
+ */
 declare const PaginationEllipsis: {
     ({ className, ...props }: React.ComponentProps<"span">): import("react/jsx-runtime").JSX.Element;
     displayName: string;

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

@@ -34,6 +34,11 @@ import * as PopoverPrimitive from "@radix-ui/react-popover";
  * @see https://www.radix-ui.com/docs/primitives/components/popover
  */
 declare const Popover: React.FC<PopoverPrimitive.PopoverProps>;
+/**
+ * Componente `PopoverTrigger` da lib.
+ * @example
+ * <PopoverTrigger />
+ */
 declare const PopoverTrigger: React.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & React.RefAttributes<HTMLButtonElement>>;
 /**
  * PopoverContent
@@ -42,6 +47,9 @@ declare const PopoverTrigger: React.ForwardRefExoticComponent<PopoverPrimitive.P
  *
  * @param align - Alinhamento horizontal (start, center, end)
  * @param sideOffset - Distância do trigger em pixels
+ *
+ * @example
+ * <PopoverContent />
  */
 declare const PopoverContent: React.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     container?: HTMLElement | null;

package/dist/components/ui/radio-group.d.ts

@@ -58,6 +58,9 @@ declare const RadioGroup: React.ForwardRefExoticComponent<Omit<RadioGroupPrimiti
  * RadioGroupItem
  *
  * Item individual do grupo de rádio com indicador visual.
+ *
+ * @example
+ * <RadioGroupItem />
  */
 declare const RadioGroupItem: React.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupItemProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 export { RadioGroup, RadioGroupItem };

package/dist/components/ui/report-request-list.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Enum `ReportRequestStatus` exportado pela lib.
+ * @example
+ * const v = ReportRequestStatus;
+ */
 export declare enum ReportRequestStatus {
     WaitingProcessing = 1,
     Processing = 2,
@@ -5,6 +10,11 @@ export declare enum ReportRequestStatus {
     Error = 4,
     Expired = 5
 }
+/**
+ * Tipo `ReportRequest` exportado pela lib.
+ * @example
+ * const value: ReportRequest = {} as ReportRequest;
+ */
 export interface ReportRequest {
     id: string;
     reportName: string;
@@ -13,6 +23,11 @@ export interface ReportRequest {
     expirationDate: string | Date;
     lastUpdate: string | Date;
 }
+/**
+ * Tipo `ReportRequestListProps` exportado pela lib.
+ * @example
+ * const value: ReportRequestListProps = {} as ReportRequestListProps;
+ */
 export interface ReportRequestListProps {
     /** Report requests data */
     requests: ReportRequest[];
@@ -41,4 +56,9 @@ export interface ReportRequestListProps {
     /** Additional className */
     className?: string;
 }
+/**
+ * Função utilitária `ReportRequestList`.
+ * @example
+ * ReportRequestList();
+ */
 export declare function ReportRequestList({ requests, isLoading, onGetReportUrl, formatDate, labels: customLabels, className, }: ReportRequestListProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,15 @@
 import * as ResizablePrimitive from "react-resizable-panels";
+/**
+ * Componente `ResizablePanelGroup` da lib.
+ * @example
+ * <ResizablePanelGroup />
+ */
 declare const ResizablePanelGroup: ({ className, ...props }: React.ComponentProps<typeof ResizablePrimitive.PanelGroup>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Componente `ResizablePanel` da lib.
+ * @example
+ * <ResizablePanel />
+ */
 declare const ResizablePanel: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLAttributes<HTMLLinkElement | HTMLElement | HTMLHeadElement | HTMLButtonElement | HTMLInputElement | HTMLDivElement | HTMLLabelElement | HTMLObjectElement | HTMLAnchorElement | HTMLAreaElement | HTMLAudioElement | HTMLBaseElement | HTMLQuoteElement | HTMLBodyElement | HTMLBRElement | HTMLCanvasElement | HTMLTableColElement | HTMLDataElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHRElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLegendElement | HTMLLIElement | HTMLMapElement | HTMLMetaElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLOutputElement | HTMLParagraphElement | HTMLPreElement | HTMLProgressElement | HTMLScriptElement | HTMLSelectElement | HTMLSlotElement | HTMLSourceElement | HTMLSpanElement | HTMLStyleElement | HTMLTableElement | HTMLTableSectionElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTimeElement | HTMLTitleElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement | HTMLTableCaptionElement | HTMLMenuElement | HTMLPictureElement>, "id" | "onResize"> & {
     className?: string;
     collapsedSize?: number | undefined;
@@ -17,6 +27,11 @@ declare const ResizablePanel: import("react").ForwardRefExoticComponent<Omit<imp
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<ResizablePrimitive.ImperativePanelHandle>>;
+/**
+ * Componente `ResizableHandle` da lib.
+ * @example
+ * <ResizableHandle />
+ */
 declare const ResizableHandle: ({ withHandle, className, ...props }: React.ComponentProps<typeof ResizablePrimitive.PanelResizeHandle> & {
     withHandle?: boolean;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/rich-text-editor.d.ts

@@ -1,4 +1,17 @@
 import * as React from 'react';
+/**
+ * Props do `RichTextEditor`. Controla o conteúdo HTML, modos de edição
+ * (visual/código/preview), placeholder, altura mínima e dicas de variáveis.
+ *
+ * @example
+ * const props: RichTextEditorProps = {
+ *   value: '<p>Olá <strong>mundo</strong></p>',
+ *   onChange: setContent,
+ *   placeholder: 'Escreva o e-mail...',
+ *   minHeight: '240px',
+ *   showVariableHint: true, // dica para usar {{variavel}}
+ * };
+ */
 export interface RichTextEditorProps {
     /** Current HTML value */
     value: string;

package/dist/components/ui/scroll-area.d.ts

@@ -32,6 +32,9 @@ declare const ScrollArea: React.ForwardRefExoticComponent<Omit<ScrollAreaPrimiti
  *
  * Scrollbar customizada com orientação vertical ou horizontal.
  * Geralmente usada internamente pelo ScrollArea.
+ *
+ * @example
+ * <ScrollBar />
  */
 declare const ScrollBar: React.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaScrollbarProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { ScrollArea, ScrollBar };

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

@@ -1,16 +1,87 @@
+/**
+ * @module Select
+ * Seletor de valor único (combo). Para busca, multi-seleção ou seleção de entidade,
+ * prefira `Combobox` (aliases: `SelectSearch`, `MultiSelect`, `EntitySelect`, `AutoComplete`).
+ *
+ * API composta: `Select` (raiz) + `SelectTrigger` + `SelectValue` + `SelectContent` + `SelectItem`.
+ * Use controlado (`value` + `onValueChange`) ou não controlado (`defaultValue`).
+ *
+ * @example Controlado
+ * ```tsx
+ * <Select value={state} onValueChange={setState}>
+ *   <SelectTrigger><SelectValue placeholder="Selecione..." /></SelectTrigger>
+ *   <SelectContent>
+ *     <SelectItem value="ok">OK</SelectItem>
+ *     <SelectItem value="ko">Não OK</SelectItem>
+ *   </SelectContent>
+ * </Select>
+ * ```
+ *
+ * @see `docs/design-system/selectors.md`
+ */
 import * as React from "react";
 import * as SelectPrimitive from "@radix-ui/react-select";
+/**
+ * Componente `Select` da lib.
+ * @example
+ * <Select />
+ */
 declare const Select: React.FC<SelectPrimitive.SelectProps>;
+/**
+ * Componente `SelectGroup` da lib.
+ * @example
+ * <SelectGroup />
+ */
 declare const SelectGroup: React.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `SelectValue` da lib.
+ * @example
+ * <SelectValue />
+ */
 declare const SelectValue: React.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>>;
+/**
+ * Componente `SelectTrigger` da lib.
+ * @example
+ * <SelectTrigger />
+ */
 declare const SelectTrigger: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `SelectScrollUpButton` da lib.
+ * @example
+ * <SelectScrollUpButton />
+ */
 declare const SelectScrollUpButton: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `SelectScrollDownButton` da lib.
+ * @example
+ * <SelectScrollDownButton />
+ */
 declare const SelectScrollDownButton: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `SelectContent` da lib.
+ * @example
+ * <SelectContent />
+ */
 declare const SelectContent: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     container?: HTMLElement;
     collisionBoundary?: HTMLElement;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `SelectLabel` da lib.
+ * @example
+ * <SelectLabel />
+ */
 declare const SelectLabel: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `SelectItem` da lib.
+ * @example
+ * <SelectItem />
+ */
 declare const SelectItem: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `SelectSeparator` da lib.
+ * @example
+ * <SelectSeparator />
+ */
 declare const SelectSeparator: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { Select, SelectGroup, SelectValue, SelectTrigger, SelectContent, SelectLabel, SelectItem, SelectSeparator, SelectScrollUpButton, SelectScrollDownButton, };

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

@@ -1,4 +1,17 @@
 import * as React from "react";
 import * as SeparatorPrimitive from "@radix-ui/react-separator";
+/**
+ * Linha divisória horizontal (default) ou vertical.
+ *
+ * @param orientation `"horizontal"` (default) | `"vertical"`. Vertical exige altura definida no pai.
+ * @param decorative Quando `true` (default), recebe `aria-hidden`. Defina `false` apenas se a separação
+ *   tiver significado semântico para leitores de tela.
+ *
+ * @example
+ * ```tsx
+ * <Separator />
+ * <Separator orientation="vertical" className="h-6" />
+ * ```
+ */
 declare const Separator: React.ForwardRefExoticComponent<Omit<SeparatorPrimitive.SeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { Separator };

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

@@ -1,32 +1,108 @@
 import * as SheetPrimitive from "@radix-ui/react-dialog";
 import { type VariantProps } from "class-variance-authority";
 import * as React from "react";
+/**
+ * Componente `Sheet` da lib.
+ * @example
+ * <Sheet />
+ */
 declare const Sheet: React.FC<SheetPrimitive.DialogProps>;
+/**
+ * Componente `SheetTrigger` da lib.
+ * @example
+ * <SheetTrigger />
+ */
 declare const SheetTrigger: React.ForwardRefExoticComponent<SheetPrimitive.DialogTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `SheetClose` da lib.
+ * @example
+ * <SheetClose />
+ */
 declare const SheetClose: React.ForwardRefExoticComponent<SheetPrimitive.DialogCloseProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `SheetPortal` da lib.
+ * @example
+ * <SheetPortal />
+ */
 declare const SheetPortal: React.FC<SheetPrimitive.DialogPortalProps>;
+/**
+ * Componente `SheetOverlay` da lib.
+ * @example
+ * <SheetOverlay />
+ */
 declare const SheetOverlay: React.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const sheetVariants: (props?: {
     side?: "left" | "right" | "bottom" | "top";
 } & import("class-variance-authority/types").ClassProp) => string;
 interface SheetContentProps extends React.ComponentPropsWithoutRef<typeof SheetPrimitive.Content>, VariantProps<typeof sheetVariants> {
 }
+/**
+ * Container principal do Sheet. Define o lado de origem da animação via prop `side`
+ * (`right` default, `left`, `top`, `bottom`). Já inclui Portal + Overlay + botão `X`.
+ *
+ * @example
+ * <SheetContent side="right" className="sm:max-w-md">
+ *   <SheetHeader><SheetTitle>Detalhes</SheetTitle></SheetHeader>
+ *   <SheetBody>...</SheetBody>
+ * </SheetContent>
+ */
 declare const SheetContent: React.ForwardRefExoticComponent<SheetContentProps & React.RefAttributes<HTMLDivElement>>;
 interface SheetHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
     showSeparator?: boolean;
 }
+/**
+ * Header fixo do Sheet (não rola). Contém `SheetTitle` e opcionalmente `SheetDescription`.
+ * Use `showSeparator` para adicionar um divisor visual antes do `SheetBody`.
+ *
+ * @example
+ * <SheetHeader showSeparator>
+ *   <SheetTitle>Filtros</SheetTitle>
+ *   <SheetDescription>Refine sua busca.</SheetDescription>
+ * </SheetHeader>
+ */
 declare const SheetHeader: {
     ({ className, showSeparator, children, ...props }: SheetHeaderProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Container scrollável do Sheet (área entre header e footer).
+ * **Obrigatório quando há `SheetFooter`** — sem ele o footer pode sair do viewport.
+ *
+ * @example
+ * <SheetBody>
+ *   {items.map(it => <Card key={it.id}>{it.name}</Card>)}
+ * </SheetBody>
+ */
 declare const SheetBody: {
     ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Footer fixo do Sheet com separador automático e alinhamento à direita.
+ *
+ * @example
+ * <SheetFooter>
+ *   <Button variant="outline" onClick={() => setOpen(false)}>Cancelar</Button>
+ *   <Button onClick={save}>Salvar</Button>
+ * </SheetFooter>
+ */
 declare const SheetFooter: {
     ({ className, children, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Título do Sheet. **Obrigatório por acessibilidade** (`aria-labelledby`).
+ * Use `className="sr-only"` se precisar ocultar visualmente.
+ *
+ * @example
+ * <SheetTitle>Editar perfil</SheetTitle>
+ */
 declare const SheetTitle: React.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Descrição opcional do Sheet (subtítulo). Mapeada para `aria-describedby`.
+ *
+ * @example
+ * <SheetDescription>Altere as configurações da sua conta.</SheetDescription>
+ */
 declare const SheetDescription: React.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 export { Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger };