@uniformdev/design-system 20.50.2-alpha.9 → 20.50.2-alpha.96

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,14 +1,11 @@
1
1
  import * as _emotion_react_jsx_runtime from '@emotion/react/jsx-runtime';
2
2
  import { Decorator } from '@storybook/react-vite';
3
3
  import * as React$1 from 'react';
4
- import React__default, { RefObject, ReactElement, HTMLAttributes, ReactNode, ButtonHTMLAttributes, ImgHTMLAttributes, SVGProps, InputHTMLAttributes, CSSProperties, Ref, HtmlHTMLAttributes, PropsWithChildren, FocusEventHandler, ChangeEvent } from 'react';
5
- import { GroupBase, Props, MultiValue, SingleValue } from 'react-select';
4
+ import React__default, { RefObject, ReactElement, HTMLAttributes, ReactNode, ButtonHTMLAttributes, ImgHTMLAttributes, SVGProps, InputHTMLAttributes, HtmlHTMLAttributes, PropsWithChildren, CSSProperties, Ref, FocusEventHandler, ChangeEvent } from 'react';
5
+ import { GroupBase, Props, MultiValue, SingleValue, StylesConfig } from 'react-select';
6
6
  export { ActionMeta, FormatOptionLabelContext, FormatOptionLabelMeta, GetOptionLabel, GetOptionValue, GroupBase, GroupHeadingProps, GroupProps, MenuListProps, MenuPlacement, MultiValue, MultiValueGenericProps, MultiValueProps, MultiValueRemoveProps, OnChangeValue, OptionContext, OptionProps, Options, OptionsOrGroups } from 'react-select';
7
7
  import * as _emotion_react from '@emotion/react';
8
- import { SerializedStyles } from '@emotion/react';
9
- import * as _ariakit_react from '@ariakit/react';
10
- import { TooltipOptions, TooltipStoreProps, TooltipProps as TooltipProps$1, ButtonProps as ButtonProps$1, MenuStoreProps, PopoverStoreState, MenuProps as MenuProps$1, Menu as Menu$1, MenuItemProps as MenuItemProps$1, PopoverProps as PopoverProps$1, PopoverProviderProps, PopoverStore, TabStoreState, TabListProps, TabProps, TabPanelProps } from '@ariakit/react';
11
- export { PopoverStore } from '@ariakit/react';
8
+ import { SerializedStyles, Interpolation, Theme as Theme$1 } from '@emotion/react';
12
9
  import { IconType as IconType$2, IconBaseProps } from '@react-icons/all-files/lib';
13
10
  import * as _react_icons_all_files from '@react-icons/all-files';
14
11
  import { IconType as IconType$1 } from '@react-icons/all-files';
@@ -19,11 +16,10 @@ import { JsonSchema7Type } from 'zod-to-json-schema';
19
16
  import { InitialConfigType } from '@lexical/react/LexicalComposer';
20
17
  import { LinkParamValue, RichTextParamConfiguration } from '@uniformdev/canvas';
21
18
  export { RichTextBuiltInElement, RichTextBuiltInFormat } from '@uniformdev/canvas';
22
- import { Spread, SerializedElementNode, ElementNode, NodeKey, EditorConfig, DOMConversionMap, RangeSelection, SerializedEditorState, LexicalEditor } from 'lexical';
19
+ import { ElementNode, NodeKey, Spread, SerializedElementNode, EditorConfig, DOMConversionMap, RangeSelection, SerializedEditorState, LexicalEditor } from 'lexical';
23
20
  import * as _uniformdev_richtext from '@uniformdev/richtext';
24
21
  import { RichTextBuiltInElement } from '@uniformdev/richtext';
25
22
  export { richTextBuiltInElements, richTextBuiltInFormats } from '@uniformdev/richtext';
26
- export { Id as ToastId, toast } from 'react-toastify';
27
23
 
28
24
  /** @todo: line 144 onwards will be brought into a title, paragraph, list and link components */
