eai-frontend-components 2.0.19 → 2.0.21

package/dist/index.d.ts

@@ -80,7 +80,7 @@ declare const AvatarImage: React$1.ForwardRefExoticComponent<Omit<AvatarPrimitiv
 declare const AvatarFallback: React$1.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarFallbackProps & React$1.RefAttributes<HTMLSpanElement>, "ref"> & React$1.RefAttributes<HTMLSpanElement>>;
 
 declare const badgeVariants: (props?: ({
-    variant?: "default" | "destructive" | "secondary" | "surface" | "outline" | "green" | "red" | "gray" | "blue" | "orange" | null | undefined;
+    variant?: "default" | "outline" | "destructive" | "secondary" | "surface" | "green" | "red" | "gray" | "blue" | "orange" | null | undefined;
 } & class_variance_authority_dist_types.ClassProp) | undefined) => string;
 interface BadgeProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
 }
@@ -105,7 +105,7 @@ declare const BreadcrumbEllipsis: {
 };
 
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "destructive" | "secondary" | "outline" | "ghost" | null | undefined;
+    variant?: "link" | "default" | "outline" | "destructive" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "sm" | "lg" | "icon" | null | undefined;
 } & class_variance_authority_dist_types.ClassProp) | undefined) => string;
 interface ButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
@@ -408,8 +408,93 @@ declare const Input: React$1.ForwardRefExoticComponent<InputProps & React$1.RefA
 
 declare const Label: React$1.ForwardRefExoticComponent<Omit<LabelPrimitive.LabelProps & React$1.RefAttributes<HTMLLabelElement>, "ref"> & VariantProps<(props?: class_variance_authority_dist_types.ClassProp | undefined) => string> & React$1.RefAttributes<HTMLLabelElement>>;
 
+/**
+ * Type for mask modification functions.
+ * Fallback for projects without @react-input/mask types.
+ */
+type MaskModifyFunction = Modify;
+/**
+ * Modify function for phone number input mask.
+ * Automatically adjusts between landline and mobile phone formats.
+ *
+ * @param value - Current input value
+ * @param data - New input data
+ * @param selectionStart - Cursor start position
+ * @param selectionEnd - Cursor end position
+ * @returns Mask configuration object
+ */
 declare const modifyPhone: Modify;
+/**
+ * Creates a phone number mask based on the input length.
+ * - Landline: (XX) XXXX-XXXX
+ * - Mobile: (XX) X XXXX-XXXX
+ *
+ * @param value - Phone number string (can be null)
+ * @returns Mask configuration object with pattern and replacement rules
+ *
+ * @example
+ * ```tsx
+ * const mask = maskPhone('11987654321');
+ * // Returns: { mask: '(__) _ ____-____', replacement: { _: /\d/ } }
+ * ```
+ */
+declare function maskPhone(value: string | null): {
+    mask: string;
+    replacement: {
+        _: RegExp;
+    };
+};
+/**
+ * Modify function for CPF/CNPJ input mask.
+ * Automatically switches between CPF and CNPJ formats based on input length.
+ *
+ * @param value - Current input value
+ * @param data - New input data
+ * @param selectionStart - Cursor start position
+ * @param selectionEnd - Cursor end position
+ * @returns Mask configuration object
+ */
 declare const modifyCpfCnpj: Modify;
