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

package/dist/index.d.ts

@@ -11,7 +11,6 @@ import { Collection } from 'react-aria-components';
 import { Command } from 'cmdk';
 import { ComponentProps } from 'react';
 import { ComponentPropsWithoutRef } from 'react';
-import { ControllerRenderProps } from 'react-hook-form';
 import { CSSProperties } from 'react';
 import { default as default_2 } from 'react';
 import { DependencyList } from 'react';
@@ -20,11 +19,9 @@ 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 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 { Form as FormPrimitive } from '@base-ui/react/form';
 import { HTMLAttributes } from 'react';
 import { HTMLProps } from 'react';
 import { Input as InputPrimitive } from '@base-ui/react/input';
@@ -56,11 +53,8 @@ import { TreeItemContent as TreeItemContent_2 } from 'react-aria-components';
 import { TreeItemProps } from 'react-aria-components';
 import { TreeProps } from 'react-aria-components';
 import { useControllableState } from '@radix-ui/react-use-controllable-state';
-import { UseFormProps } from 'react-hook-form';
-import { UseFormReturn } from 'react-hook-form';
 import { useRender } from '@base-ui/react/use-render';
 import { VariantProps } from 'class-variance-authority';
-import { z } from 'zod';
 
 /**
  * Accessible confirmation dialog with cancel and action buttons.
@@ -220,7 +214,9 @@ export declare type BaseEntity = {
     createdAt: Date;
 };
 
-declare type BaseProps = {
+declare type BaseProps = FormPrimitive.Props;
+
+declare type BaseProps_2 = {
     icon?: React.ReactNode;
     rounded?: TagVariant["rounded"];
 } & StyleProps & React.HTMLAttributes<HTMLDivElement>;
@@ -354,13 +350,14 @@ export { CheckboxPrimitive }
 declare interface CheckboxProps extends Omit<CheckboxPrimitive.Root.Props, "children"> {
     children?: ReactNode;
     label?: ReactNode;
+    tooltip?: 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;
+declare function CheckboxSingle({ className, indicatorProps, label, children, tooltip, controlFirst, required, id, ...props }: CheckboxProps): React_2.ReactElement;
 
 export declare type ClassName = string | undefined;
 
@@ -368,7 +365,7 @@ export declare const click: (element: HTMLElement) => void;
 
 export declare type ClickEvent = React.MouseEvent<HTMLButtonElement, MouseEvent>;
 
-declare type ClosableProps = BaseProps & {
+declare type ClosableProps = BaseProps_2 & {
     closable: true;
     onClose: () => void;
 };
@@ -667,31 +664,61 @@ declare interface ExtendedProps_2 {
  */
 export declare const extractInitials: (string: string) => string;
 
-export declare function Field({ label, required, tooltip, description, error, controlFirst, children, className, ...props }: FieldProps): JSX.Element;
+export declare function Field({ label, description, error, required, tooltip, inline, children, className, labelProps, descriptionProps, errorProps, ...rootProps }: FieldProps): JSX.Element;
+
+export declare const FieldControl: typeof FieldPrimitive.Control;
 
 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 FieldErrorItem = {
+    message: ReactNode;
+    match?: NonNullable<FieldErrorMatch>;
+};
+
 export declare type FieldErrorMatch = FieldPrimitive.Error.Props["match"];
 
+export declare type FieldErrorProp = string | FieldErrorItem | FieldErrorItem[];
+
+export declare function FieldItem({ className, ...props }: FieldPrimitive.Item.Props): JSX.Element;
+
 export declare function FieldLabel({ className, ...props }: FieldPrimitive.Label.Props): JSX.Element;
 
 export { FieldPrimitive }
 
