@ukic/web-components 3.0.0 → 3.2.0

package/dist/collection/components/ic-select/ic-select.js

@@ -1,7 +1,7 @@
 import { Host, h, forceUpdate, } from "@stencil/core";
-import { getInputDescribedByText, getLabelFromValue, hasValidationStatus, inheritAttributes, onComponentRequiredPropUndefined, renderHiddenInput, isMobileOrTablet, getFilteredMenuOptions, addFormResetListener, removeFormResetListener, removeDisabledFalse, checkSlotInChildMutations, } from "../../utils/helpers";
+import { getInputDescribedByText, getLabelFromValue, hasValidationStatus, inheritAttributes, onComponentRequiredPropUndefined, renderHiddenInput, isMobileOrTablet, getFilteredMenuOptions, getOptionsWithoutGroupTitlesCount, addFormResetListener, removeFormResetListener, removeDisabledFalse, checkSlotInChildMutations, } from "../../utils/helpers";
 import { IC_INHERITED_ARIA } from "../../utils/constants";
-import { IcInformationStatus, IcThemeForegroundEnum, } from "../../utils/types";
+import { IcInformationStatus, } from "../../utils/types";
 import Expand from "./assets/Expand.svg";
 import Clear from "./assets/Clear.svg";
 let inputIds = 0;
