@aurodesignsystem-dev/auro-formkit 0.0.0-pr1498.0 → 0.0.0-pr1499.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) { 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(); } } }, }"
+          "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(); } } }, }"
         }
       ],
       "exports": [
@@ -6951,7 +6951,7 @@
                   "name": "date",
                   "description": "Date format should be in a format Date constructor accepts, like '2023-04-21' or '2023/04/21'.",
                   "type": {
-                    "text": "string"
+                    "text": "Date"
                   }
                 }
               ],
@@ -6968,10 +6968,10 @@
               "name": "renderDisplayTextDate",
               "parameters": [
                 {
-                  "name": "dateValue",
+                  "name": "date",
                   "description": "The date value to format and render.",
                   "type": {
-                    "text": "string"
+                    "text": "Date"
                   }
                 }
               ],
@@ -11696,30 +11696,6 @@
                 "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",
@@ -13807,26 +13783,6 @@
               },
               "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",
@@ -16013,386 +15969,882 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/menu/src/auro-menu.js",
+      "path": "components/menu/src/auro-menu.context.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": ""
-            }
-          ],
+          "description": "",
+          "name": "MenuService",
           "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": "options",
-              "readonly": true,
+              "name": "menuOptions",
+              "description": "Gets the list of registered menu options.",
               "return": {
                 "type": {
-                  "text": "Array<HTMLElement>"
+                  "text": "AuroMenuOption[]"
                 }
-              }
+              },
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "index",
+              "name": "highlightedOption",
+              "description": "Gets the currently highlighted option.",
               "return": {
                 "type": {
-                  "text": "number"
+                  "text": "AuroMenuOption|null"
                 }
               },
-              "parameters": [
-                {
-                  "description": "Sets the index of the currently active option.",
-                  "name": "value",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "selectedOptions",
-              "description": "Gets the currently selected options as an array.",
+              "name": "currentValue",
+              "description": "Gets the current value(s) of the selected option(s).",
               "return": {
                 "type": {
-                  "text": "Array<HTMLElement>"
+                  "text": "string|string[]|undefined"
                 }
               },
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "selectedOption",
-              "description": "Gets the first selected option, or null if none.",
+              "name": "currentLabel",
+              "description": "Gets the label(s) of the currently selected option(s).",
               "return": {
                 "type": {
-                  "text": "HTMLElement|null"
+                  "text": "string"
                 }
               },
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "currentLabel",
-              "readonly": true,
+              "name": "stringValue",
+              "description": "Gets the string representation of the current value(s).\nFor multi-select, this is a JSON stringified array.",
               "return": {
                 "type": {
-                  "text": "string"
+                  "text": "string|undefined"
                 }
-              }
+              },
+              "readonly": true
             },
             {
               "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",
+              "name": "currentKeys",
+              "description": "Gets the key(s) of the currently selected option(s).",
               "return": {
                 "type": {
-                  "text": "String|Array<String>"
+                  "text": "string|string[]|undefined"
                 }
               },
               "readonly": true
             },
             {
               "kind": "method",
-              "name": "selectByValue",
-              "parameters": [
-                {
-                  "name": "value",
-                  "description": "The value(s) to select.",
-                  "type": {
-                    "text": "string|string[]|undefined|null"
-                  }
-                }
-              ],
-              "description": "Selects options by value.",
-              "privacy": "public"
+              "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": "setTagAttribute",
+              "name": "hostDisconnected",
+              "description": "Handles host disconnection and memory cleanup."
+            },
+            {
+              "kind": "method",
+              "name": "setProperty",
               "parameters": [
                 {
-                  "name": "tagName",
-                  "description": "The tag name to set as an attribute.",
+                  "name": "property",
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "any"
+                  }
                 }
               ],
