@lumx/react 4.18.0-next.2 → 4.18.0

package/index.d.ts

@@ -1890,6 +1890,19 @@ interface ComboboxInputOptions {
      * @default false (true when filter is 'off')
      */
     openOnFocus?: boolean;
+    /**
+     * Controls what happens to the input value when an option is selected.
+     *
+     * - `'fill'` (default) — The input is updated with the selected option value via `onChange`.
+     * - `'keep'` — The input value is left unchanged; `onChange` is not called.
+     *   Useful when the component manages the displayed value independently (e.g. showing
+     *   an option display name rather than the raw option ID). The filter still resets.
+     * - `'clear'` — The input is cleared (empty string) via `onChange` after selection.
+     *   Useful for multi-select patterns where typing starts fresh after each pick.
+     *
+     * @default 'fill'
+     */
+    selectionMode?: 'fill' | 'keep' | 'clear';
 }
 
 /**

package/index.js

@@ -7387,8 +7387,10 @@ function setupComboboxInput(input, options) {
   let handle;
   const {
     filter = 'auto',
+    selectionMode = 'fill',
     onSelect: optionOnSelect,
-    onInput: onInputCallback
+    onInput: onInputCallback,
+    onChange: onChangeCallback
   } = options;
   const openOnFocus = options.openOnFocus ?? filter === 'off';
   const autoFilter = filter === 'auto';
@@ -7404,15 +7406,20 @@ function setupComboboxInput(input, options) {
   let userHasTyped = false;
 
   /**
-   * Wraps the consumer's onSelect to perform input-mode side effects after selection:
-   * resets the filter and typing state.
+   * Wraps the consumer's onSelect to perform input-mode side effects after selection,
+   * and drive `onChange` according to `selectionMode`.
+   * Filter and typing state are always reset on selection.
    */
   const onSelect = option => {
     optionOnSelect?.(option);
     userHasTyped = false;
-    if (autoFilter) {
-      handle.setFilter('');
+    if (autoFilter) handle.setFilter('');
+    if (selectionMode === 'fill') {
+      onChangeCallback?.(option.value);
+    } else if (selectionMode === 'clear') {
+      onChangeCallback?.('');
     }
+    // 'keep': onChange is not called — input value stays as-is.
   };
   handle = setupCombobox({
     onSelect
@@ -8149,18 +8156,19 @@ const ComboboxInput = forwardRef((props, ref) => {
     setHandle
   } = useComboboxContext();
   const [isOpen, setIsOpen] = useComboboxOpen();
-  const state = useComboboxEvent('optionsChange', {
-    optionsLength: 0
-  });
-  const isLoading = useComboboxEvent('loadingChange', false);
   const {
     inputRef: externalInputRef,
     toggleButtonProps,
     onSelect,
     filter,
     openOnFocus,
+    selectionMode,
     ...otherProps
   } = props;
+  const state = useComboboxEvent('optionsChange', {
+    optionsLength: 0
+  });
+  const isLoading = useComboboxEvent('loadingChange', false);
   const internalInputRef = useRef(null);
   const mergedInputRef = useMergeRefs(externalInputRef, internalInputRef);
 
@@ -8176,14 +8184,15 @@ const ComboboxInput = forwardRef((props, ref) => {
     if (!input) return undefined;
     const handle = setupComboboxInput(input, {
       onSelect(option) {
-        // Update controlled value through React's normal onChange flow.
-        onChangeRef.current?.(option.value);
         onSelectRef.current?.(option);
       },
+      onChange(value) {
+        onChangeRef.current?.(value);
+      },
       onInput(value) {
-        // Keep controlled value in sync.
         onChangeRef.current?.(value);
       },
+      selectionMode,
       filter,
       openOnFocus
     });
@@ -8192,7 +8201,7 @@ const ComboboxInput = forwardRef((props, ref) => {
       handle.destroy();
       setHandle(null);
     };
-  }, [filter, openOnFocus, setHandle]);
+  }, [filter, openOnFocus, selectionMode, setHandle]);
   const handleToggle = useCallback(() => {
     setIsOpen(!isOpen);
     internalInputRef.current?.focus();
@@ -18258,6 +18267,7 @@ const SelectTextField$2 = (props, {
     children: [/*#__PURE__*/jsx(Combobox.Input, {
       label: label,
       ...inputProps,
+      selectionMode: "keep",
       chips: chips
     }), /*#__PURE__*/jsxs(Combobox.Popover, {
       fitToAnchorWidth: "minWidth",