@commercetools/nimbus 0.0.10 → 0.0.11

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import { AriaProgressBarProps } from 'react-aria';
 import { AriaToggleButtonGroupProps } from 'react-aria';
 import { AriaToggleButtonProps } from 'react-aria';
 import { AutocompleteProps } from 'react-aria-components';
+import { ButtonProps as ButtonProps_2 } from 'react-aria-components';
 import { CalendarProps as CalendarProps_2 } from 'react-aria-components';
 import { CardContentProps } from './card.slots';
 import { CardHeaderProps } from './card.slots';
@@ -24,6 +25,7 @@ import { ComboBoxRootProps as ComboBoxRootProps_2 } from './combobox.types';
 import { ComponentProps } from 'react';
 import { DateFieldProps } from 'react-aria-components';
 import { DatePickerStateOptions } from 'react-stately';
+import { DateRangePickerProps as DateRangePickerProps_2 } from 'react-aria-components';
 import { DateValue } from '@internationalized/date';
 import { DateValue as DateValue_2 } from 'react-aria';
 import { default as default_2 } from 'react';
@@ -49,19 +51,33 @@ import { HTMLChakraProps } from '@chakra-ui/react';
 import { ImageProps as ImageProps_2 } from '@chakra-ui/react';
 import { JSX } from 'react/jsx-runtime';
 import { JsxStyleProps } from '@chakra-ui/react';
-import { KbdProps } from '@chakra-ui/react';
+import { KbdProps as KbdProps_2 } from '@chakra-ui/react';
 import { List as List_2 } from '@chakra-ui/react';
 import { ListBoxItemProps } from 'react-aria-components';
 import { ListBoxProps } from 'react-aria-components';
 import { ListBoxSectionProps } from 'react-aria-components';
 import { ListIndicatorProps } from '@chakra-ui/react';
+import { MenuContentProps as MenuContentProps_2 } from './menu.types';
+import { MenuItemProps as MenuItemProps_2 } from './menu.types';
+import { MenuItemProps as MenuItemProps_3 } from 'react-aria-components';
+import { MenuProps } from 'react-aria-components';
+import { MenuRootProps as MenuRootProps_2 } from './menu.types';
+import { MenuSectionProps as MenuSectionProps_2 } from './menu.types';
+import { MenuSectionProps as MenuSectionProps_3 } from 'react-aria-components';
+import { MenuSeparatorProps as MenuSeparatorProps_2 } from './menu.types';
+import { MenuSubmenuProps as MenuSubmenuProps_2 } from './menu.types';
+import { MenuSubmenuTriggerProps as MenuSubmenuTriggerProps_2 } from './menu.types';
+import { MenuTriggerProps as MenuTriggerProps_2 } from './menu.types';
+import { MenuTriggerProps as MenuTriggerProps_3 } from 'react-aria-components';
 import { PatchHtmlProps } from '@chakra-ui/react';
 import { PolymorphicProps } from '@chakra-ui/react';
+import { PopoverProps } from 'react-aria-components';
 import { PropsWithChildren } from 'react';
 import { RadioGroupProps as RadioGroupProps_2 } from 'react-aria-components';
 import { RadioInputOptionProps as RadioInputOptionProps_2 } from './radio-input.types';
 import { RadioInputRootProps as RadioInputRootProps_2 } from './radio-input.types';
 import { RadioProps } from 'react-aria-components';
+import { RangeCalendarProps as RangeCalendarProps_2 } from 'react-aria-components';
 import { ReactNode } from 'react';
 import { RecipeDefinition } from '@chakra-ui/react';
 import { RecipeProps } from '@chakra-ui/react';
@@ -76,11 +92,13 @@ import { SelectOptionsProps as SelectOptionsProps_2 } from './select.types';
 import { SelectProps } from 'react-aria-components';
 import { SelectRootProps as SelectRootProps_2 } from './select.types';
 import { SeparatorProps } from 'react-aria';
+import { SeparatorProps as SeparatorProps_2 } from 'react-aria-components';
 import { SetStateAction } from 'react';
 import { SimpleGridProps as SimpleGridProps_2 } from '@chakra-ui/react';
 import { SlotRecipeDefinition } from '@chakra-ui/react';
 import { SlotRecipeVariantRecord } from '@chakra-ui/react';
 import { StackProps as StackProps_2 } from '@chakra-ui/react';
+import { SubmenuTriggerProps } from 'react-aria-components';
 import { SystemContext } from '@chakra-ui/react';
 import { Table } from '@chakra-ui/react';
 import { Tag } from 'react-aria-components';
