@boxcustodia/library 2.0.0-alpha.5 → 2.0.0-alpha.7

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { AlertDialog as AlertDialogPrimitive } from '@base-ui/react/alert-dialog';
 import { Avatar as AvatarPrimitive } from '@base-ui/react/avatar';
 import { ButtonHTMLAttributes } from 'react';
-import { CheckboxGroup as CheckboxGroup_2 } from '@base-ui/react/checkbox-group';
+import { ChangeEvent } from 'react';
+import { CheckboxGroup as CheckboxGroup_3 } from '@base-ui/react/checkbox-group';
 import { Checkbox as CheckboxPrimitive } from '@base-ui/react/checkbox';
 import { ClassNameValue } from 'tailwind-merge';
 import { ClassProp } from 'class-variance-authority/types';
@@ -19,12 +20,14 @@ import { DialogProps as DialogProps_2 } from '@radix-ui/react-dialog';
 import { Dispatch } from 'react';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import { ElementType } from 'react';
-import { FieldError } from 'react-hook-form';
+import { FieldError as FieldError_2 } from 'react-hook-form';
 import { FieldPath } from 'react-hook-form';
+import { Field as FieldPrimitive } from '@base-ui/react/field';
 import { FieldValues } from 'react-hook-form';
 import { FormEvent } from 'react';
 import { HTMLAttributes } from 'react';
 import { HTMLProps } from 'react';
+import { Input as InputPrimitive } from '@base-ui/react/input';
 import { JSX } from 'react/jsx-runtime';
 import { ListIterateeCustom } from 'lodash';
 import { LucideIcon } from 'lucide-react';
@@ -229,7 +232,7 @@ declare type ButtonProps = ComponentProps<typeof Button>;
 declare type ButtonProps_2 = ComponentProps<typeof Button>;
 
 export declare const buttonVariants: (props?: ({
-    variant?: "default" | "success" | "error" | "link" | "outline" | "secondary" | "ghost" | null | undefined;
+    variant?: "default" | "link" | "error" | "success" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "icon" | "sm" | "lg" | null | undefined;
     shape?: "rounded" | "circle" | "square" | null | undefined;
 } & ClassProp) | undefined) => string;
@@ -307,21 +310,58 @@ declare interface CenterProps extends ComponentProps<"div"> {
     inline?: boolean;
 }
 
-export declare function Checkbox({ children, className, id, indicatorProps, ...props }: CheckboxProps): React_2.ReactElement;
+export declare const Checkbox: typeof CheckboxSingle & {
+    Item: typeof CheckboxItem;
+    Group: typeof CheckboxGroup_2;
+    Legend: typeof CheckboxLegend;
+};
+
+export declare function CheckboxGroup({ className, ...props }: CheckboxGroup_3.Props): React_2.ReactElement;
+
+declare function CheckboxGroup_2({ legend, children, error, description, defaultValue, value, onChange, allValues, disabled, controlFirst, className, }: CheckboxGroupProps): React_2.ReactElement;
 
-export declare function CheckboxGroup({ className, ...props }: CheckboxGroup_2.Props): React_2.ReactElement;
+export declare interface CheckboxGroupProps {
+    legend?: ReactNode;
+    children: ReactNode;
+    error?: string;
+    description?: ReactNode;
+    defaultValue?: string[];
+    value?: string[];
+    onChange?: (value: string[]) => void;
+    allValues?: string[];
+    disabled?: boolean;
+    controlFirst?: boolean;
+    className?: string;
+}
 
 export declare function CheckboxIndicator({ className, ...props }: CheckboxPrimitive.Indicator.Props): React_2.ReactElement;
 
+declare function CheckboxItem({ className, label, id, ...props }: CheckboxItemProps): React_2.ReactElement;
+
+export declare interface CheckboxItemProps extends Omit<CheckboxPrimitive.Root.Props, "children"> {
+    label: ReactNode;
+}
+
+declare function CheckboxLegend({ children, className }: CheckboxLegendProps): React_2.ReactElement;
+
+export declare interface CheckboxLegendProps {
+    children: ReactNode;
+    className?: string;
+}
+
 export { CheckboxPrimitive }
 
 declare interface CheckboxProps extends Omit<CheckboxPrimitive.Root.Props, "children"> {
-    children?: React_2.ReactNode;
+    children?: ReactNode;
+    label?: ReactNode;
     indicatorProps?: CheckboxPrimitive.Indicator.Props;
+    controlFirst?: boolean;
 }
 
 export declare function CheckboxRoot({ className, ...props }: CheckboxPrimitive.Root.Props): React_2.ReactElement;
 
