@aurodesignsystem-dev/auro-formkit 0.0.0-pr1503.2 → 0.0.0-pr1505.0

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"
@@ -11696,6 +11704,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 +13815,26 @@
               },
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "_computeDateObjectFallback",
+              "parameters": [
+                {
+                  "name": "dateStr",
+                  "description": "ISO date string from `value`/`min`/`max`.",
+                  "type": {
+                    "text": "string|undefined"
+                  }
+                }
+              ],
+              "description": "Parses a date string into a Date object when the corresponding `_*Object`\nfield hasn't been synced yet by `updated()`. Returns undefined when the\ninput type/format isn't a full date or the string is not a valid date.\n\nWhy this exists: a parent (datepicker) can call `inputN.validate()` from\ninside its own `updated()` before this input's `updated()` has run\n`syncDateValues()` — so `_valueObject`/`_maxObject` are still `undefined`\nand range checks would otherwise silently no-op (flipping the result to\n`valid` or `patternMismatch`).",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Date|undefined"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "setDateObjectProperty",
@@ -15969,882 +16021,386 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/menu/src/auro-menu.context.js",
+      "path": "components/menu/src/auro-menu.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "",
-          "name": "MenuService",
+          "description": "The `auro-menu` element provides users a way to select from a list of options.",
+          "name": "AuroMenu",
+          "slots": [
+            {
+              "description": "Text to show while loading attribute is set",
+              "name": "loadingText"
+            },
+            {
+              "description": "Icon to show while loading attribute is set",
+              "name": "loadingIcon"
+            },
+            {
+              "description": "Slot for insertion of menu options.",
+              "name": ""
+            }
+          ],
           "members": [
+            {
+              "kind": "method",
+              "name": "register",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "default": "\"auro-menu\"",
+                  "description": "The name of element that you want to register to.",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "This will register this element with the browser."
+            },
             {
               "kind": "field",
-              "name": "menuOptions",
-              "description": "Gets the list of registered menu options.",
+              "name": "options",
+              "readonly": true,
               "return": {
                 "type": {
-                  "text": "AuroMenuOption[]"
+                  "text": "Array<HTMLElement>"
                 }
-              },
-              "readonly": true
+              }
             },
             {
               "kind": "field",
-              "name": "highlightedOption",
-              "description": "Gets the currently highlighted option.",
+              "name": "index",
               "return": {
                 "type": {
-                  "text": "AuroMenuOption|null"
+                  "text": "number"
                 }
               },
-              "readonly": true
+              "parameters": [
+                {
+                  "description": "Sets the index of the currently active option.",
+                  "name": "value",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
             },
             {
               "kind": "field",
-              "name": "currentValue",
-              "description": "Gets the current value(s) of the selected option(s).",
+              "name": "selectedOptions",
+              "description": "Gets the currently selected options as an array.",
               "return": {
                 "type": {
-                  "text": "string|string[]|undefined"
+                  "text": "Array<HTMLElement>"
                 }
               },
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "currentLabel",
-              "description": "Gets the label(s) of the currently selected option(s).",
+              "name": "selectedOption",
+              "description": "Gets the first selected option, or null if none.",
               "return": {
                 "type": {
-                  "text": "string"
+                  "text": "HTMLElement|null"
                 }
               },
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "stringValue",
-              "description": "Gets the string representation of the current value(s).\nFor multi-select, this is a JSON stringified array.",
+              "name": "currentLabel",
+              "readonly": true,
               "return": {
                 "type": {
-                  "text": "string|undefined"
+                  "text": "string"
                 }
-              },
-              "readonly": true
+              }
             },
             {
               "kind": "field",
-              "name": "currentKeys",
-              "description": "Gets the key(s) of the currently selected option(s).",
+              "name": "formattedValue",
+              "description": "Formatted value based on `multiSelect` state.\nDefault type is `String`, changing to `Array<String>` when `multiSelect` is true.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "string|string[]|undefined"
+                  "text": "String|Array<String>"
                 }
               },
               "readonly": true
             },
             {
               "kind": "method",
-              "name": "hostUpdated",
-              "description": "Handles host updates.\nThis is a lit reactive lifecycle method.\nThis comes from the Lit controller interface provided by adding this service as a controller to the host.\nSee constructor for `this.host.addController(this)`\nYou can read more about Lit reactive controllers here: https://lit.dev/docs/composition/controllers/"
-            },
-            {
-              "kind": "method",
-              "name": "hostDisconnected",
-              "description": "Handles host disconnection and memory cleanup."
-            },
-            {
-              "kind": "method",
-              "name": "setProperty",
+              "name": "selectByValue",
               "parameters": [
-                {
-                  "name": "property",
-                  "type": {
-                    "text": "string"
-                  }
-                },
                 {
                   "name": "value",
+                  "description": "The value(s) to select.",
                   "type": {
-                    "text": "any"
+                    "text": "string|string[]|undefined|null"
                   }
                 }
               ],
-              "description": "Sets a property value if it exists on the instance and the value has changed."
+              "description": "Selects options by value.",
+              "privacy": "public"
             },
             {
               "kind": "method",
-              "name": "setProperties",
+              "name": "setTagAttribute",
               "parameters": [
                 {
-                  "name": "properties",
-                  "description": "Key-value pairs of properties to set.",
+                  "name": "tagName",
+                  "description": "The tag name to set as an attribute.",
                   "type": {
-                    "text": "Object"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Sets multiple properties on the instance."
-            },
-            {
-              "kind": "method",
-              "name": "highlightNext",
-              "description": "Highlights the next active option in the menu."
-            },
-            {
-              "kind": "method",
-              "name": "highlightPrevious",
-              "description": "Highlights the previous active option in the menu."
+              "description": "Sets an attribute that matches the default tag name if the tag name is not the default.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "moveHighlightedOption",
+              "name": "updateItemsState",
               "parameters": [
                 {
-                  "name": "direction",
-                  "description": "The direction to move the highlight (\"next\" or \"previous\").",
+                  "name": "changedProperties",
+                  "description": "LitElement's changed properties map.",
                   "type": {
-                    "text": "string"
+                    "text": "Map<string, boolean>"
                   }
                 }
               ],
-              "description": "Moves the highlighted option in the specified direction."
+              "description": "Updates the UI state and appearance of menu items based on changed properties.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "initializeMenu",
+              "description": "Initializes the menu's state and structure.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "initItems",
+              "description": "Initializes menu items and their attributes.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "setHighlightedOption",
+              "name": "handleSelectState",
               "parameters": [
                 {
                   "name": "option",
-                  "description": "The option to highlight.",
+                  "description": "The option element to select.",
                   "type": {
-                    "text": "AuroMenuOption"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Sets the highlighted index to the specified option."
+              "description": "Updates menu state when an option is selected.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "setHighlightedIndex",
+              "name": "handleDeselectState",
               "parameters": [
                 {
-                  "name": "index",
+                  "name": "option",
+                  "description": "The menuoption to be deselected.",
                   "type": {
-                    "text": "number"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Sets the highlighted option to the option at the specified index if it exists."
+              "description": "Deselects a menu option and updates related state.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "selectHighlightedOption",
-              "description": "Selects the currently highlighted option."
+              "name": "clearSelection",
+              "description": "Resets all options to their default state.",
+              "privacy": "private"
             },
             {
               "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"
+              "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": "deselectOptions",
+              "name": "handleNestedMenus",
               "parameters": [
                 {
-                  "name": "options",
-                  "description": "Single option or array of options to deselect",
+                  "name": "menu",
+                  "description": "Root menu element.",
                   "type": {
-                    "text": "AuroMenuOption|AuroMenuOption[]"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Deselects one or more options in a batch operation"
+              "description": "Handles nested menu structure.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "selectOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "type": {
-                    "text": "AuroMenuOption"
-                  }
-                }
-              ],
-              "description": "Selects a single option."
+              "name": "makeSelection",
+              "description": "Makes a selection based on the current index.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "deselectOption",
+              "name": "toggleOption",
               "parameters": [
                 {
                   "name": "option",
+                  "description": "The menuoption to toggle.",
                   "type": {
-                    "text": "AuroMenuOption"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Deselects a single option."
+              "description": "Toggle the selection state of the menuoption.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "toggleOption",
+              "name": "handleKeyDown",
               "parameters": [
                 {
-                  "name": "option",
+                  "name": "event",
+                  "description": "The keydown event.",
                   "type": {
-                    "text": "AuroMenuOption"
+                    "text": "KeyboardEvent"
                   }
                 }
               ],
-              "description": "Toggles the selection state of a single option."
+              "description": "Handles keyboard navigation and selection.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "selectByValue",
+              "name": "handleMouseSelect",
               "parameters": [
                 {
-                  "name": "value",
-                  "description": "The value(s) to select.",
+                  "name": "event",
+                  "description": "The auroMenuOption-click event.",
                   "type": {
-                    "text": "string|number|Array<string|number>"
+                    "text": "CustomEvent"
                   }
                 }
               ],
-              "description": "Selects options based on their value(s) when compared to a passed value or values.\nValue or values are normalized to an array of strings that can be matched to option keys."
+              "description": "Handles option selection via click events from menuoptions.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "queuePendingValue",
+              "name": "handleOptionHover",
               "parameters": [
                 {
-                  "name": "value",
-                  "description": "The value to retry.",
+                  "name": "event",
+                  "description": "Event object from the browser.",
                   "type": {
-                    "text": "string|number|Array<string|number>"
+                    "text": "CustomEvent"
                   }
                 }
               ],
-              "description": "Queues a pending value and schedules a bounded retry."
-            },
-            {
-              "kind": "method",
-              "name": "clearPendingValue",
-              "description": "Clears pending retry state."
+              "description": "Handles option hover events.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "reset",
-              "description": "Resets the selected options to an empty array."
+              "name": "handleSlotChange",
+              "description": "Handles slot change events.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "subscribe",
+              "name": "navigateOptions",
               "parameters": [
                 {
-                  "name": "callback",
-                  "description": "The callback to invoke on events.",
+                  "name": "direction",
+                  "description": "'up' or 'down'.",
                   "type": {
-                    "text": "Function"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Subscribes a callback to menu service events."
+              "description": "Navigates through options using keyboard."
             },
             {
               "kind": "method",
-              "name": "unsubscribe",
+              "name": "updateActiveOption",
               "parameters": [
                 {
-                  "name": "callback",
+                  "name": "indexOrOption",
+                  "description": "Index of the option or the option element to make active.",
                   "type": {
-                    "text": "Function"
+                    "text": "number|HTMLElement"
                   }
                 }
               ],
-              "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."
+              "description": "Updates the active option state and dispatches events.\nAccepts either a numeric index or an HTMLElement option."
             },
             {
               "kind": "method",
-              "name": "notify",
+              "name": "handleCustomEvent",
               "parameters": [
                 {
-                  "name": "event",
-                  "description": "The event to send to subscribers.",
+                  "name": "option",
+                  "description": "Option with custom event.",
                   "type": {
-                    "text": "string"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "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)."
+              "description": "Handles custom events defined on options.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "notifyValueChange",
+              "name": "notifySelectionChange",
               "parameters": [
                 {
-                  "name": "meta",
-                  "default": "{}"
+                  "name": "source",
+                  "default": "undefined",
+                  "description": "The source that triggers this event.",
+                  "type": {
+                    "text": "any"
+                  }
                 }
               ],
-              "description": "Notifies subscribers of a value change (current value has changed)."
+              "description": "Notifies selection change to parent components.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "dispatchChangeEvent",
+              "name": "selectionEquals",
               "parameters": [
                 {
-                  "name": "eventName",
+                  "name": "current",
+                  "description": "Current selection.",
                   "type": {
-                    "text": "string"
+                    "text": "any"
                   }
                 },
                 {
-                  "name": "detail",
+                  "name": "next",
+                  "description": "New selection to compare.",
                   "type": {
                     "text": "any"
                   }
                 }
               ],
-              "description": "Dispatches a custom event from the host element."
-            },
-            {
-              "kind": "method",
-              "name": "addMenuOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "the option to track",
-                  "type": {
-                    "text": "AuroMenuOption"
-                  }
-                }
-              ],
-              "description": "Adds a menu option to the service's list."
-            },
-            {
-              "kind": "method",
-              "name": "removeMenuOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "the option to remove",
-                  "type": {
-                    "text": "AuroMenuOption"
-                  }
-                }
-              ],
-              "description": "Removes a menu option from the service's list."
-            },
-            {
-              "kind": "method",
-              "name": "_getNormalizedValues",
-              "parameters": [
-                {
-                  "name": "value",
-                  "description": "The value(s) to normalize.",
-                  "type": {
-                    "text": "string|number|Array<string|number>"
-                  }
-                }
-              ],
-              "description": "Normalizes a value or array of values into an array of strings for option selection.\nThis function ensures that input values are consistently formatted for matching menu options.",
-              "return": {
-                "type": {
-                  "text": "Array<string>"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "optionsArraysMatch",
-              "parameters": [
-                {
-                  "name": "arr1",
-                  "description": "First array of options.",
-                  "type": {
-                    "text": "AuroMenuOption[]"
-                  }
-                },
-                {
-                  "name": "arr2",
-                  "description": "Second array of options.",
-                  "type": {
-                    "text": "AuroMenuOption[]"
-                  }
-                }
-              ],
-              "description": "Returns whether two arrays of options contain the same elements.",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "host",
-              "default": "host"
-            },
-            {
-              "kind": "field",
-              "name": "size",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "shape",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "noCheckmark",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "disabled",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "matchWord",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "multiSelect",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "allowDeselect",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "selectAllMatchingOptions",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "highlightedIndex",
-              "type": {
-                "text": "number"
-              },
-              "default": "-1"
-            },
-            {
-              "kind": "field",
-              "name": "_menuOptions",
-              "type": {
-                "text": "array"
-              },
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "_subscribers",
-              "type": {
-                "text": "array"
-              },
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "internalUpdateInProgress",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "selectedOptions",
-              "type": {
-                "text": "array"
-              },
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "_pendingValue",
-              "type": {
-                "text": "null"
-              },
-              "default": "null"
-            },
-            {
-              "kind": "field",
-              "name": "_pendingRetryScheduled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "_pendingRetryCount",
-              "type": {
-                "text": "number"
-              },
-              "default": "0"
-            }
-          ]
-        },
-        {
-          "kind": "variable",
-          "name": "MenuContext"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "MenuService",
-          "declaration": {
-            "name": "MenuService",
-            "module": "components/menu/src/auro-menu.context.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "MenuContext",
-          "declaration": {
-            "name": "MenuContext",
-            "module": "components/menu/src/auro-menu.context.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/menu/src/auro-menu.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "The `auro-menu` element provides users a way to select from a list of options.",
-          "name": "AuroMenu",
-          "slots": [
-            {
-              "description": "Text to show while loading attribute is set",
-              "name": "loadingText"
-            },
-            {
-              "description": "Icon to show while loading attribute is set",
-              "name": "loadingIcon"
-            },
-            {
-              "description": "Slot for insertion of menu options.",
-              "name": ""
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "currentLabel",
-              "readonly": true,
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "items",
-              "readonly": true,
-              "return": {
-                "type": {
-                  "text": "Array<HTMLElement>"
-                }
-              },
-              "deprecated": "Use `options` property instead."
-            },
-            {
-              "kind": "field",
-              "name": "index",
-              "return": {
-                "type": {
-                  "text": "number"
-                }
-              },
-              "parameters": [
-                {
-                  "description": "Sets the index of the currently active option.",
-                  "name": "value",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "register",
-              "static": true,
-              "parameters": [
-                {
-                  "name": "name",
-                  "default": "\"auro-menu\"",
-                  "description": "The name of the element that you want to register.",
-                  "optional": true,
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "This will register this element with the browser."
-            },
-            {
-              "kind": "field",
-              "name": "formattedValue",
-              "description": "Formatted value based on `multiSelect` state.\nDefault type is `String`, changing to `Array<String>` when `multiSelect` is true.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "String|Array<String>"
-                }
-              },
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "propertyValues",
-              "description": "Gets the current property values for the menu service.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Object"
-                }
-              },
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "provideContext",
-              "description": "Provides the menu context to child components.\nInitializes the MenuService and subscribes to menu changes.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "updateActiveOption",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "The option to set as active.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Updates the currently active option in the menu."
-            },
-            {
-              "kind": "method",
-              "name": "setInternalValue",
-              "parameters": [
-                {
-                  "name": "value",
-                  "description": "The value to set.",
-                  "type": {
-                    "text": "String|Array<String>"
-                  }
-                }
-              ],
-              "description": "Sets the internal value and manages update state.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "handleMenuChange",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The event object from the menu service.",
-                  "type": {
-                    "text": "Object"
-                  }
-                }
-              ],
-              "description": "Handles changes from the menu service and updates component state.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "field",
-              "name": "selectedOptions",
-              "description": "Gets the currently selected options.",
-              "return": {
-                "type": {
-                  "text": "Array<HTMLElement>"
-                }
-              },
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "selectedOption",
-              "description": "Gets the first selected option, or null if none.",
-              "return": {
-                "type": {
-                  "text": "HTMLElement|null"
-                }
-              },
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "setTagAttribute",
-              "parameters": [
-                {
-                  "name": "tagName",
-                  "description": "The tag name to set as an attribute.",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Sets an attribute that matches the default tag name if the tag name is not the default.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "setLoadingState",
-              "parameters": [
-                {
-                  "name": "isLoading",
-                  "description": "Whether the menu is loading.",
-                  "type": {
-                    "text": "boolean"
-                  }
-                }
-              ],
-              "description": "Sets the loading state and dispatches a loading change event.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "initializeMenu",
-              "description": "Initializes the menu's state and structure.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "makeSelection",
-              "description": "Selects the currently highlighted option.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "clearSelection",
-              "description": "Resets all options to their default state.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "reset",
-              "description": "Resets the menu to its initial state.\nThis is the only way to return value to undefined.",
-              "privacy": "public"
-            },
-            {
-              "kind": "method",
-              "name": "handleNestedMenus",
-              "parameters": [
-                {
-                  "name": "menu",
-                  "description": "Root menu element.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Handles nested menu structure.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "navigateOptions",
-              "parameters": [
-                {
-                  "name": "direction",
-                  "description": "The direction to navigate.",
-                  "type": {
-                    "text": "'up'|'down'"
-                  }
-                }
-              ],
-              "description": "Navigates the menu options in the specified direction.",
-              "privacy": "protected"
-            },
-            {
-              "kind": "method",
-              "name": "handleSlotChange",
-              "description": "Handles slot change events.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "handleCustomEvent",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "Option with custom event.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Handles custom events defined on options.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "notifySelectionChange",
-              "parameters": [
-                {
-                  "name": "{value, stringValue, keys, options, reason}",
-                  "default": "{}"
-                },
-                {
-                  "description": "The source that triggers this event.",
-                  "name": "source",
-                  "type": {
-                    "text": "any"
-                  }
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
                 }
-              ],
-              "description": "Notifies selection change to parent components.",
-              "privacy": "private"
+              }
             },
             {
               "kind": "method",
@@ -16869,18 +16425,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 +16465,6 @@
               },
               "attribute": "shape",
               "reflects": true,
-              "description": "Sets the shape of the menu.",
               "default": "\"box\"",
               "inheritedFrom": {
                 "name": "AuroElement",
@@ -16930,13 +16480,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 +16567,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 +16578,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 +16587,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 +16627,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 +16693,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 +16709,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 +16717,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 +16772,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 +16799,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 +16869,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 +16881,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 +16891,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"
-                  }
+                  "name": "value"
                 }
-              ],
-              "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": "active"
                 }
-              ],
-              "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"
+              "name": "attachTo"
             },
             {
               "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"
-            },
-            {
-              "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"
-            },
-            {
-              "kind": "method",
-              "name": "dispatchClickEvent",
-              "description": "Dispatches a click event for this menu option.\nThis function notifies listeners that the option has been clicked.",
+              "description": "Handles click events on the menu option.",
               "privacy": "private"
             },
             {
@@ -17600,7 +16993,6 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "Specifies that an option is selected.",
               "default": "false",
               "attribute": "selected",
               "reflects": true
@@ -17608,7 +17000,7 @@
             {
               "kind": "field",
               "name": "noCheckmark",
-              "privacy": "private",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
@@ -17623,7 +17015,6 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "When true, disables the menu option.",
               "default": "false",
               "attribute": "disabled",
               "reflects": true
@@ -17635,101 +17026,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 +17108,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 +17151,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",
@@ -20401,7 +19728,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) { 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) { component.updateActiveOptionBasedOnKey(evt.key); if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (ctx.isExpanded) { component.dropdown.hide(); return; } component.dropdown.show(); } }, }"
         }
       ],
       "exports": [
@@ -20414,6 +19741,41 @@
           }
         }
       ]
+    },
+    {
+      "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>"
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getEnabledOptions",
+          "declaration": {
+            "name": "getEnabledOptions",
+            "module": "components/select/src/selectUtils.js"
+          }
+        }
+      ]
     }
   ]
 }