@@ -1141,6 +1159,13 @@ declare const dateInputSlotRecipe: SlotRecipeDefinition<"root" | "segmentGroup"
                 };
             };
         };
+        plain: {
+            segmentGroup: {
+                px: "0";
+                outline: "none!";
+                boxShadow: "none!";
+            };
+        };
     };
 }>;
 
@@ -1175,6 +1200,11 @@ export declare interface DatePickerProps extends Omit<DateInputProps, Conflictin
      * Handler that is called when the calendar popover's open state changes.
      */
     onOpenChange?: (isOpen: boolean) => void;
+    /**
+     * Whether to hide the time zone information when using ZonedDateTime values.
+     * This prop is forwarded to both the main date input and footer time input.
+     */
+    hideTimeZone?: boolean;
 }
 
 /**
@@ -1210,6 +1240,109 @@ declare const datePickerSlotRecipe: SlotRecipeDefinition<"popover" | "group" | "
     };
 }>;
 
+/**
+ * Props for the DatePickerTimeInput component.
+ */
+export declare interface DatePickerTimeInputProps {
+    hideTimeZone?: boolean;
+    hourCycle?: 12 | 24;
+}
+
+/**
+ * DateRangePicker
+ * ============================================================
+ * Combines a DateInput with a RangeCalendar popover for date range selection.
+ * Users can either type a date range directly or select from the calendar.
+ */
+export declare const DateRangePicker: {
+    (props: DateRangePickerProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * Main props interface for the DateRangePicker component.
+ *
+ * We extend React Aria's DateRangePickerProps and add the size/variant props
+ * that we want to pass through to the DateInput components.
+ */
+export declare interface DateRangePickerProps extends Omit<DateRangePickerProps_2<DateValue_2>, ExcludedProps_7>, Omit<DateRangePickerRootProps, keyof DateRangePickerProps_2<DateValue_2> | ExcludedProps_7>, RecipeVariantProps<typeof dateRangePickerSlotRecipe> {
+    /**
+     * Whether the calendar popover should be open by default (uncontrolled).
+     */
+    defaultOpen?: boolean;
+    /**
+     * Whether the calendar popover is open (controlled).
+     */
+    isOpen?: boolean;
+    /**
+     * Handler that is called when the calendar popover's open state changes.
+     */
+    onOpenChange?: (isOpen: boolean) => void;
+    /**
+     * Whether to hide the time zone information when using ZonedDateTime values.
+     * This prop is forwarded to both the main date inputs and footer time inputs.
+     */
+    hideTimeZone?: boolean;
+}
+
+/**
+ * Base recipe props interface that combines Chakra UI's recipe props
+ * with the unstyled prop option for the div element.
+ */
+declare interface DateRangePickerRecipeProps extends RecipeProps<"div">, UnstyledProp {
+}
+
+/**
+ * Root props interface that extends Chakra's HTML props with our recipe props.
+ * This creates a complete set of props for the root element, combining
+ * HTML attributes, Chakra's styling system, and our custom recipe props.
+ */
+declare interface DateRangePickerRootProps extends HTMLChakraProps<"div", DateRangePickerRecipeProps> {
+}
+
+declare const dateRangePickerSlotRecipe: SlotRecipeDefinition<"popover" | "group" | "root" | "trigger" | "calendar" | "calendarHeader" | "calendarGrid" | "calendarCell", {
+    size: {
+        sm: {
+            group: {
+                height: "800";
+                pr: "calc({spacing.1400} + {spacing.400})";
+            };
+            trigger: {
+                top: "50";
+            };
+        };
+        md: {
+            group: {
+                height: "1000";
+                pr: "calc({spacing.1600} + {spacing.200} + {spacing.400})";
+            };
+            trigger: {
+                top: "100";
+            };
+        };
+    };
+    variant: {
+        solid: {};
+        ghost: {
+            group: {
+                bg: "transparent";
+                px: "300";
+                _hover: {
+                    bg: "primary.2";
+                };
+            };
+        };
+    };
+}>;
+
+/**
+ * Props for the DateRangePickerTimeInput component.
+ */
+export declare interface DateRangePickerTimeInputProps {
+    hideTimeZone?: boolean;
+    hourCycle?: 12 | 24;
+}
+
 /**
  * @experimental This component is experimental and may change or be removed in future versions.
  */
@@ -1359,7 +1492,7 @@ declare type ExcludedProps_3 = "as" | "asChild" | "style" | "createCalendar";
  * Additional properties we want to exclude from the DatePicker component.
  * These are either deprecated or not intended for use in this component.
  */
-declare type ExcludedProps_4 = "validationState" | "label" | "description" | "errorMessage" | "css" | "colorScheme" | "unstyled" | "recipe" | "as" | "asChild";
+declare type ExcludedProps_4 = "validationState" | "label" | "description" | "errorMessage" | "css" | "colorScheme" | "unstyled" | "recipe" | "as" | "asChild" | "variant";
 
 /**
  * Additional properties we want to exclude from the ProgressBar component.
@@ -1367,6 +1500,18 @@ declare type ExcludedProps_4 = "validationState" | "label" | "description" | "er
  */
 declare type ExcludedProps_5 = "css" | "unstyled" | "as" | "asChild";
 
+/**
+ * Additional properties we want to exclude from the RangeCalendar component.
+ * These are either deprecated or not intended for use in this component.
+ */
+declare type ExcludedProps_6 = "as" | "style" | "createCalendar";
+
+/**
+ * Additional properties we want to exclude from the DateRangePicker component.
+ * These are either deprecated or not intended for use in this component.
+ */
+declare type ExcludedProps_7 = "validationState" | "label" | "description" | "errorMessage" | "css" | "colorScheme" | "unstyled" | "recipe" | "as" | "asChild";
+
 /**
  * List of props that should be excluded from the root props when combining with ARIA props
  */
@@ -1587,6 +1732,11 @@ export declare interface IconProps extends IconVariantProps {
      * Ref to the icon element
      */
     ref?: React.Ref<SVGSVGElement>;
+    /**
+     * The slot to render the icon in.
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/slot
+     */
+    slot?: string | null | undefined;
 }
 
 /**
@@ -1656,9 +1806,17 @@ export declare interface ImageProps extends ImageProps_2 {
 }
 
 /**
- * @experimental This component is experimental and may change or be removed in future versions.
+ * Kbd component
+ *
+ * Renders a keyboard shortcut or key combination, styled for visual clarity.
+ * Typically used to visually represent keyboard keys
  */
-export declare const Kbd: ForwardRefExoticComponent<KbdProps & RefAttributes<HTMLElement>>;
+export declare const Kbd: ({ ref: forwardedRef, slot, ...props }: KbdProps) => JSX.Element;
+
+export declare interface KbdProps extends Omit<KbdProps_2, "slot"> {
+    ref?: default_2.Ref<HTMLElement>;
+    slot?: string | null | undefined;
+}
 
 /**
  * Link
@@ -1862,6 +2020,151 @@ export declare const MakeElementFocusable: ForwardRefExoticComponent<FocusableOp
     children?: ReactNode | undefined;
 } & RefAttributes<HTMLElement>>;
 
+export declare const Menu: {
+    Root: {
+        (props: MenuRootProps_2): JSX.Element;
+        displayName: string;
+    };
+    Trigger: {
+        ({ children, asChild, ref, ...props }: MenuTriggerProps_2): JSX.Element;
+        displayName: string;
+    };
+    Content: {
+        ({ children, placement: placementOverride, ref, }: MenuContentProps_2): JSX.Element;
+        displayName: string;
+    };
+    Item: {
+        ({ children, isCritical, ref, ...props }: MenuItemProps_2): JSX.Element;
+        displayName: string;
+    };
+    Separator: {
+        ({ ref, ...props }: MenuSeparatorProps_2): JSX.Element;
+        displayName: string;
+    };
+    Section: {
+        <T extends object = object>({ children, ref, label, items, ...props }: MenuSectionProps_2<T>): JSX.Element;
+        displayName: string;
+    };
+    Submenu: {
+        ({ children, ...props }: MenuSubmenuProps_2): JSX.Element;
+        displayName: string;
+    };
+    SubmenuTrigger: {
+        ({ children, ...props }: MenuSubmenuTriggerProps_2): JSX.Element;
+        displayName: string;
+    };
+};
+
+export declare const _MenuContent: {
+    ({ children, placement: placementOverride, ref, }: MenuContentProps): JSX.Element;
+    displayName: string;
+};
+
+export declare interface MenuContentProps {
+    children?: ReactNode;
+    ref?: Ref<HTMLDivElement>;
+    /**
+     * The placement of the menu relative to the trigger.
+     */
+    placement?: PopoverProps["placement"];
+}
+
+export declare const _MenuItem: {
+    ({ children, isCritical, ref, ...props }: MenuItemProps): JSX.Element;
+    displayName: string;
+};
+
+export declare interface MenuItemProps extends MenuItemProps_3 {
+    /**
+     * if set to `true`, highlights the item as critical (red)
+     * */
+    isCritical?: boolean;
+    ref?: Ref<HTMLDivElement>;
+}
+
+export declare const _MenuRoot: {
+    (props: MenuRootProps): JSX.Element;
+    displayName: string;
+};
+
+export declare interface MenuRootProps extends Omit<MenuTriggerProps_3, "trigger" | "children">, Omit<MenuProps<object>, "children">, RecipeVariantProps<typeof menuSlotRecipe> {
+    /**
+     * The trigger element and menu content
+     */
+    children: ReactNode;
+    /**
+     * The trigger event to use for the menu.
+     * @default "press"
+     */
+    trigger?: "press" | "longPress";
+    /**
+     * The placement of the menu relative to the trigger.
+     * @default "bottom start"
+     */
+    placement?: PopoverProps["placement"];
+}
+
+export declare const _MenuSection: {
+    <T extends object = object>({ children, ref, label, items, ...props }: MenuSectionProps<T>): JSX.Element;
+    displayName: string;
+};
+
+export declare interface MenuSectionLabelProps {
+    children: ReactNode;
+    ref?: Ref<HTMLDivElement>;
+}
+
+export declare interface MenuSectionProps<T = object> extends MenuSectionProps_3<T> {
+    ref?: Ref<HTMLDivElement>;
+    /**
+     * Label for the section header
+     */
+    label: ReactNode;
+}
+
+export declare const _MenuSeparator: {
+    ({ ref, ...props }: MenuSeparatorProps): JSX.Element;
+    displayName: string;
+};
+
+export declare interface MenuSeparatorProps extends SeparatorProps_2 {
+    ref?: Ref<HTMLDivElement>;
+}
+
+/**
+ * Recipe configuration for the Menu component.
+ * Defines the styling variants and base styles using Chakra UI's slot recipe system.
+ */
+declare const menuSlotRecipe: SlotRecipeDefinition<"content" | "section" | "popover" | "separator" | "root" | "trigger" | "item" | "sectionLabel" | "submenu", SlotRecipeVariantRecord<"content" | "section" | "popover" | "separator" | "root" | "trigger" | "item" | "sectionLabel" | "submenu">>;
+
+export declare const _MenuSubmenu: {
+    ({ children, ...props }: MenuSubmenuProps): JSX.Element;
+    displayName: string;
+};
+
+export declare interface MenuSubmenuProps extends MenuContentProps {
+}
+
+export declare const _MenuSubmenuTrigger: {
+    ({ children, ...props }: MenuSubmenuTriggerProps): JSX.Element;
+    displayName: string;
+};
+
+export declare interface MenuSubmenuTriggerProps extends SubmenuTriggerProps {
+    ref?: Ref<HTMLDivElement>;
+}
+
+export declare const _MenuTrigger: {
+    ({ children, asChild, ref, ...props }: MenuTriggerProps): JSX.Element;
+    displayName: string;
+};
+
+export declare interface MenuTriggerProps extends Omit<MenuTriggerSlotProps, keyof ButtonProps_2>, ButtonProps_2 {
+    ref?: Ref<HTMLButtonElement>;
+}
+
+declare type MenuTriggerSlotProps = HTMLChakraProps<"button">;
+
 /**
  * MultilineTextInput
  * ============================================================
@@ -2374,6 +2677,24 @@ declare const radioInputSlotRecipe: SlotRecipeDefinition<"option" | "root", {
     };
 }>;
 
+export declare const RangeCalendar: (props: RangeCalendarProps<DateValue>) => JSX.Element;
+
+export declare interface RangeCalendarProps<T extends DateValue> extends Omit<RangeCalendarRootSlotProps, keyof RangeCalendarProps_2<DateValue> | ExcludedProps_6>, Omit<RangeCalendarProps_2<T>, ExcludedProps_6>, RecipeVariantProps<typeof rangeCalendarSlotRecipe> {
+}
+
+declare interface RangeCalendarRootSlotProps extends HTMLChakraProps<"div", RecipeVariantProps<typeof rangeCalendarSlotRecipe> & RangeCalendarProps_2<DateValue>> {
+}
+
+declare const rangeCalendarSlotRecipe: SlotRecipeDefinition<"grid" | "header" | "root" | "grids" | "monthTitle" | "gridHeader" | "headerCell" | "gridBody" | "bodyCell", SlotRecipeVariantRecord<"grid" | "header" | "root" | "grids" | "monthTitle" | "gridHeader" | "headerCell" | "gridBody" | "bodyCell">>;
+
+/**
+ * Range value type for date ranges
+ */
+export declare type RangeValue<T> = {
+    start: T;
+    end: T;
+};
+
 export declare type RouterOptions = NimbusRouterOptionsBase extends {
     routerOptions: any;
 } ? NimbusRouterOptionsBase["routerOptions"] : any;