@commercetools/nimbus 0.0.9-rc8 → 0.0.11

package/dist/components.d.ts

@@ -9,9 +9,11 @@ import { AriaButtonProps } from 'react-aria';
 import { AriaCheckboxProps } from 'react-aria';
 import { AriaLinkOptions } from 'react-aria';
 import { AriaNumberFieldProps } from 'react-aria';
+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 +26,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 'react-aria';
 import { DateValue as DateValue_2 } from '@internationalized/date';
 import { default as default_2 } from 'react';
@@ -31,7 +34,6 @@ import { DetailedHTMLProps } from 'react';
 import { Dialog as Dialog_2 } from '@chakra-ui/react';
 import { DisclosureGroupProps as DisclosureGroupProps_2 } from './accordion.types';
 import { DisclosureProps } from 'react-aria-components';
-import { Dispatch } from 'react';
 import { FC } from 'react';
 import { Flex } from '@chakra-ui/react';
 import { FocusableOptions } from 'react-aria';
@@ -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';
@@ -75,11 +91,13 @@ import { SelectOptionProps as SelectOptionProps_2 } from './select.types';
 import { SelectOptionsProps as SelectOptionsProps_2 } from './select.types';
 import { SelectProps } from 'react-aria-components';
 import { SelectRootProps as SelectRootProps_2 } from './select.types';
-import { SetStateAction } from 'react';
+import { SeparatorProps } from 'react-aria';
+import { SeparatorProps as SeparatorProps_2 } from 'react-aria-components';
 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 { Table } from '@chakra-ui/react';
 import { Tag } from 'react-aria-components';
 import { TagGroup as TagGroup_2 } from 'react-aria-components';
@@ -797,7 +815,7 @@ declare type CheckboxVariantProps = CheckboxRootProps & RecipeVariantProps<typeo
  */
 export declare const Code: ForwardRefExoticComponent<CodeProps & RefAttributes<HTMLElement>>;
 
-declare interface ColorModeProviderProps extends ThemeProviderProps {
+export declare interface ColorModeProviderProps extends ThemeProviderProps {
 }
 
 export declare const ComboBox: {
@@ -1137,6 +1155,13 @@ backgroundColor: "primary.2";
 };
 };
 };
+plain: {
+segmentGroup: {
+px: "0";
+outline: "none!";
+boxShadow: "none!";
+};
+};
 };
 }>;
 
@@ -1171,6 +1196,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;
 }
 
 /**
@@ -1206,6 +1236,109 @@ ghost: {};
 };
 }>;
 
+/**
+ * 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>, ExcludedProps_7>, Omit<DateRangePickerRootProps, keyof DateRangePickerProps_2<DateValue> | 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.
  */
@@ -1253,6 +1386,84 @@ export declare type DisclosureItemProps = AccordionItemProps & {
     onExpandedChange?: (isExpanded: boolean) => void;
 };
 
