@lumx/react 4.17.1-alpha.0 → 4.17.1-alpha.1

package/index.d.ts

@@ -1862,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).

package/index.js

@@ -7406,13 +7406,15 @@ function setupComboboxInput(input, options) {
   /**
    * Wraps the consumer's onSelect to perform input-mode side effects after selection:
    * resets the filter and typing state.
+   * Forwards the return value of the consumer callback.
    */
   const onSelect = option => {
-    optionOnSelect?.(option);
+    const result = optionOnSelect?.(option);
     userHasTyped = false;
     if (autoFilter) {
       handle.setFilter('');
     }
+    return result;
   };
   handle = setupCombobox({
     onSelect
@@ -8176,9 +8178,13 @@ 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);
+        // Fire consumer callback first so it can return false before onChange.
+        const prevented = onSelectRef.current?.(option) === false;
+        // Update controlled value through React's normal onChange flow,
+        // unless the consumer returned false.
+        if (!prevented) {
+          onChangeRef.current?.(option.value);
+        }
       },
       onInput(value) {
         // Keep controlled value in sync.