@ukic/web-components 3.0.0-alpha.2 → 3.0.0-alpha.4

package/dist/components/ic-menu2.js

@@ -1,12 +1,12 @@
 import { proxyCustomElement, HTMLElement, createEvent, h, Fragment, Host } from '@stencil/core/internal/client';
 import { c as checkIcon } from './check-icon.js';
-import { o as onComponentRequiredPropUndefined } from './helpers.js';
+import { H as isMacDevice, o as onComponentRequiredPropUndefined, J as getOptionsWithoutGroupTitlesCount } from './helpers.js';
 import { d as defineCustomElement$4 } from './ic-button2.js';
 import { d as defineCustomElement$3 } from './ic-loading-indicator2.js';
 import { c as createPopper, d as defineCustomElement$2 } from './ic-tooltip2.js';
 import { d as defineCustomElement$1 } from './ic-typography2.js';
 
-const icMenuCss = "html.sc-ic-menu{line-height:1.15;-webkit-text-size-adjust:100%}body.sc-ic-menu{margin:0}main.sc-ic-menu{display:block}h1.sc-ic-menu{font-size:2em;margin:0.67em 0}hr.sc-ic-menu{box-sizing:content-box;height:0;overflow:visible}pre.sc-ic-menu{font-family:monospace, monospace;font-size:1em}a.sc-ic-menu{background-color:transparent}abbr[title].sc-ic-menu{border-bottom:none;text-decoration:underline;-webkit-text-decoration:underline dotted;text-decoration:underline dotted}b.sc-ic-menu,strong.sc-ic-menu{font-weight:bolder}code.sc-ic-menu,kbd.sc-ic-menu,samp.sc-ic-menu{font-family:monospace, monospace;font-size:1em}small.sc-ic-menu{font-size:80%}sub.sc-ic-menu,sup.sc-ic-menu{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub.sc-ic-menu{bottom:-0.25em}sup.sc-ic-menu{top:-0.5em}img.sc-ic-menu{border-style:none}button.sc-ic-menu,input.sc-ic-menu,optgroup.sc-ic-menu,select.sc-ic-menu,textarea.sc-ic-menu{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button.sc-ic-menu,input.sc-ic-menu{overflow:visible}button.sc-ic-menu,select.sc-ic-menu{text-transform:none}button.sc-ic-menu,[type=\"button\"].sc-ic-menu,[type=\"reset\"].sc-ic-menu,[type=\"submit\"].sc-ic-menu{-webkit-appearance:button}button.sc-ic-menu::-moz-focus-inner,[type=\"button\"].sc-ic-menu::-moz-focus-inner,[type=\"reset\"].sc-ic-menu::-moz-focus-inner,[type=\"submit\"].sc-ic-menu::-moz-focus-inner{border-style:none;padding:0}button.sc-ic-menu:-moz-focusring,[type=\"button\"].sc-ic-menu:-moz-focusring,[type=\"reset\"].sc-ic-menu:-moz-focusring,[type=\"submit\"].sc-ic-menu:-moz-focusring{outline:1px dotted ButtonText}fieldset.sc-ic-menu{padding:0.35em 0.75em 0.625em}legend.sc-ic-menu{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress.sc-ic-menu{vertical-align:baseline}textarea.sc-ic-menu{overflow:auto}[type=\"checkbox\"].sc-ic-menu,[type=\"radio\"].sc-ic-menu{box-sizing:border-box;padding:0}[type=\"number\"].sc-ic-menu::-webkit-inner-spin-button,[type=\"number\"].sc-ic-menu::-webkit-outer-spin-button{height:auto}[type=\"search\"].sc-ic-menu{-webkit-appearance:textfield;outline-offset:-2px}[type=\"search\"].sc-ic-menu::-webkit-search-decoration{-webkit-appearance:none}.sc-ic-menu::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details.sc-ic-menu{display:block}summary.sc-ic-menu{display:list-item}template.sc-ic-menu{display:none}[hidden].sc-ic-menu{display:none}html.sc-ic-menu,body.sc-ic-menu,div.sc-ic-menu,span.sc-ic-menu,applet.sc-ic-menu,object.sc-ic-menu,iframe.sc-ic-menu,h1.sc-ic-menu,h2.sc-ic-menu,h3.sc-ic-menu,h4.sc-ic-menu,h5.sc-ic-menu,h6.sc-ic-menu,p.sc-ic-menu,blockquote.sc-ic-menu,pre.sc-ic-menu,a.sc-ic-menu,abbr.sc-ic-menu,acronym.sc-ic-menu,address.sc-ic-menu,big.sc-ic-menu,cite.sc-ic-menu,code.sc-ic-menu,del.sc-ic-menu,dfn.sc-ic-menu,em.sc-ic-menu,img.sc-ic-menu,ins.sc-ic-menu,kbd.sc-ic-menu,q.sc-ic-menu,s.sc-ic-menu,samp.sc-ic-menu,small.sc-ic-menu,strike.sc-ic-menu,strong.sc-ic-menu,sub.sc-ic-menu,sup.sc-ic-menu,tt.sc-ic-menu,var.sc-ic-menu,b.sc-ic-menu,u.sc-ic-menu,i.sc-ic-menu,center.sc-ic-menu,dl.sc-ic-menu,dt.sc-ic-menu,dd.sc-ic-menu,ol.sc-ic-menu,ul.sc-ic-menu,li.sc-ic-menu,fieldset.sc-ic-menu,form.sc-ic-menu,label.sc-ic-menu,legend.sc-ic-menu,table.sc-ic-menu,caption.sc-ic-menu,tbody.sc-ic-menu,tfoot.sc-ic-menu,thead.sc-ic-menu,tr.sc-ic-menu,th.sc-ic-menu,td.sc-ic-menu,article.sc-ic-menu,aside.sc-ic-menu,canvas.sc-ic-menu,details.sc-ic-menu,embed.sc-ic-menu,figure.sc-ic-menu,figcaption.sc-ic-menu,footer.sc-ic-menu,header.sc-ic-menu,hgroup.sc-ic-menu,menu.sc-ic-menu,nav.sc-ic-menu,output.sc-ic-menu,ruby.sc-ic-menu,section.sc-ic-menu,summary.sc-ic-menu,time.sc-ic-menu,mark.sc-ic-menu,audio.sc-ic-menu,video.sc-ic-menu{margin:0;padding:0;border:0;font-size:100%;font-style:inherit;vertical-align:baseline}@media (prefers-reduced-motion: no-preference){.ic-menu-open.sc-ic-menu-h .menu.sc-ic-menu{transition:max-height var(--ic-transition-duration-slow)}}.sc-ic-menu-h{border-radius:var(--ic-border-radius);max-height:0;width:var(--input-width, 20rem);color:var(--ic-color-text-primary);--ic-typography-color:var(--ic-color-text-primary);background-color:var(--ic-architectural-white);position:relative;z-index:var(--ic-z-index-menu);box-sizing:border-box;box-shadow:var(--ic-elevation-overlay)}.sc-ic-menu-h:not(.ic-menu-no-focus):focus-within{box-shadow:var(--ic-border-focus)}#retry-button.sc-ic-menu::part(button){height:var(--ic-space-lg)}.small.sc-ic-menu #retry-button.sc-ic-menu::part(button){height:var(--ic-space-md)}.on-dialog.sc-ic-menu-h{inset:auto !important}.menu.sc-ic-menu{text-decoration:none;list-style-type:none;border:var(--ic-border-width) solid var(--ic-architectural-400);border-radius:var(--ic-border-radius);background-color:var(--ic-architectural-white);visibility:hidden;max-height:0;overflow-y:hidden}.menu-scroll.sc-ic-menu{overflow-y:auto}.menu.sc-ic-menu:focus-visible{outline:none}.ic-menu-open.sc-ic-menu-h{max-height:none;display:block}.ic-menu-open.sc-ic-menu-h .menu.sc-ic-menu{visibility:visible;max-height:calc(var(--ic-space-xl) * 10 + var(--ic-space-xxxs))}.ic-menu-full-width.sc-ic-menu-h{width:100%}.option.sc-ic-menu{padding:var(--ic-space-xs) calc(var(--ic-space-xs) - var(--ic-space-1px));cursor:pointer;display:flex;align-items:center;overflow-wrap:anywhere}.option.sc-ic-menu:not(.loading-option){justify-content:space-between}.ic-menu-small.sc-ic-menu-h .option.sc-ic-menu{padding:var(--ic-space-xxs) calc(var(--ic-space-xs) - var(--ic-space-1px))}.ic-menu-large.sc-ic-menu-h .option.sc-ic-menu{padding:var(--ic-space-sm) calc(var(--ic-space-xs) - var(--ic-space-1px))}.option.sc-ic-menu:last-child{border-radius:0 0 var(--ic-space-1px) var(--ic-space-1px)}.option.sc-ic-menu:first-child{border-radius:var(--ic-space-1px) var(--ic-space-1px) 0 0}.option.sc-ic-menu:not(.disabled-option):hover{background-color:var(--ic-action-dark-bg-hover)}.option.sc-ic-menu:not(.disabled-option):active{background-color:var(--ic-action-dark-bg-pressed)}.option.sc-ic-menu:focus-visible{outline:var(--ic-hc-focus-outline)}.option.sc-ic-menu:not(.disabled-option) .option-description.sc-ic-menu{--ic-typography-color:var(--ic-color-text-secondary)}.option.sc-ic-menu .option-label.sc-ic-menu{display:flex;flex-direction:row;align-items:top}.option.sc-ic-menu .option-element.sc-ic-menu{margin-top:var(--ic-space-xxs)}.option.sc-ic-menu .option-icon.sc-ic-menu{height:var(--ic-space-md);width:var(--ic-space-md);margin-top:var(--ic-space-xxs);margin-right:var(--ic-space-xxxs)}.option-text-container.sc-ic-menu{pointer-events:none}.option.loading-option.sc-ic-menu .option-text-container.sc-ic-menu{margin-left:calc(var(--ic-space-xs) + var(--ic-space-xxxs));color:var(--ic-color-text-secondary);--ic-typography-color:var(--ic-color-text-secondary)}.error-icon-svg.sc-ic-menu{height:var(--ic-space-md);width:var(--ic-space-md);fill:var(--ic-status-error-default);align-self:center;display:flex;margin-right:calc(var(--ic-space-xxs) * 1.2)}.loading-error-info.sc-ic-menu{display:flex}.check-icon.sc-ic-menu{height:var(--ic-space-lg);width:var(--ic-space-lg);margin-left:var(--ic-space-xs);pointer-events:none}.focused-option.sc-ic-menu .check-icon.sc-ic-menu *.sc-ic-menu{fill:currentcolor}.option-group-title.sc-ic-menu{padding:var(--ic-space-lg) calc(var(--ic-space-xs) - var(--ic-space-1px))\n    var(--ic-space-xs);--ic-typography-color:var(--ic-color-text-tertiary)}.ic-menu-small.sc-ic-menu-h .option-group-title.sc-ic-menu{padding:var(--ic-space-sm) calc(var(--ic-space-xs) - var(--ic-space-1px))\n    var(--ic-space-xxs)}.last-recommended-option.sc-ic-menu{border-bottom:var(--ic-border-default)}.disabled-option.sc-ic-menu{color:var(--ic-architectural-200);--ic-typography-color:var(--ic-architectural-200);cursor:default;pointer-events:none}.focused-option.sc-ic-menu,.focused-option.sc-ic-menu .option-description.sc-ic-menu{background-color:var(--ic-color-focus-inner) !important;color:var(--ic-architectural-white) !important;--ic-typography-color:var(--ic-architectural-white) !important}.no-results.sc-ic-menu-h li.sc-ic-menu{cursor:no-drop}.no-results.sc-ic-menu-h li.sc-ic-menu:hover{background-color:transparent}@media (forced-colors: active){.focused-option.sc-ic-menu:focus{outline:none;border:0.125rem solid transparent}}";
+const icMenuCss = "html.sc-ic-menu{line-height:1.15;-webkit-text-size-adjust:100%}body.sc-ic-menu{margin:0}main.sc-ic-menu{display:block}h1.sc-ic-menu{font-size:2em;margin:0.67em 0}hr.sc-ic-menu{box-sizing:content-box;height:0;overflow:visible}pre.sc-ic-menu{font-family:monospace, monospace;font-size:1em}a.sc-ic-menu{background-color:transparent}abbr[title].sc-ic-menu{border-bottom:none;text-decoration:underline;-webkit-text-decoration:underline dotted;text-decoration:underline dotted}b.sc-ic-menu,strong.sc-ic-menu{font-weight:bolder}code.sc-ic-menu,kbd.sc-ic-menu,samp.sc-ic-menu{font-family:monospace, monospace;font-size:1em}small.sc-ic-menu{font-size:80%}sub.sc-ic-menu,sup.sc-ic-menu{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub.sc-ic-menu{bottom:-0.25em}sup.sc-ic-menu{top:-0.5em}img.sc-ic-menu{border-style:none}button.sc-ic-menu,input.sc-ic-menu,optgroup.sc-ic-menu,select.sc-ic-menu,textarea.sc-ic-menu{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button.sc-ic-menu,input.sc-ic-menu{overflow:visible}button.sc-ic-menu,select.sc-ic-menu{text-transform:none}button.sc-ic-menu,[type=\"button\"].sc-ic-menu,[type=\"reset\"].sc-ic-menu,[type=\"submit\"].sc-ic-menu{-webkit-appearance:button}button.sc-ic-menu::-moz-focus-inner,[type=\"button\"].sc-ic-menu::-moz-focus-inner,[type=\"reset\"].sc-ic-menu::-moz-focus-inner,[type=\"submit\"].sc-ic-menu::-moz-focus-inner{border-style:none;padding:0}button.sc-ic-menu:-moz-focusring,[type=\"button\"].sc-ic-menu:-moz-focusring,[type=\"reset\"].sc-ic-menu:-moz-focusring,[type=\"submit\"].sc-ic-menu:-moz-focusring{outline:1px dotted ButtonText}fieldset.sc-ic-menu{padding:0.35em 0.75em 0.625em}legend.sc-ic-menu{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress.sc-ic-menu{vertical-align:baseline}textarea.sc-ic-menu{overflow:auto}[type=\"checkbox\"].sc-ic-menu,[type=\"radio\"].sc-ic-menu{box-sizing:border-box;padding:0}[type=\"number\"].sc-ic-menu::-webkit-inner-spin-button,[type=\"number\"].sc-ic-menu::-webkit-outer-spin-button{height:auto}[type=\"search\"].sc-ic-menu{-webkit-appearance:textfield;outline-offset:-2px}[type=\"search\"].sc-ic-menu::-webkit-search-decoration{-webkit-appearance:none}.sc-ic-menu::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details.sc-ic-menu{display:block}summary.sc-ic-menu{display:list-item}template.sc-ic-menu{display:none}[hidden].sc-ic-menu{display:none}html.sc-ic-menu,body.sc-ic-menu,div.sc-ic-menu,span.sc-ic-menu,applet.sc-ic-menu,object.sc-ic-menu,iframe.sc-ic-menu,h1.sc-ic-menu,h2.sc-ic-menu,h3.sc-ic-menu,h4.sc-ic-menu,h5.sc-ic-menu,h6.sc-ic-menu,p.sc-ic-menu,blockquote.sc-ic-menu,pre.sc-ic-menu,a.sc-ic-menu,abbr.sc-ic-menu,acronym.sc-ic-menu,address.sc-ic-menu,big.sc-ic-menu,cite.sc-ic-menu,code.sc-ic-menu,del.sc-ic-menu,dfn.sc-ic-menu,em.sc-ic-menu,img.sc-ic-menu,ins.sc-ic-menu,kbd.sc-ic-menu,q.sc-ic-menu,s.sc-ic-menu,samp.sc-ic-menu,small.sc-ic-menu,strike.sc-ic-menu,strong.sc-ic-menu,sub.sc-ic-menu,sup.sc-ic-menu,tt.sc-ic-menu,var.sc-ic-menu,b.sc-ic-menu,u.sc-ic-menu,i.sc-ic-menu,center.sc-ic-menu,dl.sc-ic-menu,dt.sc-ic-menu,dd.sc-ic-menu,ol.sc-ic-menu,ul.sc-ic-menu,li.sc-ic-menu,fieldset.sc-ic-menu,form.sc-ic-menu,label.sc-ic-menu,legend.sc-ic-menu,table.sc-ic-menu,caption.sc-ic-menu,tbody.sc-ic-menu,tfoot.sc-ic-menu,thead.sc-ic-menu,tr.sc-ic-menu,th.sc-ic-menu,td.sc-ic-menu,article.sc-ic-menu,aside.sc-ic-menu,canvas.sc-ic-menu,details.sc-ic-menu,embed.sc-ic-menu,figure.sc-ic-menu,figcaption.sc-ic-menu,footer.sc-ic-menu,header.sc-ic-menu,hgroup.sc-ic-menu,menu.sc-ic-menu,nav.sc-ic-menu,output.sc-ic-menu,ruby.sc-ic-menu,section.sc-ic-menu,summary.sc-ic-menu,time.sc-ic-menu,mark.sc-ic-menu,audio.sc-ic-menu,video.sc-ic-menu{margin:0;padding:0;border:0;font-size:100%;font-style:inherit;vertical-align:baseline}@media (prefers-reduced-motion: no-preference){.ic-menu-open.sc-ic-menu-h .menu.sc-ic-menu{transition:max-height var(--ic-transition-duration-slow)}}.sc-ic-menu-h{max-height:0;width:var(--menu-width, var(--input-width, 20rem));color:var(--menu-item-text-color, var(--ic-color-text-primary));--ic-typography-color:var(\n    --menu-item-text-color,\n    var(--ic-color-text-primary)\n  );background-color:var(--menu-bg-color, var(--ic-architectural-white));position:relative;z-index:var(--ic-z-index-menu);box-sizing:border-box;box-shadow:var(--ic-elevation-overlay);border-radius:var(--ic-border-radius)}.ic-menu-open.sc-ic-menu-h:not(.ic-menu-no-focus):focus-within{box-shadow:var(--ic-border-focus);outline:var(--ic-hc-focus-outline)}.ic-select-select-all-focused.sc-ic-menu-h{box-shadow:var(--ic-elevation-overlay) !important}#retry-button.sc-ic-menu::part(button){height:var(--ic-space-lg)}.small.sc-ic-menu #retry-button.sc-ic-menu::part(button){height:var(--ic-space-md)}.on-dialog.sc-ic-menu-h{inset:auto !important}.menu.sc-ic-menu{text-decoration:none;list-style-type:none;border-radius:1px;background-color:var(--menu-bg-color, var(--ic-architectural-white));visibility:hidden;max-height:0;overflow-y:hidden}.menu.sc-ic-menu:has(+.option-bar).sc-ic-menu{border-radius:0 0 1px 1px}.menu-scroll.sc-ic-menu{overflow-y:auto}.menu.sc-ic-menu:focus-visible{outline:none}.ic-menu-open.sc-ic-menu-h{max-height:none;display:flex;flex-direction:column-reverse;border:var(--ic-border-width) solid\n    var(--menu-border-color, var(--ic-architectural-400));transition:box-shadow var(--ic-easing-transition-fast)}.ic-menu-open.sc-ic-menu-h .menu.sc-ic-menu{visibility:visible;max-height:calc(var(--ic-space-xl) * 10 + var(--ic-space-xxxs))}.ic-menu-open.sc-ic-menu-h .option-bar.sc-ic-menu{visibility:visible}.ic-menu-open.sc-ic-menu-h .select-all-button.sc-ic-menu{display:block}.ic-menu-full-width.sc-ic-menu-h{width:100%}.option.sc-ic-menu{padding:var(--ic-space-xs) calc(var(--ic-space-xs) - var(--ic-space-1px));cursor:pointer;display:flex;align-items:center}.loading-option.sc-ic-menu p.sc-ic-menu{margin-bottom:0 !important}.option.sc-ic-menu:not(.loading-option){justify-content:space-between}.ic-menu-small.sc-ic-menu-h .option.sc-ic-menu{padding:var(--ic-space-xxs) calc(var(--ic-space-xs) - var(--ic-space-1px))}.ic-menu-large.sc-ic-menu-h .option.sc-ic-menu{padding:var(--ic-space-sm) calc(var(--ic-space-xs) - var(--ic-space-1px))}.option.sc-ic-menu:last-child{border-radius:0 0 1px 1px}.sc-ic-menu:not(.menu:has(+.option-bar)).sc-ic-menu .option.sc-ic-menu:first-child{border-radius:1px 1px 0 0}.option.sc-ic-menu:not(.disabled-option):hover{background-color:var(--ic-action-dark-bg-hover)}.option.sc-ic-menu:not(.disabled-option):active{background-color:var(--ic-action-dark-bg-pressed)}.option.sc-ic-menu:focus-visible{outline:var(--ic-hc-focus-outline)}.option.sc-ic-menu:not(.disabled-option) .option-description.sc-ic-menu{--ic-typography-color:var(--ic-color-text-secondary)}.option.sc-ic-menu .option-label.sc-ic-menu{display:flex;flex-direction:row;align-items:top}.option.sc-ic-menu .option-label.sc-ic-menu ic-typography.sc-ic-menu{max-width:100%;word-wrap:break-word}.option.sc-ic-menu .option-element.sc-ic-menu{margin-top:var(--ic-space-xxs)}.option.sc-ic-menu .option-icon.sc-ic-menu{height:var(--ic-space-md);width:var(--ic-space-md);margin-top:var(--ic-space-xxs);margin-right:var(--ic-space-xxxs)}.option-text-container.sc-ic-menu{pointer-events:none;width:100%}.option-text-container.show-check-icon.sc-ic-menu{width:calc(var(--ic-space-lg) * 10 + var(--ic-space-xl))}.option.loading-option.sc-ic-menu .option-text-container.sc-ic-menu{margin-left:calc(var(--ic-space-xs) + var(--ic-space-xxxs));color:var(--ic-color-text-secondary);--ic-typography-color:var(--ic-color-text-secondary)}.error-icon-svg.sc-ic-menu{height:var(--ic-space-md);width:var(--ic-space-md);fill:var(--ic-status-error-default);align-self:center;display:flex;margin-right:calc(var(--ic-space-xxs) * 1.2)}.loading-error-info.sc-ic-menu{display:flex}.check-icon.sc-ic-menu{height:var(--ic-space-lg);min-width:var(--ic-space-lg);width:var(--ic-space-lg);margin-left:var(--ic-space-xs);pointer-events:none}.focused-option.sc-ic-menu .check-icon.sc-ic-menu *.sc-ic-menu{fill:currentcolor}.option-group-title.sc-ic-menu{padding:var(--ic-space-lg) calc(var(--ic-space-xs) - var(--ic-space-1px))\n    var(--ic-space-xs);--ic-typography-color:var(--ic-color-text-tertiary)}.ic-menu-small.sc-ic-menu-h .option-group-title.sc-ic-menu{padding:var(--ic-space-sm) calc(var(--ic-space-xs) - var(--ic-space-1px))\n    var(--ic-space-xxs)}.last-recommended-option.sc-ic-menu{border-bottom:var(--ic-border-default)}.disabled-option.sc-ic-menu{color:var(--ic-architectural-200);--ic-typography-color:var(--ic-architectural-200);cursor:default;pointer-events:none}.focused-option.sc-ic-menu,.focused-option.sc-ic-menu .option-description.sc-ic-menu{background-color:var(--ic-color-focus-inner) !important;color:var(--ic-architectural-white) !important;--ic-typography-color:var(--ic-architectural-white) !important}.no-results.sc-ic-menu-h li.sc-ic-menu{cursor:no-drop}.no-results.sc-ic-menu-h li.sc-ic-menu:hover{background-color:transparent}.option-bar.sc-ic-menu{padding:var(--ic-space-xxs) var(--ic-space-xs);display:flex;align-items:center;justify-content:space-between;background-color:var(--ic-architectural-40);visibility:hidden;border-bottom:var(--ic-border-width) solid var(--ic-architectural-400);border-radius:1px 1px 0 0}.option-bar.sc-ic-menu p.sc-ic-menu{margin-bottom:0 !important}.ic-menu-large.sc-ic-menu-h .option-bar.sc-ic-menu{padding:var(--ic-space-xs)}.select-all-button.sc-ic-menu{display:none}.select-all-button.sc-ic-menu:focus{z-index:calc(var(--ic-z-index-menu) + 1)}@media (forced-colors: active){.focused-option.sc-ic-menu:focus{outline:none;border:0.125rem solid transparent}}";
 
 const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
     constructor() {
@@ -15,19 +15,26 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
         this.menuKeyPress = createEvent(this, "menuKeyPress", 7);
         this.menuOptionId = createEvent(this, "menuOptionId", 7);
         this.menuOptionSelect = createEvent(this, "menuOptionSelect", 7);
+        this.menuOptionSelectAll = createEvent(this, "menuOptionSelectAll", 7);
         this.menuStateChange = createEvent(this, "menuStateChange", 7);
-        this.menuValueChange = createEvent(this, "menuValueChange", 7);
         this.retryButtonClicked = createEvent(this, "retryButtonClicked", 7);
         this.timeoutBlur = createEvent(this, "timeoutBlur", 7);
         this.ungroupedOptionsSet = createEvent(this, "ungroupedOptionsSet", 7);
+        this.ACTIVE_DESCENDANT = "aria-activedescendant";
+        this.CLEAR_BUTTON_ID = "clear-button";
         this.disabledOptionSelected = false;
         this.hasPreviouslyBlurred = false;
         this.hasTimedOut = false;
         this.isLoading = false;
+        this.isMultiSelect = 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.lastOptionSelected = null; // Index of last option selected
+        this.lastOptionFocused = null; // Index of last option focused
+        this.multiOptionClicked = null;
+        this.preventClickOpen = false; // Prevents menu re-opening immediately after it is closed on blur when clicking input.
+        this.preventMenuFocus = false; // (When multiple) ensures focus moves straight to select all button from menu.
+        this.shiftPressed = false;
         this.ungroupedOptions = [];
         this.handleClearListener = () => {
             this.optionHighlighted = "";
@@ -38,9 +45,16 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
         };
         this.handleMenuChange = (open, focusInput) => {
             this.menuStateChange.emit({ open, focusInput });
-            if (!open && focusInput !== false) {
-                this.inputEl.focus();
-                this.preventClickOpen = false;
+            if (!open) {
+                if (focusInput !== false) {
+                    this.inputEl.focus();
+                    this.preventClickOpen = false;
+                }
+                // Reset optionHighlighted so previously highlighted option doesn't get reselected when Enter pressed
+                if (this.isMultiSelect) {
+                    this.optionHighlighted = undefined;
+                    this.multiOptionClicked = null;
+                }
             }
         };
         this.setNextOptionValue = (selectedOptionIndex) => {
@@ -75,24 +89,34 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
             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;
+            else if (parent.tagName === "IC-SELECT") {
+                if (parent.getAttribute("searchable") !== null &&
+                    parent.getAttribute("searchable") !== undefined) {
+                    this.isSearchableSelect = true;
+                }
+                else if (parent.getAttribute("multiple") !== null &&
+                    parent.getAttribute("multiple") !== undefined) {
+                    this.isMultiSelect = true;
+                }
             }
         };
+        // Open menu when up or down arrow keys are pressed
         this.arrowBehaviour = (event) => {
             event.preventDefault();
             this.handleMenuChange(true);
         };
-        this.setMenuOptions = () => this.isSearchBar ? this.options : this.ungroupedOptions;
+        this.getMenuOptions = () => this.isSearchBar ? this.options : this.ungroupedOptions;
+        // Set option that is focused and so should show focus state
         this.setHighlightedOption = (highlightedIndex) => {
-            const menuOptions = this.setMenuOptions();
+            const menuOptions = this.getMenuOptions();
             menuOptions[highlightedIndex] &&
                 !menuOptions[highlightedIndex].timedOut &&
                 (this.optionHighlighted =
                     menuOptions[highlightedIndex][this.valueField] || undefined);
         };
+        // Determines keyboard behaviour when selection is automatic
+        // (i.e. you don't have to press Enter select an option - just focus on it)
+        // and menu is closed
         this.autoSetInputValueKeyboardOpen = (event) => {
             const selectedOptionIndex = this.ungroupedOptions.findIndex((option) => option[this.valueField] === this.value);
             this.keyboardNav = false;
@@ -109,147 +133,278 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
                     break;
                 case " ":
                 case "Enter":
-                    if (event.target.id !== "clear-button") {
+                    if (event.target.id !== this.CLEAR_BUTTON_ID) {
                         this.handleMenuChange(true);
                     }
                     break;
             }
         };
-        this.manSetInputValueKeyboardOpen = (event) => {
-            const menuOptions = this.setMenuOptions();
-            const highlightedOptionIndex = menuOptions.findIndex((option) => option[this.valueField] === this.optionHighlighted);
-            const getOptionId = (index) => { var _a; return (_a = Array.from(this.host.querySelectorAll("li"))[index]) === null || _a === void 0 ? void 0 : _a.id; };
+        this.selectHighlightedOption = (options, highlightedOptionIndex) => {
+            if (!this.isLoading && !this.hasTimedOut) {
+                this.keyboardNav = true;
+            }
             const isOpen = this.isSearchBar || this.isSearchableSelect || this.open;
-            switch (event.key) {
-                case "ArrowDown":
-                    this.keyboardNav = true;
-                    this.arrowBehaviour(event);
-                    if (highlightedOptionIndex < menuOptions.length - 1) {
-                        this.setHighlightedOption(highlightedOptionIndex + 1);
-                        this.menuOptionId.emit({
-                            optionId: getOptionId(highlightedOptionIndex + 1),
-                        });
-                    }
-                    else {
-                        this.setHighlightedOption(0);
-                        this.menuOptionId.emit({
-                            optionId: getOptionId(0),
-                        });
+            if (isOpen) {
+                if (highlightedOptionIndex >= 0) {
+                    if (options[highlightedOptionIndex] !== undefined) {
+                        if (this.isSearchBar &&
+                            options[highlightedOptionIndex].disabled === true) {
+                            this.disabledOptionSelected = true;
+                        }
+                        else {
+                            this.setInputValue(highlightedOptionIndex);
+                        }
                     }
-                    this.preventIncorrectTabOrder = false;
-                    this.focusFromSearchKeypress = false;
-                    break;
-                case "ArrowUp":
-                    this.keyboardNav = true;
-                    this.arrowBehaviour(event);
-                    if (highlightedOptionIndex <= 0 ||
-                        highlightedOptionIndex > menuOptions.length + 1) {
-                        this.setHighlightedOption(menuOptions.length - 1);
+                }
+                else {
+                    this.setInputValue(highlightedOptionIndex);
+                }
+            }
+            else {
+                this.handleMenuChange(true);
+            }
+        };
+        // Check if option is selected based on the index of the option
+        this.isOptionSelected = (index) => {
+            const menuOptions = this.getMenuOptions();
+            return this.value
+                ? this.value.includes(menuOptions[index][this.valueField])
+                : false;
+        };
+        // Deselect currently selected options when shift pressed, but keep certain options selected
+        this.deselectSelectedOptions = (optionsToKeepSelected) => {
+            const menuOptions = this.getMenuOptions();
+            if (this.value) {
+                const selectedOptionIndexes = this.value.map((value) => {
+                    return menuOptions.findIndex((option) => option[this.valueField] === value);
+                });
+                // Call setInputValue (which toggles the selected state) on options that need to be deselected
+                selectedOptionIndexes.forEach((index) => !optionsToKeepSelected.includes(index) && this.setInputValue(index));
+            }
+        };
+        // Determines keyboard behaviour when selection is manual (i.e. when you have to press Enter to select an option)
+        this.manualSetInputValueKeyboardOpen = (event) => {
+            const menuOptions = this.getMenuOptions();
+            // For preventing focus disappearing on currently focused option when Shift / Cmd / Ctrl pressed
+            // (i.e. when user is likely in the middle of executing a keyboard combination to select options)
+            const isKeyboardCombination = event.shiftKey || event.metaKey || event.ctrlKey;
+            const highlightedOptionIndex = this.getOptionHighlightedIndex();
+            const clickedMultiOptionIndex = menuOptions.findIndex((option) => option[this.valueField] === this.multiOptionClicked);
+            const getOptionId = (index) => { var _a; return (_a = Array.from(this.host.querySelectorAll("li"))[index]) === null || _a === void 0 ? void 0 : _a.id; };
+            // Space press should be equivalent to Enter when multi-select
+            if (event.key === " " && this.isMultiSelect) {
+                this.handleOptionSelect(event, highlightedOptionIndex);
+            }
+            else {
+                switch (event.key) {
+                    case "ArrowDown":
+                        this.keyboardNav = true;
+                        this.arrowBehaviour(event);
+                        if (this.multiOptionClicked) {
+                            // Set focus to option last clicked
+                            // Prevents it resetting to the top of the menu when user switches to using keyboard
+                            this.setHighlightedOption(clickedMultiOptionIndex);
+                            this.multiOptionClicked = null;
+                        }
+                        else {
+                            this.handleSingleShiftSelect(event, highlightedOptionIndex, menuOptions);
+                            if (highlightedOptionIndex < menuOptions.length - 1) {
+                                this.setHighlightedOption(highlightedOptionIndex + 1);
+                                this.menuOptionId.emit({
+                                    optionId: getOptionId(highlightedOptionIndex + 1),
+                                });
+                                this.handleSingleShiftSelect(event, highlightedOptionIndex + 1, menuOptions);
+                            }
+                            else {
+                                this.setHighlightedOption(0);
+                                this.menuOptionId.emit({
+                                    optionId: getOptionId(0),
+                                });
+                                this.handleSingleShiftSelect(event, 0, menuOptions);
+                            }
+                            // Deselect currently selected options if arrow was pressed for first time after shift is held
+                            if (this.isMultiSelect && this.shiftPressed) {
+                                this.deselectSelectedOptions([
+                                    highlightedOptionIndex,
+                                    this.getOptionHighlightedIndex(),
+                                ]);
+                                this.shiftPressed = false;
+                            }
+                        }
+                        this.lastOptionFocused = this.getOptionHighlightedIndex();
+                        this.preventIncorrectTabOrder = false;
+                        this.focusFromSearchKeypress = false;
+                        break;
+                    case "ArrowUp":
+                        this.keyboardNav = true;
+                        this.arrowBehaviour(event);
+                        if (this.multiOptionClicked) {
+                            // Set focus to option last clicked
+                            // Prevents it resetting to the bottom of the menu when user switches to using keyboard
+                            this.setHighlightedOption(clickedMultiOptionIndex);
+                            this.multiOptionClicked = null;
+                        }
+                        else {
+                            this.handleSingleShiftSelect(event, highlightedOptionIndex, menuOptions);
+                            if (highlightedOptionIndex <= 0 ||
+                                highlightedOptionIndex > menuOptions.length + 1) {
+                                this.setHighlightedOption(menuOptions.length - 1);
+                                this.menuOptionId.emit({
+                                    optionId: getOptionId(menuOptions.length - 1),
+                                });
+                                this.handleSingleShiftSelect(event, menuOptions.length - 1, menuOptions);
+                            }
+                            else {
+                                this.setHighlightedOption(highlightedOptionIndex - 1);
+                                this.menuOptionId.emit({
+                                    optionId: getOptionId(highlightedOptionIndex - 1),
+                                });
+                                this.handleSingleShiftSelect(event, highlightedOptionIndex - 1, menuOptions);
+                            }
+                            // Deselect currently selected options if arrow was pressed for first time after shift is held
+                            if (this.isMultiSelect && this.shiftPressed) {
+                                this.deselectSelectedOptions([
+                                    highlightedOptionIndex,
+                                    this.getOptionHighlightedIndex(),
+                                ]);
+                                this.shiftPressed = false;
+                            }
+                        }
+                        this.lastOptionFocused = this.getOptionHighlightedIndex();
+                        this.preventIncorrectTabOrder = false;
+                        this.focusFromSearchKeypress = false;
+                        break;
+                    case "Home": {
+                        const startOptionIndex = 0;
+                        this.keyboardNav = true;
+                        event.preventDefault();
+                        this.arrowBehaviour(event);
+                        this.setHighlightedOption(startOptionIndex);
                         this.menuOptionId.emit({
-                            optionId: getOptionId(menuOptions.length - 1),
+                            optionId: getOptionId(startOptionIndex),
                         });
+                        if (event.shiftKey && event.ctrlKey) {
+                            this.handleMultipleShiftSelect(startOptionIndex);
+                        }
+                        this.lastOptionFocused = startOptionIndex;
+                        this.lastOptionSelected = startOptionIndex;
+                        break;
                     }
-                    else {
-                        this.setHighlightedOption(highlightedOptionIndex - 1);
+                    case "End": {
+                        const endOptionIndex = menuOptions.length - 1;
+                        this.keyboardNav = true;
+                        event.preventDefault();
+                        this.arrowBehaviour(event);
+                        this.setHighlightedOption(endOptionIndex);
                         this.menuOptionId.emit({
-                            optionId: getOptionId(highlightedOptionIndex - 1),
+                            optionId: getOptionId(endOptionIndex),
                         });
-                    }
-                    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 " ":
-                    this.keyboardNav = false;
-                    if (this.isSearchBar || this.isSearchableSelect) {
+                        if (event.shiftKey && event.ctrlKey) {
+                            this.handleMultipleShiftSelect(endOptionIndex);
+                        }
+                        this.lastOptionFocused = endOptionIndex;
+                        this.lastOptionSelected = endOptionIndex;
                         break;
                     }
-                    else {
-                        if (event.target.id !== "clear-button") {
-                            this.handleMenuChange(true);
+                    case " ":
+                        if (!isKeyboardCombination) {
+                            this.keyboardNav = false;
                         }
-                    }
-                    break;
-                case "Enter":
-                    event.preventDefault();
-                    this.keyboardNav = false;
-                    if (isOpen) {
-                        if (highlightedOptionIndex >= 0) {
-                            if (menuOptions[highlightedOptionIndex] !== undefined) {
-                                if (this.isSearchBar &&
-                                    menuOptions[highlightedOptionIndex].disabled === true) {
-                                    this.disabledOptionSelected = true;
-                                }
-                                else {
-                                    this.setInputValue(highlightedOptionIndex);
-                                    this.value =
-                                        menuOptions[highlightedOptionIndex][this.valueField];
-                                }
+                        if (this.isSearchBar || this.isSearchableSelect) {
+                            break;
+                        }
+                        else {
+                            if (event.target.id !== this.CLEAR_BUTTON_ID) {
+                                this.handleMenuChange(true);
+                            }
+                        }
+                        break;
+                    case "Enter":
+                        event.preventDefault();
+                        if (!isKeyboardCombination) {
+                            this.keyboardNav = false;
+                        }
+                        this.handleOptionSelect(event, highlightedOptionIndex);
+                        break;
+                    case "Escape":
+                        if (this.open) {
+                            event.stopImmediatePropagation();
+                        }
+                        this.handleMenuChange(false);
+                        this.menuOptionId.emit({ optionId: undefined });
+                        break;
+                    case "a":
+                        // Checks if Cmd (meta) key is pressed if Mac device (while excluding meta key on Windows)
+                        // Otherwise, if a different OS, checks Ctrl key
+                        if ((isMacDevice() && event.metaKey) ||
+                            (!isMacDevice() && event.ctrlKey)) {
+                            this.emitSelectAll();
+                            this.lastOptionFocused = null;
+                            this.lastOptionSelected = null;
+                        }
+                        break;
+                    case "Shift":
+                    case "Tab":
+                        if (event.key === "Shift") {
+                            this.shiftPressed = true;
+                        }
+                        if (this.isSearchBar) {
+                            this.keyboardNav = true;
+                        }
+                        if (this.isMultiSelect) {
+                            if (this.open && !event.shiftKey && this.selectAllButton) {
+                                event.preventDefault();
+                                this.selectAllButton.focus(); // Move focus to select all button instead of focused option
+                                this.preventMenuFocus = true;
+                                this.preventClickOpen = true;
+                                this.optionHighlighted = undefined; // Stop any option focus states showing when focus moved to select all button
                             }
                         }
                         else {
-                            this.setInputValue(highlightedOptionIndex);
+                            this.preventIncorrectTabOrder = true;
                         }
-                    }
-                    else {
-                        this.handleMenuChange(true);
-                    }
-                    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;
-                default:
-                    this.keyboardNav = false;
-                    this.focusOnSearchOrSelectInput(menuOptions, highlightedOptionIndex);
-                    break;
+                        break;
+                    default:
+                        if (!isKeyboardCombination) {
+                            this.keyboardNav = false;
+                        }
+                        this.focusOnSearchOrSelectInput(menuOptions, highlightedOptionIndex);
+                }
             }
         };
         this.setInputValue = (highlightedOptionIndex) => {
-            const menuOptions = this.setMenuOptions();
+            const menuOptions = this.getMenuOptions();
             if (menuOptions[highlightedOptionIndex] !== undefined) {
                 this.menuOptionSelect.emit({
                     value: menuOptions[highlightedOptionIndex][this.valueField],
                 });
-                this.optionHighlighted = undefined;
-                this.menuOptionId.emit({ optionId: undefined });
+                if (this.closeOnSelect) {
+                    this.optionHighlighted = undefined;
+                    this.menuOptionId.emit({ optionId: undefined });
+                }
+            }
+            if (this.closeOnSelect) {
+                if (!this.hasTimedOut) {
+                    this.handleMenuChange(false);
+                }
+                else {
+                    this.parentEl.setFocus();
+                }
             }
-            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);
+            if (this.isMultiSelect) {
+                const menuOptions = this.getMenuOptions();
+                const selectedOptionIndex = menuOptions.findIndex((option) => option.value === value);
+                this.handleOptionSelect(event, selectedOptionIndex, true);
+                this.multiOptionClicked = value;
+            }
+            else {
+                this.menuOptionSelect.emit({ value, label });
+                this.handleMenuChange(false);
+            }
+            this.optionHighlighted = undefined;
         };
         this.handleRetry = () => {
             this.retryButtonClicked.emit({ value: this.value });
@@ -262,13 +417,23 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
         };
         this.handleBlur = (event) => {
             if (event.relatedTarget !== this.inputEl) {
-                if (!this.menu.contains(event.relatedTarget)) {
+                if (event.relatedTarget === this.selectAllButton) {
+                    this.menu.removeAttribute(this.ACTIVE_DESCENDANT);
+                }
+                if (!(this.menu.contains(event.relatedTarget) ||
+                    event.relatedTarget === this.selectAllButton)) {
                     this.handleMenuChange(false, this.hasPreviouslyBlurred);
+                    this.menu.removeAttribute(this.ACTIVE_DESCENDANT);
+                    this.lastOptionFocused = null;
+                    this.lastOptionSelected = null;
                 }
             }
             else {
                 this.handleMenuChange(false);
                 this.preventClickOpen = true;
+                this.menu.removeAttribute(this.ACTIVE_DESCENDANT);
+                this.lastOptionFocused = null;
+                this.lastOptionSelected = null;
             }
             if (!this.isSearchBar)
                 this.hasPreviouslyBlurred = !!event.relatedTarget;
@@ -281,12 +446,109 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
                 this.autoSetValueOnMenuKeyDown(event);
             }
             else if (this.activationType === "manual" && !this.isSearchBar) {
-                this.manSetInputValueKeyboardOpen(event);
+                this.manualSetInputValueKeyboardOpen(event);
+            }
+        };
+        this.handleMenuKeyUp = (event) => {
+            if (event.key === "Tab" && event.shiftKey) {
+                this.preventClickOpen = false;
+            }
+            if (event.key === "Enter" && this.disabledOptionSelected) {
+                this.disabledOptionSelected = false;
+                event.stopImmediatePropagation();
+            }
+            if (event.key === "Shift") {
+                this.shiftPressed = false;
+            }
+        };
+        this.handleSelectAllClick = () => {
+            this.keyboardNav = false;
+            this.menu.focus();
+            this.emitSelectAll();
+            this.lastOptionFocused = null;
+            this.lastOptionSelected = null;
+        };
+        this.handleSelectAllBlur = (event) => {
+            this.host.classList.remove("ic-select-select-all-focused");
+            if (!this.menu.contains(event.relatedTarget)) {
+                this.handleMenuChange(false, false);
             }
         };
+        this.handleSelectAllFocus = () => {
+            this.host.classList.add("ic-select-select-all-focused");
+            this.lastOptionFocused = null;
+            this.lastOptionSelected = null;
+        };
+        // Fix for Safari - select all button click was causing menu to close
+        this.handleSelectAllMouseDown = (event) => {
+            event.preventDefault();
+        };
+        // When shift key is being used to select contiguous options one by one on a multi-select
+        // I.e. holding shift and pressing up and down arrow keys
+        this.handleSingleShiftSelect = (event, optionToSelectIndex, options) => {
+            if (this.isMultiSelect &&
+                event.shiftKey &&
+                !this.isOptionSelected(optionToSelectIndex)) {
+                this.selectHighlightedOption(options, optionToSelectIndex);
+                this.lastOptionSelected = optionToSelectIndex;
+            }
+        };
+        // When shift key is being used to select multiple options at once on a multi-select
+        // I.e. holding shift when selecting another option
+        this.handleMultipleShiftSelect = (lastOptionInSelection, useFocusForSelection = false, firstOptionSelected = null) => {
+            this.shiftPressed = false;
+            const firstOptionInSelection = firstOptionSelected === null
+                ? this.getFirstOptionInSelection(useFocusForSelection)
+                : firstOptionSelected;
+            if (firstOptionInSelection !== null) {
+                const optionsToSelect = [];
+                if (firstOptionInSelection < lastOptionInSelection) {
+                    for (let i = firstOptionInSelection; i < lastOptionInSelection + 1; i++) {
+                        optionsToSelect.push(i);
+                    }
+                }
+                else {
+                    for (let i = firstOptionInSelection; i > lastOptionInSelection - 1; i--) {
+                        optionsToSelect.push(i);
+                    }
+                }
+                optionsToSelect.forEach((optionIndex) => !this.isOptionSelected(optionIndex) && this.setInputValue(optionIndex));
+                this.deselectSelectedOptions(optionsToSelect);
+            }
+        };
+        this.handleOptionSelect = (event, optionIndex, useFocusForSelection = false) => {
+            const menuOptions = this.getMenuOptions();
+            const firstOptionInSelection = this.getFirstOptionInSelection(useFocusForSelection);
+            if (event.shiftKey && firstOptionInSelection !== null) {
+                this.handleMultipleShiftSelect(optionIndex, useFocusForSelection, firstOptionInSelection);
+            }
+            else {
+                this.selectHighlightedOption(menuOptions, optionIndex);
+            }
+            this.lastOptionFocused = optionIndex;
+            this.lastOptionSelected = optionIndex;
+        };
+        this.getFirstOptionInSelection = (useFocusForSelection) => {
+            return useFocusForSelection && this.lastOptionFocused !== null
+                ? this.lastOptionFocused
+                : this.lastOptionSelected !== null
+                    ? this.lastOptionSelected
+                    : null;
+        };
+        this.emitSelectAll = () => {
+            var _a;
+            // Select all if there is either no value or not all options are selected
+            // 'true' means select all, 'false' means clear all
+            this.menuOptionSelectAll.emit({
+                select: !this.value || !(((_a = this.value) === null || _a === void 0 ? void 0 : _a.length) === this.ungroupedOptions.length),
+            });
+        };
         this.emitMenuKeyPress = (isNavKey, key) => {
             this.menuKeyPress.emit({ isNavKey: isNavKey, key: key });
         };
+        // Determines keyboard behaviour when selection is automatic
+        // (i.e. you don't have to press Enter select an option - just focus on it)
+        // and menu is focused
         this.autoSetValueOnMenuKeyDown = (event) => {
             event.cancelBubble = true;
             const selectedOptionIndex = this.ungroupedOptions.findIndex((option) => option[this.valueField] === this.value);
@@ -346,15 +608,6 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
             }
             this.emitMenuKeyPress(this.keyboardNav, event.key);
         };
-        this.handleMenuKeyUp = (event) => {
-            if (event.key === "Tab" && event.shiftKey) {
-                this.preventClickOpen = false;
-            }
-            if (event.key === "Enter" && this.disabledOptionSelected) {
-                this.disabledOptionSelected = false;
-                event.stopImmediatePropagation();
-            }
-        };
         this.getOptionId = (value) => {
             return `${this.menuId}-${value}`;
         };
@@ -380,6 +633,10 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
             }
             return sorted;
         };
+        this.getOptionHighlightedIndex = () => {
+            const menuOptions = this.getMenuOptions();
+            return menuOptions.findIndex((option) => option[this.valueField] === this.optionHighlighted);
+        };
         this.isManualMode = this.activationType === "manual";
         this.scrollToSelected = (menu) => {
             const selectedOption = this.selectOnEnter
@@ -391,9 +648,14 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
                     elTop < menu.scrollTop + menu.offsetHeight) {
                     menu.scrollTop = selectedOption.offsetTop;
                 }
+                // 'aria-activedescendant' affects screen reader focus
+                // https://www.w3.org/TR/2017/WD-wai-aria-practices-1.1-20170628/#kbd_focus_activedescendant
+                this.menu.setAttribute(this.ACTIVE_DESCENDANT, selectedOption.id);
                 selectedOption.focus();
             }
         };
+        // Set 'ungroupedOptions' variable and emit its value
+        // - this is all the options with disabled options and group titles removed
         this.loadUngroupedOptions = () => {
             if (this.options.length > 0 && this.options.map) {
                 this.options.map((option) => {
@@ -420,21 +682,24 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
         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("div", { class: "option-label" }, option.icon && (h("div", { class: "option-icon", innerHTML: option.icon, "aria-hidden": "true" })), h("ic-typography", { variant: "body", "aria-hidden": "true" }, option[this.labelField])), option.description && (h("ic-typography", { id: `${this.getOptionId(option[this.valueField])}-description`, class: "option-description", variant: "caption", "aria-hidden": "true" }, h("p", null, option.description))), option.element && (h("div", { class: "option-element", innerHTML: option.element.component, "aria-hidden": "true" }))), !!option[this.valueField] &&
+        this.optionContent = (option, selected) => {
+            const showCheckIcon = !!option[this.valueField] &&
                 !!this.value &&
-                option[this.valueField].toLowerCase() === ((_a = this.value) === null || _a === void 0 ? void 0 : _a.toLowerCase()) &&
-                this.parentEl.tagName !== "IC-SEARCH-BAR" && (h("span", { class: "check-icon", innerHTML: checkIcon }))));
+                selected &&
+                this.parentEl.tagName !== "IC-SEARCH-BAR";
+            return (h(Fragment, null, option.loading && h("ic-loading-indicator", { size: "icon" }), h("div", { class: {
+                    "option-text-container": true,
+                    "show-check-icon": showCheckIcon,
+                } }, h("div", { class: "option-label" }, option.icon && (h("div", { class: "option-icon", innerHTML: option.icon, "aria-hidden": "true" })), h("ic-typography", { variant: "body", "aria-hidden": "true" }, option[this.labelField])), option.description && (h("ic-typography", { id: `${this.getOptionId(option[this.valueField])}-description`, class: "option-description", variant: "caption", "aria-hidden": "true" }, h("p", null, option.description))), option.element && (h("div", { class: "option-element", innerHTML: option.element.component, "aria-hidden": "true" }))), showCheckIcon && h("span", { class: "check-icon", innerHTML: checkIcon })));
         };
-        this.displayOption = (option, index, parentOption) => {
-            const { open, value, keyboardNav, isManualMode, initialOptionsListRender, optionHighlighted, options, } = this;
+        this.displayOption = (option, selected, index, parentOption) => {
+            const { open, keyboardNav, isManualMode, initialOptionsListRender, optionHighlighted, options, } = this;
             return (h("li", { id: this.getOptionId(option[this.valueField]), class: {
                     option: true,
                     "focused-option": isManualMode
                         ? (keyboardNav || initialOptionsListRender) &&
                             option[this.valueField] === optionHighlighted
-                        : keyboardNav && option[this.valueField] === value,
+                        : keyboardNav && selected,
                     "last-recommended-option": option.recommended &&
                         options[index + 1] &&
                         !options[index + 1].recommended,
@@ -442,20 +707,21 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
                     "loading-option": option.loading,
                     timeout: option.timedOut,
                 }, role: "option", tabindex: open &&
-                    (option[this.valueField] === value ||
-                        option[this.valueField] === optionHighlighted) &&
+                    (selected || option[this.valueField] === optionHighlighted) &&
                     keyboardNav
                     ? "0"
-                    : "-1", "aria-label": this.getOptionAriaLabel(option, parentOption), "aria-selected": `${option[this.valueField] === value}`, "aria-disabled": option.disabled ? "true" : "false", onClick: !option.timedOut && !option.loading && this.handleOptionClick, onBlur: this.handleBlur, onMouseDown: this.handleMouseDown, "data-value": option[this.valueField], "data-label": option[this.labelField] }, 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("g", { id: "close-octagon" }, h("path", { id: "Vector", d: "M8.77 3L3.5 8.27V15.73L8.77 21H16.23L21.5 15.73V8.27L16.23 3M8.91 7L12.5 10.59L16.09 7L17.5 8.41L13.91 12L17.5 15.59L16.09 17L12.5 13.41L8.91 17L7.5 15.59L11.09 12L7.5 8.41" }))), h("ic-typography", { variant: "label" }, option[this.labelField])), h("ic-button", { size: "small", variant: "tertiary", onClick: this.handleRetry, onKeyDown: this.handleRetryKeyDown, onBlur: this.handleTimeoutBlur, id: "retry-button" }, "Retry"))) : (this.optionContent(option))));
+                    : "-1", "aria-label": this.getOptionAriaLabel(option, parentOption), "aria-selected": selected ? "true" : "false", "aria-disabled": option.disabled ? "true" : "false", onClick: !option.timedOut && !option.loading && this.handleOptionClick, onBlur: this.handleBlur, onMouseDown: this.handleMouseDown, "data-value": option[this.valueField], "data-label": option[this.labelField] }, 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("g", { id: "close-octagon" }, h("path", { id: "Vector", d: "M8.77 3L3.5 8.27V15.73L8.77 21H16.23L21.5 15.73V8.27L16.23 3M8.91 7L12.5 10.59L16.09 7L17.5 8.41L13.91 12L17.5 15.59L16.09 17L12.5 13.41L8.91 17L7.5 15.59L11.09 12L7.5 8.41" }))), h("ic-typography", { variant: "label" }, option[this.labelField])), h("ic-button", { size: "small", variant: "tertiary", onClick: this.handleRetry, onKeyDown: this.handleRetryKeyDown, onBlur: this.handleTimeoutBlur, id: "retry-button" }, "Retry"))) : (this.optionContent(option, selected))));
         };
         this.focusFromSearchKeypress = false;
         this.initialOptionsListRender = false;
         this.keyboardNav = false;
         this.optionHighlighted = undefined;
         this.preventIncorrectTabOrder = false;
