@geckoui/geckoui 1.2.0-beta.1 → 1.3.0

package/dist/index.d.mts

@@ -1,10 +1,8 @@
 import * as react from 'react';
-import react__default, { RefObject, InputHTMLAttributes, FC, ReactNode, JSX, ForwardedRef, LabelHTMLAttributes, PropsWithChildren, ButtonHTMLAttributes, DetailedHTMLProps, ReactElement, RefCallback, Dispatch, SetStateAction, HtmlHTMLAttributes, ChangeEvent, HTMLAttributes, JSXElementConstructor, SVGProps } from 'react';
+import react__default, { RefObject, InputHTMLAttributes, FC, ReactNode, JSX, ForwardedRef, LabelHTMLAttributes, PropsWithChildren, ButtonHTMLAttributes, DetailedHTMLProps, ReactElement, RefCallback, Dispatch, SetStateAction, HtmlHTMLAttributes, ChangeEvent, HTMLAttributes, SVGProps } from 'react';
 import { ControllerProps, Control, FieldValues, ControllerRenderProps, ControllerFieldState, UseFormStateReturn } from 'react-hook-form';
 import { Placement, Strategy, useFloating } from '@floating-ui/react';
 import { TextareaAutosizeProps } from 'react-textarea-autosize';
-import * as _headlessui_react from '@headlessui/react';
-import { SwitchProps as SwitchProps$1, MenuItemsProps as MenuItemsProps$1, MenuButtonProps as MenuButtonProps$1, MenuItemProps as MenuItemProps$1 } from '@headlessui/react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ToasterProps } from 'sonner';
 export { toast } from 'sonner';
@@ -1556,70 +1554,17 @@ interface RHFTextareaProps extends RHFBaseProps, Omit<TextareaProps, "name" | "o
  */
 declare const RHFTextarea: FC<RHFTextareaProps>;
 
-/** Extensible size map - To allow module augmentation */
 interface SwitchSizeMap {
     sm: unknown;
     md: unknown;
 }