+/**
+ * Creates a CPF or CNPJ mask based on the input length.
+ * - CPF: XXX.XXX.XXX-XX (up to 11 digits)
+ * - CNPJ: XX.XXX.XXX/XXXX-XX (12+ digits)
+ *
+ * @param value - CPF/CNPJ string (can be null)
+ * @returns Mask configuration object with pattern and replacement rules
+ *
+ * @example
+ * ```tsx
+ * const cpfMask = maskCpfCnpj('12345678901');
+ * // Returns: { mask: '___.___.___-___', replacement: { _: /\d/ } }
+ *
+ * const cnpjMask = maskCpfCnpj('12345678000195');
+ * // Returns: { mask: '__.___.___/____-__', replacement: { _: /\d/ } }
+ * ```
+ */
+declare function maskCpfCnpj(value: string | null): {
+    mask: string;
+    replacement: {
+        _: RegExp;
+    };
+};
+/**
+ * Removes all non-numeric characters from a string.
+ * Useful for extracting only digits from masked inputs.
+ *
+ * @param value - String with potential mask characters
+ * @returns String containing only numeric characters
+ *
+ * @example
+ * ```tsx
+ * const cleaned = removeMaskNumber('(11) 9 8765-4321');
+ * // Returns: '11987654321'
+ *
+ * const cleanCpf = removeMaskNumber('123.456.789-01');
+ * // Returns: '12345678901'
+ * ```
+ */
+declare const removeMaskNumber: (value: string) => string;
 
 declare const Pagination: {
     ({ className, ...props }: React$1.ComponentProps<"nav">): react_jsx_runtime.JSX.Element;
@@ -1509,8 +1594,48 @@ declare function getTailwindColorShades(): {
 type TailwindColorName = keyof ReturnType<typeof getTailwindColorShades>;
 declare const replaceThemeTailwindColors: (theme: string, tailwindColor: string) => HTMLStyleElement;
 
+/**
+ * Formats a phone number string with proper mask.
+ * Automatically detects landline vs mobile format.
+ *
+ * @param telefone - Raw phone number string
+ * @param removerCountryCode - Whether to remove country code (55) if present
+ * @returns Formatted phone number string
+ *
+ * @example
+ * ```tsx
+ * formatPhone('11987654321') // '(11) 9 8765-4321'
+ * formatPhone('1134567890')  // '(11) 3456-7890'
+ * ```
+ */
 declare function formatPhone(telefone: string, removerCountryCode?: boolean): string;
+/**
+ * Formats a CPF or CNPJ string with proper mask.
+ * Automatically detects CPF vs CNPJ format based on length.
+ *
+ * @param cpfCnpj - Raw CPF/CNPJ string
+ * @returns Formatted CPF/CNPJ string
+ *
+ * @example
+ * ```tsx
+ * formatCpfCnpj('12345678901')    // '123.456.789-01'
+ * formatCpfCnpj('12345678000195') // '12.345.678/0001-95'
+ * ```
+ */
 declare function formatCpfCnpj(cpfCnpj?: string): string;
+/**
+ * Formats a date to Brazilian format (DD/MM/YYYY).
+ *
+ * @param date - Date string, Date object, or undefined
+ * @param separator - Date separator (default: '/')
+ * @returns Formatted date string in Brazilian format
+ *
+ * @example
+ * ```tsx
+ * formatDate('2023-12-25')      // '25/12/2023'
+ * formatDate(new Date())        // '13/10/2025'
+ * ```
+ */
 declare const formatDate: (date: string | Date | undefined, separator?: string) => string;
 declare const formatDateTime: (date: Date | undefined, returnSeconds?: boolean) => string;
 declare function formatDateCalendar(date: Date | undefined): string;
@@ -1524,7 +1649,74 @@ declare const convertBytesToMB: (bytes: number) => number;
 declare const convertMonthToDays: (months: number) => number;
 declare const convertDaysToMonth: (days: number) => number;
 declare const formatNumber: (value: number) => string;
+/**
+ * Formats a number with Brazilian decimal format.
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted decimal string
+ *
+ * @example
+ * ```tsx
+ * formatDecimal(1234.56)   // '1.234,56'
+ * formatDecimal(1000.1, 1) // '1.000,1'
+ * ```
+ */
 declare const formatDecimal: (value: number, decimalPlaces?: number) => string;
+/**
+ * Formats a number as percentage with Brazilian decimal format.
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted percentage string
+ *
+ * @example
+ * ```tsx
+ * formatPercent(15.5)    // '% 15,50'
+ * formatPercent(100, 0)  // '% 100'
+ * ```
+ */
+declare const formatPercent: (value: number, decimalPlaces?: number) => string;
+/**
+ * Formats a number as Brazilian currency (BRL).
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```tsx
+ * formatCurrency(1234.56)  // 'R$ 1.234,56'
+ * formatCurrency(1000, 0)  // 'R$ 1.000'
+ * ```
+ */
+declare const formatCurrency: (value: number, decimalPlaces?: number) => string;
+declare const isInvalidCurrencyValue: (rawValue: string | undefined) => boolean;
+/**
+ * Formats an MSISDN (mobile phone number) to display format.
+ *
+ * @param value - Raw MSISDN string
+ * @returns Formatted MSISDN string
+ *
+ * @example
+ * ```tsx
+ * formatMsisdn('5511987654321') // '(11) 98765-4321'
+ * ```
+ */
+declare function formatMsisdn(value?: string): string;
+/**
+ * Formats a CEP (Brazilian postal code) with proper mask.
+ *
+ * @param cep - Raw CEP string
+ * @returns Formatted CEP string (XXXXX-XXX)
+ *
+ * @example
+ * ```tsx
+ * formatCEP('01234567') // '01234-567'
+ * formatCEP('12345')    // '12345'
+ * ```
+ */
+declare function formatCEP(cep?: string): string;
 
 declare const getFirstDayOfCurrentMonth: () => Date;
 declare const getFirstDayOf90DaysAgo: () => Date;
@@ -1535,5 +1727,5 @@ declare const addDaysToToday: (days: number) => Date;
 
 declare function isUUIDv4(str: string): boolean;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DEFAULT_THEME_DATA, DataTable, DataTableExport, DataTableFooter, DataTableHeader, DataTableRows, DatePickerWithRange as DateRangePicker, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Form, FormCombobox, FormControl, FormDataRange, FormDescription, FormField, FormInput, FormInputCheckbox, FormInputColor, FormInputCpfCnpj, FormInputCurrency, FormInputDate, FormInputDecimal, FormInputFile, FormInputGhost, FormInputMask, FormInputPassWord, FormInputPercent, FormInputPhone, FormInputSwitch, FormInputText, FormItem, FormLabel, FormMessage, FormRadioGroup, FormSelect, FormTextarea, Header, HoverCard, HoverCardContent, HoverCardTrigger, Input, Label, LabelWithTitle, ModuleSwitcher, MultiSelect, NavFooter, NavMain, NavSubmenuCollapsible, NavSubmenuDropdown, NavUser, NotFound, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarButton, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarItem, SidebarItemTwoLines, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarSubmenuType, SidebarTrigger, Skeleton, Slider, StepNewForm, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, ThemeProvider, Toast$1 as Toast, ToastAction, ToastClose, ToastDescription, ToastProvider, ToastTitle, ToastViewport, Toaster, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UseCalendar, aYearAgo, addDaysToToday, badgeVariants, buttonVariants, cn, convertBytesToMB, convertDaysToMonth, convertGbToMb, convertMbToGb, convertMonthToDays, convertSecondsToMinutes, formHelpText, formLabel, formLabelAndSubLabel, formMessage, formatCpfCnpj, formatDate, formatDateCalendar, formatDateTime, formatDecimal, formatNumber, formatPhone, getFirstDayOf90DaysAgo, getFirstDayOfCurrentMonth, getTailwindColorShades, invertDate, isUUIDv4, modifyCpfCnpj, modifyPhone, replaceThemeTailwindColors, roundNumber, stringDateToDate, stringToDate, stringToNumber, toast, useFormField, useSidebar, useTheme, useToast };
-export type { ActionRow, ActionTable, ButtonProps, CalendarProps, CarouselApi, ChartConfig, ComboboxOption, DataTableProps, ExportDataTable, FiltersActions, Module, MultiSelectOption, OriginalDataTableData, PropsStepNewForm, RadioOption, SelectOption, SidebarPage, TailwindColorName };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DEFAULT_THEME_DATA, DataTable, DataTableExport, DataTableFooter, DataTableHeader, DataTableRows, DatePickerWithRange as DateRangePicker, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Form, FormCombobox, FormControl, FormDataRange, FormDescription, FormField, FormInput, FormInputCheckbox, FormInputColor, FormInputCpfCnpj, FormInputCurrency, FormInputDate, FormInputDecimal, FormInputFile, FormInputGhost, FormInputMask, FormInputPassWord, FormInputPercent, FormInputPhone, FormInputSwitch, FormInputText, FormItem, FormLabel, FormMessage, FormRadioGroup, FormSelect, FormTextarea, Header, HoverCard, HoverCardContent, HoverCardTrigger, Input, Label, LabelWithTitle, ModuleSwitcher, MultiSelect, NavFooter, NavMain, NavSubmenuCollapsible, NavSubmenuDropdown, NavUser, NotFound, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, Sidebar, SidebarButton, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarItem, SidebarItemTwoLines, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarSubmenuType, SidebarTrigger, Skeleton, Slider, StepNewForm, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, ThemeProvider, Toast$1 as Toast, ToastAction, ToastClose, ToastDescription, ToastProvider, ToastTitle, ToastViewport, Toaster, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UseCalendar, aYearAgo, addDaysToToday, badgeVariants, buttonVariants, cn, convertBytesToMB, convertDaysToMonth, convertGbToMb, convertMbToGb, convertMonthToDays, convertSecondsToMinutes, formHelpText, formLabel, formLabelAndSubLabel, formMessage, formatCEP, formatCpfCnpj, formatCurrency, formatDate, formatDateCalendar, formatDateTime, formatDecimal, formatMsisdn, formatNumber, formatPercent, formatPhone, getFirstDayOf90DaysAgo, getFirstDayOfCurrentMonth, getTailwindColorShades, invertDate, isInvalidCurrencyValue, isUUIDv4, maskCpfCnpj, maskPhone, modifyCpfCnpj, modifyPhone, removeMaskNumber, replaceThemeTailwindColors, roundNumber, stringDateToDate, stringToDate, stringToNumber, toast, useFormField, useSidebar, useTheme, useToast };
+export type { ActionRow, ActionTable, ButtonProps, CalendarProps, CarouselApi, ChartConfig, ComboboxOption, DataTableProps, ExportDataTable, FiltersActions, MaskModifyFunction, Module, MultiSelectOption, OriginalDataTableData, PropsStepNewForm, RadioOption, SelectOption, SidebarPage, TailwindColorName };