@nova-design-system/nova-webcomponents 3.18.0 → 3.19.0

package/dist/collection/components/nv-fielddropdown/nv-fielddropdown.js

@@ -54,10 +54,6 @@ export class NvFielddropdown {
          * Defines the maximum height of the multiselect list when open.
          */
         this.maxHeight = '';
-        /**
-         * State of the dropdown popover.
-         */
-        this.open = false;
         /**
          * The text to display when no items match the filter.
          */
@@ -67,7 +63,21 @@ export class NvFielddropdown {
          */
         this.filterable = false;
         /**
-         * Delay in milliseconds before the search is triggered when typing in the filter input.
+         * When an item is selected by the user, the dropdown will continue to stay
+         * open.
+         */
+        this.openOnSelect = false;
+        /**
+         * Determines if the component’s filtering behavior is managed externally.
+         * When set to true and filterable is enabled, the component won’t
+         * automatically filter items. Instead, you must implement your own filtering
+         * logic (e.g., server-side search or custom matching) using the
+         * filterTextChanged event.
+         */
+        this.controlledFilter = false;
+        /**
+         * Delay in milliseconds before the search is triggered when typing in the
+         * filter input.
          * @default 300
          */
         this.debounceDelay = 300;
@@ -89,132 +99,75 @@ export class NvFielddropdown {
          */
         this.filterText = '';
         this.selectedValues = new Set();
-        this.handleInputContainerClick = (event) => {
-            if (this.disabled || this.readonly) {
+        this.open = false;
+        /**
+         * Closes the popover when a click is detected outside the component.
+         * @param {MouseEvent} event - The click event.
+         */
+        this.handleClickOutside = (event) => {
+            var _a;
+            if (!(event.target instanceof Node))
                 return;
-            }
-            const target = event.target;
-            if (target.tagName === 'P' || target.tagName === 'SPAN') {
-                this.open = true;
-                // Simulate focus to trigger "focus-within" style
-                const inputContainer = this.el.querySelector('.input-container');
-                if (inputContainer) {
-                    inputContainer.classList.add('focus-within');
-                    // Remove the "focus-within" class after a delay or when the popover is closed
-                    const removeFocusWithin = () => {
-                        inputContainer.classList.remove('focus-within');
-                    };
-                    // Or remove the class when the popover is closed
-                    this.popoverElement.addEventListener('hide', removeFocusWithin);
-                }
-            }
+            if (!((_a = this.el) === null || _a === void 0 ? void 0 : _a.contains(event.target)))
+                this.open = false;
         };
-        this.handleInput = (event) => {
-            if (!this.filterable)
-                return;
-            if (this.disabled || this.readonly) {
-                return;
-            }
-            const input = event.target;
+        this.handleFilterInput = () => {
             this.open = true;
-            // Clear any existing timer
-            if (this.debounceTimer) {
-                window.clearTimeout(this.debounceTimer);
-            }
-            // Set a new timer for filtering
+            this.filterText = this.inputElement.value;
+            this.filterTextChanged.emit(this.inputElement.value);
+            clearTimeout(this.debounceTimer);
             this.debounceTimer = window.setTimeout(() => {
-                this.filterText = input.value.toLowerCase();
                 this.filterItems();
             }, this.debounceDelay);
         };
-        this.handleInputFocus = () => {
-            if (this.disabled || this.readonly)
-                return;
-            this.open = true;
-        };
-        this.togglePopover = () => {
-            if (this.disabled || this.readonly)
-                return;
-            this.open = !this.open;
-        };
         this.getSelectedLabel = () => {
-            var _a, _b, _c, _d, _e, _f;
+            var _a, _b, _c, _d, _e, _f, _g;
             if (!this.value)
                 return '';
-            if (((_a = this.options) === null || _a === void 0 ? void 0 : _a.length) > 1) {
+            if ((_a = this.filterText) === null || _a === void 0 ? void 0 : _a.length)
+                return this.filterText;
+            if (((_b = this.options) === null || _b === void 0 ? void 0 : _b.length) > 1) {
                 const matchingItem = this.options.find(option => option.value === this.value);
-                return (_c = (_b = matchingItem === null || matchingItem === void 0 ? void 0 : matchingItem.label) !== null && _b !== void 0 ? _b : matchingItem === null || matchingItem === void 0 ? void 0 : matchingItem.value) !== null && _c !== void 0 ? _c : this.value;
+                return (_d = (_c = matchingItem === null || matchingItem === void 0 ? void 0 : matchingItem.label) !== null && _c !== void 0 ? _c : matchingItem === null || matchingItem === void 0 ? void 0 : matchingItem.value) !== null && _d !== void 0 ? _d : this.value;
             }
             const items = Array.from(this.el.querySelectorAll('nv-fielddropdownitem'));
             const matchingItem = items.find(item => item.value === this.value);
             const selectedLabel = matchingItem
-                ? (_f = (_d = matchingItem.label) !== null && _d !== void 0 ? _d : (_e = matchingItem.textContent) === null || _e === void 0 ? void 0 : _e.trim()) !== null && _f !== void 0 ? _f : matchingItem.value
+                ? (_g = (_e = matchingItem.label) !== null && _e !== void 0 ? _e : (_f = matchingItem.textContent) === null || _f === void 0 ? void 0 : _f.trim()) !== null && _g !== void 0 ? _g : matchingItem.value
                 : '';
             return selectedLabel;
         };
-        this.clearFilter = () => {
-            if (!this.filterable)
-                return;
-            this.filterText = '';
-            this.inputElement.value = this.getSelectedLabel();
-            this.inputElement.focus();
-            this.filterItems();
-        };
-        this.handleBlurInput = (event) => {
-            var _a;
-            const relatedTarget = event.relatedTarget;
-            if (!this.el.contains(relatedTarget) &&
-                !((_a = this.popoverElement) === null || _a === void 0 ? void 0 : _a.contains(relatedTarget))) {
-                this.open = false;
-                if (this.filterable) {
-                    this.clearFilter(); // Resets input to selected label, clears filterText
-                }
-            }
-        };
     }
     //#endregion EVENTS
     /****************************************************************************/
     //#region WATCHERS
-    handleOptionsChange(newValue) {
-        var _a;
-        if (!newValue)
-            return;
-        if (!this.value) {
-            const defaultValue = newValue.find(option => option.selected);
-            this.value = (_a = defaultValue === null || defaultValue === void 0 ? void 0 : defaultValue.value) !== null && _a !== void 0 ? _a : '';
-            this.updateSelectedItem(this.value);
+    handleOpenChange(newOpen) {
+        if (newOpen === false) {
+            clearTimeout(this.debounceTimer);
+            setTimeout(() => {
+                this.clearFilter();
+            }, 100);
         }
     }
-    watchValueHandler(newValue) {
-        this.valueChanged.emit(newValue);
+    handleValueChange() {
+        this.updateSelectedItem();
+        if (!this.open || !this.filterText)
+            this.setFilterInputToSelectedValue();
     }
-    handleOpenChange(newOpen) {
-        // React to external changes, e.g., clear filter or refilter on open
-        if (newOpen && this.filterable) {
-            this.filterItems(); // Ensure items are filtered if filterText exists
-        }
-        else if (!newOpen) {
-            this.clearFilter(); // Clear on external close
-        }
+    handleOptionsChange() {
+        this.updateSelectedItem();
     }
     //#endregion WATCHERS
     /****************************************************************************/
     //#region LISTENERS
-    handleOpenChanged(event) {
-        // Stop propagation to prevent the event from affecting parent components like dialogs
-        event.stopPropagation();
-        // Update `open` based on the popover state
-        if (event.target === this.popoverElement) {
-            this.open = event.detail;
-        }
-        if (!event.detail && this.filterable) {
-            this.clearFilter();
-        }
-    }
     handleDropdownItemSelected(event) {
         if (this.disabled || this.readonly)
             return;
-        const items = Array.from(this.el.querySelectorAll('nv-fielddropdownitem'));
+        if (!this.openOnSelect)
+            this.open = false;
+        if (event.detail.detached)
+            return;
+        const items = this.getAllItems();
         items.forEach(item => {
             if (item !== event.target) {
                 item.removeAttribute('selected');
@@ -223,102 +176,147 @@ export class NvFielddropdown {
                 item.setAttribute('selected', 'true');
             }
         });
-        this.clearFilter();
         this.value = event.detail.value;
-        this.open = false;
+        this.setFilterInputToSelectedValue();
+        this.valueChanged.emit(event.detail.value);
     }
-    handleBlur(event) {
-        const target = event.relatedTarget;
-        if (!(target instanceof Node) || !this.el.contains(target)) {
-            this.open = false;
-            if (this.inputElement) {
-                this.filterText = '';
-                this.inputElement.value = this.getSelectedLabel();
-                setTimeout(() => {
-                    this.filterItems();
-                }, 200);
-            }
+    handleFocus(event) {
+        if (event.relatedTarget instanceof HTMLElement &&
+            event.relatedTarget.tagName.includes('NV-FIELDDROPDOWNITEM')) {
+            return;
         }
+        if (event.target != this.toggleElement)
+            this.open = true;
+    }
+    handleFocusOut(event) {
+        if (!(event.relatedTarget instanceof Node))
+            return;
+        if (this.el.contains(event.relatedTarget))
+            return;
+        this.open = false;
     }
     handleKeyDown(event) {
-        if (!this.el)
+        if (event.key === 'Escape') {
+            this.focusField();
+            this.open = false;
             return;
-        if (!this.open) {
-            if (event.key === 'ArrowDown') {
+        }
+        if (event.key === ' ') {
+            if (event.target == this.selectElement) {
+                event.preventDefault(); // Prevent scrolling down
                 this.open = true;
-                event.preventDefault();
-                return;
             }
             return;
         }
-        const items = Array.from(this.el.querySelectorAll('nv-fielddropdownitem:not([disabled]):not([hidden])'));
-        let currentIndex = items.findIndex(item => item.classList.contains('highlighted'));
+        const items = this.getNavigableItems();
+        const highlightedItem = this.getHighlightedItemIndex(items);
         if (event.key === 'ArrowDown') {
-            event.preventDefault();
-            currentIndex = (currentIndex + 1) % items.length;
-            this.updateHighlightedItem(items, currentIndex);
-        }
-        else if (event.key === 'ArrowUp') {
-            event.preventDefault();
-            currentIndex = (currentIndex - 1 + items.length) % items.length;
-            this.updateHighlightedItem(items, currentIndex);
+            event.preventDefault(); // Prevent scrolling down
+            this.open = true;
+            const nextIndex = highlightedItem + 1;
+            this.updateHighlightedItem(items, nextIndex >= items.length ? 0 : nextIndex);
         }
-        else if (event.key === 'Escape') {
-            event.preventDefault();
-            this.open = false;
+        if (event.key === 'ArrowUp') {
+            event.preventDefault(); // Prevent scrolling up
+            this.open = true;
+            const nextIndex = highlightedItem - 1;
+            this.updateHighlightedItem(items, nextIndex < 0 ? items.length - 1 : nextIndex);
         }
     }
+    handleDocumentClick(event) {
+        this.handleClickOutside(event);
+    }
     //#endregion LISTENERS
     /****************************************************************************/
-    //#region LIFECYCLE
-    componentWillLoad() {
-        this.resetFilter();
-        if (this.filterable && this.filterText) {
-            this.filterItems();
-        }
-        if (this.options) {
-            this.handleOptionsChange(this.options);
+    //#region METHODS
+    /** Clears the filter text */
+    async clearFilter() {
+        var _a;
+        if (!this.filterable)
+            return;
+        if ((_a = this.filterText) === null || _a === void 0 ? void 0 : _a.length) {
+            this.filterText = '';
+            this.filterTextChanged.emit(this.filterText);
         }
+        this.filterItems();
+        // Wait for wrapper lifecycle to finish
+        setTimeout(() => {
+            this.setFilterInputToSelectedValue();
+        }, 0);
     }
-    componentDidLoad() {
-        if (this.value) {
-            this.updateSelectedItem(this.value);
+    /**
+     * Toggles the dropdown popover open state
+     * @param {boolean} open - The open state to set, if null, toggles the state
+     */
+    async toggleDropdown(open) {
+        if (open !== undefined) {
+            setTimeout(() => {
+                this.open = open;
+            }, 0);
         }
-        if (this.inputElement) {
-            this.inputElement.value = this.getSelectedLabel();
+        else {
+            setTimeout(() => {
+                this.open = !this.open;
+            }, 0);
         }
     }
-    //#endregion LIFECYCLE
-    /****************************************************************************/
-    //#region METHODS
-    /**
-     * Retrieves the current filter text entered by the user.
-     * @returns {string} The filter text.
-     */
-    async getFilterText() {
-        return this.filterText;
+    syncToggleDropdown() {
+        this.open = !this.open;
+    }
+    setFilterInputToSelectedValue() {
+        if (!this.filterable)
+            return;
+        if (!this.value)
+            return (this.inputElement.value = '');
+        this.inputElement.value = this.getSelectedLabel();
+    }
+    // Will exclude detached items and data-empty
+    getFilterableItems() {
+        return Array.from(this.el.querySelectorAll('nv-fielddropdownitem:not([data-empty]):not([detached])'));
+    }
+    getNavigableItems() {
+        return Array.from(this.el.querySelectorAll('nv-fielddropdownitem:not([disabled]):not([hidden])'));
+    }
+    getAllItems() {
+        return Array.from(this.el.querySelectorAll('nv-fielddropdownitem'));
+    }
+    getHighlightedItemIndex(items) {
+        return items.findIndex(item => item.classList.contains('highlighted'));
+    }
+    updateHighlightedItem(items, index) {
+        items.forEach((item, i) => {
+            item.classList.remove('highlighted');
+            if (i === index) {
+                item.classList.add('highlighted');
+                item.focus();
+                item.scrollIntoView({ block: 'nearest' });
+            }
+        });
+    }
+    focusField() {
+        const focusableItem = this.el.querySelector('[data-scope="focusable"]');
+        focusableItem === null || focusableItem === void 0 ? void 0 : focusableItem.focus();
     }
     /**
      * Filter dropdown items based on the text entered by the user.
      * If no items are found, display a message indicating no results.
      */
     filterItems() {
-        var _a;
-        const items = Array.from(this.el.querySelectorAll('nv-fielddropdownitem'));
-        // Remove the "no results found" item if it exists
-        const existingEmptyItem = this.el.querySelector('nv-fielddropdownitem[data-empty]');
-        if (existingEmptyItem) {
-            existingEmptyItem.remove();
-        }
+        var _a, _b;
+        if (this.controlledFilter)
+            return;
         let hasVisibleItems = false;
-        // Iterate over all items and adjust their visibility
+        const items = this.getFilterableItems();
+        // Remove the "no results found" item if it exists
+        (_a = this.el
+            .querySelector('nv-fielddropdownitem[data-empty]')) === null || _a === void 0 ? void 0 : _a.remove();
         items.forEach(item => {
             var _a, _b;
-            const textContent = ((_a = item.textContent) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || ''; // Get the textual content of the slot
-            const value = ((_b = item.value) === null || _b === void 0 ? void 0 : _b.toLowerCase()) || ''; // Get the value of the `value` attribute
-            // Check if the filtered text is present either in the value or in the textual content
-            const shouldShow = value.includes(this.filterText) ||
-                textContent.includes(this.filterText);
+            const filterText = this.filterText.toLowerCase();
+            const textContent = ((_a = item.textContent) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || '';
+            const value = ((_b = item.value) === null || _b === void 0 ? void 0 : _b.toLowerCase()) || '';
+            // Either in the value or in the textual content
+            const shouldShow = value.includes(filterText) || textContent.includes(filterText);
             if (shouldShow)
                 item.removeAttribute('hidden');
             else
@@ -333,56 +331,40 @@ export class NvFielddropdown {
             emptyItem.setAttribute('data-empty', 'true');
             emptyItem.setAttribute('disabled', 'true');
             emptyItem.textContent = this.emptyResult;
-            (_a = this.el.querySelector('ul[slot="content"]')) === null || _a === void 0 ? void 0 : _a.appendChild(emptyItem);
+            (_b = this.el.querySelector('div[slot="content"] ul')) === null || _b === void 0 ? void 0 : _b.prepend(emptyItem);
         }
     }
-    /** Reset the filter and make all items visible. */
-    resetFilter() {
-        const items = Array.from(this.el.querySelectorAll('nv-fielddropdownitem'));
-        items.forEach(item => {
-            item.style.display = '';
-        });
+    async updateSelectedItem() {
+        const items = this.getAllItems();
+        if (this.value) {
+            items.forEach(item => {
+                if (item.value === this.value) {
+                    item.selected = true;
+                }
+                else {
+                    item.selected = false;
+                }
+            });
+        }
     }
-    updateHighlightedItem(items, index) {
-        items.forEach((item, i) => {
-            if (i === index) {
-                item.classList.add('highlighted');
-                item.focus();
-                item.scrollIntoView({ block: 'nearest' });
-            }
-            else {
-                item.classList.remove('highlighted');
-            }
-        });
+    //#endregion METHODS
+    /****************************************************************************/
+    //#region LIFECYCLE
+    componentDidLoad() {
+        this.updateSelectedItem();
+        this.setFilterInputToSelectedValue();
     }
-    updateSelectedItem(value) {
-        if (!value)
-            return;
-        const items = Array.from(this.el.querySelectorAll('nv-fielddropdownitem'));
-        const matchingItem = items.find(item => {
-            var _a;
-            const itemLabel = item.getAttribute('label');
-            const itemValue = item.getAttribute('value');
-            const itemText = (_a = item.textContent) === null || _a === void 0 ? void 0 : _a.trim();
-            return itemLabel === value || itemValue === value || itemText === value;
-        });
-        items.forEach(item => {
-            if (item === matchingItem) {
-                item.setAttribute('selected', '');
-            }
-            else {
-                item.removeAttribute('selected');
-            }
-        });
+    disconnectedCallback() {
+        clearTimeout(this.debounceTimer);
     }
-    //#endregion METHODS
+    //#endregion LIFECYCLE
     /****************************************************************************/
     //#region RENDER
     render() {
         var _a;
-        return (h(Host, { key: '1d5a87b2a5e9d9ca0be659ba5706b1db068d1d2d', role: "combobox", "aria-expanded": this.open.toString(), "aria-haspopup": "listbox", "aria-label": this.label }, (this.label || this.el.querySelector('[slot="label"]')) && (h("label", { key: 'b07ca241c89f45292e479de79de618c6444a9c42', htmlFor: this.inputId }, h("slot", { key: '0dd6ac2799e187e7233a5a5651ef18d59e4507e8', name: "label" }, this.label))), h("nv-popover", { key: 'b06d107776724937816dc4b98a035b282ed6c1f3', ref: el => (this.popoverElement = el), triggerMode: "controlled", placement: "bottom-start", open: this.open }, h("div", { key: 'ab755801a0f2a732ea895e04d6c3a85261422f17', class: "input-wrapper", slot: "trigger" }, h("slot", { key: 'b78c41d4064cf067d69fa20ae583c1be29d1f620', name: "before-input" }), h("div", { key: 'b46f6440660056ff71b9debf503f15ca7046ca02', class: "input-container", onClick: this.handleInputContainerClick }, h("slot", { key: '36069ce529fba771c9339a3cb6c9c5c838f441c4', name: "leading-input" }), this.filterable || this.disabled || this.readonly ? (h("input", { "data-scope": "focusable", id: this.inputId, type: "search", ref: e => (this.inputElement = e), autofocus: this.autofocus, autocomplete: this.autocomplete, placeholder: this.placeholder, name: this.name, value: this.getSelectedLabel(), required: this.required, disabled: this.disabled, readOnly: this.readonly, onInput: this.handleInput, onFocus: this.handleInputFocus, onClick: this.handleInputFocus, onKeyDown: this.handleKeyDown, onBlur: this.handleBlurInput })) : (h("p", { "data-scope": "focusable", id: this.inputId, class: "non-filterable-text", onClick: this.handleInputContainerClick, tabIndex: this.disabled ? -1 : 0, onKeyDown: this.handleKeyDown, onFocus: this.handleInputFocus, onBlur: this.handleBlurInput }, this.getSelectedLabel() || this.value || this.placeholder)), this.filterable && this.filterText && this.open && (h("nv-iconbutton", { key: '36f76135c0e3e1e6750c95116aae6ddd397eec1f', name: "x", size: "md", emphasis: "lower", class: "clear-button", onClick: this.clearFilter, "aria-label": "Clear input" })), this.error && (h("nv-icon", { key: 'bd73c43ffae11897359adfae69572ee490f0f5c2', name: "alert-circle", class: "validation", size: "md" })), h("nv-iconbutton", { key: 'a0f237814e9f58aa9e4d72e73a1747248911ade8', "data-scope": "toggle-dropdown", name: this.open ? 'chevron-top' : 'chevron-down', size: "md", emphasis: "lower", "aria-label": this.open ? 'Hide dropdown' : 'Show dropdown', onClick: this.togglePopover, tabIndex: this.disabled ? -1 : 0 })), h("slot", { key: '66d2b27cfcf7ef97df493accaa333e0694234344', name: "after-input" })), h("div", { key: 'de6d7e18d676788cf0c7bfebd25f22b5cd2067ce', slot: "content", style: this.maxHeight ? { maxHeight: this.maxHeight } : {} }, ((_a = this.options) === null || _a === void 0 ? void 0 : _a.length) > 0 ? (h("ul", null, this.options.map(option => (h("nv-fielddropdownitem", { label: option.label, value: option.value, disabled: option.disabled, selected: option.value === this.value }))))) : (h("slot", { name: "content" })))), (this.description ||
-            this.el.querySelector('[slot="description"]')) && (h("div", { key: 'ea889c8ecdcfad160010374541b73f548322a0ad', class: "description" }, h("slot", { key: 'b69f67d3a03bf1839edd912ea369cfd87395ae51', name: "description" }, this.description))), (this.errorDescription ||
-            this.el.querySelector('[slot="error-description"]')) && (h("div", { key: '6ecd397cb41aab81173992c90e42f593f1227730', hidden: !this.error, class: "error-description" }, h("slot", { key: '3dff83b119d3cbbf2d00bc8641882326d08f939d', name: "error-description" }, this.errorDescription)))));
+        return (h(Host, { key: '428dd85337710d430ac04cf8cbc9021a93307bfe', role: "combobox", "aria-expanded": this.open.toString(), "aria-haspopup": "listbox", "aria-label": this.label }, (this.label || this.el.querySelector('[slot="label"]')) && (h("label", { key: 'a527c33d31152a90f8641e27fbaf91cf73eb06b6', htmlFor: this.inputId, onClick: this.syncToggleDropdown.bind(this) }, h("slot", { key: 'e4cf96c38db69080228666e4b924367a0c3a9d72', name: "label" }, this.label))), h("nv-popover", { key: '41723f7ec67e4e5680381e217eba45a1d73b47fc', triggerMode: "controlled", placement: "bottom-start", open: this.open }, h("div", { key: 'd4af00d5171b09923c36df9fd44853e1399e584f', class: "input-wrapper", slot: "trigger" }, h("slot", { key: 'bb6e53746c70fcc8172acd9a7ef8cbf72ae70698', name: "before-input" }), h("div", { key: 'ef3dc9ac5d0d895384653a17f8e61f616a7cbba9', class: "input-container" }, h("slot", { key: '7621b8cb7222330e73a426282877df2e0040714c', name: "leading-input" }), this.filterable || this.disabled || this.readonly ? (h("input", { "data-scope": "focusable", id: this.inputId, type: "search", ref: e => (this.inputElement = e), autofocus: this.autofocus, autocomplete: this.autocomplete, placeholder: this.placeholder, name: this.name, required: this.required, disabled: this.disabled, readOnly: this.readonly, onInput: this.handleFilterInput })) : (h("p", { "data-scope": "focusable", id: this.inputId, ref: el => (this.selectElement = el), class: "non-filterable-text", tabIndex: this.disabled ? -1 : 0 }, this.getSelectedLabel() || this.value || this.placeholder)), this.filterable && this.filterText && (h("nv-iconbutton", { key: '3de283e59d0c7811b39e30d98fdd7e400a1b3d49', name: "x", size: "md", emphasis: "lower", class: "clear-button", onClick: this.clearFilter.bind(this), "aria-label": "Clear input" })), this.error && (h("nv-icon", { key: '6f826edb19430ce535dc8742dfbd77b05d673f4d', name: "alert-circle", class: "validation", size: "md" })), h("nv-iconbutton", { key: '611f8df410c38faeb9fec9a43ac1f7013ce9b32b', "data-scope": "toggle-dropdown", ref: el => (this.toggleElement = el), name: this.open ? 'chevron-top' : 'chevron-down', size: "md", emphasis: "lower", "aria-label": this.open ? 'Hide dropdown' : 'Show dropdown', onClick: this.syncToggleDropdown.bind(this), tabIndex: this.disabled ? -1 : 0 })), h("slot", { key: '18d16b6c1d3c1ab910f8a45a339ae750e2277542', name: "after-input" })), h("div", { key: '53624675adac2c6c9345b64e634cbbad4f009a82', slot: "content", style: this.maxHeight ? { maxHeight: this.maxHeight } : {} }, ((_a = this.options) === null || _a === void 0 ? void 0 : _a.length) > 0 && (h("ul", { key: '3dfd5e914176bab898fd7872eb4ea0206d12b80a' }, this.options.map(option => (h("nv-fielddropdownitem", { label: option.label, value: option.value, disabled: option.disabled, selected: option.value === this.value }))))), h("slot", { key: 'e1c9151e125d0fe6f129b879b0adf1ae91b94bc4', name: "content" }))), (this.description ||
+            this.el.querySelector('[slot="description"]')) && (h("div", { key: '13247930760480ec767ce75c61385036126cd2f3', class: "description" }, h("slot", { key: '09c3f2fa0a1be5bcbe69b757a68a8327fef29ec1', name: "description" }, this.description))), (this.errorDescription ||
+            this.el.querySelector('[slot="error-description"]')) && (h("div", { key: '9b43e41b6b38242b21c750d2d442c78e0930b9bc', hidden: !this.error, class: "error-description" }, h("slot", { key: '44f7756522adbc54b8d85a211dace24a37073fc6', name: "error-description" }, this.errorDescription)))));
     }
     static get is() { return "nv-fielddropdown"; }
     static get formAssociated() { return true; }
@@ -664,9 +646,29 @@ export class NvFielddropdown {
                 "reflect": true,
                 "defaultValue": "''"
             },
-            "open": {
+            "emptyResult": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "The text to display when no items match the filter."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "empty-result",
+                "reflect": true,
+                "defaultValue": "'No results found'"
+            },
+            "filterable": {
                 "type": "boolean",
-                "mutable": true,
+                "mutable": false,
                 "complexType": {
                     "original": "boolean",
                     "resolved": "boolean",
@@ -676,35 +678,35 @@ export class NvFielddropdown {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "State of the dropdown popover."
+                    "text": "Enables or disables the filtering feature for the dropdown items."
                 },
                 "getter": false,
                 "setter": false,
-                "attribute": "open",
+                "attribute": "filterable",
                 "reflect": true,
                 "defaultValue": "false"
             },
-            "emptyResult": {
-                "type": "string",
+            "openOnSelect": {
+                "type": "boolean",
                 "mutable": false,
                 "complexType": {
-                    "original": "string",
-                    "resolved": "string",
+                    "original": "boolean",
+                    "resolved": "boolean",
                     "references": {}
                 },
                 "required": false,
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "The text to display when no items match the filter."
+                    "text": "When an item is selected by the user, the dropdown will continue to stay\nopen."
                 },
                 "getter": false,
                 "setter": false,
-                "attribute": "empty-result",
+                "attribute": "open-on-select",
                 "reflect": true,
-                "defaultValue": "'No results found'"
+                "defaultValue": "false"
             },
-            "filterable": {
+            "controlledFilter": {
                 "type": "boolean",
                 "mutable": false,
                 "complexType": {
@@ -716,11 +718,11 @@ export class NvFielddropdown {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Enables or disables the filtering feature for the dropdown items."
+                    "text": "Determines if the component\u2019s filtering behavior is managed externally.\nWhen set to true and filterable is enabled, the component won\u2019t\nautomatically filter items. Instead, you must implement your own filtering\nlogic (e.g., server-side search or custom matching) using the\nfilterTextChanged event."
                 },
                 "getter": false,
                 "setter": false,
-                "attribute": "filterable",
+                "attribute": "controlled-filter",
                 "reflect": true,
                 "defaultValue": "false"
             },
@@ -728,8 +730,8 @@ export class NvFielddropdown {
                 "type": "unknown",
                 "mutable": false,
                 "complexType": {
-                    "original": "{\n    /** Label to display for the option */\n    label: string;\n    /** Value associated with the option */\n    value: string;\n    /** Whether this option is disabled */\n    disabled?: boolean;\n    /** Whether this option is pre-selected */\n    selected?: boolean;\n  }[]",
-                    "resolved": "{ label: string; value: string; disabled?: boolean; selected?: boolean; }[]",
+                    "original": "{\n    /** Label to display for the option */\n    label: string;\n    /** Value associated with the option */\n    value: string;\n    /** Whether this option is disabled */\n    disabled?: boolean;\n  }[]",
+                    "resolved": "{ label: string; value: string; disabled?: boolean; }[]",
                     "references": {}
                 },
                 "required": false,
@@ -759,7 +761,7 @@ export class NvFielddropdown {
                             "name": "default",
                             "text": "300"
                         }],
-                    "text": "Delay in milliseconds before the search is triggered when typing in the filter input."
+                    "text": "Delay in milliseconds before the search is triggered when typing in the\nfilter input."
                 },
                 "getter": false,
                 "setter": false,
@@ -812,7 +814,8 @@ export class NvFielddropdown {
     static get states() {
         return {
             "filterText": {},
-            "selectedValues": {}
+            "selectedValues": {},
+            "open": {}
         };
     }
     static get events() {
@@ -834,6 +837,41 @@ export class NvFielddropdown {
                     "resolved": "string",
                     "references": {}
                 }
+            }, {
+                "method": "filterTextChanged",
+                "name": "filterTextChanged",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Event emitted when the filter input value changes."
+                },
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                }
+            }, {
+                "method": "openChanged",
+                "name": "openChanged",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Event emitted when the dropdown opened or closed."
+                },
+                "complexType": {
+                    "original": "HTMLNvPopoverElementEventMap['openChanged']",
+                    "resolved": "boolean",
+                    "references": {
+                        "HTMLNvPopoverElementEventMap": {
+                            "location": "global",
+                            "id": "global::HTMLNvPopoverElementEventMap"
+                        }
+                    }
+                }
             }, {
                 "method": "dropdownItemSelected",
                 "name": "dropdownItemSelected",
@@ -846,7 +884,7 @@ export class NvFielddropdown {
                 },
                 "complexType": {
                     "original": "HTMLNvFielddropdownitemElementEventMap['dropdownItemSelected']",
-                    "resolved": "{ label?: string; value: string; }",
+                    "resolved": "{ label?: string; value: string; detached?: boolean; }",
                     "references": {
                         "HTMLNvFielddropdownitemElementEventMap": {
                             "location": "global",
@@ -858,9 +896,9 @@ export class NvFielddropdown {
     }
     static get methods() {
         return {
-            "getFilterText": {
+            "clearFilter": {
                 "complexType": {
-                    "signature": "() => Promise<string>",
+                    "signature": "() => Promise<void>",
                     "parameters": [],
                     "references": {
                         "Promise": {
@@ -868,13 +906,34 @@ export class NvFielddropdown {
                             "id": "global::Promise"
                         }
                     },
-                    "return": "Promise<string>"
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Clears the filter text",
+                    "tags": []
+                }
+            },
+            "toggleDropdown": {
+                "complexType": {
+                    "signature": "(open?: boolean) => Promise<void>",
+                    "parameters": [{
+                            "name": "open",
+                            "type": "boolean",
+                            "docs": "- The open state to set, if null, toggles the state"
+                        }],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Retrieves the current filter text entered by the user.",
+                    "text": "Toggles the dropdown popover open state",
                     "tags": [{
-                            "name": "returns",
-                            "text": "The filter text."
+                            "name": "param",
+                            "text": "open - The open state to set, if null, toggles the state"
                         }]
                 }
             }
@@ -883,41 +942,47 @@ export class NvFielddropdown {
     static get elementRef() { return "el"; }
     static get watchers() {
         return [{
-                "propName": "options",
-                "methodName": "handleOptionsChange"
+                "propName": "open",
+                "methodName": "handleOpenChange"
             }, {
                 "propName": "value",
-                "methodName": "watchValueHandler"
+                "methodName": "handleValueChange"
             }, {
-                "propName": "open",
-                "methodName": "handleOpenChange"
+                "propName": "options",
+                "methodName": "handleOptionsChange"
             }];
     }
     static get listeners() {
         return [{
-                "name": "openChanged",
-                "method": "handleOpenChanged",
-                "target": undefined,
-                "capture": false,
-                "passive": false
-            }, {
                 "name": "dropdownItemSelected",
                 "method": "handleDropdownItemSelected",
                 "target": undefined,
                 "capture": false,
                 "passive": false
             }, {
-                "name": "blur",
-                "method": "handleBlur",
+                "name": "focus",
+                "method": "handleFocus",
                 "target": undefined,
                 "capture": true,
-                "passive": false
+                "passive": true
+            }, {
+                "name": "focusout",
+                "method": "handleFocusOut",
+                "target": undefined,
+                "capture": true,
+                "passive": true
             }, {
                 "name": "keydown",
                 "method": "handleKeyDown",
                 "target": undefined,
                 "capture": false,
                 "passive": false
+            }, {
+                "name": "click",
+                "method": "handleDocumentClick",
+                "target": "document",
+                "capture": false,
+                "passive": false
             }];
     }
 }