@ukic/web-components 2.1.0-beta.9 → 2.2.0

package/dist/components/ic-search-bar.js

@@ -1,6 +1,6 @@
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client';
 import { I as IcThemeForegroundEnum } from './types.js';
-import { u as handleHiddenFormButtonClick, v as getFilteredMenuOptions, w as getLabelFromValue, a as onComponentRequiredPropUndefined, h as getInputDescribedByText, e as renderHiddenInput } from './helpers.js';
+import { F as getFilteredMenuOptions, G as handleHiddenFormButtonClick, H as getLabelFromValue, r as removeDisabledFalse, o as onComponentRequiredPropUndefined, k as getInputDescribedByText, h as renderHiddenInput } from './helpers.js';
 import { d as defineCustomElement$b } from './ic-button2.js';
 import { d as defineCustomElement$a } from './ic-input-component-container2.js';
 import { d as defineCustomElement$9 } from './ic-input-container2.js';
@@ -21,45 +21,52 @@ const searchIcon = `<svg width="20" height="20" viewBox="0 0 20 20" fill="none"
     <path d="M13.1292 11.8792H12.4708L12.2375 11.6542C13.0542 10.7042 13.5458 9.47083 13.5458 8.12916C13.5458 5.13749 11.1208 2.71249 8.12916 2.71249C5.13749 2.71249 2.71249 5.13749 2.71249 8.12916C2.71249 11.1208 5.13749 13.5458 8.12916 13.5458C9.47083 13.5458 10.7042 13.0542 11.6542 12.2375L11.8792 12.4708V13.1292L16.0458 17.2875L17.2875 16.0458L13.1292 11.8792ZM8.12916 11.8792C6.05416 11.8792 4.37916 10.2042 4.37916 8.12916C4.37916 6.05416 6.05416 4.37916 8.12916 4.37916C10.2042 4.37916 11.8792 6.05416 11.8792 8.12916C11.8792 10.2042 10.2042 11.8792 8.12916 11.8792Z" fill="currentColor"/>
 </svg>`;
 