-export declare interface FieldProps extends FieldPrimitive.Root.Props {
+export declare interface FieldProps extends Omit<FieldPrimitive.Root.Props, "children"> {
+    /** Text rendered inside `FieldLabel`. */
     label?: ReactNode;
+    /** Helper text rendered below the control. */
+    description?: ReactNode;
+    /**
+     * Error message(s) rendered below the control:
+     * - `string` → always renders once the field is invalid.
+     * - `{ message, match }` → renders only when the `ValidityState` key matches.
+     * - `FieldErrorItem[]` → multiple errors with individual matches.
+     */
+    error?: FieldErrorProp;
+    /** Shows a red asterisk after the label text. */
     required?: boolean;
+    /** Renders an info icon with a tooltip next to the label. */
     tooltip?: ReactNode;
-    description?: ReactNode;
-    error?: string | {
-        message: ReactNode;
-        match: NonNullable<FieldErrorMatch>;
-    };
-    controlFirst?: boolean;
+    /**
+     * Renders the control before the label on the same row.
+     * Use for single checkboxes and switches.
+     */
+    inline?: boolean;
+    children?: ReactNode;
+    labelProps?: FieldPrimitive.Label.Props;
+    descriptionProps?: FieldPrimitive.Description.Props;
+    errorProps?: Omit<FieldPrimitive.Error.Props, "match" | "children">;
 }
 
-export declare function FieldRoot({ className, ...props }: FieldPrimitive.Root.Props): JSX.Element;
+export declare function FieldRoot({ className, required, ...props }: FieldPrimitive.Root.Props & {
+    required?: boolean;
+}): JSX.Element;
+
+export declare const FieldValidity: typeof FieldPrimitive.Validity;
 
 declare type FileError = {
     file: File;
@@ -731,32 +758,14 @@ 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_10<TFieldValues>) => JSX.Element;
-
-export declare const FormControl: ({ className, ...props }: React_2.ComponentProps<typeof Slot>) => JSX.Element;
+export declare function Form({ onSubmit, onFormSubmit, className, ...props }: FormProps): default_2.ReactElement;
 
-export declare const FormDescription: ({ className, ...props }: React_2.ComponentProps<"p">) => JSX.Element;
+export { FormPrimitive }
 
-export declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ name, label, description, className, render, itemProps, labelProps, controlProps, descriptionProps, messageProps, }: FormFieldProps<TFieldValues, TName>) => JSX.Element;
-
-declare type FormFieldProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = {
-    name: TName;
-    label?: string;
-    description?: string;
-    render: (field: ControllerRenderProps<TFieldValues, TName>) => React_2.ReactNode;
-    className?: string;
-    itemProps?: React_2.ComponentProps<typeof FormItem>;
-    labelProps?: React_2.ComponentProps<typeof FormLabel>;
-    controlProps?: React_2.ComponentProps<typeof FormControl>;
-    descriptionProps?: React_2.ComponentProps<typeof FormDescription>;
-    messageProps?: React_2.ComponentProps<typeof FormMessage>;
-};
-
-export declare const FormItem: ({ className, ...props }: React_2.ComponentProps<"div">) => JSX.Element;
-
-export declare const FormLabel: ({ className, ...props }: React_2.ComponentProps<"label">) => JSX.Element;
-
-export declare const FormMessage: ({ className, children, ...props }: React_2.ComponentProps<"p">) => JSX.Element | null;
+export declare interface FormProps extends Omit<BaseProps, "onSubmit" | "onFormSubmit"> {
+    onSubmit?: BaseProps["onFormSubmit"];
+    onFormSubmit?: BaseProps["onFormSubmit"];
+}
 
 export declare interface GenericMenuProps {
     trigger: default_2.ReactNode;
@@ -774,7 +783,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_11<C>) => JSX.Element;
+export declare const Heading: <C extends React.ElementType = "h2">({ className, size, weight, as, ...props }: Props_10<C>) => JSX.Element;
 
 declare const HeadingVariants: (props?: ({
     size?: "sm" | "lg" | "md" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | null | undefined;
@@ -792,25 +801,14 @@ declare type HotkeyOptions = {
 
 export declare type ID = string | number;
 
-export declare function Input({ className, label, tooltip, description, error, required, ...inputProps }: InputProps): JSX.Element;
+export declare function Input({ className, nativeInput, onChange, ...props }: 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"> {
+export declare type InputProps = Omit<InputPrimitive.Props, "size" | "onChange"> & {
     onChange?: (value: string, event: ChangeEvent<HTMLInputElement>) => void;
-}
+    nativeInput?: boolean;
+};
 
 declare interface ItemTimeline {
     content?: ReactNode;
@@ -859,7 +857,7 @@ export declare type LibraryProviderProps = {
     tooltipDelay?: ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>["delay"];
 } & Omit<ToastProviderProps, "children">;
 
-export declare const Loader: ({ center, containerClassName, variant, size, ...props }: Props_12) => JSX.Element;
+export declare const Loader: ({ center, containerClassName, variant, size, ...props }: Props_11) => JSX.Element;
 
 declare type LoaderVariants = VariantProps<typeof loaderVariants>;
 
@@ -1041,7 +1039,7 @@ declare type Mutation<TArgs extends any[], TReturn> = (...args: TArgs) => Promis
 
 declare type NavigationProps = Pick<CalendarNavigationProps, "goNextProps" | "goBackProps" | "changeViewProps">;
 
-declare type NonClosableProps = BaseProps & {
+declare type NonClosableProps = BaseProps_2 & {
     closable?: false;
     onClose?: never;
 };
@@ -1050,7 +1048,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_13) => JSX.Element;
+export declare const NumberInput: ({ value: prop, onChange, defaultValue: defaultProp, className, min, max, ...props }: Props_12) => JSX.Element;
 
 declare type OpenProps = {
     open?: boolean;
@@ -1069,35 +1067,23 @@ 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_14) => JSX.Element;
+export declare const Pagination: ({ optionProps, className, containerProps, ...rangeProps }: Props_13) => JSX.Element;
 
 declare interface PaginationOptionProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     isActive?: boolean;
 }
 
-export declare function Password({ label, tooltip, description, error, required, ...passwordProps }: PasswordProps): JSX.Element;
+export declare function PasswordRoot({ className, showIcon, hideIcon, onShow, onHide, toggleable, onChange, ...rest }: PasswordRootProps): 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 {
+export declare type PasswordRootProps = Omit<InputProps, "unstyled" | "nativeInput"> & {
     showIcon?: ReactNode;
     hideIcon?: ReactNode;
     onShow?: () => void;
     onHide?: () => void;
     toggleable?: boolean;
-}
+};
 
-export declare const Popover: (props: Props_15) => JSX.Element;
+export declare const Popover: (props: Props_14) => JSX.Element;
 
 export declare const PopoverContent: ({ className, align, sideOffset, matchTriggerWidth, style, focus, ...props }: PopoverContentProps) => JSX.Element;
 
@@ -1146,24 +1132,16 @@ declare interface Props extends ExtendedProps {
     onSelect?: (value: AutoCompleteItem["value"], item: AutoCompleteItem) => any;
 }
 
-declare type Props_10<TFieldValues extends FieldValues> = {
-    onSubmit: (data: TFieldValues) => void;
-    form: UseFormReturn<TFieldValues, any, any>;
-    children: React_2.ReactNode;
-    className?: string;
-    id?: string;
-};
-
-declare type Props_11<C extends React.ElementType> = VariantProps<typeof HeadingVariants> & {
+declare type Props_10<C extends React.ElementType> = VariantProps<typeof HeadingVariants> & {
     as?: C;
 } & Omit<React.ComponentPropsWithoutRef<C>, "as">;
 
-declare type Props_12 = LucideProps & LoaderVariants & {
+declare type Props_11 = LucideProps & LoaderVariants & {
     center?: boolean;
     containerClassName?: string;
 };
 
-declare type Props_13 = OverrideProps<ComponentProps<"input">, {
+declare type Props_12 = OverrideProps<ComponentProps<"input">, {
     /** valor del input */
     value?: number;
     /** functión a ejecutar cuando el valor cambia */
@@ -1176,13 +1154,13 @@ declare type Props_13 = OverrideProps<ComponentProps<"input">, {
     max?: number;
 }>;
 
-declare interface Props_14 extends useRangePaginationProps {
+declare interface Props_13 extends useRangePaginationProps {
     optionProps?: PaginationOptionProps;
     className?: string;
     containerProps?: HTMLProps<HTMLDivElement>;
 }
 
-declare interface Props_15 {
+declare interface Props_14 {
     trigger?: ReactNode;
     children: ReactNode;
     rootProps?: ComponentPropsWithoutRef<typeof PopoverRoot>;
@@ -1196,12 +1174,12 @@ declare interface Props_15 {
     offset?: ComponentPropsWithoutRef<typeof PopoverContent>["sideOffset"];
 }
 
-declare interface Props_16 extends ComponentPropsWithoutRef<typeof Slot> {
+declare interface Props_15 extends ComponentPropsWithoutRef<typeof Slot> {
     /** Si el componente está presente o no */
     when: ComponentProps<typeof Presence>["present"];
 }
 
-declare type Props_17<T> = {
+declare type Props_16<T> = {
     data: T[];
     columns: ColumnDef<T>[];
     onRowClick?: (row: T) => void;
@@ -1209,12 +1187,16 @@ declare type Props_17<T> = {
     selected?: (row: T) => boolean;
 } & ExtendedProps_2 & Omit<ComponentPropsWithoutRef<typeof TableRoot>, "data" | "selected" | "onDoubleClick">;
 
-declare type Props_18 = {
+declare type Props_17 = {
     setPageSize?: (value: PageSize) => void;
     pageSize?: PageSize;
 } & Omit<usePaginationProps, "pageSize"> & TablePaginationExtendedProps;
 
-declare type Props_19 = ClosableProps | NonClosableProps;
+declare type Props_18 = ClosableProps | NonClosableProps;
+
+declare type Props_19<T extends TreeNode> = TreeRootProps & {
+    items: T[];
+};
 
 declare interface Props_2 extends HTMLProps<HTMLDivElement> {
     /**
@@ -1223,11 +1205,7 @@ declare interface Props_2 extends HTMLProps<HTMLDivElement> {
     src: string;
 }
 
-declare type Props_20<T extends TreeNode> = TreeRootProps & {
-    items: T[];
-};
-
-declare interface Props_21<T> extends UseAsyncOptions<T> {
+declare interface Props_20<T> extends UseAsyncOptions<T> {
     fn: () => Promise<T>;
     dependencies?: DependencyList;
 }
@@ -1441,7 +1419,7 @@ declare type Shortcut = Partial<{
     shortcutOptions: MenuShortcutProps_2["options"];
 }>;
 
-export declare const Show: ({ when, ...props }: Props_16) => JSX.Element;
+export declare const Show: ({ when, ...props }: Props_15) => JSX.Element;
 
 export declare type SingleDateValue = {
     value?: DateSingle;
@@ -1540,7 +1518,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_17<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_16<T>) => JSX.Element;
 
 export declare const TABLE_PAGE_SIZES: number[];
 
@@ -1568,7 +1546,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_18) => JSX.Element;
+export declare const TablePagination: ({ containerClassName, containerProps, selectClassName, selectProps, sizes, ...props }: Props_17) => JSX.Element;
 
 declare interface TablePaginationExtendedProps {
     containerClassName?: ClassName;
@@ -1623,7 +1601,7 @@ export declare interface TabTriggerProps extends Omit<HTMLProps<HTMLButtonElemen
     value: string;
 }
 
-export declare const Tag: ({ className, color, variant, rounded, icon, closable, onClose, children, ...props }: Props_19) => JSX.Element;
+export declare const Tag: ({ className, color, variant, rounded, icon, closable, onClose, children, ...props }: Props_18) => JSX.Element;
 
 export declare type TagVariant = VariantProps<typeof tagVariants>;
 
@@ -1830,7 +1808,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_20<T>): JSX.Element;
+export declare function Tree<T extends TreeNode>({ items, ...props }: Props_19<T>): JSX.Element;
 
 export declare const TreeItem: <T extends object>({ className, ...props }: OverrideProps<TreeItemProps<T>, {
     id: string | number;
@@ -1920,7 +1898,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_21<T>): AsyncState<T>;
+export declare function useAsync<T>({ fn, dependencies, onError, onSuccess, onFinish, }: Props_20<T>): AsyncState<T>;
 
 declare interface UseAsyncOptions<T> {
     onError?: (error: Error) => void;
@@ -1953,21 +1931,6 @@ export declare function useEventListener<K extends keyof HTMLElementEventMap, T
 
 export declare function useFocusTrap(active?: boolean): (instance: HTMLElement | null) => void;
 
-export declare function useForm<T extends FieldValues = FieldValues>(schema: z.ZodType<T>, options?: Partial<UseFormProps<T>>): UseFormReturn<T, any, T>;
-
-export declare const useFormField: () => {
-    invalid: boolean;
-    isDirty: boolean;
-    isTouched: boolean;
-    isValidating: boolean;
-    error?: FieldError_2;
-    id: string;
-    name: string;
-    formItemId: string;
-    formDescriptionId: string;
-    formMessageId: string;
-};
-
 export declare function useHotkey(keys: string | string[], handler: (event: KeyboardEvent) => void, options?: HotkeyOptions): RefObject<any>;
 
 export declare function useHover<T extends HTMLElement>(options?: UseHoverOptions): {