docthub-core-components 2.99.0 → 2.99.2

package/dist/src/components/overrides/ui/auto-complete.d.ts

@@ -38,7 +38,9 @@ interface AutocompleteProps<T> {
         value: string | number;
         text: string;
     };
+    /** Shown in the dropdown when the filtered option list is empty (includes freeSolo / multiple freeSolo). */
     noOptionsText?: string;
+    /** Alias for `noOptionsText` when you prefer "empty state" wording in consuming code. */
     emptyMessage?: string;
     className?: string;
     inputClassName?: string;

package/dist/src/components/overrides/ui/pickers/date-picker-field.d.ts

@@ -1,6 +1,16 @@
 import { DayPickerSingleProps } from 'react-day-picker';
 import * as React from "react";
 export type DateFormat = "MM/DD/YYYY" | "DD/MM/YYYY" | "YYYY-MM-DD" | "DD-MM-YYYY" | "DD MMM YYYY";
+/** Half-span for the calendar year dropdown: selectable years are `today ± CALENDAR_YEAR_HALF_SPAN` (inclusive), intersected with `minDate` / `maxDate` when set. */
+export declare const CALENDAR_YEAR_HALF_SPAN = 100;
+/**
+ * Effective min/max calendar years for the picker UI and manual validation,
+ * matching the year dropdown options.
+ */
+export declare function getEffectiveCalendarYearBounds(minDate?: Date, maxDate?: Date, now?: Date): {
+    minYear: number;
+    maxYear: number;
+};
 export interface DatePickerFieldProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect" | "onChange"> {
     label?: string;
     placeholder?: string;

package/dist/src/components/overrides/ui/pickers/date-range-picker-field.d.ts

@@ -23,6 +23,7 @@ export interface DateRangePickerFieldProps extends Omit<React.HTMLAttributes<HTM
     displayFormat?: string;
     inputClassName?: string;
     error?: string;
+    /** When set, shows days from adjacent months in each month grid (react-day-picker `showOutsideDays`). Overrides `dayPickerProps.showOutsideDays`. */
     showOutsideDays?: boolean;
     clearable?: boolean;
     month?: Date;

package/dist/src/components/overrides/ui/pickers/day-picker-bounds.d.ts

@@ -0,0 +1,21 @@
+import { DateRange, Matcher } from 'react-day-picker';
+/** First instant of the calendar month containing `date` (for `startMonth` / `endMonth`). */
+export declare function calendarMonthAnchor(date: Date): Date;
+/** Local midnight for the calendar day containing `date` (inclusive min bound for that whole day). */
+export declare function startOfDayLocal(date: Date): Date;
+/** Local end-of-day for the calendar day containing `date` (inclusive max bound for that whole day). */
+export declare function endOfDayLocal(date: Date): Date;
+/**
+ * `true` if `date` falls on a calendar day allowed by `minDate` / `maxDate` (ignores time-of-day on bounds).
+ * Use with calendar-year checks where needed.
+ */
+export declare function isDateWithinMinMaxLocalDay(date: Date, minDate?: Date, maxDate?: Date): boolean;
+/** Both ends of a range (when present) must sit within min/max calendar days. */
+export declare function isRangeWithinMinMaxLocalDay(range: DateRange | undefined, minDate?: Date, maxDate?: Date): boolean;
+/**
+ * Disabled-day matchers: days before `minDate`'s calendar day / after `maxDate`'s calendar day.
+ * Uses start/end of local day so `minDate={new Date()}` still allows today (cells use midnight).
+ */
+export declare function minMaxDisabledMatchers(minDate?: Date, maxDate?: Date): Matcher[];
+/** Combine min/max bounds with optional `disabled` matchers from `dayPickerProps`. */
+export declare function mergeDisabledMatchers(bounds: Matcher[], user?: Matcher | Matcher[]): Matcher | Matcher[] | undefined;

package/dist/src/components/ui/dialog.d.ts