-const icSearchBarCss = "/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */html{line-height:1.15;-webkit-text-size-adjust:100%;}body{margin:0}main{display:block}h1{font-size:2em;margin:0.67em 0}hr{box-sizing:content-box;height:0;overflow:visible;}pre{font-family:monospace, monospace;font-size:1em;}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;-webkit-text-decoration:underline dotted;text-decoration:underline dotted;}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace, monospace;font-size:1em;}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-0.25em}sup{top:-0.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0;}button,input{overflow:visible}button,select{text-transform:none}button,[type=\"button\"],[type=\"reset\"],[type=\"submit\"]{-webkit-appearance:button}button::-moz-focus-inner,[type=\"button\"]::-moz-focus-inner,[type=\"reset\"]::-moz-focus-inner,[type=\"submit\"]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=\"button\"]:-moz-focusring,[type=\"reset\"]:-moz-focusring,[type=\"submit\"]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:0.35em 0.75em 0.625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal;}progress{vertical-align:baseline}textarea{overflow:auto}[type=\"checkbox\"],[type=\"radio\"]{box-sizing:border-box;padding:0;}[type=\"number\"]::-webkit-inner-spin-button,[type=\"number\"]::-webkit-outer-spin-button{height:auto}[type=\"search\"]{-webkit-appearance:textfield;outline-offset:-2px;}[type=\"search\"]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit;}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,img,ins,kbd,q,s,samp,small,strike,strong,sub,sup,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td,article,aside,canvas,details,embed,figure,figcaption,footer,header,hgroup,menu,nav,output,ruby,section,summary,time,mark,audio,video{margin:0;padding:0;border:0;font-size:100%;font-style:inherit;vertical-align:baseline}:host(.search){--divider-height:1.5rem}:host(.search.small){--divider-height:1rem}:host(.fullwidth){width:100%}:host(.search) .disabled:hover{border-color:var(--ic-architectural-200)}:host(.search.disabled) .disabled svg{color:var(--ic-architectural-200)}:host(.search) .disabled svg{color:var(--ic-architectural-400)}.clear-button-container{align-items:center;margin-right:0.063rem;display:none;visibility:hidden}.clear-button{border-radius:var(--ic-border-radius);transition:box-shadow var(--ic-easing-transition),\n    border-radius var(--ic-easing-transition)}.clear-button:focus,.clear-button:active{background-color:var(--ic-focus-blue);box-shadow:inset 0 0 0 0.125rem var(--ic-focus-glow);border-radius:0.25rem}.clear-button:focus,.clear-button:active *{fill:white}.clear-button-visible{visibility:visible;display:flex}.search-submit-button-container{display:flex;align-items:center}.search-submit-button-disabled .ic-tooltip-container{display:none !important}.search-submit-button:focus,.search-submit-button:active{background-color:var(--ic-focus-blue) !important;box-shadow:inset 0 0 0 0.125rem var(--ic-focus-glow) !important;border-radius:var(--ic-space-xxs)}.search-submit-button:focus,.search-submit-button:active *{fill:white}.divider{width:0.063rem;background-color:var(--ic-action-dark-active);height:var(--divider-height)}:host(.dark) .divider{background-color:var(--ic-architectural-200)}.menu-container{width:var(--input-width, 20rem);position:relative;top:var(--ic-space-xxxs)}.menu-container.fullwidth{width:100%}ic-menu{transition:var(--ic-easing-transition-slow)}.no-results{cursor:not-allowed}.search-results-status{border:0;clip:rect(0, 0, 0, 0, 0);height:0.063rem;margin-bottom:-0.063rem;margin-right:-0.063rem;overflow:hidden;padding:0;position:absolute;white-space:nowrap;width:0.063rem}";
+const icSearchBarCss = "/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */html{line-height:1.15;-webkit-text-size-adjust:100%;}body{margin:0}main{display:block}h1{font-size:2em;margin:0.67em 0}hr{box-sizing:content-box;height:0;overflow:visible;}pre{font-family:monospace, monospace;font-size:1em;}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;-webkit-text-decoration:underline dotted;text-decoration:underline dotted;}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace, monospace;font-size:1em;}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-0.25em}sup{top:-0.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0;}button,input{overflow:visible}button,select{text-transform:none}button,[type=\"button\"],[type=\"reset\"],[type=\"submit\"]{-webkit-appearance:button}button::-moz-focus-inner,[type=\"button\"]::-moz-focus-inner,[type=\"reset\"]::-moz-focus-inner,[type=\"submit\"]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=\"button\"]:-moz-focusring,[type=\"reset\"]:-moz-focusring,[type=\"submit\"]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:0.35em 0.75em 0.625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal;}progress{vertical-align:baseline}textarea{overflow:auto}[type=\"checkbox\"],[type=\"radio\"]{box-sizing:border-box;padding:0;}[type=\"number\"]::-webkit-inner-spin-button,[type=\"number\"]::-webkit-outer-spin-button{height:auto}[type=\"search\"]{-webkit-appearance:textfield;outline-offset:-2px;}[type=\"search\"]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit;}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,img,ins,kbd,q,s,samp,small,strike,strong,sub,sup,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td,article,aside,canvas,details,embed,figure,figcaption,footer,header,hgroup,menu,nav,output,ruby,section,summary,time,mark,audio,video{margin:0;padding:0;border:0;font-size:100%;font-style:inherit;vertical-align:baseline}:host(.search){--divider-height:1.5rem}:host(.search.small){--divider-height:1rem}:host(.fullwidth){width:100%}:host(.search) .disabled:hover{border-color:var(--ic-architectural-200)}:host(.search.disabled) .disabled svg{color:var(--ic-architectural-200)}:host(.search) .disabled svg{color:var(--ic-architectural-400)}.clear-button-container{align-items:center;margin-right:var(--ic-space-1px);display:none;visibility:hidden}.clear-button{border-radius:var(--ic-border-radius);transition:box-shadow var(--ic-easing-transition),\n    border-radius var(--ic-easing-transition)}.clear-button:focus,.clear-button:active{background-color:var(--ic-focus-blue);box-shadow:inset 0 0 0 0.125rem var(--ic-focus-glow);border-radius:0.25rem}.clear-button:focus,.clear-button:active *{fill:white}.clear-button-visible{visibility:visible;display:flex}.search-submit-button-container{display:flex;align-items:center}.search-submit-button-disabled .ic-tooltip-container{display:none !important}.search-submit-button:focus,.search-submit-button:active{background-color:var(--ic-focus-blue) !important;box-shadow:inset 0 0 0 0.125rem var(--ic-focus-glow) !important;border-radius:var(--ic-space-xxs)}.search-submit-button:focus,.search-submit-button:active *{fill:white}.divider{width:var(--ic-space-1px);background-color:var(--ic-action-dark-active);height:var(--divider-height)}:host(.dark) .divider{background-color:var(--ic-architectural-200)}.menu-container{width:var(--input-width, 20rem);position:relative;top:var(--ic-space-xxxs)}.menu-container.fullwidth{width:100%}.no-results{cursor:not-allowed}.search-results-status{border:0;clip:rect(0, 0, 0, 0, 0);height:var(--ic-space-1px);margin-bottom:calc(-1 * var(--ic-space-1px));margin-right:calc(-1 * var(--ic-space-1px));overflow:hidden;padding:0;position:absolute;white-space:nowrap;width:var(--ic-space-1px)}";
 
 let inputIds = 0;