-              "description": "Sets an attribute that matches the default tag name if the tag name is not the default.",
-              "privacy": "private"
+              "description": "Sets a property value if it exists on the instance and the value has changed."
             },
             {
               "kind": "method",
-              "name": "updateItemsState",
+              "name": "setProperties",
               "parameters": [
                 {
-                  "name": "changedProperties",
-                  "description": "LitElement's changed properties map.",
+                  "name": "properties",
+                  "description": "Key-value pairs of properties to set.",
                   "type": {
-                    "text": "Map<string, boolean>"
+                    "text": "Object"
                   }
                 }
               ],
-              "description": "Updates the UI state and appearance of menu items based on changed properties.",
-              "privacy": "private"
+              "description": "Sets multiple properties on the instance."
             },
             {
               "kind": "method",
-              "name": "initializeMenu",
-              "description": "Initializes the menu's state and structure.",
-              "privacy": "private"
+              "name": "highlightNext",
+              "description": "Highlights the next active option in the menu."
             },
             {
               "kind": "method",
-              "name": "initItems",
-              "description": "Initializes menu items and their attributes.",
-              "privacy": "private"
+              "name": "highlightPrevious",
+              "description": "Highlights the previous active option in the menu."
             },
             {
               "kind": "method",
-              "name": "handleSelectState",
+              "name": "moveHighlightedOption",
               "parameters": [
                 {
-                  "name": "option",
-                  "description": "The option element to select.",
+                  "name": "direction",
+                  "description": "The direction to move the highlight (\"next\" or \"previous\").",
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Updates menu state when an option is selected.",
-              "privacy": "private"
+              "description": "Moves the highlighted option in the specified direction."
             },
             {
               "kind": "method",
-              "name": "handleDeselectState",
+              "name": "setHighlightedOption",
               "parameters": [
                 {
                   "name": "option",
-                  "description": "The menuoption to be deselected.",
+                  "description": "The option to highlight.",
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "AuroMenuOption"
                   }
                 }
               ],
-              "description": "Deselects a menu option and updates related state.",
-              "privacy": "private"
+              "description": "Sets the highlighted index to the specified option."
             },
             {
               "kind": "method",
-              "name": "clearSelection",
-              "description": "Resets all options to their default state.",
-              "privacy": "private"
+              "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": "reset",
-              "description": "Resets the menu to its initial state.\nThis is the only way to return value to undefined.",
-              "privacy": "public"
+              "name": "selectHighlightedOption",
+              "description": "Selects the currently highlighted option."
             },
             {
               "kind": "method",
-              "name": "handleNestedMenus",
+              "name": "selectOptions",
               "parameters": [
                 {
-                  "name": "menu",
-                  "description": "Root menu element.",
+                  "name": "options",
+                  "description": "Single option or array of options to select",
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "AuroMenuOption|AuroMenuOption[]"
                   }
                 }
               ],
-              "description": "Handles nested menu structure.",
-              "privacy": "private"
+              "description": "Selects one or more options in a batch operation"
             },
             {
               "kind": "method",
-              "name": "makeSelection",
-              "description": "Makes a selection based on the current index.",
-              "privacy": "private"
+              "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": "toggleOption",
+              "name": "selectOption",
               "parameters": [
                 {
                   "name": "option",
-                  "description": "The menuoption to toggle.",
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "AuroMenuOption"
                   }
                 }
               ],
