forlogic-core 2.1.4 → 2.2.0

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

@@ -1,25 +1,178 @@
+/**
+ * @module DropdownMenu
+ * Menu suspenso disparado por um elemento gatilho. API composta:
+ * `DropdownMenu` (raiz) + `DropdownMenuTrigger` (use `asChild` para reaproveitar seu próprio botão)
+ * + `DropdownMenuContent` (com `DropdownMenuItem`, `DropdownMenuSeparator`, `DropdownMenuLabel`,
+ * `DropdownMenuCheckboxItem`, `DropdownMenuRadioItem`, `DropdownMenuSub`).
+ *
+ * Para ações de linha em tabelas (3 pontinhos), prefira `ActionButton` da lib (aliases:
+ * `ActionMenu`, `RowActions`) — não use `DropdownMenu` diretamente.
+ *
+ * @example
+ * ```tsx
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger asChild><Button variant="outline">Mais</Button></DropdownMenuTrigger>
+ *   <DropdownMenuContent align="end">
+ *     <DropdownMenuLabel>Ações</DropdownMenuLabel>
+ *     <DropdownMenuItem onClick={onEdit}>Editar</DropdownMenuItem>
+ *     <DropdownMenuSeparator />
+ *     <DropdownMenuItem onClick={onDelete}>Excluir</DropdownMenuItem>
+ *   </DropdownMenuContent>
+ * </DropdownMenu>
+ * ```
+ *
+ * @see `docs/design-system/buttons-actions.md`
+ */
 import * as React from "react";
 import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+/**
+ * Raiz do DropdownMenu. Controla o estado open/closed (use `open`/`onOpenChange` para
+ * controle externo). Para ações de linha em tabelas, prefira `ActionButton`/`ActionMenu`.
+ *
+ * @example
+ * <DropdownMenu>
+ *   <DropdownMenuTrigger asChild><Button>Ações</Button></DropdownMenuTrigger>
+ *   <DropdownMenuContent align="end">...</DropdownMenuContent>
+ * </DropdownMenu>
+ */
 declare const DropdownMenu: React.FC<DropdownMenuPrimitive.DropdownMenuProps>;
+/**
+ * Elemento que abre o menu. Use `asChild` para envolver seu próprio botão/ícone.
+ *
+ * @example
+ * <DropdownMenuTrigger asChild>
+ *   <Button variant="ghost" size="icon"><MoreHorizontal /></Button>
+ * </DropdownMenuTrigger>
+ */
 declare const DropdownMenuTrigger: React.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Agrupamento semântico de itens (`role="group"`). Use para separar conjuntos
+ * relacionados sem necessariamente exibir um separator visual.
+ *
+ * @example
+ * <DropdownMenuGroup>
+ *   <DropdownMenuItem>Editar</DropdownMenuItem>
+ *   <DropdownMenuItem>Duplicar</DropdownMenuItem>
+ * </DropdownMenuGroup>
+ */
 declare const DropdownMenuGroup: React.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuGroupProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Portal do menu. Já é usado internamente por `DropdownMenuContent` —
+ * sobrescreva apenas para renderizar em um container customizado.
+ *
+ * @example
+ * <DropdownMenuPortal container={portalRef.current}>...</DropdownMenuPortal>
+ */
 declare const DropdownMenuPortal: React.FC<DropdownMenuPrimitive.DropdownMenuPortalProps>;
+/**
+ * Container de submenu. Combine com `DropdownMenuSubTrigger` + `DropdownMenuSubContent`.
+ *
+ * @example
+ * <DropdownMenuSub>
+ *   <DropdownMenuSubTrigger>Compartilhar</DropdownMenuSubTrigger>
+ *   <DropdownMenuSubContent>
+ *     <DropdownMenuItem>Por e-mail</DropdownMenuItem>
+ *     <DropdownMenuItem>Copiar link</DropdownMenuItem>
+ *   </DropdownMenuSubContent>
+ * </DropdownMenuSub>
+ */
 declare const DropdownMenuSub: React.FC<DropdownMenuPrimitive.DropdownMenuSubProps>;