-interface SwitchProps extends Omit<SwitchProps$1, "className"> {
-    /**
-     * The size of the switch.(default: 'md')
-     * */
+interface SwitchProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "onChange" | "size" | "type"> {
+    onChange?: (checked: boolean) => void;
     size?: keyof SwitchSizeMap;
-    /**
-     * Class name for the switch.
-     * */
-    className?: string;
-    /**
-     * Style for the thumb of the switch.
-     * */
     thumbClassName?: string;
 }
 
-/**
- * Switch is a toggle component built on HeadlessUI that provides an accessible
- * on/off control. It supports multiple sizes, controlled and uncontrolled modes,
- * and integrates seamlessly with forms.
- *
- * @example
- * Toggle feature in settings:
- *
- * ```tsx
- * const [notificationsEnabled, setNotificationsEnabled] = useState(true);
- *
- * <div className="flex items-center gap-3">
- *   <Switch
- *     checked={notificationsEnabled}
- *     onChange={setNotificationsEnabled}
- *     size="md"
- *   />
- *   <span>Enable email notifications</span>
- * </div>
- * ```
- *
- * @example
- * Uncontrolled with default value:
- *
- * ```tsx
- * <Switch defaultChecked={true} size="lg" />
- * ```
- *
- * @example
- * Custom styling and sizes:
- *
- * ```tsx
- * <Switch
- *   checked={darkMode}
- *   onChange={toggleDarkMode}
- *   size="sm"
- *   className="bg-blue-500 data-[checked]:bg-green-600"
- *   thumbClassName="shadow-lg"
- * />
- * ```
- *
- * @see https://headlessui.com/react/switch for advanced usage
- */
-declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<null>>;
+declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<HTMLInputElement>>;
 
 interface RHFSwitchProps extends RHFBaseProps, Omit<SwitchProps, "name" | "value"> {
     /**
@@ -2989,9 +2934,12 @@ interface TooltipProps extends PropsWithChildren {
      * */
     triggerClassName?: string;
     /**
-     * Whether consider the trigger as a child
-     * Use this to avoid invalid button nesting errors when using a button as the trigger
-     * If you use custom components as the trigger, you might need to wrap with `forwardRef`
+     * Classname to apply to the tooltip arrow
+     * */
+    arrowClassName?: string;
+    /**
+     * Whether to use the child element directly as the trigger.
+     * Use this to avoid invalid button nesting errors when using a button as the trigger.
      * */
     triggerAsChild?: boolean;
     /**
@@ -3001,60 +2949,13 @@ interface TooltipProps extends PropsWithChildren {
     /**
      * The side of the tooltip to display
      * */
-    side?: "top" | "right" | "bottom" | "left";
+    side?: Placement;
     /**
      * The offset of the tooltip from the trigger
      * */
     sideOffset?: number;
 }
 
-/**
- * Tooltip displays contextual information in a floating overlay when users hover over or focus on an element.
- * Built on Radix UI, it provides accessible tooltips with customizable positioning, delays, and styling.
- * Returns children unchanged if no content is provided.
- *
- * @example
- * Icon button with helpful hint:
- *
- * ```tsx
- * <Tooltip content="Add new item" side="right" delayDuration={300}>
- *   <button className="p-2">
- *     <PlusIcon />
- *   </button>
- * </Tooltip>
- * ```
- *
- * @example
- * Complex tooltip content:
- *
- * ```tsx
- * <Tooltip
- *   content={
- *     <div>
- *       <strong>Premium Feature</strong>
- *       <p>Upgrade to access this feature</p>
- *     </div>
- *   }
- *   backgroundColor="#1f2937"
- *   sideOffset={10}
- * >
- *   <LockIcon />
- * </Tooltip>
- * ```
- *
- * @example
- * Bottom-positioned with custom delay:
- *
- * ```tsx
- * <Tooltip
- *   content="Last updated: 2 hours ago"
- *   side="bottom"
- *   delayDuration={500}
- * >
- *   <span>Status: Active</span>
- * </Tooltip>
- * ```
- */
 declare const Tooltip: FC<TooltipProps>;
 
 /** Extensible variant map - To allow module augmentation */
@@ -3685,118 +3586,132 @@ declare namespace Drawer {
     var dismiss: () => void;
 }
 
-type ReactTag = keyof JSX.IntrinsicElements | JSXElementConstructor<any>;
-type MenuButtonProps<T extends ReactTag> = MenuButtonProps$1<T>;
-type MenuItemsProps<T extends ReactTag> = MenuItemsProps$1<T>;
-type MenuItemProps<T extends ReactTag> = MenuItemProps$1<T>;
+interface MenuProps extends PropsWithChildren {
+    /**
+     * Text label for the default menu button.
+     * If `MenuTrigger` is provided as a child, this is ignored.
+     */
+    label?: string;
+    /**
+     * Whether the menu is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Placement of the dropdown panel relative to the trigger.
+     * @default "bottom-start"
+     */
+    placement?: Placement;
+    /**
+     * Floating strategy for the dropdown panel
+     */
+    floatingStrategy?: Strategy;
+    /**
+     * Additional class name for the menu wrapper
+     */
+    className?: string;
+    /**
+     * Additional class name for the dropdown panel
+     */
+    menuClassName?: string;
+    /**
+     * Additional class name for the default menu button.
+     * Only applies when no `MenuTrigger` is provided.
+     */
+    buttonClassName?: string;
+}
+interface MenuContextProps {
+    open: boolean;
+    setOpen: Dispatch<SetStateAction<boolean>>;
+    floating: ReturnType<typeof useFloating>;
+    openMenu: () => void;
+    closeMenu: () => void;
+    toggleMenu: () => void;
+    disabled: boolean;
+    menuRef: RefObject<HTMLDivElement | null>;
+}
 
-/**
- * Menu is a styled wrapper around HeadlessUI's Menu for creating dropdown menus and action lists.
- * Provides pre-styled components for building accessible, keyboard-navigable menus.
- * @see https://headlessui.com/react/menu for complete API documentation
- */
-declare const Menu: _headlessui_react._internal_ComponentMenu & {
-    Button: _headlessui_react._internal_ComponentMenuButton;
-    Items: _headlessui_react._internal_ComponentMenuItems;
-    Item: _headlessui_react._internal_ComponentMenuItem;
-    Section: _headlessui_react._internal_ComponentMenuSection;
-    Heading: _headlessui_react._internal_ComponentMenuHeading;
-    Separator: _headlessui_react._internal_ComponentMenuSeparator;
+declare const Menu: {
+    ({ label, disabled, placement, floatingStrategy, className, menuClassName, buttonClassName, children }: MenuProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
 };
-/**
- * MenuButton triggers the menu dropdown when clicked or activated.
- * Supports polymorphic rendering via the `as` prop.
- * @see https://headlessui.com/react/menu for complete API documentation
- */
-declare const MenuButton: <T extends ReactTag>({ as, ...rest }: MenuButtonProps<T>) => react_jsx_runtime.JSX.Element;
-/**
- * MenuItems contains the dropdown panel with all menu options.
- * Automatically handles positioning, animations, and focus management.
- * @see https://headlessui.com/react/menu for complete API documentation
- */
-declare const MenuItems: <T extends ReactTag>({ as, ...rest }: MenuItemsProps<T>) => react_jsx_runtime.JSX.Element;
-/**
- * MenuItem represents an individual selectable option within the menu.
- * Receives active and disabled states for conditional styling.
- * @see https://headlessui.com/react/menu for complete API documentation
- */
-declare const MenuItem: <T extends ReactTag>({ children, as, ...rest }: MenuItemProps<T>) => react_jsx_runtime.JSX.Element;
-/**
- * MenuHeading displays a non-interactive header within menu sections.
- * @see https://headlessui.com/react/menu for complete API documentation
- */
-declare const MenuHeading: _headlessui_react._internal_ComponentMenuHeading;
-/**
- * MenuSection groups related menu items together under a heading.
- * @see https://headlessui.com/react/menu for complete API documentation
- */
-declare const MenuSection: _headlessui_react._internal_ComponentMenuSection;
-/**
- * MenuSeparator provides a visual divider between menu groups or items.
- * @see https://headlessui.com/react/menu for complete API documentation
- */
-declare const MenuSeparator: _headlessui_react._internal_ComponentMenuSeparator;
 
-type DropdownClassName<T> = string | ((item: T, index: number) => string | undefined);
-interface DropdownItem {
-    label: ReactNode | FC;
+interface MenuItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onClick"> {
+    /**
+     * Text label for the menu item.
+     * Used as the default rendered content if no `children` is provided.
+     */
+    label: string;
+    /**
+     * Whether the menu item is disabled
+     */
     disabled?: boolean;
+    /**
+     * Additional class name for the menu item
+     */
     className?: string;
+    /**
+     * Callback fired when the menu item is clicked.
+     * The menu will close automatically after the callback.
+     */
     onClick?: () => void;
+    /**
+     * Custom content for the menu item.
+     * If not provided, `label` is rendered as text.
+     */
+    children?: ReactNode;
 }
-interface DropdownProps extends PropsWithChildren {
-    anchor?: MenuItemsProps<"button">["anchor"];
+
+declare const MenuItem: {
+    ({ label, disabled, className, onClick, children, ...rest }: MenuItemProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+
+interface MenuTriggerRenderProps {
     /**
-     * Items to be displayed in the dropdown
-     * */
-    items: DropdownItem[];
+     * Whether the menu is currently open
+     */
+    open: boolean;
     /**
-     * Additional class name for the dropdown button
-     * */
-    className?: string;
+     * Open the menu
+     */
+    openMenu: () => void;
     /**
-     * Additional class name for the dropdown menu
-     * */
-    menuClassName?: string;
+     * Close the menu
+     */
+    closeMenu: () => void;
     /**
-     * Icon to be displayed on the dropdown button
-     * If you want to hide the icon, pass `null`
-     * */
-    icon?: ReactNode | FC;
+     * Toggle the menu open/closed
+     */
+    toggleMenu: () => void;
     /**
-     * Hide the icon on the dropdown button
-     * */
-    iconClassName?: string;
+     * Whether the menu is disabled
+     */
+    disabled: boolean;
+}
+interface MenuTriggerProps {
     /**
-     * Hide arrow icon on the dropdown button
-     * */
-    hideArrowIcon?: boolean;
-    [key: `data-${string}`]: string;
+     * Render function that receives menu state and controls.
+     *
+     * @example
+     * ```tsx
+     * <MenuTrigger>
+     *   {({ open, toggleMenu }) => (
+     *     <button onClick={toggleMenu}>
+     *       Actions {open ? '▲' : '▼'}
+     *     </button>
+     *   )}
+     * </MenuTrigger>
+     * ```
+     */
+    children: (props: MenuTriggerRenderProps) => ReactNode;
 }
 
-/**
- * Fast and easy dropdown component extended from `Menu` and `Button` components.
- * So this won't have much customization options like the `Menu` component.
- * If you think this component is not enough for your use case, you can use the `Menu` component directly.
- *
- * @example
- *
- * ```js
- * import { Dropdown } from "@geckoui/geckoui";
- *
- * const items = [
- *  { label: "Item 1", onClick: () => console.log("Item 1 clicked") },
- *  { label: "Item 2", onClick: () => console.log("Item 2 clicked") },
- *  { label: "Item 3", onClick: () => console.log("Item 3 clicked") },
- * ];
- *
- * <Dropdown items={items} />
- * ```
- * */
-declare function Dropdown({ items, anchor, icon, className, menuClassName, iconClassName, children, hideArrowIcon, ...rest }: DropdownProps): react_jsx_runtime.JSX.Element;
-declare namespace Dropdown {
-    var displayName: string;
-}
+declare const MenuTrigger: {
+    ({ children }: MenuTriggerProps): react.ReactNode;
+    displayName: string;
+};
+
+declare const useMenu: () => MenuContextProps;
 
 type BaseIconProps = SVGProps<SVGSVGElement>;
 
@@ -3869,4 +3784,4 @@ declare class FileOnlyPickerHandler extends BaseFilePickerHandler {
 
 declare const FilePicker: typeof FileOnlyPickerHandler;
 
-export { type ActionsArgs, Alert, type AlertProps, type AlertVariantMap, BaseDateRangeInput, type BaseDateRangeInputProps, type BaseSelectProps, Button, type ButtonColorMap, type ButtonProps, type ButtonSizeMap, type ButtonVariantMap, _default as Calendar, type CalendarActiveProps, type CalendarOverload, type CalendarProps, type CalendarRangeModeProps, type CalendarRef, type CalendarSingleModeProps, CalendarType, Checkbox, type CheckboxProps, ConfirmDialog, type ConfirmDialogActionsArgs, type ConfirmDialogContentProps, type ConfirmDialogOptions, CounterInput, type CounterInputProps, type CounterInputSizeMap, type CustomSelectOptionArgs, type CustomSelectOptionBaseArgs, type DataAttributeProps, type DateFormat$1 as DateFormat, DateInput, type DateInputProps, type DateRange, DateRangeInput, type DateRangeInputProps, type DayCellRenderProps, Dialog, type DialogContentProps, type DialogOptions, Drawer, type DrawerPlacementMap, type DrawerProps, Dropdown, type DropdownClassName, type DropdownItem, type DropdownProps, FilePicker, type FilePickerFile, type FilePickerOptions, type FileSize, type FileWithPreview, type FocusedOption, GeckoUIPortal, type GeckoUIPortalProps, Input, InputError, type InputErrorProps, type InputProps, Label, type LabelProps, LoadingButton, type LoadingButtonProps, Menu, MenuButton, type MenuButtonProps, MenuHeading, MenuItem, type MenuItemProps, MenuItems, type MenuItemsProps, MenuSection, MenuSeparator, type MultiSelectProps, type MultiSelectTriggerProps, type MultiSelectTriggerRenderProps, OTPInput, type OTPInputProps, type OpenFilePickerFn, type OpenFilePickerOptions, Pagination, type PaginationProps, type RHFBaseProps, RHFCheckbox, type RHFCheckboxProps, RHFController, RHFCounterInput, type RHFCounterInputProps, RHFCurrencyInput, type RHFCurrencyInputProps, RHFDateInput, type RHFDateInputProps, RHFDateRangeInput, type RHFDateRangeInputProps, RHFError, type RHFErrorProps, type RHFErrorRenderProps, RHFFileInput, type RHFFileInputProps, RHFFilePicker, type RHFFilePickerBaseProps, type RHFFilePickerProps, type RHFFilePickerRenderProps, type RHFFilePickerRendererProps, RHFInput, RHFInputGroup, type RHFInputGroupProps, type RHFInputProps, RHFNumberInput, type RHFNumberInputProps, RHFOTPInput, type RHFOTPInputProps, RHFRadio, type RHFRadioProps, type RHFRenderArgs, RHFSelect, type RHFSelectOverload, type RHFSelectProps, RHFSwitch, type RHFSwitchProps, RHFTextarea, type RHFTextareaProps, Radio, type RadioProps, type ReactTag, Select, SelectConsumer, type SelectConsumerProps, type SelectContextProps, SelectDropdownSearch, SelectEmpty, type SelectEmptyProps, SelectOption, type SelectOptionConfig, type SelectOptionElement, type SelectOptionProps, type SelectOverload, type SelectProps, SelectTrigger, type SelectTriggerBaseRenderProps, type SelectTriggerOverload, type SelectTriggerProps, type SelectionMode, type SingleSelectProps, type SingleSelectTriggerProps, type SingleSelectTriggerRenderProps, Spinner, Switch, type SwitchProps, type SwitchSizeMap, Textarea, type TextareaProps, Tooltip, type TooltipProps, type UseFilePickerOptions, type UseFilePickerReturn, fileToUInt8Array, getDataAttributes, hasDisplayName, isAsyncFn, isTwoFileEqualByFileContent, toThousandsSeparatorFormat, useClickOutside, useEscListener, useFilePicker, usePreventDefault, useSelect };
+export { type ActionsArgs, Alert, type AlertProps, type AlertVariantMap, BaseDateRangeInput, type BaseDateRangeInputProps, type BaseSelectProps, Button, type ButtonColorMap, type ButtonProps, type ButtonSizeMap, type ButtonVariantMap, _default as Calendar, type CalendarActiveProps, type CalendarOverload, type CalendarProps, type CalendarRangeModeProps, type CalendarRef, type CalendarSingleModeProps, CalendarType, Checkbox, type CheckboxProps, ConfirmDialog, type ConfirmDialogActionsArgs, type ConfirmDialogContentProps, type ConfirmDialogOptions, CounterInput, type CounterInputProps, type CounterInputSizeMap, type CustomSelectOptionArgs, type CustomSelectOptionBaseArgs, type DataAttributeProps, type DateFormat$1 as DateFormat, DateInput, type DateInputProps, type DateRange, DateRangeInput, type DateRangeInputProps, type DayCellRenderProps, Dialog, type DialogContentProps, type DialogOptions, Drawer, type DrawerPlacementMap, type DrawerProps, FilePicker, type FilePickerFile, type FilePickerOptions, type FileSize, type FileWithPreview, type FocusedOption, GeckoUIPortal, type GeckoUIPortalProps, Input, InputError, type InputErrorProps, type InputProps, Label, type LabelProps, LoadingButton, type LoadingButtonProps, Menu, type MenuContextProps, MenuItem, type MenuItemProps, type MenuProps, MenuTrigger, type MenuTriggerProps, type MenuTriggerRenderProps, type MultiSelectProps, type MultiSelectTriggerProps, type MultiSelectTriggerRenderProps, OTPInput, type OTPInputProps, type OpenFilePickerFn, type OpenFilePickerOptions, Pagination, type PaginationProps, type RHFBaseProps, RHFCheckbox, type RHFCheckboxProps, RHFController, RHFCounterInput, type RHFCounterInputProps, RHFCurrencyInput, type RHFCurrencyInputProps, RHFDateInput, type RHFDateInputProps, RHFDateRangeInput, type RHFDateRangeInputProps, RHFError, type RHFErrorProps, type RHFErrorRenderProps, RHFFileInput, type RHFFileInputProps, RHFFilePicker, type RHFFilePickerBaseProps, type RHFFilePickerProps, type RHFFilePickerRenderProps, type RHFFilePickerRendererProps, RHFInput, RHFInputGroup, type RHFInputGroupProps, type RHFInputProps, RHFNumberInput, type RHFNumberInputProps, RHFOTPInput, type RHFOTPInputProps, RHFRadio, type RHFRadioProps, type RHFRenderArgs, RHFSelect, type RHFSelectOverload, type RHFSelectProps, RHFSwitch, type RHFSwitchProps, RHFTextarea, type RHFTextareaProps, Radio, type RadioProps, Select, SelectConsumer, type SelectConsumerProps, type SelectContextProps, SelectDropdownSearch, SelectEmpty, type SelectEmptyProps, SelectOption, type SelectOptionConfig, type SelectOptionElement, type SelectOptionProps, type SelectOverload, type SelectProps, SelectTrigger, type SelectTriggerBaseRenderProps, type SelectTriggerOverload, type SelectTriggerProps, type SelectionMode, type SingleSelectProps, type SingleSelectTriggerProps, type SingleSelectTriggerRenderProps, Spinner, Switch, type SwitchProps, type SwitchSizeMap, Textarea, type TextareaProps, Tooltip, type TooltipProps, type UseFilePickerOptions, type UseFilePickerReturn, fileToUInt8Array, getDataAttributes, hasDisplayName, isAsyncFn, isTwoFileEqualByFileContent, toThousandsSeparatorFormat, useClickOutside, useEscListener, useFilePicker, useMenu, usePreventDefault, useSelect };