@@ -39,22 +39,62 @@ type DialogContentProps = React.ComponentPropsWithoutRef<"div"> & {
     size?: keyof typeof sizeClasses;
     showCloseButton?: boolean;
     closeOnEscape?: boolean;
+    /**
+     * `insideScroll` — keeps the dialog within the viewport with a fixed header/footer; scroll the
+     * main body with `DialogScrollableBody` (matches Base UI “Inside scroll” dialog pattern).
+     *
+     * `outsideScroll` — `Dialog.Viewport` is the scroll container; the popup can extend past the
+     * bottom edge and the user scrolls the overlay layer (Base UI “Outside scroll” dialog pattern).
+     */
+    layout?: "default" | "insideScroll" | "outsideScroll";
 };
 declare const DialogContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
     closeOnOutsideClick?: boolean;
     size?: keyof typeof sizeClasses;
     showCloseButton?: boolean;
     closeOnEscape?: boolean;
+    /**
+     * `insideScroll` — keeps the dialog within the viewport with a fixed header/footer; scroll the
+     * main body with `DialogScrollableBody` (matches Base UI “Inside scroll” dialog pattern).
+     *
+     * `outsideScroll` — `Dialog.Viewport` is the scroll container; the popup can extend past the
+     * bottom edge and the user scrolls the overlay layer (Base UI “Outside scroll” dialog pattern).
+     */
+    layout?: "default" | "insideScroll" | "outsideScroll";
 } & React.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
     ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
-declare const DialogFooter: {
-    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
+type DialogFooterProps = React.ComponentPropsWithoutRef<"div"> & {
+    /**
+     * Renders an inset top border (`mx-6`, same gutter as content); padding sits below the line so
+     * actions do not touch the divider (use with `layout="insideScroll"`).
+     */
+    withTopBorder?: boolean;
 };
+declare const DialogFooter: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    /**
+     * Renders an inset top border (`mx-6`, same gutter as content); padding sits below the line so
+     * actions do not touch the divider (use with `layout="insideScroll"`).
+     */
+    withTopBorder?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+type DialogScrollableBodyProps = React.ComponentPropsWithoutRef<"div"> & {
+    /**
+     * Renders an inset top border (`mx-6`, same gutter as content); scroll padding lives in the
+     * scroller below the line (use with `layout="insideScroll"`).
+     */
+    withTopBorder?: boolean;
+};
+declare const DialogScrollableBody: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    /**
+     * Renders an inset top border (`mx-6`, same gutter as content); scroll padding lives in the
+     * scroller below the line (use with `layout="insideScroll"`).
+     */
+    withTopBorder?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
 declare const DialogTitle: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').AlertDialogTitleProps, "ref"> & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
 declare const DialogDescription: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').AlertDialogDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
-export type { DialogContentProps, DialogProps };
-export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };
+export type { DialogContentProps, DialogFooterProps, DialogProps, DialogScrollableBodyProps };
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogScrollableBody, DialogTitle, DialogTrigger, };

package/dist/src/components/ui/popover.d.ts

@@ -1,20 +1,36 @@
 import { Popover as BasePopover } from '@base-ui/react/popover';
 import * as React from "react";
 declare const Popover: typeof BasePopover.Root;
