@vkzstudio/muza-ui 1.0.43 → 1.0.45

package/dist/components/DatePicker/DatePicker.d.ts

@@ -3,29 +3,44 @@ import { DateRange } from 'react-day-picker';
 import { CalendarBaseProps } from '../Calendar';
 import { PopoverContentProps } from '../Popover/Popover';
 import { Presets } from './utils/getDateRange';
+/**
+ * Custom class names for DatePicker internal elements.
+ *
+ * @example
+ * classNames={{ popoverTrigger: 'w-full', input: 'rounded-lg' }}
+ */
+export type DatePickerClassNames = Partial<{
+    /** Class applied to the Radix popover trigger wrapping the input. */
+    popoverTrigger: string;
+    /** Class applied to the popover content container. */
+    popoverContent: string;
+    /** Class applied to the default Input trigger. */
+    input: string;
+    /** Class applied to each preset button in the left panel. */
+    leftPanelButton: string;
+}>;
 /**
  * Props for the DatePicker component.
  *
- * Uses a discriminated union on `mode` to type `value`, `defaultValue`,
- * `onChange`, and `dateFormatter` for either single date or date range selection.
+ * Discriminated union on `mode`: `'single'` for picking one date, `'range'` for a start-end range.
+ * The `mode` value narrows `value`, `defaultValue`, `onChange`, and `dateFormatter`
+ * to the matching type — see {@link DatePickerSingleProps} and {@link DatePickerRangeProps}.
  *
- * Also inherits calendar layout/visibility props from {@link CalendarBaseProps}
- * (e.g. `hideNavigation`, `hideCaption`, `showOutsideDays`, etc.).
+ * Also inherits calendar layout and visibility props from {@link CalendarBaseProps}
+ * (e.g. `hideNavigation`, `hideCaption`, `showOutsideDays`, `weekStartsOn`, `disabledDates`).
  */
 export type DatePickerProps = {
-    /** Controls horizontal alignment of the calendar popover relative to the trigger. */
+    /** Horizontal alignment of the calendar popover relative to the trigger. */
     alignCalendar?: 'center' | 'end' | 'start';
     /**
-     * Defines preset date range options shown in the left panel (range mode only).
+     * Preset date range shortcuts shown in the left panel (range mode only).
      * Each preset has a display `name` and a `type` matching a built-in range calculation.
      *
      * @example
-     * ```tsx
      * allowedPresets={[
      *   { name: 'Today', type: 'Today' },
      *   { name: 'Last 7 days', type: 'Last 7 days' },
      * ]}
-     * ```
      *
      * @see Presets
      */
@@ -33,35 +48,26 @@ export type DatePickerProps = {
         name: string;
         type: (typeof Presets)[number];
     }[];
-    /** Controls the open state of the calendar popover when used as a controlled component. */
+    /** Controlled open state of the calendar popover. */
     open?: boolean;
     /** Fires when the popover open state changes. */
     onOpenChange?: (open: boolean) => void;
     /**
      * Custom class names for internal elements.
-     *
-     * @example
-     * ```tsx
-     * classNames={{ popoverTrigger: 'w-full', input: 'rounded-lg' }}
-     * ```
+     * @see DatePickerClassNames
      */
-    classNames?: Partial<{
-        popoverTrigger: string;
-        popoverContent: string;
-        input: string;
-        leftPanelButton: string;
-    }>;
+    classNames?: DatePickerClassNames;
     /** Prevents interaction and applies disabled styling. */
     disabled?: boolean;
     /** Applies error styling with red border to the input. */
     error?: boolean;
-    /** Displays label text above the input. */
+    /** Label text displayed above the input. */
     label?: string;
-    /** Displays helper text below the input. */
+    /** Helper text displayed below the input. */
     hint?: string;
     /** Placeholder text shown when no date is selected. */
     placeholder?: string;
-    /** Controls which side of the trigger the calendar popover opens on. @default 'bottom' */
+    /** Side of the trigger the calendar popover opens on. @default 'bottom' */
     side?: 'top' | 'right' | 'bottom' | 'left';
     /** Prevents the popover from overflowing viewport boundaries. @default true */
     avoidCollisions?: boolean;
@@ -79,24 +85,48 @@ export type DatePickerProps = {
     /** Replaces the default Input trigger with a custom rendered element. */
     renderCustomTrigger?: () => ReactNode;
     /**
-     * Controls reset button behavior. When true, reset restores `defaultValue`.
-     * When false or omitted, reset reverts to the last confirmed value.
+     * Controls reset button behavior. When `true`, reset restores `defaultValue`.
+     * When `false` or omitted, reset reverts to the last confirmed value.
+     *
+     * @example
+     * // Reset clears the field (defaultValue is undefined)
+     * <DatePicker shouldResetToDefaultValue defaultValue={undefined} />
      */
     shouldResetToDefaultValue?: boolean;
-    /** When true, every calendar click calls onChange immediately. Buttons remain visible. Reset reverts to value when popover opened. */
+    /**
+     * Calls `onChange` immediately on every calendar click instead of waiting for
+     * confirm. Bottom bar buttons remain visible unless {@link hideBottomBar} is true.
+     * Reset reverts to the value the popover was opened with.
+     */
     immediateCommit?: boolean;
-    /** Range mode only. Replicates react-day-picker v8 range behavior (no longer natively supported in v9): first click sets start, second click sets end (same-day allowed). Clicking the same day again cycles back — when `required` is false the cycle is: selected → one-day range → cleared → selected; otherwise: selected → one-day range → selected. */
+    /**
+     * Range mode only. Replicates react-day-picker v8 same-day range behavior
+     * (no longer supported natively in v9): first click sets start, second click
+     * sets end (same day allowed). A third click on the same day cycles back:
+     * - `required={false}`: selected → one-day range → cleared → selected
+     * - otherwise: selected → one-day range → selected
+     */
     allowOneDayRange?: boolean;
-    /** Marks the field as required, displaying an asterisk on the label. Also passed to the underlying Calendar — when explicitly set to `false`, allows deselecting dates by clicking the selected date again. */
+    /**
+     * Marks the field as required and displays an asterisk on the label.
+     * Also forwarded to the underlying Calendar — when explicitly set to `false`,
+     * dates can be deselected by clicking the selected date again.
+     */
     required?: boolean;
     /** Hides the required asterisk even when `required` is true. @default false */
     disableRequiredAsterisk?: boolean;
-    /** Number of months to display side by side. @default 2 on desktop, 1 on mobile */
+    /** Number of months displayed side by side. @default 2 on desktop, 1 on mobile */
     numberOfMonths?: 1 | 2;
-    /** Hides the entire bottom bar (text, reset button, and confirm button). Only effective when `immediateCommit` is true. @default false */
+    /**
+     * Hides the entire bottom bar (text, reset button, and confirm button).
+     * Only effective when `immediateCommit` is true. @default false
+     */
     hideBottomBar?: boolean;
 } & Omit<CalendarBaseProps, 'numberOfMonths' | 'onConfirm' | 'onReset' | 'isExpanded' | 'leftPanelChildren' | 'bottomTextDefault' | 'dateFormatter' | 'dateRangeFormatter' | 'required'> & (DatePickerRangeProps | DatePickerSingleProps);
-/** Props for date range selection mode. */
+/**
+ * Props for date range selection mode (`mode: 'range'`).
+ * Narrows `value`, `defaultValue`, `onChange`, and `dateFormatter` to `DateRange`.
+ */
 export type DatePickerRangeProps = {
     /** Enables date range selection with start and end dates. */
     mode: 'range';
@@ -104,12 +134,15 @@ export type DatePickerRangeProps = {
     value?: DateRange | undefined;
     /** Initial date range for uncontrolled usage. */
     defaultValue?: DateRange | undefined;
-    /** Fires when a date range selection is confirmed, or `undefined` when deselected (`required={false}`). */
+    /** Fires when a date range is confirmed, or `undefined` when deselected (`required={false}`). */
     onChange?: (date: DateRange | undefined) => void;
-    /** Custom function to format the displayed date range string. */
+    /** Custom formatter for the date range displayed in the input trigger. */
     dateFormatter?: (date: DateRange) => string;
 };
-/** Props for single date selection mode. */
+/**
+ * Props for single date selection mode (`mode: 'single'`).
+ * Narrows `value`, `defaultValue`, `onChange`, and `dateFormatter` to `Date`.
+ */
 export type DatePickerSingleProps = {
     /** Enables single date selection. */
     mode: 'single';
@@ -117,9 +150,9 @@ export type DatePickerSingleProps = {
     value?: Date | undefined;
     /** Initial date for uncontrolled usage. */
     defaultValue?: Date | undefined;
-    /** Fires when a single date selection is confirmed, or `undefined` when deselected (`required={false}`). */
+    /** Fires when a date is confirmed, or `undefined` when deselected (`required={false}`). */
     onChange?: (date: Date | undefined) => void;
-    /** Custom function to format the displayed date string. */
+    /** Custom formatter for the date displayed in the input trigger. */
     dateFormatter?: (date: Date) => string;
 };
 export declare const DatePicker: import('react').ForwardRefExoticComponent<DatePickerProps & import('react').RefAttributes<HTMLInputElement>>;

package/dist/components/DatePicker/DatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.tsx"],"names":[],"mappings":"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"}

package/dist/components/DatePicker/DatePicker.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.stories.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAI3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAKzC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAiMjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAA;AAExC,eAAO,MAAM,iBAAiB,EAAE,KAoC/B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,KAuBxC,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KA0B7B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAwBtB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAwBnB,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,KAyBxC,CAAA;AAED,eAAO,MAAM,2BAA2B,EAAE,KAmCzC,CAAA;AAED,eAAO,MAAM,qCAAqC,EAAE,KA8CnD,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyB1C,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyB1C,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KA0BtB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAwBzB,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,KAkClC,CAAA;AAED,eAAO,MAAM,8BAA8B,EAAE,KAiC5C,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAkC9B,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAoCzB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAqCzB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KA6CxB,CAAA"}
+{"version":3,"file":"DatePicker.stories.d.ts","sourceRoot":"","sources":["../../../src/components/DatePicker/DatePicker.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAI3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAKzC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CA2KjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAA;AAExC,eAAO,MAAM,iBAAiB,EAAE,KAoC/B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,KAuBxC,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KA0B7B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAwBtB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAwBnB,CAAA;AAED,eAAO,MAAM,0BAA0B,EAAE,KAyBxC,CAAA;AAED,eAAO,MAAM,2BAA2B,EAAE,KAmCzC,CAAA;AAED,eAAO,MAAM,qCAAqC,EAAE,KA8CnD,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyB1C,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,KAyB1C,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KA0BtB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAwBzB,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,KAkClC,CAAA;AAED,eAAO,MAAM,8BAA8B,EAAE,KAiC5C,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAkC9B,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAoCzB,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAqCzB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KA6CxB,CAAA"}

package/dist/components/DropdownMenu/DropdownMenu.d.ts

@@ -44,8 +44,22 @@ export interface DropdownMenuContentProps extends React.ComponentProps<typeof Dr
 }
 /** Props for DropdownMenuCheckboxItem. Extends Radix CheckboxItem with IDropdownItem. */
 export type DropdownMenuCheckboxItemProps = React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem> & IDropdownItem;
-/** Props for DropdownMenuRadioGroup. Manages single-selection state via `value` and `onValueChange`. */
-export type DropdownMenuRadioGroupProps = React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>;
+/**
+ * Props for DropdownMenuRadioGroup. Manages single-selection state across child DropdownMenuRadioItems.
+ *
+ * @example
+ * const [position, setPosition] = useState('bottom')
+ * <DropdownMenuRadioGroup value={position} onValueChange={setPosition}>
+ *   <DropdownMenuRadioItem value="top">Top</DropdownMenuRadioItem>
+ *   <DropdownMenuRadioItem value="bottom">Bottom</DropdownMenuRadioItem>
+ * </DropdownMenuRadioGroup>
+ */
+export interface DropdownMenuRadioGroupProps extends React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup> {
+    /** Currently selected value. Matches the `value` of the active DropdownMenuRadioItem. */
+    value?: string;
+    /** Fires when a radio item is selected. Receives the newly selected `value`. */
+    onValueChange?: (value: string) => void;
+}
 /** Props for DropdownMenuRadioItem. Radio button for single selection within a RadioGroup. */
 export type DropdownMenuRadioItemProps = React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem> & IDropdownItem;
 /** Props for DropdownMenuSeparator. Visual divider between menu sections. */
@@ -67,21 +81,38 @@ export interface IDropdownItem {
     icon?: React.ReactNode;
     /** Highlights the item as currently active/selected with brand color. */
     isActive?: boolean;
+    /**
+     * Secondary text displayed below the main label, creating a two-line item layout.
+     *
+     * @example
+     * <DropdownMenuItem icon={<SettingsBold />} description="Configure application preferences">
+     *   Settings
+     * </DropdownMenuItem>
+     */
+    description?: React.ReactNode;
 }
 /** Props for DropdownMenuItem. Standard clickable item with optional icon. Extends Radix Item with IDropdownItem. */
 export type DropdownMenuItemProps = React.ComponentProps<typeof DropdownMenuPrimitive.Item> & IDropdownItem;
 /**
- * Props for DropdownMenuButtonItem. Menu item rendered as a Button.
- * Pass `buttonProps` to configure the inner Button.
+ * Props for DropdownMenuButtonItem. Menu item rendered as a Button for more prominent actions
+ * such as upgrade or sign-up calls-to-action inside the menu. Pass `buttonProps` to configure the inner Button.
+ *
+ * @example
+ * <DropdownMenuButtonItem buttonProps={{ variant: 'primary', size: 'sm', icon: <CrownBold /> }}>
+ *   Upgrade plan
+ * </DropdownMenuButtonItem>
  */
 export type DropdownMenuButtonItemProps = React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
-    /** Props forwarded to the inner Button component. @see ButtonProps */
+    /**
+     * Props forwarded to the inner Button component. Controls variant, size, icon, ghost, and any other Button configuration.
+     * @see ButtonProps
+     */
     buttonProps: ButtonProps;
 };
 /** Standard clickable menu item with optional icon and variant styling. */
-declare const DropdownMenuItem: ({ className, variant, children, icon, disabled, isActive, ...props }: DropdownMenuItemProps) => import("react/jsx-runtime").JSX.Element;
+declare const DropdownMenuItem: ({ className, variant, children, icon, disabled, isActive, description, ...props }: DropdownMenuItemProps) => import("react/jsx-runtime").JSX.Element;
 declare const DropdownMenuButtonItem: ({ children, buttonProps, className, ...props }: DropdownMenuButtonItemProps) => import("react/jsx-runtime").JSX.Element;
-declare const DropdownMenuCheckboxItem: ({ className, children, checked, variant, icon, ...props }: DropdownMenuCheckboxItemProps) => import("react/jsx-runtime").JSX.Element;
+declare const DropdownMenuCheckboxItem: ({ className, children, checked, variant, icon, description, ...props }: DropdownMenuCheckboxItemProps) => import("react/jsx-runtime").JSX.Element;
 declare const DropdownMenuRadioGroup: ({ value, onValueChange, ...props }: DropdownMenuRadioGroupProps) => import("react/jsx-runtime").JSX.Element;
 declare const DropdownMenuRadioItem: React.ForwardRefExoticComponent<Omit<DropdownMenuRadioItemProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuSeparator: ({ className, ...props }: DropdownMenuSeparatorProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/DropdownMenu/DropdownMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DropdownMenu.d.ts","sourceRoot":"","sources":["../../../src/components/DropdownMenu/DropdownMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,qBAAqB,MAAM,+BAA+B,CAAA;AAGtE,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAIpD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,IAAI,CAAC;IAC/D,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,yCAAyC;IACzC,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;CACpB;AAED,oFAAoF;AACpF,MAAM,MAAM,uBAAuB,GAAG,KAAK,CAAC,cAAc,CACxD,OAAO,qBAAqB,CAAC,MAAM,CACpC,CAAA;AAED,4FAA4F;AAC5F,MAAM,MAAM,wBAAwB,GAAG,KAAK,CAAC,cAAc,CACzD,OAAO,qBAAqB,CAAC,OAAO,CACrC,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,wBACf,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,qBAAqB,CAAC,OAAO,CAAC;IAClE,yEAAyE;IACzE,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC1C,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;IAClC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,yFAAyF;AACzF,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAAC,cAAc,CAC9D,OAAO,qBAAqB,CAAC,YAAY,CAC1C,GACC,aAAa,CAAA;AAEf,wGAAwG;AACxG,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC,cAAc,CAC5D,OAAO,qBAAqB,CAAC,UAAU,CACxC,CAAA;AAED,8FAA8F;AAC9F,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAAC,cAAc,CAC3D,OAAO,qBAAqB,CAAC,SAAS,CACvC,GACC,aAAa,CAAA;AAEf,6EAA6E;AAC7E,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAAC,cAAc,CAC3D,OAAO,qBAAqB,CAAC,SAAS,CACvC,CAAA;AAYD,QAAA,MAAM,YAAY,GAAI,cAAc,iBAAiB,4CAEpD,CAAA;AAED,QAAA,MAAM,kBAAkB,GAAI,cAAc,uBAAuB,4CAIhE,CAAA;AAED,QAAA,MAAM,mBAAmB,GAAI,cAAc,wBAAwB,4CAOlE,CAAA;AAED,QAAA,MAAM,mBAAmB,GAAI,4CAK1B,wBAAwB,4CAmD1B,CAAA;AAED,QAAA,MAAM,wBAAwB;;;;8EA0B7B,CAAA;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAAA;IAChC,mDAAmD;IACnD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,qHAAqH;AACrH,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC,cAAc,CACtD,OAAO,qBAAqB,CAAC,IAAI,CAClC,GACC,aAAa,CAAA;AAEf;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG,KAAK,CAAC,cAAc,CAC5D,OAAO,qBAAqB,CAAC,IAAI,CAClC,GAAG;IACF,sEAAsE;IACtE,WAAW,EAAE,WAAW,CAAA;CACzB,CAAA;AAED,2EAA2E;AAC3E,QAAA,MAAM,gBAAgB,GAAI,sEAQvB,qBAAqB,4CA2CvB,CAAA;AAED,QAAA,MAAM,sBAAsB,GAAI,gDAK7B,2BAA2B,4CAsB7B,CAAA;AAED,QAAA,MAAM,wBAAwB,GAAI,2DAO/B,6BAA6B,4CA+C/B,CAAA;AAED,QAAA,MAAM,sBAAsB,GAAI,oCAI7B,2BAA2B,4CAW7B,CAAA;AAED,QAAA,MAAM,qBAAqB,gHAyDzB,CAAA;AAIF,QAAA,MAAM,qBAAqB,GAAI,yBAG5B,0BAA0B,4CAQ5B,CAAA;AAED,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,GACzB,CAAA"}
+{"version":3,"file":"DropdownMenu.d.ts","sourceRoot":"","sources":["../../../src/components/DropdownMenu/DropdownMenu.tsx"],"names":[],"mappings":"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"}