+/**
+ * Divider
+ * ============================================================
+ * A visual separator that divides content sections
+ *
+ * Features:
+ *
+ * - allows forwarding refs to the underlying DOM element
+ * - accepts all native html 'HTMLDivElement' attributes (including aria- & data-attributes)
+ * - supports 'variants', 'orientation', etc. configured in the recipe
+ * - allows overriding styles by using style-props
+ * - supports 'asChild' and 'as' to modify the underlying html-element (polymorphic)
+ * - built with React Aria for accessibility
+ */
+export declare const Divider: {
+    (props: DividerProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * Main props interface for the Divider component.
+ * Extends DividerVariantProps to include both root props and variant props,
+ * while adding support for React Aria separator props.
+ */
+export declare interface DividerProps extends Omit<DividerVariantProps, "orientation">, Pick<SeparatorProps, "orientation"> {
+    /** The orientation of the divider */
+    orientation?: "horizontal" | "vertical";
+    /** Reference to the divider element */
+    ref?: React.Ref<HTMLDivElement>;
+}
+
+/**
+ * Recipe configuration for the Divider component.
+ * Defines the styling variants and base styles using Chakra UI's recipe system.
+ */
+declare const dividerRecipe: RecipeDefinition<    {
+orientation: {
+horizontal: {
+width: "100%";
+height: "1px";
+borderTopWidth: "1px";
+borderTopStyle: "solid";
+borderLeftWidth: "0";
+};
+vertical: {
+height: "100%";
+width: "1px";
+borderLeftWidth: "1px";
+borderLeftStyle: "solid";
+borderTopWidth: "0";
+};
+};
+}>;
+
+/**
+ * Base recipe props interface that combines Chakra UI's recipe props
+ * with the unstyled prop option for the div element.
+ */
+export declare interface DividerRecipeProps 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.
+ */
+export declare interface DividerRootProps extends HTMLChakraProps<"div", DividerRecipeProps> {
+}
+
+/**
+ * Combines the root props with Chakra UI's recipe variant props.
+ * This allows the component to accept both structural props from Root
+ * and styling variants from the recipe.
+ */
+declare type DividerVariantProps = DividerRootProps & RecipeVariantProps<typeof dividerRecipe> & {
+    [key: `data-${string}`]: unknown;
+};
+
 declare type ExcludedNumberInputProps = "asChild" | "onChange";
 
 /**
@@ -1277,7 +1488,25 @@ 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.
+ * These are chakra-ui props we don't want exposed.
+ */
+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
@@ -1499,6 +1728,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;
 }
 
 /**
@@ -1568,9 +1802,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
@@ -1774,6 +2016,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
  * ============================================================
@@ -1842,9 +2229,82 @@ declare interface MultilineTextInputRecipeProps extends RecipeVariantProps<typeo
 
 declare type MultilineTextInputRootSlotProps = HTMLChakraProps<"textarea", MultilineTextInputRecipeProps>;
 
-export declare function NimbusProvider({ children, locale, ...props }: ColorModeProviderProps & {
+export declare function NimbusProvider({ children, locale, router, ...props }: NimbusProviderProps): JSX.Element;
+
+export declare interface NimbusProviderProps extends ColorModeProviderProps {
+    /**
+     * Optional locale for internationalization.
+     * Expects a [BCP47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) (e.g., 'en-US', 'de-DE', 'fr-FR').
+     * Defaults to the user's browser locale if not provided.
+     */
     locale?: string;
-}): JSX.Element;
+    /**
+     * Optional router configuration object for client-side navigation.
+     * When provided, all nimbus components with href props will use client-side routing.
+     * - `navigate`: Function to programmatically navigate to routes.
+     * - `useHref`: Optional function to transform hrefs (useful for base paths).
+     */
+    router?: NimbusRouterConfig | TypedNimbusRouterConfig;
+}
+
+export declare interface NimbusRouterConfig {
+    /**
+     * Function to programmatically navigate to a new route.
+     * This should be the navigate function from your client-side router.
+     *
+     * @example
+     * // React Router
+     * const navigate = useNavigate();
+     * <NimbusProvider router={{ navigate }} />
+     *
+     * @example
+     * // Next.js App Router
+     * const router = useRouter();
+     * <NimbusProvider router={{ navigate: router.push }} />
+     */
+    navigate: (href: string, routerOptions?: any) => void;
+    /**
+     * Optional function to transform hrefs before they are used.
+     * Useful for prepending base paths or other URL transformations.
+     *
+     * @example
+     * // Next.js with basePath
+     * const useHref = (href: string) => process.env.BASE_PATH + href;
+     * <NimbusProvider router={{ navigate, useHref }} />
+     */
+    useHref?: (href: string) => string;
+}
+
+/**
+ * TypeScript module augmentation for Nimbus router configuration.
+ *
+ * This allows consumers to extend the router configuration types
+ * to match their specific router framework, providing better type safety.
+ *
+ * TODO: Document this in an mdx-file, available to consumers via the docs-app
+ *
+ * @example
+ * // For React Router
+ * import type { NavigateOptions } from 'react-router-dom';
+ *
+ * declare module '@commercetools/nimbus' {
+ *   interface NimbusRouterOptionsBase {
+ *     routerOptions?: NavigateOptions;
+ *   }
+ * }
+ *
+ * @example
+ * // For Next.js App Router
+ * import type { AppRouterInstance } from 'next/dist/shared/lib/app-router-context';
+ *
+ * declare module '@commercetools/nimbus' {
+ *   interface NimbusRouterOptionsBase {
+ *     routerOptions?: Parameters<AppRouterInstance['push']>[1];
+ *   }
+ * }
+ */
+export declare interface NimbusRouterOptionsBase {
+}
 
 /**
  * NumberInput
@@ -2001,6 +2461,159 @@ export declare const PasswordInput: ForwardRefExoticComponent<Omit<PasswordInput
 export declare interface PasswordInputProps extends Omit<TextInputProps, "type"> {
 }
 
+/**
+ * ProgressBar
+ * ============================================================
+ * Displays progress towards completion of a task or process
+ *
+ * Features:
+ *
+ * - Supports both determinate (with value) and indeterminate (loading) states
+ * - Two visual variants: solid (gradient) and contrast (monochromatic)
+ * - Three layouts: minimal, inline, and stacked
+ * - Configurable value formatting with internationalization support
+ * - Full accessibility support with ARIA attributes
+ * - Allows forwarding refs to the underlying DOM element
+ * - Accepts all native HTML div attributes
+ * - Supports variants, sizes, etc. configured in the recipe
+ * - Allows overriding styles by using style-props
+ */
+export declare const ProgressBar: {
+    (props: ProgressBarProps): JSX.Element;
+    displayName: string;
+};
+
+/**
+ * Main props interface for the ProgressBar component.
+ * Extends ProgressBarRootProps to include root props, variant props, and aria props,
+ * while adding custom props for label display and formatting.
+ */
+export declare interface ProgressBarProps extends Omit<ProgressBarRootProps, ExcludedProps_5> {
+    /**
+     * Ref forwarding to the root element
+     */
+    ref?: React.Ref<HTMLDivElement>;
+    /**
+     * Whether the progress bar represents an active, ongoing process.
+     * Set to `true` for dynamic progress (e.g., file uploads, downloads).
+     * Set to `false` for static progress indicators (e.g., step 3 of 5 in a wizard).
+     * @default true
+     */
+    isDynamic?: boolean;
+    /**
+     * Format options for the progress bar.
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat
+     */
+    formatOptions: ProgressBarRootProps["formatOptions"];
+}
+
+/**
+ * Base recipe props interface that combines Chakra UI's recipe props
+ * with the unstyled prop option for the div element.
+ */
+declare interface ProgressBarRecipeProps extends RecipeProps<"div">, UnstyledProp {
+}
+
+/**
+ * Root props interface that extends Chakra's HTML props with our recipe props,
+ * aria props, and data attributes.
+ */
+declare interface ProgressBarRootProps extends HTMLChakraProps<"div", ProgressBarRecipeProps>, Omit<RecipeVariantProps<typeof progressBarSlotRecipe>, "isIndeterminate">, AriaProgressBarProps {
+    [key: `data-${string}`]: string;
+}
+
+/**
+ * Recipe configuration for the ProgressBar component.
+ * Defines the styling variants and base styles using Chakra UI's slot recipe system.
+ */
+declare const progressBarSlotRecipe: SlotRecipeDefinition<"fill" | "label" | "track" | "value" | "root", {
+size: {
+"2xs": {
+root: {
+"--progress-bar-radius": "{radii.300}";
+"--progress-bar-font-size": "{fontSizes.350}";
+"--progress-bar-height": "{sizes.300}";
+"--progress-bar-line-height": "{fontSizes.500}";
+};
+};
+md: {
+root: {
+"--progress-bar-radius": "{radii.600}";
+"--progress-bar-font-size": "{fontSizes.400}";
+"--progress-bar-height": "{sizes.600}";
+"--progress-bar-line-height": "{fontSizes.600}";
+};
+};
+};
+isDynamic: {
+true: {
+fill: {
+"--progress-bar-animation": "gradient-shimmer 4s ease-in-out infinite";
+"&[data-complete='true']": {
+"--progress-bar-animation": "none";
+};
+};
+};
+};
+isIndeterminate: {
+true: {
+fill: {
+"--progress-bar-animation": "progress-indeterminate 2s ease-in-out infinite";
+width: "40% !important";
+};
+};
+};
+variant: {
+solid: {
+root: {
+"--progress-bar-text-color": "{colors.neutral.12}";
+"--progress-bar-track-bg": "{colors.neutralAlpha.3}";
+};
+};
+contrast: {
+root: {
+"--progress-bar-text-color": "{colors.colorPalette.contrast}";
+"--progress-bar-track-bg": "{colors.colorPalette.contrast/15}";
+};
+fill: {
+bgImage: "linear-gradient(90deg, {colors.colorPalette.contrast/25}, {colors.colorPalette.contrast}, {colors.colorPalette.contrast/25})";
+};
+};
+};
+layout: {
+minimal: {
+label: {
+display: "none";
+};
+value: {
+display: "none";
+};
+};
+inline: {
+root: {
+flexDirection: "row";
+alignItems: "center";
+gap: "400";
+};
+track: {
+flex: number;
+};
+};
+stacked: {
+root: {
+flexDirection: "column";
+gap: "200";
+};
+text: {
+display: "flex";
+justifyContent: "space-between";
+alignItems: "center";
+width: "100%";
+};
+};
+};
+}>;
+
 declare type RadioGroupProps = Omit<RadioGroupProps_2, "children"> & {
     children?: React.ReactNode;
 };