-const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
+const SearchBar = /*@__PURE__*/ proxyCustomElement(class SearchBar extends HTMLElement {
   constructor() {
     super();
     this.__registerHost();
     this.__attachShadow();
+    this.icChange = createEvent(this, "icChange", 7);
+    this.icClear = createEvent(this, "icClear", 7);
     this.icInput = createEvent(this, "icInput", 7);
     this.icInputBlur = createEvent(this, "icInputBlur", 7);
     this.icInputFocus = createEvent(this, "icInputFocus", 7);
-    this.icChange = createEvent(this, "icChange", 7);
-    this.icClear = createEvent(this, "icClear", 7);
-    this.icSubmitSearch = createEvent(this, "icSubmitSearch", 7);
     this.icOptionSelect = createEvent(this, "icOptionSelect", 7);
     this.icMenuChange = createEvent(this, "icMenuChange", 7);
     this.icClearBlur = createEvent(this, "icClearBlur", 7);
+    this.icRetryLoad = createEvent(this, "icRetryLoad", 7);
+    this.icSubmitSearch = createEvent(this, "icSubmitSearch", 7);
     this.icSubmitSearchBlur = createEvent(this, "icSubmitSearchBlur", 7);
     this.icSearchBarBlur = createEvent(this, "icSearchBarBlur", 7);
     this.icSearchBarFocus = createEvent(this, "icSearchBarFocus", 7);
+    this.assistiveHintEl = null;
+    this.hasTimedOut = false;
     this.inputId = `ic-search-bar-input-${inputIds++}`;
-    this.menuId = `${this.inputId}-menu`;
     this.menuCloseFromMenuChangeEvent = false;
-    this.truncateValue = false;
-    this.assistiveHintEl = null;
+    this.menuId = `${this.inputId}-menu`;
+    this.preLoad = true;
     this.preventSubmit = false;
-    this.handleSubmitSearch = () => {
-      this.highlightedValue && (this.value = this.highlightedValue);
-      this.highlightedValue = undefined;
-      this.icSubmitSearch.emit({ value: this.value });
-      const form = this.el.closest("FORM");
-      if (this.searchSubmitButton && !!form && !this.preventSubmit) {
-        handleHiddenFormButtonClick(form, this.searchSubmitButton);
-      }
-    };
-    this.handleSubmitSearchKeyDown = (ev) => {
-      if (ev.key === " ") {
+    this.prevNoOption = false;
+    this.retryButtonClick = false;
+    this.truncateValue = false;
+    this.handleClear = (ev) => {
+      const keyboardEvent = ev;
+      const mouseEvent = ev;
+      if (mouseEvent.type === "click" ||
+        keyboardEvent.code === "Enter" ||
+        keyboardEvent.code === "Space") {
+        this.value = "";
+        this.inputEl.value = "";
+        this.loading = false;
+        clearTimeout(this.timeoutTimer);
+        this.filteredOptions = this.options;
+        this.el.setFocus();
+        this.icClear.emit();
         ev.preventDefault();
-        this.handleSubmitSearch();
+        this.preventSubmit = true;
       }
     };
     this.onInput = (ev) => {
@@ -67,6 +74,7 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
       const noOptions = [{ label: this.emptyOptionListText, value: "" }];
       if (this.options.length > 0) {
         this.setMenuChange(true);
+        this.preLoad = false;
         if (this.disableFilter === false) {
           const rawFilteredOptions = getFilteredMenuOptions(this.options, false, this.value, "anywhere");
           this.filteredOptions =
@@ -88,23 +96,6 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
       this.icInputFocus.emit({ value: value });
       this.handleShowClearButton(true);
     };
-    this.handleClear = (ev) => {
-      const keyboardEvent = ev;
-      const mouseEvent = ev;
-      if (mouseEvent.type === "click" ||
-        keyboardEvent.code === "Enter" ||
-        keyboardEvent.code === "Space") {
-        this.value = "";
-        this.inputEl.value = "";
-        this.el.setFocus();
-        this.icClear.emit();
-        ev.preventDefault();
-        this.preventSubmit = true;
-      }
-    };
-    this.handleMouseDown = (ev) => {
-      ev.preventDefault();
-    };
     this.handleClearBlur = (ev) => {
       const nextFocus = ev.relatedTarget;
       this.icClearBlur.emit({ relatedTarget: nextFocus });
@@ -115,10 +106,47 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
       this.icSubmitSearchBlur.emit({ relatedTarget: nextFocus });
       this.searchSubmitFocused = false;
     };
+    this.handleMouseDown = (ev) => {
+      ev.preventDefault();
+    };
     this.handleSubmitSearchFocus = () => {
-      this.handleMenuCloseFromMenuChange(true);
       this.searchSubmitFocused = true;
     };
+    this.handleSubmitSearch = () => {
+      this.highlightedValue && (this.value = this.highlightedValue);
+      this.highlightedValue = undefined;
+      this.icSubmitSearch.emit({ value: this.value });
+      const form = this.el.closest("FORM");
+      if (this.searchSubmitButton && !!form && !this.preventSubmit) {
+        handleHiddenFormButtonClick(form, this.searchSubmitButton);
+      }
+    };
+    this.handleSubmitSearchKeyDown = (ev) => {
+      if (ev.key === " ") {
+        ev.preventDefault();
+        this.handleSubmitSearch();
+      }
+    };
+    this.handleRetry = (ev) => {
+      this.retryViaKeyPress = ev.detail.keyPressed === "Enter";
+      this.icRetryLoad.emit({ value: ev.detail.value });
+      this.triggerLoading();
+      this.retryButtonClick = true;
+    };
+    this.triggerLoading = () => {
+      const loadingOption = [
+        { label: this.loadingLabel, value: "", loading: true },
+      ];
+      if (this.filteredOptions !== loadingOption)
+        this.filteredOptions = loadingOption;
+      if (this.timeout) {
+        this.timeoutTimer = window.setTimeout(() => {
+          this.filteredOptions = [
+            { label: this.loadingErrorLabel, value: "", timedOut: true },
+          ];
+        }, this.timeout);
+      }
+    };
     this.handleOptionSelect = (ev) => {
       if (ev.detail.label === this.emptyOptionListText) {
         this.el.setFocus();
@@ -162,13 +190,22 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     };
     this.handleHostBlur = (ev) => {
       const nextFocus = ev.relatedTarget;
-      if (this.open && this.options && nextFocus !== this.menu) {
+      if (this.open &&
+        this.options &&
+        nextFocus !== this.menu &&
+        !this.retryViaKeyPress &&
+        !this.retryButtonClick) {
         this.setMenuChange(false);
       }
+      if (this.retryButtonClick || this.retryViaKeyPress) {
+        this.inputEl.setFocus();
+      }
       this.handleShowClearButton(false);
       this.handleMenuCloseFromMenuChange(false);
       this.handleTruncateValue(true);
       this.icSearchBarBlur.emit({ relatedTarget: nextFocus, value: this.value });
+      this.retryViaKeyPress = false;
+      this.retryButtonClick = false;
     };
     this.handleShowClearButton = (visible) => {
       this.showClearButton = visible;
@@ -208,7 +245,8 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
       else if (this.hasOptionsOrFilterDisabled() &&
         this.filteredOptions.length > 0 &&
         this.open &&
-        searchResultsStatusEl) {
+        searchResultsStatusEl &&
+        !this.filteredOptions[0].loading) {
         if (this.hadNoOptions()) {
           searchResultsStatusEl.innerText = this.emptyOptionListText;
         }
@@ -219,55 +257,79 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     };
     this.hasOptionsOrFilterDisabled = () => this.options.length > 0 || this.disableFilter;
     this.hadNoOptions = () => this.filteredOptions.length === 1 &&
-      this.filteredOptions[0].label === this.emptyOptionListText;
+      this.filteredOptions[0].label === this.emptyOptionListText &&
+      this.searchMode === "navigation";
     this.isSubmitDisabled = () => {
       const valueNotSet = this.value === undefined || this.value === null || this.value === "";
-      return valueNotSet || this.disabled || this.hadNoOptions();
+      const valueLengthLess = this.value.length < this.charactersUntilSuggestion;
+      return (valueNotSet ||
+        valueLengthLess ||
+        this.disabled ||
+        this.hadNoOptions() ||
+        this.hasTimedOut ||
+        this.loading);
     };
     this.highlightFirstOptionAfterNoResults = () => {
-      if (this.prevNoOption && this.menu) {
+      if (this.prevNoOption && this.menu && !this.hasTimedOut) {
         this.menu.handleSetFirstOption();
         this.prevNoOption = false;
       }
-      const prevNoOptionsList = this.filteredOptions.find((filteredOption) => filteredOption.label === this.emptyOptionListText);
+      const prevNoOptionsList = this.filteredOptions.find((filteredOption) => filteredOption.label === this.emptyOptionListText ||
+        filteredOption.label === this.loadingErrorLabel ||
+        filteredOption.label === this.loadingLabel);
       if (prevNoOptionsList) {
         this.prevNoOption = true;
       }
     };
-    this.label = undefined;
-    this.required = false;
-    this.disabled = false;
-    this.readonly = false;
-    this.placeholder = "Search";
-    this.fullWidth = false;
-    this.disableFilter = false;
-    this.hideLabel = false;
-    this.helperText = "";
-    this.small = false;
-    this.value = "";
+    this.ariaActiveDescendant = undefined;
+    this.clearButtonFocused = false;
+    this.highlightedValue = undefined;
+    this.open = false;
+    this.searchSubmitFocused = false;
+    this.showClearButton = false;
     this.autocapitalize = "off";
     this.autocomplete = "off";
     this.autocorrect = "off";
     this.autofocus = false;
+    this.charactersUntilSuggestion = 2;
+    this.disabled = false;
+    this.disableFilter = false;
     this.debounce = 0;
-    this.name = this.inputId;
-    this.spellcheck = false;
-    this.options = [];
+    this.emptyOptionListText = "No results found";
     this.focusOnLoad = false;
+    this.fullWidth = false;
+    this.helperText = "";
+    this.hideLabel = false;
     this.hintText = "When autocomplete results are available use the up and down arrows to choose and press enter to select";
-    this.emptyOptionListText = "No results found";
-    this.charactersUntilSuggestion = 2;
-    this.open = false;
+    this.label = undefined;
+    this.loading = false;
+    this.loadingErrorLabel = "Loading Error";
+    this.loadingLabel = "Loading...";
+    this.name = this.inputId;
+    this.placeholder = "Search";
+    this.readonly = false;
+    this.required = false;
+    this.searchMode = "navigation";
+    this.small = false;
+    this.spellcheck = false;
+    this.timeout = undefined;
     this.filteredOptions = [];
-    this.ariaActiveDescendant = undefined;
-    this.showClearButton = false;
-    this.clearButtonFocused = false;
-    this.searchSubmitFocused = false;
-    this.prevNoOption = false;
-    this.highlightedValue = undefined;
+    this.options = [];
+    this.value = "";
+  }
+  loadingHandler(newValue) {
+    if (newValue && !this.hasTimedOut) {
+      this.preLoad = false;
+      this.triggerLoading();
+    }
+  }
+  filteredOptionsHandler(newOptions) {
+    this.hasTimedOut = newOptions.some((opt) => opt.timedOut);
   }
   watchOptionsHandler(newOptions) {
-    if (this.disableFilter) {
+    if (this.disableFilter && !this.hasTimedOut) {
+      this.loading = false;
+      clearTimeout(this.timeoutTimer);
       if (newOptions.length > 0) {
         this.filteredOptions = newOptions;
       }
@@ -276,7 +338,11 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
           return;
         }
         this.setMenuChange(true);
-        this.filteredOptions = [{ label: this.emptyOptionListText, value: "" }];
+        !this.preLoad &&
+          (this.filteredOptions = [
+            { label: this.emptyOptionListText, value: "" },
+          ]);
+        this.preLoad = true;
       }
     }
     this.debounceAriaLiveUpdate();
@@ -291,14 +357,33 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
       this.inputEl.value = newValue;
     }
   }
-  /**
-   * Sets focus on the native `input`.
-   */
-  async setFocus() {
-    if (this.inputEl) {
-      this.inputEl.setFocus();
+  disconnectedCallback() {
+    if (this.assistiveHintEl) {
+      this.assistiveHintEl.remove();
     }
   }
+  componentWillLoad() {
+    this.watchValueHandler(this.value);
+    removeDisabledFalse(this.disabled, this.el);
+  }
+  componentDidLoad() {
+    if (this.focusOnLoad) {
+      this.el.setFocus();
+    }
+    if (this.hasOptionsOrFilterDisabled()) {
+      this.renderAssistiveHintEl();
+      if (this.disableFilter) {
+        this.filteredOptions = this.options;
+      }
+    }
+    onComponentRequiredPropUndefined([{ prop: this.label, propName: "label" }], "Search Bar");
+    if (this.inputEl !== undefined) {
+      this.anchorEl = this.inputEl.shadowRoot.querySelector("ic-input-component-container");
+    }
+  }
+  componentWillRender() {
+    this.highlightFirstOptionAfterNoResults();
+  }
   handleKeyDown(ev) {
     const keyEv = ev.detail.event;
     if (this.menu && this.open) {
@@ -320,36 +405,22 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
       this.preventSubmit = false;
     }
   }
+  /**
+   * Sets focus on the native `input`.
+   */
+  async setFocus() {
+    this.retryViaKeyPress = false;
+    this.retryButtonClick = false;
+    if (this.inputEl) {
+      this.inputEl.setFocus();
+    }
+  }
   debounceAriaLiveUpdate() {
     clearTimeout(this.debounceAriaLive);
     this.debounceAriaLive = window.setTimeout(() => {
       this.updateSearchResultAriaLive();
     }, 500);
   }
-  componentWillRender() {
-    this.highlightFirstOptionAfterNoResults();
-  }
-  componentWillLoad() {
-    this.watchValueHandler(this.value);
-  }
-  componentDidLoad() {
-    if (this.focusOnLoad) {
-      this.el.setFocus();
-    }
-    if (this.hasOptionsOrFilterDisabled()) {
-      this.renderAssistiveHintEl();
-      if (this.disableFilter) {
-        this.filteredOptions = this.options;
-      }
-    }
-    onComponentRequiredPropUndefined([{ prop: this.label, propName: "label" }], "Search Bar");
-    this.anchorEl = this.inputEl.shadowRoot.querySelector("ic-input-component-container");
-  }
-  disconnectedCallback() {
-    if (this.assistiveHintEl) {
-      this.assistiveHintEl.remove();
-    }
-  }
   render() {
     const { inputId, name, label, required, small, placeholder, helperText, disabled, value, readonly, spellcheck, fullWidth, options, open, hideLabel, menuId, ariaActiveDescendant, truncateValue, autofocus, autocapitalize, autocomplete, filteredOptions, } = this;
     const disabledMode = readonly || disabled ? true : false;
@@ -370,6 +441,9 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     const disabledText = disabledMode && !readonly;
     const hasSuggestedSearch = value && this.hasOptionsOrFilterDisabled();
     const menuOpen = hasSuggestedSearch && open && filteredOptions.length > 0;
+    const isOrHasLoaded = this.filteredOptions.length === 1 &&
+      (this.filteredOptions[0].label === this.loadingLabel ||
+        filteredOptions[0].label === this.loadingErrorLabel);
     let expanded;
     if (options.length > 0) {
       if (menuOpen) {
@@ -407,48 +481,54 @@ const SearchBar = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
         "menu-container": true,
         fullwidth: fullWidth,
       }, slot: "menu" }, menuOpen && value.length >= this.charactersUntilSuggestion && (h("ic-menu", { class: {
-        "no-results": this.hadNoOptions(),
-      }, activationType: "manual", anchorEl: this.anchorEl, autoFocusOnSelected: false, inputEl: this.inputEl, inputLabel: label, ref: (el) => (this.menu = el), small: small, fullWidth: fullWidth, menuId: menuId, open: true, options: filteredOptions, onMenuOptionSelect: this.handleOptionSelect, onMenuStateChange: this.handleMenuChange, onMenuOptionId: this.handleMenuOptionHighlight, parentEl: this.el, value: value })))), h("div", { "aria-live": "polite", role: "status", class: "search-results-status" })));
+        "no-results": this.hadNoOptions() || isOrHasLoaded,
+      }, activationType: "manual", anchorEl: this.anchorEl, autoFocusOnSelected: false, searchMode: this.searchMode, inputEl: this.inputEl, inputLabel: label, ref: (el) => (this.menu = el), small: small, fullWidth: fullWidth, menuId: menuId, open: true, options: filteredOptions, onMenuOptionSelect: this.handleOptionSelect, onMenuStateChange: this.handleMenuChange, onMenuOptionId: this.handleMenuOptionHighlight, onRetryButtonClicked: this.handleRetry, parentEl: this.el, value: value })))), h("div", { "aria-live": "polite", role: "status", class: "search-results-status" })));
   }
   static get delegatesFocus() { return true; }
   get el() { return this; }
   static get watchers() { return {
+    "loading": ["loadingHandler"],
+    "filteredOptions": ["filteredOptionsHandler"],
     "options": ["watchOptionsHandler"],
     "value": ["watchValueHandler"]
   }; }
   static get style() { return icSearchBarCss; }
 }, [17, "ic-search-bar", {
-    "label": [1],
-    "required": [4],
-    "disabled": [4],
-    "readonly": [4],
-    "placeholder": [1],
-    "fullWidth": [4, "full-width"],
-    "disableFilter": [4, "disable-filter"],
-    "hideLabel": [4, "hide-label"],
-    "helperText": [1, "helper-text"],
-    "small": [4],
-    "value": [1537],
     "autocapitalize": [1],
     "autocomplete": [1],
     "autocorrect": [1],
     "autofocus": [4],
+    "charactersUntilSuggestion": [2, "characters-until-suggestion"],
+    "disabled": [4],
+    "disableFilter": [4, "disable-filter"],
     "debounce": [2],
+    "emptyOptionListText": [1, "empty-option-list-text"],
+    "focusOnLoad": [4, "focus-on-load"],
+    "fullWidth": [4, "full-width"],
+    "helperText": [1, "helper-text"],
+    "hideLabel": [4, "hide-label"],
+    "hintText": [1, "hint-text"],
+    "label": [1],
+    "loading": [1028],
+    "loadingErrorLabel": [1, "loading-error-label"],
+    "loadingLabel": [1, "loading-label"],
     "name": [1],
+    "placeholder": [1],
+    "readonly": [4],
+    "required": [4],
+    "searchMode": [1, "search-mode"],
+    "small": [4],
     "spellcheck": [4],
+    "timeout": [2],
     "options": [16],
-    "focusOnLoad": [4, "focus-on-load"],
-    "hintText": [1, "hint-text"],
-    "emptyOptionListText": [1, "empty-option-list-text"],
-    "charactersUntilSuggestion": [2, "characters-until-suggestion"],
-    "open": [32],
-    "filteredOptions": [32],
+    "value": [1537],
     "ariaActiveDescendant": [32],
-    "showClearButton": [32],
     "clearButtonFocused": [32],
-    "searchSubmitFocused": [32],
-    "prevNoOption": [32],
     "highlightedValue": [32],
+    "open": [32],
+    "searchSubmitFocused": [32],
+    "showClearButton": [32],
+    "filteredOptions": [32],
     "setFocus": [64]
   }, [[0, "icKeydown", "handleKeyDown"], [0, "keyup", "handleKeyUp"]]]);
 function defineCustomElement$1() {