@ukic/web-components 2.1.0-beta.1 → 2.1.0-beta.10

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

@@ -9,7 +9,23 @@ export class Select {
   constructor() {
     this.inputId = `ic-select-input-${inputIds++}`;
     this.menuId = `${this.inputId}-menu`;
+    this.ungroupedOptions = [];
     this.inheritedAttributes = {};
+    this.hasSetDefaultValue = false;
+    this.initialRender = false;
+    this.initialOptionsEmpty = false;
+    this.emitIcChange = (value) => {
+      this.value = value;
+      clearTimeout(this.debounceIcChange);
+      this.debounceIcChange = window.setTimeout(() => {
+        this.icChange.emit({ value: value });
+      }, this.currDebounce);
+    };
+    this.emitImmediateIcChange = (value) => {
+      this.value = value;
+      clearTimeout(this.debounceIcChange);
+      this.icChange.emit({ value: value });
+    };
     this.isMenuEnabled = () => {
       return (((this.searchableSelectInputValue === null ||
         this.searchableSelectInputValue === "") &&
@@ -27,6 +43,9 @@ export class Select {
         });
       }
     };
+    this.setUngroupedOptions = (event) => {
+      this.ungroupedOptions = event.detail.options;
+    };
     this.setTextColor = () => {
       if (this.nativeSelectElement.selectedIndex === 0) {
         this.nativeSelectElement.className = "placeholder";
@@ -50,13 +69,19 @@ export class Select {
     };
     this.getFilteredChildMenuOptions = (option) => {
       let children = option.children;
-      children = getFilteredMenuOptions(option.children, this.includeDescriptionsInSearch, this.searchableSelectInputValue, this.searchMatchPosition);
+      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;
     };
     this.handleNativeSelectChange = () => {
-      this.icChange.emit({ value: this.nativeSelectElement.value });
+      this.icOptionSelect.emit({ value: this.nativeSelectElement.value });
+      this.emitImmediateIcChange(this.nativeSelectElement.value);
       this.setTextColor();
     };
     this.handleCustomSelectChange = (event) => {
@@ -68,12 +93,20 @@ export class Select {
         this.searchableSelectInputValue = this.getLabelFromValue(event.detail.value);
       }
       this.ariaActiveDescendant = event.detail.optionId;
-      this.icChange.emit({ value: event.detail.value });
+      this.icOptionSelect.emit({ value: event.detail.value });
+      this.emitIcChange(event.detail.value);
     };
     this.handleMenuChange = (event) => {
       this.open = event.detail.open;
+      this.pressedCharacters = "";
       this.searchable && this.handleFocusIndicatorDisplay();
     };
+    // clears the debounce delay when navigating the menu with arrow keys etc
+    // 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.handleFocusIndicatorDisplay = () => {
       const focusIndicator = this.host.shadowRoot.querySelector(".focus-indicator");
       if (this.open) {
@@ -88,9 +121,15 @@ export class Select {
         event.preventDefault();
       }
     };
+    this.isExternalFiltering = () => this.searchable && this.disableFilter;
     this.handleClick = (event) => {
-      this.noOptions = null;
-      this.menu.options = this.options;
+      if (this.isExternalFiltering()) {
+        this.menu.options = this.filteredOptions;
+      }
+      else {
+        this.noOptions = null;
+        this.menu.options = this.options;
+      }
       if (event.detail !== 0 && this.isMenuEnabled()) {
         this.menu.handleClickOpen();
       }
@@ -105,7 +144,8 @@ export class Select {
     this.handleClear = (event) => {
       event.stopPropagation();
       this.noOptions = null;
-      this.icChange.emit({ value: null });
+      this.emitImmediateIcChange(null);
+      this.icClear.emit();
       if (this.searchable) {
         this.searchableSelectElement.value = null;
         this.searchableSelectInputValue = null;
@@ -119,20 +159,49 @@ export class Select {
         this.customSelectElement.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.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);
+        }
+      }
+      else {
+        this.pressedCharacters = "";
+      }
+    };
+    this.handleNativeSelectKeyDown = (event) => {
+      event.cancelBubble = true;
+      this.handleCharacterKeyDown(event.key);
+    };
     this.handleKeyDown = (event) => {
       event.cancelBubble = true;
+      const isArrowKey = event.key === "ArrowDown" || event.key === "ArrowUp";
       if (!this.open) {
-        this.noOptions = null;
-        this.menu.options = this.options;
+        if (this.isExternalFiltering() && (event.key === "Enter" || isArrowKey)) {
+          this.menu.options = this.filteredOptions;
+        }
+        else {
+          this.noOptions = null;
+          this.menu.options = this.options;
+        }
       }
       if (this.open && event.key === "Enter") {
         this.setMenuChange(false);
       }
       else {
-        if (!((event.key === "ArrowDown" || event.key === "ArrowUp") &&
-          this.noOptions !== null) &&
-          this.isMenuEnabled()) {
-          this.menu.handleKeyboardOpen(event);
+        if (!(isArrowKey && this.noOptions !== null) && this.isMenuEnabled()) {
+          if (!(event.key === " " && this.pressedCharacters.length > 0)) {
+            this.menu.handleKeyboardOpen(event);
+          }
+          this.handleCharacterKeyDown(event.key);
         }
       }
     };
@@ -142,25 +211,21 @@ export class Select {
     this.handleClearButtonBlur = () => {
       this.clearButtonFocused = false;
     };
-    this.handleSearchableSelectInput = (event) => {
-      this.searchableSelectInputValue = event.target.value;
-      if (this.getValueFromLabel(this.searchableSelectInputValue) === undefined) {
-        this.icChange.emit({ value: null });
-      }
-      if (this.isMenuEnabled()) {
-        this.setMenuChange(true);
-      }
-      else {
-        this.setMenuChange(false);
-      }
-      const options = [...this.options];
+    this.handleFilter = () => {
+      const options = this.searchable ? [...this.options] : this.ungroupedOptions;
       let isGrouped = false;
       let newFilteredOptions = [];
       options.map((option) => {
         if (option.children)
           isGrouped = true;
       });
-      const menuOptionsFiltered = getFilteredMenuOptions(options, this.includeDescriptionsInSearch, this.searchableSelectInputValue, this.searchMatchPosition);
+      let menuOptionsFiltered;
+      if (this.searchable) {
+        menuOptionsFiltered = getFilteredMenuOptions(options, this.includeDescriptionsInSearch, this.searchableSelectInputValue, this.searchMatchPosition);
+      }
+      else {
+        menuOptionsFiltered = getFilteredMenuOptions(options, false, this.pressedCharacters, "start");
+      }
       if (!isGrouped) {
         newFilteredOptions = menuOptionsFiltered;
       }
@@ -197,17 +262,39 @@ export class Select {
         this.noOptions = noOptions;
         this.filteredOptions = this.noOptions;
       }
-      this.debounceAriaLiveUpdate();
     };
-    this.updateSearchableSelectResultAriaLive = () => {
-      const searchableSelectResultsStatusEl = this.host.shadowRoot.querySelector(".searchable-select-results-status");
-      if (this.noOptions !== null) {
-        searchableSelectResultsStatusEl.innerText = this.emptyOptionListText;
+    this.handleSearchableSelectInput = (event) => {
+      this.searchableSelectInputValue = event.target.value;
+      this.icInput.emit({ value: this.searchableSelectInputValue });
+      if (this.disableFilter) {
+        this.emitIcChange(this.searchableSelectInputValue);
+      }
+      else if (this.getValueFromLabel(this.searchableSelectInputValue) === undefined) {
+        this.emitIcChange(null);
+      }
+      if (this.isMenuEnabled()) {
+        this.setMenuChange(true);
       }
       else {
-        searchableSelectResultsStatusEl.innerText = "";
+        this.setMenuChange(false);
+      }
+      if (!this.disableFilter) {
+        this.handleFilter();
+        this.debounceAriaLiveUpdate();
       }
     };
+    this.updateSearchableSelectResultAriaLive = () => {
+      const searchableSelectResultsStatusEl = this.host.shadowRoot.querySelector(".searchable-select-results-status");
+      if (searchableSelectResultsStatusEl) {
+        if (this.noOptions !== null) {
+          searchableSelectResultsStatusEl.innerText = this.emptyOptionListText;
+        }
+        else {
+          searchableSelectResultsStatusEl.innerText = "";
+        }
+      }
+    };
+    this.getDefaultValue = (value) => this.getLabelFromValue(value) || value || null;
     this.onFocus = () => {
       this.icFocus.emit();
     };
@@ -223,7 +310,7 @@ export class Select {
     this.handleFormReset = () => {
       this.value = this.initialValue;
       if (this.searchable) {
-        this.searchableSelectInputValue = null;
+        this.searchableSelectInputValue = this.getDefaultValue(this.value);
       }
     };
     this.label = undefined;
@@ -239,6 +326,7 @@ export class Select {
     this.validationStatus = "";
     this.validationText = "";
     this.value = undefined;
+    this.debounce = 0;
     this.name = this.inputId;
     this.showClearButton = false;
     this.searchable = false;
@@ -247,6 +335,7 @@ export class Select {
     this.searchMatchPosition = "anywhere";
     this.charactersUntilSuggestions = 0;
     this.emptyOptionListText = "No results found";
+    this.disableFilter = false;
     this.open = false;
     this.clearButtonFocused = false;
     this.searchableSelectInputValue = null;
@@ -254,10 +343,45 @@ export class Select {
     this.ariaActiveDescendant = undefined;
     this.noOptions = null;
     this.initialValue = this.value;
+    this.currDebounce = this.debounce;
+    this.currValue = this.value;
+    this.debounceIcChange = undefined;
+    this.pressedCharacters = "";
   }
   watchOptionsHandler() {
-    this.setOptionsValuesFromLabels();
-    this.filteredOptions = this.options;
+    if (this.isExternalFiltering()) {
+      if (this.options.length > 0) {
+        this.setOptionsValuesFromLabels();
+        this.noOptions = null;
+        this.filteredOptions = this.options;
+      }
+      else if (this.isMenuEnabled()) {
+        this.noOptions = [{ label: this.emptyOptionListText, value: "" }];
+        this.filteredOptions = this.noOptions;
+        // Will prevent 'No results found' displaying on initial load and setting default value
+        if (!this.initialRender) {
+          this.setMenuChange(true);
+        }
+      }
+      this.updateSearchableSelectResultAriaLive();
+      this.setDefaultValue();
+    }
+    else {
+      this.setOptionsValuesFromLabels();
+      this.filteredOptions = this.options;
+      if (this.initialOptionsEmpty) {
+        this.setDefaultValue();
+        this.initialOptionsEmpty = false;
+      }
+    }
+  }
+  debounceChangedHandler(newValue) {
+    this.updateOnChangeDebounce(newValue);
+  }
+  valueChangedHandler() {
+    if (this.value !== this.currValue) {
+      this.currValue = this.value;
+    }
   }
   /**
    * Sets focus on the input box.
@@ -273,12 +397,24 @@ export class Select {
       this.searchableSelectElement.focus();
     }
   }
+  updateOnChangeDebounce(newValue) {
+    if (this.currDebounce !== newValue) {
+      this.currDebounce = newValue;
+    }
+  }
   debounceAriaLiveUpdate() {
-    clearTimeout(this.debounce);
+    clearTimeout(this.debounceAria);
     window.setTimeout(() => {
       this.updateSearchableSelectResultAriaLive();
     }, 800);
   }
+  setDefaultValue() {
+    if (!this.hasSetDefaultValue && this.currValue) {
+      this.searchableSelectInputValue = this.getDefaultValue(this.currValue);
+      this.initialValue = this.currValue;
+      this.hasSetDefaultValue = true;
+    }
+  }
   componentWillLoad() {
     this.inheritedAttributes = inheritAttributes(this.host, [
       ...IC_INHERITED_ARIA,
@@ -287,12 +423,22 @@ export class Select {
     ]);
     this.setOptionsValuesFromLabels();
     addFormResetListener(this.host, this.handleFormReset);
+    this.initialRender = true;
+    if (!this.options.length) {
+      this.initialOptionsEmpty = true;
+    }
+    else if (!this.disableFilter) {
+      this.setDefaultValue();
+    }
   }
   componentDidRender() {
     if (this.nativeSelectElement && !this.disabled) {
       this.setTextColor();
     }
   }
+  componentWillUpdate() {
+    this.initialRender = false;
+  }
   componentDidLoad() {
     onComponentRequiredPropUndefined([{ prop: this.label, propName: "label" }], "Select");
   }
@@ -300,49 +446,45 @@ export class Select {
     removeFormResetListener(this.host, this.handleFormReset);
   }
   render() {
-    const { small, disabled, fullWidth, helperText, hideLabel, label, menuId, name, options, placeholder, readonly, required, searchable, showClearButton, validationStatus, validationText, value, } = this;
-    renderHiddenInput(true, this.host, name, value, disabled);
+    const { small, disabled, fullWidth, helperText, hideLabel, label, menuId, name, options, placeholder, readonly, required, searchable, showClearButton, validationStatus, validationText, currValue, } = this;
+    renderHiddenInput(true, this.host, name, currValue, disabled);
     const invalid = validationStatus === IcInformationStatus.Error ? "true" : "false";
     const describedBy = getInputDescribedByText(this.inputId, helperText !== "", hasValidationStatus(this.validationStatus, this.disabled)).trim();
-    return (h(Host, null, 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 }, small: small, fullWidth: fullWidth, disabled: disabled, readonly: readonly, validationStatus: validationStatus }, readonly ? (h("ic-typography", null, h("p", null, this.getLabelFromValue(value)))) : 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 }, this.inheritedAttributes), h("option", { value: "", selected: true, disabled: !showClearButton }, placeholder), options.map((option) => {
+    return (h(Host, null, 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 }, small: small, fullWidth: fullWidth, disabled: disabled, readonly: readonly, validationStatus: validationStatus }, 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 }, 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 === value }, option.label)))));
+        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 === value }, option.label));
+        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", "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 }), 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 && value === null
+      (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
         ? "Clear input"
         : "Clear selection", class: "clear-button", innerHTML: Clear, onClick: this.handleClear, onFocus: this.handleClearButtonFocus, onBlur: this.handleClearButtonBlur, size: small ? "small" : "default", variant: "icon", appearance: this.clearButtonFocused
         ? IcThemeForegroundEnum.Light
         : IcThemeForegroundEnum.Dark }), h("div", { class: "divider" }))), h("span", { onMouseDown: this.handleExpandIconMouseDown, class: {
         "expand-icon": true,
         "expand-icon-open": this.open,
-        "expand-icon-filled": !(value == null || value === ""),
+        "expand-icon-filled": !(currValue == null || currValue === ""),
         "expand-icon-disabled": !this.isMenuEnabled(),
-      }, 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(value) || 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}, ${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: {
         "value-text": true,
-        placeholder: this.getLabelFromValue(value) === undefined,
-      } }, h("p", null, this.getLabelFromValue(value) || placeholder)), h("div", { class: "select-input-end" }, value && showClearButton && h("div", { class: "divider" }), h("span", { class: {
+        placeholder: this.getLabelFromValue(currValue) === undefined,
+      } }, h("p", null, this.getLabelFromValue(currValue) || placeholder)), h("div", { class: "select-input-end" }, currValue && showClearButton && (h("div", { class: "divider" })), h("span", { class: {
         "expand-icon": true,
         "expand-icon-open": this.open,
-        "expand-icon-filled": !(value == null || value === ""),
-      }, innerHTML: Expand, "aria-hidden": "true" }))), value && 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: small ? "small" : "default", variant: "icon", appearance: this.clearButtonFocused
+        "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: small ? "small" : "default", variant: "icon", appearance: this.clearButtonFocused
         ? IcThemeForegroundEnum.Light
         : IcThemeForegroundEnum.Dark }))))), !isMobileOrTablet() && (h("ic-menu", { class: {
-        "no-results": this.noOptions !== null,
+        "no-results": this.noOptions !== null && this.searchable,
       }, ref: (el) => (this.menu = el), inputEl: searchable
         ? this.searchableSelectElement
-        : this.customSelectElement, inputLabel: label, anchorEl: this.anchorEl, small: small, menuId: menuId, open: this.open, options: searchable ? this.filteredOptions : options, value: value, fullWidth: fullWidth, onMenuChange: this.handleMenuChange, onOptionSelect: this.handleCustomSelectChange, parentEl: this.host })), h("ic-input-validation", { class: { "menu-open": this.open }, ariaLiveMode: "polite", status: hasValidationStatus(this.validationStatus, this.disabled) ===
-        false
-        ? ""
-        : validationStatus, message: hasValidationStatus(this.validationStatus, this.disabled)
-        ? validationText
-        : "", for: this.inputId }))));
+        : this.customSelectElement, inputLabel: label, anchorEl: this.anchorEl, small: small, menuId: menuId, open: this.open, options: searchable ? this.filteredOptions : options, value: currValue, fullWidth: fullWidth, onMenuStateChange: this.handleMenuChange, onMenuOptionSelect: this.handleCustomSelectChange, onMenuKeyPress: this.handleMenuKeyPress, onUngroupedOptionsSet: this.setUngroupedOptions, parentEl: this.host })), hasValidationStatus(this.validationStatus, this.disabled) && (h("ic-input-validation", { 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"; }
+  static get delegatesFocus() { return true; }
   static get originalStyleUrls() {
     return {
       "$": ["ic-select.css"]
@@ -367,7 +509,7 @@ export class Select {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Provide a label for the input."
+          "text": "The label for the select."
         },
         "attribute": "label",
         "reflect": false
@@ -389,7 +531,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Provide the possible selection options."
+          "text": "The possible selection options."
         },
         "defaultValue": "[]"
       },
@@ -405,7 +547,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Specify if the input requires a value."
+          "text": "If `true`, the select will require a value."
         },
         "attribute": "required",
         "reflect": false,
@@ -423,7 +565,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Hides the label and applies the required label value as an aria-label."
+          "text": "If `true`, the label will be hidden and the required label value will be applied as an aria-label."
         },
         "attribute": "hide-label",
         "reflect": false,
@@ -441,7 +583,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Specify whether the input is disabled."
+          "text": "If `true`, the disabled state will be set."
         },
         "attribute": "disabled",
         "reflect": true,
@@ -459,7 +601,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Specify whether the input is read only."
+          "text": "If `true`, the readonly state will be set."
         },
         "attribute": "readonly",
         "reflect": false,
@@ -477,7 +619,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Provide a placeholder value to display."
+          "text": "The placeholder value to be displayed."
         },
         "attribute": "placeholder",
         "reflect": false,
@@ -495,7 +637,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Provide helper text to display additional field guidance."
+          "text": "The helper text that will be displayed for additional field guidance."
         },
         "attribute": "helper-text",
         "reflect": false,
@@ -513,7 +655,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Specify whether small styling is to be applied to the element."
+          "text": "If `true`, the small styling will be applied to the select."
         },
         "attribute": "small",
         "reflect": false,
@@ -531,7 +673,7 @@ export class Select {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "If true, then fill width of container."
+          "text": "If `true`, the select element will fill the width of the container."
         },
         "attribute": "full-width",
         "reflect": false,
@@ -554,7 +696,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Provide a validation status."
+          "text": "The validation status - e.g. 'error' | 'warning' | 'success'."
         },
         "attribute": "validation-status",
         "reflect": false,
@@ -572,7 +714,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Provide the text to display as the validation message."
+          "text": "The text to display as the validation message."
         },
         "attribute": "validation-text",
         "reflect": false,
@@ -595,6 +737,24 @@ export class Select {
         "attribute": "value",
         "reflect": false
       },
+      "debounce": {
+        "type": "number",
+        "mutable": false,
+        "complexType": {
+          "original": "number",
+          "resolved": "number",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke."
+        },
+        "attribute": "debounce",
+        "reflect": false,
+        "defaultValue": "0"
+      },
       "name": {
         "type": "string",
         "mutable": false,
@@ -625,7 +785,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Display a button which clears the input when clicked. The button will always appear on the searchable select."
+          "text": "If `true`, a button which clears the select input when clicked will be displayed. The button will always appear on the searchable select."
         },
         "attribute": "show-clear-button",
         "reflect": false,
@@ -643,7 +803,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "If true, the select 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."
         },
         "attribute": "searchable",
         "reflect": false,
@@ -661,7 +821,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "If true, descriptions of options are included when filtering options in a searchable select."
+          "text": "If `true`, descriptions of options will be included when filtering options in a searchable select. Only applies to built in filtering."
         },
         "attribute": "include-descriptions-in-search",
         "reflect": false,
@@ -679,7 +839,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "If true, group titles of grouped options are included when filtering options in a searchable select."
+          "text": "If `true`, group titles of grouped options will be included when filtering options in a searchable select. Only applies to built in filtering."
         },
         "attribute": "include-group-titles-in-search",
         "reflect": false,
@@ -702,7 +862,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Whether the search string of the searchable select should match the start of or anywhere in the options."
+          "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."
         },
         "attribute": "search-match-position",
         "reflect": false,
@@ -720,7 +880,7 @@ export class Select {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Number of characters until suggestions appear for a searchable select."
+          "text": "The number of characters until suggestions appear for a searchable select."
         },
         "attribute": "characters-until-suggestions",
         "reflect": false,
@@ -738,11 +898,29 @@ export class Select {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Provide text for empty results list"
+          "text": "The text displayed when there are no options in the option list."
         },
         "attribute": "empty-option-list-text",
         "reflect": false,
         "defaultValue": "\"No results found\""
+      },
+      "disableFilter": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Specify whether to disable the built in filtering for a searchable variant. For example, if options will already be filtered from external source."
+        },
+        "attribute": "disable-filter",
+        "reflect": false,
+        "defaultValue": "false"
       }
     };
   }
@@ -754,7 +932,11 @@ export class Select {
       "filteredOptions": {},
       "ariaActiveDescendant": {},
       "noOptions": {},
-      "initialValue": {}
+      "initialValue": {},
+      "currDebounce": {},
+      "currValue": {},
+      "debounceIcChange": {},
+      "pressedCharacters": {}
     };
   }
   static get events() {
@@ -766,7 +948,7 @@ export class Select {
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "Emitted when a value is selected."
+          "text": "Emitted when the value changes."
         },
         "complexType": {
           "original": "IcValueEventDetail",
@@ -778,6 +960,21 @@ export class Select {
             }
           }
         }
+      }, {
+        "method": "icClear",
+        "name": "icClear",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitted when clear button clicked."
+        },
+        "complexType": {
+          "original": "void",
+          "resolved": "void",
+          "references": {}
+        }
       }, {
         "method": "icFocus",
         "name": "icFocus",
@@ -786,7 +983,7 @@ export class Select {
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "Emitted when select has focus."
+          "text": "Emitted when select gains focus."
         },
         "complexType": {
           "original": "void",
@@ -801,13 +998,53 @@ export class Select {
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "Emitted when select has blur."
+          "text": "Emitted when select loses focus."
         },
         "complexType": {
           "original": "void",
           "resolved": "void",
           "references": {}
         }
+      }, {
+        "method": "icOptionSelect",
+        "name": "icOptionSelect",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitted when option is highlighted within the menu.\nHighlighting a menu item will 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"
+            }
+          }
+        }
+      }, {
+        "method": "icInput",
+        "name": "icInput",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitted when a keyboard input occurred."
+        },
+        "complexType": {
+          "original": "IcValueEventDetail",
+          "resolved": "IcValueEventDetail",
+          "references": {
+            "IcValueEventDetail": {
+              "location": "import",
+              "path": "../../interface"
+            }
+          }
+        }
       }];
   }
   static get methods() {
@@ -835,6 +1072,12 @@ export class Select {
     return [{
         "propName": "options",
         "methodName": "watchOptionsHandler"
+      }, {
+        "propName": "debounce",
+        "methodName": "debounceChangedHandler"
+      }, {
+        "propName": "value",
+        "methodName": "valueChangedHandler"
       }];
   }
 }