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

package/custom-elements.json

@@ -2454,7 +2454,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": [
@@ -6305,6 +6305,14 @@
               "description": "Defines the label content for the first input.",
               "name": "fromLabel"
             },
+            {
+              "description": "Overrides the \" (optional)\" text rendered next to the first input's label when the datepicker is not `required`.",
+              "name": "optionalFromLabel"
+            },
+            {
+              "description": "Overrides the \" (optional)\" text rendered next to the second input's label when `range` is set and the datepicker is not `required`.",
+              "name": "optionalToLabel"
+            },
             {
               "description": "Defines the content to display in the auro-calendar-cell for the specified date. The content text is colored using the success state token when the `highlight` attribute is applied to the slot.",
               "name": "date_YYYY_MM_DD"
@@ -10493,6 +10501,46 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_isDisabled",
+              "parameters": [
+                {
+                  "name": "element",
+                  "description": "The element to check.",
+                  "type": {
+                    "text": "HTMLElement | undefined | null"
+                  }
+                }
+              ],
+              "description": "Whether a given element is currently disabled. Disabled controls are excluded\nfrom submission, validity, and initial-state checks per the HTML spec\n(section 4.10.19.2 \"Enabling and disabling form controls\":\nhttps://www.w3.org/TR/2011/WD-html5-20110113/association-of-controls-and-forms.html).\n\nImplementation note: we deliberately read only the attribute. Every Auro\nform element in `formElementTags` declares `disabled` with `reflect: true`,\nso the attribute and property stay in sync. Reading the attribute also\nlets the MutationObserver in `connectedCallback` (which is filtered to\n`['disabled', 'name']`) be the single source of truth for re-renders.\nIf a future form-element type ships without attribute reflection, expand\nthis helper to also read `element.disabled`.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_isNameDisabled",
+              "parameters": [
+                {
+                  "name": "name",
+                  "description": "The `name` attribute used to register the element.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Whether the tracked form element registered under `name` is currently disabled.\nSee `_isDisabled` for the HTML-spec rationale behind excluding disabled\ncontrols from form state.\n\nReads a cached flag on `formState[name]` populated by `_addElementToState`\nat registration and refreshed by `_handleAttributeMutations` whenever the\nelement's `disabled` attribute toggles. The cache is fed by the same\n`hasAttribute('disabled')` read as `_isDisabled`, so the \"future form-element\ntype without attribute reflection\" caveat documented there applies here too.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_eventIsValidFormEvent",
@@ -10574,10 +10622,52 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "_isFormValid",
+              "description": "Raw constraint-validation check. Returns `true` when no enabled field\nhas a validity error. Unlike the public `validity` getter, this does\nNOT gate on `isInitialState` — callers that need to make a decision\nbased on the actual constraint state (submit-button enablement, the\ninternal `submit()` gate) read this so a pre-filled valid form is\ncorrectly recognized as submittable at first render.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_hasResetableState",
+              "description": "Whether the reset button should be enabled. True when the form has\ndiverged from its initial state (so the user can always return to\ndefaults — even if the dirty value lives behind a now-disabled field),\nOR when any non-disabled field has a current value or captured initial\nvalue (covers pre-filled forms and user-cleared-back-to-empty cases).",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_normalizeEmpty",
+              "parameters": [
+                {
+                  "name": "value",
+                  "description": "Value to normalize.",
+                  "type": {
+                    "text": "*"
+                  }
+                }
+              ],
+              "description": "Collapse empty representations to a single canonical `null`.\n\n`_addElementToState` captures `null` for a field that mounts without a\n`value` attribute (`element.value || element.getAttribute('value')` is\nfalsy → resolves to `null`), but `sharedInputListener` later stores the\nraw `event.target.value` — which is `''` for a user-cleared text input.\nWithout this normalization, backspacing back to empty would taint the\nform forever (`'' !== null`) and Reset would stay enabled with nothing\nto actually reset.\n\n`''`, `undefined`, and `[]` all collapse to `null`. The empty-array case\ncovers checkbox-group, radio-group, and multiselect, where `[]` means\n\"no selection\" — semantically the same as `null`/`''`. Genuine values\n— including `0`, `false`, non-empty strings, and non-empty arrays —\npass through unchanged so number, boolean, and populated multi-value\nfields still compare correctly.",
+              "return": {
+                "type": {
+                  "text": "*"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_calculateValidity",
-              "description": "Infer validity status based on current formState.",
+              "description": "Infer validity status based on current formState.\n\nValidity stays `null` while the form is in its initial state — this is\nthe \"stay quiet until the user interacts\" UX contract that consumers\ndepend on to delay error indicators. Code that needs the raw\nconstraint-validation result regardless of interaction (e.g.,\nsubmit-button enablement) should call `_isFormValid()` directly.",
               "privacy": "private"
             },
             {
@@ -10594,7 +10684,7 @@
             {
               "kind": "method",
               "name": "_setInitialState",
-              "description": "Determines whether the form is in its initial (untouched) state and updates `_isInitialState` accordingly.",
+              "description": "Determines whether the form is in its initial (untouched) state.\n\nA field is tainted if either:\n  - its value differs from the value captured on first render, OR\n  - its validity is failing (anything other than `null` or `'valid'`).\n\nValidity acts as a backup signal: it catches users who interact with a\nfield without changing its value (e.g., focusing and blurring a required\nfield). We skip `null` (not yet validated) and `'valid'` (the default\nafter Auro's auto-validation on mount) because neither proves the user\ntouched anything.",
               "return": {
                 "type": {
                   "text": "void"
@@ -10754,6 +10844,26 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_handleAttributeMutations",
+              "parameters": [
+                {
+                  "name": "mutations",
+                  "description": "The batched mutation records.",
+                  "type": {
+                    "text": "MutationRecord[]"
+                  }
+                }
+              ],
+              "description": "Handle batched MutationObserver records for `disabled` and `name`\nattribute changes on tracked form elements. A `name` change invalidates\nthe formState keying — we resolve it by re-initializing state. A `disabled`\nchange simply needs a re-render (so `value` / `validity` getters re-evaluate)\nand a refresh of the submit/reset button enablement.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "mutationEventListener",
@@ -10847,6 +10957,25 @@
               },
               "privacy": "private",
               "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_initialValues",
+              "type": {
+                "text": "Record<string, string | number | boolean | string[] | null | undefined>"
+              },
+              "description": "Captured initial (default) value per field `name`. Populated on first\nsight of each name in `_addElementToState` and preserved across\nsubsequent `initializeState` cycles (slot change, rename, reset) so\n`_setInitialState` can detect user edits as `current !== initial`,\nmatching HTML's `dirtyValueFlag` semantics.",
+              "privacy": "private",
+              "default": "{}"
+            },
+            {
+              "kind": "field",
+              "name": "_attributeObserver",
+              "type": {
+                "text": "MutationObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
             }
           ],
           "events": [
@@ -11232,7 +11361,7 @@
               "name": "label"
             },
             {
-              "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
+              "description": "Allows overriding the optional display text \" (optional)\", which appears next to the label.",
               "name": "optionalLabel"
             },
             {
@@ -11696,6 +11825,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 +13936,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,826 +16142,300 @@
     },
     {
       "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."
-            },
-            {
-              "kind": "method",
-              "name": "selectHighlightedOption",
-              "description": "Selects the currently highlighted option."
-            },
-            {
-              "kind": "method",
-              "name": "selectOptions",
-              "parameters": [
-                {
-                  "name": "options",
-                  "description": "Single option or array of options to select",
-                  "type": {
-                    "text": "AuroMenuOption|AuroMenuOption[]"
-                  }
-                }
-              ],
-              "description": "Selects one or more options in a batch operation"
-            },
-            {
-              "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"
-            },
-            {
-              "kind": "method",
-              "name": "selectOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "type": {
-                    "text": "AuroMenuOption"
-                  }
-                }
-              ],
-              "description": "Selects a single option."
-            },
-            {
-              "kind": "method",
-              "name": "deselectOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "type": {
-                    "text": "AuroMenuOption"
-                  }
-                }
-              ],
-              "description": "Deselects a single option."
-            },
-            {
-              "kind": "method",
-              "name": "toggleOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "type": {
-                    "text": "AuroMenuOption"
-                  }
-                }
-              ],
-              "description": "Toggles the selection state of a single option."
-            },
-            {
-              "kind": "method",
-              "name": "selectByValue",
-              "parameters": [
-                {
-                  "name": "value",
-                  "description": "The value(s) to select.",
-                  "type": {
-                    "text": "string|number|Array<string|number>"
-                  }
-                }
-              ],
-              "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."
-            },
-            {
-              "kind": "method",
-              "name": "queuePendingValue",
-              "parameters": [
-                {
-                  "name": "value",
-                  "description": "The value to retry.",
-                  "type": {
-                    "text": "string|number|Array<string|number>"
-                  }
-                }
-              ],
-              "description": "Queues a pending value and schedules a bounded retry."
-            },
-            {
-              "kind": "method",
-              "name": "clearPendingValue",
-              "description": "Clears pending retry state."
+              "name": "clearSelection",
+              "description": "Resets all options to their default state.",
+              "privacy": "private"
             },
             {
               "kind": "method",
               "name": "reset",
-              "description": "Resets the selected options to an empty array."
-            },
-            {
-              "kind": "method",
-              "name": "subscribe",
-              "parameters": [
-                {
-                  "name": "callback",
-                  "description": "The callback to invoke on events.",
-                  "type": {
-                    "text": "Function"
-                  }
-                }
-              ],
-              "description": "Subscribes a callback to menu service events."
-            },
-            {
-              "kind": "method",
-              "name": "unsubscribe",
-              "parameters": [
-                {
-                  "name": "callback",
-                  "type": {
-                    "text": "Function"
-                  }
-                }
-              ],
-              "description": "Remove a previously subscribed callback from menu service events."
-            },
-            {
-              "kind": "method",
-              "name": "stageUpdate",
-              "parameters": [
-                {
-                  "name": "meta",
-                  "default": "{}"
-                }
-              ],
-              "description": "Stages an update to notify subscribers of state and value changes."
-            },
-            {
-              "kind": "method",
-              "name": "notify",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The event to send to subscribers.",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "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"
-                  }
-                }
-              ]
+              "description": "Resets the menu to its initial state.\nThis is the only way to return value to undefined.",
+              "privacy": "public"
             },
             {
               "kind": "method",
-              "name": "register",
-              "static": true,
+              "name": "handleNestedMenus",
               "parameters": [
                 {
-                  "name": "name",
-                  "default": "\"auro-menu\"",
-                  "description": "The name of the element that you want to register.",
-                  "optional": true,
+                  "name": "menu",
+                  "description": "Root menu element.",
                   "type": {
-                    "text": "string"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "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
+              "description": "Handles nested menu structure.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "provideContext",
-              "description": "Provides the menu context to child components.\nInitializes the MenuService and subscribes to menu changes.",
-              "privacy": "protected"
+              "name": "makeSelection",
+              "description": "Makes a selection based on the current index.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "updateActiveOption",
+              "name": "toggleOption",
               "parameters": [
                 {
                   "name": "option",
-                  "description": "The option to set as active.",
+                  "description": "The menuoption to toggle.",
                   "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"
+              "description": "Toggle the selection state of the menuoption.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleMenuChange",
+              "name": "handleKeyDown",
               "parameters": [
                 {
                   "name": "event",
-                  "description": "The event object from the menu service.",
+                  "description": "The keydown event.",
                   "type": {
-                    "text": "Object"
+                    "text": "KeyboardEvent"
                   }
                 }
               ],
-              "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
+              "description": "Handles keyboard navigation and selection.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "setTagAttribute",
+              "name": "handleMouseSelect",
               "parameters": [
                 {
-                  "name": "tagName",
-                  "description": "The tag name to set as an attribute.",
+                  "name": "event",
+                  "description": "The auroMenuOption-click event.",
                   "type": {
-                    "text": "string"
+                    "text": "CustomEvent"
                   }
                 }
               ],
-              "description": "Sets an attribute that matches the default tag name if the tag name is not the default.",
+              "description": "Handles option selection via click events from menuoptions.",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "setLoadingState",
+              "name": "handleOptionHover",
               "parameters": [
                 {
-                  "name": "isLoading",
-                  "description": "Whether the menu is loading.",
+                  "name": "event",
+                  "description": "Event object from the browser.",
                   "type": {
-                    "text": "boolean"
+                    "text": "CustomEvent"
                   }
                 }
               ],
-              "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.",
+              "description": "Handles option hover events.",
               "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.",
+              "name": "handleSlotChange",
+              "description": "Handles slot change events.",
               "privacy": "private"
             },
             {
@@ -16797,20 +16444,27 @@
               "parameters": [
                 {
                   "name": "direction",
-                  "description": "The direction to navigate.",
+                  "description": "'up' or 'down'.",
                   "type": {
-                    "text": "'up'|'down'"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Navigates the menu options in the specified direction.",
-              "privacy": "protected"
+              "description": "Navigates through options using keyboard."
             },
             {
               "kind": "method",
-              "name": "handleSlotChange",
-              "description": "Handles slot change events.",
-              "privacy": "private"
+              "name": "updateActiveOption",
+              "parameters": [
+                {
+                  "name": "indexOrOption",
+                  "description": "Index of the option or the option element to make active.",
+                  "type": {
+                    "text": "number|HTMLElement"
+                  }
+                }
+              ],
+              "description": "Updates the active option state and dispatches events.\nAccepts either a numeric index or an HTMLElement option."
             },
             {
               "kind": "method",
@@ -16832,12 +16486,9 @@
               "name": "notifySelectionChange",
               "parameters": [
                 {
-                  "name": "{value, stringValue, keys, options, reason}",
-                  "default": "{}"
-                },
-                {
-                  "description": "The source that triggers this event.",
                   "name": "source",
+                  "default": "undefined",
+                  "description": "The source that triggers this event.",
                   "type": {
                     "text": "any"
                   }
@@ -16846,6 +16497,32 @@
               "description": "Notifies selection change to parent components.",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "selectionEquals",
+              "parameters": [
+                {
+                  "name": "current",
+                  "description": "Current selection.",
+                  "type": {
+                    "text": "any"
+                  }
+                },
+                {
+                  "name": "next",
+                  "description": "New selection to compare.",
+                  "type": {
+                    "text": "any"
+                  }
+                }
+              ],
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "isOptionSelected",
@@ -16869,18 +16546,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 +16586,6 @@
               },
               "attribute": "shape",
               "reflects": true,
-              "description": "Sets the shape of the menu.",
               "default": "\"box\"",
               "inheritedFrom": {
                 "name": "AuroElement",
@@ -16930,13 +16601,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 +16688,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 +16699,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 +16708,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 +16748,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 +16814,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 +16830,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 +16838,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 +16893,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 +16920,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 +16990,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 +17002,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 +17012,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 +17114,6 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Specifies that an option is selected.",
               "default": "false",
               "attribute": "selected",
               "reflects": true
@@ -17608,7 +17121,7 @@
             {
               "kind": "field",
               "name": "noCheckmark",
-              "privacy": "private",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
@@ -17623,7 +17136,6 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "When true, disables the menu option.",
               "default": "false",
               "attribute": "disabled",
               "reflects": true
@@ -17635,101 +17147,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 +17229,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 +17272,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 +18727,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 +18765,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 +19161,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 +19463,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 +19827,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 +19914,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 +19927,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"
+          }
+        }
+      ]
     }
   ]
 }