+/**
+ * Wrapper para `DropdownMenuRadioItem`s — controla o item selecionado via `value`/`onValueChange`.
+ *
+ * @example
+ * <DropdownMenuRadioGroup value={view} onValueChange={setView}>
+ *   <DropdownMenuRadioItem value="grid">Grade</DropdownMenuRadioItem>
+ *   <DropdownMenuRadioItem value="list">Lista</DropdownMenuRadioItem>
+ * </DropdownMenuRadioGroup>
+ */
 declare const DropdownMenuRadioGroup: React.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Disparador de um submenu (linha clicável dentro do `DropdownMenuContent` que
+ * abre `DropdownMenuSubContent` à direita). Use `inset` para alinhar com itens
+ * que possuem ícone/check à esquerda.
+ *
+ * @example
+ * <DropdownMenuSubTrigger>Mais opções</DropdownMenuSubTrigger>
+ */
 declare const DropdownMenuSubTrigger: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSubTriggerProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Painel do submenu (renderizado ao lado do `DropdownMenuSubTrigger`).
+ *
+ * @example
+ * <DropdownMenuSubContent>
+ *   <DropdownMenuItem>Item do submenu</DropdownMenuItem>
+ * </DropdownMenuSubContent>
+ */
 declare const DropdownMenuSubContent: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSubContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Container do menu. Use `align` (`start` | `center` | `end`) e `sideOffset`
+ * para posicionamento. Por padrão alinha-se ao trigger com 4px de offset.
+ *
+ * @example
+ * <DropdownMenuContent align="end" sideOffset={8}>
+ *   <DropdownMenuLabel>Ações</DropdownMenuLabel>
+ *   <DropdownMenuItem onClick={onEdit}>Editar</DropdownMenuItem>
+ * </DropdownMenuContent>
+ */
 declare const DropdownMenuContent: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Item clicável do menu. Use `inset` para alinhar com itens que tenham
+ * checkbox/radio. Para destaque destrutivo, aplique `className="text-danger"`.
+ *
+ * @example
+ * <DropdownMenuItem onClick={handleDelete} className="text-danger">
+ *   <Trash className="mr-2 h-4 w-4" /> Excluir
+ * </DropdownMenuItem>
+ */
 declare const DropdownMenuItem: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Item de menu com checkbox (estado ligado/desligado). Controle via `checked`/`onCheckedChange`.
+ *
+ * @example
+ * <DropdownMenuCheckboxItem checked={showTotals} onCheckedChange={setShowTotals}>
+ *   Mostrar totais
+ * </DropdownMenuCheckboxItem>
+ */
 declare const DropdownMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuCheckboxItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Item de seleção exclusiva (radio). Sempre dentro de `DropdownMenuRadioGroup`.
+ *
+ * @example
+ * <DropdownMenuRadioItem value="grid">Grade</DropdownMenuRadioItem>
+ */
 declare const DropdownMenuRadioItem: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuRadioItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Cabeçalho/título de uma seção do menu (não clicável). Use `inset` para alinhar
+ * com itens que tenham ícone à esquerda.
+ *
+ * @example
+ * <DropdownMenuLabel>Minha conta</DropdownMenuLabel>
+ */
 declare const DropdownMenuLabel: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Linha divisória entre grupos de itens.
+ *
+ * @example
+ * <DropdownMenuItem>Editar</DropdownMenuItem>
+ * <DropdownMenuSeparator />
+ * <DropdownMenuItem>Excluir</DropdownMenuItem>
+ */
 declare const DropdownMenuSeparator: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Atalho de teclado exibido à direita de um `DropdownMenuItem` (puramente visual).
