@keenthemes/ktui 1.0.11 → 1.0.13

package/lib/cjs/components/select/select.js

@@ -52,7 +52,6 @@ var combobox_1 = require("./combobox");
 var dropdown_1 = require("./dropdown");
 var utils_1 = require("./utils");
 var tags_1 = require("./tags");
-var types_1 = require("./types");
 var KTSelect = /** @class */ (function (_super) {
     __extends(KTSelect, _super);
     /**
@@ -69,6 +68,7 @@ var KTSelect = /** @class */ (function (_super) {
         _this._tagsModule = null;
         _this._dropdownModule = null;
         _this._loadMoreIndicator = null;
+        _this._typeToSearchBuffer = new utils_1.TypeToSearchBuffer();
         // Search debounce timeout
         _this._searchDebounceTimeout = null;
         // Store original options HTML for restoring after search
@@ -153,11 +153,6 @@ var KTSelect = /** @class */ (function (_super) {
         // Keep only the empty/placeholder option and remove the rest
         var options = Array.from(this._element.querySelectorAll('option:not([value=""])'));
         options.forEach(function (option) { return option.remove(); });
-        // Ensure we have at least an empty option
-        if (this._element.querySelectorAll('option').length === 0) {
-            var emptyOption = templates_1.defaultTemplates.emptyOption(__assign(__assign({}, this._config), { placeholder: this._config.placeholder }));
-            this._element.appendChild(emptyOption);
-        }
     };
     /**
      * Helper to show a dropdown message (error, loading, noResults)
@@ -165,19 +160,20 @@ var KTSelect = /** @class */ (function (_super) {
     KTSelect.prototype._showDropdownMessage = function (type, message) {
         if (!this._dropdownContentElement)
             return;
-        var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options-container]');
+        var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options]');
         if (!optionsContainer)
             return;
+        // Clear previous messages
+        optionsContainer.innerHTML = '';
         switch (type) {
             case 'error':
-                optionsContainer.innerHTML = templates_1.defaultTemplates.error(__assign(__assign({}, this._config), { errorMessage: message }));
+                optionsContainer.appendChild(templates_1.defaultTemplates.error(__assign(__assign({}, this._config), { errorMessage: message })));
                 break;
             case 'loading':
-                optionsContainer.innerHTML = templates_1.defaultTemplates.loading(this._config, message || 'Loading...').outerHTML;
+                optionsContainer.appendChild(templates_1.defaultTemplates.loading(this._config, message || 'Loading...'));
                 break;
-            case 'noResults':
-                optionsContainer.innerHTML = '';
-                optionsContainer.appendChild(templates_1.defaultTemplates.noResults(this._config));
+            case 'empty':
+                optionsContainer.appendChild(templates_1.defaultTemplates.empty(this._config));
                 break;
         }
     };
@@ -196,14 +192,6 @@ var KTSelect = /** @class */ (function (_super) {
      * @param message Error message
      */
     KTSelect.prototype._renderErrorState = function (message) {
-        // Create error option if the select is empty
-        if (this._element.querySelectorAll('option').length <= 1) {
-            var loadingOptions = this._element.querySelectorAll('option[disabled]:not([value])');
-            loadingOptions.forEach(function (option) { return option.remove(); });
-            // Use template function for error option instead of hardcoded element
-            var errorOption = templates_1.defaultTemplates.errorOption(__assign(__assign({}, this._config), { errorMessage: message }));
-            this._element.appendChild(errorOption);
-        }
         // If dropdown is already created, show error message there
         this._showDropdownMessage('error', message);
         if (!this._wrapperElement) {
@@ -226,7 +214,7 @@ var KTSelect = /** @class */ (function (_super) {
         // Create load more button using template
         this._loadMoreIndicator = templates_1.defaultTemplates.loadMore(this._config);
         // Add to dropdown
-        var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options-container]');
+        var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options]');
         if (optionsContainer) {
             optionsContainer.appendChild(this._loadMoreIndicator);
         }
@@ -296,42 +284,26 @@ var KTSelect = /** @class */ (function (_super) {
      * @param newItems New items to add to the dropdown
      */
     KTSelect.prototype._updateOptionsInDropdown = function (newItems) {
-        var _this = this;
         if (!this._dropdownContentElement || !newItems.length)
             return;
-        var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options-container]');
+        var optionsContainer = this._dropdownContentElement.querySelector("[data-kt-select-options]");
         if (!optionsContainer)
             return;
         // Get the load more button
-        var loadMoreButton = optionsContainer.querySelector('[data-kt-select-load-more]');
+        var loadMoreButton = optionsContainer.querySelector("[data-kt-select-load-more]");
         // Process each new item
         newItems.forEach(function (item) {
             // Create option for the original select
-            var selectOption = templates_1.defaultTemplates.emptyOption(__assign(__assign({}, _this._config), { placeholder: item.title || 'Unnamed option' }));
+            var selectOption = document.createElement('option');
             selectOption.value = item.id || '';
-            // Add description and icon attributes if available and valid
-            if (item.description &&
-                item.description !== 'null' &&
-                item.description !== 'undefined') {
-                selectOption.setAttribute('data-kt-select-option-description', item.description);
-            }
-            if (item.icon && item.icon !== 'null' && item.icon !== 'undefined') {
-                selectOption.setAttribute('data-kt-select-option-icon', item.icon);
-            }
-            // Add the option to the original select element
-            _this._element.appendChild(selectOption);
-            // Create option element for the dropdown using the KTSelectOption class
-            // This ensures consistent option rendering
-            var ktOption = new option_1.KTSelectOption(selectOption, _this._config);
-            var renderedOption = ktOption.render();
             // Add to dropdown container
             if (loadMoreButton) {
                 // Insert before the load more button
-                optionsContainer.insertBefore(renderedOption, loadMoreButton);
+                optionsContainer.insertBefore(selectOption, loadMoreButton);
             }
             else {
                 // Append to the end
-                optionsContainer.appendChild(renderedOption);
+                optionsContainer.appendChild(selectOption);
             }
         });
         // Update options NodeList to include the new options
@@ -353,7 +325,7 @@ var KTSelect = /** @class */ (function (_super) {
         this._setupElementReferences();
         this._initZIndex();
         // Initialize options
-        this._initializeOptionsHtml();
+        // this._initializeOptionsHtml();
         this._preSelectOptions(this._element);
         // Apply disabled state if needed
         this._applyInitialDisabledState();
@@ -362,17 +334,17 @@ var KTSelect = /** @class */ (function (_super) {
             this._initializeSearchModule();
         }
         // Initialize combobox if enabled
-        if (this._config.mode === types_1.SelectMode.COMBOBOX) {
+        if (this._config.combobox) {
             this._comboboxModule = new combobox_1.KTSelectCombobox(this);
         }
         // Initialize tags if enabled
-        if (this._config.mode === types_1.SelectMode.TAGS) {
+        if (this._config.tags) {
             this._tagsModule = new tags_1.KTSelectTags(this);
         }
         // Initialize focus manager after dropdown element is created
         this._focusManager = new utils_1.FocusManager(this._dropdownContentElement, '[data-kt-select-option]', this._config);
         // Initialize dropdown module after all elements are created
-        this._dropdownModule = new dropdown_1.KTSelectDropdown(this._wrapperElement, this._displayElement, this._dropdownContentElement, this._config);
+        this._dropdownModule = new dropdown_1.KTSelectDropdown(this._wrapperElement, this._displayElement, this._dropdownContentElement, this._config, this);
         // Update display and set ARIA attributes
         this._updateDisplayAndAriaAttributes();
         this.updateSelectedOptionDisplay();
@@ -380,34 +352,34 @@ var KTSelect = /** @class */ (function (_super) {
         // Attach event listeners after all modules are initialized
         this._attachEventListeners();
     };
-    /**
-     * Initialize options HTML from data
-     */
-    KTSelect.prototype._initializeOptionsHtml = function () {
-        this._generateOptionsHtml(this._element);
-    };
     /**
      * Creates the HTML structure for the select component
      */
     KTSelect.prototype._createHtmlStructure = function () {
+        var _a;
         var _this = this;
         var options = Array.from(this._element.querySelectorAll('option'));
         // Create wrapper and display elements
-        var wrapperElement = templates_1.defaultTemplates.main(this._config);
+        var wrapperElement = templates_1.defaultTemplates.wrapper(this._config);
         var displayElement = templates_1.defaultTemplates.display(this._config);
         // Add the display element to the wrapper
         wrapperElement.appendChild(displayElement);
+        // Move classes from original select to display element
+        if (this._element.classList.length > 0) {
+            (_a = displayElement.classList).add.apply(_a, Array.from(this._element.classList));
+            this._element.className = '';
+        }
         // Create an empty dropdown first (without options) using template
-        var dropdownElement = templates_1.defaultTemplates.dropdownContent(__assign(__assign({}, this._config), { zindex: this._config.dropdownZindex }));
+        var dropdownElement = templates_1.defaultTemplates.dropdown(__assign(__assign({}, this._config), { zindex: this._config.dropdownZindex }));
         // Add search input if needed
-        var isCombobox = this._config.mode === types_1.SelectMode.COMBOBOX;
-        var hasSearch = this._config.enableSearch && !isCombobox;
-        if (hasSearch) {
+        if (this._config.enableSearch) {
             var searchElement = templates_1.defaultTemplates.search(this._config);
             dropdownElement.appendChild(searchElement);
         }
         // Create options container using template
-        var optionsContainer = templates_1.defaultTemplates.optionsContainer(this._config);
+        var optionsContainer = templates_1.defaultTemplates.options(this._config);
+        // Clear the options container
+        optionsContainer.innerHTML = '';
         // Add each option directly to the container
         options.forEach(function (optionElement) {
             // Skip empty placeholder options (only if BOTH value AND text are empty)
@@ -438,21 +410,17 @@ var KTSelect = /** @class */ (function (_super) {
         // Get display element
         this._displayElement = this._wrapperElement.querySelector("[data-kt-select-display]");
         // Get dropdown content element - this is critical for dropdown functionality
-        this._dropdownContentElement = this._wrapperElement.querySelector("[data-kt-select-dropdown-content]");
+        this._dropdownContentElement = this._wrapperElement.querySelector("[data-kt-select-dropdown]");
         if (!this._dropdownContentElement) {
+            console.log(this._element);
             console.error('Dropdown content element not found', this._wrapperElement);
         }
         // Get search input element - this is used for the search functionality
-        // First check if it's in dropdown, then check if it's in display (for combobox)
         this._searchInputElement = this._dropdownContentElement.querySelector("[data-kt-select-search]");
-        // If not found in dropdown, check if it's the display element itself (for combobox)
-        if (!this._searchInputElement &&
-            this._config.mode === types_1.SelectMode.COMBOBOX) {
+        // If not found in dropdown, check if it's the display element itself
+        if (!this._searchInputElement) {
             this._searchInputElement = this._displayElement;
         }
-        if (this._config.debug)
-            console.log('Search input found:', this._searchInputElement ? 'Yes' : 'No', 'Mode:', this._config.mode, 'EnableSearch:', this._config.enableSearch);
-        this._valueDisplayElement = this._wrapperElement.querySelector("[data-kt-select-value]");
         this._options = this._wrapperElement.querySelectorAll("[data-kt-select-option]");
     };
     /**
@@ -461,17 +429,12 @@ var KTSelect = /** @class */ (function (_super) {
     KTSelect.prototype._attachEventListeners = function () {
         // Document level event listeners
         document.addEventListener('click', this._handleDocumentClick.bind(this));
-        document.addEventListener('keydown', this._handleEscKey.bind(this));
         // Dropdown option click events
         this._eventManager.addListener(this._dropdownContentElement, 'click', this._handleDropdownOptionClick.bind(this));
-        // Only attach click handler to display element
-        this._eventManager.addListener(this._displayElement, 'click', this._handleDropdownClick.bind(this));
-        // Only attach keyboard navigation to display element if NOT in combobox mode
-        // This prevents conflicts with the combobox module's keyboard handler
-        if (this._config.mode !== types_1.SelectMode.COMBOBOX) {
-            if (this._config.debug)
-                console.log('Attaching keyboard navigation to display element (non-combobox mode)');
-            this._eventManager.addListener(this._displayElement, 'keydown', this._handleDropdownKeyDown.bind(this));
+        // Attach centralized keyboard handler to the wrapper element.
+        // Events from focusable children like _displayElement or _searchInputElement (if present) will bubble up.
+        if (this._wrapperElement) {
+            this._wrapperElement.addEventListener('keydown', this._handleKeyboardEvent.bind(this));
         }
     };
     /**
@@ -541,52 +504,12 @@ var KTSelect = /** @class */ (function (_super) {
                     label =
                         extractedLabel !== null ? String(extractedLabel) : 'Unnamed option';
                 }
-                // Get description - skip if null, undefined, or "null" string
-                var description = null;
-                if (item.description !== undefined &&
-                    item.description !== null &&
-                    String(item.description) !== 'null' &&
-                    String(item.description) !== 'undefined') {
-                    description = String(item.description);
-                }
-                else if (_this._config.dataFieldDescription) {
-                    var extractedDesc = _this._getValueByKey(item, _this._config.dataFieldDescription);
-                    if (extractedDesc !== null &&
-                        extractedDesc !== undefined &&
-                        String(extractedDesc) !== 'null' &&
-                        String(extractedDesc) !== 'undefined') {
-                        description = String(extractedDesc);
-                    }
-                }
-                // Get icon - skip if null, undefined, or "null" string
-                var icon = null;
-                if (item.icon !== undefined &&
-                    item.icon !== null &&
-                    String(item.icon) !== 'null' &&
-                    String(item.icon) !== 'undefined') {
-                    icon = String(item.icon);
-                }
-                else if (_this._config.dataFieldIcon) {
-                    var extractedIcon = _this._getValueByKey(item, _this._config.dataFieldIcon);
-                    if (extractedIcon !== null &&
-                        extractedIcon !== undefined &&
-                        String(extractedIcon) !== 'null' &&
-                        String(extractedIcon) !== 'undefined') {
-                        icon = String(extractedIcon);
-                    }
-                }
                 // Log the extracted values for debugging
                 if (_this._config.debug)
-                    console.log("Option: value=".concat(value, ", label=").concat(label, ", desc=").concat(description ? description : 'none', ", icon=").concat(icon ? icon : 'none'));
+                    console.log("Option: value=".concat(value, ", label=").concat(label));
                 // Set option attributes
                 optionElement.value = value;
                 optionElement.textContent = label || 'Unnamed option';
-                if (description) {
-                    optionElement.setAttribute('data-kt-select-option-description', description);
-                }
-                if (icon) {
-                    optionElement.setAttribute('data-kt-select-option-icon', icon);
-                }
                 if (item.selected) {
                     optionElement.setAttribute('selected', 'selected');
                 }
@@ -654,31 +577,15 @@ var KTSelect = /** @class */ (function (_super) {
      * DROPDOWN MANAGEMENT
      * ========================================================================
      */
-    /**
-     * Toggle dropdown visibility
-     */
-    KTSelect.prototype.toggleDropdown = function () {
-        if (this._config.debug)
-            console.log('toggleDropdown called');
-        if (this._dropdownModule) {
-            // Always use the dropdown module's state to determine whether to open or close
-            if (this._dropdownModule.isOpen()) {
-                if (this._config.debug)
-                    console.log('Dropdown is open, closing...');
-                this.closeDropdown();
-            }
-            else {
-                if (this._config.debug)
-                    console.log('Dropdown is closed, opening...');
-                this.openDropdown();
-            }
-        }
-    };
     /**
      * Open the dropdown
      */
     KTSelect.prototype.openDropdown = function () {
-        var _this = this;
+        if (this._config.disabled) {
+            if (this._config.debug)
+                console.log('openDropdown: select is disabled, not opening');
+            return;
+        }
         if (this._config.debug)
             console.log('openDropdown called, dropdownModule exists:', !!this._dropdownModule);
         if (!this._dropdownModule) {
@@ -701,14 +608,6 @@ var KTSelect = /** @class */ (function (_super) {
         // Dispatch custom event
         this._dispatchEvent('show');
         this._fireEvent('show');
-        // Focus search input if configured and exists
-        if (this._config.enableSearch &&
-            this._config.searchAutofocus &&
-            this._searchInputElement) {
-            setTimeout(function () {
-                _this._searchInputElement.focus();
-            }, 50);
-        }
         // Update ARIA states
         this._setAriaAttributes();
         // Focus the first selected option or first option if nothing selected
@@ -729,14 +628,14 @@ var KTSelect = /** @class */ (function (_super) {
         // Always close by delegating to the dropdown module, which is the source of truth
         if (this._config.debug)
             console.log('Closing dropdown via dropdownModule...');
-        // Clear search input and highlights if the dropdown is closing
+        // Clear search input if the dropdown is closing
         if (this._searchModule && this._searchInputElement) {
             // Clear search input if configured to do so
             if (this._config.clearSearchOnClose) {
                 this._searchInputElement.value = '';
             }
-            // Always clear the highlights when dropdown closes
-            this._searchModule.clearSearchHighlights();
+            // Clear search input when dropdown closes
+            this._searchModule.clearSearch();
         }
         // Set our internal flag to match what we're doing
         this._dropdownIsOpen = false;
@@ -770,10 +669,13 @@ var KTSelect = /** @class */ (function (_super) {
         var selectedOptions = this.getSelectedOptions();
         if (selectedOptions.length === 0)
             return;
-        // Get the first selected option element
-        var firstSelectedValue = selectedOptions[0];
-        // Use the FocusManager to focus on the option
-        this._focusManager.focusOptionByValue(firstSelectedValue);
+        // Iterate through selected options and focus the first one that is visible
+        for (var _i = 0, selectedOptions_1 = selectedOptions; _i < selectedOptions_1.length; _i++) {
+            var value = selectedOptions_1[_i];
+            if (this._focusManager && this._focusManager.focusOptionByValue(value)) {
+                break; // Stop after focusing the first found selected and visible option
+            }
+        }
     };
     /**
      * ========================================================================
@@ -784,6 +686,12 @@ var KTSelect = /** @class */ (function (_super) {
      * Select an option by value
      */
     KTSelect.prototype._selectOption = function (value) {
+        // Prevent selection if the option is disabled (in dropdown or original select)
+        if (this._isOptionDisabled(value)) {
+            if (this._config.debug)
+                console.log('_selectOption: Option is disabled, ignoring selection');
+            return;
+        }
         // Get current selection state
         var isSelected = this._state.isSelected(value);
         // Toggle selection in state
@@ -829,109 +737,91 @@ var KTSelect = /** @class */ (function (_super) {
      * Update selected option display value
      */
     KTSelect.prototype.updateSelectedOptionDisplay = function () {
-        var _this = this;
         var selectedOptions = this.getSelectedOptions();
-        if (this._config.renderSelected) {
-            // Use the custom renderSelected function if provided
-            this._updateValueDisplay(this._config.renderSelected(selectedOptions));
+        var tagsEnabled = this._config.tags && this._tagsModule;
+        var valueDisplayEl = this.getValueDisplayElement();
+        if (tagsEnabled) {
+            // Tags module will render tags if selectedOptions > 0, or clear them if selectedOptions === 0.
+            this._tagsModule.updateTagsDisplay(selectedOptions);
+        }
+        // Guard against valueDisplayEl being null due to template modifications
+        if (!valueDisplayEl) {
+            if (this._config.debug) {
+                console.warn('KTSelect: Value display element is null. Cannot update display or placeholder. Check template for [data-kt-select-value].');
+            }
+            return; // Nothing to display on if the element is missing
         }
-        else {
-            if (selectedOptions.length === 0) {
-                if (this._config.mode !== types_1.SelectMode.COMBOBOX) {
-                    this._updateValueDisplay(this._config.placeholder); // Use innerHTML for placeholder
-                }
+        // 1. Custom render function takes highest precedence
+        if (typeof this._config.renderSelected === 'function') {
+            valueDisplayEl.innerHTML = this._config.renderSelected(selectedOptions);
+            return;
+        }
+        // 2. Custom displayTemplate string
+        // Check if a custom display template string is provided directly in config or via config.templates
+        var customDisplayTemplateString = this._config.displayTemplate || (this._config.templates && this._config.templates.display);
+        if (customDisplayTemplateString) {
+            // If tags are enabled and items are selected, the tags module handles display, so clear the main display area.
+            if (tagsEnabled && selectedOptions.length > 0) {
+                valueDisplayEl.innerHTML = '';
             }
-            else if (this._config.multiple) {
-                if (this._config.mode === types_1.SelectMode.TAGS) {
-                    // Use the tags module to render selected options as tags
-                    if (this._tagsModule) {
-                        this._tagsModule.updateTagsDisplay(selectedOptions);
-                    }
-                    else {
-                        // Fallback if tags module not initialized for some reason
-                        this._updateValueDisplay(selectedOptions.join(', '));
-                    }
-                }
-                else {
-                    // Render as comma-separated values
-                    var displayText = selectedOptions
-                        .map(function (option) { return _this._getOptionInnerHtml(option) || ''; })
-                        .join(', ');
-                    this._updateValueDisplay(displayText);
-                }
+            else {
+                // Otherwise, render the custom display template.
+                // If no options are selected, renderDisplayTemplateForSelected should handle showing a placeholder if the template supports it,
+                // or we might need a separate placeholder rendering for custom templates if they don't handle empty selection.
+                // For now, assume renderDisplayTemplateForSelected handles it or shows selected text.
+                valueDisplayEl.innerHTML = this.renderDisplayTemplateForSelected(selectedOptions);
+            }
+            return;
+        }
+        // 3. Default template behavior (no custom function or string template)
+        var textContainer = valueDisplayEl.querySelector('[data-kt-text-container="true"]');
+        if (tagsEnabled && selectedOptions.length > 0) {
+            // Tags are active and have content, clear the text container if it exists,
+            // or the whole display if it doesn't (though it should with default template).
+            if (textContainer) {
+                textContainer.innerHTML = '';
             }
             else {
-                var selectedOption = selectedOptions[0];
-                if (selectedOption) {
-                    var selectedText = this._getOptionInnerHtml(selectedOption);
-                    this._updateValueDisplay(selectedText);
-                    // Update combobox input value if in combobox mode
-                    if (this._config.mode === types_1.SelectMode.COMBOBOX &&
-                        this._comboboxModule) {
-                        this._comboboxModule.updateSelectedValue(selectedText);
-                    }
-                }
-                else {
-                    this._updateValueDisplay(this._config.placeholder);
-                }
+                valueDisplayEl.innerHTML = ''; // Fallback: clear entire display area
             }
         }
-        // Update any debug display boxes if they exist
-        this._updateDebugDisplays();
-    };
-    /**
-     * Update the value display element
-     */
-    KTSelect.prototype._updateValueDisplay = function (value) {
-        if (this._config.mode === types_1.SelectMode.COMBOBOX) {
-            // For combobox, we only update the hidden value element, not the input
-            // The combobox module will handle updating the input value
-            if (!this._comboboxModule) {
-                this._valueDisplayElement.value = value;
+        else if (selectedOptions.length === 0) {
+            // No options selected: display placeholder text in the text container.
+            var placeholderTemplate = templates_1.defaultTemplates.placeholder(this._config);
+            var placeholderText = placeholderTemplate.textContent || ''; // Get text from placeholder element
+            if (textContainer) {
+                textContainer.innerHTML = placeholderText;
+            }
+            else {
+                // Fallback: If no text container, replace children of valueDisplayEl with the placeholder element itself.
+                // This ensures the placeholder (which might have its own structure/classes) is displayed.
+                valueDisplayEl.replaceChildren(placeholderTemplate);
             }
         }
         else {
-            this._valueDisplayElement.innerHTML = value;
-        }
-    };
-    /**
-     * Update debug displays if present
-     */
-    KTSelect.prototype._updateDebugDisplays = function () {
-        // Check if we're in a test environment with debug boxes
-        var selectId = this.getElement().id;
-        if (selectId) {
-            var debugElement = document.getElementById("".concat(selectId, "-value"));
-            if (debugElement) {
-                var selectedOptions = this.getSelectedOptions();
-                // Format display based on selection mode
-                if (this._config.multiple) {
-                    // For multiple selection, show comma-separated list
-                    debugElement.textContent =
-                        selectedOptions.length > 0 ? selectedOptions.join(', ') : 'None';
-                }
-                else {
-                    // For single selection, show just the one value
-                    debugElement.textContent =
-                        selectedOptions.length > 0 ? selectedOptions[0] : 'None';
-                }
+            // Options are selected, and tags are not enabled (or no selected options for tags):
+            // Render normal selected text in the text container.
+            var content = this.getSelectedOptionsText();
+            if (textContainer) {
+                textContainer.innerHTML = content;
+            }
+            else {
+                valueDisplayEl.innerHTML = content; // Fallback: set content on whole display area
             }
         }
     };
     /**
-     * Get option inner HTML content by option value
+     * Check if an option was originally disabled in the HTML
      */
-    KTSelect.prototype._getOptionInnerHtml = function (optionValue) {
-        var option = Array.from(this._options).find(function (opt) { return opt.dataset.value === optionValue; });
-        if (this._config.mode == types_1.SelectMode.COMBOBOX) {
-            return option.textContent;
-        }
-        return option.innerHTML; // Get the entire HTML content of the option
+    KTSelect.prototype._isOptionOriginallyDisabled = function (value) {
+        var originalOption = Array.from(this._element.querySelectorAll('option')).find(function (opt) { return opt.value === value; });
+        return originalOption ? originalOption.disabled : false;
     };
     /**
      * Update CSS classes for selected options
      */
     KTSelect.prototype._updateSelectedOptionClass = function () {
+        var _this = this;
         var allOptions = this._wrapperElement.querySelectorAll("[data-kt-select-option]");
         var selectedValues = this._state.getSelectedOptions();
         var maxReached = typeof this._config.maxSelections === 'number' &&
@@ -943,9 +833,11 @@ var KTSelect = /** @class */ (function (_super) {
             if (!optionValue)
                 return;
             var isSelected = selectedValues.includes(optionValue);
+            var isOriginallyDisabled = _this._isOptionOriginallyDisabled(optionValue);
             if (isSelected) {
                 option.classList.add('selected');
                 option.setAttribute('aria-selected', 'true');
+                // Selected options should not be visually hidden or disabled by maxSelections logic
                 option.classList.remove('hidden');
                 option.classList.remove('disabled');
                 option.removeAttribute('aria-disabled');
@@ -953,7 +845,8 @@ var KTSelect = /** @class */ (function (_super) {
             else {
                 option.classList.remove('selected');
                 option.setAttribute('aria-selected', 'false');
-                if (maxReached) {
+                // An option should be disabled if it was originally disabled OR if maxSelections is reached
+                if (isOriginallyDisabled || maxReached) {
                     option.classList.add('disabled');
                     option.setAttribute('aria-disabled', 'true');
                 }
@@ -972,17 +865,6 @@ var KTSelect = /** @class */ (function (_super) {
         this._state.setSelectedOptions([]);
         this.updateSelectedOptionDisplay();
         this._updateSelectedOptionClass();
-        // For combobox, also clear the input value
-        if (this._config.mode === types_1.SelectMode.COMBOBOX) {
-            if (this._searchInputElement) {
-                this._searchInputElement.value = '';
-            }
-            // If combobox has a clear button, hide it
-            if (this._comboboxModule) {
-                // The combobox module will handle hiding the clear button
-                this._comboboxModule.resetInputValueToSelection();
-            }
-        }
         // Dispatch change event
         this._dispatchEvent('change');
         this._fireEvent('change');
@@ -994,49 +876,6 @@ var KTSelect = /** @class */ (function (_super) {
         var values = Array.from(options).map(function (option) { return option.value; });
         this._state.setSelectedOptions(values);
     };
-    /**
-     * ========================================================================
-     * KEYBOARD NAVIGATION
-     * ========================================================================
-     */
-    /**
-     * Handle dropdown key down events for keyboard navigation
-     * Only used for standard (non-combobox) dropdowns
-     */
-    KTSelect.prototype._handleDropdownKeyDown = function (event) {
-        // Log event for debugging
-        if (this._config.debug)
-            console.log('Standard dropdown keydown:', event.key);
-        // Use the shared handler
-        (0, utils_1.handleDropdownKeyNavigation)(event, this, {
-            multiple: this._config.multiple,
-            closeOnSelect: this._config.closeOnSelect,
-        });
-    };
-    /**
-     * Focus next option in dropdown
-     */
-    KTSelect.prototype._focusNextOption = function () {
-        return this._focusManager.focusNext();
-    };
-    /**
-     * Focus previous option in dropdown
-     */
-    KTSelect.prototype._focusPreviousOption = function () {
-        return this._focusManager.focusPrevious();
-    };
-    /**
-     * Apply hover/focus state to focused option
-     */
-    KTSelect.prototype._hoverFocusedOption = function (option) {
-        this._focusManager.applyFocus(option);
-    };
-    /**
-     * Scroll option into view when navigating
-     */
-    KTSelect.prototype._scrollOptionIntoView = function (option) {
-        this._focusManager.scrollIntoView(option);
-    };
     /**
      * Select the currently focused option
      */
@@ -1060,60 +899,13 @@ var KTSelect = /** @class */ (function (_super) {
             if (selectedValue) {
                 this._selectOption(selectedValue);
             }
-            // For combobox mode, update input value AFTER selection to ensure consistency
-            if (this._config.mode === types_1.SelectMode.COMBOBOX && this._comboboxModule) {
-                this._comboboxModule.updateSelectedValue(selectedText);
-                // Also directly update the input value for immediate visual feedback
-                if (this._searchInputElement) {
-                    this._searchInputElement.value = selectedText;
-                }
-            }
         }
     };
-    /**
-     * ========================================================================
-     * COMBOBOX SPECIFIC METHODS
-     * ========================================================================
-     */
-    /**
-     * Handle combobox input events
-     */
-    KTSelect.prototype._handleComboboxInput = function (event) {
-        if (this._comboboxModule) {
-            return;
-        }
-        var inputElement = event.target;
-        var query = inputElement.value.toLowerCase();
-        // If dropdown isn't open, open it when user starts typing
-        if (!this._dropdownIsOpen) {
-            this.openDropdown();
-        }
-        // Filter options based on input
-        this._filterOptionsForCombobox(query);
-    };
-    /**
-     * Filter options for combobox based on input query
-     * Uses the shared filterOptions function
-     */
-    KTSelect.prototype._filterOptionsForCombobox = function (query) {
-        var options = Array.from(this._dropdownContentElement.querySelectorAll('[data-kt-select-option]'));
-        (0, utils_1.filterOptions)(options, query, this._config, this._dropdownContentElement);
-    };
     /**
      * ========================================================================
      * EVENT HANDLERS
      * ========================================================================
      */
-    /**
-     * Handle display element click
-     */
-    KTSelect.prototype._handleDropdownClick = function (event) {
-        if (this._config.debug)
-            console.log('Display element clicked', event.target);
-        event.preventDefault();
-        event.stopPropagation(); // Prevent event bubbling
-        this.toggleDropdown();
-    };
     /**
      * Handle click within the dropdown
      */
@@ -1154,6 +946,13 @@ var KTSelect = /** @class */ (function (_super) {
         }
         if (this._config.debug)
             console.log('Option clicked:', optionValue);
+        // If in single-select mode and the clicked option is already selected, just close the dropdown.
+        if (!this._config.multiple && this._state.isSelected(optionValue)) {
+            if (this._config.debug)
+                console.log('Single select mode: clicked already selected option. Closing dropdown.');
+            this.closeDropdown();
+            return;
+        }
         // Use toggleSelection instead of _selectOption to prevent re-rendering
         this.toggleSelection(optionValue);
     };
@@ -1167,14 +966,6 @@ var KTSelect = /** @class */ (function (_super) {
             this.closeDropdown();
         }
     };
-    /**
-     * Handle escape key press
-     */
-    KTSelect.prototype._handleEscKey = function (event) {
-        if (event.key === 'Escape' && this._dropdownIsOpen) {
-            this.closeDropdown();
-        }
-    };
     /**
      * ========================================================================
      * ACCESSIBILITY METHODS
@@ -1186,18 +977,6 @@ var KTSelect = /** @class */ (function (_super) {
     KTSelect.prototype._setAriaAttributes = function () {
         this._displayElement.setAttribute('aria-expanded', this._dropdownIsOpen.toString());
     };
-    /**
-     * Handle focus events
-     */
-    KTSelect.prototype._handleFocus = function () {
-        // Implementation pending
-    };
-    /**
-     * Handle blur events
-     */
-    KTSelect.prototype._handleBlur = function () {
-        // Implementation pending
-    };
     /**
      * ========================================================================
      * PUBLIC API
@@ -1237,7 +1016,13 @@ var KTSelect = /** @class */ (function (_super) {
      * Get value display element
      */
     KTSelect.prototype.getValueDisplayElement = function () {
-        return this._valueDisplayElement;
+        return this._displayElement;
+    };
+    /**
+     * Get wrapper element
+     */
+    KTSelect.prototype.getWrapperElement = function () {
+        return this._wrapperElement;
     };
     /**
      * Show all options in the dropdown
@@ -1247,6 +1032,7 @@ var KTSelect = /** @class */ (function (_super) {
         var options = Array.from(this._wrapperElement.querySelectorAll("[data-kt-select-option]"));
         // Show all options by removing the hidden class and any inline styles
         options.forEach(function (option) {
+            var _a;
             // Remove hidden class
             option.classList.remove('hidden');
             // Clean up any existing inline styles for backward compatibility
@@ -1260,17 +1046,17 @@ var KTSelect = /** @class */ (function (_super) {
                     }
                     else {
                         // Otherwise, remove just the display property
-                        option.setAttribute('style', styleAttr.replace(/display:\s*[^;]+;?/gi, '').trim());
+                        option.setAttribute('style', (_a = styleAttr === null || styleAttr === void 0 ? void 0 : styleAttr.replace(/display:\s*[^;]+;?/gi, '')) === null || _a === void 0 ? void 0 : _a.trim());
                     }
                 }
             }
         });
         // If search input exists, clear it
-        if (this._searchInputElement && this._config.mode !== types_1.SelectMode.COMBOBOX) {
+        if (this._searchInputElement) {
             this._searchInputElement.value = '';
             // If we have a search module, clear any search filtering
             if (this._searchModule) {
-                this._searchModule.clearSearchHighlights();
+                this._searchModule.clearSearch();
             }
         }
     };
@@ -1290,10 +1076,16 @@ var KTSelect = /** @class */ (function (_super) {
      * Toggle the selection of an option
      */
     KTSelect.prototype.toggleSelection = function (value) {
+        // Prevent selection if the option is disabled (in dropdown or original select)
+        if (this._isOptionDisabled(value)) {
+            if (this._config.debug)
+                console.log('toggleSelection: Option is disabled, ignoring selection');
+            return;
+        }
         // Get current selection state
         var isSelected = this._state.isSelected(value);
         if (this._config.debug)
-            console.log("toggleSelection called for value: ".concat(value, ", isSelected: ").concat(isSelected, ", multiple: ").concat(this._config.multiple, ", closeOnSelect: ").concat(this._config.closeOnSelect));
+            console.log("toggleSelection called for value: ".concat(value, ", isSelected: ").concat(isSelected, ", multiple: ").concat(this._config.multiple));
         // If already selected in single select mode, do nothing (can't deselect in single select)
         if (isSelected && !this._config.multiple) {
             if (this._config.debug)
@@ -1302,9 +1094,9 @@ var KTSelect = /** @class */ (function (_super) {
         }
         if (this._config.debug)
             console.log("Toggling selection for option: ".concat(value, ", currently selected: ").concat(isSelected));
-        // Ensure any search highlights are cleared when selection changes
+        // Ensure any search input is cleared when selection changes
         if (this._searchModule) {
-            this._searchModule.clearSearchHighlights();
+            this._searchModule.clearSearch();
         }
         // Toggle the selection in the state
         this._state.toggleSelectedOptions(value);
@@ -1327,15 +1119,14 @@ var KTSelect = /** @class */ (function (_super) {
         // Update option classes without re-rendering the dropdown content
         this._updateSelectedOptionClass();
         // For single select mode, always close the dropdown after selection
-        // For multiple select mode, only close if closeOnSelect is true
         if (!this._config.multiple) {
             if (this._config.debug)
                 console.log('About to call closeDropdown() for single select mode - always close after selection');
             this.closeDropdown();
         }
-        else if (this._config.closeOnSelect) {
+        else {
             if (this._config.debug)
-                console.log('About to call closeDropdown() for multiple select with closeOnSelect:true');
+                console.log('About to call closeDropdown() for multiple select');
             this.closeDropdown();
         }
         // Dispatch custom change event with additional data
@@ -1435,9 +1226,9 @@ var KTSelect = /** @class */ (function (_super) {
                     .then(function () {
                     // Update options in the dropdown
                     _this._updateSearchResults(items);
-                    // Refresh the search module's option cache if search is enabled
-                    if (_this._searchModule && _this._config.enableSearch) {
-                        _this._searchModule.refreshOptionCache();
+                    // Refresh the search module to update focus and cache
+                    if (_this._searchModule) {
+                        _this._searchModule.refreshAfterSearch();
                     }
                 })
                     .catch(function (error) {
@@ -1457,7 +1248,7 @@ var KTSelect = /** @class */ (function (_super) {
      */
     KTSelect.prototype._renderSearchLoadingState = function () {
         if (!this._originalOptionsHtml && this._dropdownContentElement) {
-            var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options-container]');
+            var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options]');
             if (optionsContainer) {
                 this._originalOptionsHtml = optionsContainer.innerHTML;
             }
@@ -1476,36 +1267,26 @@ var KTSelect = /** @class */ (function (_super) {
      * @param items Search result items
      */
     KTSelect.prototype._updateSearchResults = function (items) {
-        var _this = this;
         if (!this._dropdownContentElement)
             return;
-        var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options-container]');
+        var optionsContainer = this._dropdownContentElement.querySelector('[data-kt-select-options]');
         if (!optionsContainer)
             return;
         // Clear current options
         optionsContainer.innerHTML = '';
         if (items.length === 0) {
             // Show no results message using template for consistency and customization
-            var noResultsElement = templates_1.defaultTemplates.noResults(this._config);
+            var noResultsElement = templates_1.defaultTemplates.empty(this._config);
             optionsContainer.appendChild(noResultsElement);
             return;
         }
         // Process each item individually to create options
         items.forEach(function (item) {
             // Create option for the original select
-            var selectOption = templates_1.defaultTemplates.emptyOption(__assign(__assign({}, _this._config), { placeholder: item.title }));
+            var selectOption = document.createElement('option');
             selectOption.value = item.id;
-            if (item.description) {
-                selectOption.setAttribute('data-kt-select-option-description', item.description);
-            }
-            if (item.icon) {
-                selectOption.setAttribute('data-kt-select-option-icon', item.icon);
-            }
-            // Create option element for the dropdown
-            var ktOption = new option_1.KTSelectOption(selectOption, _this._config);
-            var renderedOption = ktOption.render();
             // Add to dropdown container
-            optionsContainer.appendChild(renderedOption);
+            optionsContainer.appendChild(selectOption);
         });
         // Add pagination "Load More" button if needed
         if (this._config.pagination && this._remoteModule.hasMorePages()) {
@@ -1514,18 +1295,178 @@ var KTSelect = /** @class */ (function (_super) {
         // Update options NodeList
         this._options = this._wrapperElement.querySelectorAll("[data-kt-select-option]");
     };
-    /**
-     * Filter options by query
-     */
-    KTSelect.prototype.filterOptions = function (query) {
-        this._filterOptionsForCombobox(query);
-    };
     /**
      * Check if dropdown is open
      */
     KTSelect.prototype.isDropdownOpen = function () {
         return this._dropdownIsOpen;
     };
+    KTSelect.prototype.getSelectedOptionsText = function () {
+        var _this = this;
+        var selectedValues = this.getSelectedOptions();
+        var displaySeparator = this._config.displaySeparator || ', ';
+        var texts = selectedValues.map(function (value) {
+            var option = Array.from(_this._options).find(function (opt) { return opt.getAttribute('data-value') === value; });
+            return (option === null || option === void 0 ? void 0 : option.getAttribute('data-text')) || '';
+        }).filter(Boolean);
+        return texts.join(displaySeparator);
+    };
+    /**
+     * Check if an option is disabled (either in dropdown or original select)
+     */
+    KTSelect.prototype._isOptionDisabled = function (value) {
+        var dropdownOption = Array.from(this._options).find(function (opt) { return opt.getAttribute('data-value') === value; });
+        var isDropdownDisabled = dropdownOption && (dropdownOption.classList.contains('disabled') || dropdownOption.getAttribute('aria-disabled') === 'true');
+        var selectOption = Array.from(this._element.querySelectorAll('option')).find(function (opt) { return opt.value === value; });
+        var isNativeDisabled = selectOption && selectOption.disabled;
+        return Boolean(isDropdownDisabled || isNativeDisabled);
+    };
+    /**
+     * Centralized keyboard event handler for all select modes
+     */
+    KTSelect.prototype._handleKeyboardEvent = function (event) {
+        // If the event target is the search input and the event was already handled (defaultPrevented),
+        // then return early to avoid duplicate processing by this broader handler.
+        if (event.target === this._searchInputElement && event.defaultPrevented) {
+            return;
+        }
+        var isOpen = this._dropdownIsOpen;
+        var config = this._config;
+        var focusManager = this._focusManager;
+        var buffer = this._typeToSearchBuffer;
+        // If the event target is the search input, let it handle most typing keys naturally.
+        if (event.target === this._searchInputElement) {
+            // Allow navigation keys like ArrowDown, ArrowUp, Escape, Enter (for search/selection) to be handled by the logic below.
+            // For other keys (characters, space, backspace, delete), let the input field process them.
+            if (event.key !== 'ArrowDown' && event.key !== 'ArrowUp' &&
+                event.key !== 'Escape' && event.key !== 'Enter' && event.key !== 'Tab' &&
+                event.key !== 'Home' && event.key !== 'End') {
+                // If it's a character key and we are NOT type-to-searching (because search has focus)
+                // then let the input field handle it for its own value.
+                // The search module's 'input' event will handle filtering based on the input's value.
+                buffer.clear(); // Clear type-to-search buffer when typing in search field
+                return;
+            }
+            // For Enter specifically in search input, we might want to select the focused option or submit search.
+            // This is handled later in the switch.
+        }
+        // Ignore modifier keys (except for specific combinations if added later)
+        if (event.altKey || event.ctrlKey || event.metaKey)
+            return;
+        // Type-to-search: only for single char keys, when search input does not have focus
+        if (event.key.length === 1 && !event.repeat && !event.key.match(/\s/) && document.activeElement !== this._searchInputElement) {
+            buffer.push(event.key);
+            var str = buffer.getBuffer();
+            if (isOpen) {
+                focusManager.focusByString(str);
+            }
+            else {
+                // If closed, type-to-search could potentially open and select.
+                // For now, let's assume it only works when open or opens it first.
+                // Or, we could find the matching option and set it directly without opening.
+            }
+            return; // Type-to-search handles the event
+        }
+        switch (event.key) {
+            case 'ArrowDown':
+                event.preventDefault();
+                if (!isOpen) {
+                    this.openDropdown();
+                }
+                else {
+                    focusManager.focusNext();
+                }
+                break;
+            case 'ArrowUp':
+                event.preventDefault();
+                if (!isOpen) {
+                    this.openDropdown();
+                }
+                else {
+                    focusManager.focusPrevious();
+                }
+                break;
+            case 'Home':
+                event.preventDefault();
+                if (isOpen)
+                    focusManager.focusFirst();
+                break;
+            case 'End':
+                event.preventDefault();
+                if (isOpen)
+                    focusManager.focusLast();
+                break;
+            case 'Enter':
+            case ' ': // Space
+                if (isOpen) {
+                    var focusedOptionEl = this._focusManager.getFocusedOption();
+                    if (focusedOptionEl) {
+                        var val = focusedOptionEl.dataset.value;
+                        // If single select, and the item is already selected, just close.
+                        if (val !== undefined && !this._config.multiple && this._state.isSelected(val)) {
+                            if (this._config.debug)
+                                console.log('Enter on already selected item in single-select mode. Closing.');
+                            this.closeDropdown();
+                            event.preventDefault();
+                            break;
+                        }
+                    }
+                    // Proceed with selection if not handled above
+                    this.selectFocusedOption();
+                    // Close dropdown if configured to do so (for new selections)
+                    if (!this._config.multiple) {
+                        // This will also be true for the case handled above, but closeDropdown is idempotent.
+                        // However, the break above prevents this from being reached for that specific case.
+                        this.closeDropdown();
+                    }
+                    event.preventDefault(); // Prevent form submission or other default actions
+                    break;
+                }
+                else {
+                    this.openDropdown();
+                }
+                break;
+            case 'Escape':
+                if (isOpen) {
+                    this.closeDropdown();
+                    event.target.blur();
+                }
+                break;
+            case 'Tab':
+                // Let Tab propagate for normal focus movement
+                break;
+            default:
+                break;
+        }
+    };
+    KTSelect.prototype.renderDisplayTemplateForSelected = function (selectedValues) {
+        var _this = this;
+        var optionsConfig = this._config.optionsConfig || {};
+        var displaySeparator = this._config.displaySeparator || ', ';
+        var contentArray = Array.from(new Set(selectedValues.map(function (value) {
+            var option = Array.from(_this._options).find(function (opt) { return opt.getAttribute('data-value') === value; });
+            if (!option)
+                return '';
+            var displayTemplate = _this._config.displayTemplate;
+            var text = option.getAttribute('data-text') || '';
+            // Replace all {{varname}} in option.innerHTML with values from _config
+            Object.entries(optionsConfig[value] || {}).forEach(function (_a) {
+                var key = _a[0], val = _a[1];
+                if (["string", "number", "boolean"].includes(typeof val)) {
+                    displayTemplate = displayTemplate.replace(new RegExp("{{".concat(key, "}}"), 'g'), String(val));
+                }
+            });
+            return (0, utils_1.renderTemplateString)(displayTemplate, {
+                selectedCount: selectedValues.length || 0,
+                selectedTexts: _this.getSelectedOptionsText() || '',
+                text: text,
+            });
+        }).filter(Boolean)));
+        return contentArray.join(displaySeparator);
+    };
+    KTSelect.prototype.getDisplayElement = function () {
+        return this._displayElement;
+    };
     /**
      * ========================================================================
      * STATIC METHODS