@keenmate/web-multiselect 2.0.0-rc10 → 2.0.0-rc12

package/dist/index.d.ts

@@ -336,6 +336,20 @@ declare interface MultiSelectConfig<T = any> {
     isAddNewAllowed?: boolean;
     /** Show count badge next to toggle icon (internal: isCounterShown) */
     isCounterShown?: boolean;
+    /**
+     * Show an inline clear (✕) button inside the input that wipes the whole selection.
+     * Appears only while something is selected (and the control is enabled). Clicking it
+     * clears the selection and any search text, fires `change`, and refocuses the input.
+     * Default `false`. (internal: isClearShown)
+     */
+    isClearShown?: boolean;
+    /**
+     * Scope the "one overlay open at a time" coordination to a named group. Overlays
+     * (multiselects, datepickers, external popovers) sharing a group dismiss each other
+     * when one opens; different groups are independent. Unset = the default (ungrouped)
+     * group, in which every ungrouped overlay coordinates. (internal: overlayGroup)
+     */
+    overlayGroup?: string;
     /**
      * Allow the selected-items popover to open. Defaults to `true`. The popover is triggered by
      * the count / compact / "+X more" badge and by the in-input counter (`isCounterShown`). Set
@@ -653,6 +667,15 @@ export declare class MultiSelectElement<T = any> extends BlissElement<MultiSelec
     showMessage(content: string | HTMLElement, opts?: MessageOptions): void;
     /** Dismiss the transient message shown by {@link showMessage}, if any. */
     hideMessage(): void;
+    /** Open the dropdown. */
+    open(): void;
+    /** Close the dropdown. */
+    close(): void;
+    /** Toggle the dropdown open/closed. */
+    toggle(): void;
+    /** Whether the dropdown is currently open. Assigning opens/closes it. */
+    get isOpen(): boolean;
+    set isOpen(value: boolean);
     destroy(): void;
 }
 
@@ -903,10 +926,10 @@ export declare const uiLogger: Logger;
 export declare type ValueFormat = 'json' | 'csv' | 'array';
 
 export declare class WebMultiSelect<T = any> {
+    #private;
     private element;
     private instanceId;
     private options;
-    private isOpen;
     private selectedValues;
     private selectedOptions;
     private allOptions;
@@ -962,14 +985,17 @@ export declare class WebMultiSelect<T = any> {
     private selectedPopoverVirtualScroll;
     private selectedPopoverContainer;
     private input;
+    private inputWrapper;
     private dropdown;
     private dropdownInner;
     private badgesContainer;
     private counter;
+    private clearButton;
     private hint?;
     private selectedPopover;
     private documentKeydownHandler;
     private documentClickHandler;
+    private overlayCoord;
     /**
      * Generic field extractor with the precedence:
      *   tuple short-circuit -> member property -> callback -> fallback
@@ -1257,14 +1283,33 @@ export declare class WebMultiSelect<T = any> {
     private deselectOption;
     private selectAll;
     clearAll(): void;
+    /**
+     * Inline clear (✕) handler: wipe the whole selection and any search text, then
+     * restore focus to the input. clearAll() → commit() → renderBadges() already
+     * refreshes this button's visibility (it hides once nothing is selected).
+     */
+    private clearClick;
+    /**
+     * Show the inline clear (✕) only when it is opted in (isClearShown), something is
+     * selected, and the control is enabled. Called from renderBadges() so it tracks
+     * every selection change. Uses inline display like the counter / fullscreen clear.
+     */
+    private updateClearButton;
     /**
      * Re-render and fire callbacks after a selection state change.
      * `added` / `removed` drive per-item select/deselect callbacks.
      * `onChange` fires once if anything actually changed.
      */
     private commit;
-    private open;
-    private close;
+    /** Open the dropdown (no-op if already open, or if there is nothing to show). */
+    open(): void;
+    /** Close the dropdown (no-op if already closed). */
+    close(): void;
+    /** Toggle the dropdown open/closed. */
+    toggle(): void;
+    /** Whether the dropdown is currently open. Assigning opens/closes it. */
+    get isOpen(): boolean;
+    set isOpen(value: boolean);
     /**
      * Anchor a floating panel (dropdown or selected-items popover) below/above the input with
      * placement-locking and width-syncing. Returns the `autoUpdate` cleanup.