@particle-academy/react-fancy 1.6.1 → 1.7.0

package/dist/index.d.cts

@@ -114,10 +114,28 @@ interface TextareaProps extends InputBaseProps, InputAffixProps, Omit<TextareaHT
 
 declare const Textarea: react.ForwardRefExoticComponent<TextareaProps & react.RefAttributes<HTMLTextAreaElement>>;
 
-interface SelectProps extends InputBaseProps, InputAffixProps, Omit<SelectHTMLAttributes<HTMLSelectElement>, "size" | "prefix"> {
+interface SelectProps extends InputBaseProps, InputAffixProps, Omit<SelectHTMLAttributes<HTMLSelectElement>, "size" | "prefix" | "multiple"> {
+    /** Options list — strings or objects with value/label */
     list: InputOption[] | InputOptionGroup[];
     placeholder?: string;
+    /** Callback for single-select value changes */
     onValueChange?: (value: string) => void;
+    /** Layout variant. "native" uses <select>, "listbox" uses a custom dropdown. Default: "native" */
+    variant?: "native" | "listbox";
+    /** Enable multi-select (listbox variant only) */
+    multiple?: boolean;
+    /** Controlled multi-select value */
+    values?: string[];
+    /** Default multi-select value (uncontrolled) */
+    defaultValues?: string[];
+    /** Callback for multi-select value changes */
+    onValuesChange?: (values: string[]) => void;
+    /** Enable search/filter within the dropdown (listbox variant only) */
+    searchable?: boolean;
+    /** Suffix for the selected count display. Default: "selected" */
+    selectedSuffix?: string;
+    /** Selection indicator style. Default: "check" */
+    indicator?: "check" | "checkbox";
 }
 
 declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLSelectElement>>;
@@ -654,16 +672,31 @@ interface PopoverContextValue {
     open: boolean;
     setOpen: (open: boolean) => void;
     anchorRef: React.RefObject<HTMLElement | null>;
+    floatingRef: React.RefObject<HTMLDivElement | null>;
     placement: Placement;
     offset: number;
+    hover: boolean;
+    onHoverEnter: () => void;
+    onHoverLeave: () => void;
 }
 interface PopoverProps {
     children: ReactNode;
+    /** Controlled open state */
     open?: boolean;
+    /** Default open state (uncontrolled) */
     defaultOpen?: boolean;
+    /** Callback when open state changes */
     onOpenChange?: (open: boolean) => void;
+    /** Placement of the popover relative to the trigger */
     placement?: Placement;
+    /** Pixel offset from the trigger */
     offset?: number;
+    /** Open on hover instead of click */
+    hover?: boolean;
+    /** Delay in ms before opening on hover. Default: 200 */
+    hoverDelay?: number;
+    /** Delay in ms before closing after hover leaves. Default: 300 */
+    hoverCloseDelay?: number;
 }
 interface PopoverTriggerProps {
     children: ReactNode;
@@ -674,7 +707,7 @@ interface PopoverContentProps {
     className?: string;
 }
 
-declare function PopoverTrigger({ children }: PopoverTriggerProps): ReactElement<Record<string, unknown>, string | react.JSXElementConstructor<any>>;
+declare function PopoverTrigger({ children, className }: PopoverTriggerProps): react_jsx_runtime.JSX.Element;
 declare namespace PopoverTrigger {
     var displayName: string;
 }
@@ -684,7 +717,7 @@ declare namespace PopoverContent {
     var displayName: string;
 }
 
-declare function PopoverRoot({ children, open: controlledOpen, defaultOpen, onOpenChange, placement, offset, }: PopoverProps): react_jsx_runtime.JSX.Element;
+declare function PopoverRoot({ children, open: controlledOpen, defaultOpen, onOpenChange, placement, offset, hover, hoverDelay, hoverCloseDelay, }: PopoverProps): react_jsx_runtime.JSX.Element;
 declare const Popover: typeof PopoverRoot & {
     Trigger: typeof PopoverTrigger;
     Content: typeof PopoverContent;

package/dist/index.d.ts

@@ -114,10 +114,28 @@ interface TextareaProps extends InputBaseProps, InputAffixProps, Omit<TextareaHT
 
 declare const Textarea: react.ForwardRefExoticComponent<TextareaProps & react.RefAttributes<HTMLTextAreaElement>>;
 
-interface SelectProps extends InputBaseProps, InputAffixProps, Omit<SelectHTMLAttributes<HTMLSelectElement>, "size" | "prefix"> {
+interface SelectProps extends InputBaseProps, InputAffixProps, Omit<SelectHTMLAttributes<HTMLSelectElement>, "size" | "prefix" | "multiple"> {
+    /** Options list — strings or objects with value/label */
     list: InputOption[] | InputOptionGroup[];
     placeholder?: string;
+    /** Callback for single-select value changes */
     onValueChange?: (value: string) => void;
+    /** Layout variant. "native" uses <select>, "listbox" uses a custom dropdown. Default: "native" */
+    variant?: "native" | "listbox";
+    /** Enable multi-select (listbox variant only) */
+    multiple?: boolean;
+    /** Controlled multi-select value */
+    values?: string[];
+    /** Default multi-select value (uncontrolled) */
+    defaultValues?: string[];
+    /** Callback for multi-select value changes */
+    onValuesChange?: (values: string[]) => void;
+    /** Enable search/filter within the dropdown (listbox variant only) */
+    searchable?: boolean;
+    /** Suffix for the selected count display. Default: "selected" */
+    selectedSuffix?: string;
+    /** Selection indicator style. Default: "check" */
+    indicator?: "check" | "checkbox";
 }
 
 declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLSelectElement>>;
@@ -654,16 +672,31 @@ interface PopoverContextValue {
     open: boolean;
     setOpen: (open: boolean) => void;
     anchorRef: React.RefObject<HTMLElement | null>;
+    floatingRef: React.RefObject<HTMLDivElement | null>;
     placement: Placement;
     offset: number;
+    hover: boolean;
+    onHoverEnter: () => void;
+    onHoverLeave: () => void;
 }
 interface PopoverProps {
     children: ReactNode;
+    /** Controlled open state */
     open?: boolean;
+    /** Default open state (uncontrolled) */
     defaultOpen?: boolean;
+    /** Callback when open state changes */
     onOpenChange?: (open: boolean) => void;
+    /** Placement of the popover relative to the trigger */
     placement?: Placement;
+    /** Pixel offset from the trigger */
     offset?: number;
+    /** Open on hover instead of click */
+    hover?: boolean;
+    /** Delay in ms before opening on hover. Default: 200 */
+    hoverDelay?: number;
+    /** Delay in ms before closing after hover leaves. Default: 300 */
+    hoverCloseDelay?: number;
 }
 interface PopoverTriggerProps {
     children: ReactNode;
@@ -674,7 +707,7 @@ interface PopoverContentProps {
     className?: string;
 }
 
-declare function PopoverTrigger({ children }: PopoverTriggerProps): ReactElement<Record<string, unknown>, string | react.JSXElementConstructor<any>>;
+declare function PopoverTrigger({ children, className }: PopoverTriggerProps): react_jsx_runtime.JSX.Element;
 declare namespace PopoverTrigger {
     var displayName: string;
 }
@@ -684,7 +717,7 @@ declare namespace PopoverContent {
     var displayName: string;
 }
 
-declare function PopoverRoot({ children, open: controlledOpen, defaultOpen, onOpenChange, placement, offset, }: PopoverProps): react_jsx_runtime.JSX.Element;
+declare function PopoverRoot({ children, open: controlledOpen, defaultOpen, onOpenChange, placement, offset, hover, hoverDelay, hoverCloseDelay, }: PopoverProps): react_jsx_runtime.JSX.Element;
 declare const Popover: typeof PopoverRoot & {
     Trigger: typeof PopoverTrigger;
     Content: typeof PopoverContent;