@lumx/core 4.18.0-next.1 → 4.18.0-next.3

package/js/components/Combobox/TestStories.d.ts

@@ -23,12 +23,13 @@ export declare function setup({ components: { Combobox, IconButton, Button }, de
             value: string;
         };
         decorators: ((story: any, context: any) => any)[];
-        render: ({ value, onChange, onSelect, }: {
+        render: ({ value, onChange, onSelect, selectionMode, }: {
             value: string;
             onChange: (v: string) => void;
             onSelect?: (option: {
                 value: string;
             }) => void;
+            selectionMode?: import("./types").ComboboxInputOptions["selectionMode"];
         }) => import("react").JSX.Element;
     };
     ClickAwayClosesPopup: {
@@ -45,12 +46,13 @@ export declare function setup({ components: { Combobox, IconButton, Button }, de
             value: string;
         };
         decorators: ((story: any, context: any) => any)[];
-        render: ({ value, onChange, onSelect, }: {
+        render: ({ value, onChange, onSelect, selectionMode, }: {
             value: string;
             onChange: (v: string) => void;
             onSelect?: (option: {
                 value: string;
             }) => void;
+            selectionMode?: import("./types").ComboboxInputOptions["selectionMode"];
         }) => import("react").JSX.Element;
     };
     OptionMoreInfoKeyboardHighlight: {
@@ -175,12 +177,13 @@ export declare function setup({ components: { Combobox, IconButton, Button }, de
             value: string;
         };
         decorators: ((story: any, context: any) => any)[];
-        render: ({ value, onChange, onSelect, }: {
+        render: ({ value, onChange, onSelect, selectionMode, }: {
             value: string;
             onChange: (v: string) => void;
             onSelect?: (option: {
                 value: string;
             }) => void;
+            selectionMode?: import("./types").ComboboxInputOptions["selectionMode"];
         }) => import("react").JSX.Element;
     };
 };

package/js/components/Combobox/Tests.d.ts

@@ -1,3 +1,4 @@
+import type { ComboboxInputOptions } from './types';
 /** Combobox compound component namespace type. */
 export interface ComboboxNamespace {
     Provider: any;
@@ -45,12 +46,13 @@ export declare function getActiveOption(): HTMLElement | null;
  * Exported so TestStories.tsx can reuse the same templates for browser-only tests.
  */
 export declare function createTemplates(Combobox: ComboboxNamespace, IconButton: any): {
-    inputTemplate: ({ value, onChange, onSelect, }: {
+    inputTemplate: ({ value, onChange, onSelect, selectionMode, }: {
         value: string;
         onChange: (v: string) => void;
         onSelect?: (option: {
             value: string;
         }) => void;
+        selectionMode?: ComboboxInputOptions["selectionMode"];
     }) => import("react").JSX.Element;
     manualFilterTemplate: ({ value, onChange, onSelect, }: {
         value: string;

package/js/components/Combobox/setupComboboxInput.d.ts

@@ -6,6 +6,15 @@ export interface SetupComboboxInputOptions extends ComboboxCallbacks, ComboboxIn
      * (Use this in framework wrappers that maintain controlled input state, like React)
      */
     onInput?(value: string): void;
+    /**
+     * Called when the input value should change as a result of option selection,
+     * with `selectionMode` already applied.
+     *
+     * - `'fill'` (default): called with the selected option value.
+     * - `'clear'`: called with an empty string.
+     * - `'keep'`: NOT called (input value unchanged).
+     */
+    onChange?(value: string): void;
 }
 /**
  * Set up a combobox with an input trigger (autocomplete/filter pattern).

package/js/components/Combobox/types.d.ts

@@ -69,6 +69,19 @@ export 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';
 }
 /** Handle returned by `setupCombobox`. Used by framework wrappers and mode controllers. */
 export interface ComboboxHandle {

package/package.json

@@ -7,7 +7,7 @@
     },
     "dependencies": {
         "@floating-ui/dom": "^1.7.5",
-        "@lumx/icons": "^4.18.0-next.1",
+        "@lumx/icons": "^4.18.0-next.3",
         "classnames": "^2.3.2",
         "focus-visible": "^5.0.2",
         "lodash": "4.18.1",
@@ -66,7 +66,7 @@
         "update-version-changelog": "yarn version-changelog ../../CHANGELOG.md"
     },
     "sideEffects": false,
-    "version": "4.18.0-next.1",
+    "version": "4.18.0-next.3",
     "devDependencies": {
         "@rollup/plugin-typescript": "^12.3.0",
         "@testing-library/dom": "^10.4.1",