@aurodesignsystem-dev/auro-formkit 0.0.0-pr1460.2 → 0.0.0-pr1464.0

package/components/menu/demo/index.min.js

@@ -167,1533 +167,1675 @@ let s$1 = class s{get value(){return this.o}set value(s){this.setValue(s);}setVa
  * SPDX-License-Identifier: BSD-3-Clause
  */let e$2 = class e extends Event{constructor(t,s){super("context-provider",{bubbles:true,composed:true}),this.context=t,this.contextTarget=s;}};let i$2 = class i extends s$1{constructor(s,e,i){super(void 0!==e.context?e.initialValue:i),this.onContextRequest=t=>{if(t.context!==this.context)return;const s=t.contextTarget??t.composedPath()[0];s!==this.host&&(t.stopPropagation(),this.addCallback(t.callback,s,t.subscribe));},this.onProviderRequest=s=>{if(s.context!==this.context)return;if((s.contextTarget??s.composedPath()[0])===this.host)return;const e=new Set;for(const[s,{consumerHost:i}]of this.subscriptions)e.has(s)||(e.add(s),i.dispatchEvent(new s$3(this.context,i,s,true)));s.stopPropagation();},this.host=s,void 0!==e.context?this.context=e.context:this.context=e,this.attachListeners(),this.host.addController?.(this);}attachListeners(){this.host.addEventListener("context-request",this.onContextRequest),this.host.addEventListener("context-provider",this.onProviderRequest);}hostConnected(){this.host.dispatchEvent(new e$2(this.context,this.host));}};
 
-/**
- * @license
- * Copyright 2020 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
- */
-const a=Symbol.for(""),o$1=t=>{if(t?.r===a)return t?._$litStatic$},s=t=>({_$litStatic$:t,r:a}),i$1=(t,...r)=>({_$litStatic$:r.reduce((r,e,a)=>r+(t=>{if(void 0!==t._$litStatic$)return t._$litStatic$;throw Error(`Value passed to 'literal' function must be a 'literal' result: ${t}. Use 'unsafeStatic' to pass non-literal values, but\n            take care to ensure page security.`)})(e)+t[a+1],t[0]),r:a}),l=new Map,n=t=>(r,...e)=>{const a=e.length;let s,i;const n=[],u=[];let c,$=0,f=false;for(;$<a;){for(c=r[$];$<a&&void 0!==(i=e[$],s=o$1(i));)c+=s+r[++$],f=true;$!==a&&u.push(i),n.push(c),$++;}if($===a&&n.push(r[a]),f){const t=n.join("$$lit$$");void 0===(r=l.get(t))&&(n.raw=n,l.set(t,r=n)),e=u;}return t(r,...e)},u$1=n(b);
-
-var styleCss = i$6`.body-default{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-default-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-default-font-size, 1rem);line-height:var(--wcss-body-default-line-height, 1.5rem)}.body-default-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-default-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-default-emphasized-font-size, 1rem);line-height:var(--wcss-body-default-emphasized-line-height, 1.5rem)}.body-lg{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-lg-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-lg-font-size, 1.125rem);line-height:var(--wcss-body-lg-line-height, 1.625rem)}.body-lg-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-lg-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-lg-emphasized-font-size, 1.125rem);line-height:var(--wcss-body-lg-emphasized-line-height, 1.625rem)}.body-sm{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-sm-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-sm-font-size, 0.875rem);line-height:var(--wcss-body-sm-line-height, 1.25rem)}.body-sm-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-sm-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-sm-emphasized-font-size, 0.875rem);line-height:var(--wcss-body-sm-emphasized-line-height, 1.25rem)}.body-xs{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-xs-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-xs-font-size, 0.75rem);line-height:var(--wcss-body-xs-line-height, 1rem)}.body-xs-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-xs-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-xs-emphasized-font-size, 0.75rem);line-height:var(--wcss-body-xs-emphasized-line-height, 1rem)}.body-2xs{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-2xs-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-2xs-font-size, 0.625rem);line-height:var(--wcss-body-2xs-line-height, 0.875rem)}.body-2xs-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-2xs-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-2xs-emphasized-font-size, 0.625rem);line-height:var(--wcss-body-2xs-emphasized-line-height, 0.875rem)}.display-2xl{font-family:var(--wcss-display-2xl-family, "AS Circular"),var(--wcss-display-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-2xl-weight, 300);line-height:var(--wcss-display-2xl-line-height, 1.3);font-size:var(--wcss-display-2xl-font-size, clamp(3.5rem, 6vw, 5.375rem));letter-spacing:var(--wcss-display-2xl-letter-spacing, 0)}.display-xl{font-family:var(--wcss-display-xl-family, "AS Circular"),var(--wcss-display-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-xl-weight, 300);line-height:var(--wcss-display-xl-line-height, 1.3);font-size:var(--wcss-display-xl-font-size, clamp(3rem, 5.3333333333vw, 4.5rem));letter-spacing:var(--wcss-display-xl-letter-spacing, 0)}.display-lg{font-family:var(--wcss-display-lg-family, "AS Circular"),var(--wcss-display-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-lg-weight, 300);line-height:var(--wcss-display-lg-line-height, 1.3);font-size:var(--wcss-display-lg-font-size, clamp(2.75rem, 4.6666666667vw, 4rem));letter-spacing:var(--wcss-display-lg-letter-spacing, 0)}.display-md{font-family:var(--wcss-display-md-family, "AS Circular"),var(--wcss-display-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-md-weight, 300);line-height:var(--wcss-display-md-line-height, 1.3);font-size:var(--wcss-display-md-font-size, clamp(2.5rem, 4vw, 3.5rem));letter-spacing:var(--wcss-display-md-letter-spacing, 0)}.display-sm{font-family:var(--wcss-display-sm-family, "AS Circular"),var(--wcss-display-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-sm-weight, 300);line-height:var(--wcss-display-sm-line-height, 1.3);font-size:var(--wcss-display-sm-font-size, clamp(2rem, 3.6666666667vw, 3rem));letter-spacing:var(--wcss-display-sm-letter-spacing, 0)}.display-xs{font-family:var(--wcss-display-xs-family, "AS Circular"),var(--wcss-display-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-xs-weight, 300);line-height:var(--wcss-display-xs-line-height, 1.3);font-size:var(--wcss-display-xs-font-size, clamp(1.75rem, 3vw, 2.375rem));letter-spacing:var(--wcss-display-xs-letter-spacing, 0)}.heading-xl{font-family:var(--wcss-heading-xl-family, "AS Circular"),var(--wcss-heading-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-xl-weight, 300);line-height:var(--wcss-heading-xl-line-height, 1.3);font-size:var(--wcss-heading-xl-font-size, clamp(2rem, 3vw, 2.5rem));letter-spacing:var(--wcss-heading-xl-letter-spacing, 0)}.heading-lg{font-family:var(--wcss-heading-lg-family, "AS Circular"),var(--wcss-heading-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-lg-weight, 300);line-height:var(--wcss-heading-lg-line-height, 1.3);font-size:var(--wcss-heading-lg-font-size, clamp(1.75rem, 2.6666666667vw, 2.25rem));letter-spacing:var(--wcss-heading-lg-letter-spacing, 0)}.heading-md{font-family:var(--wcss-heading-md-family, "AS Circular"),var(--wcss-heading-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-md-weight, 300);line-height:var(--wcss-heading-md-line-height, 1.3);font-size:var(--wcss-heading-md-font-size, clamp(1.625rem, 2.3333333333vw, 1.75rem));letter-spacing:var(--wcss-heading-md-letter-spacing, 0)}.heading-sm{font-family:var(--wcss-heading-sm-family, "AS Circular"),var(--wcss-heading-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-sm-weight, 300);line-height:var(--wcss-heading-sm-line-height, 1.3);font-size:var(--wcss-heading-sm-font-size, clamp(1.375rem, 2vw, 1.5rem));letter-spacing:var(--wcss-heading-sm-letter-spacing, 0)}.heading-xs{font-family:var(--wcss-heading-xs-family, "AS Circular"),var(--wcss-heading-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-xs-weight, 300);line-height:var(--wcss-heading-xs-line-height, 1.3);font-size:var(--wcss-heading-xs-font-size, clamp(1.25rem, 1.6666666667vw, 1.25rem));letter-spacing:var(--wcss-heading-xs-letter-spacing, 0)}.heading-2xs{font-family:var(--wcss-heading-2xs-family, "AS Circular"),var(--wcss-heading-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-2xs-weight, 300);line-height:var(--wcss-heading-2xs-line-height, 1.3);font-size:var(--wcss-heading-2xs-font-size, clamp(1.125rem, 1.5vw, 1.125rem));letter-spacing:var(--wcss-heading-2xs-letter-spacing, 0)}.accent-2xl{font-family:var(--wcss-accent-2xl-family, "Good OT"),var(--wcss-accent-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-2xl-weight, 450);line-height:var(--wcss-accent-2xl-line-height, 1);font-size:var(--wcss-accent-2xl-font-size, clamp(2rem, 3.1666666667vw, 2.375rem));letter-spacing:var(--wcss-accent-2xl-letter-spacing, 0.05em);text-transform:uppercase}.accent-xl{font-family:var(--wcss-accent-xl-family, "Good OT"),var(--wcss-accent-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-xl-weight, 450);line-height:var(--wcss-accent-xl-line-height, 1.3);font-size:var(--wcss-accent-xl-font-size, clamp(1.625rem, 2.3333333333vw, 2rem));letter-spacing:var(--wcss-accent-xl-letter-spacing, 0.05em);text-transform:uppercase}.accent-lg{font-family:var(--wcss-accent-lg-family, "Good OT"),var(--wcss-accent-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-lg-weight, 450);line-height:var(--wcss-accent-lg-line-height, 1.3);font-size:var(--wcss-accent-lg-font-size, clamp(1.5rem, 2.1666666667vw, 1.75rem));letter-spacing:var(--wcss-accent-lg-letter-spacing, 0.05em);text-transform:uppercase}.accent-md{font-family:var(--wcss-accent-md-family, "Good OT"),var(--wcss-accent-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-md-weight, 500);line-height:var(--wcss-accent-md-line-height, 1.3);font-size:var(--wcss-accent-md-font-size, clamp(1.375rem, 1.8333333333vw, 1.5rem));letter-spacing:var(--wcss-accent-md-letter-spacing, 0.05em);text-transform:uppercase}.accent-sm{font-family:var(--wcss-accent-sm-family, "Good OT"),var(--wcss-accent-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-sm-weight, 500);line-height:var(--wcss-accent-sm-line-height, 1.3);font-size:var(--wcss-accent-sm-font-size, clamp(1.125rem, 1.5vw, 1.25rem));letter-spacing:var(--wcss-accent-sm-letter-spacing, 0.05em);text-transform:uppercase}.accent-xs{font-family:var(--wcss-accent-xs-family, "Good OT"),var(--wcss-accent-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-xs-weight, 500);line-height:var(--wcss-accent-xs-line-height, 1.3);font-size:var(--wcss-accent-xs-font-size, clamp(1rem, 1.3333333333vw, 1rem));letter-spacing:var(--wcss-accent-xs-letter-spacing, 0.1em);text-transform:uppercase}.accent-2xs{font-family:var(--wcss-accent-2xs-family, "Good OT"),var(--wcss-accent-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-2xs-weight, 450);line-height:var(--wcss-accent-2xs-line-height, 1.3);font-size:var(--wcss-accent-2xs-font-size, clamp(0.875rem, 1.1666666667vw, 0.875rem));letter-spacing:var(--wcss-accent-2xs-letter-spacing, 0.1em);text-transform:uppercase}:host{cursor:pointer;user-select:none;text-overflow:ellipsis;max-width:100dvw}:host .wrapper{display:flex;align-items:center;height:var(--ds-size-400, 2rem);padding-right:var(--ds-size-200, 1rem);padding-left:calc(var(--ds-size-150, 0.75rem) + var(--ds-size-300, 1.5rem) + var(--ds-size-100, 0.5rem));border-radius:var(--ds-size-100, 0.5rem);-webkit-tap-highlight-color:transparent}:host .wrapper[class*=shape-box]{border-radius:unset}:host .wrapper[class*=shape-snowflake]{border-radius:unset;line-height:24px}:host .wrapper[class*=shape-pill]{border-radius:30px}:host .wrapper[class*=-lg]{padding-top:var(--ds-size-75, 0.375rem);padding-bottom:var(--ds-size-75, 0.375rem);padding-right:var(--ds-size-150, 0.75rem);line-height:26px}:host .wrapper[class*=-xl]{padding-top:var(--ds-size-100, 0.5rem);padding-bottom:var(--ds-size-100, 0.5rem);padding-right:var(--ds-size-200, 1rem);line-height:26px}:host slot{display:block;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}:host [auro-icon]{--ds-auro-icon-size: var(--ds-size-300, 1.5rem);margin-right:var(--ds-size-150, 0.75rem);margin-left:var(--ds-size-100, 0.5rem)}:host ::slotted(.nestingSpacer){display:inline-block;width:var(--ds-size-300, 1.5rem)}[slot=displayValue]{display:none}:host([loadingplaceholder]) .wrapper{padding-left:calc(var(--ds-size-150, 0.75rem) + var(--ds-size-300, 1.5rem) + var(--ds-size-100, 0.5rem))}:host([selected]) .wrapper{padding-left:0}:host([nocheckmark]) .wrapper{padding-left:var(--ds-size-150, 0.75rem)}:host([nocheckmark]) .wrapper[class*=-lg]{padding-left:var(--ds-size-150, 0.75rem)}:host([nocheckmark]) .wrapper[class*=-xl]{padding-left:var(--ds-size-200, 1rem)}:host([hidden]){display:none}:host([static]){pointer-events:none}:host([disabled]:hover){cursor:auto}:host([disabled]){user-select:none;pointer-events:none}`;
-
-var colorCss = i$6`:host .wrapper{background-color:var(--ds-auro-menuoption-container-color, transparent);box-shadow:inset 0 0 0 1px var(--ds-auro-menuoption-container-border-color, transparent);color:var(--ds-auro-menuoption-text-color)}:host svg{fill:var(--ds-auro-menuoption-icon-color)}:host([disabled]){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-default, #ffffff);--ds-auro-menuoption-text-color: var(--ds-basic-color-texticon-disabled, #d0d0d0);--ds-auro-menuoption-icon-color: var(--ds-basic-color-texticon-disabled, #d0d0d0)}:host(.active){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd)}@media(hover: hover){:host(:hover){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd)}}:host(:focus){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-default, #ffffff);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}:host([selected]){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-subtle, #b4eff9);--ds-auro-menuoption-text-color: var(--ds-basic-color-texticon-default, #2a2a2a);--ds-auro-menuoption-icon-color: var(--ds-basic-color-texticon-default, #2a2a2a)}:host([selected].active){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd)}@media(hover: hover){:host([selected]:hover){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd)}}:host([selected]:focus){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-subtle, #b4eff9);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}:host(:focus.active){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}@media(hover: hover){:host(:focus:hover){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}}:host([selected]:focus.active){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}@media(hover: hover){:host([selected]:focus:hover){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}}`;
-
-// Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
-// See LICENSE in the project root for license information.
+/* eslint-disable */
 
-// ---------------------------------------------------------------------
+class MenuService {
 
-/* eslint-disable line-comment-position, no-inline-comments, no-confusing-arrow, no-nested-ternary, implicit-arrow-linebreak */
+  /**
+   * PROPERTIES AND GETTERS
+   */
 
-class AuroLibraryRuntimeUtils {
+  /**
+   * Gets the list of registered menu options.
+   * @returns {AuroMenuOption[]}
+   */
+  get menuOptions() {
+    return this._menuOptions;
+  }
 
-  /* eslint-disable jsdoc/require-param */
+  /**
+   * Gets the currently highlighted option.
+   * @returns {AuroMenuOption|null}
+   */
+  get highlightedOption() {
+    return this._menuOptions[this.highlightedIndex] || null;
+  }
 
   /**
-   * This will register a new custom element with the browser.
-   * @param {String} name - The name of the custom element.
-   * @param {Object} componentClass - The class to register as a custom element.
-   * @returns {void}
+   * Gets the current value(s) of the selected option(s).
+   * @returns {string|string[]|undefined}
    */
-  registerComponent(name, componentClass) {
-    if (!customElements.get(name)) {
-      customElements.define(name, class extends componentClass {});
-    }
+  get currentValue() {
+    const values = (this.selectedOptions || []).map(option => option.value);
+    return this.multiSelect ? values : values[0];
   }
 
   /**
-   * Finds and returns the closest HTML Element based on a selector.
-   * @returns {void}
+   * Gets the label(s) of the currently selected option(s).
+   * @returns {string}
    */
-  closestElement(
-    selector, // selector like in .closest()
-    base = this, // extra functionality to skip a parent
-    __Closest = (el, found = el && el.closest(selector)) =>
-      !el || el === document || el === window
-        ? null // standard .closest() returns null for non-found selectors also
-        : found
-          ? found // found a selector INside this element
-          : __Closest(el.getRootNode().host) // recursion!! break out to parent DOM
-  ) {
-    return __Closest(base);
+  get currentLabel() {
+    const labels = (this.selectedOptions || []).map(option => option.textContent);
+    return this.multiSelect ? labels.join(", ") : labels[0] || '';
   }
-  /* eslint-enable jsdoc/require-param */
 
   /**
-   * If the element passed is registered with a different tag name than what is passed in, the tag name is added as an attribute to the element.
-   * @param {Object} elem - The element to check.
-   * @param {String} tagName - The name of the Auro component to check for or add as an attribute.
-   * @returns {void}
+   * Gets the string representation of the current value(s).
+   * For multi-select, this is a JSON stringified array.
+   * @returns {string|undefined}
    */
-  handleComponentTagRename(elem, tagName) {
-    const tag = tagName.toLowerCase();
-    const elemTag = elem.tagName.toLowerCase();
+  get stringValue() {
+    const { currentValue } = this;
 
-    if (elemTag !== tag) {
-      elem.setAttribute(tag, true);
+    if (Array.isArray(currentValue)) {
+      if (currentValue.length > 0) {
+        return JSON.stringify(currentValue);
+      }
+      return undefined;
+    }
+
+    if (typeof currentValue === 'string') {
+      if (currentValue.length > 0) {
+        return currentValue;
+      }
+      return undefined;
     }
+
+    // Future: handle other types here (e.g., number, object, etc.)
+    return undefined;
   }
 
   /**
-   * Validates if an element is a specific Auro component.
-   * @param {Object} elem - The element to validate.
-   * @param {String} tagName - The name of the Auro component to check against.
-   * @returns {Boolean} - Returns true if the element is the specified Auro component.
+   * Gets the key(s) of the currently selected option(s).
+   * @returns {string|string[]|undefined}
    */
-  elementMatch(elem, tagName) {
-    const tag = tagName.toLowerCase();
-    const elemTag = elem.tagName.toLowerCase();
-
-    return elemTag === tag || elem.hasAttribute(tag);
+  get currentKeys() {
+    const keys = (this.selectedOptions || []).map(option => option.key);
+    return this.multiSelect ? keys : keys[0];
   }
 
   /**
-   * Gets the text content of a named slot.
-   * @returns {String}
-   * @private
+   * CONSTRUCTOR
    */
-  getSlotText(elem, name) {
-    const slot = elem.shadowRoot?.querySelector(`slot[name="${name}"]`);
-    const nodes = slot?.assignedNodes({ flatten: true }) || [];
-    const text = nodes.map(n => n.textContent?.trim()).join(' ').trim();
 
-    return text || null;
-  }
-}
+  /**
+   * Creates a new MenuService instance.
+   * @param {Object} options - The options object.
+   *   @param {AuroMenu} options.host - The host element that this service will control. Required.
+   * @throws {Error} If the host is not provided.
+   */
+  constructor({ host } = {}) {
 
-// Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
-// See LICENSE in the project root for license information.
+    // Ensure a host was passed
+    if (!host) {
+      throw new Error("MenuService requires a host element.");
+    }
 
+    // Attach the service to the host
+    this.host = host;
+    this.host.addController(this);
 
-class AuroDependencyVersioning {
+    // Set default properties
+    this.size = undefined;
+    this.shape = undefined;
+    this.noCheckmark = undefined;
+    this.disabled = undefined;
+    this.matchWord = undefined;
+    this.multiSelect = undefined;
+    this.allowDeselect = undefined;
+    this.selectAllMatchingOptions = undefined;
+
+    this.highlightedIndex = -1;
+
+    this._menuOptions = [];
+    this._subscribers = [];
+    this.internalUpdateInProgress = false;
+    this.selectedOptions = [];
+    this._pendingValue = null;
+    this._pendingRetryScheduled = false;
+    this._pendingRetryCount = 0;
+  }
 
   /**
-   * Generates a unique string to be used for child auro element naming.
-   * @private
-   * @param {string} baseName - Defines the first part of the unique element name.
-   * @param {string} version - Version of the component that will be appended to the baseName.
-   * @returns {string} - Unique string to be used for naming.
+   * PROPERTY SYNCING
    */
-  generateElementName(baseName, version) {
-    let result = baseName;
 
-    result += '-';
-    result += version.replace(/[.]/g, '_');
+  /**
+   * Handles host updates.
+   * This is a lit reactive lifecycle method.
+   * This comes from the Lit controller interface provided by adding this service as a controller to the host.
+   * See constructor for `this.host.addController(this)`
+   * You can read more about Lit reactive controllers here: https://lit.dev/docs/composition/controllers/
+   */
+  hostUpdated() {
 
-    return result;
+    // Reset selection if multiSelect mode changes
+    if (this.host.multiSelect !== this.multiSelect) {
+      this.selectedOptions = [];
+    }
+
+    // Update properties on host update
+    this.setProperties({
+      size: this.host.size,
+      shape: this.host.shape,
+      noCheckmark: this.host.noCheckmark,
+      disabled: this.host.disabled,
+      matchWord: this.host.matchWord,
+      multiSelect: this.host.multiSelect,
+      allowDeselect: this.host.allowDeselect,
+      selectAllMatchingOptions: this.host.selectAllMatchingOptions
+    });
   }
 
   /**
-   * Generates a unique string to be used for child auro element naming.
-   * @param {string} baseName - Defines the first part of the unique element name.
-   * @param {string} version - Version of the component that will be appended to the baseName.
-   * @returns {string} - Unique string to be used for naming.
+   * Handles host disconnection and memory cleanup.
    */
-  generateTag(baseName, version, tagClass) {
-    const elementName = this.generateElementName(baseName, version);
-    const tag = i$1`${s(elementName)}`;
+  hostDisconnected() {
+    this._subscribers = [];
+    this._menuOptions = [];
+    this._pendingValue = null;
+    this._pendingRetryScheduled = false;
+    this._pendingRetryCount = 0;
+  }
 
-    if (!customElements.get(elementName)) {
-      customElements.define(elementName, class extends tagClass {});
+  /**
+   * Sets a property value if it exists on the instance and the value has changed.
+   * @param {string} property
+   * @param {any} value
+   */
+  setProperty(property, value) {
+
+    // Only update if we are tracking the property in this service
+    if (this.hasOwnProperty(property)) {
+
+      // Check if the value has changed
+      const valueChanged = this[property] !== value;
+
+      // Update and notify if changed
+      if (valueChanged) {
+        this[property] = value;
+        this.notify({ property, value });
+      }
     }
+  }
 
-    return tag;
+  /**
+   * Sets multiple properties on the instance.
+   * @param {Object} properties - Key-value pairs of properties to set.
+   */
+  setProperties(properties) {
+    for (const [key, value] of Object.entries(properties)) {
+      this.setProperty(key, value);
+    }
   }
-}
 
-/**
- * @license
- * Copyright 2017 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
- */
-const t={ATTRIBUTE:1},e$1=t=>(...e)=>({_$litDirective$:t,values:e});class i{constructor(t){}get _$AU(){return this._$AM._$AU}_$AT(t,e,i){this._$Ct=t,this._$AM=e,this._$Ci=i;}_$AS(t,e){return this.update(t,e)}update(t,e){return this.render(...e)}}
+  /**
+   * MENU OPTION HIGHLIGHTING
+   */
 
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
- */const e=e$1(class extends i{constructor(t$1){if(super(t$1),t$1.type!==t.ATTRIBUTE||"class"!==t$1.name||t$1.strings?.length>2)throw Error("`classMap()` can only be used in the `class` attribute and must be the only part in the attribute.")}render(t){return " "+Object.keys(t).filter(s=>t[s]).join(" ")+" "}update(s,[i]){if(void 0===this.st){this.st=new Set,void 0!==s.strings&&(this.nt=new Set(s.strings.join(" ").split(/\s/).filter(t=>""!==t)));for(const t in i)i[t]&&!this.nt?.has(t)&&this.st.add(t);return this.render(i)}const r=s.element.classList;for(const t of this.st)t in i||(r.remove(t),this.st.delete(t));for(const t in i){const s=!!i[t];s===this.st.has(t)||this.nt?.has(t)||(s?(r.add(t),this.st.add(t)):(r.remove(t),this.st.delete(t)));}return E}});
+  /**
+   * Highlights the next active option in the menu.
+   */
+  highlightNext() {
+    this.moveHighlightedOption("next");
+  }
 
-/**
- * @license
- * Copyright 2018 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
- */const o=o=>o??A;
-
-class p{registerComponent(t,a){customElements.get(t)||customElements.define(t,class extends a{});}closestElement(t,a=this,e=(a,s=a&&a.closest(t))=>a&&a!==document&&a!==window?s||e(a.getRootNode().host):null){return e(a)}handleComponentTagRename(t,a){const e=a.toLowerCase();t.tagName.toLowerCase()!==e&&t.setAttribute(e,true);}elementMatch(t,a){const e=a.toLowerCase();return t.tagName.toLowerCase()===e||t.hasAttribute(e)}getSlotText(t,a){const e=t.shadowRoot?.querySelector(`slot[name="${a}"]`);return (e?.assignedNodes({flatten:true})||[]).map(t=>t.textContent?.trim()).join(" ").trim()||null}}var u='<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-labelledby="error__desc" class="ico_squareLarge" data-deprecated="true" role="img" style="min-width:var(--auro-size-lg, var(--ds-size-300, 1.5rem));height:var(--auro-size-lg, var(--ds-size-300, 1.5rem));fill:currentColor" viewBox="0 0 24 24" part="svg"><title/><desc id="error__desc">Error alert indicator.</desc><path d="m13.047 5.599 6.786 11.586A1.207 1.207 0 0 1 18.786 19H5.214a1.207 1.207 0 0 1-1.047-1.815l6.786-11.586a1.214 1.214 0 0 1 2.094 0m-1.165.87a.23.23 0 0 0-.085.085L5.419 17.442a.232.232 0 0 0 .203.35h12.756a.234.234 0 0 0 .203-.35L12.203 6.554a.236.236 0 0 0-.321-.084M12 15.5a.75.75 0 1 1 0 1.5.75.75 0 0 1 0-1.5m-.024-6.22c.325 0 .589.261.589.583v4.434a.586.586 0 0 1-.589.583.586.586 0 0 1-.588-.583V9.863c0-.322.264-.583.588-.583"/></svg>',g='<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" style="min-width:100%;height:auto;fill:currentColor" viewBox="0 0 142 138" part="svg"><title id="tail-DEFAULT__title">Airplane tail default image with light gray color</title><path fill="url(#paint0_linear_9225_2069)" fill-rule="evenodd" d="M124.093 14.665a3.26 3.26 0 0 1 3.208 3.829L101.097 119.85c-.47 1.087-2.211 3.398-5.692 3.471l-.106.001-80.65.013A659230 659230 0 0 1 99.08 17.412c1.214-1.497 3.275-2.722 5.372-2.747z" clip-rule="evenodd"/><defs><linearGradient id="paint0_linear_9225_2069" x1="114.823" x2="60.061" y1="14.665" y2="123.335" gradientUnits="userSpaceOnUse"><stop offset=".5" stop-color="#707984"/><stop offset=".5" stop-color="#646E7B"/></linearGradient></defs></svg>';class m extends i$3{static get properties(){return {hidden:{type:Boolean,reflect:true},hiddenVisually:{type:Boolean,reflect:true},hiddenAudible:{type:Boolean,reflect:true}}}hideAudible(t){return t?"true":"false"}}const f=new Map,w=(t,a={})=>{const e=a.responseParser||(t=>t.text());return f.has(t)||f.set(t,fetch(t).then(e)),f.get(t)};var z=i$6`:focus:not(:focus-visible){outline:3px solid transparent}.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock,:host{display:block}.util_displayFlex{display:flex}.util_displayHidden,:host([hidden]:not(:focus):not(:active)){display:none}.util_displayHiddenVisually,:host([hiddenVisually]:not(:focus):not(:active)){position:absolute;overflow:hidden;clip:rect(1px,1px,1px,1px);width:1px;height:1px;padding:0;border:0}.ico_squareLarge{fill:currentColor;height:var(--auro-size-lg, var(--ds-size-300, 1.5rem))}.ico_squareSmall{fill:currentColor;height:.6rem}.ico_squareMed{fill:currentColor;height:var(--auro-size-md, var(--ds-size-200, 1rem))}.ico_squareSml{fill:currentColor;height:var(--auro-size-sm, var(--ds-size-150, .75rem))}:host{color:currentColor;vertical-align:middle;display:inline-block}svg{min-width:var(--ds-auro-icon-size, 1.5rem)!important;width:var(--ds-auro-icon-size, 1.5rem)!important;height:var(--ds-auro-icon-size, 1.5rem)!important}.componentWrapper{display:flex;line-height:var(--ds-auro-icon-size)}.svgWrapper{height:var(--ds-auro-icon-size);width:var(--ds-auro-icon-size)}.svgWrapper [part=svg]{display:flex}.labelWrapper{margin-left:var(--ds-size-50, .25rem)}.labelWrapper ::slotted(*){line-height:inherit!important}
-`;class y extends m{constructor(){super(),this._initializeDefaults();}_initializeDefaults(){this.onDark=false,this.appearance="default";}static get properties(){return {...m.properties,onDark:{type:Boolean,reflect:true},appearance:{type:String,reflect:true},svg:{attribute:false,reflect:true}}}static get styles(){return z}async fetchIcon(t,a){let e="";e="logos"===t?await w(`${this.uri}/${t}/${a}.svg`):await w(`${this.uri}/icons/${t}/${a}.svg`);return (new DOMParser).parseFromString(e,"text/html").body.querySelector("svg")}async firstUpdated(){try{if(!this.customSvg){const t=await this.fetchIcon(this.category,this.name);if(t)this.svg=t;else if(!t){const t=this.name?.startsWith("tail-")?g:u;this.svg=(new DOMParser).parseFromString(t,"text/html").body.querySelector("svg");}}}catch(t){this.svg=void 0;}}}i$6`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock,:host{display:block}.util_displayFlex{display:flex}.util_displayHidden,:host([hidden]:not(:focus):not(:active)){display:none}.util_displayHiddenVisually,:host([hiddenVisually]:not(:focus):not(:active)){position:absolute;overflow:hidden;clip:rect(1px,1px,1px,1px);width:1px;height:1px;padding:0;border:0}:host{display:inline-block;--ds-auro-icon-size: 100%;width:100%;height:100%}:host .logo{color:var(--ds-auro-alaska-color)}:host([onDark]),:host([appearance=inverse]){--ds-auro-alaska-color: #FFF}
-`;var M=i$6`:host{--ds-auro-icon-color: var(--ds-basic-color-texticon-default, #2a2a2a);--ds-auro-alaska-color: #02426D;--ds-auro-icon-size: var(--ds-size-300, 1.5rem)}
-`;var _=i$6`:host{color:var(--ds-auro-icon-color)}:host([customColor]){color:inherit}:host(:not([onDark])[variant=accent1]),:host(:not([appearance=inverse])[variant=accent1]){--ds-auro-icon-color: var(--ds-basic-color-texticon-accent1, #265688)}:host(:not([onDark])[variant=disabled]),:host(:not([appearance=inverse])[variant=disabled]){--ds-auro-icon-color: var(--ds-basic-color-texticon-disabled, #d0d0d0)}:host(:not([onDark])[variant=muted]),:host(:not([appearance=inverse])[variant=muted]){--ds-auro-icon-color: var(--ds-basic-color-texticon-muted, #676767)}:host(:not([onDark])[variant=statusDefault]),:host(:not([appearance=inverse])[variant=statusDefault]){--ds-auro-icon-color: var(--ds-basic-color-status-default, #afb9c6)}:host(:not([onDark])[variant=statusInfo]),:host(:not([appearance=inverse])[variant=statusInfo]){--ds-auro-icon-color: var(--ds-basic-color-status-info, #01426a)}:host(:not([onDark])[variant=statusSuccess]),:host(:not([appearance=inverse])[variant=statusSuccess]){--ds-auro-icon-color: var(--ds-basic-color-status-success, #447a1f)}:host(:not([onDark])[variant=statusWarning]),:host(:not([appearance=inverse])[variant=statusWarning]){--ds-auro-icon-color: var(--ds-basic-color-status-warning, #fac200)}:host(:not([onDark])[variant=statusError]),:host(:not([appearance=inverse])[variant=statusError]){--ds-auro-icon-color: var(--ds-basic-color-status-error, #e31f26)}:host(:not([onDark])[variant=statusInfoSubtle]),:host(:not([appearance=inverse])[variant=statusInfoSubtle]){--ds-auro-icon-color: var(--ds-basic-color-status-info-subtle, #ebf3f9)}:host(:not([onDark])[variant=statusSuccessSubtle]),:host(:not([appearance=inverse])[variant=statusSuccessSubtle]){--ds-auro-icon-color: var(--ds-basic-color-status-success-subtle, #d6eac7)}:host(:not([onDark])[variant=statusWarningSubtle]),:host(:not([appearance=inverse])[variant=statusWarningSubtle]){--ds-auro-icon-color: var(--ds-basic-color-status-warning-subtle, #fff0b2)}:host(:not([onDark])[variant=statusErrorSubtle]),:host(:not([appearance=inverse])[variant=statusErrorSubtle]){--ds-auro-icon-color: var(--ds-basic-color-status-error-subtle, #fbc6c6)}:host(:not([onDark])[variant=fareBasicEconomy]),:host(:not([appearance=inverse])[variant=fareBasicEconomy]){--ds-auro-icon-color: var(--ds-basic-color-fare-basiceconomy, #97eaf8)}:host(:not([onDark])[variant=fareBusiness]),:host(:not([appearance=inverse])[variant=fareBusiness]){--ds-auro-icon-color: var(--ds-basic-color-fare-business, #01426a)}:host(:not([onDark])[variant=fareEconomy]),:host(:not([appearance=inverse])[variant=fareEconomy]){--ds-auro-icon-color: var(--ds-basic-color-fare-economy, #0074ca)}:host(:not([onDark])[variant=fareFirst]),:host(:not([appearance=inverse])[variant=fareFirst]){--ds-auro-icon-color: var(--ds-basic-color-fare-first, #00274a)}:host(:not([onDark])[variant=farePremiumEconomy]),:host(:not([appearance=inverse])[variant=farePremiumEconomy]){--ds-auro-icon-color: var(--ds-basic-color-fare-premiumeconomy, #005154)}:host(:not([onDark])[variant=tierOneWorldEmerald]),:host(:not([appearance=inverse])[variant=tierOneWorldEmerald]){--ds-auro-icon-color: var(--ds-basic-color-tier-program-oneworld-emerald, #139142)}:host(:not([onDark])[variant=tierOneWorldSapphire]),:host(:not([appearance=inverse])[variant=tierOneWorldSapphire]){--ds-auro-icon-color: var(--ds-basic-color-tier-program-oneworld-sapphire, #015daa)}:host(:not([onDark])[variant=tierOneWorldRuby]),:host(:not([appearance=inverse])[variant=tierOneWorldRuby]){--ds-auro-icon-color: var(--ds-basic-color-tier-program-oneworld-ruby, #a41d4a)}:host([onDark]),:host([appearance=inverse]){--ds-auro-icon-color: var(--ds-basic-color-texticon-inverse, #ffffff)}:host([onDark][variant=disabled]),:host([appearance=inverse][variant=disabled]){--ds-auro-icon-color: var(--ds-basic-color-texticon-inverse-disabled, #7e8894)}:host([onDark][variant=muted]),:host([appearance=inverse][variant=muted]){--ds-auro-icon-color: var(--ds-basic-color-texticon-inverse-muted, #ccd2db)}:host([onDark][variant=statusError]),:host([appearance=inverse][variant=statusError]){--ds-auro-icon-color: var(--ds-advanced-color-state-error-inverse, #f9a4a8)}
-`;class k extends y{constructor(){super(),this._initializeDefaults();}_initializeDefaults(){this.variant=void 0,this.uri="https://cdn.jsdelivr.net/npm/@alaskaairux/icons@latest/dist",this.runtimeUtils=new p;}static get properties(){return {...y.properties,ariaHidden:{type:String,reflect:true},category:{type:String,reflect:true},customColor:{type:Boolean,reflect:true},customSvg:{type:Boolean},label:{type:Boolean,reflect:true},name:{type:String,reflect:true},variant:{type:String,reflect:true}}}static get styles(){return [y.styles,M,z,_]}static register(t="auro-icon"){p.prototype.registerComponent(t,k);}connectedCallback(){super.connectedCallback(),this.runtimeUtils.handleComponentTagRename(this,"auro-icon");}exposeCssParts(){this.setAttribute("exportparts","svg:iconSvg");}async firstUpdated(){if(await super.firstUpdated(),this.hasAttribute("ariaHidden")&&this.svg){const t=this.svg.querySelector("desc");t&&(t.remove(),this.svg.removeAttribute("aria-labelledby"));}}render(){const t={labelWrapper:true,util_displayHiddenVisually:!this.label};return b`
-      <div class="componentWrapper">
-        <div
-          class="${e({svgWrapper:true})}"
-          title="${o(this.title||void 0)}">
-          <span aria-hidden="${o(this.ariaHidden||true)}" part="svg">
-            ${this.customSvg?b`
-                <slot name="svg"></slot>
-              `:b`
-                ${this.svg}
-              `}
-          </span>
-        </div>
-
-        <div class="${e(t)}" part="label">
-          <slot></slot>
-        </div>
-      </div>
-    `}}
+  /**
+   * Highlights the previous active option in the menu.
+   */
+  highlightPrevious() {
+    this.moveHighlightedOption("previous");
+  }
 
-var iconVersion = '9.1.2';
+  /**
+   * Moves the highlighted option in the specified direction.
+   * @param {string} direction - The direction to move the highlight ("next" or "previous").
+   */
+  moveHighlightedOption(direction) {
 
-var checkmarkIcon = {"svg":"<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" aria-labelledby=\"checkmark-sm__desc\" class=\"ico_squareLarge\" role=\"img\" style=\"min-width:var(--auro-size-lg, var(--ds-size-300, 1.5rem));height:var(--auro-size-lg, var(--ds-size-300, 1.5rem));fill:currentColor\" viewBox=\"0 0 24 24\" part=\"svg\"><title/><desc id=\"checkmark-sm__desc\">a small check mark.</desc><path d=\"M8.461 11.84a.625.625 0 1 0-.922.844l2.504 2.738c.247.27.674.27.922 0l5.496-6a.625.625 0 1 0-.922-.844l-5.035 5.496z\"/></svg>"};
+    // Get the active options
+    const activeOptions = this._menuOptions.filter(option => option.isActive);
 
-// Copyright (c) 2021 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
-// See LICENSE in the project root for license information.
+    // Get the currently active option
+    const currentActiveOption = activeOptions[activeOptions.indexOf(this.highlightedOption)];
 
+    // Determine the new index based on the currently active option and direction
+    let newIndex = currentActiveOption
+      ? direction === "previous"
+        ? activeOptions.indexOf(currentActiveOption) - 1
+        : activeOptions.indexOf(currentActiveOption) + 1
+      : direction === "previous"
+        ? activeOptions.length - 1
+        : 0;
 
-/**
- * Helper method to dispatch custom events.
- * @param {HTMLElement} element - Element to dispatch event from.
- * @param {string} eventName - Name of the event to dispatch.
- * @param {Object} [detail] - Optional detail object to include with the event.
- */
-function dispatchMenuEvent(element, eventName, detail = null) {
-  const eventConfig = {
-    bubbles: true,
-    cancelable: false,
-    composed: true
-  };
+    // Wrap around the index if needed
+    newIndex = newIndex < 0 ? activeOptions.length - 1 : newIndex >= activeOptions.length ? 0 : newIndex;
 
-  if (detail !== null) {
-    eventConfig.detail = detail;
+    // Get the new active option and set it as highlighted
+    const newActiveOption = activeOptions[newIndex];
+    this.setHighlightedOption(newActiveOption);
   }
 
-  element.dispatchEvent(new CustomEvent(eventName, eventConfig));
-}
+  /**
+   * Sets the highlighted index to the specified option.
+   * @param {AuroMenuOption} option - The option to highlight.
+   */
+  setHighlightedOption(option) {
 
-// Copyright (c) 2021 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
-// See LICENSE in the project root for license information.
+    if (!option) return;
 
+    // Get the index of the option to highlight
+    const index = this._menuOptions.indexOf(option);
 
-let menuOptionIdCounter = 0;
+    // Update highlighted index
+    this.highlightedIndex = index;
 
-/**
- * The `auro-menuoption` element provides users a way to define a menu option.
- * @customElement auro-menuoption
- *
- * @slot default - The default slot for the menu option text.
- *
- * @event auroMenuOption-mouseover - Notifies that this option has been hovered over.
- */
-class AuroMenuOption extends AuroElement {
+    // Notify subscribers of highlight change
+    this.notify({ type: 'highlightChange', option, index: this.highlightedIndex });
+
+    // Dispatch the change event
+    this.dispatchChangeEvent('auroMenu-activatedOption', option);
+  }
 
   /**
-   * This will register this element with the browser.
-   * @param {string} [name="auro-menuoption"] - The name of the element that you want to register.
-   *
-   * @example
-   * AuroMenuOption.register("custom-menuoption") // this will register this element to <custom-menuoption/>
-   *
+   * Sets the highlighted option to the option at the specified index if it exists.
+   * @param {number} index
    */
-  static register(name = "auro-menuoption") {
-    AuroLibraryRuntimeUtils.prototype.registerComponent(name, AuroMenuOption);
+  setHighlightedIndex(index) {
+    const option = this._menuOptions[index] || null;
+    this.setHighlightedOption(option);
   }
 
   /**
-   * Returns whether the menu option is currently active and selectable.
-   * An option is considered active if it is not hidden, not disabled, and not static.
-   * @returns {boolean} True if the option is active, false otherwise.
+   * Selects the currently highlighted option.
    */
-  get isActive() {
-    return !this.hasAttribute('hidden') &&
-      !this.disabled &&
-      !this.hasAttribute('static');
+  selectHighlightedOption() {
+    if (this.highlightedOption) {
+      this.toggleOption(this.highlightedOption);
+    }
   }
 
-  constructor() {
-    super();
+  /**
+   * SELECTION AND DESELECTION METHODS
+   */
 
-    this.bindEvents();
+  /**
+   * Selects one or more options in a batch operation
+   * @param {AuroMenuOption|AuroMenuOption[]} options - Single option or array of options to select
+   */
+  selectOptions(options) {
+    let optionsToSelect = Array.isArray(options) ? options : [options];
 
-    /**
-     * @private
-     */
-    this.shape = undefined;
+    // Filter out options that are inactive
+    optionsToSelect = optionsToSelect.filter(option => option.isActive);
 
-    /**
-     * @private
-     */
-    this.size = undefined;
+    if (!optionsToSelect.length) return;
 
-    /**
-     * Generate unique names for dependency components.
-     */
-    const versioning = new AuroDependencyVersioning();
-    this.iconTag = versioning.generateTag('auro-formkit-menuoption-icon', iconVersion, k);
+    if (this.multiSelect) {
+      this.selectedOptions = [...(this.selectedOptions || []), ...optionsToSelect];
+    } else {
+      // In single select mode, only take the last option
+      this.selectedOptions = [optionsToSelect[optionsToSelect.length - 1]];
+    }
 
-    this.selected = false;
-    this.noCheckmark = false;
-    this.disabled = false;
-    this.noMatch = false;
+    this.stageUpdate();
+  }
 
-    /**
-     * @private
-     */
-    this.runtimeUtils = new AuroLibraryRuntimeUtils();
+  /**
+   * Deselects one or more options in a batch operation
+   * @param {AuroMenuOption|AuroMenuOption[]} options - Single option or array of options to deselect
+   */
+  deselectOptions(options) {
+    const optionsToDeselect = Array.isArray(options) ? options : [options];
 
-    // Initialize context-related properties
-    this.menuService = null;
-    this.unsubscribe = null;
+    if (!optionsToDeselect.length) return;
 
-    /**
-     * @private
-     */
-    this.handleMenuChange = this.handleMenuChange.bind(this);
-  }
+    // Check if deselection should be prevented
+    const shouldPreventDeselect = !this.allowDeselect && !this.multiSelect;
+    const isOnlySelectedOption = this.selectedOptions.length === 1 && optionsToDeselect.includes(this.selectedOptions[0]);
 
-  static get properties() {
-    return {
-      ...super.properties,
+    // Prevent deselecting the only selected option if not allowed
+    if (shouldPreventDeselect && isOnlySelectedOption) {
+      optionsToDeselect.forEach(option => {
+        option.selected = true;
+      });
+      this.dispatchChangeEvent('auroMenu-deselectPrevented', {
+        values: optionsToDeselect
+      });
+      return;
+    }
 
-      /**
-       * When true, disables the menu option.
-       */
-      disabled: {
-        type: Boolean,
-        reflect: true
-      },
+    const optionsSet = new Set(optionsToDeselect);
+    const previousCount = this.selectedOptions.length;
+    this.selectedOptions = (this.selectedOptions || [])
+      .filter(opt => !optionsSet.has(opt));
 
-      /**
-       * @private
-       */
-      event: {
-        type: String,
-        reflect: true
-      },
+    if (this.selectedOptions.length < previousCount) {
+      this.stageUpdate();
+    }
+  }
 
-      /**
-       * @private
-       */
-      layout: {
-        type: String
-      },
+  /**
+   * Selects a single option.
+   * @param {AuroMenuOption} option
+   */
+  selectOption(option) {
+    this.selectOptions(option);
+  }
 
-      /**
-       * Allows users to set a unique key for the menu option for specified option selection. If no key is provided, the value property will be used.
-       */
-      key: {
-        type: String,
-        reflect: true
-      },
+  /**
+   * Deselects a single option.
+   * @param {AuroMenuOption} option
+   */
+  deselectOption(option) {
+    this.deselectOptions(option);
+  }
 
-      /**
-       * @private
-       */
-      menuService: {
-        type: Object,
-        state: true
-      },
-
-      /**
-       * @private
-       */
-      matchWord: {
-        type: String,
-        state: true
-      },
-
-      /**
-       * @private
-       */
-      noCheckmark: {
-        type: Boolean,
-        reflect: true
-      },
-
-      /**
-       * When true, marks this option as the "no matching results" placeholder shown by combobox when the user's input does not match any available options. Enables distinct styling and prevents the option from being treated as a selectable match.
-       */
-      noMatch: {
-        type: Boolean,
-        reflect: true,
-        attribute: 'nomatch'
-      },
-
-      /**
-       * Specifies that an option is selected.
-       */
-      selected: {
-        type: Boolean,
-        reflect: true
-      },
-
-      /**
-       * Specifies the tab index of the menu option.
-       */
-      tabIndex: {
-        type: Number,
-        reflect: true
-      },
-
-      /**
-       * Specifies the value to be sent to a server.
-       */
-      value: {
-        type: String,
-        reflect: true
-      },
-    };
+  /**
+   * Toggles the selection state of a single option.
+   * @param {AuroMenuOption} option
+   */
+  toggleOption(option) {
+    if (option.selected) {
+      this.deselectOption(option);
+    } else {
+      this.selectOption(option);
+    }
   }
 
-  static get styles() {
-    return [
-      styleCss,
-      colorCss,
-      tokensCss
-    ];
-  }
+  /**
+   * Selects options based on their value(s) when compared to a passed value or values.
+   * Value or values are normalized to an array of strings that can be matched to option keys.
+   * @param {string|number|Array<string|number>} value - The value(s) to select.
+   */
+  selectByValue(value) {
+    const isEmptyValue = value === undefined ||
+        value === null ||
+        (Array.isArray(value) && value.length === 0) ||
+        (typeof value === 'string' && value.trim() === '');
 
-  connectedCallback() {
-    super.connectedCallback();
+    // Early exit for invalid/empty values
+    if (isEmptyValue) {
+      this.selectedOptions.forEach(opt => opt.selected = false);
+      this.selectedOptions = [];
+      return;
+    }
 
-    // Add the tag name as an attribute if it is different than the component name
-    // Add this step soon as this node gets attached to the DOM to avoid racing condition with menu's value setting logic.
-    this.runtimeUtils.handleComponentTagRename(this, 'auro-menuoption');
+    // If an internal update cycle is still in progress, defer value application
+    // rather than dropping it.
+    if (this.internalUpdateInProgress || this.host.internalUpdateInProgress) {
+      this.queuePendingValue(value);
+      return;
+    }
 
-    // Set up context consumption in connectedCallback
-    this._contextConsumer = new s$2(this, {
-      context: MenuContext,
-      callback: this.attachTo.bind(this),
-      subscribe: true
-    });
+    // Normalize values to array of strings
+    const normalizedValues = this._getNormalizedValues(value);
 
-    // Establish the key property as early as possible.
-    // When a framework (e.g. Svelte) inserts the element into the DOM before
-    // setting its `value` property, both `getAttribute('value')` and
-    // `getAttribute('key')` return null here. Setting `this.key = null`
-    // would block the fallback in `updated()` that assigns key from the
-    // value property (the guard checked `=== undefined`). Only assign key
-    // if at least one source attribute is actually present so that the
-    // `updated()` fallback can run when the value property arrives later.
-    const valueAttr = this.getAttribute('value');
-    const keyAttr = this.getAttribute('key');
-    const resolvedKey = keyAttr !== null ? keyAttr : valueAttr;
-    if (resolvedKey !== null) {
-      this.key = resolvedKey;
+    // Validate for single-select mode
+    let validatedValues = normalizedValues;
+    if (normalizedValues.length > 1 && !this.multiSelect) {
+      console.warn("MenuService - Multiple values provided for single-select menu. Only the first value will be selected.");
+      validatedValues = [normalizedValues[0]];
     }
-  }
-
-  firstUpdated() {
-    // Add the tag name as an attribute if it is different than the component name
-    this.runtimeUtils.handleComponentTagRename(this, 'auro-menuoption');
 
-    // Generate unique ID if not already set (required for aria-activedescendant)
-    if (!this.id) {
-      menuOptionIdCounter += 1;
-      this.id = `menuoption-${menuOptionIdCounter}`;
+    if (this._menuOptions.length === 0) {
+      this.queuePendingValue(value);
+      return;
     }
 
-    this.setAttribute('role', 'option');
-    this.setAttribute('aria-selected', 'false');
+    // Find matching options by comparing available options to validated values
+    const trackedKeys = new Set();
+    const optionsToSelect = this._menuOptions.filter(option => {
+      const passesFilter = validatedValues.includes(option.key);
+      const alreadyTracked = trackedKeys.has(option.key);
+      const isActive = option.isActive;
 
-    this.addEventListener('mouseover', () => {
-      this.dispatchEvent(new CustomEvent('auroMenuOption-mouseover', {
-        bubbles: true,
-        cancelable: false,
-        composed: true,
-        detail: this
-      }));
+      trackedKeys.add(option.key);
+
+      // Include the option in the options to be selected if it passes the filter check and
+      // either hasn't been tracked yet or selectAllMatchingOptions is true
+      return isActive && passesFilter && (!alreadyTracked || (alreadyTracked && this.selectAllMatchingOptions));
     });
-  }
 
-  updated(changedProperties) {
-    super.updated(changedProperties);
+    // Handle no matches: clear existing selection, but do not dispatch an intermediate
+    // undefined value that can overwrite the host value in parent components.
+    if (!optionsToSelect.length) {
+      const hasUnresolvedKeys = this._menuOptions.some((option) => option.isActive && option.key == null);
 
-    // Update aria-selected attribute if selected changed
-    if (changedProperties.has('selected')) {
+      if (hasUnresolvedKeys) {
+        this.queuePendingValue(value);
+        return;
+      }
 
-      // Update aria-selected attribute
-      this.setAttribute('aria-selected', this.selected.toString());
+      this.clearPendingValue();
 
-      // Update menu service selection state if this isn't an internal update
-      if (this.internalUpdateInProgress !== true && this.menuService) {
-        this.menuService[this.selected ? 'selectOption' : 'deselectOption'](this);
+      if (this.selectedOptions.length > 0) {
+        this.selectedOptions = [];
       }
-    }
 
-    if (changedProperties.has('disabled')) {
-      if (this.disabled) {
-        this.setAttribute('aria-disabled', 'true');
-      } else {
-        this.removeAttribute('aria-disabled');
+      // Always notify so the host resets any stale invalid value, even when
+      // selectedOptions was already empty (e.g. double-clicking set-invalid).
+      this.stageUpdate({ reason: 'no-match' });
+
+      // Dispatch failure event if no matches found
+      if (validatedValues.length) {
+        this.dispatchChangeEvent('auroMenu-selectValueFailure', {
+          message: 'No matching options found for the provided value(s).',
+          values: validatedValues
+        });
       }
-    }
 
-    if (changedProperties.has('active')) {
-      this.updateActiveClasses();
+      return;
     }
 
-    // Update text highlight if matchWord changed
-    if (changedProperties.has('matchWord')) {
-      this.updateTextHighlight();
-    }
+    this.clearPendingValue();
 
-    // Set the key to be the passed value if no key is provided.
-    // Loose equality (== null) is intentional: it catches both null AND
-    // undefined. When a framework (e.g. Svelte, React) inserts the element
-    // before setting its value property, connectedCallback skips key
-    // assignment because both attributes are null at that point. The Lit
-    // property default for `key` is undefined (not null), so strict
-    // === null would miss the case and the fallback would never run.
-    if (changedProperties.has('value') && this.key == null) { // eslint-disable-line eqeqeq, no-eq-null
-      this.key = this.value;
+    if (this.optionsArraysMatch(optionsToSelect, this.selectedOptions)) {
+      return;
     }
-  }
 
-  disconnectedCallback() {
-    if (this.menuService) {
-      this.menuService.unsubscribe(this.handleMenuChange);
-      this.menuService.removeMenuOption(this);
-    }
+    // Apply programmatic selection as a single transaction and emit one final state.
+    this.selectedOptions = optionsToSelect;
+    this.stageUpdate();
   }
 
   /**
-   * Sets up event listeners for user interaction with the menu option.
-   * This function enables click and mouse enter events to trigger selection and highlighting logic.
+   * Queues a pending value and schedules a bounded retry.
+   * @param {string|number|Array<string|number>} value - The value to retry.
    */
-  bindEvents() {
-    this.addEventListener('click', this.handleClick.bind(this));
-    this.addEventListener('mouseenter', this.handleMouseEnter.bind(this));
-  }
+  queuePendingValue(value) {
+    this._pendingValue = value;
 
-  /**
-   * Attaches this menu option to a menu service and subscribes to its events.
-   * This method enables the option to participate in menu selection and highlighting logic.
-   * @param {Object} service - The menu service instance to attach to.
-   */
-  attachTo(service) {
-    if (!service) {
+    if (this._pendingRetryScheduled || this._pendingRetryCount >= 5) {
       return;
     }
-    this.menuService = service;
-    this.menuService.addMenuOption(this);
-    this.menuService.subscribe(this.handleMenuChange);
+
+    this._pendingRetryScheduled = true;
+    this._pendingRetryCount += 1;
+
+    setTimeout(() => {
+      this._pendingRetryScheduled = false;
+
+      if (this._pendingValue == null) {
+        return;
+      }
+
+      const pendingValue = this._pendingValue;
+      this.selectByValue(pendingValue);
+    }, 0);
   }
 
   /**
-   * Handles changes from the menu service and updates the option's state.
-   * This function synchronizes the option's properties and selection/highlight state with menu events.
-   * @param {Object} event - The event object from the menu service.
+   * Clears pending retry state.
    */
-  handleMenuChange(event) {
-
-    // Ignore events without a type or property
-    if (!event || (!event.type && !event.property)) {
-      return;
-    }
-
-    // Update reactive properties based on event type
-    if (event.property && Object.keys(AuroMenuOption.properties).includes(event.property)) {
-      this[event.property] = event.value;
-    }
-
-    // Handle highlight changes
-    if (event.type === 'highlightChange') {
-      const isActive = event.option === this;
-      this.active = isActive;
-      this.updateActiveClasses();
-    }
-
-    if (event.type === 'stateChange') {
-      const isSelected = event.selectedOptions.includes(this);
-      this.setInternalSelected(isSelected);
-    }
+  clearPendingValue() {
+    this._pendingValue = null;
+    this._pendingRetryScheduled = false;
+    this._pendingRetryCount = 0;
   }
 
   /**
-   * Updates the internal selected state of the menu option bypassing 'updated' and triggers custom events if selected.
-   * This function ensures the option's selection state is synchronized with menu logic and notifies listeners.
-   * @param {boolean} isSelected - Whether the option should be marked as selected.
+   * Resets the selected options to an empty array.
    */
-  setInternalSelected(isSelected) {
-    this.internalUpdateInProgress = true;
-    this.selected = isSelected;
+  reset() {
+    const previousOptions = [...this.selectedOptions];
+    previousOptions.forEach(opt => opt.selected = false);
+    this.selectedOptions = [];
 
-    // Fire custom event if selected
-    if (isSelected) {
-      this.handleCustomEvent();
+    // Single update after clearing all
+    if (previousOptions.length) {
+      this.stageUpdate();
     }
-
-    setTimeout(() => {
-      this.internalUpdateInProgress = false;
-    }, 0);
   }
 
   /**
-   * Sets the selected state of the menu option.
-   * This function updates whether the option is currently selected.
-   * @param {boolean} isSelected - Whether the option should be marked as selected.
-   * @deprecated Simply modify the `selected` property directly instead.
+   * SUBSCRIPTION, NOTIFICATION AND EVENT DISPATCH METHODS
    */
-  setSelected(isSelected) {
-    this.selected = isSelected;
-  }
 
   /**
-   * Updates the active state and visual highlighting of the menu option.
-   * This function toggles the option's active status and applies or removes the active CSS class.
-   * @param {boolean} isActive - Whether the option should be marked as active.
-   * @deprecated Simply modify the `active` property directly instead.
+   * Subscribes a callback to menu service events.
+   * @param {Function} callback - The callback to invoke on events.
    */
-  updateActive(isActive) {
-
-    // Set active state
-    this.active = isActive;
-    this.updateActiveClasses();
+  subscribe(callback) {
+    this._subscribers.push(callback);
   }
 
   /**
-   * Updates the CSS class for the menu option based on its active state.
-   * This function adds or removes the 'active' class to visually indicate the option's active status.
-   * @private
+   * Remove a previously subscribed callback from menu service events.
+   * @param {Function} callback
    */
-  updateActiveClasses() {
-    // Update class based on active state
-    if (this.active) this.classList.add('active');
-    else this.classList.remove('active');
+  unsubscribe(callback) {
+    this._subscribers = this._subscribers.filter(cb => cb !== callback);
   }
 
-
   /**
-   * Updates the visual highlighting of text within the menu option based on the current match word.
-   * This function highlights matching text segments and manages nested spacers for display formatting.
-   * @private
+   * Stages an update to notify subscribers of state and value changes.
    */
-  updateTextHighlight() {
-
-    // Regex for matchWord if needed
-    let regexWord = null;
-
-    if (this.matchWord && this.matchWord.length) {
-      const escapedWord = this.matchWord.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
-      regexWord = new RegExp(escapedWord, 'giu');
-    }
-
-    // Update text highlighting if matchWord changed
-    if (regexWord &&
-      this.isActive && !this.hasAttribute('persistent')) {
-      const nested = this.querySelectorAll('.nestingSpacer');
-
-      const displayValueEl = this.querySelector('[slot="displayValue"]');
-      if (displayValueEl) {
-        this.removeChild(displayValueEl);
-      }
-
-      // Create nested spacers
-      const nestingSpacerBundle = [...nested].map(() => this.nestingSpacer).join('');
-
-      // Update with spacers and matchWord
-      this.innerHTML = nestingSpacerBundle +
-        this.textContent.replace(
-          regexWord,
-          (match) => `<strong>${match}</strong>`
-        );
-      if (displayValueEl) {
-        this.append(displayValueEl);
-      }
-    }
+  stageUpdate(meta = {}) {
+    this.notifyStateChange(meta);
+    this.notifyValueChange(meta);
   }
 
   /**
-   * Handles click events on the menu option, toggling its selected state.
-   * This function dispatches a click event and updates selection if the option is not disabled.
-   * @private
+   * Notifies subscribers of a menu service event.
+   * All notifications are sent to all subscribers.
+   * @param {string} event - The event to send to subscribers.
    */
-  handleClick() {
-    if (!this.disabled) {
-      this.dispatchClickEvent();
-      this.selected = !this.selected;
-    }
+  notify(event) {
+    this._subscribers.forEach(callback => callback(event));
   }
 
   /**
-   * Handles mouse enter events to highlight the menu option.
-   * This function updates the menu service to set this option as the currently highlighted item if not disabled.
-   * @private
+   * Notifies subscribers of a state change (selected options has changed).
    */
-  handleMouseEnter() {
-    if (!this.disabled) {
-      this.menuService.setHighlightedOption(this);
-    }
+  notifyStateChange(meta = {}) {
+    this.notify({
+      type: 'stateChange',
+      selectedOptions: this.selectedOptions,
+      ...meta
+    });
   }
 
   /**
-   * Dispatches custom events defined for this menu option.
-   * This function notifies listeners when a custom event is triggered by the option.
-   * @private
+   * Notifies subscribers of a value change (current value has changed).
    */
-  handleCustomEvent() {
-    if (this.event) {
-      dispatchMenuEvent(this, this.event, { option: this });
-      dispatchMenuEvent(this, 'auroMenu-customEventFired', { option: this });
-    }
+  notifyValueChange(meta = {}) {
+
+    // Prepare details for the event
+    const details = {
+      value: this.currentValue,
+      stringValue: this.stringValue,
+      keys: this.currentKeys,
+      options: this.selectedOptions,
+      label: this.currentLabel
+    };
+
+    // If only one option is selected, include its index
+    if (this.selectedOptions.length === 1) details.index = this._menuOptions.indexOf(this.selectedOptions[0]);
+
+    this.notify({
+      type: 'valueChange',
+      ...meta,
+      ...details
+    });
   }
 
   /**
-   * Dispatches a click event for this menu option.
-   * This function notifies listeners that the option has been clicked.
-   * @private
+   * Dispatches a custom event from the host element.
+   * @param {string} eventName
+   * @param {any} detail
    */
-  dispatchClickEvent() {
-    this.dispatchEvent(new CustomEvent('auroMenuOption-click', {
+  dispatchChangeEvent(eventName, detail) {
+    this.host.dispatchEvent(new CustomEvent(eventName, {
       bubbles: true,
       cancelable: false,
       composed: true,
-      detail: this
+      detail
     }));
   }
 
   /**
-   * Generates an HTML element containing an SVG icon based on the provided `svgContent`.
-   *
-   * @private
-   * @param {string} svgContent - The SVG content to be embedded.
-   * @returns {Element} The HTML element containing the SVG icon.
+   * MENU OPTION MANAGEMENT METHODS
    */
-  generateIconHtml(svgContent) {
-    const dom = new DOMParser().parseFromString(svgContent, 'text/html');
-    const svg = dom.body.firstChild;
 
-    svg.setAttribute('slot', 'svg');
+  /**
+   * Adds a menu option to the service's list.
+   * @param {AuroMenuOption} option - the option to track
+   */
+  addMenuOption(option) {
+    this._menuOptions.push(option);
+    this.notify({ type: 'optionsChange', options: this._menuOptions });
 
-    return u$1`<${this.iconTag} customColor customSvg>${svg}</${this.iconTag}>`;
+    if (this._pendingValue != null) {
+      this.queuePendingValue(this._pendingValue);
+    }
   }
 
   /**
-   * Logic to determine the layout of the component.
-   * @protected
-   * @returns {void}
+   * Removes a menu option from the service's list.
+   * @param {AuroMenuOption} option - the option to remove
    */
-  renderLayout() {
-
-    const fontClassMap = {
-      xs: 'body-sm',
-      sm: 'body-default',
-      md: 'body-default',
-      lg: 'body-lg',
-      xl: 'body-lg'
-    };
-
-    const classes = e({
-      'wrapper': true,
-      [this.size ? fontClassMap[this.size] : 'body-sm']: true,
-    });
+  removeMenuOption(option) {
+    this._menuOptions = this._menuOptions.filter(opt => opt !== option);
+    this.notify({ type: 'optionsChange', options: this._menuOptions });
 
-    return u$1`
-      <div class="${classes}">
-        ${this.selected && !this.noCheckmark
-        ? this.generateIconHtml(checkmarkIcon.svg)
-        : undefined}
-        <slot></slot>
-      </div>
-    `;
+    if (this._menuOptions.length === 0) {
+      this.clearPendingValue();
+    }
   }
-}
-
-/* eslint-disable */
-
-class MenuService {
 
   /**
-   * PROPERTIES AND GETTERS
+   * UTILITIES
    */
 
   /**
-   * Gets the list of registered menu options.
-   * @returns {AuroMenuOption[]}
-   */
-  get menuOptions() {
-    return this._menuOptions;
-  }
-
-  /**
-   * Gets the currently highlighted option.
-   * @returns {AuroMenuOption|null}
+   * Normalizes a value or array of values into an array of strings for option selection.
+   * This function ensures that input values are consistently formatted for matching menu options.
+   *
+   * @param {string|number|Array<string|number>} value - The value(s) to normalize.
+   * @returns {Array<string>} An array of string values suitable for option matching.
+   * @throws {Error} If any value is not a string or number.
    */
-  get highlightedOption() {
-    return this._menuOptions[this.highlightedIndex] || null;
-  }
+  _getNormalizedValues(value) {
+    let values = value;
 
-  /**
-   * Gets the current value(s) of the selected option(s).
-   * @returns {string|string[]|undefined}
-   */
-  get currentValue() {
-    const values = (this.selectedOptions || []).map(option => option.value);
-    return this.multiSelect ? values : values[0];
-  }
+    // Handle JSON string and single value string input
+    if (!Array.isArray(values) && typeof values === 'string') {
 
-  /**
-   * Gets the label(s) of the currently selected option(s).
-   * @returns {string}
-   */
-  get currentLabel() {
-    const labels = (this.selectedOptions || []).map(option => option.textContent);
-    return this.multiSelect ? labels.join(", ") : labels[0] || '';
-  }
+      // Attempt to parse as JSON array
+      try {
 
-  /**
-   * Gets the string representation of the current value(s).
-   * For multi-select, this is a JSON stringified array.
-   * @returns {string|undefined}
-   */
-  get stringValue() {
-    const { currentValue } = this;
+        // Normalize single quotes to double quotes for JSON parsing
+        // This will not handle complex cases but will cover basic usage
+        const parseValue = values.replace(/'([^']*?)'/g, '"$1"');
 
-    if (Array.isArray(currentValue)) {
-      if (currentValue.length > 0) {
-        return JSON.stringify(currentValue);
+        // Attempt parse
+        const parsed = JSON.parse(parseValue);
+
+        // Ensure parsed value is an array
+        if (!Array.isArray(parsed)) throw new Error('Not an array');
+
+        // Set values to parsed array
+        values = parsed;
+      } catch (err) {
+
+        // If parsing fails, treat as single value
+        values = [value];
       }
-      return undefined;
     }
 
-    if (typeof currentValue === 'string') {
-      if (currentValue.length > 0) {
-        return currentValue;
-      }
-      return undefined;
+    // Handle a single number being passed
+    if (typeof values === 'number') {
+      values = [String(values)];
     }
 
-    // Future: handle other types here (e.g., number, object, etc.)
-    return undefined;
-  }
+    // Coerce each value to string and validate types
+    values.forEach((val, index) => {
 
-  /**
-   * Gets the key(s) of the currently selected option(s).
-   * @returns {string|string[]|undefined}
-   */
-  get currentKeys() {
-    const keys = (this.selectedOptions || []).map(option => option.key);
-    return this.multiSelect ? keys : keys[0];
+      // Throw an error for invalid value types
+      if (typeof val !== 'string' && typeof val !== 'number') {
+        throw new Error('Value contains invalid value type. Supported types are string and number.');
+      }
+
+      // Convert numbers to strings for consistency
+      if (typeof val === 'number') {
+        values[index] = String(val);
+      }
+    });
+
+    // Return the resulting array of string values
+    return values;
   }
 
   /**
-   * CONSTRUCTOR
+   * Returns whether two arrays of options contain the same elements.
+   * @param {AuroMenuOption[]} arr1 - First array of options.
+   * @param {AuroMenuOption[]} arr2 - Second array of options.
+   * @returns {boolean} True if arrays match, false otherwise.
    */
+  optionsArraysMatch(arr1, arr2) {
+    if (arr1.length !== arr2.length) return false;
 
-  /**
-   * Creates a new MenuService instance.
-   * @param {Object} options - The options object.
-   *   @param {AuroMenu} options.host - The host element that this service will control. Required.
-   * @throws {Error} If the host is not provided.
-   */
-  constructor({ host } = {}) {
+    const set1 = new Set(arr1);
+    const set2 = new Set(arr2);
 
-    // Ensure a host was passed
-    if (!host) {
-      throw new Error("MenuService requires a host element.");
+    for (let item of set1) {
+      if (!set2.has(item)) {
+        return false;
+      }
     }
 
-    // Attach the service to the host
-    this.host = host;
-    this.host.addController(this);
+    return true;
+  }
+}
 
-    // Set default properties
-    this.size = undefined;
-    this.shape = undefined;
-    this.noCheckmark = undefined;
-    this.disabled = undefined;
-    this.matchWord = undefined;
-    this.multiSelect = undefined;
-    this.allowDeselect = undefined;
-    this.selectAllMatchingOptions = undefined;
+const MenuContext = n$1('menu-context');
 
-    this.highlightedIndex = -1;
+// Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
+// See LICENSE in the project root for license information.
 
-    this._menuOptions = [];
-    this._subscribers = [];
-    this.internalUpdateInProgress = false;
-    this.selectedOptions = [];
-    this._pendingValue = null;
-    this._pendingRetryScheduled = false;
-    this._pendingRetryCount = 0;
-  }
+// ---------------------------------------------------------------------
 
-  /**
-   * PROPERTY SYNCING
-   */
+/* eslint-disable line-comment-position, no-inline-comments, no-confusing-arrow, no-nested-ternary, implicit-arrow-linebreak */
+
+class AuroLibraryRuntimeUtils {
+
+  /* eslint-disable jsdoc/require-param */
 
   /**
-   * Handles host updates.
-   * This is a lit reactive lifecycle method.
-   * This comes from the Lit controller interface provided by adding this service as a controller to the host.
-   * See constructor for `this.host.addController(this)`
-   * You can read more about Lit reactive controllers here: https://lit.dev/docs/composition/controllers/
+   * This will register a new custom element with the browser.
+   * @param {String} name - The name of the custom element.
+   * @param {Object} componentClass - The class to register as a custom element.
+   * @returns {void}
    */
-  hostUpdated() {
-
-    // Reset selection if multiSelect mode changes
-    if (this.host.multiSelect !== this.multiSelect) {
-      this.selectedOptions = [];
+  registerComponent(name, componentClass) {
+    if (!customElements.get(name)) {
+      customElements.define(name, class extends componentClass {});
     }
-
-    // Update properties on host update
-    this.setProperties({
-      size: this.host.size,
-      shape: this.host.shape,
-      noCheckmark: this.host.noCheckmark,
-      disabled: this.host.disabled,
-      matchWord: this.host.matchWord,
-      multiSelect: this.host.multiSelect,
-      allowDeselect: this.host.allowDeselect,
-      selectAllMatchingOptions: this.host.selectAllMatchingOptions
-    });
   }
 
   /**
-   * Handles host disconnection and memory cleanup.
+   * Finds and returns the closest HTML Element based on a selector.
+   * @returns {void}
    */
-  hostDisconnected() {
-    this._subscribers = [];
-    this._menuOptions = [];
-    this._pendingValue = null;
-    this._pendingRetryScheduled = false;
-    this._pendingRetryCount = 0;
+  closestElement(
+    selector, // selector like in .closest()
+    base = this, // extra functionality to skip a parent
+    __Closest = (el, found = el && el.closest(selector)) =>
+      !el || el === document || el === window
+        ? null // standard .closest() returns null for non-found selectors also
+        : found
+          ? found // found a selector INside this element
+          : __Closest(el.getRootNode().host) // recursion!! break out to parent DOM
+  ) {
+    return __Closest(base);
   }
+  /* eslint-enable jsdoc/require-param */
 
   /**
-   * Sets a property value if it exists on the instance and the value has changed.
-   * @param {string} property
-   * @param {any} value
+   * If the element passed is registered with a different tag name than what is passed in, the tag name is added as an attribute to the element.
+   * @param {Object} elem - The element to check.
+   * @param {String} tagName - The name of the Auro component to check for or add as an attribute.
+   * @returns {void}
    */
-  setProperty(property, value) {
-
-    // Only update if we are tracking the property in this service
-    if (this.hasOwnProperty(property)) {
-
-      // Check if the value has changed
-      const valueChanged = this[property] !== value;
+  handleComponentTagRename(elem, tagName) {
+    const tag = tagName.toLowerCase();
+    const elemTag = elem.tagName.toLowerCase();
 
-      // Update and notify if changed
-      if (valueChanged) {
-        this[property] = value;
-        this.notify({ property, value });
-      }
+    if (elemTag !== tag) {
+      elem.setAttribute(tag, true);
     }
   }
 
   /**
-   * Sets multiple properties on the instance.
-   * @param {Object} properties - Key-value pairs of properties to set.
+   * Validates if an element is a specific Auro component.
+   * @param {Object} elem - The element to validate.
+   * @param {String} tagName - The name of the Auro component to check against.
+   * @returns {Boolean} - Returns true if the element is the specified Auro component.
    */
-  setProperties(properties) {
-    for (const [key, value] of Object.entries(properties)) {
-      this.setProperty(key, value);
-    }
+  elementMatch(elem, tagName) {
+    const tag = tagName.toLowerCase();
+    const elemTag = elem.tagName.toLowerCase();
+
+    return elemTag === tag || elem.hasAttribute(tag);
   }
 
   /**
-   * MENU OPTION HIGHLIGHTING
+   * Gets the text content of a named slot.
+   * @returns {String}
+   * @private
    */
+  getSlotText(elem, name) {
+    const slot = elem.shadowRoot?.querySelector(`slot[name="${name}"]`);
+    const nodes = slot?.assignedNodes({ flatten: true }) || [];
+    const text = nodes.map(n => n.textContent?.trim()).join(' ').trim();
 
-  /**
-   * Highlights the next active option in the menu.
-   */
-  highlightNext() {
-    this.moveHighlightedOption("next");
+    return text || null;
   }
+}
 
-  /**
-   * Highlights the previous active option in the menu.
-   */
-  highlightPrevious() {
-    this.moveHighlightedOption("previous");
+// Copyright (c) 2021 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
+// See LICENSE in the project root for license information.
+
+
+/**
+ * Helper method to dispatch custom events.
+ * @param {HTMLElement} element - Element to dispatch event from.
+ * @param {string} eventName - Name of the event to dispatch.
+ * @param {Object} [detail] - Optional detail object to include with the event.
+ */
+function dispatchMenuEvent(element, eventName, detail = null) {
+  const eventConfig = {
+    bubbles: true,
+    cancelable: false,
+    composed: true
+  };
+
+  if (detail !== null) {
+    eventConfig.detail = detail;
   }
 
-  /**
-   * Moves the highlighted option in the specified direction.
-   * @param {string} direction - The direction to move the highlight ("next" or "previous").
-   */
-  moveHighlightedOption(direction) {
+  element.dispatchEvent(new CustomEvent(eventName, eventConfig));
+}
 
-    // Get the active options
-    const activeOptions = this._menuOptions.filter(option => option.isActive);
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const t={ATTRIBUTE:1},e$1=t=>(...e)=>({_$litDirective$:t,values:e});let i$1 = class i{constructor(t){}get _$AU(){return this._$AM._$AU}_$AT(t,e,i){this._$Ct=t,this._$AM=e,this._$Ci=i;}_$AS(t,e){return this.update(t,e)}update(t,e){return this.render(...e)}};
 
-    // Get the currently active option
-    const currentActiveOption = activeOptions[activeOptions.indexOf(this.highlightedOption)];
+/**
+ * @license
+ * Copyright 2018 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */const e=e$1(class extends i$1{constructor(t$1){if(super(t$1),t$1.type!==t.ATTRIBUTE||"class"!==t$1.name||t$1.strings?.length>2)throw Error("`classMap()` can only be used in the `class` attribute and must be the only part in the attribute.")}render(t){return " "+Object.keys(t).filter(s=>t[s]).join(" ")+" "}update(s,[i]){if(void 0===this.st){this.st=new Set,void 0!==s.strings&&(this.nt=new Set(s.strings.join(" ").split(/\s/).filter(t=>""!==t)));for(const t in i)i[t]&&!this.nt?.has(t)&&this.st.add(t);return this.render(i)}const r=s.element.classList;for(const t of this.st)t in i||(r.remove(t),this.st.delete(t));for(const t in i){const s=!!i[t];s===this.st.has(t)||this.nt?.has(t)||(s?(r.add(t),this.st.add(t)):(r.remove(t),this.st.delete(t)));}return E}});
 
-    // Determine the new index based on the currently active option and direction
-    let newIndex = currentActiveOption
-      ? direction === "previous"
-        ? activeOptions.indexOf(currentActiveOption) - 1
-        : activeOptions.indexOf(currentActiveOption) + 1
-      : direction === "previous"
-        ? activeOptions.length - 1
-        : 0;
+/* eslint-disable no-underscore-dangle */
+// Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
+// See LICENSE in the project root for license information.
 
-    // Wrap around the index if needed
-    newIndex = newIndex < 0 ? activeOptions.length - 1 : newIndex >= activeOptions.length ? 0 : newIndex;
 
-    // Get the new active option and set it as highlighted
-    const newActiveOption = activeOptions[newIndex];
-    this.setHighlightedOption(newActiveOption);
+
+/**
+ * The `auro-menu` element provides users a way to select from a list of options.
+ * @customElement auro-menu
+ *
+ * @event {CustomEvent<Element>} auroMenu-activatedOption - Notifies that a menuoption has been made `active`.
+ * @event {CustomEvent<any>} auroMenu-customEventFired - Notifies that a custom event has been fired.
+ * @event {CustomEvent<{ loading: boolean; hasLoadingPlaceholder: boolean; }>} auroMenu-loadingChange - Notifies when the loading attribute is changed.
+ * @event {CustomEvent<any>} auroMenu-selectValueFailure - Notifies that an attempt to select a menuoption by matching a value has failed.
+ * @event {CustomEvent<{ values: HTMLElement[] }>} auroMenu-deselectPrevented - Notifies that deselection was prevented and includes the affected options in `detail.values`.
+ * @event {CustomEvent<any>} auroMenu-selectValueReset - Notifies that the component value has been reset.
+ * @event {CustomEvent<any>} auroMenu-selectedOption - Notifies that a new menuoption selection has been made.
+ * @slot loadingText - Text to show while loading attribute is set
+ * @slot loadingIcon - Icon to show while loading attribute is set
+ * @slot - Slot for insertion of menu options.
+ */
+
+/* eslint-disable max-lines */
+
+class AuroMenu extends AuroElement {
+
+  constructor() {
+    super();
+
+    // State properties (reactive)
+
+    /**
+     * @private
+     */
+    this.shape = "box";
+
+    /**
+     * @private
+     */
+    this.size = "sm";
+
+    // Currently selected option
+    this.optionSelected = undefined;
+    // String used for highlighting/filtering
+    this.matchWord = undefined;
+    // Hide the checkmark icon on selected options
+    this.noCheckmark = false;
+    // Currently active option
+    this.optionActive = undefined;
+    // Loading state
+    this.loading = false;
+    // Multi-select mode
+    this.multiSelect = false;
+    // Allow deselecting of menu options
+    this.allowDeselect = false;
+    // Select all matching options when setting value in multi-select mode
+    this.selectAllMatchingOptions = false;
+
+    // Event Bindings
+
+    /**
+     * @private
+     */
+    this.handleSlotChange = this.handleSlotChange.bind(this);
+
+    // Instance properties (non-reactive)
+
+    /**
+     * @private
+     */
+    Object.assign(this, {
+      // Root-level menu (true) or a nested submenu (false)
+      rootMenu: true,
+      // Currently focused/active menu item index
+      _index: -1,
+      // Nested menu spacer
+      nestingSpacer: '<span class="nestingSpacer"></span>',
+      // Loading indicator for slot elements
+      loadingSlots: null,
+    });
   }
 
-  /**
-   * Sets the highlighted index to the specified option.
-   * @param {AuroMenuOption} option - The option to highlight.
-   */
-  setHighlightedOption(option) {
+  static get properties() {
+    return {
+      ...super.properties,
 
-    if (!option) return;
+      /**
+       * Allows deselecting an already selected option when clicked again in single-select mode.
+       */
+      allowDeselect: {
+        type: Boolean,
+        reflect: true,
+      },
 
-    // Get the index of the option to highlight
-    const index = this._menuOptions.indexOf(option);
+      /**
+       * When true, the entire menu and all options are disabled.
+       */
+      disabled: {
+        type: Boolean,
+        reflect: true
+      },
 
-    // Update highlighted index
-    this.highlightedIndex = index;
+      /**
+       * Indicates whether the menu has a loadingIcon or loadingText to render when in a loading state.
+       */
+      hasLoadingPlaceholder: {
+        type: Boolean
+      },
 
-    // Notify subscribers of highlight change
-    this.notify({ type: 'highlightChange', option, index: this.highlightedIndex });
+      /**
+       * @private
+       */
+      layout: {
+        type: String
+      },
 
-    // Dispatch the change event
-    this.dispatchChangeEvent('auroMenu-activatedOption', option);
+      /**
+       * Indent level for submenus.
+       * @private
+       */
+      level: {
+        type: Number,
+        reflect: false,
+        attribute: false
+      },
+
+      /**
+       * When true, displays a loading state using the loadingIcon and loadingText slots if provided.
+       */
+      loading: {
+        type: Boolean,
+        reflect: true
+      },
+
+      /**
+       * Specifies a string used to highlight matched string parts in options.
+       */
+      matchWord: {
+        type: String,
+        attribute: 'matchword'
+      },
+
+      /**
+       * When true, the selected option can be multiple options.
+       */
+      multiSelect: {
+        type: Boolean,
+        reflect: true,
+        attribute: 'multiselect'
+      },
+
+      /**
+       * When true, selected option will not show the checkmark.
+       */
+      noCheckmark: {
+        type: Boolean,
+        reflect: true,
+        attribute: 'nocheckmark'
+      },
+
+      /**
+       * Specifies the current active menuOption.
+       */
+      optionActive: {
+        type: Object,
+        attribute: 'optionactive'
+      },
+
+      /**
+       * An array of currently selected menu options, type `HTMLElement` by default. In multi-select mode, `optionSelected` is an array of HTML elements.
+       */
+      optionSelected: {
+        // Allow HTMLElement, HTMLElement[] arrays and undefined
+        type: Object
+      },
+
+      /**
+       * Available menu options.
+       * @readonly
+       */
+      options: {
+        type: Array,
+        reflect: false,
+        attribute: false
+      },
+
+      /**
+       * Sets the size of the menu.
+       * @type {'sm' | 'md'}
+       * @default 'sm'
+       */
+      size: {
+        type: String,
+        reflect: true
+      },
+
+      /**
+       * When true, selects all options that match the provided value/key when setting value and multiselect is enabled.
+       */
+      selectAllMatchingOptions: {
+        type: Boolean,
+        reflect: true,
+      },
+
+      /**
+       * Sets the shape of the menu.
+       * @type {'box' | 'round'}
+       * @default 'box'
+       */
+      shape: {
+        type: String,
+        reflect: true
+      },
+
+      /**
+       * The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.
+       */
+      value: {
+        type: String,
+        reflect: true,
+        attribute: 'value'
+      }
+    };
+  }
+
+  static get styles() {
+    return [
+      styleCss$1,
+      colorCss$1,
+      tokensCss
+    ];
+  }
+
+  /**
+   * @readonly
+   * @returns {string} - Returns the label of the currently selected option(s).
+   */
+  get currentLabel() {
+    return this.menuService.currentLabel;
+  };
+
+  /**
+   * @readonly
+   * @returns {Array<HTMLElement>} - Returns the array of available menu options.
+   * @deprecated Use `options` property instead.
+   */
+  get items() {
+    return this.options;
+  }
+
+  /**
+   * @returns {number} - Returns the index of the currently active option.
+   */
+  get index() {
+    return this._index;
   }
 
   /**
-   * Sets the highlighted option to the option at the specified index if it exists.
-   * @param {number} index
+   * @param {number} value - Sets the index of the currently active option.
    */
-  setHighlightedIndex(index) {
-    const option = this._menuOptions[index] || null;
-    this.setHighlightedOption(option);
+  set index(value) {
+    this.menuService.setHighlightedIndex(value);
   }
 
   /**
-   * Selects the currently highlighted option.
+   * This will register this element with the browser.
+   * @param {string} [name="auro-menu"] - The name of the element that you want to register.
+   *
+   * @example
+   * AuroMenu.register("custom-menu") // this will register this element to <custom-menu/>
+   *
    */
-  selectHighlightedOption() {
-    if (this.highlightedOption) {
-      this.toggleOption(this.highlightedOption);
-    }
+  static register(name = "auro-menu") {
+    AuroLibraryRuntimeUtils.prototype.registerComponent(name, AuroMenu);
   }
 
   /**
-   * SELECTION AND DESELECTION METHODS
+   * Formatted value based on `multiSelect` state.
+   * Default type is `String`, changing to `Array<String>` when `multiSelect` is true.
+   * @private
+   * @returns {String|Array<String>}
    */
+  get formattedValue() {
+    return this.menuService.currentValue;
+  }
 
   /**
-   * Selects one or more options in a batch operation
-   * @param {AuroMenuOption|AuroMenuOption[]} options - Single option or array of options to select
+   * Gets the current property values for the menu service.
+   * @private
+   * @returns {Object}
    */
-  selectOptions(options) {
-    let optionsToSelect = Array.isArray(options) ? options : [options];
-
-    // Filter out options that are inactive
-    optionsToSelect = optionsToSelect.filter(option => option.isActive);
-
-    if (!optionsToSelect.length) return;
-
-    if (this.multiSelect) {
-      this.selectedOptions = [...(this.selectedOptions || []), ...optionsToSelect];
-    } else {
-      // In single select mode, only take the last option
-      this.selectedOptions = [optionsToSelect[optionsToSelect.length - 1]];
-    }
-
-    this.stageUpdate();
+  get propertyValues() {
+    return {
+      size: this.size,
+      shape: this.shape,
+      noCheckmark: this.nocheckmark,
+      disabled: this.disabled
+    };
   }
 
   /**
-   * Deselects one or more options in a batch operation
-   * @param {AuroMenuOption|AuroMenuOption[]} options - Single option or array of options to deselect
+   * Provides the menu context to child components.
+   * Initializes the MenuService and subscribes to menu changes.
+   * @protected
    */
-  deselectOptions(options) {
-    const optionsToDeselect = Array.isArray(options) ? options : [options];
-
-    if (!optionsToDeselect.length) return;
-
-    // Check if deselection should be prevented
-    const shouldPreventDeselect = !this.allowDeselect && !this.multiSelect;
-    const isOnlySelectedOption = this.selectedOptions.length === 1 && optionsToDeselect.includes(this.selectedOptions[0]);
-
-    // Prevent deselecting the only selected option if not allowed
-    if (shouldPreventDeselect && isOnlySelectedOption) {
-      optionsToDeselect.forEach(option => {
-        option.selected = true;
-      });
-      this.dispatchChangeEvent('auroMenu-deselectPrevented', {
-        values: optionsToDeselect
-      });
+  provideContext() {
+    if (this.parentElement && this.parentElement.closest('auro-menu, [auro-menu]')) {
+      this.rootMenu = false;
+      this.menuService = this.parentElement.menuService;
+      this._contextProvider = this.parentElement._contextProvider;
       return;
     }
 
-    const optionsSet = new Set(optionsToDeselect);
-    this.selectedOptions = (this.selectedOptions || [])
-      .filter(opt => !optionsSet.has(opt));
-
-    this.stageUpdate();
+    this.menuService = new MenuService({host: this});
+    this.menuService.setProperties(this.propertyValues);
+    this.menuService.subscribe(this.handleMenuChange.bind(this));
+    this._contextProvider = new i$2(this, {
+      context: MenuContext,
+      initialValue: this.menuService
+    });
   }
 
   /**
-   * Selects a single option.
-   * @param {AuroMenuOption} option
+   * Updates the currently active option in the menu.
+   * @param {HTMLElement} option - The option to set as active.
    */
-  selectOption(option) {
-    this.selectOptions(option);
+  updateActiveOption(option) {
+    this.menuService.setHighlightedOption(option);
   }
 
   /**
-   * Deselects a single option.
-   * @param {AuroMenuOption} option
+   * Sets the internal value and manages update state.
+   * @param {String|Array<String>} value - The value to set.
+   * @protected
    */
-  deselectOption(option) {
-    this.deselectOptions(option);
-  }
+  setInternalValue(value) {
+    if (this.value !== value) {
+      this.internalUpdateInProgress = true;
+      this.value = value;
 
-  /**
-   * Toggles the selection state of a single option.
-   * @param {AuroMenuOption} option
-   */
-  toggleOption(option) {
-    if (option.selected) {
-      this.deselectOption(option);
-    } else {
-      this.selectOption(option);
+      setTimeout(() => {
+        this.internalUpdateInProgress = false;
+      });
     }
   }
 
   /**
-   * Selects options based on their value(s) when compared to a passed value or values.
-   * Value or values are normalized to an array of strings that can be matched to option keys.
-   * @param {string|number|Array<string|number>} value - The value(s) to select.
+   * Handles changes from the menu service and updates component state.
+   * @param {Object} event - The event object from the menu service.
+   * @protected
    */
-  selectByValue(value) {
-    const isEmptyValue = value === undefined ||
-        value === null ||
-        (Array.isArray(value) && value.length === 0) ||
-        (typeof value === 'string' && value.trim() === '');
+  handleMenuChange(event) {
+    if (event.type === 'valueChange') {
 
-    // Early exit for invalid/empty values
-    if (isEmptyValue) {
-      this.selectedOptions.forEach(opt => opt.selected = false);
-      this.selectedOptions = [];
-      return;
-    }
+      // New option is array value or first option with fallback to undefined for empty array in all cases
+      const newOption = this.multiSelect && event.options.length ? event.options : event.options[0] || undefined;
+      const newValue = event.stringValue;
 
-    // If an internal update cycle is still in progress, defer value application
-    // rather than dropping it.
-    if (this.internalUpdateInProgress || this.host.internalUpdateInProgress) {
-      this.queuePendingValue(value);
-      return;
-    }
+      // Check if the option or value has actually changed
+      if (this.optionSelected !== newOption || this.stringValue !== newValue) {
+        this.optionSelected = newOption;
+        this.setInternalValue(newValue);
+      }
 
-    // Normalize values to array of strings
-    const normalizedValues = this._getNormalizedValues(value);
+      // Notify components of selection change
+      this.notifySelectionChange(event);
+    }
 
-    // Validate for single-select mode
-    let validatedValues = normalizedValues;
-    if (normalizedValues.length > 1 && !this.multiSelect) {
-      console.warn("MenuService - Multiple values provided for single-select menu. Only the first value will be selected.");
-      validatedValues = [normalizedValues[0]];
+    if (event.type === 'highlightChange') {
+      this.optionActive = event.option;
+      this._index = event.index;
     }
 
-    if (this._menuOptions.length === 0) {
-      this.queuePendingValue(value);
-      return;
+    if (event.type === 'optionsChange') {
+      this.options = event.options;
+      this.dispatchEvent(new CustomEvent('auroMenu-optionsChange', {
+        detail: {
+          options: event.options
+        }
+      }));
     }
+  }
 
-    // Find matching options by comparing available options to validated values
-    const trackedKeys = new Set();
-    const optionsToSelect = this._menuOptions.filter(option => {
-      const passesFilter = validatedValues.includes(option.key);
-      const alreadyTracked = trackedKeys.has(option.key);
-      const isActive = option.isActive;
+  /**
+   * Gets the currently selected options.
+   * @returns {Array<HTMLElement>}
+   */
+  get selectedOptions() {
+    return this.menuService ? this.menuService.selectedOptions : [];
+  }
 
-      trackedKeys.add(option.key);
+  /**
+   * Gets the first selected option, or null if none.
+   * @returns {HTMLElement|null}
+   */
+  get selectedOption() {
+    return this.menuService ? this.menuService.selectedOptions[0] : null;
+  }
 
-      // Include the option in the options to be selected if it passes the filter check and
-      // either hasn't been tracked yet or selectAllMatchingOptions is true
-      return isActive && passesFilter && (!alreadyTracked || (alreadyTracked && this.selectAllMatchingOptions));
-    });
+  // Lifecycle Methods
 
-    // Handle no matches: clear existing selection, but do not dispatch an intermediate
-    // undefined value that can overwrite the host value in parent components.
-    if (!optionsToSelect.length) {
-      const hasUnresolvedKeys = this._menuOptions.some((option) => option.isActive && option.key == null);
+  connectedCallback() {
+    super.connectedCallback();
 
-      if (hasUnresolvedKeys) {
-        this.queuePendingValue(value);
-        return;
-      }
+    this.provideContext();
 
-      this.clearPendingValue();
+    // this.addEventListener('keydown', this.handleKeyDown);
+    this.addEventListener('auroMenuOption-click', this.handleMouseSelect);
+    this.addEventListener('auroMenuOption-mouseover', this.handleOptionHover);
+    this.addEventListener('slotchange', this.handleSlotChange);
+    this.setTagAttribute("auro-menu");
+  }
 
-      if (this.selectedOptions.length > 0) {
-        this.selectedOptions = [];
-      }
+  disconnectedCallback() {
+    // this.removeEventListener('keydown', this.handleKeyDown);
+    this.removeEventListener('auroMenuOption-click', this.handleMouseSelect);
+    this.removeEventListener('auroMenuOption-mouseover', this.handleOptionHover);
+    this.removeEventListener('slotchange', this.handleSlotChange);
 
-      // Always notify so the host resets any stale invalid value, even when
-      // selectedOptions was already empty (e.g. double-clicking set-invalid).
-      this.stageUpdate({ reason: 'no-match' });
+    super.disconnectedCallback();
+  }
 
-      // Dispatch failure event if no matches found
-      if (validatedValues.length) {
-        this.dispatchChangeEvent('auroMenu-selectValueFailure', {
-          message: 'No matching options found for the provided value(s).',
-          values: validatedValues
-        });
-      }
+  firstUpdated() {
+    AuroLibraryRuntimeUtils.prototype.handleComponentTagRename(this, 'auro-menu');
+
+    this.loadingSlots = this.querySelectorAll("[slot='loadingText'], [slot='loadingIcon']");
+    this.initializeMenu();
+  }
 
-      return;
-    }
 
-    this.clearPendingValue();
+  updated(changedProperties) {
+    super.updated(changedProperties);
 
-    if (this.optionsArraysMatch(optionsToSelect, this.selectedOptions)) {
-      return;
+    // Apply value selection synchronously so that static-HTML fixtures
+    // resolve within a single update cycle.  The refactored selectByValue
+    // no longer calls reset() first, so the destructive intermediate-event
+    // cascade that originally required deferral is eliminated.  If option
+    // keys are not yet resolved (framework mount-order race), selectByValue
+    // queues a bounded retry automatically via queuePendingValue.
+    if (changedProperties.has('value') && !this.internalUpdateInProgress) {
+      this.menuService.selectByValue(this.value);
     }
 
-    // Apply programmatic selection as a single transaction and emit one final state.
-    this.selectedOptions = optionsToSelect;
-    this.stageUpdate();
+    // Handle loading state changes
+    if (changedProperties.has('loading')) {
+      this.setLoadingState(this.loading);
+    }
+
+    if (changedProperties.has('multiSelect') && this.rootMenu) {
+      if (this.multiSelect) {
+        this.setAttribute('aria-multiselectable', 'true');
+      } else {
+        this.removeAttribute('aria-multiselectable');
+      }
+    }
   }
 
   /**
-   * Queues a pending value and schedules a bounded retry.
-   * @param {string|number|Array<string|number>} value - The value to retry.
+   * Sets an attribute that matches the default tag name if the tag name is not the default.
+   * @param {string} tagName - The tag name to set as an attribute.
+   * @private
    */
-  queuePendingValue(value) {
-    this._pendingValue = value;
-
-    if (this._pendingRetryScheduled || this._pendingRetryCount >= 5) {
-      return;
+  setTagAttribute(tagName) {
+    if (this.tagName.toLowerCase() !== tagName) {
+      this.setAttribute(tagName, true);
     }
-
-    this._pendingRetryScheduled = true;
-    this._pendingRetryCount += 1;
-
-    setTimeout(() => {
-      this._pendingRetryScheduled = false;
-
-      if (this._pendingValue == null) {
-        return;
-      }
-
-      const pendingValue = this._pendingValue;
-      this.selectByValue(pendingValue);
-    }, 0);
   }
 
   /**
-   * Clears pending retry state.
+   * Sets the loading state and dispatches a loading change event.
+   * @param {boolean} isLoading - Whether the menu is loading.
+   * @protected
    */
-  clearPendingValue() {
-    this._pendingValue = null;
-    this._pendingRetryScheduled = false;
-    this._pendingRetryCount = 0;
+  setLoadingState(isLoading) {
+    this.setAttribute("aria-busy", isLoading);
+    dispatchMenuEvent(this, "auroMenu-loadingChange", {
+      loading: isLoading,
+      hasLoadingPlaceholder: this.hasLoadingPlaceholder
+    });
   }
 
+  // Init Methods
+
   /**
-   * Resets the selected options to an empty array.
+   * Initializes the menu's state and structure.
+   * @private
    */
-  reset() {
-    const previousOptions = [...this.selectedOptions];
-    previousOptions.forEach(opt => opt.selected = false);
-    this.selectedOptions = [];
+  initializeMenu() {
+    if (this.rootMenu) {
+      this.setAttribute('role', 'listbox');
+      this.setAttribute('root', '');
 
-    // Single update after clearing all
-    if (previousOptions.length) {
-      this.stageUpdate();
+      if (this.multiSelect) {
+        this.setAttribute('aria-multiselectable', 'true');
+      }
     }
-  }
 
-  /**
-   * SUBSCRIPTION, NOTIFICATION AND EVENT DISPATCH METHODS
-   */
+    this.handleNestedMenus(this);
+  }
 
   /**
-   * Subscribes a callback to menu service events.
-   * @param {Function} callback - The callback to invoke on events.
+   * Selects the currently highlighted option.
+   * @protected
    */
-  subscribe(callback) {
-    this._subscribers.push(callback);
+  makeSelection() {
+    this.menuService.selectHighlightedOption();
   }
 
   /**
-   * Remove a previously subscribed callback from menu service events.
-   * @param {Function} callback
+   * Resets all options to their default state.
+   * @private
    */
-  unsubscribe(callback) {
-    this._subscribers = this._subscribers.filter(cb => cb !== callback);
+  clearSelection() {
+    this.optionSelected = undefined;
+    this.value = undefined;
+    this._index = -1;
   }
 
   /**
-   * Stages an update to notify subscribers of state and value changes.
+   * Resets the menu to its initial state.
+   * This is the only way to return value to undefined.
+   * @public
    */
-  stageUpdate(meta = {}) {
-    this.notifyStateChange(meta);
-    this.notifyValueChange(meta);
+  reset() {
+    this.menuService.reset();
+
+    // Dispatch reset event
+    dispatchMenuEvent(this, 'auroMenu-selectValueReset');
   }
 
   /**
-   * Notifies subscribers of a menu service event.
-   * All notifications are sent to all subscribers.
-   * @param {string} event - The event to send to subscribers.
+   * Handles nested menu structure.
+   * @private
+   * @param {HTMLElement} menu - Root menu element.
    */
-  notify(event) {
-    this._subscribers.forEach(callback => callback(event));
+  handleNestedMenus(menu) {
+    menu.level = menu.parentElement.level >= 0 ? menu.parentElement.level + 1 : 0;
+
+    if (menu.level > 0) {
+      menu.setAttribute('role', 'group');
+      menu.removeAttribute("root");
+      if (!menu.hasAttribute('aria-label')) {
+        menu.setAttribute('aria-label', 'submenu');
+      }
+    }
+
+    const options = menu.querySelectorAll(':scope > auro-menuoption, :scope > [auro-menuoption]');
+    options.forEach((option) => {
+      const regex = new RegExp(this.nestingSpacer, "gu");
+      option.innerHTML = this.nestingSpacer.repeat(menu.level) + option.innerHTML.replace(regex, '');
+    });
   }
 
   /**
-   * Notifies subscribers of a state change (selected options has changed).
+   * Navigates the menu options in the specified direction.
+   * @param {'up'|'down'} direction - The direction to navigate.
+   * @protected
    */
-  notifyStateChange(meta = {}) {
-    this.notify({
-      type: 'stateChange',
-      selectedOptions: this.selectedOptions,
-      ...meta
-    });
+  navigateOptions(direction) {
+    if (direction === 'up') {
+      this.menuService.highlightPrevious();
+    } else if (direction === 'down') {
+      this.menuService.highlightNext();
+    }
   }
 
   /**
-   * Notifies subscribers of a value change (current value has changed).
+   * Handles slot change events.
+   * @private
    */
-  notifyValueChange(meta = {}) {
-
-    // Prepare details for the event
-    const details = {
-      value: this.currentValue,
-      stringValue: this.stringValue,
-      keys: this.currentKeys,
-      options: this.selectedOptions,
-      label: this.currentLabel
-    };
-
-    // If only one option is selected, include its index
-    if (this.selectedOptions.length === 1) details.index = this._menuOptions.indexOf(this.selectedOptions[0]);
-
-    this.notify({
-      type: 'valueChange',
-      ...meta,
-      ...details
-    });
+  handleSlotChange() {
+    if (this.rootMenu) {
+      this.initializeMenu();
+    }
   }
 
   /**
-   * Dispatches a custom event from the host element.
-   * @param {string} eventName
-   * @param {any} detail
+   * Handles custom events defined on options.
+   * @private
+   * @param {HTMLElement} option - Option with custom event.
    */
-  dispatchChangeEvent(eventName, detail) {
-    this.host.dispatchEvent(new CustomEvent(eventName, {
-      bubbles: true,
-      cancelable: false,
-      composed: true,
-      detail
-    }));
+  handleCustomEvent(option) {
+    const eventName = option.getAttribute('event');
+    dispatchMenuEvent(this, eventName);
+    dispatchMenuEvent(this, 'auroMenu-customEventFired');
   }
 
   /**
-   * MENU OPTION MANAGEMENT METHODS
+   * Notifies selection change to parent components.
+   * @param {any} source - The source that triggers this event.
+   * @private
    */
+  notifySelectionChange({value, stringValue, keys, options, reason} = {}) {
+    dispatchMenuEvent(this, 'auroMenu-selectedOption', {
+      value,
+      stringValue,
+      keys,
+      options,
+      reason
+    });
+  }
 
   /**
-   * Adds a menu option to the service's list.
-   * @param {AuroMenuOption} option - the option to track
+   * Checks if an option is currently selected.
+   * @private
+   * @param {HTMLElement} option - The option to check.
+   * @returns {boolean}
    */
-  addMenuOption(option) {
-    this._menuOptions.push(option);
-    this.notify({ type: 'optionsChange', options: this._menuOptions });
+  isOptionSelected(option) {
+    if (!this.optionSelected) {
+      return false;
+    }
 
-    if (this._pendingValue != null) {
-      this.queuePendingValue(this._pendingValue);
+    if (this.multiSelect) {
+      // In multi-select mode, check if the option is in the selected array
+      return Array.isArray(this.optionSelected) && this.optionSelected.some((selectedOption) => selectedOption === option);
     }
+
+    return this.optionSelected === option;
   }
 
   /**
-   * Removes a menu option from the service's list.
-   * @param {AuroMenuOption} option - the option to remove
+   * Getter for loading placeholder state.
+   * @returns {boolean} - True if loading slots are present and non-empty.
    */
-  removeMenuOption(option) {
-    this._menuOptions = this._menuOptions.filter(opt => opt !== option);
-    this.notify({ type: 'optionsChange', options: this._menuOptions });
-
-    if (this._menuOptions.length === 0) {
-      this.clearPendingValue();
-    }
+  get hasLoadingPlaceholder() {
+    return this.loadingSlots && this.loadingSlots.length > 0;
   }
 
   /**
-   * UTILITIES
+   * Getter for wrapper classes based on size.
+   * @returns {Object} - Class map for the wrapper element.
+   * @private
    */
+  get wrapperClasses() {
+    return e({
+      'menuWrapper': true,
+      [this.size]: true,
+    });
+  }
 
   /**
-   * Normalizes a value or array of values into an array of strings for option selection.
-   * This function ensures that input values are consistently formatted for matching menu options.
-   *
-   * @param {string|number|Array<string|number>} value - The value(s) to normalize.
-   * @returns {Array<string>} An array of string values suitable for option matching.
-   * @throws {Error} If any value is not a string or number.
+   * Logic to determine the layout of the component.
+   * @protected
+   * @returns {void}
    */
-  _getNormalizedValues(value) {
-    let values = value;
-
-    // Handle JSON string and single value string input
-    if (!Array.isArray(values) && typeof values === 'string') {
-
-      // Attempt to parse as JSON array
-      try {
+  renderLayout() {
+    if (this.loading) {
+      return b`
+        <div class="${this.wrapperClasses}">
+          <auro-menuoption
+            disabled
+            loadingplaceholder
+            class="${this.hasLoadingPlaceholder ? "" : "empty"}"
+          >
+            <div>
+              <slot name="loadingIcon" class="body-lg"></slot>
+              <slot name="loadingText"></slot>
+            </div>
+          </auro-menuoption>
+        </div>
+      `;
+    }
 
-        // Normalize single quotes to double quotes for JSON parsing
-        // This will not handle complex cases but will cover basic usage
-        const parseValue = values.replace(/'([^']*?)'/g, '"$1"');
+    return b`
+      <div class="${this.wrapperClasses}">
+        <slot @slotchange=${this.handleSlotChange}></slot>
+      </div>
+    `;
+  }
+}
 
-        // Attempt parse
-        const parsed = JSON.parse(parseValue);
+/**
+ * @license
+ * Copyright 2020 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const a=Symbol.for(""),o$1=t=>{if(t?.r===a)return t?._$litStatic$},s=t=>({_$litStatic$:t,r:a}),i=(t,...r)=>({_$litStatic$:r.reduce((r,e,a)=>r+(t=>{if(void 0!==t._$litStatic$)return t._$litStatic$;throw Error(`Value passed to 'literal' function must be a 'literal' result: ${t}. Use 'unsafeStatic' to pass non-literal values, but\n            take care to ensure page security.`)})(e)+t[a+1],t[0]),r:a}),l=new Map,n=t=>(r,...e)=>{const a=e.length;let s,i;const n=[],u=[];let c,$=0,f=false;for(;$<a;){for(c=r[$];$<a&&void 0!==(i=e[$],s=o$1(i));)c+=s+r[++$],f=true;$!==a&&u.push(i),n.push(c),$++;}if($===a&&n.push(r[a]),f){const t=n.join("$$lit$$");void 0===(r=l.get(t))&&(n.raw=n,l.set(t,r=n)),e=u;}return t(r,...e)},u$1=n(b);
 
-        // Ensure parsed value is an array
-        if (!Array.isArray(parsed)) throw new Error('Not an array');
+var styleCss = i$6`.body-default{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-default-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-default-font-size, 1rem);line-height:var(--wcss-body-default-line-height, 1.5rem)}.body-default-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-default-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-default-emphasized-font-size, 1rem);line-height:var(--wcss-body-default-emphasized-line-height, 1.5rem)}.body-lg{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-lg-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-lg-font-size, 1.125rem);line-height:var(--wcss-body-lg-line-height, 1.625rem)}.body-lg-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-lg-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-lg-emphasized-font-size, 1.125rem);line-height:var(--wcss-body-lg-emphasized-line-height, 1.625rem)}.body-sm{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-sm-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-sm-font-size, 0.875rem);line-height:var(--wcss-body-sm-line-height, 1.25rem)}.body-sm-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-sm-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-sm-emphasized-font-size, 0.875rem);line-height:var(--wcss-body-sm-emphasized-line-height, 1.25rem)}.body-xs{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-xs-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-xs-font-size, 0.75rem);line-height:var(--wcss-body-xs-line-height, 1rem)}.body-xs-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-xs-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-xs-emphasized-font-size, 0.75rem);line-height:var(--wcss-body-xs-emphasized-line-height, 1rem)}.body-2xs{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-2xs-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-2xs-font-size, 0.625rem);line-height:var(--wcss-body-2xs-line-height, 0.875rem)}.body-2xs-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-2xs-emphasized-weight, );letter-spacing:var(--wcss-body-letter-spacing, 0);font-size:var(--wcss-body-2xs-emphasized-font-size, 0.625rem);line-height:var(--wcss-body-2xs-emphasized-line-height, 0.875rem)}.display-2xl{font-family:var(--wcss-display-2xl-family, "AS Circular"),var(--wcss-display-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-2xl-weight, 300);line-height:var(--wcss-display-2xl-line-height, 1.3);font-size:var(--wcss-display-2xl-font-size, clamp(3.5rem, 6vw, 5.375rem));letter-spacing:var(--wcss-display-2xl-letter-spacing, 0)}.display-xl{font-family:var(--wcss-display-xl-family, "AS Circular"),var(--wcss-display-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-xl-weight, 300);line-height:var(--wcss-display-xl-line-height, 1.3);font-size:var(--wcss-display-xl-font-size, clamp(3rem, 5.3333333333vw, 4.5rem));letter-spacing:var(--wcss-display-xl-letter-spacing, 0)}.display-lg{font-family:var(--wcss-display-lg-family, "AS Circular"),var(--wcss-display-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-lg-weight, 300);line-height:var(--wcss-display-lg-line-height, 1.3);font-size:var(--wcss-display-lg-font-size, clamp(2.75rem, 4.6666666667vw, 4rem));letter-spacing:var(--wcss-display-lg-letter-spacing, 0)}.display-md{font-family:var(--wcss-display-md-family, "AS Circular"),var(--wcss-display-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-md-weight, 300);line-height:var(--wcss-display-md-line-height, 1.3);font-size:var(--wcss-display-md-font-size, clamp(2.5rem, 4vw, 3.5rem));letter-spacing:var(--wcss-display-md-letter-spacing, 0)}.display-sm{font-family:var(--wcss-display-sm-family, "AS Circular"),var(--wcss-display-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-sm-weight, 300);line-height:var(--wcss-display-sm-line-height, 1.3);font-size:var(--wcss-display-sm-font-size, clamp(2rem, 3.6666666667vw, 3rem));letter-spacing:var(--wcss-display-sm-letter-spacing, 0)}.display-xs{font-family:var(--wcss-display-xs-family, "AS Circular"),var(--wcss-display-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-display-xs-weight, 300);line-height:var(--wcss-display-xs-line-height, 1.3);font-size:var(--wcss-display-xs-font-size, clamp(1.75rem, 3vw, 2.375rem));letter-spacing:var(--wcss-display-xs-letter-spacing, 0)}.heading-xl{font-family:var(--wcss-heading-xl-family, "AS Circular"),var(--wcss-heading-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-xl-weight, 300);line-height:var(--wcss-heading-xl-line-height, 1.3);font-size:var(--wcss-heading-xl-font-size, clamp(2rem, 3vw, 2.5rem));letter-spacing:var(--wcss-heading-xl-letter-spacing, 0)}.heading-lg{font-family:var(--wcss-heading-lg-family, "AS Circular"),var(--wcss-heading-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-lg-weight, 300);line-height:var(--wcss-heading-lg-line-height, 1.3);font-size:var(--wcss-heading-lg-font-size, clamp(1.75rem, 2.6666666667vw, 2.25rem));letter-spacing:var(--wcss-heading-lg-letter-spacing, 0)}.heading-md{font-family:var(--wcss-heading-md-family, "AS Circular"),var(--wcss-heading-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-md-weight, 300);line-height:var(--wcss-heading-md-line-height, 1.3);font-size:var(--wcss-heading-md-font-size, clamp(1.625rem, 2.3333333333vw, 1.75rem));letter-spacing:var(--wcss-heading-md-letter-spacing, 0)}.heading-sm{font-family:var(--wcss-heading-sm-family, "AS Circular"),var(--wcss-heading-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-sm-weight, 300);line-height:var(--wcss-heading-sm-line-height, 1.3);font-size:var(--wcss-heading-sm-font-size, clamp(1.375rem, 2vw, 1.5rem));letter-spacing:var(--wcss-heading-sm-letter-spacing, 0)}.heading-xs{font-family:var(--wcss-heading-xs-family, "AS Circular"),var(--wcss-heading-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-xs-weight, 300);line-height:var(--wcss-heading-xs-line-height, 1.3);font-size:var(--wcss-heading-xs-font-size, clamp(1.25rem, 1.6666666667vw, 1.25rem));letter-spacing:var(--wcss-heading-xs-letter-spacing, 0)}.heading-2xs{font-family:var(--wcss-heading-2xs-family, "AS Circular"),var(--wcss-heading-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-heading-2xs-weight, 300);line-height:var(--wcss-heading-2xs-line-height, 1.3);font-size:var(--wcss-heading-2xs-font-size, clamp(1.125rem, 1.5vw, 1.125rem));letter-spacing:var(--wcss-heading-2xs-letter-spacing, 0)}.accent-2xl{font-family:var(--wcss-accent-2xl-family, "Good OT"),var(--wcss-accent-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-2xl-weight, 450);line-height:var(--wcss-accent-2xl-line-height, 1);font-size:var(--wcss-accent-2xl-font-size, clamp(2rem, 3.1666666667vw, 2.375rem));letter-spacing:var(--wcss-accent-2xl-letter-spacing, 0.05em);text-transform:uppercase}.accent-xl{font-family:var(--wcss-accent-xl-family, "Good OT"),var(--wcss-accent-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-xl-weight, 450);line-height:var(--wcss-accent-xl-line-height, 1.3);font-size:var(--wcss-accent-xl-font-size, clamp(1.625rem, 2.3333333333vw, 2rem));letter-spacing:var(--wcss-accent-xl-letter-spacing, 0.05em);text-transform:uppercase}.accent-lg{font-family:var(--wcss-accent-lg-family, "Good OT"),var(--wcss-accent-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-lg-weight, 450);line-height:var(--wcss-accent-lg-line-height, 1.3);font-size:var(--wcss-accent-lg-font-size, clamp(1.5rem, 2.1666666667vw, 1.75rem));letter-spacing:var(--wcss-accent-lg-letter-spacing, 0.05em);text-transform:uppercase}.accent-md{font-family:var(--wcss-accent-md-family, "Good OT"),var(--wcss-accent-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-md-weight, 500);line-height:var(--wcss-accent-md-line-height, 1.3);font-size:var(--wcss-accent-md-font-size, clamp(1.375rem, 1.8333333333vw, 1.5rem));letter-spacing:var(--wcss-accent-md-letter-spacing, 0.05em);text-transform:uppercase}.accent-sm{font-family:var(--wcss-accent-sm-family, "Good OT"),var(--wcss-accent-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-sm-weight, 500);line-height:var(--wcss-accent-sm-line-height, 1.3);font-size:var(--wcss-accent-sm-font-size, clamp(1.125rem, 1.5vw, 1.25rem));letter-spacing:var(--wcss-accent-sm-letter-spacing, 0.05em);text-transform:uppercase}.accent-xs{font-family:var(--wcss-accent-xs-family, "Good OT"),var(--wcss-accent-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-xs-weight, 500);line-height:var(--wcss-accent-xs-line-height, 1.3);font-size:var(--wcss-accent-xs-font-size, clamp(1rem, 1.3333333333vw, 1rem));letter-spacing:var(--wcss-accent-xs-letter-spacing, 0.1em);text-transform:uppercase}.accent-2xs{font-family:var(--wcss-accent-2xs-family, "Good OT"),var(--wcss-accent-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-weight:var(--wcss-accent-2xs-weight, 450);line-height:var(--wcss-accent-2xs-line-height, 1.3);font-size:var(--wcss-accent-2xs-font-size, clamp(0.875rem, 1.1666666667vw, 0.875rem));letter-spacing:var(--wcss-accent-2xs-letter-spacing, 0.1em);text-transform:uppercase}:host{cursor:pointer;user-select:none;text-overflow:ellipsis;max-width:100dvw}:host .wrapper{display:flex;align-items:center;height:var(--ds-size-400, 2rem);padding-right:var(--ds-size-200, 1rem);padding-left:calc(var(--ds-size-150, 0.75rem) + var(--ds-size-300, 1.5rem) + var(--ds-size-100, 0.5rem));border-radius:var(--ds-size-100, 0.5rem);-webkit-tap-highlight-color:transparent}:host .wrapper[class*=shape-box]{border-radius:unset}:host .wrapper[class*=shape-snowflake]{border-radius:unset;line-height:24px}:host .wrapper[class*=shape-pill]{border-radius:30px}:host .wrapper[class*=-lg]{padding-top:var(--ds-size-75, 0.375rem);padding-bottom:var(--ds-size-75, 0.375rem);padding-right:var(--ds-size-150, 0.75rem);line-height:26px}:host .wrapper[class*=-xl]{padding-top:var(--ds-size-100, 0.5rem);padding-bottom:var(--ds-size-100, 0.5rem);padding-right:var(--ds-size-200, 1rem);line-height:26px}:host slot{display:block;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}:host [auro-icon]{--ds-auro-icon-size: var(--ds-size-300, 1.5rem);margin-right:var(--ds-size-150, 0.75rem);margin-left:var(--ds-size-100, 0.5rem)}:host ::slotted(.nestingSpacer){display:inline-block;width:var(--ds-size-300, 1.5rem)}[slot=displayValue]{display:none}:host([loadingplaceholder]) .wrapper{padding-left:calc(var(--ds-size-150, 0.75rem) + var(--ds-size-300, 1.5rem) + var(--ds-size-100, 0.5rem))}:host([selected]) .wrapper{padding-left:0}:host([nocheckmark]) .wrapper{padding-left:var(--ds-size-150, 0.75rem)}:host([nocheckmark]) .wrapper[class*=-lg]{padding-left:var(--ds-size-150, 0.75rem)}:host([nocheckmark]) .wrapper[class*=-xl]{padding-left:var(--ds-size-200, 1rem)}:host([hidden]){display:none}:host([static]){pointer-events:none}:host([disabled]:hover){cursor:auto}:host([disabled]){user-select:none;pointer-events:none}`;
 
-        // Set values to parsed array
-        values = parsed;
-      } catch (err) {
+var colorCss = i$6`:host .wrapper{background-color:var(--ds-auro-menuoption-container-color, transparent);box-shadow:inset 0 0 0 1px var(--ds-auro-menuoption-container-border-color, transparent);color:var(--ds-auro-menuoption-text-color)}:host svg{fill:var(--ds-auro-menuoption-icon-color)}:host([disabled]){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-default, #ffffff);--ds-auro-menuoption-text-color: var(--ds-basic-color-texticon-disabled, #d0d0d0);--ds-auro-menuoption-icon-color: var(--ds-basic-color-texticon-disabled, #d0d0d0)}:host(.active){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd)}@media(hover: hover){:host(:hover){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd)}}:host(:focus){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-default, #ffffff);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}:host([selected]){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-subtle, #b4eff9);--ds-auro-menuoption-text-color: var(--ds-basic-color-texticon-default, #2a2a2a);--ds-auro-menuoption-icon-color: var(--ds-basic-color-texticon-default, #2a2a2a)}:host([selected].active){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd)}@media(hover: hover){:host([selected]:hover){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd)}}:host([selected]:focus){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-subtle, #b4eff9);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}:host(:focus.active){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}@media(hover: hover){:host(:focus:hover){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}}:host([selected]:focus.active){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}@media(hover: hover){:host([selected]:focus:hover){--ds-auro-menuoption-container-color: var(--ds-basic-color-surface-accent1-muted, #ebfafd);--ds-auro-menuoption-container-border-color: var(--ds-basic-color-border-brand, #00274a)}}`;
 
-        // If parsing fails, treat as single value
-        values = [value];
-      }
-    }
+// Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
+// See LICENSE in the project root for license information.
 
-    // Handle a single number being passed
-    if (typeof values === 'number') {
-      values = [String(values)];
-    }
 
-    // Coerce each value to string and validate types
-    values.forEach((val, index) => {
+class AuroDependencyVersioning {
 
-      // Throw an error for invalid value types
-      if (typeof val !== 'string' && typeof val !== 'number') {
-        throw new Error('Value contains invalid value type. Supported types are string and number.');
-      }
+  /**
+   * Generates a unique string to be used for child auro element naming.
+   * @private
+   * @param {string} baseName - Defines the first part of the unique element name.
+   * @param {string} version - Version of the component that will be appended to the baseName.
+   * @returns {string} - Unique string to be used for naming.
+   */
+  generateElementName(baseName, version) {
+    let result = baseName;
 
-      // Convert numbers to strings for consistency
-      if (typeof val === 'number') {
-        values[index] = String(val);
-      }
-    });
+    result += '-';
+    result += version.replace(/[.]/g, '_');
 
-    // Return the resulting array of string values
-    return values;
+    return result;
   }
 
   /**
-   * Returns whether two arrays of options contain the same elements.
-   * @param {AuroMenuOption[]} arr1 - First array of options.
-   * @param {AuroMenuOption[]} arr2 - Second array of options.
-   * @returns {boolean} True if arrays match, false otherwise.
+   * Generates a unique string to be used for child auro element naming.
+   * @param {string} baseName - Defines the first part of the unique element name.
+   * @param {string} version - Version of the component that will be appended to the baseName.
+   * @returns {string} - Unique string to be used for naming.
    */
-  optionsArraysMatch(arr1, arr2) {
-    if (arr1.length !== arr2.length) return false;
-
-    const set1 = new Set(arr1);
-    const set2 = new Set(arr2);
+  generateTag(baseName, version, tagClass) {
+    const elementName = this.generateElementName(baseName, version);
+    const tag = i`${s(elementName)}`;
 
-    for (let item of set1) {
-      if (!set2.has(item)) {
-        return false;
-      }
+    if (!customElements.get(elementName)) {
+      customElements.define(elementName, class extends tagClass {});
     }
 
-    return true;
+    return tag;
   }
 }
 
-const MenuContext = n$1('menu-context');
+/**
+ * @license
+ * Copyright 2018 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */const o=o=>o??A;
 
-/* eslint-disable no-underscore-dangle */
-// Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
+class p{registerComponent(t,a){customElements.get(t)||customElements.define(t,class extends a{});}closestElement(t,a=this,e=(a,s=a&&a.closest(t))=>a&&a!==document&&a!==window?s||e(a.getRootNode().host):null){return e(a)}handleComponentTagRename(t,a){const e=a.toLowerCase();t.tagName.toLowerCase()!==e&&t.setAttribute(e,true);}elementMatch(t,a){const e=a.toLowerCase();return t.tagName.toLowerCase()===e||t.hasAttribute(e)}getSlotText(t,a){const e=t.shadowRoot?.querySelector(`slot[name="${a}"]`);return (e?.assignedNodes({flatten:true})||[]).map(t=>t.textContent?.trim()).join(" ").trim()||null}}var u='<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-labelledby="error__desc" class="ico_squareLarge" data-deprecated="true" role="img" style="min-width:var(--auro-size-lg, var(--ds-size-300, 1.5rem));height:var(--auro-size-lg, var(--ds-size-300, 1.5rem));fill:currentColor" viewBox="0 0 24 24" part="svg"><title/><desc id="error__desc">Error alert indicator.</desc><path d="m13.047 5.599 6.786 11.586A1.207 1.207 0 0 1 18.786 19H5.214a1.207 1.207 0 0 1-1.047-1.815l6.786-11.586a1.214 1.214 0 0 1 2.094 0m-1.165.87a.23.23 0 0 0-.085.085L5.419 17.442a.232.232 0 0 0 .203.35h12.756a.234.234 0 0 0 .203-.35L12.203 6.554a.236.236 0 0 0-.321-.084M12 15.5a.75.75 0 1 1 0 1.5.75.75 0 0 1 0-1.5m-.024-6.22c.325 0 .589.261.589.583v4.434a.586.586 0 0 1-.589.583.586.586 0 0 1-.588-.583V9.863c0-.322.264-.583.588-.583"/></svg>',g='<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" style="min-width:100%;height:auto;fill:currentColor" viewBox="0 0 142 138" part="svg"><title id="tail-DEFAULT__title">Airplane tail default image with light gray color</title><path fill="url(#paint0_linear_9225_2069)" fill-rule="evenodd" d="M124.093 14.665a3.26 3.26 0 0 1 3.208 3.829L101.097 119.85c-.47 1.087-2.211 3.398-5.692 3.471l-.106.001-80.65.013A659230 659230 0 0 1 99.08 17.412c1.214-1.497 3.275-2.722 5.372-2.747z" clip-rule="evenodd"/><defs><linearGradient id="paint0_linear_9225_2069" x1="114.823" x2="60.061" y1="14.665" y2="123.335" gradientUnits="userSpaceOnUse"><stop offset=".5" stop-color="#707984"/><stop offset=".5" stop-color="#646E7B"/></linearGradient></defs></svg>';class m extends i$3{static get properties(){return {hidden:{type:Boolean,reflect:true},hiddenVisually:{type:Boolean,reflect:true},hiddenAudible:{type:Boolean,reflect:true}}}hideAudible(t){return t?"true":"false"}}const f=new Map,w=(t,a={})=>{const e=a.responseParser||(t=>t.text());return f.has(t)||f.set(t,fetch(t).then(e)),f.get(t)};var z=i$6`:focus:not(:focus-visible){outline:3px solid transparent}.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock,:host{display:block}.util_displayFlex{display:flex}.util_displayHidden,:host([hidden]:not(:focus):not(:active)){display:none}.util_displayHiddenVisually,:host([hiddenVisually]:not(:focus):not(:active)){position:absolute;overflow:hidden;clip:rect(1px,1px,1px,1px);width:1px;height:1px;padding:0;border:0}.ico_squareLarge{fill:currentColor;height:var(--auro-size-lg, var(--ds-size-300, 1.5rem))}.ico_squareSmall{fill:currentColor;height:.6rem}.ico_squareMed{fill:currentColor;height:var(--auro-size-md, var(--ds-size-200, 1rem))}.ico_squareSml{fill:currentColor;height:var(--auro-size-sm, var(--ds-size-150, .75rem))}:host{color:currentColor;vertical-align:middle;display:inline-block}svg{min-width:var(--ds-auro-icon-size, 1.5rem)!important;width:var(--ds-auro-icon-size, 1.5rem)!important;height:var(--ds-auro-icon-size, 1.5rem)!important}.componentWrapper{display:flex;line-height:var(--ds-auro-icon-size)}.svgWrapper{height:var(--ds-auro-icon-size);width:var(--ds-auro-icon-size)}.svgWrapper [part=svg]{display:flex}.labelWrapper{margin-left:var(--ds-size-50, .25rem)}.labelWrapper ::slotted(*){line-height:inherit!important}
+`;class y extends m{constructor(){super(),this._initializeDefaults();}_initializeDefaults(){this.onDark=false,this.appearance="default";}static get properties(){return {...m.properties,onDark:{type:Boolean,reflect:true},appearance:{type:String,reflect:true},svg:{attribute:false,reflect:true}}}static get styles(){return z}async fetchIcon(t,a){let e="";e="logos"===t?await w(`${this.uri}/${t}/${a}.svg`):await w(`${this.uri}/icons/${t}/${a}.svg`);return (new DOMParser).parseFromString(e,"text/html").body.querySelector("svg")}async firstUpdated(){try{if(!this.customSvg){const t=await this.fetchIcon(this.category,this.name);if(t)this.svg=t;else if(!t){const t=this.name?.startsWith("tail-")?g:u;this.svg=(new DOMParser).parseFromString(t,"text/html").body.querySelector("svg");}}}catch(t){this.svg=void 0;}}}i$6`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock,:host{display:block}.util_displayFlex{display:flex}.util_displayHidden,:host([hidden]:not(:focus):not(:active)){display:none}.util_displayHiddenVisually,:host([hiddenVisually]:not(:focus):not(:active)){position:absolute;overflow:hidden;clip:rect(1px,1px,1px,1px);width:1px;height:1px;padding:0;border:0}:host{display:inline-block;--ds-auro-icon-size: 100%;width:100%;height:100%}:host .logo{color:var(--ds-auro-alaska-color)}:host([onDark]),:host([appearance=inverse]){--ds-auro-alaska-color: #FFF}
+`;var M=i$6`:host{--ds-auro-icon-color: var(--ds-basic-color-texticon-default, #2a2a2a);--ds-auro-alaska-color: #02426D;--ds-auro-icon-size: var(--ds-size-300, 1.5rem)}
+`;var _=i$6`:host{color:var(--ds-auro-icon-color)}:host([customColor]){color:inherit}:host(:not([onDark])[variant=accent1]),:host(:not([appearance=inverse])[variant=accent1]){--ds-auro-icon-color: var(--ds-basic-color-texticon-accent1, #265688)}:host(:not([onDark])[variant=disabled]),:host(:not([appearance=inverse])[variant=disabled]){--ds-auro-icon-color: var(--ds-basic-color-texticon-disabled, #d0d0d0)}:host(:not([onDark])[variant=muted]),:host(:not([appearance=inverse])[variant=muted]){--ds-auro-icon-color: var(--ds-basic-color-texticon-muted, #676767)}:host(:not([onDark])[variant=statusDefault]),:host(:not([appearance=inverse])[variant=statusDefault]){--ds-auro-icon-color: var(--ds-basic-color-status-default, #afb9c6)}:host(:not([onDark])[variant=statusInfo]),:host(:not([appearance=inverse])[variant=statusInfo]){--ds-auro-icon-color: var(--ds-basic-color-status-info, #01426a)}:host(:not([onDark])[variant=statusSuccess]),:host(:not([appearance=inverse])[variant=statusSuccess]){--ds-auro-icon-color: var(--ds-basic-color-status-success, #447a1f)}:host(:not([onDark])[variant=statusWarning]),:host(:not([appearance=inverse])[variant=statusWarning]){--ds-auro-icon-color: var(--ds-basic-color-status-warning, #fac200)}:host(:not([onDark])[variant=statusError]),:host(:not([appearance=inverse])[variant=statusError]){--ds-auro-icon-color: var(--ds-basic-color-status-error, #e31f26)}:host(:not([onDark])[variant=statusInfoSubtle]),:host(:not([appearance=inverse])[variant=statusInfoSubtle]){--ds-auro-icon-color: var(--ds-basic-color-status-info-subtle, #ebf3f9)}:host(:not([onDark])[variant=statusSuccessSubtle]),:host(:not([appearance=inverse])[variant=statusSuccessSubtle]){--ds-auro-icon-color: var(--ds-basic-color-status-success-subtle, #d6eac7)}:host(:not([onDark])[variant=statusWarningSubtle]),:host(:not([appearance=inverse])[variant=statusWarningSubtle]){--ds-auro-icon-color: var(--ds-basic-color-status-warning-subtle, #fff0b2)}:host(:not([onDark])[variant=statusErrorSubtle]),:host(:not([appearance=inverse])[variant=statusErrorSubtle]){--ds-auro-icon-color: var(--ds-basic-color-status-error-subtle, #fbc6c6)}:host(:not([onDark])[variant=fareBasicEconomy]),:host(:not([appearance=inverse])[variant=fareBasicEconomy]){--ds-auro-icon-color: var(--ds-basic-color-fare-basiceconomy, #97eaf8)}:host(:not([onDark])[variant=fareBusiness]),:host(:not([appearance=inverse])[variant=fareBusiness]){--ds-auro-icon-color: var(--ds-basic-color-fare-business, #01426a)}:host(:not([onDark])[variant=fareEconomy]),:host(:not([appearance=inverse])[variant=fareEconomy]){--ds-auro-icon-color: var(--ds-basic-color-fare-economy, #0074ca)}:host(:not([onDark])[variant=fareFirst]),:host(:not([appearance=inverse])[variant=fareFirst]){--ds-auro-icon-color: var(--ds-basic-color-fare-first, #00274a)}:host(:not([onDark])[variant=farePremiumEconomy]),:host(:not([appearance=inverse])[variant=farePremiumEconomy]){--ds-auro-icon-color: var(--ds-basic-color-fare-premiumeconomy, #005154)}:host(:not([onDark])[variant=tierOneWorldEmerald]),:host(:not([appearance=inverse])[variant=tierOneWorldEmerald]){--ds-auro-icon-color: var(--ds-basic-color-tier-program-oneworld-emerald, #139142)}:host(:not([onDark])[variant=tierOneWorldSapphire]),:host(:not([appearance=inverse])[variant=tierOneWorldSapphire]){--ds-auro-icon-color: var(--ds-basic-color-tier-program-oneworld-sapphire, #015daa)}:host(:not([onDark])[variant=tierOneWorldRuby]),:host(:not([appearance=inverse])[variant=tierOneWorldRuby]){--ds-auro-icon-color: var(--ds-basic-color-tier-program-oneworld-ruby, #a41d4a)}:host([onDark]),:host([appearance=inverse]){--ds-auro-icon-color: var(--ds-basic-color-texticon-inverse, #ffffff)}:host([onDark][variant=disabled]),:host([appearance=inverse][variant=disabled]){--ds-auro-icon-color: var(--ds-basic-color-texticon-inverse-disabled, #7e8894)}:host([onDark][variant=muted]),:host([appearance=inverse][variant=muted]){--ds-auro-icon-color: var(--ds-basic-color-texticon-inverse-muted, #ccd2db)}:host([onDark][variant=statusError]),:host([appearance=inverse][variant=statusError]){--ds-auro-icon-color: var(--ds-advanced-color-state-error-inverse, #f9a4a8)}
+`;class k extends y{constructor(){super(),this._initializeDefaults();}_initializeDefaults(){this.variant=void 0,this.uri="https://cdn.jsdelivr.net/npm/@alaskaairux/icons@latest/dist",this.runtimeUtils=new p;}static get properties(){return {...y.properties,ariaHidden:{type:String,reflect:true},category:{type:String,reflect:true},customColor:{type:Boolean,reflect:true},customSvg:{type:Boolean},label:{type:Boolean,reflect:true},name:{type:String,reflect:true},variant:{type:String,reflect:true}}}static get styles(){return [y.styles,M,z,_]}static register(t="auro-icon"){p.prototype.registerComponent(t,k);}connectedCallback(){super.connectedCallback(),this.runtimeUtils.handleComponentTagRename(this,"auro-icon");}exposeCssParts(){this.setAttribute("exportparts","svg:iconSvg");}async firstUpdated(){if(await super.firstUpdated(),this.hasAttribute("ariaHidden")&&this.svg){const t=this.svg.querySelector("desc");t&&(t.remove(),this.svg.removeAttribute("aria-labelledby"));}}render(){const t={labelWrapper:true,util_displayHiddenVisually:!this.label};return b`
+      <div class="componentWrapper">
+        <div
+          class="${e({svgWrapper:true})}"
+          title="${o(this.title||void 0)}">
+          <span aria-hidden="${o(this.ariaHidden||true)}" part="svg">
+            ${this.customSvg?b`
+                <slot name="svg"></slot>
+              `:b`
+                ${this.svg}
+              `}
+          </span>
+        </div>
+
+        <div class="${e(t)}" part="label">
+          <slot></slot>
+        </div>
+      </div>
+    `}}
+
+var iconVersion = '9.1.2';
+
+var checkmarkIcon = {"svg":"<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" aria-labelledby=\"checkmark-sm__desc\" class=\"ico_squareLarge\" role=\"img\" style=\"min-width:var(--auro-size-lg, var(--ds-size-300, 1.5rem));height:var(--auro-size-lg, var(--ds-size-300, 1.5rem));fill:currentColor\" viewBox=\"0 0 24 24\" part=\"svg\"><title/><desc id=\"checkmark-sm__desc\">a small check mark.</desc><path d=\"M8.461 11.84a.625.625 0 1 0-.922.844l2.504 2.738c.247.27.674.27.922 0l5.496-6a.625.625 0 1 0-.922-.844l-5.035 5.496z\"/></svg>"};
+
+// Copyright (c) 2021 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
 
 
+let menuOptionIdCounter = 0;
 
 /**
- * The `auro-menu` element provides users a way to select from a list of options.
- * @customElement auro-menu
+ * The `auro-menuoption` element provides users a way to define a menu option.
+ * @customElement auro-menuoption
  *
- * @event {CustomEvent<Element>} auroMenu-activatedOption - Notifies that a menuoption has been made `active`.
- * @event {CustomEvent<any>} auroMenu-customEventFired - Notifies that a custom event has been fired.
- * @event {CustomEvent<{ loading: boolean; hasLoadingPlaceholder: boolean; }>} auroMenu-loadingChange - Notifies when the loading attribute is changed.
- * @event {CustomEvent<any>} auroMenu-selectValueFailure - Notifies that an attempt to select a menuoption by matching a value has failed.
- * @event {CustomEvent<{ values: HTMLElement[] }>} auroMenu-deselectPrevented - Notifies that deselection was prevented and includes the affected options in `detail.values`.
- * @event {CustomEvent<any>} auroMenu-selectValueReset - Notifies that the component value has been reset.
- * @event {CustomEvent<any>} auroMenu-selectedOption - Notifies that a new menuoption selection has been made.
- * @slot loadingText - Text to show while loading attribute is set
- * @slot loadingIcon - Icon to show while loading attribute is set
- * @slot - Slot for insertion of menu options.
+ * @slot default - The default slot for the menu option text.
+ *
+ * @event auroMenuOption-mouseover - Notifies that this option has been hovered over.
  */
+class AuroMenuOption extends AuroElement {
 
-/* eslint-disable max-lines */
+  /**
+   * This will register this element with the browser.
+   * @param {string} [name="auro-menuoption"] - The name of the element that you want to register.
+   *
+   * @example
+   * AuroMenuOption.register("custom-menuoption") // this will register this element to <custom-menuoption/>
+   *
+   */
+  static register(name = "auro-menuoption") {
+    AuroLibraryRuntimeUtils.prototype.registerComponent(name, AuroMenuOption);
+  }
 
-class AuroMenu extends AuroElement {
+  /**
+   * Returns whether the menu option is currently active and selectable.
+   * An option is considered active if it is not hidden, not disabled, and not static.
+   * @returns {boolean} True if the option is active, false otherwise.
+   */
+  get isActive() {
+    return !this.hasAttribute('hidden') &&
+      !this.disabled &&
+      !this.hasAttribute('static');
+  }
 
   constructor() {
     super();
 
-    // State properties (reactive)
+    this.bindEvents();
 
     /**
      * @private
      */
-    this.shape = "box";
+    this.shape = undefined;
 
     /**
      * @private
      */
-    this.size = "sm";
-
-    // Value of the selected options
-    this.value = undefined;
-    // Currently selected option
-    this.optionSelected = undefined;
-    // String used for highlighting/filtering
-    this.matchWord = undefined;
-    // Hide the checkmark icon on selected options
-    this.noCheckmark = false;
-    // Currently active option
-    this.optionActive = undefined;
-    // Loading state
-    this.loading = false;
-    // Multi-select mode
-    this.multiSelect = false;
-    // Allow deselecting of menu options
-    this.allowDeselect = false;
-    // Select all matching options when setting value in multi-select mode
-    this.selectAllMatchingOptions = false;
-
-    // Event Bindings
+    this.size = undefined;
 
     /**
-     * @private
+     * Generate unique names for dependency components.
      */
-    this.handleSlotChange = this.handleSlotChange.bind(this);
+    const versioning = new AuroDependencyVersioning();
+    this.iconTag = versioning.generateTag('auro-formkit-menuoption-icon', iconVersion, k);
 
-    // Instance properties (non-reactive)
+    this.selected = false;
+    this.noCheckmark = false;
+    this.disabled = false;
+    this.noMatch = false;
 
     /**
      * @private
      */
-    Object.assign(this, {
-      // Root-level menu (true) or a nested submenu (false)
-      rootMenu: true,
-      // Currently focused/active menu item index
-      _index: -1,
-      // Nested menu spacer
-      nestingSpacer: '<span class="nestingSpacer"></span>',
-      // Loading indicator for slot elements
-      loadingSlots: null,
-    });
+    this.runtimeUtils = new AuroLibraryRuntimeUtils();
+
+    // Initialize context-related properties
+    this.menuService = null;
+    this.unsubscribe = null;
+
+    /**
+     * @private
+     */
+    this.handleMenuChange = this.handleMenuChange.bind(this);
   }
 
   static get properties() {
@@ -1701,15 +1843,7 @@ class AuroMenu extends AuroElement {
       ...super.properties,
 
       /**
-       * Allows deselecting an already selected option when clicked again in single-select mode.
-       */
-      allowDeselect: {
-        type: Boolean,
-        reflect: true,
-      },
-
-      /**
-       * When true, the entire menu and all options are disabled.
+       * When true, disables the menu option.
        */
       disabled: {
         type: Boolean,
@@ -1717,542 +1851,409 @@ class AuroMenu extends AuroElement {
       },
 
       /**
-       * Indicates whether the menu has a loadingIcon or loadingText to render when in a loading state.
-       */
-      hasLoadingPlaceholder: {
-        type: Boolean
-      },
-
-      /**
-       * @private
-       */
-      layout: {
-        type: String
-      },
-
-      /**
-       * Indent level for submenus.
        * @private
        */
-      level: {
-        type: Number,
-        reflect: false,
-        attribute: false
-      },
-
-      /**
-       * When true, displays a loading state using the loadingIcon and loadingText slots if provided.
-       */
-      loading: {
-        type: Boolean,
-        reflect: true
-      },
-
-      /**
-       * Specifies a string used to highlight matched string parts in options.
-       */
-      matchWord: {
-        type: String,
-        attribute: 'matchword'
-      },
-
-      /**
-       * When true, the selected option can be multiple options.
-       */
-      multiSelect: {
-        type: Boolean,
-        reflect: true,
-        attribute: 'multiselect'
-      },
-
-      /**
-       * When true, selected option will not show the checkmark.
-       */
-      noCheckmark: {
-        type: Boolean,
-        reflect: true,
-        attribute: 'nocheckmark'
-      },
-
-      /**
-       * Specifies the current active menuOption.
-       */
-      optionActive: {
-        type: Object,
-        attribute: 'optionactive'
-      },
-
-      /**
-       * An array of currently selected menu options, type `HTMLElement` by default. In multi-select mode, `optionSelected` is an array of HTML elements.
-       */
-      optionSelected: {
-        // Allow HTMLElement, HTMLElement[] arrays and undefined
-        type: Object
-      },
-
-      /**
-       * Available menu options.
-       * @readonly
-       */
-      options: {
-        type: Array,
-        reflect: false,
-        attribute: false
-      },
-
-      /**
-       * Sets the size of the menu.
-       * @type {'sm' | 'md'}
-       * @default 'sm'
-       */
-      size: {
+      event: {
         type: String,
         reflect: true
       },
 
       /**
-       * When true, selects all options that match the provided value/key when setting value and multiselect is enabled.
+       * @private
        */
-      selectAllMatchingOptions: {
-        type: Boolean,
-        reflect: true,
+      layout: {
+        type: String
       },
 
       /**
-       * Sets the shape of the menu.
-       * @type {'box' | 'round'}
-       * @default 'box'
+       * Allows users to set a unique key for the menu option for specified option selection. If no key is provided, the value property will be used.
        */
-      shape: {
+      key: {
         type: String,
         reflect: true
       },
 
       /**
-       * The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.
+       * @private
        */
-      value: {
-        type: String,
-        reflect: true,
-        attribute: 'value'
-      }
-    };
-  }
-
-  static get styles() {
-    return [
-      styleCss$1,
-      colorCss$1,
-      tokensCss
-    ];
-  }
-
-  /**
-   * @readonly
-   * @returns {string} - Returns the label of the currently selected option(s).
-   */
-  get currentLabel() {
-    return this.menuService.currentLabel;
-  };
-
-  /**
-   * @readonly
-   * @returns {Array<HTMLElement>} - Returns the array of available menu options.
-   * @deprecated Use `options` property instead.
-   */
-  get items() {
-    return this.options;
-  }
-
-  /**
-   * @returns {number} - Returns the index of the currently active option.
-   */
-  get index() {
-    return this._index;
-  }
-
-  /**
-   * @param {number} value - Sets the index of the currently active option.
-   */
-  set index(value) {
-    this.menuService.setHighlightedIndex(value);
-  }
-
-  /**
-   * This will register this element with the browser.
-   * @param {string} [name="auro-menu"] - The name of the element that you want to register.
-   *
-   * @example
-   * AuroMenu.register("custom-menu") // this will register this element to <custom-menu/>
-   *
-   */
-  static register(name = "auro-menu") {
-    AuroLibraryRuntimeUtils.prototype.registerComponent(name, AuroMenu);
-  }
-
-  /**
-   * Formatted value based on `multiSelect` state.
-   * Default type is `String`, changing to `Array<String>` when `multiSelect` is true.
-   * @private
-   * @returns {String|Array<String>}
-   */
-  get formattedValue() {
-    return this.menuService.currentValue;
-  }
-
-  /**
-   * Gets the current property values for the menu service.
-   * @private
-   * @returns {Object}
-   */
-  get propertyValues() {
-    return {
-      size: this.size,
-      shape: this.shape,
-      noCheckmark: this.nocheckmark,
-      disabled: this.disabled
-    };
-  }
-
-  /**
-   * Provides the menu context to child components.
-   * Initializes the MenuService and subscribes to menu changes.
-   * @protected
-   */
-  provideContext() {
-    if (this.parentElement && this.parentElement.closest('auro-menu, [auro-menu]')) {
-      this.rootMenu = false;
-      this.menuService = this.parentElement.menuService;
-      this._contextProvider = this.parentElement._contextProvider;
-      return;
-    }
-
-    this.menuService = new MenuService({host: this});
-    this.menuService.setProperties(this.propertyValues);
-    this.menuService.subscribe(this.handleMenuChange.bind(this));
-    this._contextProvider = new i$2(this, {
-      context: MenuContext,
-      initialValue: this.menuService
-    });
-  }
-
-  /**
-   * Updates the currently active option in the menu.
-   * @param {HTMLElement} option - The option to set as active.
-   */
-  updateActiveOption(option) {
-    this.menuService.setHighlightedOption(option);
-  }
-
-  /**
-   * Sets the internal value and manages update state.
-   * @param {String|Array<String>} value - The value to set.
-   * @protected
-   */
-  setInternalValue(value) {
-    if (this.value !== value) {
-      this.internalUpdateInProgress = true;
-      this.value = value;
-
-      setTimeout(() => {
-        this.internalUpdateInProgress = false;
-      });
-    }
-  }
-
-  /**
-   * Handles changes from the menu service and updates component state.
-   * @param {Object} event - The event object from the menu service.
-   * @protected
-   */
-  handleMenuChange(event) {
-    if (event.type === 'valueChange') {
+      menuService: {
+        type: Object,
+        state: true
+      },
 
-      // New option is array value or first option with fallback to undefined for empty array in all cases
-      const newOption = this.multiSelect && event.options.length ? event.options : event.options[0] || undefined;
-      const newValue = event.stringValue;
+      /**
+       * @private
+       */
+      matchWord: {
+        type: String,
+        state: true
+      },
 
-      // Check if the option or value has actually changed
-      if (this.optionSelected !== newOption || this.stringValue !== newValue) {
-        this.optionSelected = newOption;
-        this.setInternalValue(newValue);
-      }
+      /**
+       * @private
+       */
+      noCheckmark: {
+        type: Boolean,
+        reflect: true
+      },
 
-      // Notify components of selection change
-      this.notifySelectionChange(event);
-    }
+      /**
+       * When true, marks this option as the "no matching results" placeholder shown by combobox when the user's input does not match any available options. Enables distinct styling and prevents the option from being treated as a selectable match.
+       */
+      noMatch: {
+        type: Boolean,
+        reflect: true,
+        attribute: 'nomatch'
+      },
 
-    if (event.type === 'highlightChange') {
-      this.optionActive = event.option;
-      this._index = event.index;
-    }
+      /**
+       * Specifies that an option is selected.
+       */
+      selected: {
+        type: Boolean,
+        reflect: true
+      },
 
-    if (event.type === 'optionsChange') {
-      this.options = event.options;
-      this.dispatchEvent(new CustomEvent('auroMenu-optionsChange', {
-        detail: {
-          options: event.options
-        }
-      }));
-    }
-  }
+      /**
+       * Specifies the tab index of the menu option.
+       */
+      tabIndex: {
+        type: Number,
+        reflect: true
+      },
 
-  /**
-   * Gets the currently selected options.
-   * @returns {Array<HTMLElement>}
-   */
-  get selectedOptions() {
-    return this.menuService ? this.menuService.selectedOptions : [];
+      /**
+       * Specifies the value to be sent to a server.
+       */
+      value: {
+        type: String,
+        reflect: true
+      },
+    };
   }
 
-  /**
-   * Gets the first selected option, or null if none.
-   * @returns {HTMLElement|null}
-   */
-  get selectedOption() {
-    return this.menuService ? this.menuService.selectedOptions[0] : null;
+  static get styles() {
+    return [
+      styleCss,
+      colorCss,
+      tokensCss
+    ];
   }
 
-  // Lifecycle Methods
-
   connectedCallback() {
     super.connectedCallback();
 
-    this.provideContext();
-
-    // this.addEventListener('keydown', this.handleKeyDown);
-    this.addEventListener('auroMenuOption-click', this.handleMouseSelect);
-    this.addEventListener('auroMenuOption-mouseover', this.handleOptionHover);
-    this.addEventListener('slotchange', this.handleSlotChange);
-    this.setTagAttribute("auro-menu");
-  }
+    // Add the tag name as an attribute if it is different than the component name
+    // Add this step soon as this node gets attached to the DOM to avoid racing condition with menu's value setting logic.
+    this.runtimeUtils.handleComponentTagRename(this, 'auro-menuoption');
 
-  disconnectedCallback() {
-    // this.removeEventListener('keydown', this.handleKeyDown);
-    this.removeEventListener('auroMenuOption-click', this.handleMouseSelect);
-    this.removeEventListener('auroMenuOption-mouseover', this.handleOptionHover);
-    this.removeEventListener('slotchange', this.handleSlotChange);
+    // Set up context consumption in connectedCallback
+    this._contextConsumer = new s$2(this, {
+      context: MenuContext,
+      callback: this.attachTo.bind(this),
+      subscribe: true
+    });
 
-    super.disconnectedCallback();
+    // Establish the key property as early as possible.
+    // When a framework (e.g. Svelte) inserts the element into the DOM before
+    // setting its `value` property, both `getAttribute('value')` and
+    // `getAttribute('key')` return null here. Setting `this.key = null`
+    // would block the fallback in `updated()` that assigns key from the
+    // value property (the guard checked `=== undefined`). Only assign key
+    // if at least one source attribute is actually present so that the
+    // `updated()` fallback can run when the value property arrives later.
+    const valueAttr = this.getAttribute('value');
+    const keyAttr = this.getAttribute('key');
+    const resolvedKey = keyAttr !== null ? keyAttr : valueAttr;
+    if (resolvedKey !== null) {
+      this.key = resolvedKey;
+    }
   }
 
   firstUpdated() {
-    AuroLibraryRuntimeUtils.prototype.handleComponentTagRename(this, 'auro-menu');
+    // Add the tag name as an attribute if it is different than the component name
+    this.runtimeUtils.handleComponentTagRename(this, 'auro-menuoption');
 
-    this.loadingSlots = this.querySelectorAll("[slot='loadingText'], [slot='loadingIcon']");
-    this.initializeMenu();
-  }
+    // Generate unique ID if not already set (required for aria-activedescendant)
+    if (!this.id) {
+      menuOptionIdCounter += 1;
+      this.id = `menuoption-${menuOptionIdCounter}`;
+    }
+
+    this.setAttribute('role', 'option');
+    this.setAttribute('aria-selected', 'false');
 
+    this.addEventListener('mouseover', () => {
+      this.dispatchEvent(new CustomEvent('auroMenuOption-mouseover', {
+        bubbles: true,
+        cancelable: false,
+        composed: true,
+        detail: this
+      }));
+    });
+  }
 
   updated(changedProperties) {
     super.updated(changedProperties);
 
-    // Apply value selection synchronously so that static-HTML fixtures
-    // resolve within a single update cycle.  The refactored selectByValue
-    // no longer calls reset() first, so the destructive intermediate-event
-    // cascade that originally required deferral is eliminated.  If option
-    // keys are not yet resolved (framework mount-order race), selectByValue
-    // queues a bounded retry automatically via queuePendingValue.
-    if (changedProperties.has('value') && !this.internalUpdateInProgress) {
-      this.menuService.selectByValue(this.value);
-    }
+    // Update aria-selected attribute if selected changed
+    if (changedProperties.has('selected')) {
 
-    // Handle loading state changes
-    if (changedProperties.has('loading')) {
-      this.setLoadingState(this.loading);
+      // Update aria-selected attribute
+      this.setAttribute('aria-selected', this.selected.toString());
+
+      // Update menu service selection state if this isn't an internal update
+      if (this.internalUpdateInProgress !== true && this.menuService) {
+        this.menuService[this.selected ? 'selectOption' : 'deselectOption'](this);
+      }
     }
 
-    if (changedProperties.has('multiSelect') && this.rootMenu) {
-      if (this.multiSelect) {
-        this.setAttribute('aria-multiselectable', 'true');
+    if (changedProperties.has('disabled')) {
+      if (this.disabled) {
+        this.setAttribute('aria-disabled', 'true');
       } else {
-        this.removeAttribute('aria-multiselectable');
+        this.removeAttribute('aria-disabled');
       }
     }
+
+    if (changedProperties.has('active')) {
+      this.updateActiveClasses();
+    }
+
+    // Update text highlight if matchWord changed
+    if (changedProperties.has('matchWord')) {
+      this.updateTextHighlight();
+    }
+
+    // Set the key to be the passed value if no key is provided.
+    // Loose equality (== null) is intentional: it catches both null AND
+    // undefined. When a framework (e.g. Svelte, React) inserts the element
+    // before setting its value property, connectedCallback skips key
+    // assignment because both attributes are null at that point. The Lit
+    // property default for `key` is undefined (not null), so strict
+    // === null would miss the case and the fallback would never run.
+    if (changedProperties.has('value') && this.key == null) { // eslint-disable-line eqeqeq, no-eq-null
+      this.key = this.value;
+    }
+  }
+
+  disconnectedCallback() {
+    if (this.menuService) {
+      this.menuService.unsubscribe(this.handleMenuChange);
+      this.menuService.removeMenuOption(this);
+    }
   }
 
   /**
-   * Sets an attribute that matches the default tag name if the tag name is not the default.
-   * @param {string} tagName - The tag name to set as an attribute.
-   * @private
+   * Sets up event listeners for user interaction with the menu option.
+   * This function enables click and mouse enter events to trigger selection and highlighting logic.
    */
-  setTagAttribute(tagName) {
-    if (this.tagName.toLowerCase() !== tagName) {
-      this.setAttribute(tagName, true);
-    }
+  bindEvents() {
+    this.addEventListener('click', this.handleClick.bind(this));
+    this.addEventListener('mouseenter', this.handleMouseEnter.bind(this));
   }
 
   /**
-   * Sets the loading state and dispatches a loading change event.
-   * @param {boolean} isLoading - Whether the menu is loading.
-   * @protected
+   * Attaches this menu option to a menu service and subscribes to its events.
+   * This method enables the option to participate in menu selection and highlighting logic.
+   * @param {Object} service - The menu service instance to attach to.
    */
-  setLoadingState(isLoading) {
-    this.setAttribute("aria-busy", isLoading);
-    dispatchMenuEvent(this, "auroMenu-loadingChange", {
-      loading: isLoading,
-      hasLoadingPlaceholder: this.hasLoadingPlaceholder
-    });
+  attachTo(service) {
+    if (!service) {
+      return;
+    }
+    this.menuService = service;
+    this.menuService.addMenuOption(this);
+    this.menuService.subscribe(this.handleMenuChange);
   }
 
-  // Init Methods
+  /**
+   * Handles changes from the menu service and updates the option's state.
+   * This function synchronizes the option's properties and selection/highlight state with menu events.
+   * @param {Object} event - The event object from the menu service.
+   */
+  handleMenuChange(event) {
+
+    // Ignore events without a type or property
+    if (!event || (!event.type && !event.property)) {
+      return;
+    }
+
+    // Update reactive properties based on event type
+    if (event.property && Object.keys(AuroMenuOption.properties).includes(event.property)) {
+      this[event.property] = event.value;
+    }
+
+    // Handle highlight changes
+    if (event.type === 'highlightChange') {
+      const isActive = event.option === this;
+      this.active = isActive;
+      this.updateActiveClasses();
+    }
+
+    if (event.type === 'stateChange') {
+      const isSelected = event.selectedOptions.includes(this);
+      this.setInternalSelected(isSelected);
+    }
+  }
 
   /**
-   * Initializes the menu's state and structure.
-   * @private
+   * Updates the internal selected state of the menu option bypassing 'updated' and triggers custom events if selected.
+   * This function ensures the option's selection state is synchronized with menu logic and notifies listeners.
+   * @param {boolean} isSelected - Whether the option should be marked as selected.
    */
-  initializeMenu() {
-    if (this.rootMenu) {
-      this.setAttribute('role', 'listbox');
-      this.setAttribute('root', '');
+  setInternalSelected(isSelected) {
+    this.internalUpdateInProgress = true;
+    this.selected = isSelected;
 
-      if (this.multiSelect) {
-        this.setAttribute('aria-multiselectable', 'true');
-      }
+    // Fire custom event if selected
+    if (isSelected) {
+      this.handleCustomEvent();
     }
 
-    this.handleNestedMenus(this);
+    setTimeout(() => {
+      this.internalUpdateInProgress = false;
+    }, 0);
   }
 
   /**
-   * Selects the currently highlighted option.
-   * @protected
+   * Sets the selected state of the menu option.
+   * This function updates whether the option is currently selected.
+   * @param {boolean} isSelected - Whether the option should be marked as selected.
+   * @deprecated Simply modify the `selected` property directly instead.
    */
-  makeSelection() {
-    this.menuService.selectHighlightedOption();
+  setSelected(isSelected) {
+    this.selected = isSelected;
   }
 
   /**
-   * Resets all options to their default state.
-   * @private
+   * Updates the active state and visual highlighting of the menu option.
+   * This function toggles the option's active status and applies or removes the active CSS class.
+   * @param {boolean} isActive - Whether the option should be marked as active.
+   * @deprecated Simply modify the `active` property directly instead.
    */
-  clearSelection() {
-    this.optionSelected = undefined;
-    this.value = undefined;
-    this._index = -1;
+  updateActive(isActive) {
+
+    // Set active state
+    this.active = isActive;
+    this.updateActiveClasses();
   }
 
   /**
-   * Resets the menu to its initial state.
-   * This is the only way to return value to undefined.
-   * @public
+   * Updates the CSS class for the menu option based on its active state.
+   * This function adds or removes the 'active' class to visually indicate the option's active status.
+   * @private
    */
-  reset() {
-    this.menuService.reset();
-
-    // Dispatch reset event
-    dispatchMenuEvent(this, 'auroMenu-selectValueReset');
+  updateActiveClasses() {
+    // Update class based on active state
+    if (this.active) this.classList.add('active');
+    else this.classList.remove('active');
   }
 
+
   /**
-   * Handles nested menu structure.
+   * Updates the visual highlighting of text within the menu option based on the current match word.
+   * This function highlights matching text segments and manages nested spacers for display formatting.
    * @private
-   * @param {HTMLElement} menu - Root menu element.
    */
-  handleNestedMenus(menu) {
-    menu.level = menu.parentElement.level >= 0 ? menu.parentElement.level + 1 : 0;
+  updateTextHighlight() {
 
-    if (menu.level > 0) {
-      menu.setAttribute('role', 'group');
-      menu.removeAttribute("root");
-      if (!menu.hasAttribute('aria-label')) {
-        menu.setAttribute('aria-label', 'submenu');
-      }
+    // Regex for matchWord if needed
+    let regexWord = null;
+
+    if (this.matchWord && this.matchWord.length) {
+      const escapedWord = this.matchWord.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+      regexWord = new RegExp(escapedWord, 'giu');
     }
 
-    const options = menu.querySelectorAll(':scope > auro-menuoption, :scope > [auro-menuoption]');
-    options.forEach((option) => {
-      const regex = new RegExp(this.nestingSpacer, "gu");
-      option.innerHTML = this.nestingSpacer.repeat(menu.level) + option.innerHTML.replace(regex, '');
-    });
-  }
+    // Update text highlighting if matchWord changed
+    if (regexWord &&
+      this.isActive && !this.hasAttribute('persistent')) {
+      const nested = this.querySelectorAll('.nestingSpacer');
 
-  /**
-   * Navigates the menu options in the specified direction.
-   * @param {'up'|'down'} direction - The direction to navigate.
-   * @protected
-   */
-  navigateOptions(direction) {
-    if (direction === 'up') {
-      this.menuService.highlightPrevious();
-    } else if (direction === 'down') {
-      this.menuService.highlightNext();
-    }
-  }
+      const displayValueEl = this.querySelector('[slot="displayValue"]');
+      if (displayValueEl) {
+        this.removeChild(displayValueEl);
+      }
 
-  /**
-   * Handles slot change events.
-   * @private
-   */
-  handleSlotChange() {
-    if (this.rootMenu) {
-      this.initializeMenu();
+      // Create nested spacers
+      const nestingSpacerBundle = [...nested].map(() => this.nestingSpacer).join('');
+
+      // Update with spacers and matchWord
+      this.innerHTML = nestingSpacerBundle +
+        this.textContent.replace(
+          regexWord,
+          (match) => `<strong>${match}</strong>`
+        );
+      if (displayValueEl) {
+        this.append(displayValueEl);
+      }
     }
   }
 
   /**
-   * Handles custom events defined on options.
+   * Handles click events on the menu option, toggling its selected state.
+   * This function dispatches a click event and updates selection if the option is not disabled.
    * @private
-   * @param {HTMLElement} option - Option with custom event.
    */
-  handleCustomEvent(option) {
-    const eventName = option.getAttribute('event');
-    dispatchMenuEvent(this, eventName);
-    dispatchMenuEvent(this, 'auroMenu-customEventFired');
+  handleClick() {
+    if (!this.disabled && !this.menuService?.disabled) {
+      this.dispatchClickEvent();
+      this.selected = !this.selected;
+    }
   }
 
   /**
-   * Notifies selection change to parent components.
-   * @param {any} source - The source that triggers this event.
+   * Handles mouse enter events to highlight the menu option.
+   * This function updates the menu service to set this option as the currently highlighted item if not disabled.
    * @private
    */
-  notifySelectionChange({value, stringValue, keys, options, reason} = {}) {
-    dispatchMenuEvent(this, 'auroMenu-selectedOption', {
-      value,
-      stringValue,
-      keys,
-      options,
-      reason
-    });
+  handleMouseEnter() {
+    if (!this.disabled) {
+      this.menuService.setHighlightedOption(this);
+    }
   }
 
   /**
-   * Checks if an option is currently selected.
+   * Dispatches custom events defined for this menu option.
+   * This function notifies listeners when a custom event is triggered by the option.
    * @private
-   * @param {HTMLElement} option - The option to check.
-   * @returns {boolean}
    */
-  isOptionSelected(option) {
-    if (!this.optionSelected) {
-      return false;
-    }
-
-    if (this.multiSelect) {
-      // In multi-select mode, check if the option is in the selected array
-      return Array.isArray(this.optionSelected) && this.optionSelected.some((selectedOption) => selectedOption === option);
+  handleCustomEvent() {
+    if (this.event) {
+      dispatchMenuEvent(this, this.event, { option: this });
+      dispatchMenuEvent(this, 'auroMenu-customEventFired', { option: this });
     }
-
-    return this.optionSelected === option;
   }
 
   /**
-   * Getter for loading placeholder state.
-   * @returns {boolean} - True if loading slots are present and non-empty.
+   * Dispatches a click event for this menu option.
+   * This function notifies listeners that the option has been clicked.
+   * @private
    */
-  get hasLoadingPlaceholder() {
-    return this.loadingSlots && this.loadingSlots.length > 0;
+  dispatchClickEvent() {
+    this.dispatchEvent(new CustomEvent('auroMenuOption-click', {
+      bubbles: true,
+      cancelable: false,
+      composed: true,
+      detail: this
+    }));
   }
 
   /**
-   * Getter for wrapper classes based on size.
-   * @returns {Object} - Class map for the wrapper element.
+   * Generates an HTML element containing an SVG icon based on the provided `svgContent`.
+   *
    * @private
+   * @param {string} svgContent - The SVG content to be embedded.
+   * @returns {Element} The HTML element containing the SVG icon.
    */
-  get wrapperClasses() {
-    return e({
-      'menuWrapper': true,
-      [this.size]: true,
-    });
+  generateIconHtml(svgContent) {
+    const dom = new DOMParser().parseFromString(svgContent, 'text/html');
+    const svg = dom.body.firstChild;
+
+    svg.setAttribute('slot', 'svg');
+
+    return u$1`<${this.iconTag} customColor customSvg>${svg}</${this.iconTag}>`;
   }
 
   /**
@@ -2261,26 +2262,26 @@ class AuroMenu extends AuroElement {
    * @returns {void}
    */
   renderLayout() {
-    if (this.loading) {
-      return b`
-        <div class="${this.wrapperClasses}">
-          <auro-menuoption
-            disabled
-            loadingplaceholder
-            class="${this.hasLoadingPlaceholder ? "" : "empty"}"
-          >
-            <div>
-              <slot name="loadingIcon" class="body-lg"></slot>
-              <slot name="loadingText"></slot>
-            </div>
-          </auro-menuoption>
-        </div>
-      `;
-    }
 
-    return b`
-      <div class="${this.wrapperClasses}">
-        <slot @slotchange=${this.handleSlotChange}></slot>
+    const fontClassMap = {
+      xs: 'body-sm',
+      sm: 'body-default',
+      md: 'body-default',
+      lg: 'body-lg',
+      xl: 'body-lg'
+    };
+
+    const classes = e({
+      'wrapper': true,
+      [this.size ? fontClassMap[this.size] : 'body-sm']: true,
+    });
+
+    return u$1`
+      <div class="${classes}">
+        ${this.selected && !this.noCheckmark
+        ? this.generateIconHtml(checkmarkIcon.svg)
+        : undefined}
+        <slot></slot>
       </div>
     `;
   }