+        this.menuOptions = undefined;
         this.activationType = "automatic";
         this.anchorEl = undefined;
         this.autoFocusOnSelected = true;
+        this.closeOnSelect = true;
         this.fullWidth = false;
         this.inputEl = undefined;
         this.inputLabel = undefined;
@@ -482,9 +748,6 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
         this.ungroupedOptions = [];
         this.loadUngroupedOptions();
     }
-    watchValueHandler() {
-        this.menuValueChange.emit({ value: this.value });
-    }
     connectedCallback() {
         this.getParentEl(this.parentEl);
         if (this.isSearchBar) {
@@ -494,11 +757,12 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
         }
     }
     disconnectedCallback() {
+        var _a, _b;
         if (this.popperInstance) {
             this.popperInstance.destroy();
         }
-        this.parentEl.removeEventListener("icClear", this.handleClearListener);
-        this.parentEl.removeEventListener("icSubmitSearch", this.handleSubmitSearch);
+        (_a = this.parentEl) === null || _a === void 0 ? void 0 : _a.removeEventListener("icClear", this.handleClearListener);
+        (_b = this.parentEl) === null || _b === void 0 ? void 0 : _b.removeEventListener("icSubmitSearch", this.handleSubmitSearch);
     }
     componentWillLoad() {
         var _a, _b;
@@ -523,7 +787,7 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
     }
     componentDidUpdate() {
         const inputValueInOptions = this.options.some((option) => option[this.valueField] === this.value);
-        if (this.open && this.options.length !== 0) {
+        if (this.open && this.options.length !== 0 && !this.preventMenuFocus) {
             if (this.value &&
                 this.keyboardNav &&
                 inputValueInOptions &&
@@ -531,8 +795,7 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
                 !this.isSearchableSelect) {
                 this.scrollToSelected(this.menu);
             }
-            else if (this.inputEl.tagName !== "IC-TEXT-FIELD" &&
-                this.inputEl.tagName !== "INPUT") {
+            else if (this.selectOnEnter) {
                 this.menu.focus();
             }
             else if (!!this.optionHighlighted &&
@@ -540,13 +803,19 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
                 !this.preventIncorrectTabOrder) {
                 const highlightedEl = this.host.querySelector(`li[data-value="${this.optionHighlighted}"]`);
                 if (highlightedEl) {
+                    this.menu.setAttribute(this.ACTIVE_DESCENDANT, highlightedEl.id);
                     highlightedEl.focus();
                 }
             }
+            else if (this.inputEl.tagName !== "IC-TEXT-FIELD" &&
+                this.inputEl.tagName !== "INPUT") {
+                this.menu.focus();
+            }
         }
         if (this.open && !this.value && this.selectOnEnter) {
             this.scrollToSelected(this.menu);
         }
+        this.preventMenuFocus = false;
     }
     componentDidRender() {
         if (this.open && !this.popperInstance && this.anchorEl) {
@@ -576,7 +845,7 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
             this.autoSetInputValueKeyboardOpen(event);
         }
         else {
-            this.manSetInputValueKeyboardOpen(event);
+            this.manualSetInputValueKeyboardOpen(event);
         }
     }
     /**
@@ -591,8 +860,9 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
      * boundary behaviour so sticking with PopperJS.
      */
     async initPopperJs(anchor) {
+        // Placements set to "-start" to accommodate for custom menu width - menu should always be aligned to the left
         this.popperInstance = createPopper(anchor, this.host, {
-            placement: "bottom",
+            placement: "bottom-start",
             modifiers: [
                 {
                     name: "offset",
@@ -603,7 +873,7 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
                 {
                     name: "flip",
                     options: {
-                        fallbackPlacements: ["top"],
+                        fallbackPlacements: ["top-start"],
                         rootBoundary: "viewport",
                     },
                 },
@@ -625,36 +895,50 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
     }
     render() {
         const { inputLabel, options, menuId, value, fullWidth, hasTimedOut, isLoading, size, open, inputEl, keyboardNav, } = this;
+        const selectAllButtonText = `${(value === null || value === void 0 ? void 0 : value.length) === this.ungroupedOptions.length ? "Clear" : "Select"} all`;
+        const hasNoResults = this.host.classList.contains("no-results");
         return (h(Host, { class: {
                 "ic-menu-full-width": fullWidth,
                 "ic-menu-no-focus": (inputEl === null || inputEl === void 0 ? void 0 : inputEl.tagName) === "INPUT" || hasTimedOut || isLoading,
                 [`ic-menu-${size}`]: true,
-                "ic-menu-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) => {
+                "ic-menu-open": open && options.length !== 0,
+                "ic-menu-multiple": this.isMultiSelect,
+            } }, options.length !== 0 && (h("ul", { id: menuId, class: "menu", role: "listbox", "aria-label": `${inputLabel} pop-up`, "aria-multiselectable": this.isMultiSelect ? "true" : "false", 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[this.labelField])), option.children.map((childOption) => this.displayOption(childOption, index, option))));
+                    return (h("div", null, h("ic-typography", { class: "option-group-title", role: "presentation", variant: "subtitle-small" }, h("p", null, option[this.labelField])), option.children.map((childOption) => childOption.label &&
+                        this.displayOption(childOption, this.isMultiSelect
+                            ? value === null || value === void 0 ? void 0 : value.includes(childOption[this.valueField])
+                            : childOption[this.valueField] === value, index, option))));
                 }
                 else {
                     return null;
                 }
             }
             else {
-                return this.displayOption(option, index);
-            }
-        })))));
+                // Display option only if it has a label (rather than displaying an empty space)
+                return (option.label &&
+                    this.displayOption(option, this.isMultiSelect
+                        ? value === null || value === void 0 ? void 0 : value.includes(option[this.valueField])
+                        : option[this.valueField] === value, index));
+            }
+        }))), options.length !== 0 &&
+            this.isMultiSelect &&
+            !isLoading &&
+            !hasTimedOut &&
+            !hasNoResults && (h("div", { class: "option-bar" }, h("ic-typography", null, h("p", null, `${value ? value.length : 0}/${getOptionsWithoutGroupTitlesCount(this.options)} selected`)), h("ic-button", { class: "select-all-button", "aria-label": `${selectAllButtonText} options for ${inputLabel}`, ref: (el) => (this.selectAllButton = el), variant: "tertiary", onClick: this.handleSelectAllClick, onMouseDown: this.handleSelectAllMouseDown, onBlur: this.handleSelectAllBlur, onFocus: this.handleSelectAllFocus, size: size === "small" ? "small" : "medium" }, selectAllButtonText)))));
     }
     get host() { return this; }
     static get watchers() { return {
         "open": ["watchOpenHandler"],
-        "options": ["watchOptionsHandler"],
-        "value": ["watchValueHandler"]
+        "options": ["watchOptionsHandler"]
     }; }
     static get style() { return icMenuCss; }
 }, [2, "ic-menu", {
         "activationType": [1, "activation-type"],
         "anchorEl": [16],
         "autoFocusOnSelected": [4, "auto-focus-on-selected"],
+        "closeOnSelect": [4, "close-on-select"],
         "fullWidth": [4, "full-width"],
         "inputEl": [16],
         "inputLabel": [1, "input-label"],
@@ -666,21 +950,21 @@ const Menu = /*@__PURE__*/ proxyCustomElement(class Menu extends HTMLElement {
         "selectOnEnter": [4, "select-on-enter"],
         "size": [1],
         "options": [16],
-        "value": [1025],
+        "value": [1],
         "valueField": [1, "value-field"],
         "focusFromSearchKeypress": [32],
         "initialOptionsListRender": [32],
         "keyboardNav": [32],
         "optionHighlighted": [32],
         "preventIncorrectTabOrder": [32],
+        "menuOptions": [32],
         "handleClickOpen": [64],
         "handleKeyboardOpen": [64],
         "handleSetFirstOption": [64],
         "initPopperJs": [64]
     }, undefined, {
         "open": ["watchOpenHandler"],
-        "options": ["watchOptionsHandler"],
-        "value": ["watchValueHandler"]
+        "options": ["watchOptionsHandler"]
     }]);
 function defineCustomElement() {
     if (typeof customElements === "undefined") {