+ *
+ * @example
+ * <DropdownMenuItem>
+ *   Salvar <DropdownMenuShortcut>⌘S</DropdownMenuShortcut>
+ * </DropdownMenuItem>
+ */
 declare const DropdownMenuShortcut: {
     ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;

package/dist/components/ui/electronic-signature-dialog.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Tipo `ElectronicSignatureDialogProps` exportado pela lib.
+ * @example
+ * const value: ElectronicSignatureDialogProps = {} as ElectronicSignatureDialogProps;
+ */
 export interface ElectronicSignatureDialogProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -18,4 +23,9 @@ export interface ElectronicSignatureDialogProps {
     resendLabel?: string;
     errorMessage?: string;
 }
+/**
+ * Função utilitária `ElectronicSignatureDialog`.
+ * @example
+ * ElectronicSignatureDialog();
+ */
 export declare function ElectronicSignatureDialog({ open, onOpenChange, onConfirm, onGenerateCode, mode, email, maxLength, title, description, confirmLabel, cancelLabel, resendLabel, errorMessage, }: ElectronicSignatureDialogProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,4 +1,9 @@
 import * as React from 'react';
+/**
+ * Enum `ExportFormat` exportado pela lib.
+ * @example
+ * const v = ExportFormat;
+ */
 export declare enum ExportFormat {
     CSV = "csv",
     PDF = "pdf",
@@ -7,11 +12,21 @@ export declare enum ExportFormat {
     JPEG = "jpeg",
     SVG = "svg"
 }
+/**
+ * Tipo `ExportDialogOption` exportado pela lib.
+ * @example
+ * const value: ExportDialogOption = {} as ExportDialogOption;
+ */
 export interface ExportDialogOption {
     value: string;
     label: string;
     icon?: React.ReactNode;
 }
+/**
+ * Tipo `ExportDialogProps` exportado pela lib.
+ * @example
+ * const value: ExportDialogProps = {} as ExportDialogProps;
+ */
 export interface ExportDialogProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -25,4 +40,9 @@ export interface ExportDialogProps {
     cancelLabel?: string;
     exportLabel?: string;
 }
+/**
+ * Função utilitária `ExportDialog`.
+ * @example
+ * ExportDialog();
+ */
 export declare function ExportDialog({ open, onOpenChange, onExport, mode, options, title, description, cancelLabel, exportLabel, }: ExportDialogProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,8 +1,62 @@
 import * as React from "react";
 import * as LabelPrimitive from "@radix-ui/react-label";
 import { ControllerProps, FieldPath, FieldValues } from "react-hook-form";
+/**
+ * Provider raiz do formulário (alias de `FormProvider` do `react-hook-form`).
+ * Sempre passe o objeto retornado por `useForm()` via spread (`{...form}`).
+ *
+ * @example
+ * const form = useForm<Inputs>({ defaultValues: { email: '' } });
+ *
+ * <Form {...form}>
+ *   <form onSubmit={form.handleSubmit(onSubmit)}>
+ *     <FormField name="email" control={form.control} render={...} />
+ *   </form>
+ * </Form>
+ */
 declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>(props: import("react-hook-form").FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+/**
+ * Conecta um campo do `react-hook-form` ao sistema de Form da lib.
+ * Forneça `control` (de `useForm()`) e `name`. Os IDs e o estado de erro fluem automaticamente
+ * para `FormLabel`, `FormControl`, `FormDescription` e `FormMessage`.
+ *
+ * @example
+ * ```tsx
+ * const form = useForm<Inputs>();
+ *
+ * <Form {...form}>
+ *   <form onSubmit={form.handleSubmit(onSubmit)}>
+ *     <FormField
+ *       control={form.control}
+ *       name="email"
+ *       render={({ field }) => (
+ *         <FormItem>
+ *           <FormLabel>Email</FormLabel>
+ *           <FormControl><Input {...field} /></FormControl>
+ *           <FormMessage />
+ *         </FormItem>
+ *       )}
+ *     />
+ *   </form>
+ * </Form>
+ * ```
+ *
+ * @see `docs/design-system/inputs.md`
+ */
 declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook interno usado pelos subcomponentes (`FormLabel`, `FormControl`,
+ * `FormDescription`, `FormMessage`) para acessar IDs e estado de erro do campo
+ * envolvente. Deve ser chamado **dentro** de um `FormField` + `FormItem`.
+ *
+ * Útil quando você cria um wrapper customizado e precisa do estado:
+ *
+ * @example
+ * function CustomError() {
+ *   const { error, formMessageId } = useFormField();
+ *   return error ? <span id={formMessageId} className="text-danger">{String(error.message)}</span> : null;
+ * }
+ */
 declare const useFormField: () => {
     invalid: boolean;
     isDirty: boolean;
@@ -15,9 +69,51 @@ declare const useFormField: () => {
     formDescriptionId: string;
     formMessageId: string;
 };
+/**
+ * Wrapper de um campo do formulário (gera um `id` único compartilhado pelos filhos).
+ * Sempre o filho direto do `render` de um `FormField`.
+ *
+ * @example
+ * <FormItem>
+ *   <FormLabel>Email</FormLabel>
+ *   <FormControl><Input type="email" {...field} /></FormControl>
+ *   <FormDescription>Nunca compartilharemos seu email.</FormDescription>
+ *   <FormMessage />
+ * </FormItem>
+ */
 declare const FormItem: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Label do campo (já conectado via `htmlFor` ao `FormControl`). Aplica cor
+ * `text-destructive` automaticamente quando o campo tem erro.
+ *
+ * @example
+ * <FormLabel>Nome completo</FormLabel>
+ */
 declare const FormLabel: React.ForwardRefExoticComponent<Omit<LabelPrimitive.LabelProps & React.RefAttributes<HTMLLabelElement>, "ref"> & React.RefAttributes<HTMLLabelElement>>;
+/**
+ * Slot que injeta `id`, `aria-describedby` e `aria-invalid` no input filho.
+ * Use **um único filho** (Input, Textarea, Combobox, Select, etc).
+ *
+ * @example
+ * <FormControl><Input placeholder="seu@email.com" {...field} /></FormControl>
+ */
 declare const FormControl: React.ForwardRefExoticComponent<Omit<import("@radix-ui/react-slot").SlotProps & React.RefAttributes<HTMLElement>, "ref"> & React.RefAttributes<HTMLElement>>;
+/**
+ * Texto de ajuda exibido abaixo do controle (em `text-muted-foreground`).
+ * Já mapeado para `aria-describedby` do input.
+ *
+ * @example
+ * <FormDescription>Mínimo de 8 caracteres, com pelo menos um número.</FormDescription>
+ */
 declare const FormDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Mensagem de erro do campo (`text-danger`). Renderiza automaticamente o
+ * `error.message` do `react-hook-form` — não precisa passar `children`.
+ *
+ * @example
+ * <FormMessage />
+ * // Com fallback custom (sem erro):
+ * <FormMessage>Preencha um valor válido.</FormMessage>
+ */
 declare const FormMessage: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
 export { useFormField, Form, FormItem, FormLabel, FormControl, FormDescription, FormMessage, FormField, };

package/dist/components/ui/hover-card.d.ts

@@ -1,6 +1,21 @@
 import * as React from "react";
 import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
+/**
+ * Componente `HoverCard` da lib.
+ * @example
+ * <HoverCard />
+ */
 declare const HoverCard: React.FC<HoverCardPrimitive.HoverCardProps>;
+/**
+ * Componente `HoverCardTrigger` da lib.
+ * @example
+ * <HoverCardTrigger />
+ */
 declare const HoverCardTrigger: React.ForwardRefExoticComponent<HoverCardPrimitive.HoverCardTriggerProps & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * Componente `HoverCardContent` da lib.
+ * @example
+ * <HoverCardContent />
+ */
 declare const HoverCardContent: React.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export { HoverCard, HoverCardTrigger, HoverCardContent };

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

@@ -6,5 +6,10 @@ interface IconPickerProps {
     /** i18n: No icon label (default: "SEM ÍCONE") */
     noIconLabel?: string;
 }
+/**
+ * Componente `IconPicker` da lib.
+ * @example
+ * <IconPicker />
+ */
 export declare const IconPicker: React.FC<IconPickerProps>;
 export {};

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

@@ -1,3 +1,8 @@
+/**
+ * Tipo `IframeDialogProps` exportado pela lib.
+ * @example
+ * const value: IframeDialogProps = {} as IframeDialogProps;
+ */
 export interface IframeDialogProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -10,5 +15,10 @@ export interface IframeDialogProps {
     /** Min height for the iframe area */
     minHeight?: string;
 }
+/**
+ * Função utilitária `IframeDialog`.
+ * @example
+ * IframeDialog();
+ */
 export declare function IframeDialog({ open, onOpenChange, url, title, className, minHeight, }: IframeDialogProps): import("react/jsx-runtime").JSX.Element;
 export default IframeDialog;

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

@@ -20,10 +20,18 @@ import { type ButtonProps } from "./button";
 declare const InputGroup: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 /**
  * InputGroupAddon Variants
+ *
+ * @example
+ * inputGroupAddonVariants;
  */
 declare const inputGroupAddonVariants: (props?: {
     align?: "inline-end" | "inline-start" | "block-end" | "block-start";
 } & import("class-variance-authority/types").ClassProp) => string;
+/**
+ * Tipo `InputGroupAddonProps` exportado pela lib.
+ * @example
+ * const value: InputGroupAddonProps = {} as InputGroupAddonProps;
+ */
 export interface InputGroupAddonProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof inputGroupAddonVariants> {
 }
 /**
@@ -43,10 +51,18 @@ export interface InputGroupAddonProps extends React.HTMLAttributes<HTMLDivElemen
 declare const InputGroupAddon: React.ForwardRefExoticComponent<InputGroupAddonProps & React.RefAttributes<HTMLDivElement>>;
 /**
  * InputGroupButton Variants
+ *
+ * @example
+ * inputGroupButtonVariants;
  */
 declare const inputGroupButtonVariants: (props?: {
     size?: "sm" | "icon-sm" | "icon-xs" | "xs";
 } & import("class-variance-authority/types").ClassProp) => string;
+/**
+ * Tipo `InputGroupButtonProps` exportado pela lib.
+ * @example
+ * const value: InputGroupButtonProps = {} as InputGroupButtonProps;
+ */
 export interface InputGroupButtonProps extends Omit<ButtonProps, "size">, VariantProps<typeof inputGroupButtonVariants> {
 }
 /**

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

@@ -15,5 +15,10 @@ import * as React from "react";
 export interface InputProps extends React.ComponentProps<"input"> {
     showCharCount?: boolean;
 }
+/**
+ * Componente `Input` da lib.
+ * @example
+ * <Input />
+ */
 declare const Input: React.ForwardRefExoticComponent<Omit<InputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
 export { Input };

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

@@ -1,31 +1,111 @@
 import * as React from "react";
 import * as MenubarPrimitive from "@radix-ui/react-menubar";
+/**
+ * Componente `MenubarMenu` da lib.
+ * @example
+ * <MenubarMenu />
+ */
 declare const MenubarMenu: {
     (props: MenubarPrimitive.MenubarMenuProps & {
         __scopeMenubar?: import("@radix-ui/react-context").Scope;
     }): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+/**
+ * Componente `MenubarGroup` da lib.
+ * @example
+ * <MenubarGroup />
+ */
 declare const MenubarGroup: React.ForwardRefExoticComponent<MenubarPrimitive.MenubarGroupProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarPortal` da lib.
+ * @example
+ * <MenubarPortal />
+ */
 declare const MenubarPortal: React.FC<MenubarPrimitive.MenubarPortalProps>;
+/**
+ * Componente `MenubarSub` da lib.
+ * @example
+ * <MenubarSub />
+ */
 declare const MenubarSub: React.FC<MenubarPrimitive.MenubarSubProps>;
+/**
+ * Componente `MenubarRadioGroup` da lib.
+ * @example
+ * <MenubarRadioGroup />
+ */
 declare const MenubarRadioGroup: React.ForwardRefExoticComponent<MenubarPrimitive.MenubarRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `Menubar` da lib.
+ * @example
+ * <Menubar />
+ */
 declare const Menubar: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarTrigger` da lib.
+ * @example
+ * <MenubarTrigger />
+ */
 declare const MenubarTrigger: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Componente `MenubarSubTrigger` da lib.
+ * @example
+ * <MenubarSubTrigger />
+ */
 declare const MenubarSubTrigger: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarSubTriggerProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarSubContent` da lib.
+ * @example
+ * <MenubarSubContent />
+ */
 declare const MenubarSubContent: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarSubContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarContent` da lib.
+ * @example
+ * <MenubarContent />
+ */
 declare const MenubarContent: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarItem` da lib.
+ * @example
+ * <MenubarItem />
+ */
 declare const MenubarItem: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarCheckboxItem` da lib.
+ * @example
+ * <MenubarCheckboxItem />
+ */
 declare const MenubarCheckboxItem: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarCheckboxItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarRadioItem` da lib.
+ * @example
+ * <MenubarRadioItem />
+ */
 declare const MenubarRadioItem: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarRadioItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarLabel` da lib.
+ * @example
+ * <MenubarLabel />
+ */
 declare const MenubarLabel: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
     inset?: boolean;
 } & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarSeparator` da lib.
+ * @example
+ * <MenubarSeparator />
+ */
 declare const MenubarSeparator: React.ForwardRefExoticComponent<Omit<MenubarPrimitive.MenubarSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Componente `MenubarShortcut` da lib.
+ * @example
+ * <MenubarShortcut />
+ */
 declare const MenubarShortcut: {
     ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
     displayname: string;

package/dist/components/ui/multiselect-permissions.d.ts

@@ -1,4 +1,9 @@
 import React from 'react';
+/**
+ * Tipo `PermissionItem` exportado pela lib.
+ * @example
+ * const value: PermissionItem = {} as PermissionItem;
+ */
 export interface PermissionItem {
     id: string;
     name: string;
@@ -7,11 +12,21 @@ export interface PermissionItem {
     /** Group/context key for categorization */
     group?: string;
 }
+/**
+ * Tipo `PermissionCategory` exportado pela lib.
+ * @example
+ * const value: PermissionCategory = {} as PermissionCategory;
+ */
 export interface PermissionCategory {
     id: string;
     name: string;
     icon?: React.ReactNode;
 }
+/**
+ * Tipo `PermissionValues` exportado pela lib.
+ * @example
+ * const value: PermissionValues = {} as PermissionValues;
+ */
 export interface PermissionValues {
     /** IDs explicitly allowed */
     allowedIds: string[];
@@ -20,6 +35,11 @@ export interface PermissionValues {
     /** Group/context key */
     context?: string;
 }
+/**
+ * Tipo `MultiselectPermissionsProps` exportado pela lib.
+ * @example
+ * const value: MultiselectPermissionsProps = {} as MultiselectPermissionsProps;
+ */
 export interface MultiselectPermissionsProps {
     /** Available items to select from */
     items: PermissionItem[];
@@ -56,4 +76,9 @@ export interface MultiselectPermissionsProps {
     /** Additional className */
     className?: string;
 }
+/**
+ * Função utilitária `MultiselectPermissions`.
+ * @example
+ * MultiselectPermissions();
+ */
 export declare function MultiselectPermissions({ items, categories, value, onChange, readonly, isLoading, title, addButtonLabel, chipsTitle, chipsPlaceholder, searchPlaceholder, selectPlaceholder, itemInfoTemplate, disclaimer, disclaimerLink, onDisclaimerClick, className, }: MultiselectPermissionsProps): import("react/jsx-runtime").JSX.Element;