+declare function CheckboxSingle({ children, label, className, id, indicatorProps, controlFirst, ...props }: CheckboxProps): React_2.ReactElement;
+
 export declare type ClassName = string | undefined;
 
 export declare const click: (element: HTMLElement) => void;
@@ -627,7 +667,31 @@ declare interface ExtendedProps_2 {
  */
 export declare const extractInitials: (string: string) => string;
 
-export declare const Field: ({ label, labelClassName, labelProps, error, errorClassName, errorProps, children, className, ...props }: Props_10) => JSX.Element;
+export declare function Field({ label, required, tooltip, description, error, controlFirst, children, className, ...props }: FieldProps): JSX.Element;
+
+export declare function FieldDescription({ className, ...props }: FieldPrimitive.Description.Props): JSX.Element;
+
+export declare function FieldError({ className, ...props }: FieldPrimitive.Error.Props): JSX.Element;
+
+export declare type FieldErrorMatch = FieldPrimitive.Error.Props["match"];
+
+export declare function FieldLabel({ className, ...props }: FieldPrimitive.Label.Props): JSX.Element;
+
+export { FieldPrimitive }
+
+export declare interface FieldProps extends FieldPrimitive.Root.Props {
+    label?: ReactNode;
+    required?: boolean;
+    tooltip?: ReactNode;
+    description?: ReactNode;
+    error?: string | {
+        message: ReactNode;
+        match: NonNullable<FieldErrorMatch>;
+    };
+    controlFirst?: boolean;
+}
+
+export declare function FieldRoot({ className, ...props }: FieldPrimitive.Root.Props): JSX.Element;
 
 declare type FileError = {
     file: File;
@@ -667,7 +731,7 @@ export declare const FileTypeGroups: Record<string, FileTypeValue[]>;
 
 export declare type FileTypeValue = (typeof FileType)[keyof typeof FileType];
 
-export declare const Form: <TFieldValues extends FieldValues = FieldValues>({ onSubmit, id, form, children, className, }: Props_11<TFieldValues>) => JSX.Element;
+export declare const Form: <TFieldValues extends FieldValues = FieldValues>({ onSubmit, id, form, children, className, }: Props_10<TFieldValues>) => JSX.Element;
 
 export declare const FormControl: ({ className, ...props }: React_2.ComponentProps<typeof Slot>) => JSX.Element;
 
@@ -710,7 +774,7 @@ declare type GenericObject_2 = Record<string, any>;
 
 export declare const getFormData: (event: FormEvent<HTMLFormElement>) => Record<string, string>;
 
-export declare const Heading: <C extends React.ElementType = "h2">({ className, size, weight, as, ...props }: Props_12<C>) => JSX.Element;
+export declare const Heading: <C extends React.ElementType = "h2">({ className, size, weight, as, ...props }: Props_11<C>) => JSX.Element;
 
 declare const HeadingVariants: (props?: ({
     size?: "sm" | "lg" | "md" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | null | undefined;
@@ -728,7 +792,25 @@ declare type HotkeyOptions = {
 
 export declare type ID = string | number;
 
-export declare const Input: ({ value: prop, onChange, defaultValue: defaultProp, ...rest }: Props_13) => JSX.Element;
+export declare function Input({ className, label, tooltip, description, error, required, ...inputProps }: InputProps): JSX.Element;
+
+export { InputPrimitive }
+
+export declare interface InputProps extends InputRootProps {
+    label?: ReactNode;
+    tooltip?: ReactNode;
+    description?: ReactNode;
+    error?: string | {
+        message: ReactNode;
+        match: NonNullable<FieldErrorMatch>;
+    };
+}
+
+export declare function InputRoot({ className, onChange, ...props }: InputRootProps): JSX.Element;
+
+export declare interface InputRootProps extends Omit<InputPrimitive.Props, "onChange" | "size"> {
+    onChange?: (value: string, event: ChangeEvent<HTMLInputElement>) => void;
+}
 
 declare interface ItemTimeline {
     content?: ReactNode;
@@ -777,12 +859,12 @@ export declare type LibraryProviderProps = {
     tooltipDelay?: ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>["delay"];
 } & Omit<ToastProviderProps, "children">;
 
-export declare const Loader: ({ center, containerClassName, variant, size, ...props }: Props_14) => JSX.Element;
+export declare const Loader: ({ center, containerClassName, variant, size, ...props }: Props_12) => JSX.Element;
 
 declare type LoaderVariants = VariantProps<typeof loaderVariants>;
 
 declare const loaderVariants: (props?: ({
-    variant?: "success" | "error" | "warning" | "info" | "secondary" | "ghost" | "primary" | null | undefined;
+    variant?: "error" | "success" | "secondary" | "ghost" | "primary" | "warning" | "info" | null | undefined;
     size?: "default" | "sm" | "lg" | "xs" | "xl" | null | undefined;
 } & ClassProp) | undefined) => string;
 
@@ -968,7 +1050,7 @@ declare type noop = (this: any, ...args: any[]) => any;
 
 export declare type Nullable<T> = T | null;
 
-export declare const NumberInput: ({ value: prop, onChange, defaultValue: defaultProp, className, min, max, ...props }: Props_15) => JSX.Element;
+export declare const NumberInput: ({ value: prop, onChange, defaultValue: defaultProp, className, min, max, ...props }: Props_13) => JSX.Element;
 
 declare type OpenProps = {
     open?: boolean;
@@ -987,15 +1069,35 @@ export declare type OverrideProps<T, TOverridden> = Omit<T, keyof TOverridden> &
 
 export declare type PageSize = (typeof TABLE_PAGE_SIZES)[number];
 
-export declare const Pagination: ({ optionProps, className, containerProps, ...rangeProps }: Props_16) => JSX.Element;
+export declare const Pagination: ({ optionProps, className, containerProps, ...rangeProps }: Props_14) => JSX.Element;
 
 declare interface PaginationOptionProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     isActive?: boolean;
 }
 
-export declare const Password: ({ className, containerClassName, showIcon, hideIcon, onShow, onHide, toggleable, ...rest }: Props_17) => JSX.Element;
+export declare function Password({ label, tooltip, description, error, required, ...passwordProps }: PasswordProps): JSX.Element;
 
-export declare const Popover: (props: Props_18) => JSX.Element;
+export declare interface PasswordProps extends PasswordRootProps {
+    label?: ReactNode;
+    tooltip?: ReactNode;
+    description?: ReactNode;
+    error?: string | {
+        message: ReactNode;
+        match: NonNullable<FieldErrorMatch>;
+    };
+}
+
+export declare function PasswordRoot({ className, showIcon, hideIcon, onShow, onHide, toggleable, ...rest }: PasswordRootProps): JSX.Element;
+
+export declare interface PasswordRootProps extends InputRootProps {
+    showIcon?: ReactNode;
+    hideIcon?: ReactNode;
+    onShow?: () => void;
+    onHide?: () => void;
+    toggleable?: boolean;
+}
+
+export declare const Popover: (props: Props_15) => JSX.Element;
 
 export declare const PopoverContent: ({ className, align, sideOffset, matchTriggerWidth, style, focus, ...props }: PopoverContentProps) => JSX.Element;
 
@@ -1015,7 +1117,7 @@ export declare function Progress({ size, variant, className, trackProps, indicat
 export declare function ProgressIndicator({ className, variant, ...props }: Progress_2.Indicator.Props & VariantProps<typeof progressIndicatorVariants>): React_2.ReactElement;
 
 declare const progressIndicatorVariants: (props?: ({
-    variant?: "default" | "success" | "error" | "warning" | "info" | null | undefined;
+    variant?: "default" | "error" | "success" | "warning" | "info" | null | undefined;
 } & ClassProp) | undefined) => string;
 
 export declare function ProgressLabel({ className, ...props }: Progress_2.Label.Props): React_2.ReactElement;
@@ -1044,16 +1146,7 @@ declare interface Props extends ExtendedProps {
     onSelect?: (value: AutoCompleteItem["value"], item: AutoCompleteItem) => any;
 }
 
-declare interface Props_10 extends ComponentProps<"div"> {
-    label?: ReactNode;
-    labelClassName?: string;
-    labelProps?: ComponentPropsWithoutRef<"label">;
-    error?: ReactNode;
-    errorClassName?: string;
-    errorProps?: ComponentPropsWithoutRef<"p">;
-}
-
-declare type Props_11<TFieldValues extends FieldValues> = {
+declare type Props_10<TFieldValues extends FieldValues> = {
     onSubmit: (data: TFieldValues) => void;
     form: UseFormReturn<TFieldValues, any, any>;
     children: React_2.ReactNode;
@@ -1061,25 +1154,16 @@ declare type Props_11<TFieldValues extends FieldValues> = {
     id?: string;
 };
 
-declare type Props_12<C extends React.ElementType> = VariantProps<typeof HeadingVariants> & {
+declare type Props_11<C extends React.ElementType> = VariantProps<typeof HeadingVariants> & {
     as?: C;
 } & Omit<React.ComponentPropsWithoutRef<C>, "as">;
 
-declare type Props_13 = OverrideProps<ComponentProps<"input">, {
-    /** valor del input */
-    value?: string;
-    /** functión a ejecutar cuando el valor cambia */
-    onChange?: (value: string) => void;
-    /** valor por defecto del input */
-    defaultValue?: string;
-}>;
-
-declare type Props_14 = LucideProps & LoaderVariants & {
+declare type Props_12 = LucideProps & LoaderVariants & {
     center?: boolean;
     containerClassName?: string;
 };
 
-declare type Props_15 = OverrideProps<ComponentProps<"input">, {
+declare type Props_13 = OverrideProps<ComponentProps<"input">, {
     /** valor del input */
     value?: number;
     /** functión a ejecutar cuando el valor cambia */
@@ -1092,28 +1176,13 @@ declare type Props_15 = OverrideProps<ComponentProps<"input">, {
     max?: number;
 }>;
 
-declare interface Props_16 extends useRangePaginationProps {
+declare interface Props_14 extends useRangePaginationProps {
     optionProps?: PaginationOptionProps;
     className?: string;
     containerProps?: HTMLProps<HTMLDivElement>;
 }
 
-declare type Props_17 = OverrideProps<ComponentProps<typeof Input>, {
-    /** Clase CSS para el contenedor */
-    containerClassName?: string;
-    /** Ícono para mostrar la contraseña */
-    showIcon?: ReactNode;
-    /** Ícono para ocultar la contraseña */
-    hideIcon?: ReactNode;
-    /** Callback cuando se muestra la contraseña */
-    onShow?: () => void;
-    /** Callback cuando se oculta la contraseña */
-    onHide?: () => void;
-    /** Habilita/deshabilita el botón de mostrar/ocultar contraseña */
-    toggleable?: boolean;
-}>;
-
-declare interface Props_18 {
+declare interface Props_15 {
     trigger?: ReactNode;
     children: ReactNode;
     rootProps?: ComponentPropsWithoutRef<typeof PopoverRoot>;
@@ -1127,19 +1196,12 @@ declare interface Props_18 {
     offset?: ComponentPropsWithoutRef<typeof PopoverContent>["sideOffset"];
 }
 
-declare interface Props_19 extends ComponentPropsWithoutRef<typeof Slot> {
+declare interface Props_16 extends ComponentPropsWithoutRef<typeof Slot> {
     /** Si el componente está presente o no */
     when: ComponentProps<typeof Presence>["present"];
 }
 
-declare interface Props_2 extends HTMLProps<HTMLDivElement> {
-    /**
-     * La URL de la imagen
-     */
-    src: string;
-}
-
-declare type Props_20<T> = {
+declare type Props_17<T> = {
     data: T[];
     columns: ColumnDef<T>[];
     onRowClick?: (row: T) => void;
@@ -1147,18 +1209,25 @@ declare type Props_20<T> = {
     selected?: (row: T) => boolean;
 } & ExtendedProps_2 & Omit<ComponentPropsWithoutRef<typeof TableRoot>, "data" | "selected" | "onDoubleClick">;
 
-declare type Props_21 = {
+declare type Props_18 = {
     setPageSize?: (value: PageSize) => void;
     pageSize?: PageSize;
 } & Omit<usePaginationProps, "pageSize"> & TablePaginationExtendedProps;
 
-declare type Props_22 = ClosableProps | NonClosableProps;
+declare type Props_19 = ClosableProps | NonClosableProps;
+
+declare interface Props_2 extends HTMLProps<HTMLDivElement> {
+    /**
+     * La URL de la imagen
+     */
+    src: string;
+}
 
-declare type Props_23<T extends TreeNode> = TreeRootProps & {
+declare type Props_20<T extends TreeNode> = TreeRootProps & {
     items: T[];
 };
 
-declare interface Props_24<T> extends UseAsyncOptions<T> {
+declare interface Props_21<T> extends UseAsyncOptions<T> {
     fn: () => Promise<T>;
     dependencies?: DependencyList;
 }
@@ -1372,7 +1441,7 @@ declare type Shortcut = Partial<{
     shortcutOptions: MenuShortcutProps_2["options"];
 }>;
 
-export declare const Show: ({ when, ...props }: Props_19) => JSX.Element;
+export declare const Show: ({ when, ...props }: Props_16) => JSX.Element;
 
 export declare type SingleDateValue = {
     value?: DateSingle;
@@ -1452,11 +1521,13 @@ declare interface StepperTriggerProps {
 
 declare type StyleProps = ColorProps | VariantProps_2;
 
-export declare function Switch({ children, className, id, thumbProps, ...props }: SwitchProps): React_2.ReactElement;
+export declare function Switch({ children, label, className, id, thumbProps, controlFirst, ...props }: SwitchProps): React_2.ReactElement;
 
 declare interface SwitchProps extends Omit<Switch_2.Root.Props, "children"> {
     children?: React_2.ReactNode;
+    label?: React_2.ReactNode;
     thumbProps?: Switch_2.Thumb.Props;
+    controlFirst?: boolean;
 }
 
 export declare function SwitchRoot({ className, ...props }: Switch_2.Root.Props): React_2.ReactElement;
@@ -1469,7 +1540,7 @@ export declare interface TabContentProps extends HTMLProps<HTMLDivElement> {
     value: string;
 }
 
-export declare const Table: <T>({ data, columns, onRowClick, onDoubleClick, selected, theadClassName, theadProps, tbodyClassName, tbodyProps, trClassName, trProps, thClassName, thProps, tdClassName, tdProps, ...tableProps }: Props_20<T>) => JSX.Element;
+export declare const Table: <T>({ data, columns, onRowClick, onDoubleClick, selected, theadClassName, theadProps, tbodyClassName, tbodyProps, trClassName, trProps, thClassName, thProps, tdClassName, tdProps, ...tableProps }: Props_17<T>) => JSX.Element;
 
 export declare const TABLE_PAGE_SIZES: number[];
 
@@ -1497,7 +1568,7 @@ declare type TableHeaderProps = React_2.ComponentProps<"thead">;
 
 declare type TableHeadProps = React_2.ComponentProps<"th">;
 
-export declare const TablePagination: ({ containerClassName, containerProps, selectClassName, selectProps, sizes, ...props }: Props_21) => JSX.Element;
+export declare const TablePagination: ({ containerClassName, containerProps, selectClassName, selectProps, sizes, ...props }: Props_18) => JSX.Element;
 
 declare interface TablePaginationExtendedProps {
     containerClassName?: ClassName;
@@ -1552,13 +1623,13 @@ export declare interface TabTriggerProps extends Omit<HTMLProps<HTMLButtonElemen
     value: string;
 }
 
-export declare const Tag: ({ className, color, variant, rounded, icon, closable, onClose, children, ...props }: Props_22) => JSX.Element;
+export declare const Tag: ({ className, color, variant, rounded, icon, closable, onClose, children, ...props }: Props_19) => JSX.Element;
 
 export declare type TagVariant = VariantProps<typeof tagVariants>;
 
 export declare const tagVariants: (props?: ({
     rounded?: "default" | "square" | "full" | null | undefined;
-    variant?: "success" | "error" | "outline" | "secondary" | "primary" | "borderless" | null | undefined;
+    variant?: "error" | "success" | "outline" | "secondary" | "primary" | "borderless" | null | undefined;
 } & ClassProp) | undefined) => string;
 
 export declare const Textarea: ({ className, ...props }: TextAreaProps) => JSX.Element;
@@ -1759,7 +1830,7 @@ export declare function TooltipRoot(props: RootProps): JSX.Element;
 
 export declare function TooltipTrigger({ className, ...props }: TriggerProps): JSX.Element;
 
-export declare function Tree<T extends TreeNode>({ items, ...props }: Props_23<T>): JSX.Element;
+export declare function Tree<T extends TreeNode>({ items, ...props }: Props_20<T>): JSX.Element;
 
 export declare const TreeItem: <T extends object>({ className, ...props }: OverrideProps<TreeItemProps<T>, {
     id: string | number;
@@ -1849,7 +1920,7 @@ export declare function useArray<T>(defaultProp: T[]): readonly [T[], {
     readonly update: (predicate: ListIterateeCustom<T, boolean>, newItem: T | ((item: T) => T)) => void;
 }];
 
-export declare function useAsync<T>({ fn, dependencies, onError, onSuccess, onFinish, }: Props_24<T>): AsyncState<T>;
+export declare function useAsync<T>({ fn, dependencies, onError, onSuccess, onFinish, }: Props_21<T>): AsyncState<T>;
 
 declare interface UseAsyncOptions<T> {
     onError?: (error: Error) => void;
@@ -1889,7 +1960,7 @@ export declare const useFormField: () => {
     isDirty: boolean;
     isTouched: boolean;
     isValidating: boolean;
-    error?: FieldError;
+    error?: FieldError_2;
     id: string;
     name: string;
     formItemId: string;