-interface PopoverTriggerProps extends React.ComponentPropsWithoutRef<"button"> {
+type PopoverTriggerProps = React.ComponentProps<typeof BasePopover.Trigger> & {
+    /**
+     * Renders the child with Base UI’s `render` prop (equivalent to `render={child}`).
+     * Prefer the Base UI `render` prop in new code — see
+     * [shadcn Popover (Base UI)](https://ui.shadcn.com/docs/components/base/popover).
+     */
     asChild?: boolean;
-    render?: React.ReactElement;
-}
-declare const PopoverTrigger: React.ForwardRefExoticComponent<PopoverTriggerProps & React.RefAttributes<HTMLButtonElement>>;
-declare const PopoverAnchor: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-interface PopoverContentProps extends React.ComponentPropsWithoutRef<"div"> {
-    sideOffset?: number;
-    side?: "top" | "bottom" | "left" | "right";
-    align?: "start" | "center" | "end";
-    /** When set, positions against this element instead of the trigger (see Base UI `Popover.Positioner`). */
-    anchor?: React.ComponentProps<typeof BasePopover.Positioner>["anchor"];
-    /** Controls collision behavior (e.g. disable perpendicular side fallback). */
-    collisionAvoidance?: React.ComponentProps<typeof BasePopover.Positioner>["collisionAvoidance"];
-}
-declare const PopoverContent: React.ForwardRefExoticComponent<PopoverContentProps & React.RefAttributes<HTMLDivElement>>;
-export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger };
+};
+declare const PopoverTrigger: React.ForwardRefExoticComponent<Omit<PopoverTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+type PopoverPositionerProps = React.ComponentPropsWithoutRef<typeof BasePopover.Positioner>;
+type PopoverPopupProps = React.ComponentPropsWithoutRef<typeof BasePopover.Popup>;
+type PositionerConfig = Pick<PopoverPositionerProps, "anchor" | "side" | "sideOffset" | "align" | "alignOffset" | "collisionBoundary" | "collisionPadding" | "sticky" | "positionMethod" | "arrowPadding" | "disableAnchorTracking" | "collisionAvoidance">;
+/**
+ * [Base UI Popover](https://base-ui.com/react/components/popover) `Portal` → `Positioner` + `Popup`.
+ * - Positioning/anchor options map to `Popover.Positioner` (and `className` on the popup maps to `Popover.Popup`).
+ * - `positionerClassName` is applied to `Positioner` (e.g. z-index); `className` styles the popover surface.
+ */
+export type PopoverContentProps = Omit<PopoverPopupProps, "ref"> & PositionerConfig & {
+    positionerClassName?: string;
+    keepMounted?: boolean;
+};
+declare const PopoverContent: React.ForwardRefExoticComponent<Omit<Omit<Omit<import('@base-ui/react').PopoverPopupProps, "ref"> & React.RefAttributes<HTMLDivElement>, "ref">, "ref"> & PositionerConfig & {
+    positionerClassName?: string;
+    keepMounted?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const PopoverTitle: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').PopoverTitleProps, "ref"> & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+declare const PopoverDescription: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').PopoverDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+declare const PopoverHeader: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const PopoverClose: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').PopoverCloseProps, "ref"> & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+declare const PopoverArrow: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').PopoverArrowProps, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const PopoverBackdrop: React.ForwardRefExoticComponent<Omit<Omit<import('@base-ui/react').PopoverBackdropProps, "ref"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const PopoverViewport: React.ForwardRefExoticComponent<Omit<BasePopover.Viewport.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export { Popover, PopoverArrow, PopoverBackdrop, PopoverClose, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, PopoverViewport, };

package/dist/src/components/ui/select.d.ts

@@ -52,6 +52,11 @@ declare const SelectTrigger: React.ForwardRefExoticComponent<SelectTriggerProps
 declare const SelectScrollUpButton: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const SelectScrollDownButton: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 interface SelectContentProps extends React.ComponentPropsWithoutRef<"div"> {
+    /**
+     * `popper` — anchor-based placement with Floating UI collision handling (side flip, shift).
+     * `item-aligned` — Base UI `alignItemWithTrigger`: selected item lines up with the trigger text
+     * (may use a different overflow strategy).
+     */
     position?: "item-aligned" | "popper";
 }
 declare const SelectContent: React.ForwardRefExoticComponent<SelectContentProps & React.RefAttributes<HTMLDivElement>>;

package/dist/src/components/ui/skeleton.d.ts