@@ -2060,6 +2673,28 @@ gap: "400";
 };
 }>;
 
+export declare const RangeCalendar: (props: RangeCalendarProps<DateValue_2>) => JSX.Element;
+
+export declare interface RangeCalendarProps<T extends DateValue_2> extends Omit<RangeCalendarRootSlotProps, keyof RangeCalendarProps_2<DateValue_2> | ExcludedProps_6>, Omit<RangeCalendarProps_2<T>, ExcludedProps_6>, RecipeVariantProps<typeof rangeCalendarSlotRecipe> {
+}
+
+declare interface RangeCalendarRootSlotProps extends HTMLChakraProps<"div", RecipeVariantProps<typeof rangeCalendarSlotRecipe> & RangeCalendarProps_2<DateValue_2>> {
+}
+
+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;
+
 export declare const Select: {
     Root: ForwardRefExoticComponent<SelectRootProps_2 & RefAttributes<HTMLDivElement>>;
     Options: {
@@ -2644,15 +3279,10 @@ declare interface TooltipRootProps extends HTMLChakraProps<"div", TooltipRecipeP
  */
 declare type TooltipVariantProps = ExcludePolymorphicFromProps<TooltipRootProps & RecipeVariantProps<typeof tooltipRecipe> & TooltipProps_2>;
 
-export declare function useColorMode(): {
-    colorMode: string | undefined;
-    setColorMode: Dispatch<SetStateAction<string>>;
-    toggleColorMode: () => void;
-};
-
-export declare function useColorModeValue<T>(light: T, dark: T): T;
-
-export declare function useColorScheme(): string;
+export declare interface TypedNimbusRouterConfig {
+    navigate: (href: string, routerOptions?: RouterOptions) => void;
+    useHref?: (href: string) => string;
+}
 
 export declare const VisuallyHidden: {
     (props: VisuallyHiddenProps): JSX.Element;