@nova-design-system/nova-webcomponents 3.15.0 → 3.16.0

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

@@ -12,6 +12,8 @@ import { v4 as uuidv4 } from "uuid";
 export class NvFieldmultiselect {
     constructor() {
         this.isBulkOperation = false;
+        // Add the flag to the class
+        this.preventBlurClose = false;
         /**
          * Sets the ID for the input element and the for attribute of the associated
          * label. If no ID is provided, a random one will be automatically generated
@@ -117,11 +119,6 @@ export class NvFieldmultiselect {
          * Controls the visibility of the select all section.
          */
         this.isSelectAllSectionVisible = true;
-        // Add the flag to the class
-        this.preventBlurClose = false;
-        this.handleMouseDownPreventBlur = () => {
-            this.preventBlurClose = true;
-        };
         /**
          * Handle badge close for options mode.
          */
@@ -165,17 +162,16 @@ export class NvFieldmultiselect {
             if (this.isHandlingEscape) {
                 return;
             }
-            // Reset filter if needed, but preserve the filter text
-            if (this.filterable) {
-                this.resetFilter();
-            }
+            // Filter reset is handled in handleOpenChanged; no need to repeat
         };
         /**
          * Clear the filter text
          */
         this.clearFilterText = () => {
-            this.filterText = '';
-            this.filterTextChanged.emit('');
+            if (this.filterText !== '') {
+                this.filterText = '';
+                this.filterTextChanged.emit('');
+            }
             this.resetFilter();
             this.hasFilterResults = true;
         };
@@ -189,11 +185,9 @@ export class NvFieldmultiselect {
                     return; // Don't close the popover
                 }
                 if (!this.el.contains(document.activeElement)) {
-                    // Close the popover without affecting the divider
-                    this.open = false;
-                    // Clear filter text when focus is lost
+                    this.open = false; // Close the popover on blur
                     if (this.filterable) {
-                        this.clearFilterText();
+                        this.clearFilterText(); // Clear filter text on blur
                     }
                 }
             }, 150);
