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

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

@@ -1,9 +1,19 @@
-import { h, Host, } from "@stencil/core";
+import { h, Host, Fragment, } from "@stencil/core";
 import { createPopper } from "@popperjs/core";
 import Check from "../../assets/check-icon.svg";
 import { onComponentRequiredPropUndefined } from "../../utils/helpers";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 export class Menu {
   constructor() {
+    this.firstRender = true;
+    this.hasPreviouslyBlurred = false;
+    this.hasTimedOut = false;
+    this.isLoading = false;
+    this.isSearchBar = false;
+    this.isSearchableSelect = false;
+    // Prevents menu re-opening immediately after it is closed on blur when clicking input.
+    this.preventClickOpen = false;
+    this.ungroupedOptions = [];
     this.handleClearListener = () => {
       this.optionHighlighted = "";
     };
@@ -11,13 +21,7 @@ export class Menu {
       const highlightedOptionIndex = this.options.findIndex((option) => option.value === this.optionHighlighted);
       this.setInputValue(highlightedOptionIndex);
     };
-    this.ungroupedOptions = [];
-    // Prevents menu re-opening immediately after it is closed on blur when clicking input
-    this.preventClickOpen = false;
-    this.isSearchBar = false;
     this.handleMenuChange = (open, focusInput) => {
-      if (!open)
-        this.popperInstance.destroy();
       this.menuStateChange.emit({ open, focusInput });
       if (!open && focusInput !== false) {
         this.inputEl.focus();
@@ -52,18 +56,31 @@ export class Menu {
         });
       }
     };
+    this.getParentEl = (parent) => {
+      if (parent.tagName === "IC-SEARCH-BAR") {
+        this.isSearchBar = true;
+      }
+      else if (parent.tagName === "IC-SELECT" &&
+        parent.getAttribute("searchable") !== null &&
+        parent.getAttribute("searchable") !== undefined) {
+        this.isSearchableSelect = true;
+      }
+    };
     this.arrowBehaviour = (event) => {
       event.preventDefault();
       this.handleMenuChange(true);
     };
+    this.setMenuOptions = () => this.isSearchBar ? this.options : this.ungroupedOptions;
     this.setHighlightedOption = (highlightedIndex) => {
-      this.optionHighlighted = this.options[highlightedIndex].value || undefined;
+      const menuOptions = this.setMenuOptions();
+      menuOptions[highlightedIndex] &&
+        !menuOptions[highlightedIndex].timedOut &&
+        (this.optionHighlighted =
+          menuOptions[highlightedIndex].value || undefined);
     };
     this.autoSetInputValueKeyboardOpen = (event) => {
-      var _a;
       const selectedOptionIndex = this.ungroupedOptions.findIndex((option) => option.value === this.value);
       this.keyboardNav = false;
-      const isSearchableSelect = ((_a = this.inputEl) === null || _a === void 0 ? void 0 : _a.tagName) === "INPUT";
       switch (event.key) {
         case "ArrowDown":
           this.keyboardNav = true;
@@ -81,25 +98,19 @@ export class Menu {
             this.handleMenuChange(true);
           }
           break;
-        case "Backspace":
-          if (isSearchableSelect) {
-            this.inputEl.focus();
-          }
-          break;
-        default:
-          if (isSearchableSelect && event.key !== "Tab") {
-            this.inputEl.focus();
-          }
-          break;
       }
     };
     this.manSetInputValueKeyboardOpen = (event) => {
-      const highlightedOptionIndex = this.options.findIndex((option) => option.value === this.optionHighlighted);
-      const getOptionId = (index) => Array.from(this.host.shadowRoot.querySelectorAll("li"))[index].id;
+      var _a;
+      const menuOptions = this.setMenuOptions();
+      this.keyboardNav = false;
+      const highlightedOptionIndex = menuOptions.findIndex((option) => option.value === this.optionHighlighted);
+      const getOptionId = (index) => { var _a; return (_a = Array.from(this.host.querySelectorAll("li"))[index]) === null || _a === void 0 ? void 0 : _a.id; };
       switch (event.key) {
         case "ArrowDown":
+          this.keyboardNav = true;
           this.arrowBehaviour(event);
-          if (highlightedOptionIndex < this.options.length - 1) {
+          if (highlightedOptionIndex < menuOptions.length - 1) {
             this.setHighlightedOption(highlightedOptionIndex + 1);
             this.menuOptionId.emit({
               optionId: getOptionId(highlightedOptionIndex + 1),
@@ -115,12 +126,13 @@ export class Menu {
           this.focusFromSearchKeypress = false;
           break;
         case "ArrowUp":
+          this.keyboardNav = true;
           this.arrowBehaviour(event);
           if (highlightedOptionIndex <= 0 ||
-            highlightedOptionIndex > this.options.length + 1) {
-            this.setHighlightedOption(this.options.length - 1);
+            highlightedOptionIndex > menuOptions.length + 1) {
+            this.setHighlightedOption(menuOptions.length - 1);
             this.menuOptionId.emit({
-              optionId: getOptionId(this.options.length - 1),
+              optionId: getOptionId(menuOptions.length - 1),
             });
           }
           else {
@@ -132,60 +144,110 @@ export class Menu {
           this.preventIncorrectTabOrder = false;
           this.focusFromSearchKeypress = false;
           break;
+        case "Home":
+          this.keyboardNav = true;
+          event.preventDefault();
+          this.arrowBehaviour(event);
+          this.setHighlightedOption(0);
+          this.menuOptionId.emit({
+            optionId: getOptionId(0),
+          });
+          break;
+        case "End":
+          this.keyboardNav = true;
+          event.preventDefault();
+          this.arrowBehaviour(event);
+          this.setHighlightedOption(menuOptions.length - 1);
+          this.menuOptionId.emit({
+            optionId: getOptionId(menuOptions.length - 1),
+          });
+          break;
         case "Enter":
           event.preventDefault();
           this.setInputValue(highlightedOptionIndex);
+          this.value = (_a = menuOptions[highlightedOptionIndex]) === null || _a === void 0 ? void 0 : _a.value;
           break;
         case "Escape":
+          if (this.open) {
+            event.stopImmediatePropagation();
+          }
           this.handleMenuChange(false);
           this.menuOptionId.emit({ optionId: undefined });
           break;
         case "Shift":
         case "Tab":
+          if (this.isSearchBar) {
+            this.keyboardNav = true;
+          }
           this.preventIncorrectTabOrder = true;
           break;
         case "Backspace":
           if (this.isSearchBar) {
             this.parentEl.setFocus();
-            this.focusFromSearchKeypress = true;
-            this.setHighlightedOption(0);
+            if (this.searchMode === "navigation")
+              this.setHighlightedOption(0);
+          }
+          else if (this.isSearchableSelect) {
+            this.parentEl.setFocus();
           }
+          this.focusFromSearchKeypress = true;
           break;
         default:
-          if (this.isSearchBar && event.key !== "Tab") {
-            this.parentEl.setFocus();
+          if (event.key !== "Tab") {
+            if (this.isSearchBar) {
+              this.parentEl.setFocus();
+              if (this.searchMode === "navigation")
+                this.setHighlightedOption(0);
+            }
+            else if (this.isSearchableSelect) {
+              this.parentEl.setFocus();
+            }
             this.focusFromSearchKeypress = true;
-            this.setHighlightedOption(0);
           }
           break;
       }
     };
     this.setInputValue = (highlightedOptionIndex) => {
       var _a;
-      if (this.options[highlightedOptionIndex]) {
+      const menuOptions = this.setMenuOptions();
+      if (menuOptions[highlightedOptionIndex]) {
         this.menuOptionSelect.emit({
-          value: (_a = this.options[highlightedOptionIndex]) === null || _a === void 0 ? void 0 : _a.value,
+          value: (_a = menuOptions[highlightedOptionIndex]) === null || _a === void 0 ? void 0 : _a.value,
         });
         this.optionHighlighted = undefined;
         this.menuOptionId.emit({ optionId: undefined });
       }
-      this.handleMenuChange(false);
+      if (!this.hasTimedOut)
+        this.handleMenuChange(false);
+      else
+        this.parentEl.setFocus();
     };
     this.handleOptionClick = (event) => {
       const { value, label } = event.target.dataset;
       this.menuOptionSelect.emit({ value, label });
       this.handleMenuChange(false);
     };
+    this.handleRetry = () => {
+      this.retryButtonClicked.emit({ value: this.value });
+    };
+    this.handleRetryKeyDown = (ev) => {
+      if (ev.key === "Enter" || ev.key === " ") {
+        ev.preventDefault();
+        this.retryButtonClicked.emit({ value: this.value, keyPressed: ev.key });
+      }
+    };
     this.handleBlur = (event) => {
       if (event.relatedTarget !== this.inputEl) {
         if (!this.menu.contains(event.relatedTarget)) {
-          this.handleMenuChange(false, false);
+          this.handleMenuChange(false, this.hasPreviouslyBlurred);
         }
       }
       else {
         this.handleMenuChange(false);
         this.preventClickOpen = true;
       }
+      if (!this.isSearchBar)
+        this.hasPreviouslyBlurred = !!event.relatedTarget;
     };
     this.handleMouseDown = (event) => {
       event.preventDefault();
@@ -194,9 +256,12 @@ export class Menu {
       if (this.activationType === "automatic") {
         this.autoSetValueOnMenuKeyDown(event);
       }
+      else if (this.activationType === "manual" && this.isSearchableSelect) {
+        this.manSetInputValueKeyboardOpen(event);
+      }
     };
-    this.emitMenuKeyPress = (isNavKey) => {
-      this.menuKeyPress.emit({ isNavKey: isNavKey });
+    this.emitMenuKeyPress = (isNavKey, key) => {
+      this.menuKeyPress.emit({ isNavKey: isNavKey, key: key });
     };
     this.autoSetValueOnMenuKeyDown = (event) => {
       event.cancelBubble = true;
@@ -204,15 +269,22 @@ export class Menu {
       const isSearchableSelect = this.inputEl.tagName === "INPUT";
       this.keyboardNav = false;
       switch (event.key) {
-        case "ArrowUp":
+        case " ":
           event.preventDefault();
-          this.setPreviousOptionValue(selectedOptionIndex);
-          this.keyboardNav = true;
+          break;
+        case "ArrowUp":
+          if (!this.hasTimedOut) {
+            event.preventDefault();
+            this.setPreviousOptionValue(selectedOptionIndex);
+            this.keyboardNav = true;
+          }
           break;
         case "ArrowDown":
-          event.preventDefault();
-          this.setNextOptionValue(selectedOptionIndex);
-          this.keyboardNav = true;
+          if (!this.hasTimedOut) {
+            event.preventDefault();
+            this.setNextOptionValue(selectedOptionIndex);
+            this.keyboardNav = true;
+          }
           break;
         case "Home":
           this.menuOptionSelect.emit({
@@ -226,8 +298,9 @@ export class Menu {
           });
           this.keyboardNav = true;
           break;
-        case " ":
         case "Enter":
+          !this.hasTimedOut && this.handleMenuChange(false);
+          break;
         case "Escape":
           this.handleMenuChange(false);
           break;
@@ -239,12 +312,15 @@ export class Menu {
         case "Shift":
           break;
         default:
-          if (isSearchableSelect && event.key !== "Tab") {
+          if (isSearchableSelect && event.key !== "Tab" && !this.hasTimedOut) {
             this.inputEl.focus();
           }
+          if (event.key.length === 1) {
+            this.keyboardNav = true;
+          }
           break;
       }
-      this.emitMenuKeyPress(this.keyboardNav);
+      this.emitMenuKeyPress(this.keyboardNav, event.key);
     };
     this.handleMenuKeyUp = (event) => {
       if (event.key === "Tab" && event.shiftKey) {
@@ -267,7 +343,11 @@ export class Menu {
       }
     };
     this.getSortedOptions = (options) => {
-      return options.sort((optionA, optionB) => optionA.recommended && !optionB.recommended ? -1 : 0);
+      let sorted = [];
+      if (options.sort) {
+        sorted = options.sort((optionA, optionB) => optionA.recommended && !optionB.recommended ? -1 : 0);
+      }
+      return sorted;
     };
     this.isManualMode = this.activationType === "manual";
     this.scrollToSelected = (menu) => {
@@ -282,7 +362,7 @@ export class Menu {
       }
     };
     this.loadUngroupedOptions = () => {
-      if (this.options.length > 0) {
+      if (this.options.length > 0 && this.options.map) {
         this.options.map((option) => {
           if (option.children) {
             option.children.map((option) => !option.disabled && this.ungroupedOptions.push(option));
@@ -293,104 +373,103 @@ export class Menu {
         });
       }
       this.ungroupedOptions = this.getSortedOptions(this.ungroupedOptions);
+      this.ungroupedOptionsSet.emit({ options: this.ungroupedOptions });
+    };
+    this.setMenuScrollbar = () => {
+      let optionsHeight = 0;
+      this.host
+        .querySelectorAll(".option")
+        .forEach((option) => (optionsHeight += option.clientHeight));
+      if (optionsHeight >= 320) {
+        this.menu.classList.add("menu-scroll");
+      }
+    };
+    this.handleTimeoutBlur = (ev) => {
+      this.timeoutBlur.emit({ ev });
+    };
+    this.optionContent = (option) => {
+      var _a;
+      return (h(Fragment, null, option.loading && h("ic-loading-indicator", { size: "icon" }), h("div", { class: "option-text-container" }, h("ic-typography", { variant: "body", "aria-hidden": "true" }, h("p", null, option.label)), option.description && (h("ic-typography", { id: `${this.getOptionId(option === null || option === void 0 ? void 0 : option.value)}-description`, class: "option-description", variant: "caption", "aria-hidden": "true" }, h("p", null, option.description)))), !!option.value &&
+        !!this.value &&
+        (option === null || option === void 0 ? void 0 : option.value.toLowerCase()) === ((_a = this.value) === null || _a === void 0 ? void 0 : _a.toLowerCase()) &&
+        this.parentEl.tagName !== "IC-SEARCH-BAR" && (h("span", { class: "check-icon", innerHTML: Check }))));
     };
     this.displayOption = (option, index, parentOption) => {
-      const { open, value } = this;
+      const { open, value, keyboardNav, isManualMode, initialOptionsListRender, optionHighlighted, options, } = this;
       return (h("li", { id: this.getOptionId(option.value), class: {
           option: true,
-          "focused-option": this.isManualMode
-            ? (this.keyboardNav || this.initialOptionsListRender) &&
-              option.value === this.optionHighlighted
-            : this.keyboardNav && option.value === value,
+          "focused-option": isManualMode
+            ? (keyboardNav || initialOptionsListRender) &&
+              option.value === optionHighlighted
+            : keyboardNav && option.value === value,
           "last-recommended-option": option.recommended &&
-            this.options[index + 1] &&
-            !this.options[index + 1].recommended,
+            options[index + 1] &&
+            !options[index + 1].recommended,
           "disabled-option": option.disabled,
+          "loading-option": option.loading,
+          timeout: option.timedOut,
         }, role: "option", tabindex: open &&
-          (option.value === value || option.value === this.optionHighlighted) &&
-          this.keyboardNav
+          (option.value === value || option.value === optionHighlighted) &&
+          keyboardNav
           ? "0"
-          : "-1", "aria-label": this.getOptionAriaLabel(option, parentOption), "aria-selected": option.value === value, "aria-disabled": option.disabled ? "true" : "false", onClick: this.handleOptionClick, onBlur: this.handleBlur, onMouseDown: this.handleMouseDown, "data-value": option.value, "data-label": option.label }, h("div", { class: "option-text-container" }, h("ic-typography", { variant: "body", "aria-hidden": "true" }, h("p", null, option.label)), option.description && (h("ic-typography", { id: `${this.getOptionId(option.value)}-description`, class: "option-description", variant: "caption", "aria-hidden": "true" }, h("p", null, option.description)))), (option === null || option === void 0 ? void 0 : option.value.toLowerCase()) === (value === null || value === void 0 ? void 0 : value.toLowerCase()) &&
-        this.parentEl.tagName !== "IC-SEARCH-BAR" && (h("span", { class: "check-icon", innerHTML: Check }))));
+          : "-1", "aria-label": this.getOptionAriaLabel(option, parentOption), "aria-selected": option.value === value, "aria-disabled": option.disabled ? "true" : "false", onClick: !option.timedOut && !option.loading && this.handleOptionClick, onBlur: this.handleBlur, onMouseDown: this.handleMouseDown, "data-value": option.value, "data-label": option.label }, option.timedOut ? (h(Fragment, null, h("div", { class: "loading-error-info" }, h("svg", { class: "error-icon-svg", "aria-labelledby": "error-title", xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", fill: "#000000" }, h("title", { id: "error-title" }, "Error"), h("path", { d: "M0 0h24v24H0z", fill: "none" }), h("path", { d: "M12 2C6.47 2 2 6.47 2 12s4.47 10 10 10 10-4.47 10-10S17.53 2 12 2zm5 13.59L15.59 17 12 13.41 8.41 17 7 15.59 10.59 12 7 8.41 8.41 7 12 10.59 15.59 7 17 8.41 13.41 12 17 15.59z" })), h("ic-typography", { variant: "label" }, option.label)), h("ic-button", { size: "small", variant: "tertiary", onClick: this.handleRetry, onKeyDown: this.handleRetryKeyDown, onBlur: this.handleTimeoutBlur, id: "retry-button" }, "Retry"))) : (this.optionContent(option))));
     };
-    this.open = undefined;
-    this.options = undefined;
-    this.small = false;
-    this.menuId = undefined;
-    this.value = undefined;
-    this.activationType = "automatic";
-    this.inputEl = undefined;
-    this.parentEl = undefined;
-    this.inputLabel = undefined;
-    this.anchorEl = undefined;
-    this.fullWidth = false;
-    this.autoFocusOnSelected = true;
-    this.keyboardNav = false;
-    this.optionHighlighted = undefined;
     this.focusFromSearchKeypress = false;
     this.initialOptionsListRender = false;
+    this.keyboardNav = false;
+    this.optionHighlighted = undefined;
     this.preventIncorrectTabOrder = false;
+    this.activationType = "automatic";
+    this.anchorEl = undefined;
+    this.autoFocusOnSelected = true;
+    this.fullWidth = false;
+    this.inputEl = undefined;
+    this.inputLabel = undefined;
+    this.menuId = undefined;
+    this.open = undefined;
+    this.parentEl = undefined;
+    this.searchMode = "navigation";
+    this.small = false;
+    this.options = undefined;
+    this.value = undefined;
   }
-  watchOptionsHandler() {
+  watchOptionsHandler(newOptions) {
+    this.hasTimedOut = newOptions.some((opt) => opt.timedOut);
+    this.isLoading = newOptions.some((opt) => opt.loading);
     this.ungroupedOptions = [];
     this.loadUngroupedOptions();
   }
-  /**
-   * @internal If menu is opened with the mouse, emit menuStateChange custom event.
-   */
-  async handleClickOpen() {
-    if (!this.preventClickOpen) {
-      this.menuStateChange.emit({ open: !this.open });
-      this.keyboardNav = false;
-    }
-    this.preventClickOpen = false;
-  }
-  /**
-   * Used alongside activationType
-   * If menu is opened via keyboard navigation (i.e. Enter, ArrowUp or ArrowDown), emit optionSelect custom event.
-   * @param {KeyboardEvent} event - keyboard event
-   */
-  async handleKeyboardOpen(event) {
-    this.keyboardNav = false;
-    if (this.activationType === "automatic") {
-      this.autoSetInputValueKeyboardOpen(event);
-    }
-    else {
-      this.keyboardNav = true;
-      this.manSetInputValueKeyboardOpen(event);
-    }
-  }
-  /**
-   * @internal Used to highlight the first option in the menu.
-   */
-  async handleSetFirstOption() {
-    this.setHighlightedOption(0);
+  watchValueHandler() {
+    this.menuValueChange.emit({ value: this.value });
   }
   connectedCallback() {
-    var _a;
-    if (((_a = this.parentEl) === null || _a === void 0 ? void 0 : _a.tagName) === "IC-SEARCH-BAR") {
-      this.setHighlightedOption(0);
+    this.getParentEl(this.parentEl);
+    if (this.isSearchBar) {
+      if (this.searchMode === "navigation")
+        this.setHighlightedOption(0);
       this.initialOptionsListRender = true;
     }
   }
+  disconnectedCallback() {
+    if (this.popperInstance !== undefined) {
+      this.popperInstance.destroy();
+    }
+    this.parentEl.removeEventListener("icClear", this.handleClearListener);
+    this.parentEl.removeEventListener("icSubmitSearch", this.handleSubmitSearch);
+  }
   componentWillLoad() {
+    var _a, _b;
     this.loadUngroupedOptions();
-    this.isSearchBar = this.parentEl.tagName === "IC-SEARCH-BAR";
     this.parentEl.addEventListener("icClear", this.handleClearListener);
     this.parentEl.addEventListener("icSubmitSearch", this.handleSubmitSearch);
+    this.hasTimedOut = (_a = this.options) === null || _a === void 0 ? void 0 : _a.some((opt) => opt.timedOut);
+    this.isLoading = (_b = this.options) === null || _b === void 0 ? void 0 : _b.some((opt) => opt.loading);
   }
   componentDidLoad() {
     if (this.isSearchBar &&
       this.parentEl.disableFilter) {
       this.focusFromSearchKeypress = true;
     }
-    let optionsHeight = 0;
-    this.host.shadowRoot
-      .querySelectorAll(".option")
-      .forEach((option) => (optionsHeight += option.clientHeight));
-    if (optionsHeight >= 320) {
-      this.menu.classList.add("menu-scroll");
-    }
     onComponentRequiredPropUndefined([
       { prop: this.open, propName: "open" },
       { prop: this.options, propName: "options" },
@@ -399,28 +478,6 @@ export class Menu {
       //NOTE: no check for value, input-el or anchor-el as otherwise get console errors on first load of select component
     ], "Menu");
   }
-  componentDidRender() {
-    if (this.open) {
-      this.popperInstance = createPopper(this.anchorEl, this.host, {
-        placement: "bottom",
-        modifiers: [
-          {
-            name: "offset",
-            options: {
-              offset: [0, 7],
-            },
-          },
-          {
-            name: "flip",
-            options: {
-              fallbackPlacements: ["top"],
-              rootBoundary: "viewport",
-            },
-          },
-        ],
-      });
-    }
-  }
   componentDidUpdate() {
     const inputValueInOptions = this.options.some((option) => option.value === this.value);
     const optionHighlightedIsSet = this.optionHighlighted !== null &&
@@ -430,7 +487,8 @@ export class Menu {
       if (this.value &&
         this.keyboardNav &&
         inputValueInOptions &&
-        this.autoFocusOnSelected) {
+        this.autoFocusOnSelected &&
+        !this.isSearchableSelect) {
         this.scrollToSelected(this.menu);
       }
       else if (this.inputEl.tagName !== "IC-TEXT-FIELD" &&
@@ -440,26 +498,104 @@ export class Menu {
       else if (optionHighlightedIsSet &&
         !this.focusFromSearchKeypress &&
         !this.preventIncorrectTabOrder) {
-        const highlightedEl = this.host.shadowRoot.querySelector(`li[data-value="${this.optionHighlighted}"]`);
+        const highlightedEl = this.host.querySelector(`li[data-value="${this.optionHighlighted}"]`);
         if (highlightedEl) {
           highlightedEl.focus();
         }
       }
     }
   }
-  disconnectedCallback() {
-    this.parentEl.removeEventListener("icClear", this.handleClearListener);
-    this.parentEl.removeEventListener("icSubmitSearch", this.handleSubmitSearch);
+  componentDidRender() {
+    if (this.firstRender && this.open) {
+      this.firstRender = false;
+      let adjust = false;
+      const dialogEl = this.parentEl.closest("ic-dialog");
+      const onDialog = dialogEl !== null;
+      if (onDialog) {
+        this.host.classList.add("on-dialog");
+        if (dialogEl.getAttribute("data-overflow") === "false") {
+          const menuTop = this.host.getBoundingClientRect().top;
+          const menuHeight = this.host.getBoundingClientRect().height;
+          const dialogHeight = dialogEl.getBoundingClientRect().bottom;
+          if (menuTop + menuHeight > dialogHeight) {
+            adjust = true;
+          }
+        }
+        if (adjust === false) {
+          this.host.classList.add("on-dialog-fix-translate");
+        }
+      }
+      if (adjust) {
+        this.popperInstance = createPopper(this.anchorEl, this.host, {
+          placement: "top",
+        });
+      }
+      else {
+        this.popperInstance = createPopper(this.anchorEl, this.host, {
+          placement: "bottom",
+          modifiers: [
+            {
+              name: "offset",
+              options: {
+                offset: [0, 7],
+              },
+            },
+            {
+              name: "flip",
+              options: {
+                fallbackPlacements: ["top"],
+                rootBoundary: "viewport",
+              },
+            },
+          ],
+        });
+      }
+    }
+    else if (this.open) {
+      this.popperInstance.update();
+    }
+    if (this.open && !!this.options.length) {
+      this.setMenuScrollbar();
+    }
+  }
+  /**
+   * @internal If menu is opened with the mouse, emit menuStateChange custom event.
+   */
+  async handleClickOpen() {
+    if (!this.preventClickOpen) {
+      this.menuStateChange.emit({ open: !this.open });
+      this.keyboardNav = false;
+    }
+    this.preventClickOpen = false;
+  }
+  /**
+   * Used alongside activationType
+   * If menu is opened via keyboard navigation (i.e. Enter, ArrowUp or ArrowDown), emit optionSelect custom event.
+   * @param {KeyboardEvent} event - keyboard event
+   */
+  async handleKeyboardOpen(event) {
+    this.keyboardNav = false;
+    if (this.activationType === "automatic") {
+      this.autoSetInputValueKeyboardOpen(event);
+    }
+    else {
+      this.manSetInputValueKeyboardOpen(event);
+    }
+  }
+  /**
+   * @internal Used to highlight the first option in the menu.
+   */
+  async handleSetFirstOption() {
+    this.setHighlightedOption(0);
   }
   render() {
-    var _a, _b;
-    const { inputLabel, options, menuId, value, fullWidth } = this;
+    const { inputLabel, options, menuId, value, fullWidth, hasTimedOut, isLoading, small, open, inputEl, keyboardNav, } = this;
     return (h(Host, { class: {
         "full-width": fullWidth,
-        "no-focus": ((_a = this.inputEl) === null || _a === void 0 ? void 0 : _a.tagName) === "INPUT",
-      } }, options.length !== 0 && (h("ul", { id: menuId, class: "menu", role: "listbox", "aria-label": inputLabel, "aria-activedescendant": value != null && value !== "" ? this.getOptionId(value) : "", tabindex: open && !this.keyboardNav && ((_b = this.inputEl) === null || _b === void 0 ? void 0 : _b.tagName) !== "INPUT"
-        ? "0"
-        : "-1", ref: (el) => (this.menu = el), onKeyDown: this.handleMenuKeyDown, onKeyUp: this.handleMenuKeyUp, onBlur: this.handleBlur }, this.getSortedOptions(options).map((option, index) => {
+        "no-focus": (inputEl === null || inputEl === void 0 ? void 0 : inputEl.tagName) === "INPUT" || hasTimedOut || isLoading,
+        small: small,
+        open: open,
+      } }, options.length !== 0 && (h("ul", { id: menuId, class: "menu", role: "listbox", "aria-label": inputLabel, "aria-activedescendant": value != null && value !== "" ? this.getOptionId(value) : "", tabindex: open && !keyboardNav && (inputEl === null || inputEl === void 0 ? void 0 : inputEl.tagName) !== "INPUT" ? "0" : "-1", ref: (el) => (this.menu = el), onKeyDown: this.handleMenuKeyDown, onKeyUp: this.handleMenuKeyUp, onBlur: this.handleBlur }, this.getSortedOptions(options).map((option, index) => {
       if (option.children) {
         if (option.children.length > 0) {
           return (h("div", null, h("ic-typography", { class: "option-group-title", role: "presentation", variant: "subtitle-small" }, h("p", null, option.label)), option.children.map((childOption) => this.displayOption(childOption, index, option))));
@@ -474,7 +610,7 @@ export class Menu {
     })))));
   }
   static get is() { return "ic-menu"; }
-  static get encapsulation() { return "shadow"; }
+  static get encapsulation() { return "scoped"; }
   static get originalStyleUrls() {
     return {
       "$": ["ic-menu.css"]
@@ -487,33 +623,38 @@ export class Menu {
   }
   static get properties() {
     return {
-      "open": {
-        "type": "boolean",
+      "activationType": {
+        "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
-          "references": {}
+          "original": "IcActivationTypes",
+          "resolved": "\"automatic\" | \"manual\"",
+          "references": {
+            "IcActivationTypes": {
+              "location": "import",
+              "path": "../../utils/types"
+            }
+          }
         },
-        "required": true,
-        "optional": false,
+        "required": false,
+        "optional": true,
         "docs": {
           "tags": [],
-          "text": "If `true`, the menu will be displayed open."
+          "text": "Determines whether options manually set as values (by pressing 'Enter') when they receive focus using keyboard navigation."
         },
-        "attribute": "open",
-        "reflect": true
+        "attribute": "activation-type",
+        "reflect": false,
+        "defaultValue": "\"automatic\""
       },
-      "options": {
+      "anchorEl": {
         "type": "unknown",
         "mutable": false,
         "complexType": {
-          "original": "IcMenuOption[]",
-          "resolved": "IcMenuOption[]",
+          "original": "HTMLElement",
+          "resolved": "HTMLElement",
           "references": {
-            "IcMenuOption": {
-              "location": "import",
-              "path": "../../utils/types"
+            "HTMLElement": {
+              "location": "global"
             }
           }
         },
@@ -521,10 +662,10 @@ export class Menu {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The possible menu selection options."
+          "text": "The reference to an anchor element the menu will position itself from when rendered."
         }
       },
-      "small": {
+      "autoFocusOnSelected": {
         "type": "boolean",
         "mutable": false,
         "complexType": {
@@ -533,33 +674,56 @@ export class Menu {
           "references": {}
         },
         "required": false,
-        "optional": true,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "If `true`, autofocus will be applied on selected item when menu is open."
+            }],
+          "text": ""
+        },
+        "attribute": "auto-focus-on-selected",
+        "reflect": false,
+        "defaultValue": "true"
+      },
+      "fullWidth": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
         "docs": {
           "tags": [],
-          "text": "If `true`, the small styling will be applied to the menu."
+          "text": "If `true`, the menu will fill the width of the container."
         },
-        "attribute": "small",
-        "reflect": true,
+        "attribute": "full-width",
+        "reflect": false,
         "defaultValue": "false"
       },
-      "menuId": {
-        "type": "string",
+      "inputEl": {
+        "type": "unknown",
         "mutable": false,
         "complexType": {
-          "original": "string",
-          "resolved": "string",
-          "references": {}
+          "original": "HTMLElement",
+          "resolved": "HTMLElement",
+          "references": {
+            "HTMLElement": {
+              "location": "global"
+            }
+          }
         },
         "required": true,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The ID of the menu."
-        },
-        "attribute": "menu-id",
-        "reflect": false
+          "text": "The reference to the input element."
+        }
       },
-      "value": {
+      "inputLabel": {
         "type": "string",
         "mutable": false,
         "complexType": {
@@ -571,52 +735,44 @@ export class Menu {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The value of the currently selected option."
+          "text": "The label for the input element."
         },
-        "attribute": "value",
+        "attribute": "input-label",
         "reflect": false
       },
-      "activationType": {
+      "menuId": {
         "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "IcActivationTypes",
-          "resolved": "\"automatic\" | \"manual\"",
-          "references": {
-            "IcActivationTypes": {
-              "location": "import",
-              "path": "../../utils/types"
-            }
-          }
+          "original": "string",
+          "resolved": "string",
+          "references": {}
         },
-        "required": false,
-        "optional": true,
+        "required": true,
+        "optional": false,
         "docs": {
           "tags": [],
-          "text": "Determines whether options manually set as values (by pressing 'Enter') when they receive focus using keyboard navigation."
+          "text": "The ID of the menu."
         },
-        "attribute": "activation-type",
-        "reflect": false,
-        "defaultValue": "\"automatic\""
+        "attribute": "menu-id",
+        "reflect": false
       },
-      "inputEl": {
-        "type": "unknown",
+      "open": {
+        "type": "boolean",
         "mutable": false,
         "complexType": {
-          "original": "HTMLElement",
-          "resolved": "HTMLElement",
-          "references": {
-            "HTMLElement": {
-              "location": "global"
-            }
-          }
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
         },
         "required": true,
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The reference to the input element."
-        }
+          "text": "If `true`, the menu will be displayed open."
+        },
+        "attribute": "open",
+        "reflect": true
       },
       "parentEl": {
         "type": "unknown",
@@ -640,43 +796,30 @@ export class Menu {
           "text": ""
         }
       },
-      "inputLabel": {
+      "searchMode": {
         "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "string",
-          "resolved": "string",
-          "references": {}
-        },
-        "required": true,
-        "optional": false,
-        "docs": {
-          "tags": [],
-          "text": "The label for the input element."
-        },
-        "attribute": "input-label",
-        "reflect": false
-      },
-      "anchorEl": {
-        "type": "unknown",
-        "mutable": false,
-        "complexType": {
-          "original": "HTMLElement",
-          "resolved": "HTMLElement",
+          "original": "IcSearchBarSearchModes",
+          "resolved": "\"navigation\" | \"query\"",
           "references": {
-            "HTMLElement": {
-              "location": "global"
+            "IcSearchBarSearchModes": {
+              "location": "import",
+              "path": "../ic-search-bar/ic-search-bar.types"
             }
           }
         },
-        "required": true,
-        "optional": false,
+        "required": false,
+        "optional": true,
         "docs": {
           "tags": [],
-          "text": "The reference to an anchor element the menu will position itself from when rendered."
-        }
+          "text": "Specify the mode search bar uses to search. `navigation` allows for quick lookups of a set of values, `query` allows for more general searches."
+        },
+        "attribute": "search-mode",
+        "reflect": false,
+        "defaultValue": "\"navigation\""
       },
-      "fullWidth": {
+      "small": {
         "type": "boolean",
         "mutable": false,
         "complexType": {
@@ -685,49 +828,106 @@ export class Menu {
           "references": {}
         },
         "required": false,
-        "optional": false,
+        "optional": true,
         "docs": {
           "tags": [],
-          "text": "If `true`, the menu will fill the width of the container."
+          "text": "If `true`, the small styling will be applied to the menu."
         },
-        "attribute": "full-width",
-        "reflect": false,
+        "attribute": "small",
+        "reflect": true,
         "defaultValue": "false"
       },
-      "autoFocusOnSelected": {
-        "type": "boolean",
+      "options": {
+        "type": "unknown",
         "mutable": false,
         "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
+          "original": "IcMenuOption[]",
+          "resolved": "IcMenuOption[]",
+          "references": {
+            "IcMenuOption": {
+              "location": "import",
+              "path": "../../utils/types"
+            }
+          }
+        },
+        "required": true,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": "The possible menu selection options."
+        }
+      },
+      "value": {
+        "type": "string",
+        "mutable": true,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
           "references": {}
         },
-        "required": false,
+        "required": true,
         "optional": false,
         "docs": {
-          "tags": [{
-              "name": "internal",
-              "text": "If `true`, autofocus will be applied on selected item when menu is open."
-            }],
-          "text": ""
+          "tags": [],
+          "text": "The value of the currently selected option."
         },
-        "attribute": "auto-focus-on-selected",
-        "reflect": false,
-        "defaultValue": "true"
+        "attribute": "value",
+        "reflect": false
       }
     };
   }
   static get states() {
     return {
-      "keyboardNav": {},
-      "optionHighlighted": {},
       "focusFromSearchKeypress": {},
       "initialOptionsListRender": {},
+      "keyboardNav": {},
+      "optionHighlighted": {},
       "preventIncorrectTabOrder": {}
     };
   }
   static get events() {
     return [{
+        "method": "menuKeyPress",
+        "name": "menuKeyPress",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "Emitted when key is pressed while menu is open"
+            }],
+          "text": ""
+        },
+        "complexType": {
+          "original": "{ isNavKey: boolean; key: string }",
+          "resolved": "{ isNavKey: boolean; key: string; }",
+          "references": {}
+        }
+      }, {
+        "method": "menuOptionId",
+        "name": "menuOptionId",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "Emitted when an option has been highlighted"
+            }],
+          "text": ""
+        },
+        "complexType": {
+          "original": "IcMenuOptionIdEventDetail",
+          "resolved": "IcMenuOptionIdEventDetail",
+          "references": {
+            "IcMenuOptionIdEventDetail": {
+              "location": "import",
+              "path": "./ic-menu.types"
+            }
+          }
+        }
+      }, {
         "method": "menuOptionSelect",
         "name": "menuOptionSelect",
         "bubbles": true,
@@ -774,45 +974,95 @@ export class Menu {
           }
         }
       }, {
-        "method": "menuOptionId",
-        "name": "menuOptionId",
+        "method": "menuValueChange",
+        "name": "menuValueChange",
         "bubbles": true,
         "cancelable": true,
         "composed": true,
         "docs": {
           "tags": [{
               "name": "internal",
-              "text": "Emitted when an option has been highlighted"
+              "text": "Emitted when menu value changes."
             }],
           "text": ""
         },
         "complexType": {
-          "original": "IcMenuOptionIdEventDetail",
-          "resolved": "IcMenuOptionIdEventDetail",
+          "original": "IcValueEventDetail",
+          "resolved": "IcValueEventDetail",
           "references": {
-            "IcMenuOptionIdEventDetail": {
+            "IcValueEventDetail": {
               "location": "import",
-              "path": "./ic-menu.types"
+              "path": "../../utils/types"
             }
           }
         }
       }, {
-        "method": "menuKeyPress",
-        "name": "menuKeyPress",
+        "method": "retryButtonClicked",
+        "name": "retryButtonClicked",
         "bubbles": true,
         "cancelable": true,
         "composed": true,
         "docs": {
           "tags": [{
               "name": "internal",
-              "text": "Emitted when key is pressed while menu is open"
+              "text": "Emitted when the retry button is clicked"
             }],
           "text": ""
         },
         "complexType": {
-          "original": "{ isNavKey: boolean }",
-          "resolved": "{ isNavKey: boolean; }",
-          "references": {}
+          "original": "IcValueEventDetail",
+          "resolved": "IcValueEventDetail",
+          "references": {
+            "IcValueEventDetail": {
+              "location": "import",
+              "path": "../../utils/types"
+            }
+          }
+        }
+      }, {
+        "method": "timeoutBlur",
+        "name": "timeoutBlur",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "Emitted when the timeout menu loses focus"
+            }],
+          "text": ""
+        },
+        "complexType": {
+          "original": "{ ev: FocusEvent }",
+          "resolved": "{ ev: FocusEvent; }",
+          "references": {
+            "FocusEvent": {
+              "location": "global"
+            }
+          }
+        }
+      }, {
+        "method": "ungroupedOptionsSet",
+        "name": "ungroupedOptionsSet",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "Emitted when the ungrouped options have been set."
+            }],
+          "text": ""
+        },
+        "complexType": {
+          "original": "{ options: IcMenuOption[] }",
+          "resolved": "{ options: IcMenuOption[]; }",
+          "references": {
+            "IcMenuOption": {
+              "location": "import",
+              "path": "../../utils/types"
+            }
+          }
         }
       }];
   }
@@ -891,6 +1141,9 @@ export class Menu {
     return [{
         "propName": "options",
         "methodName": "watchOptionsHandler"
+      }, {
+        "propName": "value",
+        "methodName": "watchValueHandler"
       }];
   }
 }