@@ -10,6 +10,11 @@ export interface SkeletonProps extends React.HTMLAttributes<HTMLDivElement> {
     width?: number | string;
     /** Height (CSS value or number for pixels) */
     height?: number | string;
+    /**
+     * When set, layout size is inferred from this content (hidden) while the skeleton overlay shows.
+     * Matches Material UI’s pattern for sizing circular placeholders to an avatar, etc.
+     */
+    children?: React.ReactNode;
 }
-declare function Skeleton({ className, variant, animation, width, height, style, ...props }: SkeletonProps): import("react/jsx-runtime").JSX.Element;
+declare function Skeleton({ className, variant, animation, width, height, style, children, ...props }: SkeletonProps): import("react/jsx-runtime").JSX.Element;
 export { Skeleton };

package/dist/src/components/ui/textarea.d.ts

@@ -5,7 +5,6 @@ export interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextArea
     errorText?: string;
     error?: string;
     required?: boolean;
-    resize?: "none" | "vertical" | "horizontal" | "both";
     showCharCount?: boolean;
     characterLimit?: number;
     onValueChange?: (value: string) => void;

package/dist/src/components/ui/toast.d.ts

@@ -1,10 +1,12 @@
 import { ToasterProps as SonnerToasterProps } from 'sonner';
 import type * as React from "react";