@@ -19,14 +19,130 @@ export class Select {
         this.searchableMenuItemSelected = false;
         this.ungroupedOptions = [];
         this.hostMutationObserver = null;
+        this.clearButtonFocused = false;
+        this.noOptions = null;
+        this.open = false;
+        this.pressedCharacters = "";
+        this.searchableSelectInputValue = null;
+        /**
+         * If `true`, the disabled state will be set.
+         */
+        this.disabled = false;
+        /**
+         * If `true`, the built in filtering will be disabled for a searchable variant. For example, if options will already be filtered from external source.
+         */
+        this.disableAutoFiltering = false;
+        /**
+         * The text displayed when there are no options in the option list.
+         */
+        this.emptyOptionListText = "No results found";
+        /**
+         * If `true`, the select will fill the width of the container.
+         */
+        this.fullWidth = false;
+        /**
+         * The helper text that will be displayed for additional field guidance.
+         */
+        this.helperText = "";
+        /**
+         * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
+         */
+        this.hideLabel = false;
+        /**
+         * If `true`, descriptions of options will be included when filtering options in a searchable select. Only applies to built in filtering.
+         */
+        this.includeDescriptionsInSearch = false;
+        /**
+         * If `true`, group titles of grouped options will be included when filtering options in a searchable select. Only applies to built in filtering.
+         */
+        this.includeGroupTitlesInSearch = false;
+        /**
+         * The message displayed when external loading times out.
+         */
+        this.loadingErrorLabel = "Loading Error";
+        /**
+         * The message displayed whilst the options are being loaded externally.
+         */
+        this.loadingLabel = "Loading...";
+        /**
+         * If `true`, multiple options can be selected.
+         */
+        this.multiple = false;
+        /**
+         * The name of the control, which is submitted with the form data.
+         */
+        this.name = this.inputId;
+        /**
+         * The placeholder value to be displayed.
+         */
+        this.placeholder = "Select an option";
+        /**
+         * If `true`, the readonly state will be set.
+         */
+        this.readonly = false;
+        /**
+         * If `true`, the select will require a value.
+         */
+        this.required = false;
+        /**
+         * If `true`, a searchable variant of the select will be displayed which can be typed in to filter options. This functionality is only available on the single-select variant of the select component.
+         */
+        this.searchable = false;
+        /**
+         * Whether the search string of the searchable select should match the start of or anywhere in the options. Only applies to built in filtering.
+         */
+        this.searchMatchPosition = "anywhere";
+        /**
+         * If `true`, the icOptionSelect event will be fired on enter instead of ArrowUp and ArrowDown on the single select.
+         */
+        this.selectOnEnter = false;
+        /**
+         * If `true`, a button which clears the select input when clicked will be displayed. The button will always appear on the searchable select.
+         */
+        this.showClearButton = false;
+        /**
+         * The size of the select.
+         */
+        this.size = "medium";
+        /**
+         * Sets the theme color to the dark or light theme color. "inherit" will set the color based on the system settings or ic-theme component.
+         */
+        this.theme = "inherit";
+        /**
+         * The validation status - e.g. 'error' | 'warning' | 'success'.
+         */
+        this.validationStatus = "";
+        /**
+         * The text to display as the validation message.
+         */
+        this.validationText = "";
+        /**
+         * If `true`, the loading state will be triggered when fetching options asynchronously.
+         */
+        this.loading = false;
+        /**
+         * The possible selection options.
+         */
+        this.options = [];
+        this.filteredOptions = this.options;
+        this.uniqueOptions = this.options;
+        /**
+         * The amount of time, in milliseconds, to wait to trigger the `icInput` event after each keystroke.
+         */
+        this.debounce = 0;
+        this.currDebounce = this.debounce;
+        this.initialValue = this.value;
+        this.inputValueToFilter = this.value;
         // triggered when attributes of host element change
         this.hostMutationCallback = (mutationList) => {
             let forceComponentUpdate = false;
             mutationList.forEach(({ attributeName, type, addedNodes, removedNodes }) => {
-                if (MUTABLE_ATTRIBUTES.includes(attributeName)) {
-                    this.inheritedAttributes[attributeName] =
-                        this.el.getAttribute(attributeName);
-                    forceComponentUpdate = true;
+                if (attributeName) {
+                    const attribute = this.el.getAttribute(attributeName);
+                    if (attribute && MUTABLE_ATTRIBUTES.includes(attributeName)) {
+                        this.inheritedAttributes[attributeName] = attribute;
+                        forceComponentUpdate = true;
+                    }
                 }
                 else if (type === "childList") {
                     forceComponentUpdate = checkSlotInChildMutations(addedNodes, removedNodes, "icon");
@@ -43,21 +159,59 @@ export class Select {
             this.blurredBecauseButtonPressed = true;
             this.retryButtonClick = true;
             this.hasSetDefaultValue = true;
-            this.icRetryLoad.emit({ value: this.hiddenInputValue });
+            this.icRetryLoad.emit({
+                value: this.searchable
+                    ? this.searchableSelectInputValue
+                    : this.hiddenInputValue,
+            });
         };
         this.emitIcChange = (value) => {
-            if (!this.searchable) {
+            // If "Select all" button clicked, replace value with new value (array of all option values)
+            if (this.multiple && !Array.isArray(value) && value !== null) {
+                this.handleMultipleSelectChange(String(value));
+            }
+            else {
                 this.value = value;
             }
-            clearTimeout(this.debounceIcChange);
-            this.debounceIcChange = window.setTimeout(() => {
-                this.icChange.emit({ value: value });
-            }, this.currDebounce);
+            const valueToEmit = this.multiple ? this.value : value;
+            this.icChange.emit({ value: valueToEmit || null });
         };
-        this.emitImmediateIcChange = (value) => {
-            this.value = value;
-            clearTimeout(this.debounceIcChange);
-            this.icChange.emit({ value: value });
+        this.emitIcInput = (value) => {
+            clearTimeout(this.debounceIcInput);
+            this.debounceIcInput = window.setTimeout(() => this.icInput.emit({ value }), this.currDebounce);
+        };
+        this.setOptions = () => {
+            if (!this.hasTimedOut && this.options !== this.noOptions) {
+                this.loading = false;
+                clearTimeout(this.timeoutTimer);
+                if (this.options.length > 0) {
+                    this.setOptionsValuesFromLabels();
+                    this.uniqueOptions = this.deduplicateOptions(this.options);
+                    this.filteredOptions = this.uniqueOptions;
+                }
+                else {
+                    this.noOptions = [{ label: this.emptyOptionListText, value: "" }];
+                    this.uniqueOptions = this.noOptions;
+                    this.filteredOptions = this.noOptions;
+                }
+                if (this.isExternalFiltering()) {
+                    // When searchable select
+                    this.noOptions = null;
+                    this.updateSearchableSelectResultAriaLive();
+                    this.setDefaultValue();
+                }
+                else {
+                    if (this.initialOptionsEmpty) {
+                        this.setDefaultValue();
+                        this.initialOptionsEmpty = false;
+                    }
+                }
+            }
+            else {
+                if (!this.searchable) {
+                    this.options = this.noOptions || [];
+                }
+            }
         };
         /**
          * Processes the provided array of IcMenuOptions, removing duplicates and reporting them with a console.warn
@@ -102,8 +256,7 @@ export class Select {
          * Loop through options array and for all options with no value, infer it from the label
          */
         this.setOptionsValuesFromLabels = () => {
-            var _a;
-            if (((_a = this.options) === null || _a === void 0 ? void 0 : _a.length) > 0 && this.options.map) {
+            if (this.options.length > 0) {
                 this.options.map((option) => {
                     if (!option.value) {
                         option.value = option.label;
@@ -115,11 +268,13 @@ export class Select {
             this.ungroupedOptions = event.detail.options;
         };
         this.setTextColor = () => {
-            if (this.nativeSelectElement.selectedIndex === 0) {
-                this.nativeSelectElement.className = "placeholder";
-            }
-            else {
-                this.nativeSelectElement.className = "select-option-selected";
+            if (this.nativeSelectElement) {
+                if (this.nativeSelectElement.selectedIndex === 0) {
+                    this.nativeSelectElement.className = "placeholder";
+                }
+                else {
+                    this.nativeSelectElement.className = "select-option-selected";
+                }
             }
         };
         this.setMenuChange = (open) => {
@@ -130,41 +285,112 @@ export class Select {
         this.getLabelFromValue = (value) => {
             return getLabelFromValue(value, this.uniqueOptions);
         };
+        this.getMultipleOptionsString = (selectedValues) => {
+            const selectedLabels = selectedValues === null || selectedValues === void 0 ? void 0 : selectedValues.map((value) => this.getLabelFromValue(value)).filter((label) => !!label);
+            return selectedLabels === null || selectedLabels === void 0 ? void 0 : selectedLabels.join(", ");
+        };
         this.getFilteredChildMenuOptions = (option) => {
             let children = option.children;
-            if (this.searchable) {
-                children = getFilteredMenuOptions(option.children, this.includeDescriptionsInSearch, this.searchableSelectInputValue, this.searchMatchPosition);
-            }
-            else {
-                children = getFilteredMenuOptions(option.children, false, this.pressedCharacters, "start");
+            if (option.children) {
+                if (this.searchable) {
+                    children = getFilteredMenuOptions(option.children, !!this.includeDescriptionsInSearch, this.searchableSelectInputValue || "", this.searchMatchPosition);
+                }
+                else {
+                    children = getFilteredMenuOptions(option.children, false, this.pressedCharacters, "start");
+                }
             }
             const newOption = Object.assign({}, option);
             newOption.children = children;
             return newOption;
         };
+        // (For multi-select) get value array, i.e. selected option values, in order they appear in option list
+        this.getValueSortedByOptions = (value) => {
+            const valueArray = value;
+            const valuesFromAllOptions = this.ungroupedOptions.map((option) => option.value);
+            valueArray.sort((a, b) => valuesFromAllOptions.indexOf(a) - valuesFromAllOptions.indexOf(b));
+            return valueArray;
+        };
         this.handleNativeSelectChange = () => {
-            this.icOptionSelect.emit({ value: this.nativeSelectElement.value });
-            this.emitImmediateIcChange(this.nativeSelectElement.value);
+            if (this.nativeSelectElement) {
+                this.icOptionSelect.emit({ value: this.nativeSelectElement.value });
+                this.emitIcChange(this.nativeSelectElement.value);
+            }
             this.setTextColor();
         };
+        // Handle option select for when a custom input box and menu is rendered
+        // (rather than native <select> - rendered when viewed on a mobile / tablet screen)
         this.handleCustomSelectChange = (event) => {
-            if (this.searchable && event.detail.label === this.emptyOptionListText) {
-                this.searchableSelectElement.focus();
+            var _a, _b;
+            const value = event.detail.value;
+            if (event.detail.label === this.emptyOptionListText) {
+                (_a = this.searchableSelectElement) === null || _a === void 0 ? void 0 : _a.focus();
                 return;
             }
             if (this.searchable) {
-                this.value = event.detail.value;
+                this.value = value;
                 this.searchableMenuItemSelected = true;
                 // After editing the input, if selecting the same option as before, set the input value to label again
                 if (this.value === this.currValue) {
-                    this.searchableSelectInputValue = this.getLabelFromValue(this.value);
+                    this.searchableSelectInputValue =
+                        this.getLabelFromValue(this.value) || null;
                 }
                 this.inputValueToFilter = null;
-                this.hiddenInputValue = this.getValueFromLabel(this.searchableSelectInputValue);
+                this.hiddenInputValue =
+                    this.getValueFromLabel(this.searchableSelectInputValue) || null;
+            }
+            if (this.multiple && ((_b = this.value) === null || _b === void 0 ? void 0 : _b.includes(value))) {
+                this.icOptionDeselect.emit({ value });
+            }
+            else {
+                this.icOptionSelect.emit({ value });
             }
             this.ariaActiveDescendant = event.detail.optionId;
-            this.icOptionSelect.emit({ value: event.detail.value });
-            this.emitIcChange(event.detail.value);
+            this.emitIcChange(value);
+        };
+        // Update selected options - adds / removes them, in order of option list
+        // Create new array if value prop is undefined
+        this.handleMultipleSelectChange = (value) => {
+            if (this.value) {
+                let valueArray = this.value.slice();
+                if (this.value.includes(value)) {
+                    const valueIndex = valueArray.indexOf(value);
+                    valueArray.splice(valueIndex, 1);
+                }
+                else {
+                    valueArray.push(value);
+                    valueArray = this.getValueSortedByOptions(valueArray);
+                }
+                this.value = valueArray.length === 0 ? null : valueArray;
+            }
+            else {
+                const valueArray = [];
+                valueArray.push(value);
+                this.value = valueArray;
+            }
+        };
+        this.handleSelectAllChange = (event) => {
+            const selectAllOptions = event.detail.select;
+            const allEnabledOptions = this.ungroupedOptions.filter((option) => !option.disabled);
+            const allValues = allEnabledOptions.map((option) => option.value);
+            let newValue;
+            if (selectAllOptions) {
+                let unselectedValues;
+                // Only emit icOptionSelect for all values that are newly selected
+                if (this.value) {
+                    unselectedValues = allValues.filter((value) => this.value && !this.value.includes(value));
+                }
+                else {
+                    unselectedValues = allValues;
+                }
+                unselectedValues.forEach((value) => this.icOptionSelect.emit({ value }));
+                newValue = allValues;
+            }
+            else {
+                // Only emit icOptionDeselect for values that were selected
+                this.value.forEach((value) => this.icOptionDeselect.emit({ value }));
+                newValue = null;
+            }
+            this.emitIcChange(newValue);
         };
         this.handleMenuChange = (event) => {
             this.open = event.detail.open;
@@ -175,18 +401,20 @@ export class Select {
         // to prevent delay in change event, which should only occur when typing in input
         this.handleMenuKeyPress = (ev) => {
             ev.cancelBubble = true;
-            this.handleCharacterKeyDown(ev.detail.key);
-        };
-        this.handleMenuValueChange = (ev) => {
-            this.value = ev.detail.value;
+            if (!this.multiple) {
+                this.handleCharacterKeyDown(ev.detail.key);
+            }
         };
         this.handleFocusIndicatorDisplay = () => {
-            const focusIndicator = this.el.shadowRoot.querySelector(".focus-indicator");
-            if (this.open) {
-                focusIndicator.classList.add("focus-indicator-enabled");
-            }
-            else {
-                focusIndicator.classList.remove("focus-indicator-enabled");
+            var _a;
+            const focusIndicator = (_a = this.el.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(".focus-indicator");
+            if (focusIndicator) {
+                if (this.open) {
+                    focusIndicator.classList.add("focus-indicator-enabled");
+                }
+                else {
+                    focusIndicator.classList.remove("focus-indicator-enabled");
+                }
             }
         };
         this.handleMouseDown = (event) => {
@@ -194,10 +422,10 @@ export class Select {
                 event.preventDefault();
             }
         };
-        this.isExternalFiltering = () => this.searchable && this.disableAutoFiltering;
+        this.isExternalFiltering = () => this.searchable && !!this.disableAutoFiltering;
         this.handleClick = (event) => {
-            var _a;
-            if (!this.open) {
+            var _a, _b;
+            if (!this.open && this.menu) {
                 if (this.isExternalFiltering()) {
                     this.menu.options = this.filteredOptions;
                 }
@@ -210,50 +438,47 @@ export class Select {
                 }
             }
             if (event.detail !== 0) {
-                this.menu.handleClickOpen();
+                (_b = this.menu) === null || _b === void 0 ? void 0 : _b.handleClickOpen();
             }
         };
         this.handleExpandIconMouseDown = (event) => {
+            var _a;
             if (!this.disabled) {
                 event.preventDefault();
-                this.searchableSelectElement.focus();
+                (_a = this.searchableSelectElement) === null || _a === void 0 ? void 0 : _a.focus();
                 this.handleClick(event);
             }
         };
         this.handleClear = (event) => {
+            var _a, _b;
             event.stopPropagation();
             this.hasTimedOut = false;
             clearTimeout(this.timeoutTimer);
-            this.noOptions = null;
-            this.emitImmediateIcChange(null);
+            this.clearInput();
+            this.emitIcChange(null);
             this.icClear.emit();
             if (this.searchable) {
-                this.searchableSelectElement.value = null;
-                this.searchableSelectInputValue = null;
-                this.filteredOptions = this.uniqueOptions;
                 this.hiddenInputValue = null;
-                this.searchableSelectElement.focus();
+                (_a = this.searchableSelectElement) === null || _a === void 0 ? void 0 : _a.focus();
             }
             else {
-                this.customSelectElement.focus();
+                (_b = this.customSelectElement) === null || _b === void 0 ? void 0 : _b.focus();
             }
         };
         this.handleCharacterKeyDown = (key) => {
             // Only close menu when space is pressed if not being used alongside character keys to quickly select options
-            if (this.open &&
-                key === " " &&
-                this.pressedCharacters.length === 0 &&
-                !this.hasTimedOut &&
-                !this.loading) {
+            if (this.open && key === " " && this.pressedCharacters.length === 0) {
                 this.setMenuChange(false);
             }
             if (key.length === 1 && !this.searchable) {
                 window.clearTimeout(this.characterKeyPressTimer);
                 this.characterKeyPressTimer = window.setTimeout(() => (this.pressedCharacters = ""), 1000);
-                this.pressedCharacters += key;
-                this.handleFilter();
-                if (!this.noOptions) {
-                    this.emitImmediateIcChange(this.filteredOptions[0].value);
+                if (!(key === " " && !this.pressedCharacters)) {
+                    this.pressedCharacters += key;
+                    this.handleFilter();
+                    if (!this.noOptions) {
+                        this.emitIcChange(this.filteredOptions[0].value);
+                    }
                 }
             }
             else {
@@ -267,11 +492,12 @@ export class Select {
             this.handleCharacterKeyDown(event.key);
         };
         this.handleKeyDown = (event) => {
+            var _a;
             if ((event.key !== "Escape" && event.key !== "Tab") || this.open) {
                 event.cancelBubble = true;
             }
             const isArrowKey = event.key === "ArrowDown" || event.key === "ArrowUp";
-            if (!this.open) {
+            if (this.menu && !this.open) {
                 if (this.isExternalFiltering() && (event.key === "Enter" || isArrowKey)) {
                     this.menu.options = this.filteredOptions;
                 }
@@ -289,9 +515,11 @@ export class Select {
                 if (!(isArrowKey && this.noOptions !== null)) {
                     if (!(event.key === " " && this.pressedCharacters.length > 0)) {
                         // Keyboard events get passed onto ic-menu
-                        this.menu.handleKeyboardOpen(event);
+                        (_a = this.menu) === null || _a === void 0 ? void 0 : _a.handleKeyboardOpen(event);
+                    }
+                    if (!this.multiple) {
+                        this.handleCharacterKeyDown(event.key);
                     }
-                    this.handleCharacterKeyDown(event.key);
                 }
             }
         };
@@ -320,7 +548,7 @@ export class Select {
             });
             let menuOptionsFiltered;
             if (this.searchable) {
-                menuOptionsFiltered = getFilteredMenuOptions(options, this.includeDescriptionsInSearch, this.inputValueToFilter, this.searchMatchPosition);
+                menuOptionsFiltered = getFilteredMenuOptions(options, !!this.includeDescriptionsInSearch, this.inputValueToFilter || "", this.searchMatchPosition);
                 this.searchableMenuItemSelected = false;
             }
             else {
@@ -349,7 +577,7 @@ export class Select {
             if (isGrouped) {
                 noChildOptionsWhenFiltered = true;
                 newFilteredOptions.map((option) => {
-                    if (option.children.length > 0) {
+                    if (option.children && option.children.length > 0) {
                         noChildOptionsWhenFiltered = false;
                     }
                 });
@@ -391,13 +619,18 @@ export class Select {
         };
         this.getValueFromLabel = (label) => {
             var _a;
-            return (_a = this.uniqueOptions.find((option) => option.label === label)) === null || _a === void 0 ? void 0 : _a.value;
+            return (label &&
+                ((_a = this.uniqueOptions.find((option) => option.label === label)) === null || _a === void 0 ? void 0 : _a.value));
         };
         this.handleSearchableSelectInput = (event) => {
             this.searchableSelectInputValue = event.target.value;
-            this.icInput.emit({ value: this.searchableSelectInputValue });
-            this.emitIcChange(this.searchableSelectInputValue);
-            this.hiddenInputValue = this.searchableSelectInputValue;
+            this.emitIcInput(this.searchableSelectInputValue);
+            // De-select previous selection when input is edited
+            // Only emit icChange once when editing input
+            if (this.value != null) {
+                this.emitIcChange(null);
+            }
+            this.hiddenInputValue = null;
             this.inputValueToFilter = this.searchableSelectInputValue;
             this.setMenuChange(true);
             if (!this.disableAutoFiltering) {
@@ -406,7 +639,8 @@ export class Select {
             }
         };
         this.updateSearchableSelectResultAriaLive = () => {
-            const searchableSelectResultsStatusEl = this.el.shadowRoot.querySelector(".searchable-select-results-status");
+            var _a;
+            const searchableSelectResultsStatusEl = (_a = this.el.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(".searchable-select-results-status");
             if (searchableSelectResultsStatusEl) {
                 if (this.noOptions !== null) {
                     searchableSelectResultsStatusEl.innerText = this.emptyOptionListText;
@@ -416,7 +650,25 @@ export class Select {
                 }
             }
         };
-        this.getDefaultValue = (value) => this.getLabelFromValue(value) || value || null;
+        this.updateMultiSelectedCountAriaLive = () => {
+            var _a, _b;
+            const multiSelectSelectedCountEl = (_a = this.el.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(".multi-select-selected-count");
+            const selectedCount = `${(_b = this.currValue) === null || _b === void 0 ? void 0 : _b.length} of ${getOptionsWithoutGroupTitlesCount(this.options)} selected`;
+            if (multiSelectSelectedCountEl &&
+                multiSelectSelectedCountEl.innerText !== selectedCount) {
+                multiSelectSelectedCountEl.innerText = selectedCount;
+            }
+        };
+        this.getDefaultValue = (value) => this.getLabelFromValue(value) || null;
+        this.setDefaultValue = () => {
+            if (!this.hasSetDefaultValue && this.currValue) {
+                this.searchableSelectInputValue = this.searchable
+                    ? this.getDefaultValue(this.currValue)
+                    : null;
+                this.initialValue = this.currValue;
+                this.hasSetDefaultValue = true;
+            }
+        };
         this.onFocus = () => {
             this.icFocus.emit();
         };
@@ -438,6 +690,10 @@ export class Select {
             if (isSearchableAndNoFocusedInternalElements) {
                 if (!this.retryButtonClick) {
                     this.setMenuChange(false);
+                    // Clear input field on blur when searchable if no option is selected
+                    if (!this.value) {
+                        this.clearInput();
+                    }
                 }
                 this.handleFocusIndicatorDisplay();
             }
@@ -461,98 +717,46 @@ export class Select {
                 this.hiddenInputValue = this.value;
             }
         };
-        this.ariaActiveDescendant = undefined;
-        this.clearButtonFocused = false;
-        this.debounceIcChange = undefined;
-        this.hiddenInputValue = undefined;
-        this.noOptions = null;
-        this.open = false;
-        this.pressedCharacters = "";
-        this.searchableSelectInputValue = null;
-        this.disabled = false;
-        this.disableAutoFiltering = false;
-        this.emptyOptionListText = "No results found";
-        this.form = undefined;
-        this.fullWidth = false;
-        this.helperText = "";
-        this.hideLabel = false;
-        this.includeDescriptionsInSearch = false;
-        this.includeGroupTitlesInSearch = false;
-        this.label = undefined;
-        this.loadingErrorLabel = "Loading Error";
-        this.loadingLabel = "Loading...";
-        this.name = this.inputId;
-        this.placeholder = "Select an option";
-        this.readonly = false;
-        this.required = false;
-        this.searchable = false;
-        this.searchMatchPosition = "anywhere";
-        this.selectOnEnter = false;
-        this.showClearButton = false;
-        this.size = "default";
-        this.timeout = undefined;
-        this.validationStatus = "";
-        this.validationText = "";
-        this.loading = false;
-        this.options = [];
-        this.filteredOptions = this.options;
-        this.uniqueOptions = this.options;
-        this.debounce = 0;
-        this.currDebounce = this.debounce;
-        this.value = undefined;
-        this.initialValue = this.value;
-        this.inputValueToFilter = this.value;
-        this.currValue = this.value;
+        this.clearInput = () => {
+            var _a;
+            this.noOptions = null;
+            if (this.searchable) {
+                (_a = this.searchableSelectElement) === null || _a === void 0 ? void 0 : _a.setAttribute("value", "");
+                this.searchableSelectInputValue = null;
+                this.filteredOptions = this.uniqueOptions;
+            }
+        };
+    }
+    watchDisabledHandler() {
+        removeDisabledFalse(this.disabled, this.el);
     }
     loadingHandler(newValue) {
-        newValue && this.triggerLoading();
+        newValue ? this.triggerLoading() : this.setOptions();
     }
     watchOptionsHandler() {
-        var _a;
-        if (!this.hasTimedOut) {
-            this.loading = false;
-            clearTimeout(this.timeoutTimer);
-            if (this.isExternalFiltering()) {
-                if (((_a = this.options) === null || _a === void 0 ? void 0 : _a.length) > 0) {
-                    this.setOptionsValuesFromLabels();
-                    this.noOptions = null;
-                    this.uniqueOptions = this.deduplicateOptions(this.options);
-                    this.filteredOptions = this.uniqueOptions;
-                }
-                else {
-                    this.noOptions = [{ label: this.emptyOptionListText, value: "" }];
-                    this.uniqueOptions = this.noOptions;
-                    this.filteredOptions = this.noOptions;
-                }
-                this.updateSearchableSelectResultAriaLive();
-                this.setDefaultValue();
-            }
-            else {
-                this.setOptionsValuesFromLabels();
-                this.uniqueOptions = this.deduplicateOptions(this.options);
-                this.filteredOptions = this.uniqueOptions;
-                if (this.initialOptionsEmpty) {
-                    this.setDefaultValue();
-                    this.initialOptionsEmpty = false;
-                }
-            }
-        }
-        else {
-            if (!this.searchable) {
-                this.options = this.noOptions;
-            }
-        }
+        this.setOptions();
     }
     debounceChangedHandler(newValue) {
         this.updateOnChangeDebounce(newValue);
     }
     valueChangedHandler() {
         if (this.value !== this.currValue) {
-            this.currValue = this.value;
+            if (this.value && this.multiple) {
+                this.currValue = this.getMultipleOptionsString(this.value)
+                    ? this.getValueSortedByOptions(this.value)
+                    : null;
+                this.updateMultiSelectedCountAriaLive();
+            }
+            else {
+                this.currValue = this.getLabelFromValue(this.value)
+                    ? this.value
+                    : null;
+            }
         }
-        if (this.searchable) {
+        if (this.searchable && this.value) {
+            // Only set if value not null - prevents whole input value being cleared when edited
             this.searchableSelectInputValue =
-                this.getLabelFromValue(this.currValue) || this.currValue;
+                this.getLabelFromValue(String(this.currValue)) || null;
         }
     }
     openChangedHandler() {
@@ -564,12 +768,15 @@ export class Select {
         (_a = this.hostMutationObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
     }
     componentWillLoad() {
-        var _a;
+        const valueInOptions = this.multiple
+            ? this.getMultipleOptionsString(this.value)
+            : this.getLabelFromValue(this.value);
+        this.currValue = valueInOptions ? this.value : null;
         this.inheritedAttributes = inheritAttributes(this.el, MUTABLE_ATTRIBUTES);
         removeDisabledFalse(this.disabled, this.el);
         this.setOptionsValuesFromLabels();
         addFormResetListener(this.el, this.handleFormReset);
-        if (!((_a = this.options) === null || _a === void 0 ? void 0 : _a.length)) {
+        if (!this.options.length) {
             this.initialOptionsEmpty = true;
             this.noOptions = [{ label: this.emptyOptionListText, value: "" }];
             this.uniqueOptions = this.noOptions;
@@ -585,7 +792,9 @@ export class Select {
         if (this.loading) {
             this.triggerLoading();
         }
-        this.hiddenInputValue = this.searchable && this.currValue;
+        if (this.searchable) {
+            this.hiddenInputValue = this.currValue;
+        }
         this.hostMutationObserver = new MutationObserver(this.hostMutationCallback);
         this.hostMutationObserver.observe(this.el, {
             attributes: true,
@@ -622,64 +831,72 @@ export class Select {
             this.updateSearchableSelectResultAriaLive();
         }, 800);
     }
-    setDefaultValue() {
-        if (!this.hasSetDefaultValue && this.currValue) {
-            this.searchableSelectInputValue = this.getDefaultValue(this.currValue);
-            this.initialValue = this.currValue;
-            this.hasSetDefaultValue = true;
-        }
-    }
     render() {
-        const { size, disabled, fullWidth, helperText, hideLabel, label, menuId, name, options, placeholder, readonly, required, searchable, showClearButton, validationStatus, validationText, currValue, } = this;
-        renderHiddenInput(true, this.el, name, this.searchable ? this.hiddenInputValue : currValue, disabled);
-        const invalid = validationStatus === IcInformationStatus.Error ? "true" : "false";
-        const describedBy = getInputDescribedByText(this.inputId, helperText !== "", hasValidationStatus(this.validationStatus, this.disabled)).trim();
+        const { size, disabled, fullWidth, helperText, hideLabel, label, menuId, multiple, name, options, placeholder, readonly, required, searchable, showClearButton, validationStatus, validationText, currValue, theme, } = this;
+        // HTML inputs only accept 'string' for their value
+        // Does not cause errors when it is a multi-select - sets value correctly, to a comma-separated string
+        renderHiddenInput(true, this.el, name || this.inputId, this.searchable ? this.hiddenInputValue : currValue, disabled);
+        const invalid = `${validationStatus === IcInformationStatus.Error}`;
+        const describedBy = getInputDescribedByText(this.inputId, helperText !== "", hasValidationStatus(this.validationStatus, !!this.disabled)).trim();
         let showLeftIcon = !!this.el.querySelector(`[slot="icon"]`);
         if (showLeftIcon && (disabled || (readonly && !this.value))) {
             showLeftIcon = false;
         }
-        return (h(Host, { class: {
-                ["ic-select-disabled"]: disabled,
-                ["ic-select-searchable"]: searchable,
-                [`ic-select-${size}`]: size !== "default",
-                ["ic-select-full-width"]: fullWidth,
-            }, onBlur: this.onBlur }, h("ic-input-container", { readonly: readonly }, !hideLabel && (h("ic-input-label", { for: this.inputId, label: label, helperText: helperText, required: required, disabled: disabled, readonly: readonly })), h("ic-input-component-container", { ref: (el) => (this.anchorEl = el), class: { "menu-open": this.open }, size: size, fullWidth: fullWidth, disabled: disabled, readonly: readonly, validationStatus: validationStatus }, showLeftIcon && (h("span", { slot: "left-icon", class: {
-                ["readonly"]: readonly,
+        const optionsSelectedCount = `${currValue === null || currValue === void 0 ? void 0 : currValue.length} of ${getOptionsWithoutGroupTitlesCount(this.options)} selected`;
+        const valueLabelString = multiple
+            ? this.getMultipleOptionsString(currValue)
+            : this.getLabelFromValue(currValue);
+        const isClearable = !disabled &&
+            (searchable
+                ? this.searchableSelectInputValue
+                : currValue && !this.loading && showClearButton);
+        return (h(Host, { key: '75cf0d014983dd89d440f68080f01333e6c265ee', class: {
+                "ic-select-disabled": !!disabled,
+                "ic-select-searchable": !!searchable,
+                [`ic-select-${size}`]: size !== "medium",
+                "ic-select-full-width": !!fullWidth,
+                [`ic-theme-${theme}`]: theme !== "inherit",
+            }, onBlur: this.onBlur }, h("ic-input-container", { key: 'eb714cd9445894ca8fd3be546308f19f32d1b54c', readonly: readonly }, !hideLabel && (h("ic-input-label", { key: 'b458a202cdce6dcfad3d92da57714aa44f73d886', for: this.inputId, label: label, helperText: helperText, required: required, disabled: disabled, readonly: readonly })), h("ic-input-component-container", { key: '4ac767a175604d7e4f86fa46945fc028be835ff2', ref: (el) => (this.anchorEl = el), class: { "menu-open": this.open }, size: size, fullWidth: fullWidth, disabled: disabled, readonly: readonly, validationStatus: validationStatus }, showLeftIcon && (h("span", { key: '7ac05ef11cda6c03db0b1b9f4573a704581524e0', slot: "left-icon", class: {
+                ["readonly"]: !!readonly,
                 ["has-value"]: !!this.value,
-            } }, h("slot", { name: "icon" }))), readonly ? (h("ic-typography", null, h("p", null, this.getLabelFromValue(currValue)))) : isMobileOrTablet() ? (h("select", Object.assign({ ref: (el) => (this.nativeSelectElement = el), disabled: disabled, onChange: this.handleNativeSelectChange, required: required, id: this.inputId, "aria-label": label, "aria-describedby": describedBy, "aria-invalid": invalid, onBlur: this.onBlur, onFocus: this.onFocus, onKeyDown: this.handleNativeSelectKeyDown, form: this.form }, this.inheritedAttributes), h("option", { value: "", selected: true, disabled: !showClearButton }, placeholder), options.map((option) => {
+            } }, h("slot", { key: 'f09cffc377cfe7eb76d1b8bc4c83ec632a99b2df', name: "icon" }))), readonly ? (h("ic-typography", null, h("p", null, valueLabelString))) : isMobileOrTablet() && !multiple ? (h("select", Object.assign({ ref: (el) => (this.nativeSelectElement = el), disabled: disabled, onChange: this.handleNativeSelectChange, required: required, id: this.inputId, "aria-label": label, "aria-describedby": describedBy, "aria-invalid": invalid, onBlur: this.onBlur, onFocus: this.onFocus, onKeyDown: this.handleNativeSelectKeyDown, form: this.form }, this.inheritedAttributes), h("option", { value: "", selected: true, disabled: !showClearButton }, placeholder), options.map((option) => {
             if (option.children) {
                 return (h("optgroup", { label: option.label }, option.children.map((option) => (h("option", { value: option.value, disabled: option.disabled, selected: option.value === currValue }, option.label)))));
             }
             else {
                 return (h("option", { value: option.value, disabled: option.disabled, selected: option.value === currValue }, option.label));
             }
-        }))) : searchable ? (h("div", { class: "searchable-select-container" }, h("input", { class: "select-input", role: "combobox", autocomplete: "off", "aria-label": label, "aria-describedby": describedBy, "aria-activedescendant": this.ariaActiveDescendant, "aria-autocomplete": "list", "aria-expanded": this.open ? "true" : "false", "aria-invalid": invalid, "aria-required": required ? "true" : "false", "aria-controls": menuId, ref: (el) => (this.searchableSelectElement = el), id: this.inputId, value: this.searchableSelectInputValue, placeholder: placeholder, disabled: disabled, onInput: this.handleSearchableSelectInput, onClick: this.handleClick, onKeyDown: this.handleKeyDown, onFocus: this.onFocus, onBlur: this.onBlur, form: this.form }), this.searchableSelectInputValue &&
-            (showClearButton || searchable) && (h("div", { class: "clear-button-container" }, h("ic-button", { id: "clear-button", ref: (el) => (this.clearButton = el), "aria-label": this.searchableSelectInputValue && currValue === null
+        }))) : searchable ? (h("div", { class: "searchable-select-container" }, h("input", { class: {
+                "select-input": true,
+                "with-clear-button": !!this.searchableSelectInputValue,
+            }, role: "combobox", autocomplete: "off", "aria-label": label, "aria-describedby": describedBy, "aria-activedescendant": this.ariaActiveDescendant, "aria-autocomplete": "list", "aria-expanded": `${this.open}`, "aria-invalid": invalid, "aria-required": `${required}`, "aria-controls": menuId, ref: (el) => (this.searchableSelectElement = el), id: this.inputId, value: this.searchableSelectInputValue || undefined, placeholder: placeholder, disabled: disabled, onInput: this.handleSearchableSelectInput, onClick: this.handleClick, onKeyDown: this.handleKeyDown, onFocus: this.onFocus, onBlur: this.onBlur, form: this.form }), isClearable && (h("div", { class: "clear-button-container" }, h("ic-button", { id: "clear-button", ref: (el) => (this.clearButton = el), "aria-label": this.searchableSelectInputValue &&
+                (currValue === null || this.loading)
                 ? "Clear input"
-                : "Clear selection", class: "clear-button", innerHTML: Clear, onClick: this.handleClear, onFocus: this.handleClearButtonFocus, onBlur: this.handleClearButtonBlur, size: size, variant: "icon", appearance: this.clearButtonFocused
-                ? IcThemeForegroundEnum.Light
-                : IcThemeForegroundEnum.Dark }), h("div", { class: "divider" }))), h("span", { onMouseDown: this.handleExpandIconMouseDown, class: {
+                : "Clear selection", class: "clear-button", innerHTML: Clear, onClick: this.handleClear, onFocus: this.handleClearButtonFocus, onBlur: this.handleClearButtonBlur, size: size, variant: "icon", theme: this.clearButtonFocused ? "light" : "dark" }), h("div", { class: "divider" }))), h("span", { onMouseDown: this.handleExpandIconMouseDown, class: {
                 "expand-icon": true,
                 "expand-icon-open": this.open,
-                "expand-icon-filled": !(currValue == null || currValue === ""),
-            }, innerHTML: Expand, "aria-hidden": "true" }), h("div", { "aria-live": "polite", role: "status", class: "searchable-select-results-status" }))) : (h("div", { class: "select-container" }, h("button", { class: "select-input", ref: (el) => (this.customSelectElement = el), id: this.inputId, "aria-label": `${label}, ${this.getLabelFromValue(currValue) || placeholder}${required ? ", required" : ""}`, "aria-describedby": describedBy, "aria-invalid": invalid, "aria-haspopup": "listbox", "aria-expanded": this.open ? "true" : "false", "aria-owns": menuId, "aria-controls": menuId, disabled: disabled, onBlur: this.onBlur, onFocus: this.onFocus, onClick: this.handleClick, onMouseDown: this.handleMouseDown, onKeyDown: this.handleKeyDown }, h("ic-typography", { variant: "body", class: {
+            }, innerHTML: Expand, "aria-hidden": "true" }), h("div", { "aria-live": "polite", role: "status", class: "searchable-select-results-status" }))) : (h("div", { class: "select-container" }, h("button", { class: "select-input", ref: (el) => (this.customSelectElement = el), id: this.inputId, "aria-label": `${label}, ${(multiple && currValue
+                ? `${optionsSelectedCount}, ${valueLabelString}`
+                : valueLabelString) || placeholder}${required ? ", required" : ""}`, "aria-describedby": describedBy, "aria-invalid": invalid, "aria-haspopup": "listbox", "aria-expanded": this.open ? "true" : "false", "aria-owns": menuId, "aria-controls": menuId, disabled: disabled, onBlur: this.onBlur, onFocus: this.onFocus, onClick: this.handleClick, onMouseDown: this.handleMouseDown, onKeyDown: this.handleKeyDown }, h("ic-typography", { variant: "body", class: {
                 "value-text": true,
-                placeholder: this.getLabelFromValue(currValue) === undefined,
-            } }, this.getLabelFromValue(currValue) || placeholder), h("div", { class: "select-input-end" }, currValue && showClearButton && (h("div", { class: "divider" })), h("span", { class: {
+                "with-clear-button": !!isClearable,
+                placeholder: !this.loading && multiple
+                    ? !this.value || this.value.length < 1
+                    : !this.getLabelFromValue(currValue),
+            } }, valueLabelString || placeholder), h("div", { class: "select-input-end" }, isClearable && h("div", { class: "divider" }), h("span", { class: {
                 "expand-icon": true,
                 "expand-icon-open": this.open,
-                "expand-icon-filled": !(currValue == null || currValue === ""),
-            }, innerHTML: Expand, "aria-hidden": "true" }))), currValue && showClearButton && (h("ic-button", { id: "clear-button", "aria-label": "Clear selection", class: "clear-button", innerHTML: Clear, onClick: this.handleClear, onFocus: this.handleClearButtonFocus, onBlur: this.handleClearButtonBlur, size: size, variant: "icon", appearance: this.clearButtonFocused
-                ? IcThemeForegroundEnum.Light
-                : IcThemeForegroundEnum.Dark }))))), !isMobileOrTablet() && (h("ic-menu", { class: {
+            }, innerHTML: Expand, "aria-hidden": "true" }))), isClearable && (h("ic-button", { id: "clear-button", "aria-label": "Clear selection", class: "clear-button", innerHTML: Clear, onClick: this.handleClear, onFocus: this.handleClearButtonFocus, onBlur: this.handleClearButtonBlur, size: size, variant: "icon", theme: this.clearButtonFocused ? "light" : "dark" }))))), (!isMobileOrTablet() || multiple) && (h("ic-menu", { key: '60dac9f71d9787ae401f439dbcd013365c33b713', class: {
                 "no-results": this.loading ||
                     this.hasTimedOut ||
                     (this.noOptions !== null &&
                         this.noOptions[0] &&
                         this.noOptions[0].label === this.emptyOptionListText),
-            }, ref: (el) => (this.menu = el), inputEl: searchable
+            }, ref: (el) => (this.menu = el), inputEl: (searchable
                 ? this.searchableSelectElement
-                : this.customSelectElement, inputLabel: label, anchorEl: this.anchorEl, size: size, menuId: menuId, open: this.open, options: searchable ? this.filteredOptions : this.uniqueOptions, value: currValue, fullWidth: fullWidth, selectOnEnter: this.selectOnEnter, onMenuStateChange: this.handleMenuChange, onMenuOptionSelect: this.handleCustomSelectChange, onMenuKeyPress: this.handleMenuKeyPress, onMenuValueChange: this.handleMenuValueChange, onUngroupedOptionsSet: this.setUngroupedOptions, onRetryButtonClicked: this.handleRetry, parentEl: this.el, onTimeoutBlur: this.onTimeoutBlur, activationType: this.searchable || this.selectOnEnter ? "manual" : "automatic" })), hasValidationStatus(this.validationStatus, this.disabled) && (h("ic-input-validation", { class: { "menu-open": this.open }, ariaLiveMode: "polite", status: validationStatus, message: validationText, for: this.inputId })))));
+                : this.customSelectElement), inputLabel: label, anchorEl: this.anchorEl, size: size, menuId: menuId, open: this.open, options: searchable ? this.filteredOptions : this.uniqueOptions, value: multiple ? currValue : currValue, fullWidth: fullWidth, selectOnEnter: this.selectOnEnter, onMenuStateChange: this.handleMenuChange, onMenuOptionSelect: this.handleCustomSelectChange, onMenuOptionSelectAll: this.handleSelectAllChange, onMenuKeyPress: this.handleMenuKeyPress, onUngroupedOptionsSet: this.setUngroupedOptions, onRetryButtonClicked: this.handleRetry, parentEl: this.el, onTimeoutBlur: this.onTimeoutBlur, activationType: this.searchable || multiple || this.selectOnEnter
+                ? "manual"
+                : "automatic", closeOnSelect: !multiple })), this.multiple && (h("div", { key: '876f1da870c48b21130b246afa988c4fccefdfc6', "aria-live": "polite", role: "status", class: "multi-select-selected-count" })), hasValidationStatus(this.validationStatus, !!this.disabled) && (h("ic-input-validation", { key: '657c2433a3ab425432356227e931cafe4268dd8b', class: { "menu-open": this.open }, ariaLiveMode: "polite", status: validationStatus, message: validationText || "", for: this.inputId })))));
     }
     static get is() { return "ic-select"; }
     static get encapsulation() { return "shadow"; }
@@ -701,7 +918,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -710,6 +927,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, the disabled state will be set."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "disabled",
                 "reflect": true,
                 "defaultValue": "false"
@@ -719,7 +938,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -728,6 +947,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, the built in filtering will be disabled for a searchable variant. For example, if options will already be filtered from external source."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "disable-auto-filtering",
                 "reflect": false,
                 "defaultValue": "false"
@@ -737,15 +958,17 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
                     "text": "The text displayed when there are no options in the option list."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "empty-option-list-text",
                 "reflect": false,
                 "defaultValue": "\"No results found\""
@@ -755,7 +978,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -764,6 +987,8 @@ export class Select {
                     "tags": [],
                     "text": "The <form> element to associate the select with."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "form",
                 "reflect": false
             },
@@ -772,15 +997,17 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "If `true`, the select element will fill the width of the container. This prop should only be used with searchable select and will only be applied if searchable is true."
+                    "text": "If `true`, the select will fill the width of the container."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "full-width",
                 "reflect": false,
                 "defaultValue": "false"
@@ -790,7 +1017,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -799,6 +1026,8 @@ export class Select {
                     "tags": [],
                     "text": "The helper text that will be displayed for additional field guidance."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "helper-text",
                 "reflect": false,
                 "defaultValue": "\"\""
@@ -808,7 +1037,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -817,6 +1046,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, the label will be hidden and the required label value will be applied as an aria-label."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "hide-label",
                 "reflect": false,
                 "defaultValue": "false"
@@ -826,7 +1057,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -835,6 +1066,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, descriptions of options will be included when filtering options in a searchable select. Only applies to built in filtering."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "include-descriptions-in-search",
                 "reflect": false,
                 "defaultValue": "false"
@@ -844,7 +1077,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -853,6 +1086,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, group titles of grouped options will be included when filtering options in a searchable select. Only applies to built in filtering."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "include-group-titles-in-search",
                 "reflect": false,
                 "defaultValue": "false"
@@ -871,6 +1106,8 @@ export class Select {
                     "tags": [],
                     "text": "The label for the select."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "label",
                 "reflect": false
             },
@@ -879,7 +1116,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -888,6 +1125,8 @@ export class Select {
                     "tags": [],
                     "text": "The message displayed when external loading times out."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "loading-error-label",
                 "reflect": false,
                 "defaultValue": "\"Loading Error\""
@@ -897,7 +1136,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -906,16 +1145,38 @@ export class Select {
                     "tags": [],
                     "text": "The message displayed whilst the options are being loaded externally."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "loading-label",
                 "reflect": false,
                 "defaultValue": "\"Loading...\""
             },
+            "multiple": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "If `true`, multiple options can be selected."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "multiple",
+                "reflect": false,
+                "defaultValue": "false"
+            },
             "name": {
                 "type": "string",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -924,6 +1185,8 @@ export class Select {
                     "tags": [],
                     "text": "The name of the control, which is submitted with the form data."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "name",
                 "reflect": false,
                 "defaultValue": "this.inputId"
@@ -933,7 +1196,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -942,6 +1205,8 @@ export class Select {
                     "tags": [],
                     "text": "The placeholder value to be displayed."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "placeholder",
                 "reflect": false,
                 "defaultValue": "\"Select an option\""
@@ -951,7 +1216,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -960,6 +1225,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, the readonly state will be set."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "readonly",
                 "reflect": false,
                 "defaultValue": "false"
@@ -969,7 +1236,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -978,6 +1245,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, the select will require a value."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "required",
                 "reflect": false,
                 "defaultValue": "false"
@@ -987,15 +1256,17 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "If `true`, a searchable variant of the select will be displayed which can be typed in to filter options."
+                    "text": "If `true`, a searchable variant of the select will be displayed which can be typed in to filter options. This functionality is only available on the single-select variant of the select component."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "searchable",
                 "reflect": false,
                 "defaultValue": "false"
@@ -1005,7 +1276,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "IcSearchMatchPositions",
-                    "resolved": "\"anywhere\" | \"start\"",
+                    "resolved": "\"anywhere\" | \"start\" | undefined",
                     "references": {
                         "IcSearchMatchPositions": {
                             "location": "import",
@@ -1020,6 +1291,8 @@ export class Select {
                     "tags": [],
                     "text": "Whether the search string of the searchable select should match the start of or anywhere in the options. Only applies to built in filtering."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "search-match-position",
                 "reflect": false,
                 "defaultValue": "\"anywhere\""
@@ -1029,15 +1302,17 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "If `true`, the icOptionSelect event will be fired on enter instead of ArrowUp and ArrowDown."
+                    "text": "If `true`, the icOptionSelect event will be fired on enter instead of ArrowUp and ArrowDown on the single select."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "select-on-enter",
                 "reflect": false,
                 "defaultValue": "false"
@@ -1047,7 +1322,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -1056,6 +1331,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, a button which clears the select input when clicked will be displayed. The button will always appear on the searchable select."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "show-clear-button",
                 "reflect": false,
                 "defaultValue": "false"
@@ -1065,7 +1342,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "IcSizes",
-                    "resolved": "\"default\" | \"large\" | \"small\"",
+                    "resolved": "\"large\" | \"medium\" | \"small\" | undefined",
                     "references": {
                         "IcSizes": {
                             "location": "import",
@@ -1078,18 +1355,20 @@ export class Select {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "The size of the select component."
+                    "text": "The size of the select."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "size",
                 "reflect": false,
-                "defaultValue": "\"default\""
+                "defaultValue": "\"medium\""
             },
             "timeout": {
                 "type": "number",
                 "mutable": false,
                 "complexType": {
                     "original": "number",
-                    "resolved": "number",
+                    "resolved": "number | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -1098,15 +1377,43 @@ export class Select {
                     "tags": [],
                     "text": "If using external filtering, set a timeout for when loading takes too long."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "timeout",
                 "reflect": false
             },
+            "theme": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "IcThemeMode",
+                    "resolved": "\"dark\" | \"inherit\" | \"light\" | undefined",
+                    "references": {
+                        "IcThemeMode": {
+                            "location": "import",
+                            "path": "../../utils/types",
+                            "id": "src/utils/types.ts::IcThemeMode"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Sets the theme color to the dark or light theme color. \"inherit\" will set the color based on the system settings or ic-theme component."
+                },
+                "getter": false,
+                "setter": false,
+                "attribute": "theme",
+                "reflect": false,
+                "defaultValue": "\"inherit\""
+            },
             "validationStatus": {
                 "type": "string",
                 "mutable": false,
                 "complexType": {
                     "original": "IcInformationStatusOrEmpty",
-                    "resolved": "\"\" | \"error\" | \"success\" | \"warning\"",
+                    "resolved": "\"\" | \"error\" | \"success\" | \"warning\" | undefined",
                     "references": {
                         "IcInformationStatusOrEmpty": {
                             "location": "import",
@@ -1121,6 +1428,8 @@ export class Select {
                     "tags": [],
                     "text": "The validation status - e.g. 'error' | 'warning' | 'success'."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "validation-status",
                 "reflect": false,
                 "defaultValue": "\"\""
@@ -1130,7 +1439,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "string",
-                    "resolved": "string",
+                    "resolved": "string | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -1139,6 +1448,8 @@ export class Select {
                     "tags": [],
                     "text": "The text to display as the validation message."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "validation-text",
                 "reflect": false,
                 "defaultValue": "\"\""
@@ -1148,7 +1459,7 @@ export class Select {
                 "mutable": true,
                 "complexType": {
                     "original": "boolean",
-                    "resolved": "boolean",
+                    "resolved": "boolean | undefined",
                     "references": {}
                 },
                 "required": false,
@@ -1157,6 +1468,8 @@ export class Select {
                     "tags": [],
                     "text": "If `true`, the loading state will be triggered when fetching options asynchronously."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "loading",
                 "reflect": false,
                 "defaultValue": "false"
@@ -1166,7 +1479,7 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "IcMenuOption[]",
-                    "resolved": "IcMenuOption[]",
+                    "resolved": "IcMenuOption[] | undefined",
                     "references": {
                         "IcMenuOption": {
                             "location": "import",
@@ -1181,6 +1494,8 @@ export class Select {
                     "tags": [],
                     "text": "The possible selection options."
                 },
+                "getter": false,
+                "setter": false,
                 "defaultValue": "[]"
             },
             "debounce": {
@@ -1188,15 +1503,17 @@ export class Select {
                 "mutable": false,
                 "complexType": {
                     "original": "number",
-                    "resolved": "number",
+                    "resolved": "number | undefined",
                     "references": {}
                 },
                 "required": false,
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "The amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke."
+                    "text": "The amount of time, in milliseconds, to wait to trigger the `icInput` event after each keystroke."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "debounce",
                 "reflect": false,
                 "defaultValue": "0"
@@ -1205,16 +1522,18 @@ export class Select {
                 "type": "string",
                 "mutable": true,
                 "complexType": {
-                    "original": "string",
-                    "resolved": "string",
+                    "original": "string | string[] | null",
+                    "resolved": "null | string | string[] | undefined",
                     "references": {}
                 },
                 "required": false,
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "The value of the select, reflected by the value of the currently selected option. For the searchable variant, the value is also reflected by the user input."
+                    "text": "The value of the select, reflected by the value of the currently selected option.\nFor the searchable variant, the value is also reflected by the user input.\nFor the multi-select variant, the value must be an array of option values."
                 },
+                "getter": false,
+                "setter": false,
                 "attribute": "value",
                 "reflect": false
             }
@@ -1224,7 +1543,7 @@ export class Select {
         return {
             "ariaActiveDescendant": {},
             "clearButtonFocused": {},
-            "debounceIcChange": {},
+            "debounceIcInput": {},
             "hiddenInputValue": {},
             "noOptions": {},
             "open": {},
@@ -1265,13 +1584,13 @@ export class Select {
                     "text": "Emitted when the value changes."
                 },
                 "complexType": {
-                    "original": "IcValueEventDetail",
-                    "resolved": "IcValueEventDetail",
+                    "original": "IcMultiValueEventDetail",
+                    "resolved": "IcMultiValueEventDetail",
                     "references": {
-                        "IcValueEventDetail": {
+                        "IcMultiValueEventDetail": {
                             "location": "import",
                             "path": "../../utils/types",
-                            "id": "src/utils/types.ts::IcValueEventDetail"
+                            "id": "src/utils/types.ts::IcMultiValueEventDetail"
                         }
                     }
                 }
@@ -1283,7 +1602,7 @@ export class Select {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Emitted when the clear button is clicked."
+                    "text": "Emitted when the clear or clear all button is clicked."
                 },
                 "complexType": {
                     "original": "void",
@@ -1331,13 +1650,13 @@ export class Select {
                     "text": "Emitted when a keyboard input occurred."
                 },
                 "complexType": {
-                    "original": "IcValueEventDetail",
-                    "resolved": "IcValueEventDetail",
+                    "original": "IcMultiValueEventDetail",
+                    "resolved": "IcMultiValueEventDetail",
                     "references": {
-                        "IcValueEventDetail": {
+                        "IcMultiValueEventDetail": {
                             "location": "import",
                             "path": "../../utils/types",
-                            "id": "src/utils/types.ts::IcValueEventDetail"
+                            "id": "src/utils/types.ts::IcMultiValueEventDetail"
                         }
                     }
                 }
@@ -1364,7 +1683,28 @@ export class Select {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Emitted when an option is highlighted within the menu.\nHighlighting a menu item will also trigger an `icChange/onIcChange` due to the value being updated."
+                    "text": "Emitted when an option is selected.\nSelecting an option will also trigger an `icChange/onIcChange` due to the value being updated."
+                },
+                "complexType": {
+                    "original": "IcOptionSelectEventDetail",
+                    "resolved": "IcOptionSelectEventDetail",
+                    "references": {
+                        "IcOptionSelectEventDetail": {
+                            "location": "import",
+                            "path": "../ic-menu/ic-menu.types",
+                            "id": "src/components/ic-menu/ic-menu.types.ts::IcOptionSelectEventDetail"
+                        }
+                    }
+                }
+            }, {
+                "method": "icOptionDeselect",
+                "name": "icOptionDeselect",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitted when `multiple` is `true` and an option is deselected."
                 },
                 "complexType": {
                     "original": "IcOptionSelectEventDetail",
@@ -1388,13 +1728,13 @@ export class Select {
                     "text": "Emitted when the 'retry loading' button is clicked for a searchable variant."
                 },
                 "complexType": {
-                    "original": "IcValueEventDetail",
-                    "resolved": "IcValueEventDetail",
+                    "original": "IcMultiValueEventDetail",
+                    "resolved": "IcMultiValueEventDetail",
                     "references": {
-                        "IcValueEventDetail": {
+                        "IcMultiValueEventDetail": {
                             "location": "import",
                             "path": "../../utils/types",
-                            "id": "src/utils/types.ts::IcValueEventDetail"
+                            "id": "src/utils/types.ts::IcMultiValueEventDetail"
                         }
                     }
                 }
@@ -1424,6 +1764,9 @@ export class Select {
     static get elementRef() { return "el"; }
     static get watchers() {
         return [{
+                "propName": "disabled",
+                "methodName": "watchDisabledHandler"
+            }, {
                 "propName": "loading",
                 "methodName": "loadingHandler"
             }, {