@aurodesignsystem-dev/auro-formkit 0.0.0-pr1504.0 → 0.0.0-pr1506.0

package/custom-elements.json

@@ -1256,6 +1256,26 @@
               "description": "Update displayValue or input.value, it's called when making a selection.",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "syncInputValuesAcrossTriggerAndBib",
+              "parameters": [
+                {
+                  "name": "nextValue",
+                  "description": "The value to write to both inputs.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Writes nextValue to the trigger input and the bib input when their current\nvalue differs, then re-asserts imask after Lit's update flushes.",
+              "return": {
+                "type": {
+                  "text": "Promise<void> | null"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "handleMenuOptions",
@@ -2454,7 +2474,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
+          "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
         }
       ],
       "exports": [
@@ -11696,6 +11716,30 @@
                 "module": "components/input/src/base-input.js"
               }
             },
+            {
+              "kind": "method",
+              "name": "_computeDateObjectFallback",
+              "parameters": [
+                {
+                  "name": "dateStr",
+                  "description": "ISO date string from `value`/`min`/`max`.",
+                  "type": {
+                    "text": "string|undefined"
+                  }
+                }
+              ],
+              "description": "Parses a date string into a Date object when the corresponding `_*Object`\nfield hasn't been synced yet by `updated()`. Returns undefined when the\ninput type/format isn't a full date or the string is not a valid date.\n\nWhy this exists: a parent (datepicker) can call `inputN.validate()` from\ninside its own `updated()` before this input's `updated()` has run\n`syncDateValues()` — so `_valueObject`/`_maxObject` are still `undefined`\nand range checks would otherwise silently no-op (flipping the result to\n`valid` or `patternMismatch`).",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Date|undefined"
+                }
+              },
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
             {
               "kind": "method",
               "name": "setDateObjectProperty",
@@ -13783,6 +13827,26 @@
               },
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "_computeDateObjectFallback",
+              "parameters": [
+                {
+                  "name": "dateStr",
+                  "description": "ISO date string from `value`/`min`/`max`.",
+                  "type": {
+                    "text": "string|undefined"
+                  }
+                }
+              ],
+              "description": "Parses a date string into a Date object when the corresponding `_*Object`\nfield hasn't been synced yet by `updated()`. Returns undefined when the\ninput type/format isn't a full date or the string is not a valid date.\n\nWhy this exists: a parent (datepicker) can call `inputN.validate()` from\ninside its own `updated()` before this input's `updated()` has run\n`syncDateValues()` — so `_valueObject`/`_maxObject` are still `undefined`\nand range checks would otherwise silently no-op (flipping the result to\n`valid` or `patternMismatch`).",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Date|undefined"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "setDateObjectProperty",
@@ -15969,882 +16033,386 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/menu/src/auro-menu.context.js",
+      "path": "components/menu/src/auro-menu.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "",
-          "name": "MenuService",
+          "description": "The `auro-menu` element provides users a way to select from a list of options.",
+          "name": "AuroMenu",
+          "slots": [
+            {
+              "description": "Text to show while loading attribute is set",
+              "name": "loadingText"
+            },
+            {
+              "description": "Icon to show while loading attribute is set",
+              "name": "loadingIcon"
+            },
+            {
+              "description": "Slot for insertion of menu options.",
+              "name": ""
+            }
+          ],
           "members": [
+            {
+              "kind": "method",
+              "name": "register",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "default": "\"auro-menu\"",
+                  "description": "The name of element that you want to register to.",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "This will register this element with the browser."
+            },
             {
               "kind": "field",
-              "name": "menuOptions",
-              "description": "Gets the list of registered menu options.",
+              "name": "options",
+              "readonly": true,
               "return": {
                 "type": {
-                  "text": "AuroMenuOption[]"
+                  "text": "Array<HTMLElement>"
                 }
-              },
-              "readonly": true
+              }
             },
             {
               "kind": "field",
-              "name": "highlightedOption",
-              "description": "Gets the currently highlighted option.",
+              "name": "index",
               "return": {
                 "type": {
-                  "text": "AuroMenuOption|null"
+                  "text": "number"
                 }
               },
-              "readonly": true
+              "parameters": [
+                {
+                  "description": "Sets the index of the currently active option.",
+                  "name": "value",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
             },
             {
               "kind": "field",
-              "name": "currentValue",
-              "description": "Gets the current value(s) of the selected option(s).",
+              "name": "selectedOptions",
+              "description": "Gets the currently selected options as an array.",
               "return": {
                 "type": {
-                  "text": "string|string[]|undefined"
+                  "text": "Array<HTMLElement>"
                 }
               },
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "currentLabel",
-              "description": "Gets the label(s) of the currently selected option(s).",
+              "name": "selectedOption",
+              "description": "Gets the first selected option, or null if none.",
               "return": {
                 "type": {
-                  "text": "string"
+                  "text": "HTMLElement|null"
                 }
               },
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "stringValue",
-              "description": "Gets the string representation of the current value(s).\nFor multi-select, this is a JSON stringified array.",
+              "name": "currentLabel",
+              "readonly": true,
               "return": {
                 "type": {
-                  "text": "string|undefined"
+                  "text": "string"
                 }
-              },
-              "readonly": true
+              }
             },
             {
               "kind": "field",
-              "name": "currentKeys",
-              "description": "Gets the key(s) of the currently selected option(s).",
+              "name": "formattedValue",
+              "description": "Formatted value based on `multiSelect` state.\nDefault type is `String`, changing to `Array<String>` when `multiSelect` is true.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "string|string[]|undefined"
+                  "text": "String|Array<String>"
                 }
               },
               "readonly": true
             },
             {
               "kind": "method",
-              "name": "hostUpdated",
-              "description": "Handles host updates.\nThis is a lit reactive lifecycle method.\nThis comes from the Lit controller interface provided by adding this service as a controller to the host.\nSee constructor for `this.host.addController(this)`\nYou can read more about Lit reactive controllers here: https://lit.dev/docs/composition/controllers/"
-            },
-            {
-              "kind": "method",
-              "name": "hostDisconnected",
-              "description": "Handles host disconnection and memory cleanup."
+              "name": "selectByValue",
+              "parameters": [
+                {
+                  "name": "value",
+                  "description": "The value(s) to select.",
+                  "type": {
+                    "text": "string|string[]|undefined|null"
+                  }
+                }
+              ],
+              "description": "Selects options by value.",
+              "privacy": "public"
             },
             {
               "kind": "method",
-              "name": "setProperty",
+              "name": "setTagAttribute",
               "parameters": [
                 {
-                  "name": "property",
+                  "name": "tagName",
+                  "description": "The tag name to set as an attribute.",
                   "type": {
                     "text": "string"
                   }
-                },
-                {
-                  "name": "value",
-                  "type": {
-                    "text": "any"
-                  }
                 }
               ],
-              "description": "Sets a property value if it exists on the instance and the value has changed."
+              "description": "Sets an attribute that matches the default tag name if the tag name is not the default.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "setProperties",
+              "name": "updateItemsState",
               "parameters": [
                 {
-                  "name": "properties",
-                  "description": "Key-value pairs of properties to set.",
+                  "name": "changedProperties",
+                  "description": "LitElement's changed properties map.",
                   "type": {
-                    "text": "Object"
+                    "text": "Map<string, boolean>"
                   }
                 }
               ],
-              "description": "Sets multiple properties on the instance."
+              "description": "Updates the UI state and appearance of menu items based on changed properties.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "highlightNext",
-              "description": "Highlights the next active option in the menu."
+              "name": "initializeMenu",
+              "description": "Initializes the menu's state and structure.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "highlightPrevious",
-              "description": "Highlights the previous active option in the menu."
+              "name": "initItems",
+              "description": "Initializes menu items and their attributes.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "moveHighlightedOption",
+              "name": "handleSelectState",
               "parameters": [
                 {
-                  "name": "direction",
-                  "description": "The direction to move the highlight (\"next\" or \"previous\").",
+                  "name": "option",
+                  "description": "The option element to select.",
                   "type": {
-                    "text": "string"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Moves the highlighted option in the specified direction."
+              "description": "Updates menu state when an option is selected.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "setHighlightedOption",
+              "name": "handleDeselectState",
               "parameters": [
                 {
                   "name": "option",
-                  "description": "The option to highlight.",
+                  "description": "The menuoption to be deselected.",
                   "type": {
-                    "text": "AuroMenuOption"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Sets the highlighted index to the specified option."
+              "description": "Deselects a menu option and updates related state.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "setHighlightedIndex",
-              "parameters": [
-                {
-                  "name": "index",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ],
-              "description": "Sets the highlighted option to the option at the specified index if it exists."
+              "name": "clearSelection",
+              "description": "Resets all options to their default state.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "selectHighlightedOption",
-              "description": "Selects the currently highlighted option."
+              "name": "reset",
+              "description": "Resets the menu to its initial state.\nThis is the only way to return value to undefined.",
+              "privacy": "public"
             },
             {
               "kind": "method",
-              "name": "selectOptions",
+              "name": "handleNestedMenus",
               "parameters": [
                 {
-                  "name": "options",
-                  "description": "Single option or array of options to select",
+                  "name": "menu",
+                  "description": "Root menu element.",
                   "type": {
-                    "text": "AuroMenuOption|AuroMenuOption[]"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Selects one or more options in a batch operation"
+              "description": "Handles nested menu structure.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "deselectOptions",
-              "parameters": [
-                {
-                  "name": "options",
-                  "description": "Single option or array of options to deselect",
-                  "type": {
-                    "text": "AuroMenuOption|AuroMenuOption[]"
-                  }
-                }
-              ],
-              "description": "Deselects one or more options in a batch operation"
+              "name": "makeSelection",
+              "description": "Makes a selection based on the current index.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "selectOption",
+              "name": "toggleOption",
               "parameters": [
                 {
                   "name": "option",
+                  "description": "The menuoption to toggle.",
                   "type": {
-                    "text": "AuroMenuOption"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Selects a single option."
+              "description": "Toggle the selection state of the menuoption.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "deselectOption",
+              "name": "handleKeyDown",
               "parameters": [
                 {
-                  "name": "option",
+                  "name": "event",
+                  "description": "The keydown event.",
                   "type": {
-                    "text": "AuroMenuOption"
+                    "text": "KeyboardEvent"
                   }
                 }
               ],
-              "description": "Deselects a single option."
+              "description": "Handles keyboard navigation and selection.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "toggleOption",
+              "name": "handleMouseSelect",
               "parameters": [
                 {
-                  "name": "option",
+                  "name": "event",
+                  "description": "The auroMenuOption-click event.",
                   "type": {
-                    "text": "AuroMenuOption"
+                    "text": "CustomEvent"
                   }
                 }
               ],
-              "description": "Toggles the selection state of a single option."
+              "description": "Handles option selection via click events from menuoptions.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "selectByValue",
+              "name": "handleOptionHover",
               "parameters": [
                 {
-                  "name": "value",
-                  "description": "The value(s) to select.",
+                  "name": "event",
+                  "description": "Event object from the browser.",
                   "type": {
-                    "text": "string|number|Array<string|number>"
+                    "text": "CustomEvent"
                   }
                 }
               ],
-              "description": "Selects options based on their value(s) when compared to a passed value or values.\nValue or values are normalized to an array of strings that can be matched to option keys."
+              "description": "Handles option hover events.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleSlotChange",
+              "description": "Handles slot change events.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "queuePendingValue",
+              "name": "navigateOptions",
               "parameters": [
                 {
-                  "name": "value",
-                  "description": "The value to retry.",
+                  "name": "direction",
+                  "description": "'up' or 'down'.",
                   "type": {
-                    "text": "string|number|Array<string|number>"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Queues a pending value and schedules a bounded retry."
-            },
-            {
-              "kind": "method",
-              "name": "clearPendingValue",
-              "description": "Clears pending retry state."
-            },
-            {
-              "kind": "method",
-              "name": "reset",
-              "description": "Resets the selected options to an empty array."
+              "description": "Navigates through options using keyboard."
             },
             {
               "kind": "method",
-              "name": "subscribe",
+              "name": "updateActiveOption",
               "parameters": [
                 {
-                  "name": "callback",
-                  "description": "The callback to invoke on events.",
+                  "name": "indexOrOption",
+                  "description": "Index of the option or the option element to make active.",
                   "type": {
-                    "text": "Function"
+                    "text": "number|HTMLElement"
                   }
                 }
               ],
-              "description": "Subscribes a callback to menu service events."
+              "description": "Updates the active option state and dispatches events.\nAccepts either a numeric index or an HTMLElement option."
             },
             {
               "kind": "method",
-              "name": "unsubscribe",
+              "name": "handleCustomEvent",
               "parameters": [
                 {
-                  "name": "callback",
+                  "name": "option",
+                  "description": "Option with custom event.",
                   "type": {
-                    "text": "Function"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Remove a previously subscribed callback from menu service events."
+              "description": "Handles custom events defined on options.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "stageUpdate",
+              "name": "notifySelectionChange",
               "parameters": [
                 {
-                  "name": "meta",
-                  "default": "{}"
+                  "name": "source",
+                  "default": "undefined",
+                  "description": "The source that triggers this event.",
+                  "type": {
+                    "text": "any"
+                  }
                 }
               ],
-              "description": "Stages an update to notify subscribers of state and value changes."
+              "description": "Notifies selection change to parent components.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "notify",
+              "name": "selectionEquals",
               "parameters": [
                 {
-                  "name": "event",
-                  "description": "The event to send to subscribers.",
+                  "name": "current",
+                  "description": "Current selection.",
                   "type": {
-                    "text": "string"
+                    "text": "any"
+                  }
+                },
+                {
+                  "name": "next",
+                  "description": "New selection to compare.",
+                  "type": {
+                    "text": "any"
                   }
                 }
               ],
-              "description": "Notifies subscribers of a menu service event.\nAll notifications are sent to all subscribers."
-            },
-            {
-              "kind": "method",
-              "name": "notifyStateChange",
-              "parameters": [
-                {
-                  "name": "meta",
-                  "default": "{}"
-                }
-              ],
-              "description": "Notifies subscribers of a state change (selected options has changed)."
-            },
-            {
-              "kind": "method",
-              "name": "notifyValueChange",
-              "parameters": [
-                {
-                  "name": "meta",
-                  "default": "{}"
-                }
-              ],
-              "description": "Notifies subscribers of a value change (current value has changed)."
-            },
-            {
-              "kind": "method",
-              "name": "dispatchChangeEvent",
-              "parameters": [
-                {
-                  "name": "eventName",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "detail",
-                  "type": {
-                    "text": "any"
-                  }
-                }
-              ],
-              "description": "Dispatches a custom event from the host element."
-            },
-            {
-              "kind": "method",
-              "name": "addMenuOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "the option to track",
-                  "type": {
-                    "text": "AuroMenuOption"
-                  }
-                }
-              ],
-              "description": "Adds a menu option to the service's list."
-            },
-            {
-              "kind": "method",
-              "name": "removeMenuOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "the option to remove",
-                  "type": {
-                    "text": "AuroMenuOption"
-                  }
-                }
-              ],
-              "description": "Removes a menu option from the service's list."
-            },
-            {
-              "kind": "method",
-              "name": "_getNormalizedValues",
-              "parameters": [
-                {
-                  "name": "value",
-                  "description": "The value(s) to normalize.",
-                  "type": {
-                    "text": "string|number|Array<string|number>"
-                  }
-                }
-              ],
-              "description": "Normalizes a value or array of values into an array of strings for option selection.\nThis function ensures that input values are consistently formatted for matching menu options.",
-              "return": {
-                "type": {
-                  "text": "Array<string>"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "optionsArraysMatch",
-              "parameters": [
-                {
-                  "name": "arr1",
-                  "description": "First array of options.",
-                  "type": {
-                    "text": "AuroMenuOption[]"
-                  }
-                },
-                {
-                  "name": "arr2",
-                  "description": "Second array of options.",
-                  "type": {
-                    "text": "AuroMenuOption[]"
-                  }
-                }
-              ],
-              "description": "Returns whether two arrays of options contain the same elements.",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "host",
-              "default": "host"
-            },
-            {
-              "kind": "field",
-              "name": "size",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "shape",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "noCheckmark",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "disabled",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "matchWord",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "multiSelect",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "allowDeselect",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "selectAllMatchingOptions",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "highlightedIndex",
-              "type": {
-                "text": "number"
-              },
-              "default": "-1"
-            },
-            {
-              "kind": "field",
-              "name": "_menuOptions",
-              "type": {
-                "text": "array"
-              },
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "_subscribers",
-              "type": {
-                "text": "array"
-              },
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "internalUpdateInProgress",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "selectedOptions",
-              "type": {
-                "text": "array"
-              },
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "_pendingValue",
-              "type": {
-                "text": "null"
-              },
-              "default": "null"
-            },
-            {
-              "kind": "field",
-              "name": "_pendingRetryScheduled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "_pendingRetryCount",
-              "type": {
-                "text": "number"
-              },
-              "default": "0"
-            }
-          ]
-        },
-        {
-          "kind": "variable",
-          "name": "MenuContext"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "MenuService",
-          "declaration": {
-            "name": "MenuService",
-            "module": "components/menu/src/auro-menu.context.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "MenuContext",
-          "declaration": {
-            "name": "MenuContext",
-            "module": "components/menu/src/auro-menu.context.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/menu/src/auro-menu.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "The `auro-menu` element provides users a way to select from a list of options.",
-          "name": "AuroMenu",
-          "slots": [
-            {
-              "description": "Text to show while loading attribute is set",
-              "name": "loadingText"
-            },
-            {
-              "description": "Icon to show while loading attribute is set",
-              "name": "loadingIcon"
-            },
-            {
-              "description": "Slot for insertion of menu options.",
-              "name": ""
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "currentLabel",
-              "readonly": true,
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "items",
-              "readonly": true,
-              "return": {
-                "type": {
-                  "text": "Array<HTMLElement>"
-                }
-              },
-              "deprecated": "Use `options` property instead."
-            },
-            {
-              "kind": "field",
-              "name": "index",
-              "return": {
-                "type": {
-                  "text": "number"
-                }
-              },
-              "parameters": [
-                {
-                  "description": "Sets the index of the currently active option.",
-                  "name": "value",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "register",
-              "static": true,
-              "parameters": [
-                {
-                  "name": "name",
-                  "default": "\"auro-menu\"",
-                  "description": "The name of the element that you want to register.",
-                  "optional": true,
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "This will register this element with the browser."
-            },
-            {
-              "kind": "field",
-              "name": "formattedValue",
-              "description": "Formatted value based on `multiSelect` state.\nDefault type is `String`, changing to `Array<String>` when `multiSelect` is true.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "String|Array<String>"
-                }
-              },
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "propertyValues",
-              "description": "Gets the current property values for the menu service.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Object"
-                }
-              },
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "provideContext",
-              "description": "Provides the menu context to child components.\nInitializes the MenuService and subscribes to menu changes.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "updateActiveOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "The option to set as active.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Updates the currently active option in the menu."
-            },
-            {
-              "kind": "method",
-              "name": "setInternalValue",
-              "parameters": [
-                {
-                  "name": "value",
-                  "description": "The value to set.",
-                  "type": {
-                    "text": "String|Array<String>"
-                  }
-                }
-              ],
-              "description": "Sets the internal value and manages update state.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "handleMenuChange",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The event object from the menu service.",
-                  "type": {
-                    "text": "Object"
-                  }
-                }
-              ],
-              "description": "Handles changes from the menu service and updates component state.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "field",
-              "name": "selectedOptions",
-              "description": "Gets the currently selected options.",
-              "return": {
-                "type": {
-                  "text": "Array<HTMLElement>"
-                }
-              },
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "selectedOption",
-              "description": "Gets the first selected option, or null if none.",
-              "return": {
-                "type": {
-                  "text": "HTMLElement|null"
-                }
-              },
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "setTagAttribute",
-              "parameters": [
-                {
-                  "name": "tagName",
-                  "description": "The tag name to set as an attribute.",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Sets an attribute that matches the default tag name if the tag name is not the default.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "setLoadingState",
-              "parameters": [
-                {
-                  "name": "isLoading",
-                  "description": "Whether the menu is loading.",
-                  "type": {
-                    "text": "boolean"
-                  }
-                }
-              ],
-              "description": "Sets the loading state and dispatches a loading change event.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "initializeMenu",
-              "description": "Initializes the menu's state and structure.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "makeSelection",
-              "description": "Selects the currently highlighted option.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "clearSelection",
-              "description": "Resets all options to their default state.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "reset",
-              "description": "Resets the menu to its initial state.\nThis is the only way to return value to undefined.",
-              "privacy": "public"
-            },
-            {
-              "kind": "method",
-              "name": "handleNestedMenus",
-              "parameters": [
-                {
-                  "name": "menu",
-                  "description": "Root menu element.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Handles nested menu structure.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "navigateOptions",
-              "parameters": [
-                {
-                  "name": "direction",
-                  "description": "The direction to navigate.",
-                  "type": {
-                    "text": "'up'|'down'"
-                  }
-                }
-              ],
-              "description": "Navigates the menu options in the specified direction.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "handleSlotChange",
-              "description": "Handles slot change events.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "handleCustomEvent",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "Option with custom event.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Handles custom events defined on options.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "notifySelectionChange",
-              "parameters": [
-                {
-                  "name": "{value, stringValue, keys, options, reason}",
-                  "default": "{}"
-                },
-                {
-                  "description": "The source that triggers this event.",
-                  "name": "source",
-                  "type": {
-                    "text": "any"
-                  }
-                }
-              ],
-              "description": "Notifies selection change to parent components.",
-              "privacy": "private"
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
             },
             {
               "kind": "method",
@@ -16869,18 +16437,13 @@
             {
               "kind": "field",
               "name": "hasLoadingPlaceholder",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
               "description": "Getter for loading placeholder state.",
               "return": {
                 "type": {
                   "text": "boolean"
                 }
               },
-              "readonly": true,
-              "attribute": "hasLoadingPlaceholder"
+              "readonly": true
             },
             {
               "kind": "field",
@@ -16914,7 +16477,6 @@
               },
               "attribute": "shape",
               "reflects": true,
-              "description": "Sets the shape of the menu.",
               "default": "\"box\"",
               "inheritedFrom": {
                 "name": "AuroElement",
@@ -16930,13 +16492,24 @@
               },
               "attribute": "size",
               "reflects": true,
-              "description": "Sets the size of the menu.",
               "default": "\"sm\"",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "value",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.",
+              "default": "undefined",
+              "attribute": "value",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "optionSelected",
@@ -17006,30 +16579,6 @@
               "attribute": "multiselect",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "allowDeselect",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Allows deselecting an already selected option when clicked again in single-select mode.",
-              "default": "false",
-              "attribute": "allowDeselect",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "selectAllMatchingOptions",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "When true, selects all options that match the provided value/key when setting value and multiselect is enabled.",
-              "default": "false",
-              "attribute": "selectAllMatchingOptions",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "disabled",
@@ -17041,22 +16590,6 @@
               "attribute": "disabled",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "layout",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "Defines the language of an element.",
-              "default": "{'default'}",
-              "attribute": "layout",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
-            },
             {
               "kind": "field",
               "name": "level",
@@ -17066,27 +16599,6 @@
               },
               "description": "Indent level for submenus."
             },
-            {
-              "kind": "field",
-              "name": "options",
-              "privacy": "public",
-              "type": {
-                "text": "array"
-              },
-              "description": "Available menu options.",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "value",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.",
-              "attribute": "value",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "componentHasFocus",
@@ -17127,6 +16639,22 @@
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "layout",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Defines the language of an element.",
+              "default": "{'default'}",
+              "attribute": "layout",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
+            },
             {
               "kind": "field",
               "name": "onDark",
@@ -17177,13 +16705,6 @@
               "description": "Notifies that an attempt to select a menuoption by matching a value has failed.",
               "name": "auroMenu-selectValueFailure"
             },
-            {
-              "type": {
-                "text": "CustomEvent<{ values: HTMLElement[] }>"
-              },
-              "description": "Notifies that deselection was prevented and includes the affected options in `detail.values`.",
-              "name": "auroMenu-deselectPrevented"
-            },
             {
               "type": {
                 "text": "CustomEvent<any>"
@@ -17200,15 +16721,6 @@
             }
           ],
           "attributes": [
-            {
-              "name": "allowDeselect",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Allows deselecting an already selected option when clicked again in single-select mode.",
-              "default": "false",
-              "fieldName": "allowDeselect"
-            },
             {
               "name": "disabled",
               "type": {
@@ -17217,33 +16729,6 @@
               "description": "When true, the entire menu and all options are disabled.",
               "fieldName": "disabled"
             },
-            {
-              "name": "hasLoadingPlaceholder",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Getter for loading placeholder state.",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "readonly": true,
-              "fieldName": "hasLoadingPlaceholder"
-            },
-            {
-              "name": "layout",
-              "type": {
-                "text": "string"
-              },
-              "description": "Defines the language of an element.",
-              "default": "{'default'}",
-              "fieldName": "layout",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
-            },
             {
               "name": "loading",
               "type": {
@@ -17299,26 +16784,26 @@
               "fieldName": "optionSelected"
             },
             {
-              "name": "size",
+              "name": "value",
               "type": {
                 "text": "string"
               },
-              "fieldName": "size",
-              "description": "Sets the size of the menu.",
-              "default": "\"sm\"",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.",
+              "default": "undefined",
+              "fieldName": "value"
             },
             {
-              "name": "selectAllMatchingOptions",
+              "name": "layout",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "When true, selects all options that match the provided value/key when setting value and multiselect is enabled.",
-              "default": "false",
-              "fieldName": "selectAllMatchingOptions"
+              "description": "Defines the language of an element.",
+              "default": "{'default'}",
+              "fieldName": "layout",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
             },
             {
               "name": "shape",
@@ -17326,20 +16811,21 @@
                 "text": "string"
               },
               "fieldName": "shape",
-              "description": "Sets the shape of the menu.",
-              "default": "\"box\"",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
             {
-              "name": "value",
+              "name": "size",
               "type": {
                 "text": "string"
               },
-              "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.",
-              "fieldName": "value"
+              "fieldName": "size",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
             },
             {
               "name": "ondark",
@@ -17395,7 +16881,7 @@
                 {
                   "name": "name",
                   "default": "\"auro-menuoption\"",
-                  "description": "The name of the element that you want to register.",
+                  "description": "The name of element that you want to register to.",
                   "optional": true,
                   "type": {
                     "text": "string"
@@ -17407,7 +16893,7 @@
             {
               "kind": "field",
               "name": "isActive",
-              "description": "Returns whether the menu option is currently active and selectable.\nAn option is considered active if it is not hidden, not disabled, and not static.",
+              "description": "Returns whether the menu option is currently active and selectable.",
               "return": {
                 "type": {
                   "text": "boolean"
@@ -17417,115 +16903,34 @@
             },
             {
               "kind": "method",
-              "name": "bindEvents",
-              "description": "Sets up event listeners for user interaction with the menu option.\nThis function enables click and mouse enter events to trigger selection and highlighting logic."
-            },
-            {
-              "kind": "method",
-              "name": "attachTo",
-              "parameters": [
-                {
-                  "name": "service",
-                  "description": "The menu service instance to attach to.",
-                  "type": {
-                    "text": "Object"
-                  }
-                }
-              ],
-              "description": "Attaches this menu option to a menu service and subscribes to its events.\nThis method enables the option to participate in menu selection and highlighting logic."
-            },
-            {
-              "kind": "method",
-              "name": "handleMenuChange",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The event object from the menu service.",
-                  "type": {
-                    "text": "Object"
-                  }
-                }
-              ],
-              "description": "Handles changes from the menu service and updates the option's state.\nThis function synchronizes the option's properties and selection/highlight state with menu events."
-            },
-            {
-              "kind": "method",
-              "name": "setInternalSelected",
-              "parameters": [
-                {
-                  "name": "isSelected",
-                  "description": "Whether the option should be marked as selected.",
-                  "type": {
-                    "text": "boolean"
-                  }
-                }
-              ],
-              "description": "Updates the internal selected state of the menu option bypassing 'updated' and triggers custom events if selected.\nThis function ensures the option's selection state is synchronized with menu logic and notifies listeners."
+              "name": "handleMenuChange"
             },
             {
               "kind": "method",
               "name": "setSelected",
               "parameters": [
                 {
-                  "name": "isSelected",
-                  "description": "Whether the option should be marked as selected.",
-                  "type": {
-                    "text": "boolean"
-                  }
-                }
-              ],
-              "description": "Sets the selected state of the menu option.\nThis function updates whether the option is currently selected.",
-              "deprecated": "Simply modify the `selected` property directly instead."
-            },
-            {
-              "kind": "method",
-              "name": "updateActive",
-              "parameters": [
-                {
-                  "name": "isActive",
-                  "description": "Whether the option should be marked as active.",
-                  "type": {
-                    "text": "boolean"
-                  }
+                  "name": "value"
                 }
-              ],
-              "description": "Updates the active state and visual highlighting of the menu option.\nThis function toggles the option's active status and applies or removes the active CSS class.",
-              "deprecated": "Simply modify the `active` property directly instead."
-            },
-            {
-              "kind": "method",
-              "name": "updateActiveClasses",
-              "description": "Updates the CSS class for the menu option based on its active state.\nThis function adds or removes the 'active' class to visually indicate the option's active status.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "updateTextHighlight",
-              "description": "Updates the visual highlighting of text within the menu option based on the current match word.\nThis function highlights matching text segments and manages nested spacers for display formatting.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "handleClick",
-              "description": "Handles click events on the menu option, toggling its selected state.\nThis function dispatches a click event and updates selection if the option is not disabled.",
-              "privacy": "private"
+              ]
             },
             {
               "kind": "method",
-              "name": "handleMouseEnter",
-              "description": "Handles mouse enter events to highlight the menu option.\nThis function updates the menu service to set this option as the currently highlighted item if not disabled.",
-              "privacy": "private"
+              "name": "updateActive",
+              "parameters": [
+                {
+                  "name": "active"
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "handleCustomEvent",
-              "description": "Dispatches custom events defined for this menu option.\nThis function notifies listeners when a custom event is triggered by the option.",
-              "privacy": "private"
+              "name": "attachTo"
             },
             {
               "kind": "method",
-              "name": "dispatchClickEvent",
-              "description": "Dispatches a click event for this menu option.\nThis function notifies listeners that the option has been clicked.",
+              "name": "handleClick",
+              "description": "Handles click events on the menu option.",
               "privacy": "private"
             },
             {
@@ -17600,7 +17005,6 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Specifies that an option is selected.",
               "default": "false",
               "attribute": "selected",
               "reflects": true
@@ -17608,7 +17012,7 @@
             {
               "kind": "field",
               "name": "noCheckmark",
-              "privacy": "private",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
@@ -17623,7 +17027,6 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "When true, disables the menu option.",
               "default": "false",
               "attribute": "disabled",
               "reflects": true
@@ -17635,101 +17038,46 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "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.",
+              "description": "When true, marks this option as the \"no matching results\" placeholder shown by combobox\nwhen the user's input does not match any available options.",
               "default": "false",
               "attribute": "nomatch",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "runtimeUtils",
-              "privacy": "private",
-              "default": "new AuroLibraryRuntimeUtils()"
-            },
-            {
-              "kind": "field",
-              "name": "menuService",
-              "privacy": "private",
-              "type": {
-                "text": "null"
-              },
-              "default": "null",
-              "attribute": "menuService"
-            },
-            {
-              "kind": "field",
-              "name": "unsubscribe",
-              "type": {
-                "text": "null"
-              },
-              "default": "null"
-            },
-            {
-              "kind": "field",
-              "name": "event",
+              "name": "tabIndex",
               "privacy": "private",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "attribute": "event",
+              "default": "-1",
+              "attribute": "tabIndex",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "layout",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "Defines the language of an element.",
-              "default": "{'default'}",
-              "attribute": "layout",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "name": "runtimeUtils",
+              "privacy": "private",
+              "default": "new AuroLibraryRuntimeUtils()"
             },
             {
               "kind": "field",
-              "name": "key",
+              "name": "value",
               "privacy": "public",
               "type": {
                 "text": "string"
               },
-              "description": "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.",
-              "attribute": "key",
+              "attribute": "value",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "matchWord",
+              "name": "event",
               "privacy": "private",
               "type": {
                 "text": "string"
               },
-              "attribute": "matchWord"
-            },
-            {
-              "kind": "field",
-              "name": "tabIndex",
-              "privacy": "public",
-              "type": {
-                "text": "number"
-              },
-              "description": "Specifies the tab index of the menu option.",
-              "attribute": "tabIndex",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "value",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "Specifies the value to be sent to a server.",
-              "attribute": "value",
+              "attribute": "event",
               "reflects": true
             },
             {
@@ -17772,6 +17120,22 @@
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "layout",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Defines the language of an element.",
+              "default": "{'default'}",
+              "attribute": "layout",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
+            },
             {
               "kind": "field",
               "name": "onDark",
@@ -17799,103 +17163,78 @@
               "name": "auroMenuOption-click",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Notifies that this option has been clicked."
             }
           ],
           "attributes": [
             {
-              "name": "disabled",
+              "name": "noCheckmark",
               "type": {
                 "text": "boolean"
               },
-              "description": "When true, disables the menu option.",
               "default": "false",
-              "fieldName": "disabled"
+              "fieldName": "noCheckmark"
             },
             {
-              "name": "event",
+              "name": "selected",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "fieldName": "event"
+              "default": "false",
+              "fieldName": "selected"
             },
             {
-              "name": "layout",
+              "name": "disabled",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Defines the language of an element.",
-              "default": "{'default'}",
-              "fieldName": "layout",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "default": "false",
+              "fieldName": "disabled"
             },
             {
-              "name": "key",
+              "name": "value",
               "type": {
                 "text": "string"
               },
-              "description": "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.",
-              "fieldName": "key"
+              "fieldName": "value"
             },
             {
-              "name": "menuService",
+              "name": "tabIndex",
               "type": {
-                "text": "null"
+                "text": "number"
               },
-              "default": "null",
-              "fieldName": "menuService"
+              "default": "-1",
+              "fieldName": "tabIndex"
             },
             {
-              "name": "matchWord",
+              "name": "event",
               "type": {
                 "text": "string"
               },
-              "fieldName": "matchWord"
-            },
-            {
-              "name": "noCheckmark",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "noCheckmark"
+              "fieldName": "event"
             },
             {
               "name": "nomatch",
               "type": {
                 "text": "boolean"
               },
-              "description": "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.",
+              "description": "When true, marks this option as the \"no matching results\" placeholder shown by combobox\nwhen the user's input does not match any available options.",
               "default": "false",
               "fieldName": "noMatch"
             },
             {
-              "name": "selected",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Specifies that an option is selected.",
-              "default": "false",
-              "fieldName": "selected"
-            },
-            {
-              "name": "tabIndex",
-              "type": {
-                "text": "number"
-              },
-              "description": "Specifies the tab index of the menu option.",
-              "fieldName": "tabIndex"
-            },
-            {
-              "name": "value",
+              "name": "layout",
               "type": {
                 "text": "string"
               },
-              "description": "Specifies the value to be sent to a server.",
-              "fieldName": "value"
+              "description": "Defines the language of an element.",
+              "default": "{'default'}",
+              "fieldName": "layout",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
             },
             {
               "name": "shape",
@@ -19279,6 +18618,32 @@
               ],
               "description": "Updates the active option in the menu."
             },
+            {
+              "kind": "method",
+              "name": "_getOptionDisplayText",
+              "parameters": [
+                {
+                  "name": "option",
+                  "description": "The menu option element.",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Returns the lowercase, trimmed text content of a menu option.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_clearTypeaheadBuffer",
+              "description": "Empties the type-ahead buffer and cancels any pending reset timeout.\nCalled when focus leaves the component, when Escape closes the bib, and on disconnect\nso a stale buffer never bridges into a fresh interaction.",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "updateActiveOptionBasedOnKey",
@@ -19291,7 +18656,7 @@
                   }
                 }
               ],
-              "description": "Updates the active option in the menu based on keyboard input.",
+              "description": "Updates the active option in the menu based on keyboard input.\n\nImplements the WAI-ARIA APG Listbox type-ahead pattern: accumulates printable\nkeystrokes into a buffer that resets after `typeaheadTimeoutMs` of inactivity.\nA multi-character buffer matches the first option whose displayed text starts\nwith the buffer; repeating a single character cycles through options that start\nwith that character.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -19687,6 +19052,24 @@
               },
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "typeaheadBuffer",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "_typeaheadTimeout",
+              "type": {
+                "text": "null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "appearance",
@@ -19971,6 +19354,18 @@
               },
               "description": "Indicates whether the input is in a dirty state (has been interacted with)."
             },
+            {
+              "kind": "field",
+              "name": "typeaheadTimeoutMs",
+              "privacy": "public",
+              "type": {
+                "text": "number"
+              },
+              "description": "Milliseconds of keyboard inactivity before the type-ahead buffer resets.\nIncrease for users who type slowly.",
+              "default": "500",
+              "attribute": "typeaheadTimeoutMs",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "validity",
@@ -20323,6 +19718,15 @@
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "name": "typeaheadTimeoutMs",
+              "type": {
+                "text": "number"
+              },
+              "description": "Milliseconds of keyboard inactivity before the type-ahead buffer resets.\nIncrease for users who type slowly.",
+              "default": "500",
+              "fieldName": "typeaheadTimeoutMs"
+            },
             {
               "name": "validity",
               "type": {
@@ -20401,7 +19805,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const lastOption = [...component.menu.menuService.menuOptions].reverse().find((option) => !option.disabled); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, Enter(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const firstOption = component.menu.menuService.menuOptions.find((option) => !option.disabled); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { component.updateActiveOptionBasedOnKey(evt.key); if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (ctx.isExpanded) { component.dropdown.hide(); return; } component.dropdown.show(); } }, }"
+          "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, Enter(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
         }
       ],
       "exports": [
@@ -20414,6 +19818,68 @@
           }
         }
       ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/select/src/selectUtils.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getEnabledOptions",
+          "parameters": [
+            {
+              "name": "menu",
+              "description": "The auro-menu element.",
+              "type": {
+                "text": "HTMLElement | null | undefined"
+              }
+            }
+          ],
+          "description": "Returns the enabled (non-disabled) options for a menu, safely.\n\nAuro-menu's `options` getter returns `undefined` when the menu has no items\n(initItems sets `items` to undefined for empty menus). Callers that reach for\n`.find()` / `[...spread]` would otherwise crash; this helper normalizes the\nempty case to `[]` so array methods are always safe.",
+          "return": {
+            "type": {
+              "text": "Array<HTMLElement>"
+            }
+          }
+        },
+        {
+          "kind": "function",
+          "name": "getActiveOptions",
+          "parameters": [
+            {
+              "name": "menu",
+              "description": "The auro-menu element.",
+              "type": {
+                "text": "HTMLElement | null | undefined"
+              }
+            }
+          ],
+          "description": "Returns the active (selectable + visible) options for type-ahead navigation.\n\nUses auro-menuoption's `isActive` getter, which excludes disabled, hidden,\nand static options (e.g. `static nomatch` placeholders) so the type-ahead\ncursor never lands on a non-actionable item. Same empty-safe handling as\n`getEnabledOptions`.",
+          "return": {
+            "type": {
+              "text": "Array<HTMLElement>"
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getEnabledOptions",
+          "declaration": {
+            "name": "getEnabledOptions",
+            "module": "components/select/src/selectUtils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getActiveOptions",
+          "declaration": {
+            "name": "getActiveOptions",
+            "module": "components/select/src/selectUtils.js"
+          }
+        }
+      ]
     }
   ]
 }