-export type ToastVariant = "error" | "info" | "warning" | "success";
+export type ToastVariant = "default" | "error" | "info" | "success" | "warning";
 export type ToastPosition = "top-right" | "top-center" | "top-left" | "bottom-right" | "bottom-center" | "bottom-left";
 export interface ToastOptions {
     description?: string;
     variant?: ToastVariant;
+    /** Viewport position; overrides `<Toaster position />` for this toast. */
+    position?: ToastPosition;
     action?: {
         label: string;
         onClick: () => void;
@@ -13,8 +15,16 @@ export interface ToastOptions {
     icon?: React.ReactNode;
     iconPosition?: "left" | "right";
 }
-export declare const toast: (message: string, options?: ToastOptions) => string | number;
+type ToastId = string | number;
+export declare const toast: ((message: string, options?: ToastOptions) => ToastId) & {
+    default: (message: string, options?: Omit<ToastOptions, "variant">) => ToastId;
+    success: (message: string, options?: Omit<ToastOptions, "variant">) => ToastId;
+    info: (message: string, options?: Omit<ToastOptions, "variant">) => ToastId;
+    warning: (message: string, options?: Omit<ToastOptions, "variant">) => ToastId;
+    error: (message: string, options?: Omit<ToastOptions, "variant">) => ToastId;
+};
 export interface ToasterProps extends Omit<SonnerToasterProps, "position"> {
     position?: ToastPosition;
 }
 export declare function Toaster(props: ToasterProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/index.d.ts

@@ -30,17 +30,19 @@ export { Calendar as DoctCalendar, CalendarDayButton } from './components/ui/cal
 export { Checkbox as DoctCheckbox } from './components/ui/checkbox';
 export { Collapsible as DoctCollapsible, CollapsibleContent as DoctCollapsibleContent, CollapsibleTrigger as DoctCollapsibleTrigger, } from './components/ui/collapsible';
 export { Command as DoctCommand, CommandDialog as DoctCommandDialog, CommandEmpty as DoctCommandEmpty, CommandGroup as DoctCommandGroup, CommandInput as DoctCommandInput, CommandItem as DoctCommandItem, CommandList as DoctCommandList, CommandSeparator as DoctCommandSeparator, CommandShortcut as DoctCommandShortcut, } from './components/ui/command';
-export { Dialog as DoctDialog, DialogClose as DoctDialogClose, DialogContent as DoctDialogContent, DialogDescription as DoctDialogDescription, DialogFooter as DoctDialogFooter, DialogHeader as DoctDialogHeader, DialogTitle as DoctDialogTitle, DialogTrigger as DoctDialogTrigger, } from './components/ui/dialog';
+export { Dialog as DoctDialog, DialogClose as DoctDialogClose, DialogContent as DoctDialogContent, DialogDescription as DoctDialogDescription, DialogFooter as DoctDialogFooter, DialogHeader as DoctDialogHeader, DialogScrollableBody as DoctDialogScrollableBody, DialogTitle as DoctDialogTitle, DialogTrigger as DoctDialogTrigger, } from './components/ui/dialog';
 export { Drawer as DoctDrawer, DrawerClose as DoctDrawerClose, DrawerContent as DoctDrawerContent, DrawerDescription as DoctDrawerDescription, DrawerFooter as DoctDrawerFooter, DrawerHeader as DoctDrawerHeader, DrawerTitle as DoctDrawerTitle, DrawerTrigger as DoctDrawerTrigger, } from './components/ui/drawer';
 export { DropdownMenu as DoctDropdownMenu, DropdownMenuCheckboxItem as DoctDropdownMenuCheckboxItem, DropdownMenuContent as DoctDropdownMenuContent, DropdownMenuGroup as DoctDropdownMenuGroup, DropdownMenuItem as DoctDropdownMenuItem, DropdownMenuLabel as DoctDropdownMenuLabel, DropdownMenuRadioGroup as DoctDropdownMenuRadioGroup, DropdownMenuRadioItem as DoctDropdownMenuRadioItem, DropdownMenuSeparator as DoctDropdownMenuSeparator, DropdownMenuShortcut as DoctDropdownMenuShortcut, DropdownMenuSub as DoctDropdownMenuSub, DropdownMenuSubContent as DoctDropdownMenuSubContent, DropdownMenuSubTrigger as DoctDropdownMenuSubTrigger, DropdownMenuTrigger as DoctDropdownMenuTrigger, } from './components/ui/dropdown-menu';
 export { Input as DoctInput, type InputProps } from './components/ui/input';
 export { Label as DoctLabel } from './components/ui/label';
-export { Popover as DoctPopover, PopoverContent as DoctPopoverContent, PopoverTrigger as DoctPopoverTrigger, } from './components/ui/popover';
+export type { PopoverContentProps } from './components/ui/popover';
+export { Popover as DoctPopover, PopoverArrow as DoctPopoverArrow, PopoverBackdrop as DoctPopoverBackdrop, PopoverClose as DoctPopoverClose, PopoverContent as DoctPopoverContent, PopoverDescription as DoctPopoverDescription, PopoverHeader as DoctPopoverHeader, PopoverTitle as DoctPopoverTitle, PopoverTrigger as DoctPopoverTrigger, PopoverViewport as DoctPopoverViewport, } from './components/ui/popover';
 export { Progress as DoctProgress } from './components/ui/progress';
 export { RadioGroup as DoctRadioGroup, RadioGroupItem as DoctRadioGroupItem, } from './components/ui/radio-group';
 export { Skeleton as DoctSkeleton } from './components/ui/skeleton';
 export { Tabs as DoctTabs, Tabs as DoctCustomTabs, TabsContent as DoctTabsContent, TabsContent as DoctCustomTabsContent, TabsList as DoctTabsList, TabsList as DoctCustomTabsList, TabsTrigger as DoctTabsTrigger, TabsTrigger as DoctCustomTabsTrigger, } from './components/ui/tabs';
-export { Toaster as DoctToaster, toast as DoctToast, } from './components/ui/toast';
+export type { ToastOptions, ToastPosition, ToastVariant } from './components/ui/toast';
+export { Toaster as DoctToaster, toast as DoctToast } from './components/ui/toast';
 export { Tooltip as DoctTooltip, TooltipContent as DoctTooltipContent, TooltipProvider as DoctTooltipProvider, TooltipTrigger as DoctTooltipTrigger, } from './components/ui/tooltip';
 export { useAutocompleteCheckbox } from './hooks/useAutocompleteCheckbox';
 export { DoctFooter, type DoctFooterProps, type FooterAppLink, type FooterBrand, type FooterColumn, type FooterLink, type FooterSection, type FooterSocialLink, } from './components/overrides/ui/footer';