-              "description": "Toggle the selection state of the menuoption.",
-              "privacy": "private"
+              "description": "Selects a single option."
             },
             {
               "kind": "method",
-              "name": "handleKeyDown",
+              "name": "deselectOption",
               "parameters": [
                 {
-                  "name": "event",
-                  "description": "The keydown event.",
+                  "name": "option",
                   "type": {
-                    "text": "KeyboardEvent"
+                    "text": "AuroMenuOption"
                   }
                 }
               ],
-              "description": "Handles keyboard navigation and selection.",
-              "privacy": "private"
+              "description": "Deselects a single option."
             },
             {
               "kind": "method",
-              "name": "handleMouseSelect",
+              "name": "toggleOption",
               "parameters": [
                 {
-                  "name": "event",
-                  "description": "The auroMenuOption-click event.",
+                  "name": "option",
                   "type": {
-                    "text": "CustomEvent"
+                    "text": "AuroMenuOption"
                   }
                 }
               ],
-              "description": "Handles option selection via click events from menuoptions.",
-              "privacy": "private"
+              "description": "Toggles the selection state of a single option."
             },
             {
               "kind": "method",
-              "name": "handleOptionHover",
+              "name": "selectByValue",
               "parameters": [
                 {
-                  "name": "event",
-                  "description": "Event object from the browser.",
+                  "name": "value",
+                  "description": "The value(s) to select.",
                   "type": {
-                    "text": "CustomEvent"
+                    "text": "string|number|Array<string|number>"
                   }
                 }
               ],
-              "description": "Handles option hover events.",
-              "privacy": "private"
+              "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": "handleSlotChange",
-              "description": "Handles slot change events.",
-              "privacy": "private"
+              "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": "navigateOptions",
+              "name": "clearPendingValue",
+              "description": "Clears pending retry state."
+            },
+            {
+              "kind": "method",
+              "name": "reset",
+              "description": "Resets the selected options to an empty array."
+            },
+            {
+              "kind": "method",
+              "name": "subscribe",
               "parameters": [
                 {
-                  "name": "direction",
-                  "description": "'up' or 'down'.",
+                  "name": "callback",
+                  "description": "The callback to invoke on events.",
                   "type": {
-                    "text": "string"
+                    "text": "Function"
                   }
                 }
               ],
-              "description": "Navigates through options using keyboard."
+              "description": "Subscribes a callback to menu service events."
             },
             {
               "kind": "method",
-              "name": "updateActiveOption",
+              "name": "unsubscribe",
               "parameters": [
                 {
-                  "name": "indexOrOption",
-                  "description": "Index of the option or the option element to make active.",
+                  "name": "callback",
                   "type": {
-                    "text": "number|HTMLElement"
+                    "text": "Function"
                   }
                 }
               ],
-              "description": "Updates the active option state and dispatches events.\nAccepts either a numeric index or an HTMLElement option."
+              "description": "Remove a previously subscribed callback from menu service events."
             },
             {
               "kind": "method",
-              "name": "handleCustomEvent",
+              "name": "stageUpdate",
               "parameters": [
                 {
-                  "name": "option",
-                  "description": "Option with custom event.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
+                  "name": "meta",
+                  "default": "{}"
                 }
               ],
-              "description": "Handles custom events defined on options.",
-              "privacy": "private"
+              "description": "Stages an update to notify subscribers of state and value changes."
             },
             {
               "kind": "method",
-              "name": "notifySelectionChange",
+              "name": "notify",
               "parameters": [
                 {
-                  "name": "source",
-                  "default": "undefined",
-                  "description": "The source that triggers this event.",
+                  "name": "event",
+                  "description": "The event to send to subscribers.",
                   "type": {
-                    "text": "any"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Notifies selection change to parent components.",
-              "privacy": "private"
+              "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": "selectionEquals",
+              "name": "dispatchChangeEvent",
               "parameters": [
                 {
-                  "name": "current",
-                  "description": "Current selection.",
+                  "name": "eventName",
                   "type": {
-                    "text": "any"
+                    "text": "string"
                   }
                 },
                 {
-                  "name": "next",
-                  "description": "New selection to compare.",
+                  "name": "detail",
                   "type": {
                     "text": "any"
                   }
                 }
               ],
-              "privacy": "private",
-              "return": {
-                "type": {
+              "description": "Dispatches a custom event from the host element."
+            },
+            {
+              "kind": "method",
+              "name": "addMenuOption",
+              "parameters": [
+                {
+                  "name": "option",
+                  "description": "the option to track",
+                  "type": {
+                    "text": "AuroMenuOption"
+                  }
+                }
+              ],
+              "description": "Adds a menu option to the service's list."
+            },
+            {
+              "kind": "method",
+              "name": "removeMenuOption",
+              "parameters": [
+                {
+                  "name": "option",
+                  "description": "the option to remove",
+                  "type": {
+                    "text": "AuroMenuOption"
+                  }
+                }
+              ],
+              "description": "Removes a menu option from the service's list."
+            },
+            {
+              "kind": "method",
+              "name": "_getNormalizedValues",
+              "parameters": [
+                {
+                  "name": "value",
+                  "description": "The value(s) to normalize.",
+                  "type": {
+                    "text": "string|number|Array<string|number>"
+                  }
+                }
+              ],
+              "description": "Normalizes a value or array of values into an array of strings for option selection.\nThis function ensures that input values are consistently formatted for matching menu options.",
+              "return": {
+                "type": {
+                  "text": "Array<string>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "optionsArraysMatch",
+              "parameters": [
+                {
+                  "name": "arr1",
+                  "description": "First array of options.",
+                  "type": {
+                    "text": "AuroMenuOption[]"
+                  }
+                },
+                {
+                  "name": "arr2",
+                  "description": "Second array of options.",
+                  "type": {
+                    "text": "AuroMenuOption[]"
+                  }
+                }
+              ],
+              "description": "Returns whether two arrays of options contain the same elements.",
+              "return": {
+                "type": {
                   "text": "boolean"
                 }
-              }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "host",
+              "default": "host"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "shape",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "noCheckmark",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "matchWord",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "multiSelect",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "allowDeselect",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "selectAllMatchingOptions",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "highlightedIndex",
+              "type": {
+                "text": "number"
+              },
+              "default": "-1"
+            },
+            {
+              "kind": "field",
+              "name": "_menuOptions",
+              "type": {
+                "text": "array"
+              },
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_subscribers",
+              "type": {
+                "text": "array"
+              },
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "internalUpdateInProgress",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "selectedOptions",
+              "type": {
+                "text": "array"
+              },
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingValue",
+              "type": {
+                "text": "null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingRetryScheduled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingRetryCount",
+              "type": {
+                "text": "number"
+              },
+              "default": "0"
+            }
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "MenuContext"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "MenuService",
+          "declaration": {
+            "name": "MenuService",
+            "module": "components/menu/src/auro-menu.context.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MenuContext",
+          "declaration": {
+            "name": "MenuContext",
+            "module": "components/menu/src/auro-menu.context.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/menu/src/auro-menu.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "The `auro-menu` element provides users a way to select from a list of options.",
+          "name": "AuroMenu",
+          "slots": [
+            {
+              "description": "Text to show while loading attribute is set",
+              "name": "loadingText"
+            },
+            {
+              "description": "Icon to show while loading attribute is set",
+              "name": "loadingIcon"
+            },
+            {
+              "description": "Slot for insertion of menu options.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "currentLabel",
+              "readonly": true,
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "items",
+              "readonly": true,
+              "return": {
+                "type": {
+                  "text": "Array<HTMLElement>"
+                }
+              },
+              "deprecated": "Use `options` property instead."
+            },
+            {
+              "kind": "field",
+              "name": "index",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "description": "Sets the index of the currently active option.",
+                  "name": "value",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "register",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "default": "\"auro-menu\"",
+                  "description": "The name of the element that you want to register.",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "This will register this element with the browser."
+            },
+            {
+              "kind": "field",
+              "name": "formattedValue",
+              "description": "Formatted value based on `multiSelect` state.\nDefault type is `String`, changing to `Array<String>` when `multiSelect` is true.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "String|Array<String>"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "propertyValues",
+              "description": "Gets the current property values for the menu service.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Object"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "provideContext",
+              "description": "Provides the menu context to child components.\nInitializes the MenuService and subscribes to menu changes.",
+              "privacy": "protected"
+            },
+            {
+              "kind": "method",
+              "name": "updateActiveOption",
+              "parameters": [
+                {
+                  "name": "option",
+                  "description": "The option to set as active.",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Updates the currently active option in the menu."
+            },
+            {
+              "kind": "method",
+              "name": "setInternalValue",
+              "parameters": [
+                {
+                  "name": "value",
+                  "description": "The value to set.",
+                  "type": {
+                    "text": "String|Array<String>"
+                  }
+                }
+              ],
+              "description": "Sets the internal value and manages update state.",
+              "privacy": "protected"
+            },
+            {
+              "kind": "method",
+              "name": "handleMenuChange",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The event object from the menu service.",
+                  "type": {
+                    "text": "Object"
+                  }
+                }
+              ],
+              "description": "Handles changes from the menu service and updates component state.",
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "selectedOptions",
+              "description": "Gets the currently selected options.",
+              "return": {
+                "type": {
+                  "text": "Array<HTMLElement>"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "selectedOption",
+              "description": "Gets the first selected option, or null if none.",
+              "return": {
+                "type": {
+                  "text": "HTMLElement|null"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "setTagAttribute",
+              "parameters": [
+                {
+                  "name": "tagName",
+                  "description": "The tag name to set as an attribute.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Sets an attribute that matches the default tag name if the tag name is not the default.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "setLoadingState",
+              "parameters": [
+                {
+                  "name": "isLoading",
+                  "description": "Whether the menu is loading.",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Sets the loading state and dispatches a loading change event.",
+              "privacy": "protected"
+            },
+            {
+              "kind": "method",
+              "name": "initializeMenu",
+              "description": "Initializes the menu's state and structure.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "makeSelection",
+              "description": "Selects the currently highlighted option.",
+              "privacy": "protected"
+            },
+            {
+              "kind": "method",
+              "name": "clearSelection",
+              "description": "Resets all options to their default state.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "reset",
+              "description": "Resets the menu to its initial state.\nThis is the only way to return value to undefined.",
+              "privacy": "public"
+            },
+            {
+              "kind": "method",
+              "name": "handleNestedMenus",
+              "parameters": [
+                {
+                  "name": "menu",
+                  "description": "Root menu element.",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Handles nested menu structure.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "navigateOptions",
+              "parameters": [
+                {
+                  "name": "direction",
+                  "description": "The direction to navigate.",
+                  "type": {
+                    "text": "'up'|'down'"
+                  }
+                }
+              ],
+              "description": "Navigates the menu options in the specified direction.",
+              "privacy": "protected"
+            },
+            {
+              "kind": "method",
+              "name": "handleSlotChange",
+              "description": "Handles slot change events.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleCustomEvent",
+              "parameters": [
+                {
+                  "name": "option",
+                  "description": "Option with custom event.",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Handles custom events defined on options.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "notifySelectionChange",
+              "parameters": [
+                {
+                  "name": "{value, stringValue, keys, options, reason}",
+                  "default": "{}"
+                },
+                {
+                  "description": "The source that triggers this event.",
+                  "name": "source",
+                  "type": {
+                    "text": "any"
+                  }
+                }
+              ],
+              "description": "Notifies selection change to parent components.",
+              "privacy": "private"
             },
             {
               "kind": "method",
@@ -16417,13 +16869,18 @@
             {
               "kind": "field",
               "name": "hasLoadingPlaceholder",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
               "description": "Getter for loading placeholder state.",
               "return": {
                 "type": {
                   "text": "boolean"
                 }
               },
-              "readonly": true
+              "readonly": true,
+              "attribute": "hasLoadingPlaceholder"
             },
             {
               "kind": "field",
@@ -16457,6 +16914,7 @@
               },
               "attribute": "shape",
               "reflects": true,
+              "description": "Sets the shape of the menu.",
               "default": "\"box\"",
               "inheritedFrom": {
                 "name": "AuroElement",
@@ -16472,24 +16930,13 @@
               },
               "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",
@@ -16559,6 +17006,30 @@
               "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",
@@ -16570,6 +17041,22 @@
               "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",
@@ -16579,6 +17066,27 @@
               },
               "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",
@@ -16619,22 +17127,6 @@
                 "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",
@@ -16685,6 +17177,13 @@
               "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>"
@@ -16701,6 +17200,15 @@
             }
           ],
           "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": {
@@ -16709,6 +17217,33 @@
               "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": {
@@ -16764,48 +17299,47 @@
               "fieldName": "optionSelected"
             },
             {
-              "name": "value",
-              "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",
-              "fieldName": "value"
-            },
-            {
-              "name": "layout",
+              "name": "size",
               "type": {
                 "text": "string"
               },
-              "description": "Defines the language of an element.",
-              "default": "{'default'}",
-              "fieldName": "layout",
+              "fieldName": "size",
+              "description": "Sets the size of the menu.",
+              "default": "\"sm\"",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "name": "selectAllMatchingOptions",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, selects all options that match the provided value/key when setting value and multiselect is enabled.",
+              "default": "false",
+              "fieldName": "selectAllMatchingOptions"
+            },
             {
               "name": "shape",
               "type": {
                 "text": "string"
               },
               "fieldName": "shape",
+              "description": "Sets the shape of the menu.",
+              "default": "\"box\"",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
             {
-              "name": "size",
+              "name": "value",
               "type": {
                 "text": "string"
               },
-              "fieldName": "size",
-              "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.",
+              "fieldName": "value"
             },
             {
               "name": "ondark",
@@ -16861,7 +17395,7 @@
                 {
                   "name": "name",
                   "default": "\"auro-menuoption\"",
-                  "description": "The name of element that you want to register to.",
+                  "description": "The name of the element that you want to register.",
                   "optional": true,
                   "type": {
                     "text": "string"
@@ -16873,7 +17407,7 @@
             {
               "kind": "field",
               "name": "isActive",
-              "description": "Returns whether the menu option is currently active and selectable.",
+              "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.",
               "return": {
                 "type": {
                   "text": "boolean"
@@ -16883,34 +17417,115 @@
             },
             {
               "kind": "method",
-              "name": "handleMenuChange"
+              "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."
             },
             {
               "kind": "method",
               "name": "setSelected",
               "parameters": [
                 {
-                  "name": "value"
+                  "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": "active"
+                  "name": "isActive",
+                  "description": "Whether the option should be marked as active.",
+                  "type": {
+                    "text": "boolean"
+                  }
                 }
-              ]
+              ],
+              "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": "attachTo"
+              "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.",
+              "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.",
               "privacy": "private"
             },
             {
@@ -16985,6 +17600,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "Specifies that an option is selected.",
               "default": "false",
               "attribute": "selected",
               "reflects": true
@@ -16992,7 +17608,7 @@
             {
               "kind": "field",
               "name": "noCheckmark",
-              "privacy": "public",
+              "privacy": "private",
               "type": {
                 "text": "boolean"
               },
@@ -17007,6 +17623,7 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "When true, disables the menu option.",
               "default": "false",
               "attribute": "disabled",
               "reflects": true
@@ -17018,46 +17635,101 @@
               "type": {
                 "text": "boolean"
               },
-              "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.",
+              "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.",
               "default": "false",
               "attribute": "nomatch",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "tabIndex",
+              "name": "runtimeUtils",
+              "privacy": "private",
+              "default": "new AuroLibraryRuntimeUtils()"
+            },
+            {
+              "kind": "field",
+              "name": "menuService",
               "privacy": "private",
               "type": {
-                "text": "number"
+                "text": "null"
               },
-              "default": "-1",
-              "attribute": "tabIndex",
-              "reflects": true
+              "default": "null",
+              "attribute": "menuService"
             },
             {
               "kind": "field",
-              "name": "runtimeUtils",
+              "name": "unsubscribe",
+              "type": {
+                "text": "null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "event",
               "privacy": "private",
-              "default": "new AuroLibraryRuntimeUtils()"
+              "type": {
+                "text": "string"
+              },
+              "attribute": "event",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "layout",
               "privacy": "public",
               "type": {
                 "text": "string"
               },
-              "attribute": "value",
+              "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": "key",
+              "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",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "event",
+              "name": "matchWord",
               "privacy": "private",
               "type": {
                 "text": "string"
               },
-              "attribute": "event",
+              "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",
               "reflects": true
             },
             {
@@ -17100,22 +17772,6 @@
                 "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",
@@ -17143,78 +17799,103 @@
               "name": "auroMenuOption-click",
               "type": {
                 "text": "CustomEvent"
-              },
-              "description": "Notifies that this option has been clicked."
+              }
             }
           ],
           "attributes": [
             {
-              "name": "noCheckmark",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
+              "description": "When true, disables the menu option.",
               "default": "false",
-              "fieldName": "noCheckmark"
+              "fieldName": "disabled"
             },
             {
-              "name": "selected",
+              "name": "event",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "selected"
+              "fieldName": "event"
             },
             {
-              "name": "disabled",
+              "name": "layout",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "disabled"
+              "description": "Defines the language of an element.",
+              "default": "{'default'}",
+              "fieldName": "layout",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
             },
             {
-              "name": "value",
+              "name": "key",
               "type": {
                 "text": "string"
               },
-              "fieldName": "value"
+              "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"
             },
             {
-              "name": "tabIndex",
+              "name": "menuService",
               "type": {
-                "text": "number"
+                "text": "null"
               },
-              "default": "-1",
-              "fieldName": "tabIndex"
+              "default": "null",
+              "fieldName": "menuService"
             },
             {
-              "name": "event",
+              "name": "matchWord",
               "type": {
                 "text": "string"
               },
-              "fieldName": "event"
+              "fieldName": "matchWord"
+            },
+            {
+              "name": "noCheckmark",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "noCheckmark"
             },
             {
               "name": "nomatch",
               "type": {
                 "text": "boolean"
               },
-              "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.",
+              "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.",
               "default": "false",
               "fieldName": "noMatch"
             },
             {
-              "name": "layout",
+              "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",
               "type": {
                 "text": "string"
               },
-              "description": "Defines the language of an element.",
-              "default": "{'default'}",
-              "fieldName": "layout",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "description": "Specifies the value to be sent to a server.",
+              "fieldName": "value"
             },
             {
               "name": "shape",
@@ -19720,7 +20401,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(); // `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(); } }, }"
+          "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(); } }, }"
         }
       ],
       "exports": [
@@ -19733,41 +20414,6 @@
           }
         }
       ]
-    },
-    {
-      "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"
-          }
-        }
-      ]
     }
   ]
 }