@lumx/react 4.17.0 → 4.17.1-alpha.1

package/index.d.ts

@@ -1457,6 +1457,25 @@ declare const Placement: {
     readonly LEFT_START: "left-start";
 };
 type Placement = ValueOf<typeof Placement>;
+/**
+ * Popover fit anchor width options.
+ */
+declare const FitAnchorWidth: {
+    readonly MAX_WIDTH: "maxWidth";
+    readonly MIN_WIDTH: "minWidth";
+    readonly WIDTH: "width";
+};
+type FitAnchorWidth = ValueOf<typeof FitAnchorWidth>;
+/**
+ * Popover height/width sizes
+ */
+declare const POPOVER_SIZES: readonly ["m", "l", "xl", "xxl"];
+
+/** Viewport-relative height value, e.g. `50vh`. */
+type VHSize = `${number}vh`;
+/** Pixel value, e.g. `12px`. */
+type PXSize = `${number}px`;
+
 /**
  * Offset of the popover.
  */
@@ -1470,15 +1489,26 @@ interface Offset {
  * Popover elevation index.
  */
 type Elevation = 1 | 2 | 3 | 4 | 5;
-/**
- * Popover fit anchor width options.
- */
-declare const FitAnchorWidth: {
-    readonly MAX_WIDTH: "maxWidth";
-    readonly MIN_WIDTH: "minWidth";
-    readonly WIDTH: "width";
-};
-type FitAnchorWidth = ValueOf<typeof FitAnchorWidth>;
+/** Popover size value — pixel value, or "t-shirt" size token. */
+type PopoverSize = PXSize | (typeof POPOVER_SIZES)[number];
+/** Popover height value — extends PopoverSize with viewport-relative unit. */
+type PopoverHeight = PopoverSize | VHSize;
+/** Popover width value — same as PopoverSize (pixels or t-shirt only). */
+type PopoverWidth = PopoverSize;
+interface PopoverSizes {
+    /** Exact width (pixels or t-shirt size). Combines with `fitToAnchorWidth`: if both target the same CSS property, the explicit prop wins for `width`. */
+    width?: PopoverWidth;
+    /** Minimum width (pixels or t-shirt size). Combines with `fitToAnchorWidth='minWidth'` as `max(anchor, value)`. */
+    minWidth?: PopoverWidth;
+    /** Maximum width (pixels or t-shirt size). Combines with `fitToAnchorWidth='maxWidth'` as `min(anchor, value)`. */
+    maxWidth?: PopoverWidth;
+    /** Exact height (pixels, vh, or t-shirt size). */
+    height?: PopoverHeight;
+    /** Minimum height (pixels, vh, or t-shirt size). */
+    minHeight?: PopoverHeight;
+    /** Maximum height (pixels, vh, or t-shirt size). Combines with `fitWithinViewportHeight` as `min(maxHeight, available)`. */
+    maxHeight?: PopoverHeight;
+}
 
 /**
  * Shared popover props used by both React and Vue wrappers.
@@ -1508,7 +1538,7 @@ interface PopoverProps$1 extends HasClassName, HasTheme, HasCloseMode {
      *   - `width`: popover equal to the anchor.
      */
     fitToAnchorWidth?: FitAnchorWidth | boolean;
-    /** Shrink popover if even after flipping there is not enough space. */
+    /** Constrain popover height to avoid overflowing the viewport. */
     fitWithinViewportHeight?: boolean;
     /** Element to focus when opening the popover. */
     focusElement?: CommonRef;
@@ -1541,7 +1571,7 @@ interface PopoverProps$1 extends HasClassName, HasTheme, HasCloseMode {
  * Extends core PopoverProps, overriding ref-typed props with React-specific `RefObject` types
  * and replacing `handleClose` with the React-idiomatic `onClose` callback.
  */
-interface PopoverProps extends GenericProps$1, ReactToJSX<PopoverProps$1, 'anchorRef' | 'as' | 'boundaryRef' | 'focusElement' | 'parentElement' | 'focusTrapZoneElement' | 'className'> {
+interface PopoverProps extends GenericProps$1, ReactToJSX<PopoverProps$1, 'anchorRef' | 'as' | 'boundaryRef' | 'focusElement' | 'parentElement' | 'focusTrapZoneElement' | 'className'>, PopoverSizes {
     /** Reference to the DOM element used to set the position of the popover. */
     anchorRef: RefObject<HTMLElement>;
     /** Customize the root element. (Must accept ref forwarding and props forwarding!). */
@@ -1832,10 +1862,14 @@ interface ComboboxEventMap {
 }
 /** Callbacks provided by the consumer (React/Vue) to react to combobox state changes. */
 interface ComboboxCallbacks {
-    /** Called when an option is selected (click or keyboard). */
+    /**
+     * Called when an option is selected (click or keyboard).
+     * Return `false` to skip the default behaviour of updating the input value via `onChange`.
+     * The combobox will still close normally.
+     */
     onSelect?(option: {
         value: string;
-    }): void;
+    }): boolean | void;
 }
 /**
  * Behavioral options for input-mode combobox (autocomplete/filter pattern).
@@ -2529,6 +2563,7 @@ interface DropdownProps extends GenericProps$1 {
 /**
  * Dropdown component.
  *
+ * @deprecated Use `MenuButton` for action-based dropdowns, `SelectButton` for selection-based dropdowns, or `Popover` for lower-level control.
  * @param  props Component props.
  * @param  ref   Component ref.
  * @return React element.
@@ -4336,11 +4371,8 @@ interface SelectButtonProps$1<O> extends BaseSelectProps<O> {
      * The wrapper layer chooses the shape; the core just renders names.
      */
     value?: O | O[];
-    /**
-     * When `true`, sets `aria-multiselectable="true"` on the listbox so
-     * the dropdown stays open after each selection (combobox setup detects this attribute).
-     */
-    isMultiselectable?: boolean;
+    /** Single or multiple selection */
+    selectionType?: 'single' | 'multiple';
     /** Button label (used for ARIA and when no selection). */
     label: string;
     /** Controls how the label/value is displayed in the button. */
@@ -4388,7 +4420,7 @@ declare const DefaultButton: Comp<ButtonProps, HTMLButtonElement>;
 /** Keys managed internally — never forwarded to the trigger element. */
 type OmittedKeys = 'value' | 'children' | 'role' | 'aria-controls' | 'aria-haspopup' | 'aria-expanded' | 'aria-activedescendant' | 'ref';
 /** Select-specific props common to both single and multi modes. */
-type SelectButtonSelectProps<O> = Omit<ReactToJSX<SelectButtonProps$1<O>>, 'renderOption' | 'buttonProps' | 'value' | 'isMultiselectable'> & {
+interface SelectButtonSelectProps<O> extends ReactToJSX<SelectButtonProps$1<O>, 'renderOption' | 'buttonProps' | 'value' | 'handleSelect' | 'listProps' | 'infiniteScrollOptions'> {
     /** Called to load more options (infinite scroll). */
     onLoadMore?: () => void;
     /** Called when the dropdown opens or closes. */
@@ -4398,7 +4430,7 @@ type SelectButtonSelectProps<O> = Omit<ReactToJSX<SelectButtonProps$1<O>>, 'rend
      * Props `value`, `isSelected`, `description` and `key` are merged in automatically.
      */
     renderOption?: (option: O, index: number) => React__default.ReactNode;
-};
+}
 /**
  * Forwarded trigger props for a given element `E`, minus the keys that the
  * component manages internally.
@@ -4546,6 +4578,11 @@ interface MultipleSelectTextFieldProps<O = any> extends BaseSelectTextFieldProps
 }
 /**
  * SelectTextField props — supports both single and multiple selection.
+ * Discriminated on `selectionType`:
+ * - `'single'` → `value?: O`, `onChange?: (newValue?: O) => void`.
+ * - `'multiple'` → `value?: O[]`, `onChange?: (newValue?: O[]) => void`, `renderChip`, `getChipProps`.
+ *
+ * @typeParam O - Option object type, inferred from `options` / `getOptionId`.
  */
 type SelectTextFieldProps<O = any> = SingleSelectTextFieldProps<O> | MultipleSelectTextFieldProps<O>;
 
@@ -5435,7 +5472,16 @@ interface TimePickerFieldWrapperProps {
      */
     maxTime?: Date;
     /**
-     * Translations label for clear and show suggestions buttons.
+     * Controls how the time value interacts with `[minTime, maxTime]` bounds.
+     * Typed input is always snapped to bounds on blur.
+     * - `'enforce'`: additionally, the controlled `value` prop is proactively
+     *   clamped to bounds on mount and whenever bounds change, calling
+     *   `onChange` when adjusted.
+     * - `'on-blur'` (default): only blur snapping applies.
+     */
+    boundsMode?: 'on-blur' | 'enforce';
+    /**
+     * Translation labels for clear and show suggestions buttons.
      */
     translations: TimePickerFieldTranslations;
 }
@@ -5730,4 +5776,4 @@ declare const ThemeProvider: React__default.FC<{
 declare function useTheme(): ThemeContextValue;
 
 export { AlertDialog, Autocomplete, AutocompleteMultiple, Avatar, Badge, BadgeWrapper, Button, ButtonEmphasis, ButtonGroup, CLASSNAME$2 as CLASSNAME, COMPONENT_NAME$2 as COMPONENT_NAME, Checkbox, Chip, ChipGroup, Combobox, CommentBlock, CommentBlockVariant, DEFAULT_PROPS, DatePicker, DatePickerControlled, DatePickerField, Dialog, Divider, DragHandle, Dropdown, ExpansionPanel, Flag, FlexBox, GenericBlock, GenericBlockGapSize, Grid, GridColumn, GridItem, Heading, HeadingLevelProvider, Icon, IconButton, ImageBlock, ImageBlockCaptionPosition, ImageLightbox, InlineList, InputHelper, InputLabel, Lightbox, Link, LinkPreview, List, ListDivider, ListItem, ListSection, ListSubheader, MenuButton, ListDivider as MenuDivider, MenuItem, Message, Mosaic, Navigation, Notification, Placement, Popover, PopoverDialog, PostBlock, Progress, ProgressCircular, ProgressLinear, ProgressTracker, ProgressTrackerProvider, ProgressTrackerStep, ProgressTrackerStepPanel, ProgressVariant, RadioButton, RadioGroup, RawInputText, RawInputTextarea, Select, SelectButton, SelectMultiple, SelectMultipleField, SelectTextField, SelectVariant, SelectionChipGroup, SideNavigation, SideNavigationItem, SkeletonCircle, SkeletonRectangle, SkeletonRectangleVariant, SkeletonTypography, Slider, Slides, Slideshow, SlideshowControls, SlideshowItem, Switch, CLASSNAME as TIME_PICKER_FIELD_CLASSNAME, COMPONENT_NAME as TIME_PICKER_FIELD_COMPONENT_NAME, Tab, TabList, TabListLayout, TabPanel, TabProvider, Table, TableBody, TableCell, TableCellVariant, TableCellVariant as TableCellVariantType, TableHeader, TableRow, Text, TextField, ThOrder, ThOrder as ThOrderType, ThemeProvider, Thumbnail, ThumbnailAspectRatio, ThumbnailObjectFit, ThumbnailVariant, TimePickerField, Toolbar, Tooltip, Uploader, UploaderVariant, UserBlock, clamp, useFocusPointStyle, useHeadingLevel, useTheme };
-export type { AlertDialogProps, AutocompleteMultipleProps, AutocompleteProps, AvatarProps, AvatarSize, BadgeProps, BadgeWrapperProps, BaseButtonProps, ButtonGroupProps, ButtonProps, ButtonSize, CheckboxProps, ChipGroupProps, ChipProps, ComboboxButtonProps, ComboboxInputProps, ComboboxListProps, ComboboxOptionActionProps, ComboboxOptionMoreInfoProps, ComboboxOptionProps, ComboboxOptionSkeletonProps, ComboboxPopoverComponentProps, ComboboxPopoverProps, ComboboxProviderProps, ComboboxSectionProps, ComboboxStateProps, CommentBlockProps, DatePickerControlledProps, DatePickerFieldProps, DatePickerProps, DialogProps, DialogSizes, DividerProps, DragHandleProps, DropdownProps, Elevation, ExpansionPanelProps, FlagProps, FlexBoxProps, FlexHorizontalAlignment, FlexVerticalAlignment, FocusPoint, GapSize, GenericBlockProps, GenericBlockSectionProps, GridColumnGapSize, GridColumnProps, GridItemProps, GridProps, HeadingLevelProviderProps, HeadingProps, IconButtonProps, IconProps, IconSizes, ImageBlockProps, ImageBlockSize, ImageLightboxProps, InlineListProps, InputHelperProps, InputLabelProps, LightboxProps, LinkPreviewProps, LinkProps, ListDividerProps, ListItemProps, ListItemSize, ListProps, ListSectionProps, ListSubheaderProps, MarginAutoAlignment, MenuButtonProps, ListDividerProps as MenuDividerProps, MenuItemActionProps, MenuItemProps, MessageProps, MosaicProps, MultipleSelectButtonProps, MultipleSelectTextFieldProps, NavigationProps, NotificationProps, Offset, PopoverDialogProps, PopoverProps, PostBlockProps, ProgressCircularProps, ProgressCircularSize, ProgressLinearProps, ProgressProps, ProgressTrackerProps, ProgressTrackerProviderProps, ProgressTrackerStepPanelProps, ProgressTrackerStepProps, RadioButtonProps, RadioGroupProps, RawInputTextProps, RawInputTextareaProps, SelectButtonProps, SelectListStatus as SelectButtonStatus, SelectButtonTranslations, SelectListStatus, SelectMultipleProps, SelectProps, SelectTextFieldProps, SelectListStatus as SelectTextFieldStatus, SelectTextFieldTranslations, SelectionChipGroupProps, SideNavigationItemProps, SideNavigationProps, SingleSelectButtonProps, SingleSelectTextFieldProps, SkeletonCircleProps, SkeletonRectangleProps, SkeletonTypographyProps, SliderProps, SlidesProps, SlideshowControlsProps, SlideshowItemProps, SlideshowProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabProviderProps, TableBodyProps, TableCellProps, TableHeaderProps, TableProps, TableRowProps, TextFieldProps, TextProps, ThumbnailProps, ThumbnailSize, TimePickerFieldProps, ToolbarProps, TooltipPlacement, TooltipProps, UploaderProps, UploaderSize, UserBlockProps, UserBlockSize };
+export type { AlertDialogProps, AutocompleteMultipleProps, AutocompleteProps, AvatarProps, AvatarSize, BadgeProps, BadgeWrapperProps, BaseButtonProps, ButtonGroupProps, ButtonProps, ButtonSize, CheckboxProps, ChipGroupProps, ChipProps, ComboboxButtonProps, ComboboxInputProps, ComboboxListProps, ComboboxOptionActionProps, ComboboxOptionMoreInfoProps, ComboboxOptionProps, ComboboxOptionSkeletonProps, ComboboxPopoverComponentProps, ComboboxPopoverProps, ComboboxProviderProps, ComboboxSectionProps, ComboboxStateProps, CommentBlockProps, DatePickerControlledProps, DatePickerFieldProps, DatePickerProps, DialogProps, DialogSizes, DividerProps, DragHandleProps, DropdownProps, Elevation, ExpansionPanelProps, FlagProps, FlexBoxProps, FlexHorizontalAlignment, FlexVerticalAlignment, FocusPoint, GapSize, GenericBlockProps, GenericBlockSectionProps, GridColumnGapSize, GridColumnProps, GridItemProps, GridProps, HeadingLevelProviderProps, HeadingProps, IconButtonProps, IconProps, IconSizes, ImageBlockProps, ImageBlockSize, ImageLightboxProps, InlineListProps, InputHelperProps, InputLabelProps, LightboxProps, LinkPreviewProps, LinkProps, ListDividerProps, ListItemProps, ListItemSize, ListProps, ListSectionProps, ListSubheaderProps, MarginAutoAlignment, MenuButtonProps, ListDividerProps as MenuDividerProps, MenuItemActionProps, MenuItemProps, MessageProps, MosaicProps, MultipleSelectButtonProps, MultipleSelectTextFieldProps, NavigationProps, NotificationProps, Offset, PopoverDialogProps, PopoverHeight, PopoverProps, PopoverWidth, PostBlockProps, ProgressCircularProps, ProgressCircularSize, ProgressLinearProps, ProgressProps, ProgressTrackerProps, ProgressTrackerProviderProps, ProgressTrackerStepPanelProps, ProgressTrackerStepProps, RadioButtonProps, RadioGroupProps, RawInputTextProps, RawInputTextareaProps, SelectButtonProps, SelectListStatus as SelectButtonStatus, SelectButtonTranslations, SelectListStatus, SelectMultipleProps, SelectProps, SelectTextFieldProps, SelectListStatus as SelectTextFieldStatus, SelectTextFieldTranslations, SelectionChipGroupProps, SideNavigationItemProps, SideNavigationProps, SingleSelectButtonProps, SingleSelectTextFieldProps, SkeletonCircleProps, SkeletonRectangleProps, SkeletonTypographyProps, SliderProps, SlidesProps, SlideshowControlsProps, SlideshowItemProps, SlideshowProps, SwitchProps, TabListProps, TabPanelProps, TabProps, TabProviderProps, TableBodyProps, TableCellProps, TableHeaderProps, TableProps, TableRowProps, TextFieldProps, TextProps, ThumbnailProps, ThumbnailSize, TimePickerFieldProps, ToolbarProps, TooltipPlacement, TooltipProps, UploaderProps, UploaderSize, UserBlockProps, UserBlockSize };