@lumx/react 4.17.0 → 4.18.0-next.0

package/index.d.ts

@@ -2529,6 +2529,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 +4337,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 +4386,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 +4396,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 +4544,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 +5438,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;
 }