@@ -306,17 +300,14 @@ export class NvFieldmultiselect {
          */
         this.handleInputBlurSlots = () => {
             setTimeout(() => {
-                // Honor preventBlurClose to avoid closing when interacting inside the popover
                 if (this.preventBlurClose) {
                     this.preventBlurClose = false;
                     return; // Don't close the popover
                 }
                 if (!this.el.contains(document.activeElement)) {
-                    // Close the popover without affecting the divider
-                    this.open = false;
-                    // Clear filter text when focus is lost
+                    this.open = false; // Close the popover on blur
                     if (this.filterable) {
-                        this.clearFilterText();
+                        this.clearFilterText(); // Clear filter text on blur
                     }
                 }
             }, 150);
@@ -443,6 +434,9 @@ export class NvFieldmultiselect {
             const shouldSelectAll = currentState === 'unchecked' || currentState === 'indeterminate';
             this.toggleSelectAllSlots(shouldSelectAll);
         };
+        this.handleMouseDownPreventBlur = () => {
+            this.preventBlurClose = true;
+        };
         //#endregion METHODS
         /****************************************************************************/
         //#region RENDER
@@ -451,7 +445,8 @@ export class NvFieldmultiselect {
          * @returns {any} The JSX for options mode
          */
         this.renderOptionsMode = () => {
-            return (h(Host, { "aria-label": this.label }, (this.label || this.el.querySelector('[slot="label"]')) && (h("label", { htmlFor: this.inputId }, h("slot", { name: "label" }, this.label))), h("nv-popover", { ref: el => (this.popoverElement = el), triggerMode: "controlled", placement: "bottom-start", open: this.open }, h("div", { class: "input-wrapper-multiselect", slot: "trigger" }, h("slot", { name: "before-input" }), h("div", { class: "input-container-multiselect" }, h("slot", { name: "leading-input" }), this.value.length > 0 && (h("nv-badge", { slot: "leading-input", "prevent-auto-close": true, color: "10", dismissible: this.value.length > 0, label: `${this.value.length} ${this.badgeLabel}`, "aria-label": `Clear all ${this.value.length} ${this.badgeLabel} items`, onCloseClicked: this.handleBadgeCloseOptions })), this.filterable || this.disabled || this.readonly ? (h("input", { type: "text", id: this.inputId, ref: e => (this.inputElement = e), autofocus: this.autofocus, autocomplete: this.autocomplete, placeholder: this.placeholder, name: this.name, value: this.filterText, required: this.required, disabled: this.disabled, readOnly: this.readonly, onInput: this.handleInputOptions, onFocus: this.handleInputFocusOptions, onBlur: this.handleInputBlurOptions, onKeyDown: this.handleKeyDown, "data-scope": "focusable", "aria-label": this.label, "aria-controls": `${this.inputId}-listbox` })) : (h(Fragment, null, h("input", { id: this.inputId, type: "text", style: {
+            var _a, _b, _c, _d;
+            return (h(Host, { "aria-label": this.label }, (this.label || this.el.querySelector('[slot="label"]')) && (h("label", { htmlFor: this.inputId }, h("slot", { name: "label" }, this.label))), h("nv-popover", { ref: el => (this.popoverElement = el), triggerMode: "controlled", placement: "bottom-start", open: this.open }, h("div", { class: "input-wrapper-multiselect", slot: "trigger" }, h("slot", { name: "before-input" }), h("div", { class: "input-container-multiselect" }, h("slot", { name: "leading-input" }), (((_a = this.value) === null || _a === void 0 ? void 0 : _a.length) || 0) > 0 && (h("nv-badge", { slot: "leading-input", "prevent-auto-close": true, color: "10", dismissible: (((_b = this.value) === null || _b === void 0 ? void 0 : _b.length) || 0) > 0, label: `${((_c = this.value) === null || _c === void 0 ? void 0 : _c.length) || 0} ${this.badgeLabel}`, "aria-label": `Clear all ${((_d = this.value) === null || _d === void 0 ? void 0 : _d.length) || 0} ${this.badgeLabel} items`, onCloseClicked: this.handleBadgeCloseOptions })), this.filterable || this.disabled || this.readonly ? (h("input", { type: "text", id: this.inputId, ref: e => (this.inputElement = e), autofocus: this.autofocus, autocomplete: this.autocomplete, placeholder: this.placeholder, name: this.name, value: this.filterText, required: this.required, disabled: this.disabled, readOnly: this.readonly, onInput: this.handleInputOptions, onFocus: this.handleInputFocusOptions, onBlur: this.handleInputBlurOptions, onKeyDown: this.handleKeyDown, "data-scope": "focusable", "aria-label": this.label, "aria-controls": `${this.inputId}-listbox` })) : (h(Fragment, null, h("input", { id: this.inputId, type: "text", style: {
                     position: 'absolute',
                     opacity: '0',
                     width: '0',
@@ -460,14 +455,15 @@ export class NvFieldmultiselect {
                 }, tabIndex: -1, "aria-hidden": "true", autoComplete: this.autocomplete, name: this.name, onFocus: this.handleInputFocusOptions }), h("p", { id: this.inputId, class: "non-filterable-text", onClick: this.handleInputContainerClickOptions, tabIndex: 0, onKeyDown: this.handleKeyDown, onFocus: this.handleInputFocusOptions, "aria-label": this.label, "aria-controls": `${this.inputId}-listbox`, "data-scope": "focusable", role: "button" }, h("span", null, this.placeholder)))), this.error && (h("nv-icon", { name: "alert-circle", class: "validation", size: "md" })), this.filterable && this.filterText.length > 0 && (h("nv-iconbutton", { "data-scope": "clear-filter", name: "x", size: "md", emphasis: "lower", "aria-label": "Clear filter text", tabindex: "-1", title: "Clear filter text", onMouseDown: this.handleMouseDownPreventBlur, onClick: this.clearFilterText })), h("nv-iconbutton", { "data-scope": "toggle-dropdown", name: this.open ? 'chevron-top' : 'chevron-down', size: "md", emphasis: "lower", "aria-label": this.open ? 'Hide dropdown' : 'Show dropdown', title: this.open ? 'Hide dropdown' : 'Show dropdown', onMouseDown: this.handleMouseDownPreventBlur, onClick: this.togglePopoverOptions })), h("slot", { name: "after-input" })), h("div", { id: `${this.inputId}-listbox`, slot: "content", style: this.maxHeight ? { maxHeight: this.maxHeight } : {}, onMouseDown: this.handleMouseDownPreventBlur }, this.shouldShowToggleAllOptionsButton() && (h("div", { class: "select-all-container" }, h("div", { class: "select-all-header" }, this.isSelectAllSectionVisible && (h("nv-fieldcheckbox", { checked: this.getSelectAllCheckboxStateOptions() === 'checked', indeterminate: this.getSelectAllCheckboxStateOptions() ===
                     'indeterminate', label: this.getSelectAllCheckboxStateOptions() === 'unchecked'
                     ? this.selectAllLabel
-                    : this.deselectAllLabel, onMouseDown: this.handleMouseDownPreventBlur, onClick: this.handleSelectAllCheckboxOptionsClick }))))), h("ul", { role: "listbox", "aria-multiselectable": "true" }, this.options.map(option => (h("nv-fielddropdownitemcheck", { role: "option", label: option.label, description: option.description, value: option.value, checked: this.value.includes(option.value), disabled: option.disabled })))))), this.renderDescriptions()));
+                    : this.deselectAllLabel, onMouseDown: this.handleMouseDownPreventBlur, onClick: this.handleSelectAllCheckboxOptionsClick }))))), h("ul", { role: "listbox", "aria-multiselectable": "true" }, this.options.map(option => (h("nv-fielddropdownitemcheck", { role: "option", label: option.label, description: option.description, value: option.value, checked: (this.value || []).includes(option.value), disabled: option.disabled })))))), this.renderDescriptions()));
         };
         /**
          * Renders the component in slots mode
          * @returns {any} The JSX for slots mode
          */
         this.renderSlotsMode = () => {
-            return (h(Host, { "aria-label": this.label }, (this.label || this.el.querySelector('[slot="label"]')) && (h("label", { htmlFor: this.inputId }, h("slot", { name: "label" }, this.label))), h("nv-popover", { ref: el => (this.popoverElement = el), triggerMode: "controlled", placement: "bottom-start", open: this.open }, h("div", { class: "input-wrapper-multiselect", slot: "trigger" }, h("slot", { name: "before-input" }), h("div", { class: "input-container-multiselect", onClick: this.handleInputContainerClickSlots }, h("slot", { name: "leading-input" }), this.value.length > 0 && (h("nv-badge", { slot: "leading-input", "prevent-auto-close": true, color: "10", dismissible: this.value.length > 0, label: `${this.value.length} ${this.badgeLabel}`, "aria-label": `Clear all ${this.value.length} ${this.badgeLabel} items`, onCloseClicked: this.handleBadgeCloseSlots })), this.filterable || this.disabled || this.readonly ? (h("input", { id: this.inputId, ref: e => (this.inputElement = e), autocomplete: this.autocomplete, placeholder: this.placeholder, name: this.name, value: this.filterText, required: this.required, disabled: this.disabled, readOnly: this.readonly, onInput: this.handleInputSlots, onFocus: this.handleInputFocusSlots, onBlur: this.handleInputBlurSlots, onKeyDown: this.handleKeyDown, "data-scope": "focusable", "aria-label": this.label, "aria-controls": `${this.inputId}-listbox` })) : (h(Fragment, null, h("input", { id: this.inputId, type: "text", style: {
+            var _a, _b, _c, _d;
+            return (h(Host, { "aria-label": this.label }, (this.label || this.el.querySelector('[slot="label"]')) && (h("label", { htmlFor: this.inputId }, h("slot", { name: "label" }, this.label))), h("nv-popover", { ref: el => (this.popoverElement = el), triggerMode: "controlled", placement: "bottom-start", open: this.open }, h("div", { class: "input-wrapper-multiselect", slot: "trigger" }, h("slot", { name: "before-input" }), h("div", { class: "input-container-multiselect", onClick: this.handleInputContainerClickSlots }, h("slot", { name: "leading-input" }), (((_a = this.value) === null || _a === void 0 ? void 0 : _a.length) || 0) > 0 && (h("nv-badge", { slot: "leading-input", "prevent-auto-close": true, color: "10", dismissible: (((_b = this.value) === null || _b === void 0 ? void 0 : _b.length) || 0) > 0, label: `${((_c = this.value) === null || _c === void 0 ? void 0 : _c.length) || 0} ${this.badgeLabel}`, "aria-label": `Clear all ${((_d = this.value) === null || _d === void 0 ? void 0 : _d.length) || 0} ${this.badgeLabel} items`, onCloseClicked: this.handleBadgeCloseSlots })), this.filterable || this.disabled || this.readonly ? (h("input", { id: this.inputId, ref: e => (this.inputElement = e), autocomplete: this.autocomplete, placeholder: this.placeholder, name: this.name, value: this.filterText, required: this.required, disabled: this.disabled, readOnly: this.readonly, onInput: this.handleInputSlots, onFocus: this.handleInputFocusSlots, onBlur: this.handleInputBlurSlots, onKeyDown: this.handleKeyDown, "data-scope": "focusable", "aria-label": this.label, "aria-controls": `${this.inputId}-listbox` })) : (h(Fragment, null, h("input", { id: this.inputId, type: "text", style: {
                     position: 'absolute',
                     opacity: '0',
                     width: '0',
@@ -487,7 +483,7 @@ export class NvFieldmultiselect {
             return;
         // If the parent has set a value prop, use it. Otherwise, derive from checked options.
         // (Assume: if value is undefined, it's not set by parent; if it's an array, it's set.)
-        if (this.value === undefined || this.value.length === 0) {
+        if (!this.value || this.value.length === 0) {
             this.value = newValue
                 .filter(option => option.checked)
                 .map(option => option.value);
@@ -495,7 +491,7 @@ export class NvFieldmultiselect {
         else {
             // If value is set, ensure checked states in options match value
             newValue.forEach(option => {
-                option.checked = this.value.includes(option.value);
+                option.checked = (this.value || []).includes(option.value);
             });
         }
         this.reorderOptionsContent();
@@ -512,10 +508,24 @@ export class NvFieldmultiselect {
         // Also, update options checked state if options exist
         if (this.options) {
             this.options.forEach(option => {
-                option.checked = this.value.includes(option.value);
+                option.checked = (this.value || []).includes(option.value);
             });
         }
     }
+    handleOpenChange(newOpen) {
+        // React to external changes, e.g., reorder or filter
+        if (newOpen) {
+            if (this.options) {
+                this.reorderOptionsContent();
+            }
+            else {
+                this.reorderSlotContent();
+            }
+            if (this.filterText) {
+                this.filterItems();
+            }
+        }
+    }
     //#endregion WATCHERS
     /****************************************************************************/
     //#region LISTENERS
@@ -526,23 +536,33 @@ export class NvFieldmultiselect {
     handleOpenChanged(event) {
         // Stop propagation to prevent the event from affecting parent components like dialogs
         event.stopPropagation();
-        // Update `open` based on the popover state
-        this.open = event.detail;
-        if (this.open) {
-            // Filter items only if there is filter text
-            if (this.filterText) {
-                this.filterItems();
+        // Only update if the event comes from our popover
+        if (event.target === this.popoverElement) {
+            // Only update if open state differs to avoid redundant actions
+            if (this.open !== event.detail) {
+                this.open = event.detail;
+                if (this.open) {
+                    // Filter items only if there is filter text
+                    if (this.filterText) {
+                        this.filterItems();
+                    }
+                }
+                else {
+                    // Clear filter text on close if filterable
+                    if (this.filterable) {
+                        this.clearFilterText();
+                    }
+                    this.handlePopoverClose();
+                }
+                // Reorder content as needed
+                if (this.options) {
+                    this.reorderOptionsContent();
+                }
+                else {
+                    this.reorderSlotContent();
+                }
             }
         }
-        else {
-            this.handlePopoverClose();
-        }
-        if (this.options) {
-            this.reorderOptionsContent();
-        }
-        else {
-            this.reorderSlotContent();
-        }
     }
     /**
      * Listen for the `itemChecked` event emitted by child items.
@@ -555,7 +575,7 @@ export class NvFieldmultiselect {
         }
         const { value, checked } = event.detail;
         if (value !== undefined && value !== null) {
-            const newValue = [...this.value];
+            const newValue = [...(this.value || [])];
             const valueIndex = newValue.indexOf(value);
             let hasChanged = false;
             if (checked && valueIndex === -1) {
@@ -592,6 +612,86 @@ export class NvFieldmultiselect {
             });
         }
     }
+    /**
+     * Handle keyboard events & arrow key navigation.
+     * If the multiselect is not open, opens it and focuses on the first item if the list is not filterable.
+     * If the multiselect is open, handles arrow key navigation and closes it if the focus is outside the component.
+     * @param {KeyboardEvent} event - The keyboard event.
+     */
+    async handleKeyDown(event) {
+        if (!this.open) {
+            if (event.key === 'ArrowDown') {
+                this.open = true;
+                // Focus on the first item if the list is not filterable
+                if (!this.filterable) {
+                    requestAnimationFrame(() => {
+                        this.focusFirstItem();
+                    });
+                }
+                event.preventDefault();
+                return;
+            }
+            return;
+        }
+        const items = Array.from(this.el.querySelectorAll('nv-fielddropdownitemcheck:not([style*="display: none"])'));
+        if (items.length === 0) {
+            console.warn('No visible items found to navigate');
+            return;
+        }
+        let currentIndex = items.findIndex(item => item.classList.contains('highlighted'));
+        if (event.key === 'ArrowDown') {
+            event.preventDefault();
+            currentIndex =
+                currentIndex === -1 ? 0 : (currentIndex + 1) % items.length;
+            this.updateHighlightedItem(items, currentIndex);
+        }
+        else if (event.key === 'ArrowUp') {
+            event.preventDefault();
+            currentIndex =
+                currentIndex === -1
+                    ? items.length - 1
+                    : (currentIndex - 1 + items.length) % items.length;
+            this.updateHighlightedItem(items, currentIndex);
+        }
+        else if (event.key === 'Enter' && currentIndex >= 0) {
+            event.preventDefault();
+            const selectedItem = items[currentIndex];
+            // Toggle the checked state
+            const isCurrentlyChecked = selectedItem.hasAttribute('checked');
+            selectedItem.checked = !isCurrentlyChecked;
+            // Trigger a click event to ensure proper event handling
+            selectedItem.dispatchEvent(new MouseEvent('click', {
+                view: window,
+                bubbles: true,
+                cancelable: true,
+            }));
+        }
+        else if (event.key === 'Escape') {
+            event.preventDefault();
+            event.stopPropagation(); // Prevent the event from propagating to the popover
+            // Do the reorder and wait a bit before closing
+            const handleEscape = async () => {
+                this.isHandlingEscape = true; // Disable the hide listener
+                if (this.options) {
+                    this.reorderOptionsContent();
+                }
+                else {
+                    this.reorderSlotContent();
+                }
+                // Wait for the reorder to be applied
+                await new Promise(resolve => setTimeout(resolve, 100));
+                // Reactivate the hide listener after a short delay
+                setTimeout(() => {
+                    this.isHandlingEscape = false;
+                    this.open = false;
+                }, 150);
+                if (this.inputElement) {
+                    this.inputElement.blur();
+                }
+            };
+            await handleEscape();
+        }
+    }
     //#endregion LISTENERS
     /****************************************************************************/
     //#region LIFECYCLE
@@ -688,8 +788,8 @@ export class NvFieldmultiselect {
             if (emptyMessage)
                 emptyMessage.remove();
             // Reorder with divider if needed
-            const selectedItems = items.filter(item => this.value.includes(item.getAttribute('value') || ''));
-            const unselectedItems = items.filter(item => !this.value.includes(item.getAttribute('value') || ''));
+            const selectedItems = items.filter(item => (this.value || []).includes(item.getAttribute('value') || ''));
+            const unselectedItems = items.filter(item => !(this.value || []).includes(item.getAttribute('value') || ''));
             if (selectedItems.length > 0) {
                 this.manageDivider(ul, selectedItems, unselectedItems);
             }
@@ -774,8 +874,8 @@ export class NvFieldmultiselect {
             return;
         }
         // Separate checked vs unchecked
-        const selectedItems = items.filter(item => this.value.includes(item.getAttribute('value') || ''));
-        const unselectedItems = items.filter(item => !this.value.includes(item.getAttribute('value') || ''));
+        const selectedItems = items.filter(item => (this.value || []).includes(item.getAttribute('value') || ''));
+        const unselectedItems = items.filter(item => !(this.value || []).includes(item.getAttribute('value') || ''));
         // Reinsert CHECKED items FIRST
         // appendChild() moves the element without recreating it
         // this is not trigger a re-rendering of the component in the platforms
@@ -801,8 +901,8 @@ export class NvFieldmultiselect {
         if (!ul)
             return;
         const items = Array.from(ul.querySelectorAll('nv-fielddropdownitemcheck')).filter(item => item.style.display !== 'none');
-        const selectedItems = items.filter(item => this.value.includes(item.getAttribute('value') || ''));
-        const unselectedItems = items.filter(item => !this.value.includes(item.getAttribute('value') || ''));
+        const selectedItems = items.filter(item => (this.value || []).includes(item.getAttribute('value') || ''));
+        const unselectedItems = items.filter(item => !(this.value || []).includes(item.getAttribute('value') || ''));
         // Reorder the elements
         selectedItems.forEach(item => ul.appendChild(item));
         unselectedItems.forEach(item => ul.appendChild(item));
@@ -838,8 +938,8 @@ export class NvFieldmultiselect {
             }
             // Reorder with divider
             const items = Array.from(ul.querySelectorAll('nv-fielddropdownitemcheck'));
-            const selectedItems = items.filter(item => this.value.includes(item.getAttribute('value') || ''));
-            const unselectedItems = items.filter(item => !this.value.includes(item.getAttribute('value') || ''));
+            const selectedItems = items.filter(item => (this.value || []).includes(item.getAttribute('value') || ''));
+            const unselectedItems = items.filter(item => !(this.value || []).includes(item.getAttribute('value') || ''));
             this.manageDivider(ul, selectedItems, unselectedItems);
             return;
         }
@@ -860,8 +960,8 @@ export class NvFieldmultiselect {
             });
             // Manage the divider with the visible items
             const visibleItems = items.filter(item => item.style.display !== 'none');
-            const visibleSelected = visibleItems.filter(item => this.value.includes(item.getAttribute('value') || ''));
-            const visibleUnselected = visibleItems.filter(item => !this.value.includes(item.getAttribute('value') || ''));
+            const visibleSelected = visibleItems.filter(item => (this.value || []).includes(item.getAttribute('value') || ''));
+            const visibleUnselected = visibleItems.filter(item => !(this.value || []).includes(item.getAttribute('value') || ''));
             this.manageDivider(ul, visibleSelected, visibleUnselected);
         }
         else {
@@ -901,31 +1001,39 @@ export class NvFieldmultiselect {
         const items = Array.from(ul.querySelectorAll('nv-fielddropdownitemcheck'));
         // Reset items if the filter text is empty
         if (!this.filterText.trim()) {
-            // Remove the empty message if it exists
             this.removeEmptyMessageOption(ul);
-            items.forEach(item => (item.style.display = ''));
-            this.reorderOptionsContent(); // Reorder after reset
-            this.hasFilterResults = true; // Reset filter means we have results
+            items.forEach(item => {
+                item.style.display = '';
+                item.removeAttribute('aria-hidden'); // Ensure accessibility
+            });
+            this.reorderOptionsContent();
+            this.hasFilterResults = true;
             return;
         }
         // Filter the items
         items.forEach(item => {
-            const label = item.getAttribute('label') || '';
-            const value = item.getAttribute('value') || '';
-            const matchesFilter = this.normalizeText(label).includes(normalizedFilter) ||
-                this.normalizeText(value).includes(normalizedFilter);
-            item.style.display = matchesFilter ? '' : 'none';
-            if (matchesFilter)
-                hasVisibleItems = true;
+            const option = this.options.find(opt => opt.value === item.getAttribute('value'));
+            if (option && !option.isDivider) {
+                const matchesFilter = this.normalizeText(option.label).includes(normalizedFilter) ||
+                    this.normalizeText(option.value).includes(normalizedFilter);
+                item.style.display = matchesFilter ? '' : 'none';
+                item.setAttribute('aria-hidden', matchesFilter ? 'false' : 'true'); // Update accessibility
+                if (matchesFilter)
+                    hasVisibleItems = true;
+            }
+            else {
+                item.style.display = 'none'; // Hide dividers during filtering
+                item.setAttribute('aria-hidden', 'true');
+            }
         });
         // Update the filter results state
         this.hasFilterResults = hasVisibleItems;
         // Manage the divider with the visible items
         const visibleItems = items.filter(item => item.style.display !== 'none');
-        const visibleSelected = visibleItems.filter(item => this.value.includes(item.getAttribute('value') || ''));
-        const visibleUnselected = visibleItems.filter(item => !this.value.includes(item.getAttribute('value') || ''));
+        const visibleSelected = visibleItems.filter(item => (this.value || []).includes(item.getAttribute('value') || ''));
+        const visibleUnselected = visibleItems.filter(item => !(this.value || []).includes(item.getAttribute('value') || ''));
         this.manageDivider(ul, visibleSelected, visibleUnselected);
-        // Add or remove the empty message based on the case
+        // Add or remove the empty message
         if (!hasVisibleItems) {
             this.addEmptyMessageOption(ul);
         }
@@ -974,8 +1082,8 @@ export class NvFieldmultiselect {
         this.hasFilterResults = hasVisibleItems;
         // Get visible items after filtering
         const visibleItems = items.filter(item => item.style.display !== 'none');
-        const visibleSelectedItems = visibleItems.filter(item => this.value.includes(item.getAttribute('value') || ''));
-        this.manageDivider(ul, visibleSelectedItems, visibleItems.filter(item => !this.value.includes(item.getAttribute('value') || '')));
+        const visibleSelectedItems = visibleItems.filter(item => (this.value || []).includes(item.getAttribute('value') || ''));
+        this.manageDivider(ul, visibleSelectedItems, visibleItems.filter(item => !(this.value || []).includes(item.getAttribute('value') || '')));
         // Add empty message if no items match the filter
         if (!hasVisibleItems) {
             const emptyMessage = document.createElement('li');
@@ -1016,86 +1124,6 @@ export class NvFieldmultiselect {
         }
         this.open = false;
     }
-    /**
-     * Handle keyboard events & arrow key navigation.
-     * If the multiselect is not open, opens it and focuses on the first item if the list is not filterable.
-     * If the multiselect is open, handles arrow key navigation and closes it if the focus is outside the component.
-     * @param {KeyboardEvent} event - The keyboard event.
-     */
-    async handleKeyDown(event) {
-        if (!this.open) {
-            if (event.key === 'ArrowDown') {
-                this.open = true;
-                // Focus on the first item if the list is not filterable
-                if (!this.filterable) {
-                    requestAnimationFrame(() => {
-                        this.focusFirstItem();
-                    });
-                }
-                event.preventDefault();
-                return;
-            }
-            return;
-        }
-        const items = Array.from(this.el.querySelectorAll('nv-fielddropdownitemcheck:not([style*="display: none"])'));
-        if (items.length === 0) {
-            console.warn('No visible items found to navigate');
-            return;
-        }
-        let currentIndex = items.findIndex(item => item.classList.contains('highlighted'));
-        if (event.key === 'ArrowDown') {
-            event.preventDefault();
-            currentIndex =
-                currentIndex === -1 ? 0 : (currentIndex + 1) % items.length;
-            this.updateHighlightedItem(items, currentIndex);
-        }
-        else if (event.key === 'ArrowUp') {
-            event.preventDefault();
-            currentIndex =
-                currentIndex === -1
-                    ? items.length - 1
-                    : (currentIndex - 1 + items.length) % items.length;
-            this.updateHighlightedItem(items, currentIndex);
-        }
-        else if (event.key === 'Enter' && currentIndex >= 0) {
-            event.preventDefault();
-            const selectedItem = items[currentIndex];
-            // Toggle the checked state
-            const isCurrentlyChecked = selectedItem.hasAttribute('checked');
-            selectedItem.checked = !isCurrentlyChecked;
-            // Trigger a click event to ensure proper event handling
-            selectedItem.dispatchEvent(new MouseEvent('click', {
-                view: window,
-                bubbles: true,
-                cancelable: true,
-            }));
-        }
-        else if (event.key === 'Escape') {
-            event.preventDefault();
-            event.stopPropagation(); // Prevent the event from propagating to the popover
-            // Do the reorder and wait a bit before closing
-            const handleEscape = async () => {
-                this.isHandlingEscape = true; // Disable the hide listener
-                if (this.options) {
-                    this.reorderOptionsContent();
-                }
-                else {
-                    this.reorderSlotContent();
-                }
-                // Wait for the reorder to be applied
-                await new Promise(resolve => setTimeout(resolve, 100));
-                // Reactivate the hide listener after a short delay
-                setTimeout(() => {
-                    this.isHandlingEscape = false;
-                    this.open = false;
-                }, 150);
-                if (this.inputElement) {
-                    this.inputElement.blur();
-                }
-            };
-            await handleEscape();
-        }
-    }
     /**
      * Updates the highlighted item in the dropdown list.
      *
@@ -1185,7 +1213,7 @@ export class NvFieldmultiselect {
         items.forEach(item => {
             // Get the effective value: use explicit value if present, otherwise use label
             const itemValue = item.getAttribute('value') || item.getAttribute('label') || '';
-            const shouldBeChecked = this.value.includes(itemValue);
+            const shouldBeChecked = (this.value || []).includes(itemValue);
             // Only update if the checked state differs to avoid triggering unnecessary events
             if (item.checked !== shouldBeChecked) {
                 // Set attribute and property, but avoid triggering itemChecked during bulk
@@ -1225,8 +1253,10 @@ export class NvFieldmultiselect {
     getVisibleEnabledOptionItems() {
         const allItems = Array.from(this.el.querySelectorAll('nv-fielddropdownitemcheck'));
         const visibleItems = allItems.filter(item => {
-            const isHidden = item.style.display === 'none';
-            const isDisabled = item.hasAttribute('disabled');
+            const isHidden = item.style.display === 'none' ||
+                item.getAttribute('aria-hidden') === 'true';
+            const isDisabled = item.hasAttribute('disabled') ||
+                item.getAttribute('disabled') === 'true';
             return !isHidden && !isDisabled;
         });
         return visibleItems
@@ -1253,7 +1283,7 @@ export class NvFieldmultiselect {
         const visibleOptionValues = this.getVisibleEnabledOptionItems();
         if (visibleOptionValues.length === 0)
             return 'unchecked';
-        const selectedVisibleOptions = visibleOptionValues.filter(value => this.value.includes(value));
+        const selectedVisibleOptions = visibleOptionValues.filter(value => (this.value || []).includes(value));
         if (selectedVisibleOptions.length === 0)
             return 'unchecked';
         if (selectedVisibleOptions.length === visibleOptionValues.length)
@@ -1273,7 +1303,7 @@ export class NvFieldmultiselect {
             return 'unchecked';
         const selectedItems = items.filter(item => {
             const itemValue = item.getAttribute('value') || item.getAttribute('label') || '';
-            return itemValue !== '' && this.value.includes(itemValue);
+            return itemValue !== '' && (this.value || []).includes(itemValue);
         });
         if (selectedItems.length === 0)
             return 'unchecked';
@@ -2021,6 +2051,9 @@ export class NvFieldmultiselect {
             }, {
                 "propName": "value",
                 "methodName": "watchValueHandler"
+            }, {
+                "propName": "open",
+                "methodName": "handleOpenChange"
             }];
     }
     static get listeners() {