@boxcustodia/library 2.0.0-alpha.4 → 2.0.0-alpha.6

package/dist/index.d.ts

@@ -14,8 +14,8 @@ import { ControllerRenderProps } from 'react-hook-form';
 import { CSSProperties } from 'react';
 import { default as default_2 } from 'react';
 import { DependencyList } from 'react';
-import * as DialogPrimitive from '@radix-ui/react-dialog';
-import { DialogProps } from '@radix-ui/react-dialog';
+import { Dialog as DialogPrimitive } from '@base-ui/react/dialog';
+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';
@@ -161,7 +161,7 @@ export declare const AutoComplete: ({ items, placeholder, emptyMessage, onSelect
 
 export declare const AutoCompleteDialog: ({ children, ...props }: AutoCompleteDialogProps) => JSX.Element;
 
-declare interface AutoCompleteDialogProps extends DialogProps {
+declare interface AutoCompleteDialogProps extends DialogProps_2 {
 }
 
 export declare const AutoCompleteEmpty: (props: React_2.ComponentProps<typeof Command.Empty>) => JSX.Element;
@@ -416,34 +416,94 @@ declare type DayProps = {
     navigationDate: Date;
 } & HTMLProps<HTMLButtonElement>;
 
-export declare const Dialog: ({ trigger, title, description, children, footer, focus, triggerProps, headerProps, headerClassName, titleProps, titleClassName, descriptionProps, descriptionClassName, contentProps, contentClassName, footerProps, footerClassName, ...props }: Props_8) => JSX.Element;
+/**
+ * General-purpose dialog with optional trigger, title, description, body, and footer.
+ *
+ * The `trigger` prop uses Base UI's `render` prop — no wrapper element is added —
+ * making it composable with `<Tooltip>` at the primitive level.
+ * For full structural control, use the exported primitives directly.
+ *
+ * @example
+ * ```tsx
+ * <Dialog
+ *   trigger={<Button>Open settings</Button>}
+ *   title="Settings"
+ *   description="Manage your account preferences."
+ *   footer={<Button onClick={handleSave}>Save</Button>}
+ * >
+ *   <SettingsForm />
+ * </Dialog>
+ * ```
+ */
+export declare function Dialog({ trigger, title, description, children, footer, onClose, hideClose, closeProps, portalProps, className, onOpenChange, ...props }: DialogProps): JSX.Element;
 
-export declare const DialogClose: ({ ...props }: React_2.ComponentProps<typeof DialogPrimitive.Close>) => JSX.Element;
+/** Semi-transparent overlay rendered behind the popup. */
+export declare function DialogBackdrop({ className, ...props }: DialogPrimitive.Backdrop.Props): JSX.Element;
 
-export declare const DialogContent: ({ className, children, focus, hideClose, ...props }: React_2.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
-    focus?: boolean;
-    hideClose?: boolean;
-}) => JSX.Element;
+/** Closes the dialog and merges an optional `onClick` into the `render` element. */
+export declare function DialogClose({ className, ...props }: DialogPrimitive.Close.Props): JSX.Element;
 
-export declare const DialogDescription: ({ className, ...props }: React_2.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>) => JSX.Element;
+/** Supplementary description rendered below the title. */
+export declare function DialogDescription({ className, ...props }: DialogPrimitive.Description.Props): JSX.Element;
 
-export declare const DialogFooter: ({ className, ...props }: React_2.HTMLAttributes<HTMLDivElement>) => JSX.Element;
+/** Layout wrapper for action buttons. */
+export declare function DialogFooter({ className, ...props }: HTMLAttributes<HTMLDivElement>): JSX.Element;
 
-export declare const DialogHeader: ({ className, ...props }: React_2.HTMLAttributes<HTMLDivElement>) => JSX.Element;
+/** Layout wrapper for title and description. */
+export declare function DialogHeader({ className, ...props }: HTMLAttributes<HTMLDivElement>): JSX.Element;
 
-export declare const DialogOverlay: ({ className, ...props }: React_2.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>) => JSX.Element;
+/**
+ * Dialog content container. Includes Portal, Backdrop and Viewport internally.
+ * Pass `portalProps` to configure the portal (e.g. a custom `container`).
+ * Pass `closeProps` to customise the close button.
+ */
+export declare function DialogPopup({ className, children, hideClose, closeProps, portalProps, ...props }: DialogPrimitive.Popup.Props & {
+    hideClose?: boolean;
+    closeProps?: DialogPrimitive.Close.Props;
+    portalProps?: DialogPrimitive.Portal.Props;
+}): JSX.Element;
 
-export declare const DialogPortal: ({ ...props }: React_2.ComponentProps<typeof DialogPrimitive.Portal>) => JSX.Element;
+export { DialogPrimitive }
 
-export declare const DialogRoot: ({ onClose, ...props }: React_2.ComponentProps<typeof DialogPrimitive.Root> & {
-    onClose?: () => any;
-}) => JSX.Element;
+export declare type DialogProps = Omit<DialogPrimitive.Root.Props, "children"> & {
+    /** Element that opens the dialog on click. Passed as Base UI `render` prop — no DOM wrapper added. */
+    trigger?: ReactElement;
+    /** Dialog heading. */
+    title?: ReactNode;
+    /** Supporting text rendered below the title. */
+    description?: ReactNode;
+    /** Body content rendered between the description and the footer. */
+    children?: ReactNode;
+    /** Content rendered inside the footer wrapper. */
+    footer?: ReactNode;
+    /** Called when the dialog closes. */
+    onClose?: () => void;
+    /** Hides the close (×) button inside the popup. */
+    hideClose?: boolean;
+    /** Props forwarded to the close button primitive. */
+    closeProps?: DialogPrimitive.Close.Props;
+    /** Props forwarded to the portal. */
+    portalProps?: DialogPrimitive.Portal.Props;
+    /** Additional className forwarded to the popup panel. */
+    className?: string;
+};
 
-export declare const DialogTitle: ({ className, ...props }: React_2.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>) => JSX.Element;
+/** Context root. Holds open state and wraps all dialog parts. */
+export declare function DialogRoot(props: DialogPrimitive.Root.Props): JSX.Element;
 
-export declare const DialogTrigger: ({ ...props }: React_2.ComponentProps<typeof DialogPrimitive.Trigger>) => JSX.Element;
+/** Accessible title rendered as `<h2>`. Required for a11y. */
+export declare function DialogTitle({ className, ...props }: DialogPrimitive.Title.Props): JSX.Element;
 
-export declare const Divider: (props: Props_9) => JSX.Element;
+/**
+ * Renders as its `render` element (defaults to `<button>`).
+ * Composes cleanly with `<Tooltip>` and other Base UI triggers on the same DOM element.
+ */
+export declare function DialogTrigger({ className, ...props }: DialogPrimitive.Trigger.Props): JSX.Element;
+
+/** Full-screen container that centers the popup. */
+export declare function DialogViewport({ className, ...props }: DialogPrimitive.Viewport.Props): JSX.Element;
+
+export declare const Divider: (props: Props_8) => JSX.Element;
 
 export declare const DOTS = "...";
 
@@ -520,7 +580,7 @@ export declare type DropzoneProps = {
     onError?: (fileErrors: FileError[]) => void;
 } & Omit<ComponentPropsWithoutRef<"div">, "onDrop" | "onError">;
 
-export declare const EmptyState: ({ icon, title, description, className, children, ...props }: Props_10) => JSX.Element;
+export declare const EmptyState: ({ icon, title, description, className, children, ...props }: Props_9) => JSX.Element;
 
 export declare const ensureReactElement: <P>({ children, as: Wrapper, props, }: EnsureReactElementProps<P>) => ReactElement;
 
@@ -548,20 +608,6 @@ declare interface ExtendedProps {
 }
 
 declare interface ExtendedProps_2 {
-    triggerProps?: ComponentPropsWithoutRef<typeof DialogTrigger>;
-    headerProps?: ComponentPropsWithoutRef<typeof DialogHeader>;
-    headerClassName?: ClassName;
-    titleProps?: ComponentPropsWithoutRef<typeof DialogTitle>;
-    titleClassName?: ClassName;
-    descriptionProps?: ComponentPropsWithoutRef<typeof DialogDescription>;
-    descriptionClassName?: ClassName;
-    contentProps?: ComponentPropsWithoutRef<typeof DialogContent>;
-    contentClassName?: ClassName;
-    footerProps?: ComponentPropsWithoutRef<typeof DialogFooter>;
-    footerClassName?: ClassName;
-}
-
-declare interface ExtendedProps_3 {
     theadClassName?: ClassName;
     theadProps?: HTMLProps<HTMLTableSectionElement>;
     tbodyClassName?: ClassName;
@@ -581,7 +627,7 @@ declare interface ExtendedProps_3 {
  */
 export declare const extractInitials: (string: string) => string;
 
-export declare const Field: ({ label, labelClassName, labelProps, error, errorClassName, errorProps, children, className, ...props }: Props_11) => JSX.Element;
+export declare const Field: ({ label, labelClassName, labelProps, error, errorClassName, errorProps, children, className, ...props }: Props_10) => JSX.Element;
 
 declare type FileError = {
     file: File;
@@ -621,7 +667,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_12<TFieldValues>) => JSX.Element;
+export declare const Form: <TFieldValues extends FieldValues = FieldValues>({ onSubmit, id, form, children, className, }: Props_11<TFieldValues>) => JSX.Element;
 
 export declare const FormControl: ({ className, ...props }: React_2.ComponentProps<typeof Slot>) => JSX.Element;
 
@@ -664,7 +710,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_13<C>) => JSX.Element;
+export declare const Heading: <C extends React.ElementType = "h2">({ className, size, weight, as, ...props }: Props_12<C>) => JSX.Element;
 
 declare const HeadingVariants: (props?: ({
     size?: "sm" | "lg" | "md" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | null | undefined;
@@ -682,7 +728,7 @@ declare type HotkeyOptions = {
 
 export declare type ID = string | number;
 
-export declare const Input: ({ value: prop, onChange, defaultValue: defaultProp, ...rest }: Props_14) => JSX.Element;
+export declare const Input: ({ value: prop, onChange, defaultValue: defaultProp, ...rest }: Props_13) => JSX.Element;
 
 declare interface ItemTimeline {
     content?: ReactNode;
@@ -731,7 +777,7 @@ export declare type LibraryProviderProps = {
     tooltipDelay?: ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>["delay"];
 } & Omit<ToastProviderProps, "children">;
 
-export declare const Loader: ({ center, containerClassName, variant, size, ...props }: Props_15) => JSX.Element;
+export declare const Loader: ({ center, containerClassName, variant, size, ...props }: Props_14) => JSX.Element;
 
 declare type LoaderVariants = VariantProps<typeof loaderVariants>;
 
@@ -922,7 +968,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_16) => JSX.Element;
+export declare const NumberInput: ({ value: prop, onChange, defaultValue: defaultProp, className, min, max, ...props }: Props_15) => JSX.Element;
 
 declare type OpenProps = {
     open?: boolean;
@@ -941,15 +987,15 @@ 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_17) => JSX.Element;
+export declare const Pagination: ({ optionProps, className, containerProps, ...rangeProps }: Props_16) => JSX.Element;
 
 declare interface PaginationOptionProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     isActive?: boolean;
 }
 
-export declare const Password: ({ className, containerClassName, showIcon, hideIcon, onShow, onHide, toggleable, ...rest }: Props_18) => JSX.Element;
+export declare const Password: ({ className, containerClassName, showIcon, hideIcon, onShow, onHide, toggleable, ...rest }: Props_17) => JSX.Element;
 
-export declare const Popover: (props: Props_19) => JSX.Element;
+export declare const Popover: (props: Props_18) => JSX.Element;
 
 export declare const PopoverContent: ({ className, align, sideOffset, matchTriggerWidth, style, focus, ...props }: PopoverContentProps) => JSX.Element;
 
@@ -998,13 +1044,7 @@ declare interface Props extends ExtendedProps {
     onSelect?: (value: AutoCompleteItem["value"], item: AutoCompleteItem) => any;
 }
 
-declare type Props_10 = ComponentPropsWithoutRef<"div"> & {
-    icon?: ReactNode;
-    title?: ReactNode;
-    description?: ReactNode;
-};
-
-declare interface Props_11 extends ComponentProps<"div"> {
+declare interface Props_10 extends ComponentProps<"div"> {
     label?: ReactNode;
     labelClassName?: string;
     labelProps?: ComponentPropsWithoutRef<"label">;
@@ -1013,7 +1053,7 @@ declare interface Props_11 extends ComponentProps<"div"> {
     errorProps?: ComponentPropsWithoutRef<"p">;
 }
 
-declare type Props_12<TFieldValues extends FieldValues> = {
+declare type Props_11<TFieldValues extends FieldValues> = {
     onSubmit: (data: TFieldValues) => void;
     form: UseFormReturn<TFieldValues, any, any>;
     children: React_2.ReactNode;
@@ -1021,11 +1061,11 @@ declare type Props_12<TFieldValues extends FieldValues> = {
     id?: string;
 };
 
-declare type Props_13<C extends React.ElementType> = VariantProps<typeof HeadingVariants> & {
+declare type Props_12<C extends React.ElementType> = VariantProps<typeof HeadingVariants> & {
     as?: C;
 } & Omit<React.ComponentPropsWithoutRef<C>, "as">;
 
-declare type Props_14 = OverrideProps<ComponentProps<"input">, {
+declare type Props_13 = OverrideProps<ComponentProps<"input">, {
     /** valor del input */
     value?: string;
     /** functión a ejecutar cuando el valor cambia */
@@ -1034,12 +1074,12 @@ declare type Props_14 = OverrideProps<ComponentProps<"input">, {
     defaultValue?: string;
 }>;
 
-declare type Props_15 = LucideProps & LoaderVariants & {
+declare type Props_14 = LucideProps & LoaderVariants & {
     center?: boolean;
     containerClassName?: string;
 };
 
-declare type Props_16 = OverrideProps<ComponentProps<"input">, {
+declare type Props_15 = OverrideProps<ComponentProps<"input">, {
     /** valor del input */
     value?: number;
     /** functión a ejecutar cuando el valor cambia */
@@ -1052,13 +1092,13 @@ declare type Props_16 = OverrideProps<ComponentProps<"input">, {
     max?: number;
 }>;
 
-declare interface Props_17 extends useRangePaginationProps {
+declare interface Props_16 extends useRangePaginationProps {
     optionProps?: PaginationOptionProps;
     className?: string;
     containerProps?: HTMLProps<HTMLDivElement>;
 }
 
-declare type Props_18 = OverrideProps<ComponentProps<typeof Input>, {
+declare type Props_17 = OverrideProps<ComponentProps<typeof Input>, {
     /** Clase CSS para el contenedor */
     containerClassName?: string;
     /** Ícono para mostrar la contraseña */
@@ -1073,7 +1113,7 @@ declare type Props_18 = OverrideProps<ComponentProps<typeof Input>, {
     toggleable?: boolean;
 }>;
 
-declare interface Props_19 {
+declare interface Props_18 {
     trigger?: ReactNode;
     children: ReactNode;
     rootProps?: ComponentPropsWithoutRef<typeof PopoverRoot>;
@@ -1087,6 +1127,11 @@ declare interface Props_19 {
     offset?: ComponentPropsWithoutRef<typeof PopoverContent>["sideOffset"];
 }
 
+declare interface Props_19 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
@@ -1094,31 +1139,26 @@ declare interface Props_2 extends HTMLProps<HTMLDivElement> {
     src: string;
 }
 
-declare interface Props_20 extends ComponentPropsWithoutRef<typeof Slot> {
-    /** Si el componente está presente o no */
-    when: ComponentProps<typeof Presence>["present"];
-}
-
-declare type Props_21<T> = {
+declare type Props_20<T> = {
     data: T[];
     columns: ColumnDef<T>[];
     onRowClick?: (row: T) => void;
     onDoubleClick?: (row: T) => void;
     selected?: (row: T) => boolean;
-} & ExtendedProps_3 & Omit<ComponentPropsWithoutRef<typeof TableRoot>, "data" | "selected" | "onDoubleClick">;
+} & ExtendedProps_2 & Omit<ComponentPropsWithoutRef<typeof TableRoot>, "data" | "selected" | "onDoubleClick">;
 
-declare type Props_22 = {
+declare type Props_21 = {
     setPageSize?: (value: PageSize) => void;
     pageSize?: PageSize;
 } & Omit<usePaginationProps, "pageSize"> & TablePaginationExtendedProps;
 
-declare type Props_23 = ClosableProps | NonClosableProps;
+declare type Props_22 = ClosableProps | NonClosableProps;
 
-declare type Props_24<T extends TreeNode> = TreeRootProps & {
+declare type Props_23<T extends TreeNode> = TreeRootProps & {
     items: T[];
 };
 
-declare interface Props_25<T> extends UseAsyncOptions<T> {
+declare interface Props_24<T> extends UseAsyncOptions<T> {
     fn: () => Promise<T>;
     dependencies?: DependencyList;
 }
@@ -1179,19 +1219,16 @@ declare type Props_7 = ComponentProps<"input"> & {
     renderFooter?: (props: DatePickerFooterProps) => ReactNode;
 };
 
-declare type Props_8 = ComponentPropsWithoutRef<typeof DialogRoot> & ExtendedProps_2 & {
-    trigger?: ReactNode;
+declare type Props_8 = {
+    orientation?: "horizontal" | "vertical";
+} & HTMLProps<HTMLHRElement>;
+
+declare type Props_9 = ComponentPropsWithoutRef<"div"> & {
+    icon?: ReactNode;
     title?: ReactNode;
     description?: ReactNode;
-    children: ReactNode;
-    footer?: ReactNode;
-    focus?: boolean;
 };
 
-declare type Props_9 = {
-    orientation?: "horizontal" | "vertical";
-} & HTMLProps<HTMLHRElement>;
-
 declare type PropsWithoutValue<T> = Omit<T, "value" | "onChange" | "defaultValue">;
 
 declare type ProviderProps = ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>;
@@ -1335,7 +1372,7 @@ declare type Shortcut = Partial<{
     shortcutOptions: MenuShortcutProps_2["options"];
 }>;
 
-export declare const Show: ({ when, ...props }: Props_20) => JSX.Element;
+export declare const Show: ({ when, ...props }: Props_19) => JSX.Element;
 
 export declare type SingleDateValue = {
     value?: DateSingle;
@@ -1432,7 +1469,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_21<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_20<T>) => JSX.Element;
 
 export declare const TABLE_PAGE_SIZES: number[];
 
@@ -1460,7 +1497,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_22) => JSX.Element;
+export declare const TablePagination: ({ containerClassName, containerProps, selectClassName, selectProps, sizes, ...props }: Props_21) => JSX.Element;
 
 declare interface TablePaginationExtendedProps {
     containerClassName?: ClassName;
@@ -1515,7 +1552,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_23) => JSX.Element;
+export declare const Tag: ({ className, color, variant, rounded, icon, closable, onClose, children, ...props }: Props_22) => JSX.Element;
 
 export declare type TagVariant = VariantProps<typeof tagVariants>;
 
@@ -1722,7 +1759,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_24<T>): JSX.Element;
+export declare function Tree<T extends TreeNode>({ items, ...props }: Props_23<T>): JSX.Element;
 
 export declare const TreeItem: <T extends object>({ className, ...props }: OverrideProps<TreeItemProps<T>, {
     id: string | number;
@@ -1812,7 +1849,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_25<T>): AsyncState<T>;
+export declare function useAsync<T>({ fn, dependencies, onError, onSuccess, onFinish, }: Props_24<T>): AsyncState<T>;
 
 declare interface UseAsyncOptions<T> {
     onError?: (error: Error) => void;