29
25
  type ThemeProps = {
@@ -58,10 +54,12 @@ declare const useBreakpoint: () => BreakpointSize;
58
54
  * Media Query Helper Function
59
55
  * @function
60
56
  * @param {string} size - The responsive breakpoint value
61
- * @returns {string} - compiled media query e.g. (min-width: 640px)
57
+ * @param {'min' | 'max'} [bound='min'] - Whether to use min-width or max-width
58
+ * @returns {string} - compiled media query e.g. @media (min-width: 640px)
62
59
  * @example `${mq('md')} { background: red; }`
60
+ * @example `${mq('lg', 'max')} { overflow: hidden; }`
63
61
  */
64
- declare const mq: (size: BreakpointSize) => string;
62
+ declare const mq: (size: BreakpointSize, bound?: "min" | "max") => string;
65
63
  /**
66
64
  * Media Query Helper Function
67
65
  * @function
@@ -345,7 +343,7 @@ type AddListButtonProps = React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
345
343
  */
346
344
  declare const AddListButton: ({ buttonText, onButtonClick, disabled, icon, variant, theme, ...buttonProps }: AddListButtonProps) => _emotion_react_jsx_runtime.JSX.Element;
347
345
 
348
- type AvatarSizeProp = '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
346
+ type AvatarSizeProp = '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
349
347
  type AvatarProps = {
350
348
  /**
351
349
  * The src of the avatar.
@@ -370,6 +368,27 @@ type AvatarProps = {
370
368
  */
371
369
  declare const Avatar: ({ src, label, children, size, as, labelWithoutPortal, ...props }: AvatarProps) => _emotion_react_jsx_runtime.JSX.Element;
372
370
 
371
+ /** Canonical width tokens for each `Avatar` `size` (single source of truth for rem values). */
372
+ declare const AVATAR_SIZE_2XS = "1rem";
373
+ declare const AVATAR_SIZE_XS = "1.5rem";
374
+ declare const AVATAR_SIZE_SM = "2rem";
375
+ declare const AVATAR_SIZE_MD = "2.5rem";
376
+ declare const AVATAR_SIZE_LG = "3rem";
377
+ declare const AVATAR_SIZE_XL = "4rem";
378
+ declare const AVATAR_SIZE_2XL = "5rem";
379
+ /** Largest step (6rem ≈ 96px when root font size is 16px). */
380
+ declare const AVATAR_SIZE_3XL = "6rem";
381
+ declare const avatarStyles: _emotion_react.SerializedStyles;
382
+ declare const avatarImageStyles: _emotion_react.SerializedStyles;
383
+ declare const avatarSize2xsStyles: _emotion_react.SerializedStyles;
384
+ declare const avatarSizeXsStyles: _emotion_react.SerializedStyles;
385
+ declare const avatarSizeSmStyles: _emotion_react.SerializedStyles;
386
+ declare const avatarSizeMdStyles: _emotion_react.SerializedStyles;
387
+ declare const avatarSizeLgStyles: _emotion_react.SerializedStyles;
388
+ declare const avatarSizeXlStyles: _emotion_react.SerializedStyles;
389
+ declare const avatarSize2xlStyles: _emotion_react.SerializedStyles;
390
+ declare const avatarSize3xlStyles: _emotion_react.SerializedStyles;
391
+
373
392
  interface AvatarGroupProps extends React.HTMLAttributes<HTMLDivElement> {
374
393
  /**
375
394
  * The maximum number of avatars to show. This must be 2 or more.
@@ -505,24 +524,40 @@ interface UseShortcutResult extends ShortcutReference {
505
524
  }
506
525
  declare function useShortcut({ disabled, handler, shortcut, macShortcut, doNotPreventDefault, activeWhenEditing, useKey, }: UseShortcutOptions): UseShortcutResult;
507
526
 
508
- type TooltipProps = TooltipOptions & {
527
+ type Placement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
528
+ interface PopoverStore {
529
+ show(): void;
530
+ hide(): void;
531
+ readonly open: boolean;
532
+ }
533
+
534
+ type TooltipProps = {
509
535
  /** Content of tooltip popover */
510
536
  title: string | React.ReactElement;
511
537
  /** Optional ability to specify alternative placement. By default - bottom center */
512
- placement?: TooltipStoreProps['placement'];
538
+ placement?: Placement;
513
539
  /** Optional ability to control visibility of Tooltip manually, useful for showing tooltip on click instead of on hover */
514
- visible?: TooltipStoreProps['open'];
540
+ visible?: boolean | undefined;
515
541
  /** Offset between the reference and the popover on the main axis. Use it only in special cases. */
516
- gutter?: TooltipProps$1['gutter'];
542
+ gutter?: number;
517
543
  children: ReactElement;
518
544
  /** If the tooltip should not be rendered inside a portal */
519
545
  withoutPortal?: boolean;
520
- /** sets the delay time before showing the tooltip
546
+ /**
547
+ * Sets the delay time before showing the tooltip.
521
548
  * @default 0
522
549
  */
523
550
  timeout?: number;
524
- } & Pick<HTMLAttributes<HTMLDivElement>, 'className'>;
525
- declare function Tooltip({ children, title, placement, visible, withoutPortal, timeout, ...tooltipProps }: TooltipProps): _emotion_react_jsx_runtime.JSX.Element;
551
+ /**
552
+ * Sets the visibility of the tooltip. This is deprecated and will be removed in the next major version.
553
+ * @deprecated Use `visible` instead.
554
+ */
555
+ open?: boolean | undefined;
556
+ } & Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'children'>;
557
+ /**
558
+ * Displays contextual information when hovering or focusing an element.
559
+ */
560
+ declare function Tooltip({ children, title, placement, visible, withoutPortal, timeout, gutter, ...popupProps }: TooltipProps): _emotion_react_jsx_runtime.JSX.Element;
526
561
 
527
562
  /** Button sizes that are available to use with our brand */
528
563
  type ButtonSizeProps = 'zero' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
@@ -551,7 +586,7 @@ declare const useButtonStyles: ({ size, ...props }: ButtonStylesProps) => {
551
586
  btnSize: string;
552
587
  };
553
588
 
554
- type ButtonProps = ButtonProps$1 & {
589
+ type ButtonProps = React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
555
590
  /** sets the theme of the button
556
591
  * @default "primary"
557
592
  */
@@ -587,7 +622,25 @@ type ButtonWithVariantProps = Omit<ButtonProps, 'buttonType'> & {
587
622
  * Uniform Button Component
588
623
  * @example <Button buttonType="secondary" size="md" onClick={() => alert('hello world!')}>Click me</Button>
589
624
  */
590
- declare const Button: React$1.ForwardRefExoticComponent<(Omit<ButtonProps, "ref"> | Omit<ButtonWithVariantProps, "ref">) & React$1.RefAttributes<HTMLButtonElement>>;
625
+ declare const Button: React$1.ForwardRefExoticComponent<(ButtonProps | ButtonWithVariantProps) & React$1.RefAttributes<HTMLButtonElement>>;
626
+
627
+ type LinkButtonProps = React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
628
+ /** React child node */
629
+ children?: React$1.ReactNode;
630
+ /** (optional) sets whether the link is truncated or not */
631
+ truncated?: boolean;
632
+ };
633
+ /**
634
+ * @deprecated - Beta - A button styled as a link with ghost-like appearance.
635
+ * Features no padding, left-aligned content, text truncation, and no background hover color.
636
+ * @example <LinkButton onClick={() => {}}>Click me</LinkButton>
637
+ */
638
+ declare const LinkButton: React$1.ForwardRefExoticComponent<React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
639
+ /** React child node */
640
+ children?: React$1.ReactNode;
641
+ /** (optional) sets whether the link is truncated or not */
642
+ truncated?: boolean;
643
+ } & React$1.RefAttributes<HTMLButtonElement>>;
591
644
 
592
645
  declare const rectangleRoundedIcon: IconType$1;
593
646
  declare const cardIcon: IconType$1;
@@ -1400,8 +1453,8 @@ type ButtonWithMenuStylesProps = ButtonWithMenuDefaultStylesProps | ButtonWithMe
1400
1453
  interface ActionButtonsProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'size' | 'disabled'> {
1401
1454
  /** Takes a function for the visible button */
1402
1455
  onButtonClick?: () => void;
1403
- /** (optional) ariakit placements options for the expandable menu */
1404
- placement?: MenuStoreProps['placement'];
1456
+ /** (optional) placement options for the expandable menu */
1457
+ placement?: Placement;
1405
1458
  /** sets the button text value */
1406
1459
  buttonText: React.ReactNode;
1407
1460
  /** sets a leading icon supporting the button text */
@@ -1451,12 +1504,25 @@ declare const ButtonWithMenu: ({ onButtonClick, buttonText, icon, disabled, chil
1451
1504
  * A string in the ISO 8601 date format: YYYY-MM-DD
1452
1505
  */
1453
1506
  type IsoDateString = string;
1507
+ type CalendarCellCss = Interpolation<Theme$1> | null | false | undefined;
1508
+ /**
1509
+ * Optional style overrides for calendar sub-elements.
1510
+ */
1511
+ type CalendarStyles = {
1512
+ /**
1513
+ * Returns custom styles to append to a date cell.
1514
+ */
1515
+ calendarCell?: (date: Date) => CalendarCellCss[];
1516
+ };
1454
1517
  type CalendarProps = Pick<CalendarProps$1<DateValue>, 'autoFocus' | 'isDisabled' | 'isReadOnly' | 'isInvalid'> & Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onBlur' | 'onFocus'> & {
1455
1518
  value: IsoDateString | null | undefined;
1456
1519
  timeZone: string;
1457
1520
  minValue?: IsoDateString;
1458
1521
  maxValue?: IsoDateString;
1459
1522
  onChange?: (value: IsoDateString) => void;
1523
+ styles?: CalendarStyles;
1524
+ withTodayButton?: boolean;
1525
+ isDateUnavailable?: (date: Date) => boolean;
1460
1526
  };
1461
1527
  /**
1462
1528
  * A Calendar Grid which allows the user to navigate
@@ -1464,7 +1530,7 @@ type CalendarProps = Pick<CalendarProps$1<DateValue>, 'autoFocus' | 'isDisabled'
1464
1530
  *
1465
1531
  * @deprecated This component is in beta, name and props are subject to change without a major version
1466
1532
  */
1467
- declare const Calendar: ({ value, timeZone, minValue, maxValue, onChange, autoFocus, isDisabled, isInvalid, isReadOnly, ...props }: CalendarProps) => _emotion_react_jsx_runtime.JSX.Element;
1533
+ declare const Calendar: ({ value, timeZone, minValue, maxValue, onChange, styles: stylesProp, autoFocus, isDisabled, isInvalid, isReadOnly, withTodayButton, isDateUnavailable, ...props }: CalendarProps) => _emotion_react_jsx_runtime.JSX.Element;
1468
1534
 
1469
1535
  /** Callout button types available to use with our brand */
1470
1536
  type CalloutType = 'caution' | 'danger' | 'info' | 'note' | 'success' | 'tip' | 'error';
@@ -1561,7 +1627,7 @@ declare const CardContainer: ({ bgColor, padding, withLastColumn, children, ...p
1561
1627
  */
1562
1628
  declare const LoadingCardSkeleton: () => _emotion_react_jsx_runtime.JSX.Element;
1563
1629
 
1564
- type ChipSizeProp = 'xs' | 'sm' | 'md';
1630
+ type ChipSizeProp = 'xxs' | 'xs' | 'sm' | 'md';
1565
1631
  type ChipTheme = 'accent-light' | 'accent-dark' | 'accent-alt-light' | 'accent-alt-dark' | 'neutral-light' | 'neutral-dark' | 'utility-caution' | 'utility-danger' | 'utility-info' | 'utility-success';
1566
1632
  type ChipProps = {
1567
1633
  icon?: IconType;
@@ -1609,15 +1675,23 @@ type DismissibleChipActionProps = {
1609
1675
  declare const DismissibleChipAction: ({ onDismiss, ...props }: DismissibleChipActionProps) => _emotion_react_jsx_runtime.JSX.Element;
1610
1676
 
1611
1677
  type FilterChipSize = 'xs' | 'sm' | 'md' | 'lg';
1612
- type FilterChipProps = {
1678
+ /**
1679
+ * Compact button used to toggle a filter on/off, optionally rendered as a
1680
+ * dropdown trigger. Spreads `...props` first then sets `type` last with a
1681
+ * fallback to `"button"` so wrappers like Base UI's `Menu.Trigger` (which can
1682
+ * forward `type: undefined` via `cloneElement`) cannot accidentally turn it
1683
+ * into a submit button inside a `<form>`. Marked with `markNativeButton` so
1684
+ * `Menu` knows the rendered DOM is a real `<button>` and can pass
1685
+ * `nativeButton={true}` to Base UI.
1686
+ */
1687
+ declare const FilterChip: React$1.ForwardRefExoticComponent<{
1613
1688
  leadingIcon?: IconType;
1614
1689
  asDropdown?: boolean;
1615
1690
  children: React.ReactNode;
1616
1691
  dataTestId?: string;
1617
1692
  size?: FilterChipSize;
1618
1693
  isSelected?: boolean;
1619
- } & ButtonHTMLAttributes<HTMLButtonElement>;
1620
- declare const FilterChip: ({ leadingIcon, asDropdown, children, dataTestId, size, isSelected, ...props }: FilterChipProps) => _emotion_react_jsx_runtime.JSX.Element;
1694
+ } & ButtonHTMLAttributes<HTMLButtonElement> & React$1.RefAttributes<HTMLButtonElement>>;
1621
1695
 
1622
1696
  type MultilineChipProps = {
1623
1697
  children: ReactNode;
@@ -1783,13 +1857,15 @@ type DateTimePickerProps = {
1783
1857
  /** (optional) sets the base test id for each of the elements with a testid */
1784
1858
  testId?: string;
1785
1859
  /** (optional) sets the popover placement */
1786
- placement?: PopoverStoreState['placement'];
1860
+ placement?: Placement;
1787
1861
  /** (optional) sets the popover offset
1788
1862
  * @default 8
1789
1863
  */
1790
1864
  offset?: number;
1791
1865
  /** (optional) sets whether to render the popover in a portal */
1792
1866
  portal?: boolean;
1867
+ /** (optional) reduces input height to match compact parameter inputs */
1868
+ compact?: boolean;
1793
1869
  };
1794
1870
  /**
1795
1871
  * Use this context for slots within the date time picker
@@ -1809,7 +1885,7 @@ declare function useDateTimePickerContext(): {
1809
1885
  * Subcomponents can manipulate the value directly by using
1810
1886
  * the `useDateTimePickerContext()` hook.
1811
1887
  */
1812
- declare const DateTimePicker: ({ id, label, triggerIcon, value, minVisible, maxVisible, variant, caption, placeholder, belowTimeInputSlot, showLabel, errorMessage, warningMessage, disabled, onChange, offset, testId, placement, portal, ...props }: DateTimePickerProps) => _emotion_react_jsx_runtime.JSX.Element;
1888
+ declare const DateTimePicker: ({ id, label, triggerIcon, value, minVisible, maxVisible, variant, caption, placeholder, belowTimeInputSlot, showLabel, errorMessage, warningMessage, disabled, onChange, offset, testId, placement, portal, compact, ...props }: DateTimePickerProps) => _emotion_react_jsx_runtime.JSX.Element;
1813
1889
 
1814
1890
  declare function DateTimePickerSummary({ value, placeholder, }: {
1815
1891
  value: DateTimePickerValue | null | undefined;
@@ -2048,7 +2124,7 @@ interface IconButtonProps extends Omit<ButtonProps, 'size'> {
2048
2124
  /** Style for the larger sizes have not been decided yet */
2049
2125
  size?: 'xs' | 'sm' | 'md';
2050
2126
  }
2051
- declare const IconButton: React$1.ForwardRefExoticComponent<Omit<IconButtonProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
2127
+ declare const IconButton: React$1.ForwardRefExoticComponent<IconButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
2052
2128
 
2053
2129
  interface ImageProps extends ImgHTMLAttributes<HTMLImageElement> {
2054
2130
  imgClassName?: string;
@@ -2653,8 +2729,6 @@ type IntegrationModalHeaderProps = {
2653
2729
  /** (optional) sets child elements in */
2654
2730
  menu?: React$1.ReactNode;
2655
2731
  };
2656
- type HexModalBackgroundProps = React$1.SVGAttributes<SVGElement>;
2657
- declare const HexModalBackground: ({ ...props }: HexModalBackgroundProps) => _emotion_react_jsx_runtime.JSX.Element;
2658
2732
  /** Uniform Integration Modal Header
2659
2733
  * @example <IntegrationModalHeader icon="/icon.svg" name="name" />
2660
2734
  */
@@ -2709,6 +2783,14 @@ type KeyValueInputProps<TValue extends string = string> = {
2709
2783
  onChange: (icon: string) => void;
2710
2784
  disabled?: boolean;
2711
2785
  }) => ReactNode;
2786
+ /**
2787
+ * When true, keys and values are treated as fully independent: typing a key
2788
+ * does not autofill the value, and multi-line paste lines without a comma
2789
+ * are imported as keys with empty values rather than mirroring key into value.
2790
+ * Use for inputs where the value has no logical relation to the key
2791
+ * (e.g. HTTP header name/value pairs).
2792
+ */
2793
+ independentKeyValue?: boolean;
2712
2794
  };
2713
2795
  /**
2714
2796
  * A component to render a sortable key-value input
@@ -2717,212 +2799,9 @@ type KeyValueInputProps<TValue extends string = string> = {
2717
2799
  * return <KeyValueInput value={value} onChange={setValue} />
2718
2800
  * @deprecated This component is in beta, name and props are subject to change without a major version
2719
2801
  */
2720
- declare const KeyValueInput: <TValue extends string = string>({ value, onChange, label, newItemDefault, keyLabel, valueLabel, iconLabel, keyInfoPopover, valueInfoPopover, iconInfoPopover, disabled, errors, onFocusChange, showIconColumn, renderIconSelector, }: KeyValueInputProps<TValue>) => _emotion_react_jsx_runtime.JSX.Element;
2721
-
2722
- type AsideAndSectionLayout = {
2723
- /** sets child components in the aside / supporting column */
2724
- sidebar?: ReactNode;
2725
- /** sets child components in the section / main content column */
2726
- children: ReactNode;
2727
- /** Makes the sidebar sticky to the top of the container
2728
- * @default false
2729
- */
2730
- isStickyAside?: boolean;
2731
- };
2732
- declare const AsideAndSectionLayout: ({ sidebar, children, isStickyAside, }: AsideAndSectionLayout) => _emotion_react_jsx_runtime.JSX.Element;
2733
-
2734
- type SpacingProp = '0' | '2xs' | 'xs' | 'sm' | 'base' | 'md' | 'lg' | 'xl' | '2xl';
2735
- type BackgroundColorProp = 'transparent' | 'white' | 'gray-50' | 'gray-100' | 'gray-200' | 'gray-300' | 'gray-400' | 'gray-500' | 'gray-600' | 'gray-700' | 'gray-800' | 'gray-900';
2736
- type HtmlTagProps = 'div' | 'section' | 'article' | 'aside' | 'span';
2737
- type BorderRadiusProps = 'rounded-sm' | 'rounded-base' | 'rounded-md';
2738
- type CommonContainerProps = {
2739
- /** sets the background color of the element */
2740
- backgroundColor?: BackgroundColorProp;
2741
- /** sets border: 1px solid var(--gray-300)*/
2742
- border?: boolean;
2743
- /** sets the border radius of the element */
2744
- rounded?: BorderRadiusProps;
2745
- /** sets the padding of the element */
2746
- padding?: string;
2747
- /** sets the margin of the element */
2748
- margin?: string;
2749
- };
2750
- type RhythmProps = React.HTMLAttributes<HTMLDivElement | HTMLFieldSetElement> & {
2751
- /** sets the wrapping html tag
2752
- * @default 'div'
2753
- */
2754
- tag?: HtmlTagProps | 'fieldset';
2755
- /** sets the spacing between each element
2756
- * @default 'div'
2757
- */
2758
- gap?: SpacingProp;
2759
- /** sets the alignment of elements
2760
- * @default normal browser behaviour
2761
- */
2762
- align?: CSSProperties['alignItems'];
2763
- justify?: CSSProperties['justifyContent'];
2764
- children: React.ReactNode;
2765
- /** for use when fieldset is applied to the tag prop */
2766
- disabled?: boolean;
2767
- ref?: Ref<HTMLDivElement>;
2768
- };
2769
-
2770
- type ContainerProps = CommonContainerProps & React$1.HTMLAttributes<HTMLDivElement> & {
2771
- tag?: HtmlTagProps;
2772
- children: React$1.ReactNode;
2773
- };
2774
- declare const Container: ({ tag, backgroundColor, border, rounded, padding, margin, children, ...props }: ContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
2775
-
2776
- declare const HorizontalRhythm: ({ align, justify, tag, gap, children, ref, ...props }: RhythmProps) => _emotion_react_jsx_runtime.JSX.Element;
2777
-
2778
- type TwoColumnLayoutProps = {
2779
- /** sets the full bleed background colour
2780
- * @default 'var(--white)'
2781
- */
2782
- bgColor?: 'var(--white)' | 'var(--gray-50)';
2783
- /** sets child components in the aside / supporting column */
2784
- supportingContent?: ReactNode;
2785
- /** sets child components in the section / main content column */
2786
- children?: ReactNode;
2787
- /** inverts the layout placing the aside container on the left
2788
- * @default false
2789
- */
2790
- invertLayout?: boolean;
2791
- };
2792
- /** @example <TwoColumnLayout supportingContent={<div>supporting content</div>}><h1>title</h1></TwoColumnLayout> */
2793
- declare const TwoColumnLayout: ({ bgColor, invertLayout, supportingContent, children, }: TwoColumnLayoutProps) => _emotion_react_jsx_runtime.JSX.Element;
2794
-
2795
- declare const VerticalRhythm: ({ align, justify, tag, gap, children, ref, ...props }: RhythmProps) => _emotion_react_jsx_runtime.JSX.Element;
2796
-
2797
- type LimitsBarProps = {
2798
- /** The current value of used limits */
2799
- current: number;
2800
- /** The maximum number of limits */
2801
- max: number;
2802
- /** @deprecated No longer used */
2803
- label?: string;
2804
- /** Optional popover content for info icon */
2805
- popoverContent?: ReactNode;
2806
- };
2807
- /**
2808
- * Uniform Limits Bar Component
2809
- * @example <LimitsBar current={3} max={5} />
2810
- */
2811
- declare const LimitsBar: ({ current, max, popoverContent }: LimitsBarProps) => _emotion_react_jsx_runtime.JSX.Element;
2812
-
2813
- type LinkListProps = React$1.HTMLAttributes<HTMLDivElement> & {
2814
- /** sets the title field */
2815
- title: string;
2816
- /** (optional) sets react child component */
2817
- children?: React$1.ReactNode;
2818
- };
2819
- declare const LinkList: ({ title, children, ...props }: LinkListProps) => _emotion_react_jsx_runtime.JSX.Element;
2820
-
2821
- type ScrollableListProps = React$1.HTMLAttributes<HTMLDivElement> & {
2822
- /** (optional) sets the label value */
2823
- label?: string;
2824
- /** (optional) allows users to add child components within the container */
2825
- children?: React$1.ReactNode;
2826
- };
2827
- /**
2828
- * Component that sets the base structure for scrollable content in a max height container
2829
- * @example <ScrollableList label="allowed content types"><button>say hello</button></ScrollableList>
2830
- */
2831
- declare const ScrollableList: ({ label, children, ...props }: ScrollableListProps) => _emotion_react_jsx_runtime.JSX.Element;
2832
-
2833
- type ScrollableListContainerProps = {
2834
- /** sets whether to show or hide the shadow around the element
2835
- * @default 'false'
2836
- */
2837
- disableShadow?: boolean;
2838
- /** sets the active style of the button */
2839
- active: boolean;
2840
- };
2841
-
2842
- type ScrollableItemProps = {
2843
- /** sets an element within the label > span element */
2844
- icon?: React.ReactElement;
2845
- /**sets the label value */
2846
- label: string | React.ReactElement;
2847
- /** sets a data-testid on the label */
2848
- labelTestId?: string;
2849
- /** recommended to use a form input element of type radio or checkbox */
2850
- children: React.ReactNode;
2851
- } & ScrollableListContainerProps;
2852
- /** @example <ScrollableListInputItem label="my label" active={true}><input type="radio" name="age" /></ScrollableListInputItem>*/
2853
- declare const ScrollableListInputItem: ({ label, icon, active, disableShadow, children, labelTestId, ...props }: ScrollableItemProps) => _emotion_react_jsx_runtime.JSX.Element;
2854
-
2855
- type ScrollableListItemProps = React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
2856
- /** sets the button text value */
2857
- buttonText: string;
2858
- icon?: React$1.ReactElement;
2859
- } & ScrollableListContainerProps;
2860
- /**
2861
- * Component used within <ScrollableList /> for adding interactive button components with predefined styles
2862
- * @example <ScrollableListItem buttontext="my button" active={false} />
2863
- */
2864
- declare const ScrollableListItem: ({ buttonText, icon, active, disableShadow, ...props }: ScrollableListItemProps) => _emotion_react_jsx_runtime.JSX.Element;
2865
-
2866
- type LoadingIndicatorProps = {
2867
- color?: 'gray' | 'accent-alt';
2868
- size?: 'lg' | 'sm';
2869
- } & Omit<HTMLAttributes<HTMLDivElement>, 'color'>;
2870
- /**
2871
- * Loading Indicator
2872
- * @example <LoadingIndicator />
2873
- */
2874
- declare const LoadingIndicator: ({ size, color, ...props }: LoadingIndicatorProps) => _emotion_react_jsx_runtime.JSX.Element;
2875
-
2876
- interface LoadingOverlayProps {
2877
- /** sets whether to display the loading overlay components */
2878
- isActive: boolean;
2879
- /** (optional) type that sets a text value or React component under the loading icon */
2880
- statusMessage?: string | ReactNode;
2881
- /** (optional) the z-index value of the overlay
2882
- * @default 9999
2883
- */
2884
- zIndex?: number;
2885
- /** (optional) sets the width and height of the loader
2886
- * @default 128
2887
- */
2888
- loaderSize?: number;
2889
- /** (optional) sets the loading overlay background color
2890
- * @default 'var(--white)'
2891
- */
2892
- overlayBackgroundColor?: 'transparent' | 'var(--white)';
2893
- /** (optional) if set to true, the animation of the loading indicator is paused
2894
- * @default false
2895
- */
2896
- isPaused?: boolean;
2897
- /** (optional) aligns the content of the overlay to the top instead of having it centered
2898
- * @default false
2899
- */
2900
- isTopAligned?: boolean;
2901
- children?: React.ReactNode;
2902
- /** (optional) sets the position of the overlay
2903
- * @default 'absolute'
2904
- */
2905
- position?: 'absolute' | 'fixed';
2906
- }
2907
- /**
2908
- * Loading Overlay.
2909
- * NOTE: the container/parent element must have a non-static `position` value for the overlay to work properly.
2910
- * @example <LoadingOverlay isActive={true} statusMessage="Loading..." />
2911
- */
2912
- declare const LoadingOverlay: ({ isActive, statusMessage, zIndex, loaderSize, overlayBackgroundColor, isTopAligned, isPaused, children, position, }: LoadingOverlayProps) => _emotion_react_jsx_runtime.JSX.Element;
2913
- interface LoadingIconProps extends HTMLAttributes<SVGSVGElement> {
2914
- /** (optional) prop that sets a number value for the height of the icon */
2915
- width?: number;
2916
- /** (optional) prop that sets a number value for the width of the icon */
2917
- height?: number;
2918
- }
2919
- /**
2920
- * Loading Icon
2921
- * @example <LoadingIcon height={128} width={128} />
2922
- */
2923
- declare const LoadingIcon: ({ height, width, ...props }: LoadingIconProps) => _emotion_react_jsx_runtime.JSX.Element;
2802
+ declare const KeyValueInput: <TValue extends string = string>({ value, onChange, label, newItemDefault, keyLabel, valueLabel, iconLabel, keyInfoPopover, valueInfoPopover, iconInfoPopover, disabled, errors, onFocusChange, showIconColumn, renderIconSelector, independentKeyValue, }: KeyValueInputProps<TValue>) => _emotion_react_jsx_runtime.JSX.Element;
2924
2803
 
2925
- interface DropdownStyleMenuTriggerProps extends React.HTMLAttributes<HTMLButtonElement> {
2804
+ interface DropdownStyleMenuTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
2926
2805
  children: React.ReactNode;
2927
2806
  /** sets the background color of the button */
2928
2807
  bgColor?: string;
@@ -2931,17 +2810,29 @@ interface DropdownStyleMenuTriggerProps extends React.HTMLAttributes<HTMLButtonE
2931
2810
  */
2932
2811
  variant?: 'ghost' | 'outline';
2933
2812
  }
2934
- /** Renders a dropdown menu style menu trigger button */
2813
+ /**
2814
+ * Renders a dropdown menu style menu trigger button. Marked with
2815
+ * `markNativeButton` so the design system's `Menu` knows to opt into Base UI's
2816
+ * native-button code path even though the React element type is a function
2817
+ * component.
2818
+ */
2935
2819
  declare const DropdownStyleMenuTrigger: React$1.ForwardRefExoticComponent<DropdownStyleMenuTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
2936
2820
 
2937
2821
  declare const legacyPlacements: readonly ["auto", "auto-start", "auto-end"];
2938
2822
  type LegacyPlacement = (typeof legacyPlacements)[number];
2939
- interface MenuProps extends MenuProps$1 {
2940
- /** the component that triggers the menu functionality */
2823
+ /**
2824
+ * @internal Hook used by MenuItem to detect when it is being rendered as the
2825
+ * `render` element of a Base UI SubmenuTrigger, so it can render a plain styled
2826
+ * div instead of `<BaseUIMenu.Item>` (which conflicts with SubmenuTrigger's own
2827
+ * composite-store registration and breaks click handling on submenu children).
2828
+ */
2829
+ declare function useIsSubmenuTriggerMode(): boolean;
2830
+ interface MenuProps extends Pick<React$1.HTMLAttributes<HTMLDivElement>, 'className' | 'id' | 'style'> {
2831
+ /** The component that triggers the menu functionality */
2941
2832
  menuTrigger: React$1.ReactElement & React$1.RefAttributes<any>;
2942
- /** (optional) Ariakit placements options for the expandable menu */
2943
- placement?: MenuStoreProps['placement'] | LegacyPlacement;
2944
- /** (optional) allows users to set additional class names */
2833
+ /** (optional) placement options for the expandable menu */
2834
+ placement?: Placement | LegacyPlacement;
2835
+ /** (optional) allows users to set additional class names */
2945
2836
  menuItemsContainerCssClasses?: SerializedStyles | string;
2946
2837
  /** (optional) allows users to add child elements */
2947
2838
  children?: React$1.ReactNode;
@@ -2956,7 +2847,7 @@ interface MenuProps extends MenuProps$1 {
2956
2847
  * If you need to disable this functionality, set this prop to true.
2957
2848
  */
2958
2849
  disableAutoSeparatorManagement?: boolean;
2959
- /** sets whether to use a React portal rendering or not. */
2850
+ /** Sets whether to use a React portal rendering or not. */
2960
2851
  withoutPortal?: boolean;
2961
2852
  /** (optional) sets the test id attribute */
2962
2853
  testId?: string;
@@ -2965,12 +2856,47 @@ interface MenuProps extends MenuProps$1 {
2965
2856
  * this is not compatible with nested menus that expand to the left or right of the menu
2966
2857
  */
2967
2858
  maxMenuHeight?: string;
2968
- portalElement?: React$1.ComponentProps<typeof Menu$1>['portalElement'];
2969
- /** sets the menu size
2859
+ /** Optional container element for the portal */
2860
+ portalElement?: HTMLElement | null;
2861
+ /** Sets the menu size
2970
2862
  * it's recommended to use the same size for all menu items in a menu
2971
2863
  * @default 'base'
2972
2864
  */
2973
2865
  size?: 'small' | 'base';
2866
+ /** (optional) disables the menu trigger so the menu cannot be opened */
2867
+ disabled?: boolean;
2868
+ /** Controls the open state of the menu (controlled mode) */
2869
+ open?: boolean;
2870
+ /** Called when the menu closes */
2871
+ onClose?: () => void;
2872
+ /** Called when the menu open state changes */
2873
+ onOpenChange?: (open: boolean) => void;
2874
+ /** Distance between the trigger and the menu popup in pixels */
2875
+ gutter?: number;
2876
+ /** Offset along the alignment axis in pixels */
2877
+ shift?: number;
2878
+ /**
2879
+ * Returns a custom anchor rect for positioning the menu.
2880
+ * Used by QuickFilter for custom anchor positioning.
2881
+ */
2882
+ getAnchorRect?: (anchor: HTMLElement | null) => {
2883
+ x?: number;
2884
+ y?: number;
2885
+ width?: number;
2886
+ height?: number;
2887
+ };
2888
+ /**
2889
+ * Controls when the menu repositions.
2890
+ * When provided, disables automatic anchor tracking after initial placement.
2891
+ */
2892
+ updatePosition?: (props: {
2893
+ updatePosition: () => void;
2894
+ }) => void;
2895
+ /**
2896
+ * @deprecated use `withoutPortal={false}` instead (default behavior).
2897
+ * Kept for backward compatibility.
2898
+ */
2899
+ portal?: boolean;
2974
2900
  }
2975
2901
  /**
2976
2902
  * Component used for creating clickable menus
@@ -2982,7 +2908,7 @@ interface MenuProps extends MenuProps$1 {
2982
2908
  * <MenuItem>Item 1</MenuItem>
2983
2909
  * </Menu>
2984
2910
  */
2985
- declare const Menu: React$1.ForwardRefExoticComponent<Omit<MenuProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
2911
+ declare const Menu: React$1.ForwardRefExoticComponent<MenuProps & React$1.RefAttributes<HTMLDivElement>>;
2986
2912
 
2987
2913
  type MenuGroupProps = {
2988
2914
  /** Title for the menu group. If undefined or an empty string, the group will render as normal menu */
@@ -2998,7 +2924,7 @@ declare const MenuGroup: ({ title, children }: MenuGroupProps) => _emotion_react
2998
2924
  * accent-alt - AI color (accent-alt-dark). DOES NOT change the text - only the icon color!
2999
2925
  */
3000
2926
  type MenuItemTextThemeProps = 'base' | 'red' | 'accent-alt';
3001
- type MenuItemProps = MenuItemProps$1 & {
2927
+ type MenuItemProps = Pick<React$1.HTMLAttributes<HTMLDivElement>, 'className' | 'style' | 'tabIndex' | 'id' | 'title' | 'onMouseEnter' | 'onMouseLeave'> & {
3002
2928
  /**
3003
2929
  * Sets child elements within the component.
3004
2930
  * Can be omitted when using the `render` prop
@@ -3006,6 +2932,11 @@ type MenuItemProps = MenuItemProps$1 & {
3006
2932
  children?: ChildFunction | React$1.ReactNode;
3007
2933
  /** (optional) set whether to hide the menu after a click action */
3008
2934
  hideMenuOnClick?: boolean;
2935
+ /**
2936
+ * @deprecated Use `hideMenuOnClick` instead.
2937
+ * Alias kept for backward compatibility.
2938
+ */
2939
+ hideOnClick?: boolean;
3009
2940
  /** (optional) set an icon along side the item text, we recommend using the MenuItemIcon component
3010
2941
  * @example <MenuItemIcon icon="add-r" />
3011
2942
  */
@@ -3026,8 +2957,18 @@ type MenuItemProps = MenuItemProps$1 & {
3026
2957
  * be automatically set to invoke the shortcut's handler function.
3027
2958
  */
3028
2959
  shortcut?: ShortcutReference;
2960
+ /** Click handler for the menu item */
2961
+ onClick?: React$1.MouseEventHandler<HTMLElement>;
2962
+ /** Whether the menu item is disabled */
2963
+ disabled?: boolean;
2964
+ /** Overrides the rendered element */
2965
+ render?: React$1.ReactElement;
2966
+ /** Ref forwarded to the root element */
2967
+ ref?: React$1.Ref<HTMLDivElement>;
2968
+ /** Overrides the text label to use when the item is matched during keyboard text navigation */
2969
+ label?: string;
3029
2970
  };
3030
- type ChildFunction = (menuItemProps: MenuItemProps$1) => React$1.ReactElement | null;
2971
+ type ChildFunction = (menuItemProps: Record<string, unknown>) => React$1.ReactElement | null;
3031
2972
  /**
3032
2973
  * MenuItem Component used along side <Menu /> component
3033
2974
  * @example <MenuItem onClick={() => alert('menu item was clicked')} icon={<RedClose />}>Remove Link</MenuItem>
@@ -3035,8 +2976,8 @@ type ChildFunction = (menuItemProps: MenuItemProps$1) => React$1.ReactElement |
3035
2976
  declare const MenuItem: React$1.ForwardRefExoticComponent<Omit<MenuItemProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
3036
2977
  /**
3037
2978
  * MenuItem Component for headless use outside <Menu /> component
3038
- * Use only if adapting Uniform menu item appearance to a non-ariakit menu.
3039
- * This is required because ariakit does not let you use MenuItem outside of a Menu component.
2979
+ * Use only if adapting Uniform menu item appearance to a non-Base UI menu.
2980
+ * This is required because Base UI does not let you use MenuItem outside of a Menu component.
3040
2981
  * @example <MenuItemInner onClick={() => alert('menu item was clicked')} icon={<RedClose />}>Remove Link</MenuItem>
3041
2982
  */
3042
2983
  declare const MenuItemInner: React$1.FC<MenuItemProps>;
@@ -3059,10 +3000,20 @@ declare const MenuItemSeparator: ({ ...props }: HtmlHTMLAttributes<HTMLHRElement
3059
3000
 
3060
3001
  type MenuButtonProp = {
3061
3002
  children: React.ReactNode;
3062
- } & HTMLAttributes<HTMLButtonElement>;
3003
+ } & ButtonHTMLAttributes<HTMLButtonElement>;
3004
+ /**
3005
+ * Bare `<button type="button">` styled wrapper used as a Menu trigger.
3006
+ *
3007
+ * The `type` attribute is set after `...props` with a fallback so wrappers
3008
+ * such as Base UI's `Menu.Trigger` (which can forward `type: undefined` via
3009
+ * `cloneElement`) cannot accidentally turn this into a submit button when
3010
+ * placed inside a `<form>`. Marked with `markNativeButton` so the design
3011
+ * system's `Menu` component knows to opt into Base UI's native-button code
3012
+ * path.
3013
+ */
3063
3014
  declare const MenuButton: React$1.ForwardRefExoticComponent<{
3064
3015
  children: React.ReactNode;
3065
- } & HTMLAttributes<HTMLButtonElement> & React$1.RefAttributes<HTMLButtonElement>>;
3016
+ } & ButtonHTMLAttributes<HTMLButtonElement> & React$1.RefAttributes<HTMLButtonElement>>;
3066
3017
  type MenuThreeDotsProps = {
3067
3018
  /** sets the aria-label and title value on the button
3068
3019
  * @default 'More options'
@@ -3073,7 +3024,12 @@ type MenuThreeDotsProps = {
3073
3024
  */
3074
3025
  iconSize?: string;
3075
3026
  disabled?: boolean;
3076
- } & HTMLAttributes<HTMLButtonElement>;
3027
+ } & ButtonHTMLAttributes<HTMLButtonElement>;
3028
+ /**
3029
+ * Three-dot ("more options") Menu trigger. Marked as a native-button trigger
3030
+ * so `Menu` reports `nativeButton={true}` to Base UI even though it is a
3031
+ * function component (Base UI inspects the React element's outer `type`).
3032
+ */
3077
3033
  declare const MenuThreeDots: React$1.ForwardRefExoticComponent<{
3078
3034
  /** sets the aria-label and title value on the button
3079
3035
  * @default 'More options'
@@ -3084,14 +3040,18 @@ declare const MenuThreeDots: React$1.ForwardRefExoticComponent<{
3084
3040
  */
3085
3041
  iconSize?: string;
3086
3042
  disabled?: boolean;
3087
- } & HTMLAttributes<HTMLButtonElement> & React$1.RefAttributes<HTMLButtonElement>>;
3043
+ } & ButtonHTMLAttributes<HTMLButtonElement> & React$1.RefAttributes<HTMLButtonElement>>;
3044
+ /**
3045
+ * Select-style Menu trigger that renders the current value with a chevron.
3046
+ * Marked as a native-button trigger for the same reason as `MenuThreeDots`.
3047
+ */
3088
3048
  declare const MenuSelect: React$1.ForwardRefExoticComponent<{
3089
3049
  /** sets the size of the menu select
3090
3050
  * @default 'base'
3091
3051
  */
3092
3052
  size?: "xs" | "sm" | "base" | "md" | "lg";
3093
3053
  children: React.ReactNode;
3094
- } & HTMLAttributes<HTMLButtonElement> & React$1.RefAttributes<HTMLButtonElement>>;
3054
+ } & ButtonHTMLAttributes<HTMLButtonElement> & React$1.RefAttributes<HTMLButtonElement>>;
3095
3055
 
3096
3056
  type SearchableMenuProps = {
3097
3057
  /** Note: this is pre-debounced for your handling enjoyment */
@@ -3102,6 +3062,8 @@ type SearchableMenuProps = {
3102
3062
  disableSearch?: boolean;
3103
3063
  /** Sets the placeholder in the search input */
3104
3064
  searchPlaceholder?: string;
3065
+ /** Called when Enter is pressed in the search input and no highlighted menu item handles the event */
3066
+ onSearchEnterKeyDown?: () => void;
3105
3067
  } & MenuProps;
3106
3068
  /**
3107
3069
  * Searchable menu allows searching through its menu items
@@ -3109,9 +3071,445 @@ type SearchableMenuProps = {
3109
3071
  declare const SearchableMenu: (props: SearchableMenuProps) => _emotion_react_jsx_runtime.JSX.Element;
3110
3072
 
3111
3073
  interface SelectableMenuItemProps extends PropsWithChildren<Omit<MenuItemProps, 'children'>> {
3074
+ /** whether the menu item is selected */
3112
3075
  selected: boolean;
3076
+ /** the styles to use for the selectable menu item
3077
+ * @default 'default'
3078
+ */
3079
+ selectStyles?: 'default' | 'checkbox-select';
3080
+ /** whether the menu item is selectable
3081
+ * @default true
3082
+ */
3083
+ isSelectable?: boolean;
3113
3084
  }
3114
- declare function SelectableMenuItem({ selected, children, ...menuItemProps }: SelectableMenuItemProps): _emotion_react_jsx_runtime.JSX.Element;
3085
+ /**
3086
+ * A {@link MenuItem} that displays a selected state via a leading check icon.
3087
+ *
3088
+ * The component forwards refs to the underlying menu item DOM node so that
3089
+ * Base UI's `SubmenuTrigger` (which clones its `render` element and attaches a
3090
+ * ref for positioning/focus management) works correctly when a
3091
+ * SelectableMenuItem is used as a submenu trigger.
3092
+ */
3093
+ declare const SelectableMenuItem: React$1.ForwardRefExoticComponent<Omit<SelectableMenuItemProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
3094
+
3095
+ type SwatchSize = 'default' | 'small';
3096
+ type SwatchVariant = 'swatch-default' | 'swatch-red' | 'swatch-orange' | 'swatch-yellow' | 'swatch-green' | 'swatch-blue' | 'swatch-purple' | 'swatch-pink' | 'swatch-brown' | 'swatch-gray';
3097
+ type SwatchProps = {
3098
+ /** sets the size of the swatch
3099
+ * @default 'default'
3100
+ */
3101
+ size?: SwatchSize;
3102
+ /** sets the color variant of the swatch
3103
+ * @default 'swatch-default'
3104
+ */
3105
+ variant?: SwatchVariant;
3106
+ /** sets the tooltip of the swatch
3107
+ * @default undefined
3108
+ */
3109
+ tooltip?: string;
3110
+ /** sets the test id of the swatch
3111
+ * @default 'swatch'
3112
+ */
3113
+ testId?: string;
3114
+ };
3115
+ /** @example <Swatch variant="swatch-blue" size="default" /> */
3116
+ declare const Swatch: ({ size, variant, tooltip, testId, }: SwatchProps) => _emotion_react_jsx_runtime.JSX.Element;
3117
+
3118
+ /** Swatch color CSS custom properties
3119
+ * Exports CSS variables for all swatch variants that can be used in other components.
3120
+ * Each variant has --swatch-{variant}-bg and --swatch-{variant}-border variables.
3121
+ * @example <div css={swatchColors}></div>
3122
+ * @example css-in-js my-component { ${swatchColors} }
3123
+ */
3124
+ declare const swatchColors: _emotion_react.SerializedStyles;
3125
+ /**
3126
+ * Swatch variant styles as plain objects.
3127
+ * Works with both Emotion's css prop and react-select's styles API.
3128
+ * @example <div css={swatchVariant['swatch-blue']}></div>
3129
+ * @example styles={{ multiValue: (base, { data }) => ({ ...base, ...swatchVariant[data.color] }) }}
3130
+ */
3131
+ declare const swatchVariant: {
3132
+ readonly 'swatch-default': {
3133
+ readonly '--variant-bg': "var(--swatch-default-bg)";
3134
+ readonly '--variant-border': "var(--swatch-default-border)";
3135
+ };
3136
+ readonly 'swatch-gray': {
3137
+ readonly '--variant-bg': "var(--swatch-gray-bg)";
3138
+ readonly '--variant-border': "var(--swatch-gray-border)";
3139
+ };
3140
+ readonly 'swatch-brown': {
3141
+ readonly '--variant-bg': "var(--swatch-brown-bg)";
3142
+ readonly '--variant-border': "var(--swatch-brown-border)";
3143
+ };
3144
+ readonly 'swatch-orange': {
3145
+ readonly '--variant-bg': "var(--swatch-orange-bg)";
3146
+ readonly '--variant-border': "var(--swatch-orange-border)";
3147
+ };
3148
+ readonly 'swatch-yellow': {
3149
+ readonly '--variant-bg': "var(--swatch-yellow-bg)";
3150
+ readonly '--variant-border': "var(--swatch-yellow-border)";
3151
+ };
3152
+ readonly 'swatch-green': {
3153
+ readonly '--variant-bg': "var(--swatch-green-bg)";
3154
+ readonly '--variant-border': "var(--swatch-green-border)";
3155
+ };
3156
+ readonly 'swatch-blue': {
3157
+ readonly '--variant-bg': "var(--swatch-blue-bg)";
3158
+ readonly '--variant-border': "var(--swatch-blue-border)";
3159
+ };
3160
+ readonly 'swatch-purple': {
3161
+ readonly '--variant-bg': "var(--swatch-purple-bg)";
3162
+ readonly '--variant-border': "var(--swatch-purple-border)";
3163
+ };
3164
+ readonly 'swatch-pink': {
3165
+ readonly '--variant-bg': "var(--swatch-pink-bg)";
3166
+ readonly '--variant-border': "var(--swatch-pink-border)";
3167
+ };
3168
+ readonly 'swatch-red': {
3169
+ readonly '--variant-bg': "var(--swatch-red-bg)";
3170
+ readonly '--variant-border': "var(--swatch-red-border)";
3171
+ };
3172
+ };
3173
+
3174
+ /**
3175
+ * SwatchComboBoxLabelStyles provides custom styles for react-select's multiValue and multiValueLabel.
3176
+ * Dynamically applies color based on each option's color property.
3177
+ * @returns A StylesConfig object with customized styles.
3178
+ */
3179
+ declare const SwatchComboBoxLabelStyles: <TOption, IsMulti extends boolean = boolean, TGroup extends ComboBoxGroupBase<TOption> = ComboBoxGroupBase<TOption>>() => StylesConfig<TOption, IsMulti, TGroup>;
3180
+ declare function SwatchComboBox<TOption = InputComboBoxOption & {
3181
+ color: SwatchVariant;
3182
+ }, IsMulti extends boolean = false, TGroup extends ComboBoxGroupBase<TOption> = ComboBoxGroupBase<TOption>>({ labelTitle, caption, isMulti, ...props }: InputComboBoxProps<TOption, IsMulti, TGroup> & {
3183
+ labelTitle?: string;
3184
+ caption?: string;
3185
+ isMulti?: boolean;
3186
+ }): _emotion_react_jsx_runtime.JSX.Element;
3187
+
3188
+ type SwatchLabelProps = {
3189
+ /** Sets the color variant of the swatch label
3190
+ * @default 'swatch-default'
3191
+ */
3192
+ variant?: SwatchVariant;
3193
+ /** The text to display inside the swatch label */
3194
+ label: string;
3195
+ /** The size of the swatch label
3196
+ * @default 'default'
3197
+ */
3198
+ size?: 'xs' | 'sm' | 'md';
3199
+ /** The right slot to display inside the swatch label */
3200
+ rightSlot?: React.ReactNode;
3201
+ /** The tooltip to display inside the swatch label */
3202
+ tooltip?: string | React.ReactElement;
3203
+ /** The left slot to display inside the swatch label */
3204
+ leftSlot?: React.ReactNode;
3205
+ };
3206
+ /**
3207
+ * A colored label component that uses the same color variants as Swatch.
3208
+ * @example <SwatchLabel variant="swatch-blue" label="Blue Label" />
3209
+ */
3210
+ declare const SwatchLabel: ({ variant, size, label, rightSlot, tooltip, leftSlot, }: SwatchLabelProps) => _emotion_react_jsx_runtime.JSX.Element;
3211
+ declare const SwatchLabelRemoveButton: ({ onRemove, size, }: {
3212
+ /** The function to call when the remove button is clicked */
3213
+ onRemove: () => void;
3214
+ /** The size of the remove button
3215
+ * @default 'sm'
3216
+ */
3217
+ size?: SwatchLabelProps["size"];
3218
+ }) => _emotion_react_jsx_runtime.JSX.Element;
3219
+ /**
3220
+ * A tooltip component that displays a swatch label with a parent title and a description.
3221
+ * @example <SwatchLabelTooltip parentTitle="Parent Title" title="Title" description="Description" />
3222
+ */
3223
+ declare const SwatchLabelTooltip: ({ parentTitle, title, description, }: {
3224
+ parentTitle?: string | React.ReactElement;
3225
+ title?: string | React.ReactElement;
3226
+ description?: string | React.ReactElement;
3227
+ }) => _emotion_react_jsx_runtime.JSX.Element;
3228
+
3229
+ /** Represents a label item that can be displayed in the quick filter */
3230
+ type LabelsQuickFilterItem = {
3231
+ /** Unique identifier for the label */
3232
+ id: string;
3233
+ /** Display name for the label */
3234
+ name: string;
3235
+ /** Optional swatch variant color */
3236
+ variant?: SwatchVariant;
3237
+ /** Optional tooltip content */
3238
+ tooltip?: string | React.ReactElement;
3239
+ /** Whether this item represents a group header */
3240
+ isGroup?: boolean;
3241
+ /** The parent group ID if this label belongs to a group */
3242
+ parent?: string;
3243
+ };
3244
+ type LabelsQuickFilterProps = {
3245
+ /** The text to display on the filter button */
3246
+ buttonText: string;
3247
+ /** The text to display on the add button */
3248
+ addButtonText?: string | null;
3249
+ /** All available label items (including groups and children) */
3250
+ items: LabelsQuickFilterItem[];
3251
+ /** Set or array of currently selected item IDs */
3252
+ selectedIds: Set<string> | string[];
3253
+ /** Callback when a label is selected */
3254
+ onSelect: (item: LabelsQuickFilterItem) => void;
3255
+ /** Callback when a label is deselected */
3256
+ onDeselect: (id: string) => void;
3257
+ /** Whether the filter is disabled */
3258
+ disabled?: boolean;
3259
+ /** Test ID for the component */
3260
+ testId?: string;
3261
+ /** Override the total results count (defaults to items.length excluding groups) */
3262
+ totalResults?: number;
3263
+ /** handles creating a new label */
3264
+ onCreateLabel?: (label: string) => void;
3265
+ /** sets whether to use a React portal rendering or not. */
3266
+ withoutPortal?: boolean;
3267
+ /**
3268
+ * The maximum width of the quick filter container.
3269
+ * Useful for controlling the maximum width of the filter in different layouts (e.g., responsive sidebars).
3270
+ * @default '4rem'
3271
+ */
3272
+ maxContainerSize?: string;
3273
+ /** the function to call when the quick filter is opened */
3274
+ onOpen?: () => void;
3275
+ /** the function to call when the quick filter is closed */
3276
+ onClose?: () => void;
3277
+ /**
3278
+ * Override the placement of the dropdown menu.
3279
+ * @default 'right-start'
3280
+ */
3281
+ menuPlacement?: MenuProps['placement'];
3282
+ /**
3283
+ * Override the anchor rect for custom menu positioning.
3284
+ * Pass `null` to disable the built-in default and use standard positioning.
3285
+ */
3286
+ menuGetAnchorRect?: ((anchor: HTMLElement | null) => {
3287
+ x?: number;
3288
+ y?: number;
3289
+ width?: number;
3290
+ height?: number;
3291
+ }) | null;
3292
+ /**
3293
+ * Override the updatePosition callback to control when the menu repositions.
3294
+ * Pass `null` to disable the built-in default (position freezing) and allow normal repositioning.
3295
+ */
3296
+ menuUpdatePosition?: MenuProps['updatePosition'] | null;
3297
+ /** the maximum number of results to display
3298
+ * @default 0 (no limit)
3299
+ */
3300
+ maxCount?: number;
3301
+ };
3302
+ /**
3303
+ * A reusable quick filter component for selecting labels with swatch colors.
3304
+ * Supports flat labels and grouped labels with nested menus.
3305
+ * @example <LabelsQuickFilter buttonText="Filter by label" items={labels} selectedIds={selectedSet} onSelect={handleSelect} onDeselect={handleDeselect} />
3306
+ */
3307
+ declare const LabelsQuickFilter: ({ buttonText, addButtonText, items, selectedIds, onSelect, onDeselect, disabled, testId, totalResults, onCreateLabel, withoutPortal, maxContainerSize, onOpen, onClose, menuPlacement, menuGetAnchorRect, menuUpdatePosition, maxCount, }: LabelsQuickFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
3308
+
3309
+ type AsideAndSectionLayout = {
3310
+ /** sets child components in the aside / supporting column */
3311
+ sidebar?: ReactNode;
3312
+ /** sets child components in the section / main content column */
3313
+ children: ReactNode;
3314
+ /** Makes the sidebar sticky to the top of the container
3315
+ * @default false
3316
+ */
3317
+ isStickyAside?: boolean;
3318
+ };
3319
+ declare const AsideAndSectionLayout: ({ sidebar, children, isStickyAside, }: AsideAndSectionLayout) => _emotion_react_jsx_runtime.JSX.Element;
3320
+
3321
+ type SpacingProp = '0' | '2xs' | 'xs' | 'sm' | 'base' | 'md' | 'lg' | 'xl' | '2xl';
3322
+ type BackgroundColorProp = 'transparent' | 'white' | 'gray-50' | 'gray-100' | 'gray-200' | 'gray-300' | 'gray-400' | 'gray-500' | 'gray-600' | 'gray-700' | 'gray-800' | 'gray-900';
3323
+ type HtmlTagProps = 'div' | 'section' | 'article' | 'aside' | 'span';
3324
+ type BorderRadiusProps = 'rounded-sm' | 'rounded-base' | 'rounded-md';
3325
+ type CommonContainerProps = {
3326
+ /** sets the background color of the element */
3327
+ backgroundColor?: BackgroundColorProp;
3328
+ /** sets border: 1px solid var(--gray-300)*/
3329
+ border?: boolean;
3330
+ /** sets the border radius of the element */
3331
+ rounded?: BorderRadiusProps;
3332
+ /** sets the padding of the element */
3333
+ padding?: string;
3334
+ /** sets the margin of the element */
3335
+ margin?: string;
3336
+ };
3337
+ type RhythmProps = React.HTMLAttributes<HTMLDivElement | HTMLFieldSetElement> & {
3338
+ /** sets the wrapping html tag
3339
+ * @default 'div'
3340
+ */
3341
+ tag?: HtmlTagProps | 'fieldset';
3342
+ /** sets the spacing between each element
3343
+ * @default 'div'
3344
+ */
3345
+ gap?: SpacingProp;
3346
+ /** sets the alignment of elements
3347
+ * @default normal browser behaviour
3348
+ */
3349
+ align?: CSSProperties['alignItems'];
3350
+ justify?: CSSProperties['justifyContent'];
3351
+ children: React.ReactNode;
3352
+ /** for use when fieldset is applied to the tag prop */
3353
+ disabled?: boolean;
3354
+ ref?: Ref<HTMLDivElement>;
3355
+ };
3356
+
3357
+ type ContainerProps = CommonContainerProps & React$1.HTMLAttributes<HTMLDivElement> & {
3358
+ tag?: HtmlTagProps;
3359
+ children: React$1.ReactNode;
3360
+ };
3361
+ declare const Container: ({ tag, backgroundColor, border, rounded, padding, margin, children, ...props }: ContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
3362
+
3363
+ declare const HorizontalRhythm: ({ align, justify, tag, gap, children, ref, ...props }: RhythmProps) => _emotion_react_jsx_runtime.JSX.Element;
3364
+
3365
+ type TwoColumnLayoutProps = {
3366
+ /** sets the full bleed background colour
3367
+ * @default 'var(--white)'
3368
+ */
3369
+ bgColor?: 'var(--white)' | 'var(--gray-50)';
3370
+ /** sets child components in the aside / supporting column */
3371
+ supportingContent?: ReactNode;
3372
+ /** sets child components in the section / main content column */
3373
+ children?: ReactNode;
3374
+ /** inverts the layout placing the aside container on the left
3375
+ * @default false
3376
+ */
3377
+ invertLayout?: boolean;
3378
+ };
3379
+ /** @example <TwoColumnLayout supportingContent={<div>supporting content</div>}><h1>title</h1></TwoColumnLayout> */
3380
+ declare const TwoColumnLayout: ({ bgColor, invertLayout, supportingContent, children, }: TwoColumnLayoutProps) => _emotion_react_jsx_runtime.JSX.Element;
3381
+
3382
+ declare const VerticalRhythm: ({ align, justify, tag, gap, children, ref, ...props }: RhythmProps) => _emotion_react_jsx_runtime.JSX.Element;
3383
+
3384
+ type LimitsBarProps = {
3385
+ /** The current value of used limits */
3386
+ current: number;
3387
+ /** The maximum number of limits */
3388
+ max: number;
3389
+ /** @deprecated No longer used */
3390
+ label?: string;
3391
+ /** Optional popover content for info icon */
3392
+ popoverContent?: ReactNode;
3393
+ /** Optional css value passed to the background color of the bar. Leave empty for dynamic color based on usage percentage. */
3394
+ barColor?: string;
3395
+ } & React.HTMLAttributes<HTMLDivElement>;
3396
+ /**
3397
+ * Uniform Limits Bar Component
3398
+ * @example <LimitsBar current={3} max={5} />
3399
+ */
3400
+ declare const LimitsBar: ({ current, max, popoverContent, barColor, ...props }: LimitsBarProps) => _emotion_react_jsx_runtime.JSX.Element;
3401
+
3402
+ type LinkListProps = React$1.HTMLAttributes<HTMLDivElement> & {
3403
+ /** sets the title field */
3404
+ title: string;
3405
+ /** (optional) sets react child component */
3406
+ children?: React$1.ReactNode;
3407
+ };
3408
+ declare const LinkList: ({ title, children, ...props }: LinkListProps) => _emotion_react_jsx_runtime.JSX.Element;
3409
+
3410
+ type ScrollableListProps = React$1.HTMLAttributes<HTMLDivElement> & {
3411
+ /** (optional) sets the label value */
3412
+ label?: string;
3413
+ /** (optional) allows users to add child components within the container */
3414
+ children?: React$1.ReactNode;
3415
+ };
3416
+ /**
3417
+ * Component that sets the base structure for scrollable content in a max height container
3418
+ * @example <ScrollableList label="allowed content types"><button>say hello</button></ScrollableList>
3419
+ */
3420
+ declare const ScrollableList: ({ label, children, ...props }: ScrollableListProps) => _emotion_react_jsx_runtime.JSX.Element;
3421
+
3422
+ type ScrollableListContainerProps = {
3423
+ /** sets whether to show or hide the shadow around the element
3424
+ * @default 'false'
3425
+ */
3426
+ disableShadow?: boolean;
3427
+ /** sets the active style of the button */
3428
+ active: boolean;
3429
+ };
3430
+
3431
+ type ScrollableItemProps = {
3432
+ /** sets an element within the label > span element */
3433
+ icon?: React.ReactElement;
3434
+ /**sets the label value */
3435
+ label: string | React.ReactElement;
3436
+ /** sets a data-testid on the label */
3437
+ labelTestId?: string;
3438
+ /** recommended to use a form input element of type radio or checkbox */
3439
+ children: React.ReactNode;
3440
+ } & ScrollableListContainerProps;
3441
+ /** @example <ScrollableListInputItem label="my label" active={true}><input type="radio" name="age" /></ScrollableListInputItem>*/
3442
+ declare const ScrollableListInputItem: ({ label, icon, active, disableShadow, children, labelTestId, ...props }: ScrollableItemProps) => _emotion_react_jsx_runtime.JSX.Element;
3443
+
3444
+ type ScrollableListItemProps = React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
3445
+ /** sets the button text value */
3446
+ buttonText: string;
3447
+ icon?: React$1.ReactElement;
3448
+ } & ScrollableListContainerProps;
3449
+ /**
3450
+ * Component used within <ScrollableList /> for adding interactive button components with predefined styles
3451
+ * @example <ScrollableListItem buttontext="my button" active={false} />
3452
+ */
3453
+ declare const ScrollableListItem: ({ buttonText, icon, active, disableShadow, ...props }: ScrollableListItemProps) => _emotion_react_jsx_runtime.JSX.Element;
3454
+
3455
+ type LoadingIndicatorProps = {
3456
+ color?: 'gray' | 'accent-alt';
3457
+ size?: 'lg' | 'sm';
3458
+ } & Omit<HTMLAttributes<HTMLDivElement>, 'color'>;
3459
+ /**
3460
+ * Loading Indicator
3461
+ * @example <LoadingIndicator />
3462
+ */
3463
+ declare const LoadingIndicator: ({ size, color, ...props }: LoadingIndicatorProps) => _emotion_react_jsx_runtime.JSX.Element;
3464
+
3465
+ interface LoadingOverlayProps {
3466
+ /** sets whether to display the loading overlay components */
3467
+ isActive: boolean;
3468
+ /** (optional) type that sets a text value or React component under the loading icon */
3469
+ statusMessage?: string | ReactNode;
3470
+ /** (optional) the z-index value of the overlay
3471
+ * @default 9999
3472
+ */
3473
+ zIndex?: number;
3474
+ /** (optional) sets the width and height of the loader
3475
+ * @default 128
3476
+ */
3477
+ loaderSize?: number;
3478
+ /** (optional) sets the loading overlay background color
3479
+ * @default 'var(--white)'
3480
+ */
3481
+ overlayBackgroundColor?: 'transparent' | 'var(--white)';
3482
+ /** (optional) if set to true, the animation of the loading indicator is paused
3483
+ * @default false
3484
+ */
3485
+ isPaused?: boolean;
3486
+ /** (optional) aligns the content of the overlay to the top instead of having it centered
3487
+ * @default false
3488
+ */
3489
+ isTopAligned?: boolean;
3490
+ children?: React.ReactNode;
3491
+ /** (optional) sets the position of the overlay
3492
+ * @default 'absolute'
3493
+ */
3494
+ position?: 'absolute' | 'fixed';
3495
+ }
3496
+ /**
3497
+ * Loading Overlay.
3498
+ * NOTE: the container/parent element must have a non-static `position` value for the overlay to work properly.
3499
+ * @example <LoadingOverlay isActive={true} statusMessage="Loading..." />
3500
+ */
3501
+ declare const LoadingOverlay: ({ isActive, statusMessage, zIndex, loaderSize, overlayBackgroundColor, isTopAligned, isPaused, children, position, }: LoadingOverlayProps) => _emotion_react_jsx_runtime.JSX.Element;
3502
+ interface LoadingIconProps extends HTMLAttributes<SVGSVGElement> {
3503
+ /** (optional) prop that sets a number value for the height of the icon */
3504
+ width?: number;
3505
+ /** (optional) prop that sets a number value for the width of the icon */
3506
+ height?: number;
3507
+ }
3508
+ /**
3509
+ * Loading Icon
3510
+ * @example <LoadingIcon height={128} width={128} />
3511
+ */
3512
+ declare const LoadingIcon: ({ height, width, ...props }: LoadingIconProps) => _emotion_react_jsx_runtime.JSX.Element;
3115
3513
 
3116
3514
  type ModalProps = {
3117
3515
  header?: React__default.ReactNode;
@@ -3152,120 +3550,315 @@ declare const Modal: React__default.ForwardRefExoticComponent<Omit<ModalProps, "
3152
3550
  type ModalDialogProps = Omit<ModalProps, 'width'>;
3153
3551
  declare const ModalDialog: React$1.ForwardRefExoticComponent<Omit<ModalDialogProps, "ref"> & React$1.RefAttributes<HTMLDialogElement>>;
3154
3552
 
3553
+ /**
3554
+ * Context for passing a portal container element to child popover/menu components
3555
+ * rendered inside a Modal. This ensures floating elements render into the dialog
3556
+ * instead of document.body, preventing clipping by the modal's overflow.
3557
+ */
3558
+ declare const ModalPortalContext: React$1.Context<HTMLElement | null>;
3559
+ declare function useModalPortalContainer(): HTMLElement | null;
3560
+
3561
+ /**
3562
+ * Tracks the stack of currently open native `<dialog>` elements that have been
3563
+ * promoted to the browser's top layer via `HTMLDialogElement.showModal()`.
3564
+ *
3565
+ * Anything portalled to `document.body` is rendered behind any top-layer
3566
+ * dialog, which means toasts (whose Base UI portal defaults to `body`) would
3567
+ * be hidden behind an open modal. By keeping a shared stack here we can hand
3568
+ * the topmost dialog to `BaseToast.Portal`'s `container` prop and have toasts
3569
+ * portal _into_ that dialog while it is open, then fall back to `body` when no
3570
+ * modal is on screen.
3571
+ *
3572
+ * The stack supports nested modals — each `Modal` registers on mount /
3573
+ * `showModal()` and unregisters on cleanup, and listeners always receive the
3574
+ * topmost (last-pushed) entry.
3575
+ */
3576
+ /**
3577
+ * Push a dialog element onto the stack. Intended to be called by `Modal`
3578
+ * immediately after `showModal()` so the dialog can become the active toast
3579
+ * portal target.
3580
+ */
3581
+ declare const pushTopLayerDialog: (dialog: HTMLDialogElement) => void;
3582
+ /**
3583
+ * Remove a dialog element from the stack. Safe to call even if the dialog is
3584
+ * not currently in the stack (no-op in that case).
3585
+ */
3586
+ declare const popTopLayerDialog: (dialog: HTMLDialogElement) => void;
3587
+ /**
3588
+ * Subscribe to changes to the topmost open dialog. The listener is invoked
3589
+ * immediately with the current top (or `null` if no dialog is open) so
3590
+ * subscribers don't need a separate initial read.
3591
+ *
3592
+ * @returns A teardown function that removes the listener.
3593
+ */
3594
+ declare const subscribeTopLayerDialog: (listener: (top: HTMLDialogElement | null) => void) => (() => void);
3595
+
3596
+ /** Props for {@link ObjectGridContainer}. */
3155
3597
  type ObjectGridContainerProps = {
3156
- /** The number of columns in the grid
3598
+ /** Number of columns in the grid, passed to CSS `repeat()`.
3599
+ * Accepts a number (e.g. `3`) or any valid `repeat()` track value (e.g. `'auto-fill, minmax(200px, 1fr)'`).
3157
3600
  * @default 3
3158
- * the expected values should follow css repeat() function values
3159
- * see https://developer.mozilla.org/en-US/docs/Web/CSS/repeat#syntax for examples
3601
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/repeat#syntax
3160
3602
  */
3161
3603
  gridCount?: string | number;
3162
- /** The children to render */
3604
+ /** Grid item children typically {@link ObjectGridItem} or {@link ObjectGridItemLoadingSkeleton} elements. */
3163
3605
  children: React.ReactNode;
3164
3606
  };
3607
+ /**
3608
+ * CSS Grid container for laying out {@link ObjectGridItem} elements in a responsive grid.
3609
+ * Supports forwarding a ref to the underlying `<div>`.
3610
+ *
3611
+ * @example
3612
+ * ```tsx
3613
+ * <ObjectGridContainer gridCount={4}>
3614
+ * <ObjectGridItem header={<ObjectGridItemHeading heading="Item" />} cover={...} />
3615
+ * </ObjectGridContainer>
3616
+ * ```
3617
+ */
3165
3618
  declare const ObjectGridContainer: React$1.ForwardRefExoticComponent<ObjectGridContainerProps & React$1.RefAttributes<HTMLDivElement>>;
3166
3619
 
3620
+ /** Shared props for heading components used across list and grid Object items. */
3167
3621
  type ObjectHeadingProps = {
3168
- /** sets the heading value */
3622
+ /** The heading content to display. */
3169
3623
  heading: ReactNode;
3170
- /** Slot that renders a component before the heading */
3624
+ /** Slot rendered before the heading text (e.g. an icon or status indicator). */
3171
3625
  beforeHeadingSlot?: ReactNode;
3172
- /** Slot that renders a component after the heading */
3626
+ /** Slot rendered after the heading text (e.g. a badge or chip). */
3173
3627
  afterHeadingSlot?: ReactNode;
3174
- /** sets the heading tooltip */
3628
+ /** Tooltip text shown on hover when the heading is truncated. */
3175
3629
  tooltip?: string;
3176
3630
  };
3631
+ /**
3632
+ * Shared props for Object item components ({@link ObjectListItem} and {@link ObjectGridItem}).
3633
+ * Defines the common slot-based API for composing item layouts.
3634
+ */
3177
3635
  type ObjectItemProps = {
3178
- /** Slot for the header component, we recommend using <ObjectGridItemHeading /> or <ObjectListItemHeading /> */
3636
+ /** Slot for the header use {@link ObjectGridItemHeading} or {@link ObjectListItemHeading}. */
3179
3637
  header: ReactNode;
3180
- /** Slot for the cover component, we recommend using <ObjectGridItemCoverButton />, <ObjectGridItemCover /> or <ObjectListItemCover /> */
3638
+ /** Slot for the cover media use {@link ObjectGridItemCoverButton}, {@link ObjectGridItemCover}, or {@link ObjectListItemCover}. */
3181
3639
  cover: ReactNode;
3182
- /** Slot for the right component */
3640
+ /** Slot rendered on the right side of the item (e.g. timestamps, status badges). */
3183
3641
  rightSlot?: React.ReactNode;
3184
- /** Slot for the menu items, <MenuItem /> component should be used here */
3642
+ /** Slot for the left component */
3643
+ leftSlot?: React.ReactNode;
3644
+ /** Slot for context menu items — pass `<MenuItem />` elements here. When provided, a three-dot menu trigger is rendered automatically. */
3185
3645
  menuItems?: React.ReactNode;
3186
- /** If the item is selected */
3646
+ /** Whether the item is visually marked as selected via `aria-selected`. */
3187
3647
  isSelected?: boolean;
3188
- /** Slot for the children */
3648
+ /** Additional child content rendered below the header (only visible in `renderAs="multi"` mode for list items). */
3189
3649
  children?: React.ReactNode;
3190
3650
  };
3191
3651
 
3192
- type ObjectGridItemProps = ObjectItemProps & {
3652
+ /** Props for {@link ObjectGridItem}. */
3653
+ type ObjectGridItemProps = Omit<ObjectItemProps, 'leftSlot'> & {
3654
+ /** Whether the item is visually marked as selected. */
3193
3655
  isSelected?: boolean;
3194
- /** sets the menu test id
3195
- * @default object-grid-item-menu-btn
3656
+ /** Override the `data-testid` on the context menu trigger button.
3657
+ * @default 'object-grid-item-menu-btn'
3196
3658
  */
3197
3659
  menuTestId?: string;
3198
3660
  } & HTMLAttributes<HTMLDivElement>;
3661
+ /**
3662
+ * A card-style grid item for displaying an object with cover media, heading, subtitle, and optional context menu.
3663
+ *
3664
+ * When an `onClick` handler is provided, the entire card becomes clickable with hover styles.
3665
+ * Menu and right-slot interactions use `stopPropagation` to prevent triggering the card click.
3666
+ * Wrap items with {@link ObjectGridContainer} for responsive grid layout.
3667
+ *
3668
+ * @example
3669
+ * ```tsx
3670
+ * <ObjectGridItem
3671
+ * cover={<ObjectGridItemCover imageUrl="/thumb.jpg" icon={uniformComposition} />}
3672
+ * header={<ObjectGridItemHeading heading="My composition" tooltip="My composition" />}
3673
+ * rightSlot={<StatusBullet status="published" />}
3674
+ * menuItems={<MenuItem onClick={onEdit}>Edit</MenuItem>}
3675
+ * onClick={handleOpen}
3676
+ * />
3677
+ * ```
3678
+ */
3199
3679
  declare const ObjectGridItem: ({ header, cover, rightSlot, menuItems, isSelected, children, menuTestId, ...props }: ObjectGridItemProps) => _emotion_react_jsx_runtime.JSX.Element;
3200
3680
 
3681
+ /**
3682
+ * Props for {@link ObjectGridItemCardCover}.
3683
+ * Pass **either** an `icon` or an `imageUrl` — the component renders the appropriate variant.
3684
+ */
3201
3685
  type ObjectGridItemCardCoverProps = {
3202
- icon: IconType;
3203
- iconColor?: 'currentColor' | 'accent-dark' | 'accent-alt-dark';
3686
+ /** Icon to render as the card cover. */ icon: IconType;
3687
+ /** Color applied to the icon. */ iconColor?: 'currentColor' | 'accent-dark' | 'accent-alt-dark';
3204
3688
  } | {
3205
- imageUrl: string;
3206
- srcSet?: string;
3207
- alt?: string;
3208
- errorFallbackSrc?: string;
3689
+ /** URL of the image to render as the card cover. */ imageUrl: string;
3690
+ /** Optional `srcSet` for responsive images. */ srcSet?: string;
3691
+ /** Alt text for the image. */ alt?: string;
3692
+ /** Fallback image URL shown when the primary image fails to load. */ errorFallbackSrc?: string;
3209
3693
  };
3694
+ /**
3695
+ * Low-level cover media for a grid card — renders either a lazy-loaded image
3696
+ * or an icon with a ghost background. Typically used via {@link ObjectGridItemCover}
3697
+ * rather than directly.
3698
+ */
3210
3699
  declare const ObjectGridItemCardCover: (props: ObjectGridItemCardCoverProps) => _emotion_react_jsx_runtime.JSX.Element | undefined;
3700
+ /**
3701
+ * Props for {@link ObjectGridItemCover}.
3702
+ * Extends {@link ObjectGridItemCardCoverProps} with overlay slots at each corner.
3703
+ */
3211
3704
  type ObjectGridItemCoverProps = {
3212
- /** The left slot to render components */
3705
+ /** Slot positioned at the top-left of the cover (e.g. a selection checkbox). */
3213
3706
  coverSlotLeft?: React.ReactNode;
3214
- /** The right slot to render components */
3707
+ /** Slot positioned at the top-right of the cover (e.g. a favourite icon). */
3215
3708
  coverSlotRight?: React.ReactNode;
3216
- /** The bottom left slot to render components */
3709
+ /** Slot positioned at the bottom-left of the cover. */
3217
3710
  coverSlotBottomLeft?: React.ReactNode;
3218
- /** The bottom right slot to render components */
3711
+ /** Slot positioned at the bottom-right of the cover (e.g. a status chip). */
3219
3712
  coverSlotBottomRight?: React.ReactNode;
3220
3713
  } & ObjectGridItemCardCoverProps;
3714
+ /**
3715
+ * Grid item cover with corner overlay slots for badges, checkboxes, or status indicators.
3716
+ * Wraps {@link ObjectGridItemCardCover} and positions slot content at each corner.
3717
+ *
3718
+ * @example
3719
+ * ```tsx
3720
+ * <ObjectGridItemCover
3721
+ * imageUrl="/thumb.jpg"
3722
+ * coverSlotRight={<Chip text="New" />}
3723
+ * />
3724
+ * ```
3725
+ */
3221
3726
  declare const ObjectGridItemCover: ({ coverSlotLeft, coverSlotRight, coverSlotBottomLeft, coverSlotBottomRight, ...props }: ObjectGridItemCoverProps) => _emotion_react_jsx_runtime.JSX.Element;
3727
+ /**
3728
+ * Props for {@link ObjectGridItemCoverButton}.
3729
+ * The `coverSlotBottomRight` is reserved for the selection chip and cannot be overridden.
3730
+ */
3222
3731
  type ObjectGridItemCoverButtonProps = {
3732
+ /** Unique identifier passed back to `onSelection` when the cover is clicked. */
3223
3733
  id: string;
3734
+ /** Callback fired when the cover button is clicked. */
3224
3735
  onSelection: (id: string) => void;
3736
+ /** Whether this cover is currently selected — renders a chip in the bottom-right corner. */
3225
3737
  isSelected?: boolean;
3738
+ /** Label text shown on the selection chip.
3739
+ * @default 'selected'
3740
+ */
3226
3741
  selectedText?: string;
3227
3742
  } & Omit<ObjectGridItemCoverProps, 'coverSlotBottomRight'> & ObjectGridItemCardCoverProps;
3743
+ /**
3744
+ * Clickable variant of {@link ObjectGridItemCover} that acts as a selection toggle.
3745
+ * When selected, a chip with `selectedText` appears in the bottom-right corner.
3746
+ * Click events are stopped from propagating to parent elements.
3747
+ *
3748
+ * @example
3749
+ * ```tsx
3750
+ * <ObjectGridItemCoverButton
3751
+ * id={item.id}
3752
+ * imageUrl={item.thumbnail}
3753
+ * isSelected={selectedId === item.id}
3754
+ * onSelection={setSelectedId}
3755
+ * />
3756
+ * ```
3757
+ */
3228
3758
  declare const ObjectGridItemCoverButton: ({ id, isSelected, onSelection, selectedText, ...props }: ObjectGridItemCoverButtonProps) => _emotion_react_jsx_runtime.JSX.Element;
3229
3759
 
3760
+ /** Props for {@link ObjectGridItemHeading}. */
3230
3761
  type ObjectGridItemTitleProps = ObjectHeadingProps & HTMLAttributes<HTMLDivElement>;
3762
+ /**
3763
+ * Heading component designed for use inside {@link ObjectGridItem}'s `header` slot.
3764
+ *
3765
+ * Automatically detects when the heading text is truncated (via a `ResizeObserver`)
3766
+ * and shows the `tooltip` on hover so users can still read the full title.
3767
+ * Click events on `beforeHeadingSlot` and `afterHeadingSlot` are stopped from propagating
3768
+ * to the parent grid item.
3769
+ *
3770
+ * @example
3771
+ * ```tsx
3772
+ * <ObjectGridItemHeading
3773
+ * heading="My composition"
3774
+ * tooltip="My composition"
3775
+ * beforeHeadingSlot={<Icon icon={uniformComposition} />}
3776
+ * />
3777
+ * ```
3778
+ */
3231
3779
  declare const ObjectGridItemHeading: ({ heading, beforeHeadingSlot, afterHeadingSlot, tooltip, ...props }: ObjectGridItemTitleProps) => _emotion_react_jsx_runtime.JSX.Element;
3232
3780
 
3781
+ /** Props for {@link ObjectGridItemIconWithTooltip}. */
3233
3782
  type ObjectGridItemIconWithTooltipProps = {
3234
- /** The title of the tooltip */
3783
+ /** Text shown inside the tooltip on hover. */
3235
3784
  tooltipTitle: string;
3236
- /** The icon to display */
3785
+ /** The icon to render. */
3237
3786
  icon: IconType;
3238
- /** The color of the icon */
3787
+ /** Color applied to the icon.
3788
+ * @default 'accent-dark'
3789
+ */
3239
3790
  iconColor?: IconColor;
3240
3791
  } & Pick<TooltipProps, 'placement' | 'withoutPortal'>;
3792
+ /**
3793
+ * Small icon with a tooltip, designed for the `rightSlot` of {@link ObjectGridItem}.
3794
+ * Useful for showing contextual indicators (e.g. entry type, locale) without taking up text space.
3795
+ *
3796
+ * @example
3797
+ * ```tsx
3798
+ * <ObjectGridItemIconWithTooltip
3799
+ * tooltipTitle="Composition"
3800
+ * icon={uniformComposition}
3801
+ * />
3802
+ * ```
3803
+ */
3241
3804
  declare const ObjectGridItemIconWithTooltip: ({ tooltipTitle, placement, icon, iconColor, ...props }: ObjectGridItemIconWithTooltipProps) => _emotion_react_jsx_runtime.JSX.Element;
3242
3805
 
3243
- /** @deprecated - Beta Object grid loading skeleton component
3244
- * @example <ObjectGridItemLoadingSkeleton />
3806
+ /**
3807
+ * Animated skeleton placeholder for {@link ObjectGridItem}, displayed while data is loading.
3808
+ * Renders a simulated cover image and two text lines matching the visual dimensions
3809
+ * of a real grid card so the layout doesn't shift on load.
3810
+ *
3811
+ * @example
3812
+ * ```tsx
3813
+ * <ObjectGridContainer gridCount={3}>
3814
+ * <ObjectGridItemLoadingSkeleton />
3815
+ * <ObjectGridItemLoadingSkeleton />
3816
+ * <ObjectGridItemLoadingSkeleton />
3817
+ * </ObjectGridContainer>
3818
+ * ```
3245
3819
  */
3246
3820
  declare const ObjectGridItemLoadingSkeleton: () => _emotion_react_jsx_runtime.JSX.Element;
3247
3821
 
3248
- /** @deprecated - Beta Object item loading skeleton component */
3822
+ /** Props for {@link ObjectItemLoadingSkeleton}. */
3249
3823
  type ObjectItemLoadingSkeletonProps = {
3250
- /** Show cover image loading skeleton */
3824
+ /** When `true`, renders an additional 80×55 animated rectangle representing a cover image. */
3251
3825
  showCover?: boolean;
3252
- /** Render as single or multi
3826
+ /** Controls the skeleton layout to match the corresponding {@link ObjectListItem} mode.
3827
+ * - `"single"` — single text line (vertically centered).
3828
+ * - `"multi"` — two text lines (top-aligned).
3253
3829
  * @default 'single'
3254
3830
  */
3255
3831
  renderAs?: 'single' | 'multi';
3256
3832
  };
3257
- /** @deprecated - Beta Object item loading skeleton component
3258
- * @example <ObjectItemLoadingSkeleton showCover />
3833
+ /**
3834
+ * Animated skeleton placeholder for {@link ObjectListItem}, displayed while data is loading.
3835
+ * Matches the visual dimensions of a real list item so the layout doesn't shift on load.
3836
+ *
3837
+ * @example
3838
+ * ```tsx
3839
+ * <ObjectListItemContainer>
3840
+ * <ObjectItemLoadingSkeleton />
3841
+ * <ObjectItemLoadingSkeleton showCover renderAs="multi" />
3842
+ * </ObjectListItemContainer>
3843
+ * ```
3259
3844
  */
3260
3845
  declare const ObjectItemLoadingSkeleton: ({ showCover, renderAs, }: ObjectItemLoadingSkeletonProps) => _emotion_react_jsx_runtime.JSX.Element;
3261
3846
 
3262
- /** @deprecated - Beta Object list item component */
3847
+ /**
3848
+ * Props for {@link ObjectListItem}.
3849
+ *
3850
+ * Supports two layout modes via `renderAs`:
3851
+ * - `"single"` (default) — header and right slot vertically centered on one line.
3852
+ * - `"multi"` — header aligned to top with additional `children` rendered below it.
3853
+ */
3263
3854
  type ObjectListItemProps = {
3264
- /** Optional ref to the stacked route container to scope all components rendered via portal to be inside the stacked route container */
3855
+ /** Portal target for the context menu, useful inside stacked route containers to prevent clipping. */
3265
3856
  portalElement?: MenuProps['portalElement'];
3857
+ /** Optional cover media rendered to the left of the header (e.g. {@link ObjectListItemCover}). */
3266
3858
  cover?: ReactNode;
3859
+ /** Optional drag handle rendered at the leading edge (e.g. `<DragHandle />`). */
3267
3860
  dragHandle?: ReactNode;
3268
- /** Sets the container query width for wrapping container
3861
+ /** Minimum width at which the container query breakpoint activates to lay out columns side-by-side.
3269
3862
  * @default '34rem'
3270
3863
  */
3271
3864
  minContainerQueryWidth?: string;
@@ -3277,29 +3870,93 @@ type ObjectListItemMultiProps = Omit<ObjectItemProps, 'cover'> & {
3277
3870
  renderAs?: 'multi';
3278
3871
  children?: ReactNode;
3279
3872
  };
3280
- /** @deprecated - beta Object list item component */
3873
+ /**
3874
+ * A horizontal list item for displaying an object with header, cover, right slot, and optional context menu.
3875
+ *
3876
+ * Uses container queries so the layout adapts to its parent width rather than the viewport.
3877
+ * Wrap items with {@link ObjectListItemContainer} to get proper list semantics and dividers.
3878
+ *
3879
+ * @example
3880
+ * ```tsx
3881
+ * <ObjectListItem
3882
+ * header={<ObjectListItemHeading heading="My entry" />}
3883
+ * rightSlot={<StatusBullet status="published" />}
3884
+ * menuItems={<MenuItem onClick={onDelete}>Delete</MenuItem>}
3885
+ * />
3886
+ * ```
3887
+ */
3281
3888
  declare const ObjectListItem: ({ minContainerQueryWidth, ...props }: ObjectListItemProps) => _emotion_react_jsx_runtime.JSX.Element;
3282
3889
 
3283
- /** @deprecated - Beta Object list item container component */
3890
+ /**
3891
+ * Vertical container that wraps {@link ObjectListItem} elements with `role="list"` semantics
3892
+ * and renders a top-border divider between each item.
3893
+ *
3894
+ * @example
3895
+ * ```tsx
3896
+ * <ObjectListItemContainer>
3897
+ * <ObjectListItem header={<ObjectListItemHeading heading="Item 1" />} />
3898
+ * <ObjectListItem header={<ObjectListItemHeading heading="Item 2" />} />
3899
+ * </ObjectListItemContainer>
3900
+ * ```
3901
+ */
3284
3902
  declare const ObjectListItemContainer: ({ children, gap, ...props }: RhythmProps) => _emotion_react_jsx_runtime.JSX.Element;
3285
3903
 
3286
- /** @deprecated - Beta Object list item cover component */
3904
+ /** Props for {@link ObjectListItemCover}. */
3287
3905
  type ObjectListItemCoverProps = {
3906
+ /** URL of the thumbnail image. When omitted, a placeholder with `noImageText` is shown instead. */
3288
3907
  imageUrl?: string;
3289
- /** (optional) sets the text to display when there is no image
3908
+ /** Placeholder text displayed when `imageUrl` is not provided.
3290
3909
  * @default 'Image not available'
3291
3910
  */
3292
3911
  noImageText?: string;
3912
+ /** (optional) sets the icon to display when there is no image */
3913
+ icon?: IconType | undefined;
3293
3914
  } & HTMLAttributes<HTMLImageElement>;
3294
- /** @deprecated - beta Object list item cover component */
3295
- declare const ObjectListItemCover: ({ imageUrl, noImageText, ...props }: ObjectListItemCoverProps) => _emotion_react_jsx_runtime.JSX.Element;
3915
+ /**
3916
+ * Thumbnail cover image for use inside {@link ObjectListItem}'s `cover` slot.
3917
+ * Renders a fixed-size (80×45) container with a lazy-loaded image, or a
3918
+ * text placeholder when no `imageUrl` is available.
3919
+ *
3920
+ * @example
3921
+ * ```tsx
3922
+ * <ObjectListItem
3923
+ * cover={<ObjectListItemCover imageUrl="https://example.com/thumb.jpg" />}
3924
+ * header={<ObjectListItemHeading heading="My entry" />}
3925
+ * />
3926
+ * ```
3927
+ */
3928
+ declare const ObjectListItemCover: ({ imageUrl, noImageText, icon, ...props }: ObjectListItemCoverProps) => _emotion_react_jsx_runtime.JSX.Element;
3296
3929
 
3297
- /** @deprecated - Beta Object list item heading component */
3930
+ /** Props for {@link ObjectListItemHeading}. */
3298
3931
  type ObjectListItemHeadingProps = Omit<ObjectHeadingProps, 'heading' | 'tooltip'> & HTMLAttributes<HTMLDivElement> & {
3932
+ /** The heading content — typically a string, link, or inline element. */
3299
3933
  heading: ReactNode;
3934
+ /** Override the `data-testid` on the heading element.
3935
+ * @default 'reference-item-name'
3936
+ */
3937
+ headingTestId?: string;
3300
3938
  };
3301
- /** @deprecated - beta Object list item heading component */
3302
- declare const ObjectListItemHeading: ({ heading, beforeHeadingSlot, afterHeadingSlot, ...props }: ObjectListItemHeadingProps) => _emotion_react_jsx_runtime.JSX.Element;
3939
+ /**
3940
+ * Heading component designed for use inside {@link ObjectListItem}'s `header` slot.
3941
+ *
3942
+ * Renders a responsive heading row that stacks vertically on narrow containers
3943
+ * and switches to a horizontal layout at wider widths (controlled by a container query).
3944
+ *
3945
+ * @example
3946
+ * ```tsx
3947
+ * <ObjectListItemHeading
3948
+ * heading={<a href="/entries/123">My entry</a>}
3949
+ * beforeHeadingSlot={<Icon icon={uniformComposition} />}
3950
+ * afterHeadingSlot={<Chip text="Draft" />}
3951
+ * />
3952
+ * ```
3953
+ */
3954
+ declare const ObjectListItemHeading: ({ heading, beforeHeadingSlot, afterHeadingSlot, headingTestId, ...props }: ObjectListItemHeadingProps) => _emotion_react_jsx_runtime.JSX.Element;
3955
+
3956
+ type ObjectListSubTextProps = {
3957
+ children: React.ReactNode;
3958
+ } & React.HTMLAttributes<HTMLDivElement>;
3959
+ declare const ObjectListSubText: ({ children, ...props }: ObjectListSubTextProps) => _emotion_react_jsx_runtime.JSX.Element;
3303
3960
 
3304
3961
  declare function Pagination({ limit, offset, total, onPageChange, }: {
3305
3962
  limit: number;
@@ -3389,6 +4046,7 @@ type BaseParameterActionButtonProps = {
3389
4046
  * If a React element is provided, it will be displayed as a tooltip.
3390
4047
  */
3391
4048
  tooltip?: string | React__default.ReactNode;
4049
+ tooltipProps?: Partial<TooltipProps>;
3392
4050
  /**
3393
4051
  * The component to render the button as.
3394
4052
  * There maybe a scenario where we want to render the button as a div
@@ -3407,7 +4065,7 @@ interface FilledVariant extends BaseParameterActionButtonProps {
3407
4065
  inverted?: boolean;
3408
4066
  }
3409
4067
  type ParameterActionButtonProps = OutlineVariant | FilledVariant;
3410
- declare const ParameterActionButton: ({ children, themeType, tooltip, renderAs, disabled, ...props }: ParameterActionButtonProps) => _emotion_react_jsx_runtime.JSX.Element;
4068
+ declare const ParameterActionButton: ({ children, themeType, tooltip, tooltipProps, renderAs, disabled, ...props }: ParameterActionButtonProps) => _emotion_react_jsx_runtime.JSX.Element;
3411
4069
 
3412
4070
  type ParameterDrawerHeaderProps = {
3413
4071
  title: string;
@@ -3496,6 +4154,44 @@ type ParameterLabelProps = HTMLAttributes<HTMLLabelElement> & {
3496
4154
  /** @example <ParameterLabel id="my-label">my label</ParameterLabel> */
3497
4155
  declare const ParameterLabel: ({ id, asSpan, children, testId, ...props }: ParameterLabelProps) => _emotion_react_jsx_runtime.JSX.Element;
3498
4156
 
4157
+ /** Extended option type that supports label-specific properties */
4158
+ type LabelOption = InputComboBoxOption & {
4159
+ /** The color variant for the label swatch */
4160
+ color?: SwatchVariant;
4161
+ /** Whether this option represents a group header */
4162
+ isGroup?: boolean;
4163
+ /** The parent group ID if this label belongs to a group */
4164
+ parent?: string;
4165
+ /** Tooltip content for the label */
4166
+ tooltip?: string | React.ReactElement;
4167
+ };
4168
+ type ParameterLabelsInnerProps = Pick<InputComboBoxProps<LabelOption, true>, 'options' | 'value' | 'defaultValue' | 'onChange' | 'onBlur' | 'isClearable' | 'isDisabled'> & {
4169
+ /** Callback when an item is removed from the selection */
4170
+ onItemRemoved?: (id: string) => void;
4171
+ /** Callback when a new label is created */
4172
+ onCreateLabel?: (label: string) => void;
4173
+ /** Override the text displayed on the filter button */
4174
+ buttonText?: string;
4175
+ /** Override the text displayed on the add button */
4176
+ addButtonText?: string | null;
4177
+ /** the function to call when the quick filter is opened */
4178
+ onOpen?: () => void;
4179
+ /** the function to call when the quick filter is closed */
4180
+ onClose?: () => void;
4181
+ /** The maximum number of labels that can be selected */
4182
+ maxCount?: number;
4183
+ };
4184
+ type ParameterLabelsProps = CommonParameterInputProps & ParameterLabelsInnerProps & {
4185
+ disabled?: boolean;
4186
+ };
4187
+ /**
4188
+ * A parameter input component for selecting multiple labels with swatch colors.
4189
+ * Supports grouped labels with nested menus.
4190
+ * @example <ParameterLabels id="labels" label="Labels" options={[]} value={[]} onChange={() => {}} />
4191
+ */
4192
+ declare const ParameterLabels: ({ disabled, ...props }: ParameterLabelsProps) => _emotion_react_jsx_runtime.JSX.Element;
4193
+ declare const ParameterLabelsInner: (props: ParameterLabelsInnerProps) => _emotion_react_jsx_runtime.JSX.Element;
4194
+
3499
4195
  type ParameterLinkProps = CommonParameterInputProps & React.InputHTMLAttributes<HTMLInputElement> & {
3500
4196
  /** (optional) sets the button text when value is empty
3501
4197
  * @default 'Configure link'
@@ -3900,7 +4596,9 @@ declare const ParameterShell: ({ label, labelLeadingIcon, labelTrailingIcon, hid
3900
4596
  declare const ParameterShellPlaceholder: ({ children }: {
3901
4597
  children?: ReactNode;
3902
4598
  }) => _emotion_react_jsx_runtime.JSX.Element;
3903
- declare const ParameterOverrideMarker: (props: HTMLAttributes<HTMLButtonElement>) => _emotion_react_jsx_runtime.JSX.Element;
4599
+ declare const ParameterOverrideMarker: (props: HTMLAttributes<HTMLButtonElement> & {
4600
+ tooltipProps?: Partial<TooltipProps>;
4601
+ }) => _emotion_react_jsx_runtime.JSX.Element;
3904
4602
 
3905
4603
  type ParameterTextareaProps = CommonParameterInputProps & React.TextareaHTMLAttributes<HTMLTextAreaElement>;
3906
4604
  /** @example <ParameterTextarea label="label value" id="my-textarea" /> */
@@ -3941,8 +4639,7 @@ declare const ParameterToggleInner: React$1.ForwardRefExoticComponent<Omit<React
3941
4639
  withoutIndeterminateState?: boolean;
3942
4640
  } & React$1.RefAttributes<HTMLInputElement>>;
3943
4641
 
3944
- type PopoverProps = Omit<PopoverProps$1, 'unmountOnHide'> & {
3945
- /** sets the aria-controls and id value of the matching popover set */
4642
+ type PopoverProps = Pick<React.HTMLAttributes<HTMLDivElement>, 'className' | 'style' | 'tabIndex' | 'id'> & {
3946
4643
  /** sets the icon color
3947
4644
  * @default 'action'
3948
4645
  */
@@ -3962,7 +4659,7 @@ type PopoverProps = Omit<PopoverProps$1, 'unmountOnHide'> & {
3962
4659
  /** sets the placement of the popover
3963
4660
  * @default 'bottom'
3964
4661
  */
3965
- placement?: PopoverProviderProps['placement'];
4662
+ placement?: Placement;
3966
4663
  /** sets a test id for e2e tests */
3967
4664
  testId?: string;
3968
4665
  children: ReactNode;
@@ -3979,15 +4676,36 @@ type PopoverProps = Omit<PopoverProps$1, 'unmountOnHide'> & {
3979
4676
  * @default 'small'
3980
4677
  */
3981
4678
  variant?: 'large' | 'small';
4679
+ /**
4680
+ * Distance between the anchor and the popover in pixels.
4681
+ * @default 0
4682
+ */
4683
+ gutter?: number;
4684
+ /**
4685
+ * Whether to render the popover in a portal.
4686
+ * @default true
4687
+ */
4688
+ portal?: boolean;
4689
+ /** Controls the popover open state externally. */
4690
+ open?: boolean;
4691
+ /** Called when the popover open state changes. */
4692
+ onOpenChange?: (open: boolean) => void;
4693
+ /** Disables the popover trigger */
4694
+ disabled?: boolean;
3982
4695
  };
3983
- declare const Popover: ({ iconColor, icon, iconSize, buttonText, ariaLabel, placement, testId, trigger, children, onInit, variant, maxWidth, ...otherProps }: PopoverProps) => _emotion_react_jsx_runtime.JSX.Element;
4696
+ interface PopoverComponentContextValue {
4697
+ open: boolean;
4698
+ setOpen: (open: boolean) => void;
4699
+ hide: () => void;
4700
+ show: () => void;
4701
+ }
4702
+ declare const Popover: ({ iconColor, icon, iconSize, buttonText, ariaLabel, placement, testId, trigger, children, onInit, variant, maxWidth, gutter, portal, open: controlledOpen, onOpenChange: controlledOnOpenChange, className, style, tabIndex, id, disabled, }: PopoverProps) => _emotion_react_jsx_runtime.JSX.Element;
3984
4703
  /**
3985
- * Hook to get the current popover context
3986
- * @description This hook is used to get the current popover context
3987
- * useful for closing the popover with a nested button or interactive element
3988
- * @example const currentPopoverContext = usePopoverComponentContext();
4704
+ * Hook to get the current popover context.
4705
+ * Useful for closing the popover with a nested button or interactive element.
4706
+ * @example const popoverContext = usePopoverComponentContext();
3989
4707
  */
3990
- declare const usePopoverComponentContext: () => PopoverStore | undefined;
4708
+ declare const usePopoverComponentContext: () => PopoverComponentContextValue | null;
3991
4709
 
3992
4710
  type PopoverBodyProps = React.HTMLAttributes<HTMLDivElement> & {
3993
4711
  /**
@@ -4052,6 +4770,118 @@ type ProgressListItem<IdType extends string = string> = {
4052
4770
  };
4053
4771
  declare const ProgressListItem: ({ children, status, error, errorLevel, autoEllipsis, }: ProgressListItemProps) => _emotion_react_jsx_runtime.JSX.Element;
4054
4772
 
4773
+ type QuickFilterSelectedItem = {
4774
+ /** Unique identifier for the selected item */
4775
+ id: string;
4776
+ /** Display name for the selected item */
4777
+ name: string;
4778
+ /** Optional swatch variant color */
4779
+ variant?: SwatchVariant | string;
4780
+ /** The tooltip to display inside the selected item */
4781
+ tooltip?: string | React.ReactElement;
4782
+ /** Optional icon to display on the left of the selected item */
4783
+ icon?: IconType;
4784
+ };
4785
+ type QuickFilterProps = {
4786
+ /** the icon to display on the left of the quick filter */
4787
+ iconLeft?: IconType;
4788
+ /** the text to display on the quick filter */
4789
+ buttonText: string;
4790
+ /** the function to call when the quick filter is clicked */
4791
+ /** the size of the quick filter
4792
+ * @default 'sm'
4793
+ */
4794
+ size?: ButtonSizeProps;
4795
+ /** the test id to use for the quick filter */
4796
+ testId?: string;
4797
+ /** the aria label to use for the quick filter */
4798
+ ariaLabel?: string;
4799
+ /** the children to display inside the quick filter */
4800
+ children: ReactNode;
4801
+ /** whether the quick filter is disabled */
4802
+ disabled?: boolean;
4803
+ /** the selected items to display inside the quick filter */
4804
+ selectedItems?: QuickFilterSelectedItem[];
4805
+ /** the function to call when the search term is changed */
4806
+ onSearchTermChanged: (searchTerm: string) => void;
4807
+ /** addButtonText to use for the add button
4808
+ * @default 'Add'
4809
+ */
4810
+ addButtonText?: string | null;
4811
+ /** the css to use for the swatch colors
4812
+ * @default swatchColors from the Swatch component
4813
+ */
4814
+ swatchColorsCss?: SerializedStyles;
4815
+ /** the function to call when an item is removed */
4816
+ onItemRemoved?: (id: string) => void;
4817
+ /** the total number of results */
4818
+ totalResults: number;
4819
+ /** the maximum height of the menu
4820
+ * @default '320px'
4821
+ */
4822
+ maxMenuHeight?: string;
4823
+ /** the maximum number of results to display
4824
+ * @default 5
4825
+ */
4826
+ maxCount?: number;
4827
+ /** the css to use for the container
4828
+ * @default swatchColors from the Swatch component
4829
+ */
4830
+ containerCss?: SerializedStyles;
4831
+ /** Render function for displaying selected items. Receives selectedItems and onItemRemoved.
4832
+ * @default Renders SwatchLabel components
4833
+ */
4834
+ resultsComponent?: (props: {
4835
+ selectedItems: QuickFilterSelectedItem[];
4836
+ onItemRemoved?: (id: string) => void;
4837
+ }) => ReactNode;
4838
+ /** the message to display when there are no results
4839
+ * @default ''
4840
+ */
4841
+ hasNoResultsMessage?: string;
4842
+ /** the placeholder text to display in the search input
4843
+ * @default 'Search...'
4844
+ */
4845
+ searchPlaceholderText?: string;
4846
+ /**
4847
+ * The maximum width of the quick filter container.
4848
+ * Useful for controlling the maximum width of the filter in different layouts (e.g., responsive sidebars).
4849
+ * @default '4rem'
4850
+ */
4851
+ maxContainerSize?: string;
4852
+ /** the icon to display on the left of the quick filter when collapsed */
4853
+ collapsedIcon?: IconType;
4854
+ /** the function to call when the quick filter is opened */
4855
+ onOpen?: () => void;
4856
+ /** the function to call when the quick filter is closed */
4857
+ onClose?: () => void;
4858
+ /**
4859
+ * Override the placement of the dropdown menu.
4860
+ * @default 'right-start'
4861
+ */
4862
+ menuPlacement?: MenuProps['placement'];
4863
+ /**
4864
+ * Override the anchor rect for custom menu positioning.
4865
+ * Pass `null` to disable the built-in default and use standard positioning.
4866
+ * @default Anchors to the container's right edge
4867
+ */
4868
+ menuGetAnchorRect?: ((anchor: HTMLElement | null) => {
4869
+ x?: number;
4870
+ y?: number;
4871
+ width?: number;
4872
+ height?: number;
4873
+ }) | null;
4874
+ /**
4875
+ * Override the updatePosition callback to control when the menu repositions.
4876
+ * Pass `null` to disable the built-in default (position freezing) and allow normal repositioning.
4877
+ * @default Freezes position after initial placement
4878
+ */
4879
+ menuUpdatePosition?: MenuProps['updatePosition'] | null;
4880
+ /** Called when Enter is pressed in the search input and no active menu item handles the event */
4881
+ onSearchEnterKeyDown?: () => void;
4882
+ };
4883
+ declare const QuickFilter: ({ iconLeft, collapsedIcon, buttonText, testId, ariaLabel, children, size, disabled, selectedItems, onSearchTermChanged, addButtonText, onItemRemoved, totalResults, maxMenuHeight, maxCount, containerCss, resultsComponent, hasNoResultsMessage, searchPlaceholderText, maxContainerSize, onOpen, onClose, menuPlacement, menuGetAnchorRect, menuUpdatePosition, onSearchEnterKeyDown, }: QuickFilterProps) => _emotion_react_jsx_runtime.JSX.Element;
4884
+
4055
4885
  type SegmentedControlOption<TValue extends string = string> = {
4056
4886
  value: TValue;
4057
4887
  label?: string;
@@ -4121,6 +4951,114 @@ declare const Spinner: ({ width, label, isPaused, }: {
4121
4951
  isPaused?: boolean;
4122
4952
  }) => _emotion_react_jsx_runtime.JSX.Element;
4123
4953
 
4954
+ /** The direction of a step transition, determining which slide animation to play. */
4955
+ type StackedModalDirection = 'forward' | 'backward';
4956
+ /** The full navigation state exposed by the `useStackedModal` hook. */
4957
+ type StackedModalContextValue = {
4958
+ /** The zero-indexed active step. */
4959
+ currentStep: number;
4960
+ /** The total number of steps. */
4961
+ totalSteps: number;
4962
+ /** The direction of the last navigation, used to drive slide animations. */
4963
+ direction: StackedModalDirection;
4964
+ /** The zero-indexed step that was active before the last navigation. Used internally for animation. */
4965
+ previousStep: number;
4966
+ /** Navigate to the next step. No-op if already on the last step. */
4967
+ nextStep: () => void;
4968
+ /** Navigate to the previous step. No-op if already on the first step. */
4969
+ goBack: () => void;
4970
+ /** Navigate to a specific step by index. */
4971
+ goToStep: (index: number) => void;
4972
+ };
4973
+ /**
4974
+ * Hook to access the stacked modal navigation context.
4975
+ * Provides the current step, total steps, navigation direction, and functions to navigate between steps.
4976
+ *
4977
+ * @throws If used outside of a `<StackedModal>` component tree.
4978
+ */
4979
+ declare function useStackedModal(): StackedModalContextValue;
4980
+ /** The semantic transition state for a single step, derived from the navigation context. */
4981
+ type StepTransitionState = {
4982
+ /** Whether this step is the currently visible step. */
4983
+ isActive: boolean;
4984
+ /** Whether this step is animating out after being replaced by a new active step. */
4985
+ isExiting: boolean;
4986
+ /** Whether the modal is idle (no transition in progress). True on initial render and after animations complete. */
4987
+ isIdle: boolean;
4988
+ /** The direction of the current or most recent transition. */
4989
+ direction: StackedModalDirection;
4990
+ };
4991
+
4992
+ type StackedModalProps = {
4993
+ /** The step content. Each child should be a `StackedModalStep` component. */
4994
+ children: ReactNode;
4995
+ /**
4996
+ * Called when the close button is clicked, the Escape button is pressed, or when the modal's backdrop is clicked.
4997
+ * If undefined is passed, the modal will not be closable by the user and the close button will not be rendered.
4998
+ */
4999
+ onRequestClose: ModalProps['onRequestClose'];
5000
+ /**
5001
+ * The size sets the modal width to one of three options sm = 400px, md = 600px and lg = 800px.
5002
+ * If a width attribute is used the size will be overridden by the width attribute.
5003
+ * @default 'lg'
5004
+ */
5005
+ modalSize?: ModalProps['modalSize'];
5006
+ /** A valid CSS width. Overrides `modalSize` when provided. */
5007
+ width?: string;
5008
+ /** A valid CSS height. */
5009
+ height?: string;
5010
+ /**
5011
+ * The zero-indexed step to display initially.
5012
+ * @default 0
5013
+ */
5014
+ initialStep?: number;
5015
+ };
5016
+ /**
5017
+ * A modal component that supports multi-step content with sliding transitions.
5018
+ * Each child should be a `StackedModalStep` component that defines its own header,
5019
+ * content, and button group.
5020
+ *
5021
+ * Use the `useStackedModal` hook inside step content to navigate between steps.
5022
+ *
5023
+ * @example
5024
+ * <StackedModal onRequestClose={handleClose} modalSize="lg">
5025
+ * <StackedModalStep header="Step 1" buttonGroup={<Buttons />}>
5026
+ * <StepOneContent />
5027
+ * </StackedModalStep>
5028
+ * <StackedModalStep header="Step 2" buttonGroup={<Buttons />}>
5029
+ * <StepTwoContent />
5030
+ * </StackedModalStep>
5031
+ * </StackedModal>
5032
+ */
5033
+ declare const StackedModal: React__default.ForwardRefExoticComponent<StackedModalProps & React__default.RefAttributes<HTMLDialogElement>>;
5034
+
5035
+ /** Props for a single step within a `StackedModal`. */
5036
+ type StackedModalStepProps = {
5037
+ /**
5038
+ * Header content displayed in the modal's header row, inline with the close icon.
5039
+ * This prop is extracted by the parent `StackedModal` and rendered in the
5040
+ * modal chrome -- it is **not** rendered by `StackedModalStep` itself.
5041
+ */
5042
+ header?: ReactNode;
5043
+ /** Optional button group rendered at the bottom of the step, typically navigation or submit buttons. */
5044
+ buttonGroup?: ReactNode;
5045
+ /** The main body content of the step. */
5046
+ children: ReactNode;
5047
+ };
5048
+ /**
5049
+ * Defines a single step inside a `StackedModal`.
5050
+ *
5051
+ * Renders a scrollable content area and an optional bottom button group.
5052
+ * The `header` prop is read by the parent `StackedModal` and displayed in the
5053
+ * modal header row with a matching slide animation.
5054
+ *
5055
+ * @example
5056
+ * <StackedModalStep header="Account details" buttonGroup={<Button>Next</Button>}>
5057
+ * <FormFields />
5058
+ * </StackedModalStep>
5059
+ */
5060
+ declare function StackedModalStep({ children, buttonGroup }: StackedModalStepProps): _emotion_react_jsx_runtime.JSX.Element;
5061
+
4124
5062
  type SwitchProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type'> & {
4125
5063
  /** sets the label value */
4126
5064
  label: ReactNode;
@@ -4214,30 +5152,57 @@ declare const TableRow: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedH
4214
5152
  declare const TableCellHead: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.ThHTMLAttributes<HTMLTableHeaderCellElement>, HTMLTableHeaderCellElement>, "ref"> & React$1.RefAttributes<HTMLTableCellElement>>;
4215
5153
  declare const TableCellData: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.TdHTMLAttributes<HTMLTableDataCellElement>, HTMLTableDataCellElement>, "ref"> & React$1.RefAttributes<HTMLTableCellElement>>;
4216
5154
 
4217
- declare const useCurrentTab: () => _ariakit_react.TabStore;
5155
+ interface TabsContextValue {
5156
+ value: string | undefined;
5157
+ setValue: (value: string | undefined) => void;
5158
+ }
5159
+ /** Returns the current tabs context with `value` and `setValue`. Must be used inside `<Tabs>`. */
5160
+ declare const useCurrentTab: () => TabsContextValue;
4218
5161
  type TabsProps<TTabName extends string = string> = {
4219
5162
  children: React__default.ReactNode;
4220
5163
  selectedId?: TTabName;
4221
5164
  manual?: boolean;
4222
- orientation?: TabStoreState['orientation'];
5165
+ orientation?: 'horizontal' | 'vertical';
4223
5166
  onSelectedIdChange?: (tabName: TTabName | undefined) => void;
4224
5167
  /**
4225
5168
  * @deprecated you can control the route state on the application level.
4226
5169
  */
4227
5170
  useHashForState?: boolean;
5171
+ /** Forwarded to the root element. Receives the `className` generated by Emotion's `css` prop. */
5172
+ className?: string;
5173
+ /** Forwarded to the root element. */
5174
+ style?: React__default.CSSProperties;
4228
5175
  };
4229
- declare const Tabs: <TTabName extends string = string>({ children, onSelectedIdChange, useHashForState, selectedId, manual, ...props }: TabsProps<TTabName>) => _emotion_react_jsx_runtime.JSX.Element;
4230
- declare const TabButtonGroup: ({ children, ...props }: Partial<TabListProps>) => _emotion_react_jsx_runtime.JSX.Element;
4231
- type TabButtonProps<TTabName extends string = string> = Partial<TabProps> & {
5176
+ declare const Tabs: <TTabName extends string = string>({ children, onSelectedIdChange, useHashForState, selectedId, manual, orientation, className, style, }: TabsProps<TTabName>) => _emotion_react_jsx_runtime.JSX.Element;
5177
+ type TabButtonGroupProps = React__default.HTMLAttributes<HTMLDivElement> & {
5178
+ children?: React__default.ReactNode;
5179
+ };
5180
+ declare const TabButtonGroup: ({ children, ...props }: TabButtonGroupProps) => _emotion_react_jsx_runtime.JSX.Element;
5181
+ type TabButtonProps<TTabName extends string = string> = React__default.ButtonHTMLAttributes<HTMLButtonElement> & {
4232
5182
  id: TTabName;
4233
5183
  children: React__default.ReactNode;
4234
5184
  };
4235
5185
  declare const TabButton: <TTabName extends string = string>({ children, id, ...props }: TabButtonProps<TTabName>) => _emotion_react_jsx_runtime.JSX.Element;
4236
- type TabContentProps<TTabName extends string = string> = Partial<TabPanelProps> & {
5186
+ type TabContentProps<TTabName extends string = string> = Omit<React__default.HTMLAttributes<HTMLDivElement>, 'id'> & {
5187
+ /**
5188
+ * When `tabId` is not set, this identifies which tab the panel belongs to.
5189
+ * When `tabId` IS set, this is just the HTML `id` attribute on the panel element.
5190
+ * @deprecated Pass `tabId` for tab identification; use `id` only as an HTML id.
5191
+ */
5192
+ id?: TTabName | (string & {});
5193
+ /** Identifies which tab this content panel belongs to. Matches the `id` on the corresponding `TabButton`. */
4237
5194
  tabId?: TTabName;
5195
+ /**
5196
+ * Whether to keep the panel mounted in the DOM when its tab is inactive.
5197
+ * Defaults to `true` so that embedded forms (e.g. Formik with debounced
5198
+ * auto-submit) preserve their state and pending work across tab switches.
5199
+ * Pass `false` only when you explicitly want inactive panels unmounted.
5200
+ * @default true
5201
+ */
5202
+ keepMounted?: boolean;
4238
5203
  children: React__default.ReactNode;
4239
5204
  };
4240
- declare const TabContent: <TTabName extends string = string>({ children, ...props }: TabContentProps<TTabName>) => _emotion_react_jsx_runtime.JSX.Element;
5205
+ declare const TabContent: <TTabName extends string = string>({ children, tabId, id, keepMounted, ...props }: TabContentProps<TTabName>) => _emotion_react_jsx_runtime.JSX.Element;
4241
5206
 
4242
5207
  type CreateTeamIntegrationTileProps = React.HTMLAttributes<HTMLDivElement> & {
4243
5208
  /** (optional) sets the title value
@@ -4500,16 +5465,143 @@ type TileTitleProps = {
4500
5465
  } & HTMLAttributes<HTMLSpanElement>;
4501
5466
  declare const TileText: ({ as, children, ...props }: TileTitleProps) => _emotion_react_jsx_runtime.JSX.Element;
4502
5467
 
5468
+ /**
5469
+ * Identifier returned by `toast.*` calls. Kept as `string | number` for
5470
+ * backwards compatibility with the previous react-toastify `Id` type that
5471
+ * several consumers store in `useRef<number | string>`. Internally the
5472
+ * underlying Base UI manager always uses `string`.
5473
+ */
5474
+ type ToastId = string | number;
5475
+ /**
5476
+ * The shape consumers can store on a toast via the `data` field. Recognised
5477
+ * by the default `<ToastList>` renderer to render either a progress bar or
5478
+ * an inline Undo affordance, while keeping the imperative `toast.*` API
5479
+ * unchanged for the rest of the codebase.
5480
+ */
5481
+ type ToastData = {
5482
+ /** Progress-bar toast (used by `CopyValuesToLocales`). */
5483
+ kind: 'progress';
5484
+ /** Label rendered above the progress bar. */
5485
+ label: React__default.ReactNode;
5486
+ /** Completion ratio in the closed interval [0, 1]. */
5487
+ progress: number;
5488
+ } | {
5489
+ /** Toast with an inline 'Undo' button (used by the InlineAI popovers). */
5490
+ kind: 'undoable';
5491
+ /** Description rendered next to the Undo button. */
5492
+ description: React__default.ReactNode;
5493
+ /** Invoked when the user clicks the Undo button. */
5494
+ onUndo: () => void;
5495
+ /** Custom label for the Undo button. */
5496
+ undoLabel?: string;
5497
+ };
5498
+ /**
5499
+ * Per-call options accepted by every `toast.*` method. The shape mirrors the
5500
+ * legacy react-toastify options the design system used to forward.
5501
+ */
5502
+ type ToastOptions = {
5503
+ /**
5504
+ * Time in milliseconds before the toast is auto-dismissed. Pass `false` to
5505
+ * keep the toast open until it is dismissed manually (maps to Base UI's
5506
+ * `timeout: 0`).
5507
+ */
5508
+ autoClose?: number | false;
5509
+ /**
5510
+ * Stable id for the toast. When provided, calling a toast method again with
5511
+ * the same id updates the existing toast in place (and refreshes its
5512
+ * auto-dismiss timer) instead of stacking a new one. Useful for deduping
5513
+ * toasts triggered by repeated user actions.
5514
+ */
5515
+ toastId?: string;
5516
+ };
5517
+ /**
5518
+ * Promise-toast options accepted by `toast.promise`. Each handler may be a
5519
+ * static description string or a function that receives the resolved value /
5520
+ * rejection error and returns a description. All three keys are optional to
5521
+ * mirror react-toastify's behaviour where any unset state simply rendered an
5522
+ * empty toast (or none at all when the promise settled fast enough).
5523
+ */
5524
+ type ToastPromiseOptions<TValue, TError = unknown> = {
5525
+ /** Description shown while the promise is pending. */
5526
+ pending?: React__default.ReactNode;
5527
+ /** Description shown when the promise resolves. */
5528
+ success?: React__default.ReactNode | ((value: TValue) => React__default.ReactNode);
5529
+ /** Description shown when the promise rejects. */
5530
+ error?: React__default.ReactNode | ((error: TError) => React__default.ReactNode);
5531
+ };
5532
+ /**
5533
+ * Patch shape accepted by `toast.update`. A subset of Base UI's
5534
+ * `ToastManagerUpdateOptions<ToastData>` that consumers actually use.
5535
+ */
5536
+ type ToastUpdate = {
5537
+ type?: string;
5538
+ description?: React__default.ReactNode;
5539
+ timeout?: number;
5540
+ data?: ToastData;
5541
+ };
5542
+ /**
5543
+ * Imperative API for showing toasts from anywhere in the app. Mirrors the
5544
+ * historical react-toastify surface (`toast`, `.success`, `.error`, `.info`,
5545
+ * `.warning`, `.loading`, `.dismiss`, `.update`, `.done`, `.promise`) so the
5546
+ * ~200 existing call sites continue to work unchanged. Internally delegates
5547
+ * to the singleton Base UI `toastManager` mounted by `<ToastContainer />`.
5548
+ */
5549
+ declare const toast: ((description: React__default.ReactNode, options?: ToastOptions) => ToastId) & {
5550
+ success: (description: React__default.ReactNode, options?: ToastOptions) => ToastId;
5551
+ error: (description: React__default.ReactNode, options?: ToastOptions) => ToastId;
5552
+ info: (description: React__default.ReactNode, options?: ToastOptions) => ToastId;
5553
+ warning: (description: React__default.ReactNode, options?: ToastOptions) => ToastId;
5554
+ loading: (description: React__default.ReactNode) => ToastId;
5555
+ dismiss: (id?: ToastId) => void;
5556
+ update: (id: ToastId, patch: ToastUpdate) => void;
5557
+ /**
5558
+ * Closes the toast. Carried forward from the react-toastify API where
5559
+ * `done()` ended a `loading` toast — Base UI has no separate concept,
5560
+ * so this is an alias for `dismiss(id)`.
5561
+ */
5562
+ done: (id: ToastId) => void;
5563
+ /**
5564
+ * Wraps an async operation in a 3-state toast (loading / success / error).
5565
+ * Accepts either a `Promise` or a thunk returning a `Promise` to match the
5566
+ * historical react-toastify usage. The optional `TError` type argument
5567
+ * narrows the parameter type of the `error` callback for call sites that
5568
+ * historically supplied an explicit error type (e.g. `toast.promise<void, Error>`).
5569
+ *
5570
+ * Unlike Base UI's built-in `toastManager.promise`, this implementation
5571
+ * skips rendering toasts for states whose option is `undefined`. This
5572
+ * preserves the legacy react-toastify behaviour many call sites depend on
5573
+ * (e.g. save-draft flows omit `pending`/`success` and only want a toast
5574
+ * when the operation fails).
5575
+ */
5576
+ promise: <TValue, TError = unknown>(input: Promise<TValue> | (() => Promise<TValue>), options: ToastPromiseOptions<TValue, TError>) => Promise<TValue>;
5577
+ };
4503
5578
  type ToastContainerProps = {
5579
+ /**
5580
+ * Maximum number of toasts visible at once. Older toasts are dismissed when
5581
+ * the limit is exceeded.
5582
+ * @default 4
5583
+ */
4504
5584
  limit?: number;
4505
- /** sets the auto close delay in seconds normal: 5 seconds, medium: 8 seconds, long: 10 seconds
5585
+ /**
5586
+ * Default auto-close duration applied to every toast that does not specify
5587
+ * its own `autoClose` option.
5588
+ * - `'normal'` — 5 seconds
5589
+ * - `'medium'` — 8 seconds
5590
+ * - `'long'` — 10 seconds
4506
5591
  * @default 'normal'
4507
5592
  */
4508
5593
  autoCloseDelay?: 'normal' | 'medium' | 'long';
4509
5594
  };
4510
5595
  /**
4511
- * A component to render toasts in your app. This component is supposed to be used just once in your app. Typically inside _app.tsx
4512
- * @example <App><ToastContainer autoCloseDelay="normal" /></App>
5596
+ * Renders the global toast viewport. Intended to be mounted exactly once near
5597
+ * the root of the app (typically in `_app.tsx`).
5598
+ *
5599
+ * @example
5600
+ * ```tsx
5601
+ * <App>
5602
+ * <ToastContainer autoCloseDelay="normal" />
5603
+ * </App>
5604
+ * ```
4513
5605
  */
4514
5606
  declare const ToastContainer: ({ limit, autoCloseDelay }: ToastContainerProps) => _emotion_react_jsx_runtime.JSX.Element;
4515
5607
 
@@ -4536,4 +5628,4 @@ declare const StatusBullet: ({ status, hideText, size, message, compact, ...prop
4536
5628
 
4537
5629
  declare const actionBarVisibilityStyles: _emotion_react.SerializedStyles;
4538
5630
 
4539
- export { type ActionButtonsProps, AddButton, type AddButtonProps, AddListButton, type AddListButtonProps, type AddListButtonThemeProps, AsideAndSectionLayout, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Banner, type BannerProps, type BannerType, BetaDecorator, type BoxHeightProps, type BreakpointSize, type BreakpointsMap, Button, type ButtonProps, type ButtonSizeProps, type ButtonSoftThemeProps, type ButtonThemeProps, ButtonWithMenu, type ButtonWithMenuProps, Calendar, type CalendarProps, Callout, type CalloutProps, type CalloutType, Caption, type CaptionProps, Card, CardContainer, type CardContainerBgColorProps, type CardContainerProps, type CardProps, CardTitle, type CardTitleProps, CheckboxWithInfo, type CheckboxWithInforProps, type ChildFunction, Chip, type ChipProps, type ChipTheme, type ComboBoxGroupBase, type ComboBoxSelectableGroup, type ComboBoxSelectableItem, type ComboBoxSelectableOption, Container, type ContainerProps, type ConvertComboBoxGroupsToSelectableGroupsOptions, Counter, type CounterBgColors, type CounterIconColors, type CounterProps, CreateTeamIntegrationTile, type CreateTeamIntegrationTileProps, CurrentDrawerContext, DashedBox, type DashedBoxProps, DateTimePicker, type DateTimePickerProps, DateTimePickerSummary, type DateTimePickerValue, DateTimePickerVariant, DebouncedInputKeywordSearch, type DebouncedInputKeywordSearchProps, DescriptionList, type DescriptionListProps, Details, type DetailsProps, DismissibleChipAction, DragHandle, type DraggableHandleProps, Drawer, DrawerContent, type DrawerContentProps, type DrawerContextValue, type DrawerItem, type DrawerProps, DrawerProvider, DrawerRenderer, type DrawerRendererItemProps, type DrawerRendererProps, type DrawersRegistryRecord, DropdownStyleMenuTrigger, type DropdownStyleMenuTriggerProps, EditTeamIntegrationTile, type EditTeamIntegrationTileProps, ErrorMessage, type ErrorMessageProps, FieldMessage, type FieldMessageProps, Fieldset, type FieldsetProps, FilterChip, FlexiCard, FlexiCardTitle, type GroupedOption, Heading, type HeadingProps, HexModalBackground, HorizontalRhythm, Icon, IconButton, type IconButtonProps, type IconColor, type IconName, type IconProps, type IconType, IconsProvider, Image, ImageBroken, type ImageProps, InfoMessage, type InfoMessageProps, Input, InputComboBox, type InputComboBoxOption, type InputComboBoxProps, InputCreatableComboBox, type InputCreatableComboBoxProps, InputInlineSelect, type InputInlineSelectOption, type InputInlineSelectProps, InputKeywordSearch, type InputKeywordSearchProps, type InputProps, InputSelect, type InputSelectProps, InputTime, type InputTimeProps, InputToggle, type InputToggleProps, IntegrationComingSoon, type IntegrationComingSoonProps, IntegrationLoadingTile, type IntegrationLoadingTileProps, IntegrationModalHeader, type IntegrationModalHeaderProps, IntegrationModalIcon, type IntegrationModalIconProps, IntegrationTile, type IntegrationTileProps, type IsoDateString, type IsoDateTimeString, type IsoTimeString, JsonEditor, type JsonEditorProps, KeyValueInput, type KeyValueInputProps, type KeyValueItem, Label, LabelLeadingIcon, type LabelLeadingIconProps, type LabelProps, Legend, type LegendProps, type LevelProps, LimitsBar, type LimitsBarProps, Link, type LinkColorProps, LinkList, type LinkListProps, type LinkManagerWithRefType, LinkNode, type LinkProps, LinkTile, type LinkTileWithRefProps, LinkWithRef, LoadingCardSkeleton, LoadingIcon, type LoadingIconProps, LoadingIndicator, LoadingOverlay, type LoadingOverlayProps, Menu, MenuButton, type MenuButtonProp, MenuGroup, type MenuGroupProps, MenuItem, MenuItemEmptyIcon, MenuItemIcon, MenuItemInner, type MenuItemProps, MenuItemSeparator, type MenuItemTextThemeProps, type MenuProps, MenuSelect, MenuThreeDots, type MenuThreeDotsProps, Modal, ModalDialog, type ModalDialogProps, type ModalProps, MultilineChip, type MultilineChipProps, ObjectGridContainer, type ObjectGridContainerProps, ObjectGridItem, ObjectGridItemCardCover, type ObjectGridItemCardCoverProps, ObjectGridItemCover, ObjectGridItemCoverButton, type ObjectGridItemCoverButtonProps, type ObjectGridItemCoverProps, ObjectGridItemHeading, ObjectGridItemIconWithTooltip, type ObjectGridItemIconWithTooltipProps, ObjectGridItemLoadingSkeleton, type ObjectGridItemProps, type ObjectGridItemTitleProps, ObjectItemLoadingSkeleton, type ObjectItemLoadingSkeletonProps, ObjectListItem, ObjectListItemContainer, ObjectListItemCover, type ObjectListItemCoverProps, ObjectListItemHeading, type ObjectListItemHeadingProps, type ObjectListItemProps, PageHeaderSection, type PageHeaderSectionProps, Pagination, Paragraph, type ParagraphProps, ParameterActionButton, type ParameterActionButtonProps, ParameterDrawerHeader, type ParameterDrawerHeaderProps, ParameterGroup, type ParameterGroupProps, ParameterImage, ParameterImageInner, ParameterImagePreview, type ParameterImageProps, ParameterInput, ParameterInputInner, type ParameterInputProps, ParameterLabel, type ParameterLabelProps, ParameterLink, ParameterLinkInner, type ParameterLinkProps, ParameterMenuButton, type ParameterMenuButtonProps, ParameterMultiSelect, ParameterMultiSelectInner, type ParameterMultiSelectOption, type ParameterMultiSelectProps, ParameterNameAndPublicIdInput, type ParameterNameAndPublicIdInputProps, ParameterNumberSlider, ParameterNumberSliderInner, type ParameterNumberSliderProps, ParameterOverrideMarker, ParameterRichText, ParameterRichTextInner, type ParameterRichTextInnerProps, type ParameterRichTextProps, ParameterSelect, ParameterSelectInner, type ParameterSelectProps, ParameterSelectSlider, ParameterSelectSliderInner, type ParameterSelectSliderProps, ParameterShell, ParameterShellContext, ParameterShellPlaceholder, type ParameterShellProps, ParameterTextarea, ParameterTextareaInner, type ParameterTextareaProps, ParameterToggle, ParameterToggleInner, type ParameterToggleProps, Popover, PopoverBody, type PopoverBodyProps, type PopoverProps, ProgressBar, type ProgressBarProps, ProgressList, ProgressListItem, type ProgressListItemProps, type ProgressListProps, type RegisterDrawerProps, ResolveIcon, type ResolveIconProps, ResponsiveTableContainer, type RhythmProps, type RichTextParamValue, RichTextToolbarIcon, type ScrollableItemProps, ScrollableList, type ScrollableListContainerProps, ScrollableListInputItem, ScrollableListItem, type ScrollableListItemProps, type ScrollableListProps, SearchableMenu, type SearchableMenuProps, SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, SelectableMenuItem, type SelectableMenuItemProps, type SerializedLinkNode, type ShortcutReference, Skeleton, type SkeletonProps, Slider, SliderLabels, type SliderLabelsProps, type SliderOption, type SliderProps, Spinner, StatusBullet, type StatusBulletProps, type StatusTypeProps, SuccessMessage, type SuccessMessageProps, Switch, type SwitchProps, TAKEOVER_STACK_ID, TabButton, TabButtonGroup, type TabButtonProps, TabContent, type TabContentProps, Table, TableBody, type TableBodyProps, TableCellData, type TableCellDataProps, TableCellHead, type TableCellHeadProps, TableFoot, type TableFootProps, TableHead, type TableHeadProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, TakeoverDrawerRenderer, type TextAlignProps, Textarea, type TextareaProps, Theme, type ThemeProps, type TickMark, Tile, TileContainer, type TileContainerProps, type TileProps, TileText, type TileTitleProps, ToastContainer, type ToastContainerProps, Tooltip, type TooltipProps, TwoColumnLayout, type TwoColumnLayoutProps, UniformBadge, UniformLogo, UniformLogoLarge, type UniformLogoProps, type UseShortcutOptions, type UseShortcutResult, VerticalRhythm, WarningMessage, type WarningMessageProps, accessibleHidden, actionBarVisibilityStyles, addPathSegmentToPathname, borderTopIcon, breakpoints, button, buttonAccentAltDark, buttonAccentAltDarkOutline, buttonDestructive, buttonDisabled, buttonGhost, buttonGhostDestructive, buttonGhostUnimportant, buttonPrimary, buttonPrimaryInvert, buttonRippleEffect, buttonSecondary, buttonSecondaryInvert, buttonSoftAccentPrimary, buttonSoftAlt, buttonSoftDestructive, buttonSoftPrimary, buttonSoftTertiary, buttonTertiary, buttonTertiaryOutline, buttonUnimportant, canvasAlertIcon, cardIcon, chatIcon, convertComboBoxGroupsToSelectableGroups, cq, customIcons, debounce, extractParameterProps, fadeIn, fadeInBottom, fadeInLtr, fadeInRtl, fadeInTop, fadeOutBottom, fullWidthScreenIcon, getButtonSize, getButtonStyles, getComboBoxSelectedSelectableGroups, getDrawerAttributes, getFormattedShortcut, getParentPath, getPathSegment, growSubtle, imageTextIcon, infoFilledIcon, input, inputError, inputSelect, isSecureURL, isValidUrl, jsonIcon, labelText, mq, numberInput, prefersReducedMotion, queryStringIcon, rectangleRoundedIcon, replaceUnderscoreInString, richTextToolbarButton, richTextToolbarButtonActive, ripple, scrollbarStyles, settings, settingsIcon, skeletonLoading, slideInRtl, slideInTtb, spin, structurePanelIcon, supports, textInput, uniformAiIcon, uniformComponentIcon, uniformComponentPatternIcon, uniformCompositionPatternIcon, uniformConditionalValuesIcon, uniformContentTypeIcon, uniformEntryIcon, uniformEntryPatternIcon, uniformLocaleDisabledIcon, uniformLocaleIcon, uniformStatusDraftIcon, uniformStatusModifiedIcon, uniformStatusPublishedIcon, uniformUsageStatusIcon, useBreakpoint, useButtonStyles, useCloseCurrentDrawer, useCurrentDrawer, useCurrentTab, useDateTimePickerContext, useDrawer, useIconContext, useImageLoadFallback, useOutsideClick, useParameterShell, usePopoverComponentContext, useRichTextToolbarState, useShortcut, functionalColors as utilityColors, warningIcon, yesNoIcon, zigZag, zigZagThick };
5631
+ export { AVATAR_SIZE_2XL, AVATAR_SIZE_2XS, AVATAR_SIZE_3XL, AVATAR_SIZE_LG, AVATAR_SIZE_MD, AVATAR_SIZE_SM, AVATAR_SIZE_XL, AVATAR_SIZE_XS, type ActionButtonsProps, AddButton, type AddButtonProps, AddListButton, type AddListButtonProps, type AddListButtonThemeProps, AsideAndSectionLayout, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Banner, type BannerProps, type BannerType, BetaDecorator, type BoxHeightProps, type BreakpointSize, type BreakpointsMap, Button, type ButtonProps, type ButtonSizeProps, type ButtonSoftThemeProps, type ButtonThemeProps, ButtonWithMenu, type ButtonWithMenuProps, Calendar, type CalendarCellCss, type CalendarProps, type CalendarStyles, Callout, type CalloutProps, type CalloutType, Caption, type CaptionProps, Card, CardContainer, type CardContainerBgColorProps, type CardContainerProps, type CardProps, CardTitle, type CardTitleProps, CheckboxWithInfo, type CheckboxWithInforProps, type ChildFunction, Chip, type ChipProps, type ChipTheme, type ComboBoxGroupBase, type ComboBoxSelectableGroup, type ComboBoxSelectableItem, type ComboBoxSelectableOption, Container, type ContainerProps, type ConvertComboBoxGroupsToSelectableGroupsOptions, Counter, type CounterBgColors, type CounterIconColors, type CounterProps, CreateTeamIntegrationTile, type CreateTeamIntegrationTileProps, CurrentDrawerContext, DashedBox, type DashedBoxProps, DateTimePicker, type DateTimePickerProps, DateTimePickerSummary, type DateTimePickerValue, DateTimePickerVariant, DebouncedInputKeywordSearch, type DebouncedInputKeywordSearchProps, DescriptionList, type DescriptionListProps, Details, type DetailsProps, DismissibleChipAction, DragHandle, type DraggableHandleProps, Drawer, DrawerContent, type DrawerContentProps, type DrawerContextValue, type DrawerItem, type DrawerProps, DrawerProvider, DrawerRenderer, type DrawerRendererItemProps, type DrawerRendererProps, type DrawersRegistryRecord, DropdownStyleMenuTrigger, type DropdownStyleMenuTriggerProps, EditTeamIntegrationTile, type EditTeamIntegrationTileProps, ErrorMessage, type ErrorMessageProps, FieldMessage, type FieldMessageProps, Fieldset, type FieldsetProps, FilterChip, FlexiCard, FlexiCardTitle, type GroupedOption, Heading, type HeadingProps, HorizontalRhythm, Icon, IconButton, type IconButtonProps, type IconColor, type IconName, type IconProps, type IconType, IconsProvider, Image, ImageBroken, type ImageProps, InfoMessage, type InfoMessageProps, Input, InputComboBox, type InputComboBoxOption, type InputComboBoxProps, InputCreatableComboBox, type InputCreatableComboBoxProps, InputInlineSelect, type InputInlineSelectOption, type InputInlineSelectProps, InputKeywordSearch, type InputKeywordSearchProps, type InputProps, InputSelect, type InputSelectProps, InputTime, type InputTimeProps, InputToggle, type InputToggleProps, IntegrationComingSoon, type IntegrationComingSoonProps, IntegrationLoadingTile, type IntegrationLoadingTileProps, IntegrationModalHeader, type IntegrationModalHeaderProps, IntegrationModalIcon, type IntegrationModalIconProps, IntegrationTile, type IntegrationTileProps, type IsoDateString, type IsoDateTimeString, type IsoTimeString, JsonEditor, type JsonEditorProps, KeyValueInput, type KeyValueInputProps, type KeyValueItem, Label, LabelLeadingIcon, type LabelLeadingIconProps, type LabelOption, type LabelProps, LabelsQuickFilter, type LabelsQuickFilterItem, type LabelsQuickFilterProps, Legend, type LegendProps, type LevelProps, LimitsBar, type LimitsBarProps, Link, LinkButton, type LinkButtonProps, type LinkColorProps, LinkList, type LinkListProps, type LinkManagerWithRefType, LinkNode, type LinkProps, LinkTile, type LinkTileWithRefProps, LinkWithRef, LoadingCardSkeleton, LoadingIcon, type LoadingIconProps, LoadingIndicator, LoadingOverlay, type LoadingOverlayProps, Menu, MenuButton, type MenuButtonProp, MenuGroup, type MenuGroupProps, MenuItem, MenuItemEmptyIcon, MenuItemIcon, MenuItemInner, type MenuItemProps, MenuItemSeparator, type MenuItemTextThemeProps, type MenuProps, MenuSelect, MenuThreeDots, type MenuThreeDotsProps, Modal, ModalDialog, type ModalDialogProps, ModalPortalContext, type ModalProps, MultilineChip, type MultilineChipProps, ObjectGridContainer, type ObjectGridContainerProps, ObjectGridItem, ObjectGridItemCardCover, type ObjectGridItemCardCoverProps, ObjectGridItemCover, ObjectGridItemCoverButton, type ObjectGridItemCoverButtonProps, type ObjectGridItemCoverProps, ObjectGridItemHeading, ObjectGridItemIconWithTooltip, type ObjectGridItemIconWithTooltipProps, ObjectGridItemLoadingSkeleton, type ObjectGridItemProps, type ObjectGridItemTitleProps, ObjectItemLoadingSkeleton, type ObjectItemLoadingSkeletonProps, ObjectListItem, ObjectListItemContainer, ObjectListItemCover, type ObjectListItemCoverProps, ObjectListItemHeading, type ObjectListItemHeadingProps, type ObjectListItemProps, ObjectListSubText, PageHeaderSection, type PageHeaderSectionProps, Pagination, Paragraph, type ParagraphProps, ParameterActionButton, type ParameterActionButtonProps, ParameterDrawerHeader, type ParameterDrawerHeaderProps, ParameterGroup, type ParameterGroupProps, ParameterImage, ParameterImageInner, ParameterImagePreview, type ParameterImageProps, ParameterInput, ParameterInputInner, type ParameterInputProps, ParameterLabel, type ParameterLabelProps, ParameterLabels, ParameterLabelsInner, ParameterLink, ParameterLinkInner, type ParameterLinkProps, ParameterMenuButton, type ParameterMenuButtonProps, ParameterMultiSelect, ParameterMultiSelectInner, type ParameterMultiSelectOption, type ParameterMultiSelectProps, ParameterNameAndPublicIdInput, type ParameterNameAndPublicIdInputProps, ParameterNumberSlider, ParameterNumberSliderInner, type ParameterNumberSliderProps, ParameterOverrideMarker, ParameterRichText, ParameterRichTextInner, type ParameterRichTextInnerProps, type ParameterRichTextProps, ParameterSelect, ParameterSelectInner, type ParameterSelectProps, ParameterSelectSlider, ParameterSelectSliderInner, type ParameterSelectSliderProps, ParameterShell, ParameterShellContext, ParameterShellPlaceholder, type ParameterShellProps, ParameterTextarea, ParameterTextareaInner, type ParameterTextareaProps, ParameterToggle, ParameterToggleInner, type ParameterToggleProps, Popover, PopoverBody, type PopoverBodyProps, type PopoverProps, type PopoverStore, ProgressBar, type ProgressBarProps, ProgressList, ProgressListItem, type ProgressListItemProps, type ProgressListProps, QuickFilter, type QuickFilterSelectedItem, type RegisterDrawerProps, ResolveIcon, type ResolveIconProps, ResponsiveTableContainer, type RhythmProps, type RichTextParamValue, RichTextToolbarIcon, type ScrollableItemProps, ScrollableList, type ScrollableListContainerProps, ScrollableListInputItem, ScrollableListItem, type ScrollableListItemProps, type ScrollableListProps, SearchableMenu, type SearchableMenuProps, SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, SelectableMenuItem, type SelectableMenuItemProps, type SerializedLinkNode, type ShortcutReference, Skeleton, type SkeletonProps, Slider, SliderLabels, type SliderLabelsProps, type SliderOption, type SliderProps, Spinner, StackedModal, type StackedModalProps, StackedModalStep, type StackedModalStepProps, StatusBullet, type StatusBulletProps, type StatusTypeProps, type StepTransitionState, SuccessMessage, type SuccessMessageProps, Swatch, SwatchComboBox, SwatchComboBoxLabelStyles, SwatchLabel, type SwatchLabelProps, SwatchLabelRemoveButton, SwatchLabelTooltip, type SwatchProps, type SwatchSize, type SwatchVariant, Switch, type SwitchProps, TAKEOVER_STACK_ID, TabButton, TabButtonGroup, type TabButtonGroupProps, type TabButtonProps, TabContent, type TabContentProps, Table, TableBody, type TableBodyProps, TableCellData, type TableCellDataProps, TableCellHead, type TableCellHeadProps, TableFoot, type TableFootProps, TableHead, type TableHeadProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, TakeoverDrawerRenderer, type TextAlignProps, Textarea, type TextareaProps, Theme, type ThemeProps, type TickMark, Tile, TileContainer, type TileContainerProps, type TileProps, TileText, type TileTitleProps, ToastContainer, type ToastContainerProps, type ToastData, type ToastId, type ToastOptions, type ToastPromiseOptions, type ToastUpdate, Tooltip, type TooltipProps, TwoColumnLayout, type TwoColumnLayoutProps, UniformBadge, UniformLogo, UniformLogoLarge, type UniformLogoProps, type UseShortcutOptions, type UseShortcutResult, VerticalRhythm, WarningMessage, type WarningMessageProps, accessibleHidden, actionBarVisibilityStyles, addPathSegmentToPathname, avatarImageStyles, avatarSize2xlStyles, avatarSize2xsStyles, avatarSize3xlStyles, avatarSizeLgStyles, avatarSizeMdStyles, avatarSizeSmStyles, avatarSizeXlStyles, avatarSizeXsStyles, avatarStyles, borderTopIcon, breakpoints, button, buttonAccentAltDark, buttonAccentAltDarkOutline, buttonDestructive, buttonDisabled, buttonGhost, buttonGhostDestructive, buttonGhostUnimportant, buttonPrimary, buttonPrimaryInvert, buttonRippleEffect, buttonSecondary, buttonSecondaryInvert, buttonSoftAccentPrimary, buttonSoftAlt, buttonSoftDestructive, buttonSoftPrimary, buttonSoftTertiary, buttonTertiary, buttonTertiaryOutline, buttonUnimportant, canvasAlertIcon, cardIcon, chatIcon, convertComboBoxGroupsToSelectableGroups, cq, customIcons, debounce, extractParameterProps, fadeIn, fadeInBottom, fadeInLtr, fadeInRtl, fadeInTop, fadeOutBottom, fullWidthScreenIcon, getButtonSize, getButtonStyles, getComboBoxSelectedSelectableGroups, getDrawerAttributes, getFormattedShortcut, getParentPath, getPathSegment, growSubtle, imageTextIcon, infoFilledIcon, input, inputError, inputSelect, isSecureURL, isValidUrl, jsonIcon, labelText, mq, numberInput, popTopLayerDialog, prefersReducedMotion, pushTopLayerDialog, queryStringIcon, rectangleRoundedIcon, replaceUnderscoreInString, richTextToolbarButton, richTextToolbarButtonActive, ripple, scrollbarStyles, settings, settingsIcon, skeletonLoading, slideInRtl, slideInTtb, spin, structurePanelIcon, subscribeTopLayerDialog, supports, swatchColors, swatchVariant, textInput, toast, uniformAiIcon, uniformComponentIcon, uniformComponentPatternIcon, uniformCompositionPatternIcon, uniformConditionalValuesIcon, uniformContentTypeIcon, uniformEntryIcon, uniformEntryPatternIcon, uniformLocaleDisabledIcon, uniformLocaleIcon, uniformStatusDraftIcon, uniformStatusModifiedIcon, uniformStatusPublishedIcon, uniformUsageStatusIcon, useBreakpoint, useButtonStyles, useCloseCurrentDrawer, useCurrentDrawer, useCurrentTab, useDateTimePickerContext, useDrawer, useIconContext, useImageLoadFallback, useIsSubmenuTriggerMode, useModalPortalContainer, useOutsideClick, useParameterShell, usePopoverComponentContext, useRichTextToolbarState, useShortcut, useStackedModal, functionalColors as utilityColors, warningIcon, yesNoIcon, zigZag, zigZagThick };