@siemens/ix 4.4.0 → 5.1.0

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

@@ -6,95 +6,58 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { iconApps, iconCogwheel, iconInfo, iconLightDark, iconNavigationLeft, iconNavigationRight, } from "@siemens/ix-icons/icons";
+import { iconApps, iconCogwheel, iconInfo, iconLightDark, } from "@siemens/ix-icons/icons";
 import { h, Host, } from "@stencil/core";
 import { animate } from "animejs";
-import { ApplicationSidebarToggleEvent } from "../application-sidebar/events";
 import Animation from "../utils/animation";
 import { showAppSwitch } from "../utils/app-switch";
 import { ApplicationLayoutContext } from "../utils/application-layout/context";
 import { applicationLayoutService } from "../utils/application-layout/service";
 import { useContextConsumer } from "../utils/context";
 import { menuController } from "../utils/menu-service/menu-service";
+import { requestAnimationFrameNoNgZone } from "../utils/requestAnimationFrame";
 import { convertToRemString } from "../utils/rwd.util";
 import { themeSwitcher } from "../utils/theme-switcher";
 export class Menu {
-    constructor() {
-        /**
-         * Is settings tab visible
-         */
-        this.showSettings = false;
-        /**
-         * Is about tab visible
-         */
-        this.showAbout = false;
-        /**
-         * Show toggle between light and dark variant. Only if the provided theme have implemented both!
-         */
-        this.enableToggleTheme = false;
-        /** @internal */
-        this.enableMapExpand = false;
-        /**
-         * Should only be set if you use ix-menu standalone
-         */
-        this.applicationDescription = '';
-        /**
-         * Accessibility i18n label for the burger menu of the sidebar
-         * @deprecated Since 4.2.0. Will be removed in 5.0.0. The expand button is now hidden from screen readers with aria-hidden="true".
-         */
-        this.i18nExpandSidebar = 'Expand sidebar';
-        /**
-         *  Toggle the expand state of the menu
-         */
-        this.expand = false;
-        /**
-         *  If set the menu will be expanded initially. This will only take effect at the breakpoint 'lg'.
-         */
-        this.startExpanded = false;
-        /**
-         * Menu stays pinned to the left
-         */
-        this.pinned = false;
-        /**
-         *  i18n label for 'About & legal information' button
-         */
-        this.i18nLegal = 'About & legal information';
-        /**
-         * i18n label for 'Settings' button
-         */
-        this.i18nSettings = 'Settings';
-        /**
-         * i18n label for 'Toggle theme' button
-         */
-        this.i18nToggleTheme = 'Toggle theme';
-        /**
-         * i18n label for 'Expand' button
-         */
-        this.i18nExpand = ' Expand';
-        /**
-         * i18n label for 'Collapse' button
-         */
-        this.i18nCollapse = 'Collapse';
-        this.showPinned = false;
-        this.mapExpand = true;
-        this.breakpoint = 'lg';
-        this.itemsScrollShadowTop = false;
-        this.itemsScrollShadowBottom = false;
-        this.isDarkMode = false;
-        this.isTransitionDisabled = false;
-        // FBC IAM workaround #488
-        this.isVisible = (elm) => {
-            var _a, _b;
-            return (elm.style.display !== 'none' &&
-                ((_b = (_a = elm.parentElement) === null || _a === void 0 ? void 0 : _a.parentElement) === null || _b === void 0 ? void 0 : _b.style.display) !== 'none');
-        };
-    }
+    hostElement;
+    /**
+     * Is settings tab visible
+     */
+    showSettings = false;
+    /**
+     * Is about tab visible
+     */
+    showAbout = false;
+    /**
+     * Show toggle between light and dark variant. Only if the provided theme have implemented both!
+     */
+    enableToggleTheme = false;
+    /**
+     * Should only be set if you use ix-menu standalone
+     */
+    applicationName;
+    /**
+     * Should only be set if you use ix-menu standalone
+     */
+    applicationDescription = '';
+    /**
+     *  Toggle the expand state of the menu
+     */
+    expand = false;
     expandChanged(newExpand, oldExpand) {
         if (newExpand === oldExpand) {
             return;
         }
         this.toggleMenu(newExpand);
     }
+    /**
+     *  If set the menu will be expanded initially. This will only take effect at the breakpoint 'lg'.
+     */
+    startExpanded = false;
+    /**
+     * Menu stays pinned to the left
+     */
+    pinned = false;
     pinnedChange(newPinned) {
         this.setPinned(this.pinned);
         if (newPinned) {
@@ -104,6 +67,78 @@ export class Menu {
         }
         applicationLayoutService.enableBreakpointDetection();
     }
+    /**
+     * i18n aria-label for menu. Gets read out by screen readers when first focusing the menu
+     *
+     * @since 5.1.0
+     */
+    i18nAriaLabelMenu = 'Application Navigation';
+    /**
+     * i18n description for menu keyboard navigation hint, read by screen readers when focusing the menu
+     *
+     * @since 5.1.0
+     */
+    i18nNavigationHint = 'Use Up and Down arrow keys to navigate between menu items';
+    /**
+     *  i18n label for 'About & legal information' button
+     */
+    i18nLegal = 'About & legal information';
+    /**
+     * i18n label for 'Settings' button
+     */
+    i18nSettings = 'Settings';
+    /**
+     * i18n label for 'Toggle theme' button
+     */
+    i18nToggleTheme = 'Toggle theme';
+    /**
+     * i18n label for 'Expand' button
+     */
+    i18nExpand = 'Expand';
+    /**
+     * i18n label for 'Collapse' button
+     */
+    i18nCollapse = 'Collapse';
+    /**
+     * Menu expanded
+     */
+    expandChange;
+    /**
+     * Map Sidebar expanded
+     */
+    mapExpandChange;
+    /**
+     * Event emitted when the app switch button is clicked
+     *
+     * @since 3.0.0
+     */
+    openAppSwitch;
+    /**
+     * Event emitted when the settings button is clicked
+     * @since 3.0.0
+     */
+    openSettings;
+    /**
+     * Event emitted when the about button is clicked
+     * @since 3.0.0
+     */
+    openAbout;
+    showPinned = false;
+    mapExpand = true;
+    breakpoint = 'lg';
+    itemsScrollShadowTop = false;
+    itemsScrollShadowBottom = false;
+    hasBottomSlotItems = false;
+    applicationLayoutContext;
+    isDarkMode = false;
+    isTransitionDisabled = false;
+    lastFocusedMenuItem;
+    themeNameDisposer;
+    // FBC IAM workaround #488
+    isVisible = (elm) => {
+        return (elm.style.display !== 'none' &&
+            elm.parentElement?.parentElement?.style.display !== 'none');
+    };
     get popoverArea() {
         return this.hostElement.shadowRoot.querySelector('#popover-area');
     }
@@ -113,6 +148,9 @@ export class Menu {
     get menuItemsContainer() {
         return this.menu.querySelector('.tabs');
     }
+    get menuNavigationContainer() {
+        return this.menu.querySelector('.menu-navigation');
+    }
     get overlayContainer() {
         return this.hostElement.shadowRoot.querySelector('.menu-overlay');
     }
@@ -144,8 +182,8 @@ export class Menu {
         return this.hostElement.querySelector('.about-news');
     }
     get aboutNewsPopover() {
-        var _a;
-        return ((_a = document.querySelector('ix-menu-about-news')) !== null && _a !== void 0 ? _a : this.hostElement.querySelector('ix-menu-about-news'));
+        return (document.querySelector('ix-menu-about-news') ??
+            this.hostElement.querySelector('ix-menu-about-news'));
     }
     get aboutTab() {
         return this.hostElement.shadowRoot.querySelector('#aboutAndLegal');
@@ -159,18 +197,28 @@ export class Menu {
     get isSettingsEmpty() {
         return (Array.from(this.hostElement.shadowRoot.querySelectorAll('ix-menu-settings-item')).length === 0);
     }
+    get hasUtilityMenuItems() {
+        return !!this.settings || this.enableToggleTheme || !!this.about;
+    }
+    get shouldFillMenuNavigation() {
+        return this.hasUtilityMenuItems || this.hasBottomSlotItems;
+    }
     get tabsContainer() {
         return this.hostElement;
     }
     componentDidLoad() {
         requestAnimationFrame(() => {
+            this.suppressAnchorWrapperTabStops();
             this.handleOverflowIndicator();
+            const items = this.getAllFocusableItems();
+            this.resetRovingTabIndex(items);
         });
         if (this.pinned) {
             this.pinnedChange(this.pinned);
         }
     }
     componentWillLoad() {
+        this.updateBottomSlotState();
         useContextConsumer(this.hostElement, ApplicationLayoutContext, (ctx) => {
             this.applicationLayoutContext = ctx;
             if (ctx.hideHeader === true) {
@@ -179,13 +227,9 @@ export class Menu {
             }
             this.onBreakpointChange(applicationLayoutService.breakpoint);
         }, true);
-        menuController.register(this.hostElement);
         applicationLayoutService.onChange.on((breakpoint) => this.onBreakpointChange(breakpoint));
         this.onBreakpointChange(applicationLayoutService.breakpoint, true);
         this.updateThemeState();
-        this.themeDisposer = themeSwitcher.schemaChanged.on(() => {
-            this.updateThemeState();
-        });
         this.themeNameDisposer = themeSwitcher.themeChanged.on(() => {
             this.updateThemeState();
         });
@@ -196,10 +240,12 @@ export class Menu {
         }
         this.appendFragments();
     }
+    connectedCallback() {
+        menuController.register(this.hostElement);
+    }
     disconnectedCallback() {
-        var _a, _b;
-        (_a = this.themeDisposer) === null || _a === void 0 ? void 0 : _a.dispose();
-        (_b = this.themeNameDisposer) === null || _b === void 0 ? void 0 : _b.dispose();
+        this.themeNameDisposer?.dispose();
+        menuController.unregister(this.hostElement);
     }
     updateThemeState() {
         this.isDarkMode = themeSwitcher.getMode() === 'dark';
@@ -227,10 +273,9 @@ export class Menu {
         this.appendAboutNewsPopover();
     }
     getAboutPopoverVerticalPosition() {
-        var _a;
         const heightArrow = 12;
         const offsetArrow = 6;
-        const rectAbout = ((_a = this.aboutTab) === null || _a === void 0 ? void 0 : _a.getBoundingClientRect()) || {
+        const rectAbout = this.aboutTab?.getBoundingClientRect() || {
             bottom: -window.innerHeight,
             height: 0,
         };
@@ -239,20 +284,18 @@ export class Menu {
         return convertToRemString(offset);
     }
     appendAboutNewsPopover() {
-        var _a;
         if (!this.aboutNewsPopover || !this.about) {
             return;
         }
         this.aboutNewsPopover.style.bottom = this.getAboutPopoverVerticalPosition();
-        if (!((_a = this.popoverArea) === null || _a === void 0 ? void 0 : _a.contains(this.aboutNewsPopover))) {
+        if (!this.popoverArea?.contains(this.aboutNewsPopover)) {
             const showMore = () => {
-                var _a;
-                if (((_a = this.aboutNewsPopover) === null || _a === void 0 ? void 0 : _a.aboutItemLabel) && this.about) {
-                    this.about.activeTabLabel = this.aboutNewsPopover.aboutItemLabel;
+                if (this.aboutNewsPopover?.activeAboutTabKey && this.about) {
+                    this.about.activeTabKey = this.aboutNewsPopover.activeAboutTabKey;
                     this.toggleAbout(true);
                 }
             };
-            this.aboutNewsPopover.addEventListener('showMore', showMore.bind(this));
+            this.aboutNewsPopover.addEventListener('showMore', () => showMore());
             document.body.appendChild(this.aboutNewsPopover);
         }
     }
@@ -375,12 +418,6 @@ export class Menu {
             this.about.show = false;
         }
     }
-    getCollapseText() {
-        return this.mapExpand ? this.i18nCollapse : this.i18nExpand;
-    }
-    getCollapseIcon() {
-        return this.mapExpand ? iconNavigationLeft : iconNavigationRight;
-    }
     isMenuItemClicked(event) {
         if (event.target instanceof HTMLElement) {
             return event.target.tagName === 'IX-MENU-ITEM';
@@ -393,9 +430,25 @@ export class Menu {
         this.itemsScrollShadowBottom =
             Math.round(scrollTop + clientHeight) < scrollHeight;
     }
-    onOverlayClose() {
+    onOverlayClose(event) {
+        const shouldRestoreFocus = this.shouldRestoreMenuFocus(event);
         this.animateOverlayFadeOut(() => {
             this.resetOverlay();
+            if (shouldRestoreFocus) {
+                this.focusMenuNavigationContainer();
+            }
+        });
+    }
+    shouldRestoreMenuFocus(event) {
+        return !!event;
+    }
+    focusMenuNavigationContainer() {
+        const menuNavigation = this.menuNavigationContainer;
+        if (!menuNavigation) {
+            return;
+        }
+        requestAnimationFrameNoNgZone(() => {
+            menuNavigation.focus();
         });
     }
     animateOverlayFadeIn() {
@@ -435,25 +488,146 @@ export class Menu {
             this.onOverlayClose();
         }
     }
+    updateBottomSlotState() {
+        this.hasBottomSlotItems = Array.from(this.hostElement.children).some((element) => element.getAttribute('slot') === 'bottom');
+    }
     isHiddenFromViewport() {
         return this.breakpoint === 'sm' && this.expand === false;
     }
-    sidebarToggle() {
-        this.mapExpandChange.emit(this.mapExpand);
-        this.hostElement.dispatchEvent(new ApplicationSidebarToggleEvent(this.mapExpand));
+    updateRovingTabIndex(items, activeIndex) {
+        this.updateMenuItemPositionMetadata(items);
+        items.forEach((item, i) => {
+            item.setTabIndex?.(i === activeIndex ? 0 : -1);
+        });
+    }
+    resetRovingTabIndex(items = this.getAllFocusableItems()) {
+        this.updateMenuItemPositionMetadata(items);
+        items.forEach((item) => {
+            item.setTabIndex?.(-1);
+        });
+    }
+    // item positions and menu size has to be set manually because slotted items and utility controls are separated into two groups
+    updateMenuItemPositionMetadata(items) {
+        // get all items unfiltered in case any of them changed state and became hidden or disabled
+        const allMenuItems = [
+            ...Array.from(this.hostElement.querySelectorAll('ix-menu-item')),
+            ...Array.from(this.hostElement.shadowRoot?.querySelectorAll('.menu-utility-controls > ix-menu-item') ?? []),
+        ];
+        allMenuItems.forEach((item) => {
+            item.removeAttribute('aria-posinset');
+            item.removeAttribute('aria-setsize');
+        });
+        const total = items.length;
+        items.forEach((item, index) => {
+            item.setAttribute('aria-posinset', String(index + 1));
+            item.setAttribute('aria-setsize', String(total));
+        });
+    }
+    handleMenuFocusIn(event) {
+        const items = this.getAllFocusableItems();
+        const path = event.composedPath();
+        const activeIndex = items.findIndex((item) => path.includes(item));
+        if (activeIndex !== -1) {
+            this.lastFocusedMenuItem = items[activeIndex];
+            this.updateRovingTabIndex(items, activeIndex);
+        }
+        else if (event.target instanceof HTMLElement) {
+            this.resetRovingTabIndex(items);
+        }
+    }
+    getAllFocusableItems() {
+        const isNavigable = (el) => !el.hasAttribute('disabled') &&
+            !el.hasAttribute('hidden') &&
+            this.isVisible(el);
+        const lightItems = Array.from(this.hostElement.querySelectorAll(':scope > ix-menu-item, :scope > ix-menu-category, :scope > a > ix-menu-item, :scope > a > ix-menu-category')).filter(isNavigable);
+        const utilityItems = Array.from(this.hostElement.shadowRoot?.querySelectorAll('.menu-utility-controls > ix-menu-item') ?? []).filter(isNavigable);
+        return [...lightItems, ...utilityItems];
+    }
+    suppressAnchorWrapperTabStops() {
+        Array.from(this.hostElement.querySelectorAll(':scope > a'))
+            .filter((a) => a.querySelector('ix-menu-item, ix-menu-category'))
+            .forEach((a) => {
+            if (a.getAttribute('tabindex') !== '-1') {
+                a.setAttribute('tabindex', '-1');
+            }
+        });
+    }
+    isEventFromExpandedCategoryItems(event) {
+        return event
+            .composedPath()
+            .some((el) => el instanceof HTMLElement && el.getAttribute?.('role') === 'menu');
+    }
+    handleMenuKeyDown(event) {
+        if (!['ArrowDown', 'ArrowUp', 'Home', 'End'].includes(event.key)) {
+            return;
+        }
+        if (this.isEventFromExpandedCategoryItems(event)) {
+            return;
+        }
+        const items = this.getAllFocusableItems();
+        if (items.length === 0) {
+            return;
+        }
+        const path = event.composedPath();
+        const currentIndex = items.findIndex((item) => path.includes(item));
+        const isMenuNavigationFocused = currentIndex === -1 && path.includes(this.menuNavigationContainer);
+        if (!isMenuNavigationFocused && currentIndex === -1) {
+            return;
+        }
+        event.preventDefault();
+        if (isMenuNavigationFocused) {
+            let index = items.indexOf(this.lastFocusedMenuItem);
+            if (event.key === 'Home') {
+                index = 0;
+            }
+            else if (event.key === 'End') {
+                index = items.length - 1;
+            }
+            else if (index === -1) {
+                index = event.key === 'ArrowDown' ? 0 : items.length - 1;
+            }
+            this.updateRovingTabIndex(items, index);
+            this.lastFocusedMenuItem = items[index];
+            items[index].focus();
+            return;
+        }
+        switch (event.key) {
+            case 'ArrowDown': {
+                const next = (currentIndex + 1) % items.length;
+                this.updateRovingTabIndex(items, next);
+                this.lastFocusedMenuItem = items[next];
+                items[next].focus();
+                break;
+            }
+            case 'ArrowUp': {
+                const prev = (currentIndex - 1 + items.length) % items.length;
+                this.updateRovingTabIndex(items, prev);
+                this.lastFocusedMenuItem = items[prev];
+                items[prev].focus();
+                break;
+            }
+            case 'Home':
+                this.updateRovingTabIndex(items, 0);
+                this.lastFocusedMenuItem = items[0];
+                items[0].focus();
+                break;
+            case 'End':
+                this.updateRovingTabIndex(items, items.length - 1);
+                this.lastFocusedMenuItem = items.at(-1);
+                items.at(-1)?.focus();
+                break;
+        }
     }
     async showAppSwitch() {
-        var _a;
         const { defaultPrevented } = this.openAppSwitch.emit();
         if (defaultPrevented) {
             return;
         }
-        if ((_a = this.applicationLayoutContext) === null || _a === void 0 ? void 0 : _a.appSwitchConfig) {
+        if (this.applicationLayoutContext?.appSwitchConfig) {
             showAppSwitch(this.applicationLayoutContext.appSwitchConfig);
         }
     }
     render() {
-        var _a, _b;
         let overlayLabel;
         if (this.showSettings) {
             overlayLabel = this.i18nSettings;
@@ -461,44 +635,47 @@ export class Menu {
         else if (this.showAbout) {
             overlayLabel = this.i18nLegal;
         }
-        return (h(Host, { key: 'f110c37a48450f5c2503f7d22aa2ec89ab3e2a2b', class: {
+        return (h(Host, { key: '47a4fe953c394a65c515c69eb164fae9921241d0', class: {
                 expanded: this.expand,
                 [`breakpoint-${this.breakpoint}`]: true,
-            }, slot: "menu" }, h("nav", { key: 'ba8f5ebdf01e3971944d12bf7559920a30de630b', "aria-label": this.applicationName, class: {
+            }, slot: "menu" }, h("nav", { key: 'befa847fe411183d14f2618eae42f11892bd53e3', "aria-label": this.applicationName, class: {
                 menu: true,
                 expanded: this.expand,
-            } }, h("div", { key: 'ded53cf75d43d7470b414c9a79470c08e84cdafc', class: "menu-buttons" }, this.breakpoint !== 'sm' && (h("ix-menu-expand-icon", { key: 'affe4bd90b5d89e8bbfe84e0721f47c089f939c1', breakpoint: this.breakpoint, expanded: this.expand, pinned: this.pinned, class: "menu-expand-icon", onClick: async () => this.toggleMenu(), "data-testid": "expand-collapse-menu" })), this.breakpoint === 'sm' &&
-            ((_a = this.applicationLayoutContext) === null || _a === void 0 ? void 0 : _a.appSwitchConfig) && (h("ix-icon-button", { key: 'eb491ad150526feffc353aa3bc0facad5c022f59', onClick: () => {
+            } }, h("div", { key: 'd648ef9cf9525f858b25dbf8b396ab6faceadd4e', class: "menu-buttons" }, this.breakpoint !== 'sm' && (h("ix-menu-expand-icon", { key: 'b9092de8f71df6ec8b78cc356f5fcc83902b75cd', breakpoint: this.breakpoint, expanded: this.expand, "i18n-expand": this.i18nExpand, "i18n-collapse": this.i18nCollapse, pinned: this.pinned, class: "menu-expand-icon", onClick: async () => this.toggleMenu(), "data-testid": "expand-collapse-menu" })), this.breakpoint === 'sm' &&
+            this.applicationLayoutContext?.appSwitchConfig && (h("ix-icon-button", { key: '4ce5e027869a3fe66290e9447c1da57ea827cdde', onClick: () => {
                 this.showAppSwitch();
-            }, icon: iconApps, variant: "subtle-tertiary" }))), h("div", { key: 'c011962c8617669d512a5819d8fdd0426b889597', id: "menu-tabs", style: {
+            }, icon: iconApps, variant: "subtle-tertiary" }))), h("div", { key: '088f955c6ab52008a6cd1aa6e75ef5d97211cb5b', role: "menubar", "aria-orientation": "vertical", "aria-label": this.i18nAriaLabelMenu, "aria-description": this.i18nNavigationHint, class: {
+                'menu-navigation': true,
+                'menu-navigation--fill': this.shouldFillMenuNavigation,
+            }, tabIndex: 0, onKeyDown: (e) => this.handleMenuKeyDown(e), onFocusin: (e) => this.handleMenuFocusIn(e), onFocusout: () => this.resetRovingTabIndex() }, h("div", { key: 'b1ec4b72b2a1d791429a97617184065e1d47b260', id: "menu-tabs", style: {
                 display: 'contents',
-            }, onClick: (e) => this.onMenuItemsClick(e) }, h("div", { key: '0a2bf780cff17852ebee73236cb9361cda69eae7', class: "tabs-shadow-container" }, h("div", { key: '89e91e3921a72d4fc38fbcfd9bcf7b1dc86b65f3', class: {
+            }, onClick: (e) => this.onMenuItemsClick(e) }, h("div", { key: '80712fd2a17029394ca4355cc0ca22a61ff7b4ef', class: "tabs-shadow-container" }, h("div", { key: '3fc0eca7419f73746525f4881dea0cbc27398d87', class: {
                 'tabs--shadow': true,
                 'tabs--shadow-top': true,
                 'tabs--shadow--show': this.itemsScrollShadowTop,
-            } }), h("div", { key: '576ea9d478068b06c44fdaa0d0ea85291351f50e', class: {
+            } }), h("div", { key: 'f6d8d4716a1b3e15ac7c48a80fd7878ec7003d63', class: {
                 tabs: true,
                 'show-scrollbar': this.expand,
-            }, onScroll: () => this.handleOverflowIndicator() }, h("div", { key: '93207553be4b6ea5c2ee10e4199dea100c571632', class: "menu-avatar" }, h("slot", { key: '9a10f155385fe009c6af637bd2b21162670df08f', name: "ix-menu-avatar" })), h("slot", { key: 'c6ee9852f5c1891f6192654ce0a8b2dc5a6828f7', name: "home" }), this.breakpoint !== 'sm' || !this.isHiddenFromViewport() ? (h("slot", null)) : null), h("div", { key: 'd9ddb5926de8faf8c5bbea2f87e4799c0467884b', class: {
+            }, onScroll: () => this.handleOverflowIndicator() }, h("div", { key: '53ebf16042ac81b94cfceedf4efff1d4eaf74d08', class: "menu-avatar" }, h("slot", { key: '1cbebf98bb6bb2ba9545a153d45390fe6e7effb0', name: "ix-menu-avatar" })), h("slot", { key: '28941eced5a431a5610859c187db19d0f0a17437', name: "home" }), this.breakpoint !== 'sm' || !this.isHiddenFromViewport() ? (h("slot", null)) : null), h("div", { key: 'e67916be1c943d25ae37b7b97c08b0cc1dd72bdf', class: {
                 'tabs--shadow': true,
                 'tabs--shadow-bottom': true,
                 'tabs--shadow--show': this.itemsScrollShadowBottom,
-            } }))), h("div", { key: '2bbe5f772c8d634b57a8d5d0e042bca39d85fb34', class: "bottom-tab-divider" }), this.settings ? (h("ix-menu-item", { disabled: this.isHiddenFromViewport(), id: "settings", class: {
+            } }))), h("div", { key: '0d5aed4213390ac89cb1906e52528fe0451a250f', onClick: (e) => this.onMenuItemsClick(e) }, h("slot", { key: '95514a4b070d7e8c9f73869acf59c78169a524ac', name: "bottom", onSlotchange: () => this.updateBottomSlotState() })), h("div", { key: '24b2a88b7eb24c2a33cf94313a2f6736249d0cd5', class: "bottom-tab-divider" }), h("div", { key: '6900b0226aeed36a3b643b790a4db230a0635eb6', class: "menu-utility-controls" }, this.settings ? (h("ix-menu-item", { disabled: this.isHiddenFromViewport(), id: "settings", class: {
                 'internal-tab': true,
                 'bottom-tab': true,
                 active: this.showSettings,
-            }, icon: iconCogwheel, onClick: async () => this.toggleSettings(!this.showSettings), label: this.i18nSettings, "aria-expanded": this.showSettings.toString(), "aria-controls": "menu-overlay" })) : null, this.enableToggleTheme ? (h("ix-menu-item", { disabled: this.isHiddenFromViewport(), id: "toggleTheme", onClick: () => themeSwitcher.toggleMode(), class: "internal-tab bottom-tab", icon: iconLightDark, label: this.i18nToggleTheme, role: "switch", "aria-checked": this.isDarkMode.toString() })) : null, h("div", { key: 'cb0c86250320b703ef016097137c3f95cf274163', onClick: (e) => this.onMenuItemsClick(e) }, h("slot", { key: '5c22657279384b7fbc82b3728156ec11cc4494e7', name: "bottom" })), h("div", { key: 'a34655b9fbfeecadd26ed3b73b340b56c8481c63', id: "popover-area" }), this.enableMapExpand || ((_b = this.applicationLayoutContext) === null || _b === void 0 ? void 0 : _b.sidebar) ? (h("ix-menu-item", { disabled: this.isHiddenFromViewport(), id: "menu-collapse", onClick: () => this.sidebarToggle(), class: "internal-tab bottom-tab", icon: `${this.getCollapseIcon()}`, label: this.getCollapseText() })) : null, this.about ? (h("ix-menu-item", { disabled: this.isHiddenFromViewport(), id: "aboutAndLegal", class: {
+            }, icon: iconCogwheel, onClick: async () => this.toggleSettings(!this.showSettings), label: this.i18nSettings, "aria-haspopup": "dialog", "aria-expanded": this.showSettings.toString(), "aria-controls": "menu-overlay" })) : null, this.enableToggleTheme ? (h("ix-menu-item", { disabled: this.isHiddenFromViewport(), id: "toggleTheme", onClick: () => themeSwitcher.toggleMode(), class: "internal-tab bottom-tab", icon: iconLightDark, label: this.i18nToggleTheme, role: "menuitemcheckbox", "aria-checked": this.isDarkMode.toString() })) : null, this.about ? (h("ix-menu-item", { disabled: this.isHiddenFromViewport(), id: "aboutAndLegal", class: {
                 'internal-tab': true,
                 'bottom-tab': true,
                 active: this.showAbout,
-            }, icon: iconInfo, onClick: async () => this.toggleAbout(!this.showAbout), label: this.i18nLegal, "aria-expanded": this.showAbout.toString(), "aria-controls": "menu-overlay" })) : null), h("section", { key: '596600987bd9b245b44d7d725ba06a0266869fc0', id: "menu-overlay", "aria-label": overlayLabel, class: {
+            }, icon: iconInfo, onClick: async () => this.toggleAbout(!this.showAbout), label: this.i18nLegal, "aria-haspopup": "dialog", "aria-expanded": this.showAbout.toString(), "aria-controls": "menu-overlay" })) : null)), h("div", { key: '4d1cfd95a64cd7b51eadb71131284ed7404af601', id: "popover-area" })), h("section", { key: '730576b8b7214a6aee310c05f67109fe6911b0c5', id: "menu-overlay", role: "dialog", "aria-label": overlayLabel, class: {
                 'menu-overlay': true,
                 visible: this.isOverlayVisible(),
                 expanded: this.expand,
             }, onTransitionEnd: () => {
                 this.isTransitionDisabled = true;
                 this.checkTransition();
-            } }, h("div", { key: '13b89027a0240f22981b9e6ae41f3e62dbcdc8c9', class: 'menu-overlay-container' }, this.showSettings ? h("slot", { name: "ix-menu-settings" }) : null), h("div", { key: 'a9e17821bc23eef2717fff6a3c9514b54b2bf00f', class: 'menu-overlay-container' }, this.showAbout ? h("slot", { name: "ix-menu-about" }) : null))));
+            } }, h("div", { key: 'f2c7e8b61608398eead0080b0b7e9f40702e3eab', class: 'menu-overlay-container' }, this.showSettings ? h("slot", { name: "ix-menu-settings" }) : null), h("div", { key: 'e77e005e8a36e3b243b310254f230d90539fec94', class: 'menu-overlay-container' }, this.showAbout ? h("slot", { name: "ix-menu-about" }) : null))));
     }
     static get is() { return "ix-menu"; }
     static get encapsulation() { return "shadow"; }
@@ -574,29 +751,6 @@ export class Menu {
                 "attribute": "enable-toggle-theme",
                 "defaultValue": "false"
             },
-            "enableMapExpand": {
-                "type": "boolean",
-                "mutable": false,
-                "complexType": {
-                    "original": "boolean",
-                    "resolved": "boolean",
-                    "references": {}
-                },
-                "required": false,
-                "optional": false,
-                "docs": {
-                    "tags": [{
-                            "name": "internal",
-                            "text": undefined
-                        }],
-                    "text": ""
-                },
-                "getter": false,
-                "setter": false,
-                "reflect": false,
-                "attribute": "enable-map-expand",
-                "defaultValue": "false"
-            },
             "applicationName": {
                 "type": "string",
                 "mutable": false,
@@ -636,29 +790,6 @@ export class Menu {
                 "attribute": "application-description",
                 "defaultValue": "''"
             },
-            "i18nExpandSidebar": {
-                "type": "string",
-                "mutable": false,
-                "complexType": {
-                    "original": "string",
-                    "resolved": "string",
-                    "references": {}
-                },
-                "required": false,
-                "optional": false,
-                "docs": {
-                    "tags": [{
-                            "name": "deprecated",
-                            "text": "Since 4.2.0. Will be removed in 5.0.0. The expand button is now hidden from screen readers with aria-hidden=\"true\"."
-                        }],
-                    "text": "Accessibility i18n label for the burger menu of the sidebar"
-                },
-                "getter": false,
-                "setter": false,
-                "reflect": false,
-                "attribute": "i18n-expand-sidebar",
-                "defaultValue": "'Expand sidebar'"
-            },
             "expand": {
                 "type": "boolean",
                 "mutable": true,
@@ -719,6 +850,52 @@ export class Menu {
                 "attribute": "pinned",
                 "defaultValue": "false"
             },
+            "i18nAriaLabelMenu": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "since",
+                            "text": "5.1.0"
+                        }],
+                    "text": "i18n aria-label for menu. Gets read out by screen readers when first focusing the menu"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "i18n-aria-label-menu",
+                "defaultValue": "'Application Navigation'"
+            },
+            "i18nNavigationHint": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "since",
+                            "text": "5.1.0"
+                        }],
+                    "text": "i18n description for menu keyboard navigation hint, read by screen readers when focusing the menu"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "i18n-navigation-hint",
+                "defaultValue": "'Use Up and Down arrow keys to navigate between menu items'"
+            },
             "i18nLegal": {
                 "type": "string",
                 "mutable": false,
@@ -797,7 +974,7 @@ export class Menu {
                 "setter": false,
                 "reflect": false,
                 "attribute": "i18n-expand",
-                "defaultValue": "' Expand'"
+                "defaultValue": "'Expand'"
             },
             "i18nCollapse": {
                 "type": "string",
@@ -828,6 +1005,7 @@ export class Menu {
             "breakpoint": {},
             "itemsScrollShadowTop": {},
             "itemsScrollShadowBottom": {},
+            "hasBottomSlotItems": {},
             "applicationLayoutContext": {},
             "isDarkMode": {}
         };