@aurodesignsystem-dev/auro-formkit 0.0.0-pr1498.0 → 0.0.0-pr1499.0

package/custom-elements.json

@@ -4,35 +4,35 @@
   "modules": [
     {
       "kind": "javascript-module",
-      "path": "components/bibtemplate/src/auro-bibtemplate.js",
+      "path": "components/checkbox/src/auro-checkbox-group.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "The `auro-bibtemplate` element provides users a template for creating modal dialog elements.",
-          "name": "AuroBibtemplate",
+          "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
+          "name": "AuroCheckboxGroup",
           "slots": [
             {
-              "description": "The default slot for the main content.",
-              "name": "default"
-            },
-            {
-              "description": "Slot for the header content.",
-              "name": "header"
+              "description": "Allows for the legend to be overridden.",
+              "name": "legend"
             },
             {
-              "description": "Slot for the subheader content.",
-              "name": "subheader"
+              "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
+              "name": "optionalLabel"
             },
             {
-              "description": "Slot for the footer content.",
-              "name": "footer"
+              "description": "Allows for the helper text to be overridden.",
+              "name": "helpText"
             },
             {
-              "description": "Slot for the close button aria-label.",
-              "name": "ariaLabel.close"
+              "description": "The default slot for the checkbox items.",
+              "name": "default"
             }
           ],
           "members": [
+            {
+              "kind": "method",
+              "name": "_initializeDefaults"
+            },
             {
               "kind": "method",
               "name": "register",
@@ -40,8 +40,8 @@
               "parameters": [
                 {
                   "name": "name",
-                  "default": "\"auro-bibtemplate\"",
-                  "description": "The name of element that you want to register to.",
+                  "default": "\"auro-checkbox-group\"",
+                  "description": "The name of the element that you want to register.",
                   "optional": true,
                   "type": {
                     "text": "string"
@@ -52,17 +52,25 @@
             },
             {
               "kind": "method",
-              "name": "preventBodyScroll",
+              "name": "handleValueUpdate",
               "parameters": [
                 {
-                  "name": "event",
-                  "description": "The touchmove event.",
+                  "name": "value",
+                  "description": "The value of the checkbox.",
                   "type": {
-                    "text": "Event"
+                    "text": "String"
+                  }
+                },
+                {
+                  "name": "selected",
+                  "description": "The checked state of the checkbox.",
+                  "type": {
+                    "text": "Boolean"
                   }
                 }
               ],
-              "description": "Prevents scrolling of the body when touching empty areas of the component.",
+              "description": "Helper method to handle checkbox value changing.",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
@@ -71,8 +79,9 @@
             },
             {
               "kind": "method",
-              "name": "focusCloseButton",
-              "description": "Focuses the close button inside the bibtemplate's shadow DOM.\nUsed by parent components to set initial focus when the fullscreen dialog opens.",
+              "name": "handlePreselectedItems",
+              "description": "Helper method that handles the state of preselected checkboxes.",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
@@ -81,213 +90,308 @@
             },
             {
               "kind": "method",
-              "name": "onCloseButtonClick"
+              "name": "handleItems",
+              "description": "Helper method that handles the state of checkboxes.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "exposeCssParts",
-              "description": "Exposes CSS parts for styling from parent components.",
+              "name": "reset",
+              "description": "Resets component to initial state.",
               "return": {
                 "type": {
                   "text": "void"
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "validate",
+              "parameters": [
+                {
+                  "name": "force",
+                  "default": "false",
+                  "description": "Whether to force validation.",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Validates value."
+            },
             {
               "kind": "field",
-              "name": "large",
+              "name": "appearance",
+              "privacy": "public",
+              "type": {
+                "text": "'default' | 'inverse'"
+              },
+              "description": "Defines whether the component will be on lighter or darker backgrounds.",
+              "default": "'default'",
+              "attribute": "appearance",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
               "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "attribute": "large",
+              "description": "If set, disables the checkbox group.",
+              "attribute": "disabled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "iconTag",
-              "privacy": "private"
+              "name": "error",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
+              "attribute": "error",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "headerTag",
-              "privacy": "private"
+              "name": "horizontal",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set, checkboxes will be aligned horizontally.",
+              "attribute": "horizontal",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "buttonTag",
-              "privacy": "private"
+              "name": "noValidate",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set, disables auto-validation on blur.",
+              "attribute": "noValidate",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "isFullscreen",
+              "name": "onDark",
               "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "attribute": "isFullscreen",
+              "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
+              "attribute": "onDark",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "showFooter",
+              "name": "required",
               "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
-              "attribute": "showFooter",
+              "description": "Populates the `required` attribute on the element. Used for client-side validation.",
+              "attribute": "required",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "setCustomValidity",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Sets a custom help text message to display for all validityStates.",
+              "attribute": "setCustomValidity"
+            },
+            {
+              "kind": "field",
+              "name": "setCustomValidityCustomError",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Custom help text message to display when validity = `customError`.",
+              "attribute": "setCustomValidityCustomError"
+            },
+            {
+              "kind": "field",
+              "name": "setCustomValidityValueMissing",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Custom help text message to display when validity = `valueMissing`.",
+              "attribute": "setCustomValidityValueMissing"
+            },
+            {
+              "kind": "field",
+              "name": "validity",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Specifies the `validityState` this element is in.",
+              "attribute": "validity",
               "reflects": true
             }
           ],
           "events": [
             {
-              "name": "close-click",
+              "name": "input",
               "type": {
-                "text": "Event"
+                "text": "CustomEvent"
               }
             },
             {
-              "name": "auro-bibtemplate-connected",
-              "type": {
-                "text": "CustomEvent"
-              }
+              "description": "Notifies that the `validity` and `errorMessage` values have changed.",
+              "name": "auroFormElement-validated"
             }
           ],
           "attributes": [
             {
-              "name": "isFullscreen",
+              "name": "appearance",
+              "type": {
+                "text": "'default' | 'inverse'"
+              },
+              "description": "Defines whether the component will be on lighter or darker backgrounds.",
+              "default": "'default'",
+              "fieldName": "appearance"
+            },
+            {
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
-              "fieldName": "isFullscreen"
+              "description": "If set, disables the checkbox group.",
+              "fieldName": "disabled"
             },
             {
-              "name": "large",
+              "name": "error",
+              "type": {
+                "text": "string"
+              },
+              "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
+              "fieldName": "error"
+            },
+            {
+              "name": "horizontal",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "fieldName": "large"
+              "description": "If set, checkboxes will be aligned horizontally.",
+              "fieldName": "horizontal"
             },
             {
-              "name": "showFooter",
+              "name": "noValidate",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
-              "fieldName": "showFooter"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "auro-bibtemplate",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AuroBibtemplate",
-          "declaration": {
-            "name": "AuroBibtemplate",
-            "module": "components/bibtemplate/src/auro-bibtemplate.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/bibtemplate/src/buttonVersion.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "12.3.2",
-            "module": "components/bibtemplate/src/buttonVersion.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/bibtemplate/src/headerVersion.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "5.0.1",
-            "module": "components/bibtemplate/src/headerVersion.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/bibtemplate/src/iconVersion.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "9.2.0",
-            "module": "components/bibtemplate/src/iconVersion.js"
-          }
+              "description": "If set, disables auto-validation on blur.",
+              "fieldName": "noValidate"
+            },
+            {
+              "name": "onDark",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
+              "fieldName": "onDark"
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Populates the `required` attribute on the element. Used for client-side validation.",
+              "fieldName": "required"
+            },
+            {
+              "name": "setCustomValidity",
+              "type": {
+                "text": "string"
+              },
+              "description": "Sets a custom help text message to display for all validityStates.",
+              "fieldName": "setCustomValidity"
+            },
+            {
+              "name": "setCustomValidityCustomError",
+              "type": {
+                "text": "string"
+              },
+              "description": "Custom help text message to display when validity = `customError`.",
+              "fieldName": "setCustomValidityCustomError"
+            },
+            {
+              "name": "setCustomValidityValueMissing",
+              "type": {
+                "text": "string"
+              },
+              "description": "Custom help text message to display when validity = `valueMissing`.",
+              "fieldName": "setCustomValidityValueMissing"
+            },
+            {
+              "name": "validity",
+              "type": {
+                "text": "string"
+              },
+              "description": "Specifies the `validityState` this element is in.",
+              "fieldName": "validity"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "auro-checkbox-group",
+          "customElement": true
         }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/bibtemplate/src/index.js",
-      "declarations": [],
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "AuroBibtemplate",
+          "name": "AuroCheckboxGroup",
           "declaration": {
-            "name": "AuroBibtemplate",
-            "module": "components/bibtemplate/src/index.js"
+            "name": "AuroCheckboxGroup",
+            "module": "components/checkbox/src/auro-checkbox-group.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/bibtemplate/src/registered.js",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/checkbox/src/auro-checkbox-group.js",
+      "path": "components/checkbox/src/auro-checkbox.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
-          "name": "AuroCheckboxGroup",
-          "slots": [
+          "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
+          "name": "AuroCheckbox",
+          "cssParts": [
             {
-              "description": "Allows for the legend to be overridden.",
-              "name": "legend"
+              "description": "apply css to a specific checkbox.",
+              "name": "checkbox"
             },
             {
-              "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
-              "name": "optionalLabel"
+              "description": "apply css to a specific checkbox's input.",
+              "name": "checkbox-input"
             },
             {
-              "description": "Allows for the helper text to be overridden.",
-              "name": "helpText"
-            },
+              "description": "apply css to a specific checkbox's label.",
+              "name": "checkbox-label"
+            }
+          ],
+          "slots": [
             {
-              "description": "The default slot for the checkbox items.",
+              "description": "The default slot for the checkbox label.",
               "name": "default"
             }
           ],
@@ -303,8 +407,8 @@
               "parameters": [
                 {
                   "name": "name",
-                  "default": "\"auro-checkbox-group\"",
-                  "description": "The name of the element that you want to register.",
+                  "default": "\"auro-checkbox\"",
+                  "description": "The name of element that you want to register to.",
                   "optional": true,
                   "type": {
                     "text": "string"
@@ -315,24 +419,37 @@
             },
             {
               "kind": "method",
-              "name": "handleValueUpdate",
+              "name": "handleChange",
               "parameters": [
                 {
-                  "name": "value",
-                  "description": "The value of the checkbox.",
+                  "name": "event",
+                  "description": "The change event from the checkbox input.",
                   "type": {
-                    "text": "String"
+                    "text": "Event"
                   }
-                },
+                }
+              ],
+              "description": "Handles the change event for the checkbox input.\nUpdates the checked state and dispatches a corresponding custom event.\nThis custom event is only for the purpose of supporting IE.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleInput",
+              "parameters": [
                 {
-                  "name": "selected",
-                  "description": "The checked state of the checkbox.",
+                  "name": "event",
+                  "description": "The input event from the checkbox input.",
                   "type": {
-                    "text": "Boolean"
+                    "text": "Event"
                   }
                 }
               ],
-              "description": "Helper method to handle checkbox value changing.",
+              "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -342,8 +459,8 @@
             },
             {
               "kind": "method",
-              "name": "handlePreselectedItems",
-              "description": "Helper method that handles the state of preselected checkboxes.",
+              "name": "handleFocusin",
+              "description": "Function to support",
               "privacy": "private",
               "return": {
                 "type": {
@@ -353,12 +470,12 @@
             },
             {
               "kind": "method",
-              "name": "handleItems",
-              "description": "Helper method that handles the state of checkboxes.",
+              "name": "generateIconHtml",
+              "description": "Function to generate checkmark svg.",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "HTMLElement"
                 }
               }
             },
@@ -374,19 +491,34 @@
             },
             {
               "kind": "method",
-              "name": "validate",
+              "name": "updateAriaLabel",
+              "description": "Updates the aria-label based on slot content.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleKeyDown",
               "parameters": [
                 {
-                  "name": "force",
-                  "default": "false",
-                  "description": "Whether to force validation.",
-                  "optional": true,
+                  "name": "event",
+                  "description": "The keydown event from the checkbox input.",
                   "type": {
-                    "text": "boolean"
+                    "text": "KeyboardEvent"
                   }
                 }
               ],
-              "description": "Validates value."
+              "description": "Handles keydown event to toggle the checkbox with Space key.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "field",
@@ -400,6 +532,17 @@
               "attribute": "appearance",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "checked",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set to true, the checkbox will be filled with a checkmark.",
+              "attribute": "checked",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -407,7 +550,7 @@
               "type": {
                 "text": "boolean"
               },
-              "description": "If set, disables the checkbox group.",
+              "description": "If set to true, the checkbox will not be clickable.",
               "attribute": "disabled",
               "reflects": true
             },
@@ -416,33 +559,41 @@
               "name": "error",
               "privacy": "public",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
+              "description": "If set to true, the checkbox will be displayed with an error state.",
               "attribute": "error",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "horizontal",
+              "name": "id",
               "privacy": "public",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If set, checkboxes will be aligned horizontally.",
-              "attribute": "horizontal",
+              "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
+              "attribute": "id",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "noValidate",
+              "name": "inputId",
+              "privacy": "private",
+              "type": {
+                "text": "string"
+              },
+              "description": "The id for input node."
+            },
+            {
+              "kind": "field",
+              "name": "name",
               "privacy": "public",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If set, disables auto-validation on blur.",
-              "attribute": "noValidate",
-              "reflects": true
+              "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
+              "attribute": "name"
             },
             {
               "kind": "field",
@@ -457,67 +608,94 @@
             },
             {
               "kind": "field",
-              "name": "required",
-              "privacy": "public",
+              "name": "touched",
+              "privacy": "private",
               "type": {
                 "text": "boolean"
               },
-              "description": "Populates the `required` attribute on the element. Used for client-side validation.",
-              "attribute": "required",
-              "reflects": true
+              "description": "Indicates whether the checkbox has been interacted with."
             },
             {
               "kind": "field",
-              "name": "setCustomValidity",
+              "name": "value",
               "privacy": "public",
               "type": {
                 "text": "string"
               },
-              "description": "Sets a custom help text message to display for all validityStates.",
-              "attribute": "setCustomValidity"
+              "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
+              "attribute": "value"
             },
             {
               "kind": "field",
-              "name": "setCustomValidityCustomError",
-              "privacy": "public",
+              "name": "tabIndex",
+              "privacy": "private",
+              "type": {
+                "text": "number"
+              },
+              "description": "The tabindex attribute for the checkbox.",
+              "attribute": "tabindex",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "ariaChecked",
+              "privacy": "private",
               "type": {
                 "text": "string"
               },
-              "description": "Custom help text message to display when validity = `customError`.",
-              "attribute": "setCustomValidityCustomError"
+              "description": "The aria-checked attribute for the checkbox.",
+              "attribute": "aria-checked",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "setCustomValidityValueMissing",
-              "privacy": "public",
+              "name": "ariaDisabled",
+              "privacy": "private",
               "type": {
                 "text": "string"
               },
-              "description": "Custom help text message to display when validity = `valueMissing`.",
-              "attribute": "setCustomValidityValueMissing"
+              "description": "The aria-disabled attribute for the checkbox.",
+              "attribute": "aria-disabled",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "validity",
-              "privacy": "public",
+              "name": "role",
+              "privacy": "private",
               "type": {
                 "text": "string"
               },
-              "description": "Specifies the `validityState` this element is in.",
-              "attribute": "validity",
+              "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
+              "attribute": "role",
               "reflects": true
             }
           ],
           "events": [
             {
-              "name": "input",
+              "name": "auroCheckbox-input",
               "type": {
                 "text": "CustomEvent"
               }
             },
             {
-              "description": "Notifies that the `validity` and `errorMessage` values have changed.",
-              "name": "auroFormElement-validated"
+              "name": "auroCheckbox-focusin",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "auroCheckbox-focusout",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "description": "(Deprecated) Notifies when checked value is changed.",
+              "name": "change"
+            },
+            {
+              "description": "Notifies when when checked value is changed by user's interface.",
+              "name": "input"
             }
           ],
           "attributes": [
@@ -530,37 +708,45 @@
               "default": "'default'",
               "fieldName": "appearance"
             },
+            {
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set to true, the checkbox will be filled with a checkmark.",
+              "fieldName": "checked"
+            },
             {
               "name": "disabled",
               "type": {
                 "text": "boolean"
               },
-              "description": "If set, disables the checkbox group.",
+              "description": "If set to true, the checkbox will not be clickable.",
               "fieldName": "disabled"
             },
             {
               "name": "error",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
+              "description": "If set to true, the checkbox will be displayed with an error state.",
               "fieldName": "error"
             },
             {
-              "name": "horizontal",
+              "name": "id",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If set, checkboxes will be aligned horizontally.",
-              "fieldName": "horizontal"
+              "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
+              "fieldName": "id"
             },
             {
-              "name": "noValidate",
+              "name": "name",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If set, disables auto-validation on blur.",
-              "fieldName": "noValidate"
+              "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
+              "fieldName": "name"
             },
             {
               "name": "onDark",
@@ -571,98 +757,125 @@
               "fieldName": "onDark"
             },
             {
-              "name": "required",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "Populates the `required` attribute on the element. Used for client-side validation.",
-              "fieldName": "required"
+              "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
+              "fieldName": "value"
             },
             {
-              "name": "setCustomValidity",
+              "name": "tabindex",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "description": "Sets a custom help text message to display for all validityStates.",
-              "fieldName": "setCustomValidity"
+              "description": "The tabindex attribute for the checkbox.",
+              "fieldName": "tabIndex"
             },
             {
-              "name": "setCustomValidityCustomError",
+              "name": "aria-checked",
               "type": {
                 "text": "string"
               },
-              "description": "Custom help text message to display when validity = `customError`.",
-              "fieldName": "setCustomValidityCustomError"
+              "description": "The aria-checked attribute for the checkbox.",
+              "fieldName": "ariaChecked"
             },
             {
-              "name": "setCustomValidityValueMissing",
+              "name": "aria-disabled",
               "type": {
                 "text": "string"
               },
-              "description": "Custom help text message to display when validity = `valueMissing`.",
-              "fieldName": "setCustomValidityValueMissing"
+              "description": "The aria-disabled attribute for the checkbox.",
+              "fieldName": "ariaDisabled"
             },
             {
-              "name": "validity",
+              "name": "role",
               "type": {
                 "text": "string"
               },
-              "description": "Specifies the `validityState` this element is in.",
-              "fieldName": "validity"
+              "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
+              "fieldName": "role"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "auro-checkbox-group",
+          "tagName": "auro-checkbox",
           "customElement": true
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "AuroCheckbox",
+          "declaration": {
+            "name": "AuroCheckbox",
+            "module": "components/checkbox/src/auro-checkbox.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/checkbox/src/index.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AuroCheckbox",
+          "declaration": {
+            "name": "AuroCheckbox",
+            "module": "components/checkbox/src/index.js"
+          }
+        },
         {
           "kind": "js",
           "name": "AuroCheckboxGroup",
           "declaration": {
             "name": "AuroCheckboxGroup",
-            "module": "components/checkbox/src/auro-checkbox-group.js"
+            "module": "components/checkbox/src/index.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/checkbox/src/auro-checkbox.js",
+      "path": "components/checkbox/src/registered.js",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/bibtemplate/src/auro-bibtemplate.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
-          "name": "AuroCheckbox",
-          "cssParts": [
+          "description": "The `auro-bibtemplate` element provides users a template for creating modal dialog elements.",
+          "name": "AuroBibtemplate",
+          "slots": [
             {
-              "description": "apply css to a specific checkbox.",
-              "name": "checkbox"
+              "description": "The default slot for the main content.",
+              "name": "default"
             },
             {
-              "description": "apply css to a specific checkbox's input.",
-              "name": "checkbox-input"
+              "description": "Slot for the header content.",
+              "name": "header"
             },
             {
-              "description": "apply css to a specific checkbox's label.",
-              "name": "checkbox-label"
-            }
-          ],
-          "slots": [
+              "description": "Slot for the subheader content.",
+              "name": "subheader"
+            },
             {
-              "description": "The default slot for the checkbox label.",
-              "name": "default"
+              "description": "Slot for the footer content.",
+              "name": "footer"
+            },
+            {
+              "description": "Slot for the close button aria-label.",
+              "name": "ariaLabel.close"
             }
           ],
           "members": [
-            {
-              "kind": "method",
-              "name": "_initializeDefaults"
-            },
             {
               "kind": "method",
               "name": "register",
@@ -670,7 +883,7 @@
               "parameters": [
                 {
                   "name": "name",
-                  "default": "\"auro-checkbox\"",
+                  "default": "\"auro-bibtemplate\"",
                   "description": "The name of element that you want to register to.",
                   "optional": true,
                   "type": {
@@ -682,38 +895,17 @@
             },
             {
               "kind": "method",
-              "name": "handleChange",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The change event from the checkbox input.",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Handles the change event for the checkbox input.\nUpdates the checked state and dispatches a corresponding custom event.\nThis custom event is only for the purpose of supporting IE.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "handleInput",
+              "name": "preventBodyScroll",
               "parameters": [
                 {
                   "name": "event",
-                  "description": "The input event from the checkbox input.",
+                  "description": "The touchmove event.",
                   "type": {
                     "text": "Event"
                   }
                 }
               ],
-              "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
-              "privacy": "private",
+              "description": "Prevents scrolling of the body when touching empty areas of the component.",
               "return": {
                 "type": {
                   "text": "void"
@@ -722,9 +914,8 @@
             },
             {
               "kind": "method",
-              "name": "handleFocusin",
-              "description": "Function to support",
-              "privacy": "private",
+              "name": "focusCloseButton",
+              "description": "Focuses the close button inside the bibtemplate's shadow DOM.\nUsed by parent components to set initial focus when the fullscreen dialog opens.",
               "return": {
                 "type": {
                   "text": "void"
@@ -733,378 +924,187 @@
             },
             {
               "kind": "method",
-              "name": "generateIconHtml",
-              "description": "Function to generate checkmark svg.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement"
-                }
-              }
+              "name": "onCloseButtonClick"
             },
             {
               "kind": "method",
-              "name": "reset",
-              "description": "Resets component to initial state.",
+              "name": "exposeCssParts",
+              "description": "Exposes CSS parts for styling from parent components.",
               "return": {
                 "type": {
                   "text": "void"
                 }
               }
             },
-            {
-              "kind": "method",
-              "name": "updateAriaLabel",
-              "description": "Updates the aria-label based on slot content.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "handleKeyDown",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The keydown event from the checkbox input.",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ],
-              "description": "Handles keydown event to toggle the checkbox with Space key.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "appearance",
-              "privacy": "public",
-              "type": {
-                "text": "'default' | 'inverse'"
-              },
-              "description": "Defines whether the component will be on lighter or darker backgrounds.",
-              "default": "'default'",
-              "attribute": "appearance",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "checked",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set to true, the checkbox will be filled with a checkmark.",
-              "attribute": "checked",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "disabled",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set to true, the checkbox will not be clickable.",
-              "attribute": "disabled",
-              "reflects": true
-            },
             {
               "kind": "field",
-              "name": "error",
+              "name": "large",
               "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "If set to true, the checkbox will be displayed with an error state.",
-              "attribute": "error",
+              "default": "false",
+              "attribute": "large",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "id",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
-              "attribute": "id",
-              "reflects": true
+              "name": "iconTag",
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "inputId",
-              "privacy": "private",
-              "type": {
-                "text": "string"
-              },
-              "description": "The id for input node."
+              "name": "headerTag",
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "name",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
-              "attribute": "name"
+              "name": "buttonTag",
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "onDark",
+              "name": "isFullscreen",
               "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
-              "attribute": "onDark",
+              "attribute": "isFullscreen",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "touched",
-              "privacy": "private",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Indicates whether the checkbox has been interacted with."
-            },
-            {
-              "kind": "field",
-              "name": "value",
+              "name": "showFooter",
               "privacy": "public",
               "type": {
-                "text": "string"
-              },
-              "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
-              "attribute": "value"
-            },
-            {
-              "kind": "field",
-              "name": "tabIndex",
-              "privacy": "private",
-              "type": {
-                "text": "number"
-              },
-              "description": "The tabindex attribute for the checkbox.",
-              "attribute": "tabindex",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "ariaChecked",
-              "privacy": "private",
-              "type": {
-                "text": "string"
-              },
-              "description": "The aria-checked attribute for the checkbox.",
-              "attribute": "aria-checked",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "ariaDisabled",
-              "privacy": "private",
-              "type": {
-                "text": "string"
-              },
-              "description": "The aria-disabled attribute for the checkbox.",
-              "attribute": "aria-disabled",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "role",
-              "privacy": "private",
-              "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
-              "attribute": "role",
+              "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
+              "attribute": "showFooter",
               "reflects": true
             }
           ],
           "events": [
             {
-              "name": "auroCheckbox-input",
-              "type": {
-                "text": "CustomEvent"
-              }
-            },
-            {
-              "name": "auroCheckbox-focusin",
+              "name": "close-click",
               "type": {
-                "text": "CustomEvent"
+                "text": "Event"
               }
             },
             {
-              "name": "auroCheckbox-focusout",
+              "name": "auro-bibtemplate-connected",
               "type": {
                 "text": "CustomEvent"
               }
-            },
-            {
-              "description": "(Deprecated) Notifies when checked value is changed.",
-              "name": "change"
-            },
-            {
-              "description": "Notifies when when checked value is changed by user's interface.",
-              "name": "input"
             }
           ],
           "attributes": [
             {
-              "name": "appearance",
-              "type": {
-                "text": "'default' | 'inverse'"
-              },
-              "description": "Defines whether the component will be on lighter or darker backgrounds.",
-              "default": "'default'",
-              "fieldName": "appearance"
-            },
-            {
-              "name": "checked",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set to true, the checkbox will be filled with a checkmark.",
-              "fieldName": "checked"
-            },
-            {
-              "name": "disabled",
+              "name": "isFullscreen",
               "type": {
                 "text": "boolean"
               },
-              "description": "If set to true, the checkbox will not be clickable.",
-              "fieldName": "disabled"
+              "fieldName": "isFullscreen"
             },
             {
-              "name": "error",
+              "name": "large",
               "type": {
                 "text": "boolean"
               },
-              "description": "If set to true, the checkbox will be displayed with an error state.",
-              "fieldName": "error"
-            },
-            {
-              "name": "id",
-              "type": {
-                "text": "string"
-              },
-              "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
-              "fieldName": "id"
-            },
-            {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
-              "fieldName": "name"
+              "default": "false",
+              "fieldName": "large"
             },
             {
-              "name": "onDark",
+              "name": "showFooter",
               "type": {
                 "text": "boolean"
               },
-              "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
-              "fieldName": "onDark"
-            },
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
-              "fieldName": "value"
-            },
-            {
-              "name": "tabindex",
-              "type": {
-                "text": "number"
-              },
-              "description": "The tabindex attribute for the checkbox.",
-              "fieldName": "tabIndex"
-            },
-            {
-              "name": "aria-checked",
-              "type": {
-                "text": "string"
-              },
-              "description": "The aria-checked attribute for the checkbox.",
-              "fieldName": "ariaChecked"
-            },
-            {
-              "name": "aria-disabled",
-              "type": {
-                "text": "string"
-              },
-              "description": "The aria-disabled attribute for the checkbox.",
-              "fieldName": "ariaDisabled"
-            },
-            {
-              "name": "role",
-              "type": {
-                "text": "string"
-              },
-              "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
-              "fieldName": "role"
+              "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
+              "fieldName": "showFooter"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "auro-checkbox",
+          "tagName": "auro-bibtemplate",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AuroCheckbox",
+          "name": "AuroBibtemplate",
           "declaration": {
-            "name": "AuroCheckbox",
-            "module": "components/checkbox/src/auro-checkbox.js"
+            "name": "AuroBibtemplate",
+            "module": "components/bibtemplate/src/auro-bibtemplate.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/checkbox/src/index.js",
+      "path": "components/bibtemplate/src/buttonVersion.js",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "AuroCheckbox",
+          "name": "default",
           "declaration": {
-            "name": "AuroCheckbox",
-            "module": "components/checkbox/src/index.js"
+            "name": "12.3.2",
+            "module": "components/bibtemplate/src/buttonVersion.js"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/bibtemplate/src/headerVersion.js",
+      "declarations": [],
+      "exports": [
         {
           "kind": "js",
-          "name": "AuroCheckboxGroup",
+          "name": "default",
           "declaration": {
-            "name": "AuroCheckboxGroup",
-            "module": "components/checkbox/src/index.js"
+            "name": "5.0.1",
+            "module": "components/bibtemplate/src/headerVersion.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/checkbox/src/registered.js",
+      "path": "components/bibtemplate/src/iconVersion.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "9.2.0",
+            "module": "components/bibtemplate/src/iconVersion.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/bibtemplate/src/index.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AuroBibtemplate",
+          "declaration": {
+            "name": "AuroBibtemplate",
+            "module": "components/bibtemplate/src/index.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/bibtemplate/src/registered.js",
       "declarations": [],
       "exports": []
     },
@@ -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",
@@ -15224,47 +15180,586 @@
               "fieldName": "simple"
             },
             {
-              "name": "spellcheck",
-              "type": {
-                "text": "string"
-              },
-              "description": "An enumerated attribute defines whether the element may be checked for spelling errors. [true, false]. When set to `false` the attribute `autocorrect` is set to `off` and `autocapitalize` is set to `none`.",
-              "fieldName": "spellcheck"
+              "name": "spellcheck",
+              "type": {
+                "text": "string"
+              },
+              "description": "An enumerated attribute defines whether the element may be checked for spelling errors. [true, false]. When set to `false` the attribute `autocorrect` is set to `off` and `autocapitalize` is set to `none`.",
+              "fieldName": "spellcheck"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number'"
+              },
+              "description": "Populates the `type` attribute on the input.",
+              "default": "'text'",
+              "fieldName": "type"
+            },
+            {
+              "name": "validateOnInput",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Sets validation mode to re-eval with each input.",
+              "fieldName": "validateOnInput"
+            },
+            {
+              "name": "validity",
+              "type": {
+                "text": "string"
+              },
+              "description": "Specifies the `validityState` this element is in.",
+              "fieldName": "validity"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "Populates the `value` attribute on the input. Can also be read to retrieve the current value of the input.\nThe format for this property should be ISO for `date` type inputs.",
+              "default": "undefined",
+              "fieldName": "value"
+            },
+            {
+              "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": "shape",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "shape",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "size",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
+            },
+            {
+              "name": "ondark",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "onDark",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
+            }
+          ],
+          "superclass": {
+            "name": "AuroElement",
+            "module": "/components/layoutElement/src/auroElement.js"
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "BaseInput",
+            "module": "components/input/src/base-input.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/input/src/buttonVersion.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "12.3.2",
+            "module": "components/input/src/buttonVersion.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/input/src/i18n.js",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "i18n",
+          "parameters": [
+            {
+              "name": "lang",
+              "description": "Requested lang for content return.",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "requestedString",
+              "description": "String requested in context.",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Function to support the selected of a string in the set lang.",
+          "privacy": "private",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          }
+        },
+        {
+          "kind": "function",
+          "name": "notifyOnLangChange",
+          "parameters": [
+            {
+              "name": "element",
+              "description": "Pass in the scope of the element in use.",
+              "type": {
+                "text": "object"
+              }
+            }
+          ],
+          "privacy": "private"
+        },
+        {
+          "kind": "function",
+          "name": "stopNotifyingOnLangChange",
+          "parameters": [
+            {
+              "name": "element",
+              "description": "Pass in the scope of the element in use.",
+              "type": {
+                "text": "object"
+              }
+            }
+          ],
+          "privacy": "private"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "i18n",
+            "module": "components/input/src/i18n.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "notifyOnLangChange",
+          "declaration": {
+            "name": "notifyOnLangChange",
+            "module": "components/input/src/i18n.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "stopNotifyingOnLangChange",
+          "declaration": {
+            "name": "stopNotifyingOnLangChange",
+            "module": "components/input/src/i18n.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/input/src/iconVersion.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "9.2.0",
+            "module": "components/input/src/iconVersion.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/input/src/index.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AuroInput",
+          "declaration": {
+            "name": "AuroInput",
+            "module": "components/input/src/index.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AuroInputUtil",
+          "declaration": {
+            "name": "AuroInputUtil",
+            "module": "components/input/src/index.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/input/src/registered.js",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/input/src/utilities.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AuroInputUtilities",
+          "members": [
+            {
+              "kind": "method",
+              "name": "updateFormat",
+              "parameters": [
+                {
+                  "name": "newFormat",
+                  "description": "New date format string.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Updates the date format override.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toDateFnsMask",
+              "parameters": [
+                {
+                  "name": "mask",
+                  "description": "IMask date mask (e.g. \"MM/DD/YYYY\").",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Converts an IMask-style date mask to a date-fns compatible format string.",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getDateMaskFromLocale",
+              "parameters": [
+                {
+                  "name": "locale",
+                  "description": "BCP 47 language tag (e.g. \"en-US\", \"fr-FR\", \"ja-JP\").",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Generates a date mask based on the provided locale.",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "parseDateByMask",
+              "parameters": [
+                {
+                  "name": "dateString",
+                  "description": "The date string to parse.",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "mask",
+                  "description": "The date mask to use for parsing.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Parses a date string using the provided mask.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getMaskOptions",
+              "parameters": [
+                {
+                  "name": "type",
+                  "description": "The input type.",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "format",
+                  "description": "The format of the mask to apply.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Configures the mask to be used on the input element based on format and/or type.\nIMask tool documentation: https://imask.js.org/.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "object"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "isFullDateFormat",
+              "parameters": [
+                {
+                  "name": "type",
+                  "description": "The input type.",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "format",
+                  "description": "The date format string.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Determines if the given type and format combination represents a full year/month/day date.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toModelValue",
+              "parameters": [
+                {
+                  "name": "inputValue",
+                  "description": "String from the rendered input.",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "format",
+                  "description": "The date format string.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Converts a display string to its model value.\nFor full date formats, converts the display string to an ISO date string.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "toFormattedValue",
+              "parameters": [
+                {
+                  "name": "valueObject",
+                  "description": "Date object representation of value.",
+                  "type": {
+                    "text": "Date|undefined"
+                  }
+                },
+                {
+                  "name": "format",
+                  "description": "The date format string.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Converts a model value to a display value for the input element.\nFor full date formats, converts an ISO model value to the configured display format.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | undefined"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "overrideFormat"
+            },
+            {
+              "kind": "field",
+              "name": "formatter",
+              "default": "new Intl.DateTimeFormat(this.locale)"
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getDateFormatFromLocale",
+          "parameters": [
+            {
+              "name": "locale",
+              "description": "BCP 47 language tag used to determine the date format (e.g. \"en-US\", \"fr-FR\").",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Derives a locale-aware date format string suitable for use in input masks. This helper exposes the internal AuroInputUtilities locale logic in a simple function form.",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AuroInputUtilities",
+          "declaration": {
+            "name": "AuroInputUtilities",
+            "module": "components/input/src/utilities.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getDateFormatFromLocale",
+          "declaration": {
+            "name": "getDateFormatFromLocale",
+            "module": "components/input/src/utilities.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/layoutElement/src/auroElement.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AuroElement",
+          "members": [
+            {
+              "kind": "field",
+              "name": "componentHasFocus",
+              "description": "Returns true if the element has focus.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "resetShapeClasses"
+            },
+            {
+              "kind": "method",
+              "name": "resetLayoutClasses"
+            },
+            {
+              "kind": "method",
+              "name": "updateComponentArchitecture"
             },
             {
-              "name": "type",
+              "kind": "field",
+              "name": "layout",
+              "privacy": "public",
               "type": {
-                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number'"
+                "text": "string"
               },
-              "description": "Populates the `type` attribute on the input.",
-              "default": "'text'",
-              "fieldName": "type"
+              "description": "Defines the language of an element.",
+              "default": "{'default'}",
+              "attribute": "layout",
+              "reflects": true
             },
             {
-              "name": "validateOnInput",
+              "kind": "field",
+              "name": "shape",
+              "privacy": "public",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "Sets validation mode to re-eval with each input.",
-              "fieldName": "validateOnInput"
+              "attribute": "shape",
+              "reflects": true
             },
             {
-              "name": "validity",
+              "kind": "field",
+              "name": "size",
+              "privacy": "public",
               "type": {
                 "text": "string"
               },
-              "description": "Specifies the `validityState` this element is in.",
-              "fieldName": "validity"
+              "attribute": "size",
+              "reflects": true
             },
             {
-              "name": "value",
+              "kind": "field",
+              "name": "onDark",
+              "privacy": "public",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Populates the `value` attribute on the input. Can also be read to retrieve the current value of the input.\nThe format for this property should be ISO for `date` type inputs.",
-              "default": "undefined",
-              "fieldName": "value"
-            },
+              "attribute": "ondark",
+              "reflects": true
+            }
+          ],
+          "attributes": [
             {
               "name": "layout",
               "type": {
@@ -15272,741 +15767,782 @@
               },
               "description": "Defines the language of an element.",
               "default": "{'default'}",
-              "fieldName": "layout",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "fieldName": "layout"
             },
             {
               "name": "shape",
               "type": {
                 "text": "string"
               },
-              "fieldName": "shape",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "fieldName": "shape"
             },
             {
               "name": "size",
               "type": {
                 "text": "string"
               },
-              "fieldName": "size",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "fieldName": "size"
             },
             {
               "name": "ondark",
               "type": {
                 "text": "boolean"
               },
-              "fieldName": "onDark",
-              "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
-              }
+              "fieldName": "onDark"
             }
           ],
           "superclass": {
-            "name": "AuroElement",
-            "module": "/components/layoutElement/src/auroElement.js"
-          }
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "default",
+          "name": "AuroElement",
           "declaration": {
-            "name": "BaseInput",
-            "module": "components/input/src/base-input.js"
+            "name": "AuroElement",
+            "module": "components/layoutElement/src/auroElement.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/input/src/buttonVersion.js",
+      "path": "components/layoutElement/src/index.js",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "default",
+          "name": "AuroElement",
           "declaration": {
-            "name": "12.3.2",
-            "module": "components/input/src/buttonVersion.js"
+            "name": "AuroElement",
+            "module": "components/layoutElement/src/index.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/input/src/i18n.js",
+      "path": "components/layoutElement/src/registered.js",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/menu/src/auro-menu-utils.js",
       "declarations": [
         {
           "kind": "function",
-          "name": "i18n",
+          "name": "arrayConverter",
           "parameters": [
             {
-              "name": "lang",
-              "description": "Requested lang for content return.",
+              "name": "value",
+              "description": "The value to be converted. Can be a string, array, or undefined.",
               "type": {
-                "text": "string"
+                "text": "any"
+              }
+            }
+          ],
+          "description": "Converts value to an array.\nIf the value is a JSON string representing an array, it will be parsed.\nIf the value is already an array, it is returned.\nIf the value is undefined, it returns undefined.",
+          "privacy": "private",
+          "return": {
+            "type": {
+              "text": "Array|undefined"
+            }
+          }
+        },
+        {
+          "kind": "function",
+          "name": "arraysAreEqual",
+          "parameters": [
+            {
+              "name": "arr1",
+              "description": "First array to compare.",
+              "type": {
+                "text": "Array"
               }
             },
             {
-              "name": "requestedString",
-              "description": "String requested in context.",
+              "name": "arr2",
+              "description": "Second array to compare.",
               "type": {
-                "text": "string"
+                "text": "Array"
               }
             }
           ],
-          "description": "Function to support the selected of a string in the set lang.",
+          "description": "Compare two arrays for equality.",
           "privacy": "private",
           "return": {
             "type": {
-              "text": "string"
+              "text": "boolean"
             }
           }
         },
         {
           "kind": "function",
-          "name": "notifyOnLangChange",
+          "name": "isOptionInteractive",
           "parameters": [
             {
-              "name": "element",
-              "description": "Pass in the scope of the element in use.",
+              "name": "option",
+              "description": "The option to check.",
               "type": {
-                "text": "object"
+                "text": "HTMLElement"
               }
             }
           ],
-          "privacy": "private"
+          "description": "Validates if an option can be interacted with.",
+          "privacy": "private",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          }
         },
         {
           "kind": "function",
-          "name": "stopNotifyingOnLangChange",
+          "name": "dispatchMenuEvent",
           "parameters": [
             {
               "name": "element",
-              "description": "Pass in the scope of the element in use.",
+              "description": "Element to dispatch event from.",
               "type": {
-                "text": "object"
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "eventName",
+              "description": "Name of the event to dispatch.",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "detail",
+              "default": "null",
+              "description": "Optional detail object to include with the event.",
+              "optional": true,
+              "type": {
+                "text": "Object"
               }
             }
           ],
-          "privacy": "private"
+          "description": "Helper method to dispatch custom events."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "default",
+          "name": "arrayConverter",
           "declaration": {
-            "name": "i18n",
-            "module": "components/input/src/i18n.js"
+            "name": "arrayConverter",
+            "module": "components/menu/src/auro-menu-utils.js"
           }
         },
         {
           "kind": "js",
-          "name": "notifyOnLangChange",
+          "name": "arraysAreEqual",
           "declaration": {
-            "name": "notifyOnLangChange",
-            "module": "components/input/src/i18n.js"
+            "name": "arraysAreEqual",
+            "module": "components/menu/src/auro-menu-utils.js"
           }
         },
         {
           "kind": "js",
-          "name": "stopNotifyingOnLangChange",
-          "declaration": {
-            "name": "stopNotifyingOnLangChange",
-            "module": "components/input/src/i18n.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/input/src/iconVersion.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "9.2.0",
-            "module": "components/input/src/iconVersion.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/input/src/index.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AuroInput",
+          "name": "isOptionInteractive",
           "declaration": {
-            "name": "AuroInput",
-            "module": "components/input/src/index.js"
+            "name": "isOptionInteractive",
+            "module": "components/menu/src/auro-menu-utils.js"
           }
         },
         {
           "kind": "js",
-          "name": "AuroInputUtil",
+          "name": "dispatchMenuEvent",
           "declaration": {
-            "name": "AuroInputUtil",
-            "module": "components/input/src/index.js"
+            "name": "dispatchMenuEvent",
+            "module": "components/menu/src/auro-menu-utils.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/input/src/registered.js",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/input/src/utilities.js",
+      "path": "components/menu/src/auro-menu.context.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "AuroInputUtilities",
+          "name": "MenuService",
           "members": [
+            {
+              "kind": "field",
+              "name": "menuOptions",
+              "description": "Gets the list of registered menu options.",
+              "return": {
+                "type": {
+                  "text": "AuroMenuOption[]"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "highlightedOption",
+              "description": "Gets the currently highlighted option.",
+              "return": {
+                "type": {
+                  "text": "AuroMenuOption|null"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "currentValue",
+              "description": "Gets the current value(s) of the selected option(s).",
+              "return": {
+                "type": {
+                  "text": "string|string[]|undefined"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "currentLabel",
+              "description": "Gets the label(s) of the currently selected option(s).",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "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.",
+              "return": {
+                "type": {
+                  "text": "string|undefined"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "currentKeys",
+              "description": "Gets the key(s) of the currently selected option(s).",
+              "return": {
+                "type": {
+                  "text": "string|string[]|undefined"
+                }
+              },
+              "readonly": true
+            },
             {
               "kind": "method",
-              "name": "updateFormat",
+              "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",
               "parameters": [
                 {
-                  "name": "newFormat",
-                  "description": "New date format string.",
+                  "name": "property",
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "any"
+                  }
                 }
               ],
-              "description": "Updates the date format override.",
-              "return": {
-                "type": {
-                  "text": "void"
+              "description": "Sets a property value if it exists on the instance and the value has changed."
+            },
+            {
+              "kind": "method",
+              "name": "setProperties",
+              "parameters": [
+                {
+                  "name": "properties",
+                  "description": "Key-value pairs of properties to set.",
+                  "type": {
+                    "text": "Object"
+                  }
                 }
-              }
+              ],
+              "description": "Sets multiple properties on the instance."
             },
             {
               "kind": "method",
-              "name": "toDateFnsMask",
+              "name": "highlightNext",
+              "description": "Highlights the next active option in the menu."
+            },
+            {
+              "kind": "method",
+              "name": "highlightPrevious",
+              "description": "Highlights the previous active option in the menu."
+            },
+            {
+              "kind": "method",
+              "name": "moveHighlightedOption",
               "parameters": [
                 {
-                  "name": "mask",
-                  "description": "IMask date mask (e.g. \"MM/DD/YYYY\").",
+                  "name": "direction",
+                  "description": "The direction to move the highlight (\"next\" or \"previous\").",
                   "type": {
                     "text": "string"
                   }
                 }
               ],
-              "description": "Converts an IMask-style date mask to a date-fns compatible format string.",
-              "return": {
-                "type": {
-                  "text": "string"
+              "description": "Moves the highlighted option in the specified direction."
+            },
+            {
+              "kind": "method",
+              "name": "setHighlightedOption",
+              "parameters": [
+                {
+                  "name": "option",
+                  "description": "The option to highlight.",
+                  "type": {
+                    "text": "AuroMenuOption"
+                  }
                 }
-              }
+              ],
+              "description": "Sets the highlighted index to the specified option."
             },
             {
               "kind": "method",
-              "name": "getDateMaskFromLocale",
+              "name": "setHighlightedIndex",
               "parameters": [
                 {
-                  "name": "locale",
-                  "description": "BCP 47 language tag (e.g. \"en-US\", \"fr-FR\", \"ja-JP\").",
-                  "optional": true,
+                  "name": "index",
                   "type": {
-                    "text": "string"
+                    "text": "number"
                   }
                 }
               ],
-              "description": "Generates a date mask based on the provided locale.",
-              "return": {
-                "type": {
-                  "text": "string"
+              "description": "Sets the highlighted option to the option at the specified index if it exists."
+            },
+            {
+              "kind": "method",
+              "name": "selectHighlightedOption",
+              "description": "Selects the currently highlighted option."
+            },
+            {
+              "kind": "method",
+              "name": "selectOptions",
+              "parameters": [
+                {
+                  "name": "options",
+                  "description": "Single option or array of options to select",
+                  "type": {
+                    "text": "AuroMenuOption|AuroMenuOption[]"
+                  }
                 }
-              }
+              ],
+              "description": "Selects one or more options in a batch operation"
             },
             {
               "kind": "method",
-              "name": "parseDateByMask",
+              "name": "deselectOptions",
               "parameters": [
                 {
-                  "name": "dateString",
-                  "description": "The date string to parse.",
+                  "name": "options",
+                  "description": "Single option or array of options to deselect",
                   "type": {
-                    "text": "string"
+                    "text": "AuroMenuOption|AuroMenuOption[]"
                   }
-                },
+                }
+              ],
+              "description": "Deselects one or more options in a batch operation"
+            },
+            {
+              "kind": "method",
+              "name": "selectOption",
+              "parameters": [
                 {
-                  "name": "mask",
-                  "description": "The date mask to use for parsing.",
+                  "name": "option",
                   "type": {
-                    "text": "string"
+                    "text": "AuroMenuOption"
                   }
                 }
               ],
-              "description": "Parses a date string using the provided mask.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
+              "description": "Selects a single option."
+            },
+            {
+              "kind": "method",
+              "name": "deselectOption",
+              "parameters": [
+                {
+                  "name": "option",
+                  "type": {
+                    "text": "AuroMenuOption"
+                  }
                 }
-              }
+              ],
+              "description": "Deselects a single option."
             },
             {
               "kind": "method",
-              "name": "getMaskOptions",
+              "name": "toggleOption",
               "parameters": [
                 {
-                  "name": "type",
-                  "description": "The input type.",
+                  "name": "option",
                   "type": {
-                    "text": "string"
+                    "text": "AuroMenuOption"
                   }
-                },
+                }
+              ],
+              "description": "Toggles the selection state of a single option."
+            },
+            {
+              "kind": "method",
+              "name": "selectByValue",
+              "parameters": [
                 {
-                  "name": "format",
-                  "description": "The format of the mask to apply.",
+                  "name": "value",
+                  "description": "The value(s) to select.",
+                  "type": {
+                    "text": "string|number|Array<string|number>"
+                  }
+                }
+              ],
+              "description": "Selects options based on their value(s) when compared to a passed value or values.\nValue or values are normalized to an array of strings that can be matched to option keys."
+            },
+            {
+              "kind": "method",
+              "name": "queuePendingValue",
+              "parameters": [
+                {
+                  "name": "value",
+                  "description": "The value to retry.",
+                  "type": {
+                    "text": "string|number|Array<string|number>"
+                  }
+                }
+              ],
+              "description": "Queues a pending value and schedules a bounded retry."
+            },
+            {
+              "kind": "method",
+              "name": "clearPendingValue",
+              "description": "Clears pending retry state."
+            },
+            {
+              "kind": "method",
+              "name": "reset",
+              "description": "Resets the selected options to an empty array."
+            },
+            {
+              "kind": "method",
+              "name": "subscribe",
+              "parameters": [
+                {
+                  "name": "callback",
+                  "description": "The callback to invoke on events.",
+                  "type": {
+                    "text": "Function"
+                  }
+                }
+              ],
+              "description": "Subscribes a callback to menu service events."
+            },
+            {
+              "kind": "method",
+              "name": "unsubscribe",
+              "parameters": [
+                {
+                  "name": "callback",
+                  "type": {
+                    "text": "Function"
+                  }
+                }
+              ],
+              "description": "Remove a previously subscribed callback from menu service events."
+            },
+            {
+              "kind": "method",
+              "name": "stageUpdate",
+              "parameters": [
+                {
+                  "name": "meta",
+                  "default": "{}"
+                }
+              ],
+              "description": "Stages an update to notify subscribers of state and value changes."
+            },
+            {
+              "kind": "method",
+              "name": "notify",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The event to send to subscribers.",
                   "type": {
                     "text": "string"
                   }
                 }
               ],
-              "description": "Configures the mask to be used on the input element based on format and/or type.\nIMask tool documentation: https://imask.js.org/.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "object"
+              "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": "isFullDateFormat",
+              "name": "notifyValueChange",
               "parameters": [
                 {
-                  "name": "type",
-                  "description": "The input type.",
+                  "name": "meta",
+                  "default": "{}"
+                }
+              ],
+              "description": "Notifies subscribers of a value change (current value has changed)."
+            },
+            {
+              "kind": "method",
+              "name": "dispatchChangeEvent",
+              "parameters": [
+                {
+                  "name": "eventName",
                   "type": {
                     "text": "string"
                   }
                 },
                 {
-                  "name": "format",
-                  "description": "The date format string.",
+                  "name": "detail",
                   "type": {
-                    "text": "string"
+                    "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": "Determines if the given type and format combination represents a full year/month/day date.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              }
+              "description": "Adds a menu option to the service's list."
             },
             {
               "kind": "method",
-              "name": "toModelValue",
+              "name": "removeMenuOption",
               "parameters": [
                 {
-                  "name": "inputValue",
-                  "description": "String from the rendered input.",
+                  "name": "option",
+                  "description": "the option to remove",
                   "type": {
-                    "text": "string"
+                    "text": "AuroMenuOption"
                   }
-                },
+                }
+              ],
+              "description": "Removes a menu option from the service's list."
+            },
+            {
+              "kind": "method",
+              "name": "_getNormalizedValues",
+              "parameters": [
                 {
-                  "name": "format",
-                  "description": "The date format string.",
+                  "name": "value",
+                  "description": "The value(s) to normalize.",
                   "type": {
-                    "text": "string"
+                    "text": "string|number|Array<string|number>"
                   }
                 }
               ],
-              "description": "Converts a display string to its model value.\nFor full date formats, converts the display string to an ISO date string.",
-              "privacy": "private",
+              "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": "string"
+                  "text": "Array<string>"
                 }
               }
             },
             {
               "kind": "method",
-              "name": "toFormattedValue",
+              "name": "optionsArraysMatch",
               "parameters": [
                 {
-                  "name": "valueObject",
-                  "description": "Date object representation of value.",
+                  "name": "arr1",
+                  "description": "First array of options.",
                   "type": {
-                    "text": "Date|undefined"
+                    "text": "AuroMenuOption[]"
                   }
                 },
                 {
-                  "name": "format",
-                  "description": "The date format string.",
+                  "name": "arr2",
+                  "description": "Second array of options.",
                   "type": {
-                    "text": "string"
+                    "text": "AuroMenuOption[]"
                   }
                 }
               ],
-              "description": "Converts a model value to a display value for the input element.\nFor full date formats, converts an ISO model value to the configured display format.",
-              "privacy": "private",
+              "description": "Returns whether two arrays of options contain the same elements.",
               "return": {
                 "type": {
-                  "text": "string | undefined"
+                  "text": "boolean"
                 }
               }
             },
             {
               "kind": "field",
-              "name": "overrideFormat"
+              "name": "host",
+              "default": "host"
             },
             {
               "kind": "field",
-              "name": "formatter",
-              "default": "new Intl.DateTimeFormat(this.locale)"
-            }
-          ]
-        },
-        {
-          "kind": "function",
-          "name": "getDateFormatFromLocale",
-          "parameters": [
-            {
-              "name": "locale",
-              "description": "BCP 47 language tag used to determine the date format (e.g. \"en-US\", \"fr-FR\").",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Derives a locale-aware date format string suitable for use in input masks. This helper exposes the internal AuroInputUtilities locale logic in a simple function form.",
-          "return": {
-            "type": {
-              "text": "string"
-            }
-          }
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AuroInputUtilities",
-          "declaration": {
-            "name": "AuroInputUtilities",
-            "module": "components/input/src/utilities.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getDateFormatFromLocale",
-          "declaration": {
-            "name": "getDateFormatFromLocale",
-            "module": "components/input/src/utilities.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/layoutElement/src/auroElement.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AuroElement",
-          "members": [
-            {
-              "kind": "field",
-              "name": "componentHasFocus",
-              "description": "Returns true if the element has focus.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "readonly": true
+              "name": "size",
+              "default": "undefined"
             },
             {
-              "kind": "method",
-              "name": "resetShapeClasses"
+              "kind": "field",
+              "name": "shape",
+              "default": "undefined"
             },
             {
-              "kind": "method",
-              "name": "resetLayoutClasses"
+              "kind": "field",
+              "name": "noCheckmark",
+              "default": "undefined"
             },
             {
-              "kind": "method",
-              "name": "updateComponentArchitecture"
+              "kind": "field",
+              "name": "disabled",
+              "default": "undefined"
             },
             {
               "kind": "field",
-              "name": "layout",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "description": "Defines the language of an element.",
-              "default": "{'default'}",
-              "attribute": "layout",
-              "reflects": true
+              "name": "matchWord",
+              "default": "undefined"
             },
             {
               "kind": "field",
-              "name": "shape",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "shape",
-              "reflects": true
+              "name": "multiSelect",
+              "default": "undefined"
             },
             {
               "kind": "field",
-              "name": "size",
-              "privacy": "public",
-              "type": {
-                "text": "string"
-              },
-              "attribute": "size",
-              "reflects": true
+              "name": "allowDeselect",
+              "default": "undefined"
             },
             {
               "kind": "field",
-              "name": "onDark",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "attribute": "ondark",
-              "reflects": true
-            }
-          ],
-          "attributes": [
-            {
-              "name": "layout",
-              "type": {
-                "text": "string"
-              },
-              "description": "Defines the language of an element.",
-              "default": "{'default'}",
-              "fieldName": "layout"
+              "name": "selectAllMatchingOptions",
+              "default": "undefined"
             },
             {
-              "name": "shape",
+              "kind": "field",
+              "name": "highlightedIndex",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "fieldName": "shape"
+              "default": "-1"
             },
             {
-              "name": "size",
+              "kind": "field",
+              "name": "_menuOptions",
               "type": {
-                "text": "string"
+                "text": "array"
               },
-              "fieldName": "size"
+              "default": "[]"
             },
-            {
-              "name": "ondark",
-              "type": {
-                "text": "boolean"
-              },
-              "fieldName": "onDark"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AuroElement",
-          "declaration": {
-            "name": "AuroElement",
-            "module": "components/layoutElement/src/auroElement.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/layoutElement/src/index.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AuroElement",
-          "declaration": {
-            "name": "AuroElement",
-            "module": "components/layoutElement/src/index.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/layoutElement/src/registered.js",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/menu/src/auro-menu-utils.js",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "arrayConverter",
-          "parameters": [
-            {
-              "name": "value",
-              "description": "The value to be converted. Can be a string, array, or undefined.",
-              "type": {
-                "text": "any"
-              }
-            }
-          ],
-          "description": "Converts value to an array.\nIf the value is a JSON string representing an array, it will be parsed.\nIf the value is already an array, it is returned.\nIf the value is undefined, it returns undefined.",
-          "privacy": "private",
-          "return": {
-            "type": {
-              "text": "Array|undefined"
-            }
-          }
-        },
-        {
-          "kind": "function",
-          "name": "arraysAreEqual",
-          "parameters": [
-            {
-              "name": "arr1",
-              "description": "First array to compare.",
+            {
+              "kind": "field",
+              "name": "_subscribers",
               "type": {
-                "text": "Array"
-              }
+                "text": "array"
+              },
+              "default": "[]"
             },
             {
-              "name": "arr2",
-              "description": "Second array to compare.",
+              "kind": "field",
+              "name": "internalUpdateInProgress",
               "type": {
-                "text": "Array"
-              }
-            }
-          ],
-          "description": "Compare two arrays for equality.",
-          "privacy": "private",
-          "return": {
-            "type": {
-              "text": "boolean"
-            }
-          }
-        },
-        {
-          "kind": "function",
-          "name": "isOptionInteractive",
-          "parameters": [
+                "text": "boolean"
+              },
+              "default": "false"
+            },
             {
-              "name": "option",
-              "description": "The option to check.",
+              "kind": "field",
+              "name": "selectedOptions",
               "type": {
-                "text": "HTMLElement"
-              }
-            }
-          ],
-          "description": "Validates if an option can be interacted with.",
-          "privacy": "private",
-          "return": {
-            "type": {
-              "text": "boolean"
-            }
-          }
-        },
-        {
-          "kind": "function",
-          "name": "dispatchMenuEvent",
-          "parameters": [
+                "text": "array"
+              },
+              "default": "[]"
+            },
             {
-              "name": "element",
-              "description": "Element to dispatch event from.",
+              "kind": "field",
+              "name": "_pendingValue",
               "type": {
-                "text": "HTMLElement"
-              }
+                "text": "null"
+              },
+              "default": "null"
             },
             {
-              "name": "eventName",
-              "description": "Name of the event to dispatch.",
+              "kind": "field",
+              "name": "_pendingRetryScheduled",
               "type": {
-                "text": "string"
-              }
+                "text": "boolean"
+              },
+              "default": "false"
             },
             {
-              "name": "detail",
-              "default": "null",
-              "description": "Optional detail object to include with the event.",
-              "optional": true,
+              "kind": "field",
+              "name": "_pendingRetryCount",
               "type": {
-                "text": "Object"
-              }
+                "text": "number"
+              },
+              "default": "0"
             }
-          ],
-          "description": "Helper method to dispatch custom events."
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "MenuContext"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "arrayConverter",
-          "declaration": {
-            "name": "arrayConverter",
-            "module": "components/menu/src/auro-menu-utils.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "arraysAreEqual",
-          "declaration": {
-            "name": "arraysAreEqual",
-            "module": "components/menu/src/auro-menu-utils.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "isOptionInteractive",
+          "name": "MenuService",
           "declaration": {
-            "name": "isOptionInteractive",
-            "module": "components/menu/src/auro-menu-utils.js"
+            "name": "MenuService",
+            "module": "components/menu/src/auro-menu.context.js"
           }
         },
         {
           "kind": "js",
-          "name": "dispatchMenuEvent",
+          "name": "MenuContext",
           "declaration": {
-            "name": "dispatchMenuEvent",
-            "module": "components/menu/src/auro-menu-utils.js"
+            "name": "MenuContext",
+            "module": "components/menu/src/auro-menu.context.js"
           }
         }
       ]
@@ -16035,31 +16571,25 @@
           ],
           "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"
-                  }
+              "kind": "field",
+              "name": "currentLabel",
+              "readonly": true,
+              "return": {
+                "type": {
+                  "text": "string"
                 }
-              ],
-              "description": "This will register this element with the browser."
+              }
             },
             {
               "kind": "field",
-              "name": "options",
+              "name": "items",
               "readonly": true,
               "return": {
                 "type": {
                   "text": "Array<HTMLElement>"
                 }
-              }
+              },
+              "deprecated": "Use `options` property instead."
             },
             {
               "kind": "field",
@@ -16080,262 +16610,207 @@
               ]
             },
             {
-              "kind": "field",
-              "name": "selectedOptions",
-              "description": "Gets the currently selected options as an array.",
-              "return": {
-                "type": {
-                  "text": "Array<HTMLElement>"
+              "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"
+                  }
                 }
-              },
-              "readonly": true
+              ],
+              "description": "This will register this element with the browser."
             },
             {
               "kind": "field",
-              "name": "selectedOption",
-              "description": "Gets the first selected option, or null if none.",
+              "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": "HTMLElement|null"
+                  "text": "String|Array<String>"
                 }
               },
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "currentLabel",
-              "readonly": true,
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "formattedValue",
-              "description": "Formatted value based on `multiSelect` state.\nDefault type is `String`, changing to `Array<String>` when `multiSelect` is true.",
+              "name": "propertyValues",
+              "description": "Gets the current property values for the menu service.",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "String|Array<String>"
+                  "text": "Object"
                 }
               },
               "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"
-            },
-            {
-              "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": "updateItemsState",
-              "parameters": [
-                {
-                  "name": "changedProperties",
-                  "description": "LitElement's changed properties map.",
-                  "type": {
-                    "text": "Map<string, boolean>"
-                  }
-                }
-              ],
-              "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": "handleSelectState",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "The option element to select.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Updates menu state when an option is selected.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "handleDeselectState",
-              "parameters": [
-                {
-                  "name": "option",
-                  "description": "The menuoption to be deselected.",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                }
-              ],
-              "description": "Deselects a menu option and updates related state.",
-              "privacy": "private"
-            },
-            {
-              "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"
+              "name": "provideContext",
+              "description": "Provides the menu context to child components.\nInitializes the MenuService and subscribes to menu changes.",
+              "privacy": "protected"
             },
             {
               "kind": "method",
-              "name": "handleNestedMenus",
+              "name": "updateActiveOption",
               "parameters": [
                 {
-                  "name": "menu",
-                  "description": "Root menu element.",
+                  "name": "option",
+                  "description": "The option to set as active.",
                   "type": {
                     "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Handles nested menu structure.",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "makeSelection",
-              "description": "Makes a selection based on the current index.",
-              "privacy": "private"
+              "description": "Updates the currently active option in the menu."
             },
             {
               "kind": "method",
-              "name": "toggleOption",
+              "name": "setInternalValue",
               "parameters": [
                 {
-                  "name": "option",
-                  "description": "The menuoption to toggle.",
+                  "name": "value",
+                  "description": "The value to set.",
                   "type": {
-                    "text": "HTMLElement"
+                    "text": "String|Array<String>"
                   }
                 }
               ],
-              "description": "Toggle the selection state of the menuoption.",
-              "privacy": "private"
+              "description": "Sets the internal value and manages update state.",
+              "privacy": "protected"
             },
             {
               "kind": "method",
-              "name": "handleKeyDown",
+              "name": "handleMenuChange",
               "parameters": [
                 {
                   "name": "event",
-                  "description": "The keydown event.",
+                  "description": "The event object from the menu service.",
                   "type": {
-                    "text": "KeyboardEvent"
+                    "text": "Object"
                   }
                 }
               ],
-              "description": "Handles keyboard navigation and selection.",
-              "privacy": "private"
+              "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": "handleMouseSelect",
+              "name": "setTagAttribute",
               "parameters": [
                 {
-                  "name": "event",
-                  "description": "The auroMenuOption-click event.",
+                  "name": "tagName",
+                  "description": "The tag name to set as an attribute.",
                   "type": {
-                    "text": "CustomEvent"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Handles option selection via click events from menuoptions.",
+              "description": "Sets an attribute that matches the default tag name if the tag name is not the default.",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleOptionHover",
+              "name": "setLoadingState",
               "parameters": [
                 {
-                  "name": "event",
-                  "description": "Event object from the browser.",
+                  "name": "isLoading",
+                  "description": "Whether the menu is loading.",
                   "type": {
-                    "text": "CustomEvent"
+                    "text": "boolean"
                   }
                 }
               ],
-              "description": "Handles option hover events.",
+              "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": "handleSlotChange",
-              "description": "Handles slot change events.",
+              "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": "navigateOptions",
+              "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": "direction",
-                  "description": "'up' or 'down'.",
+                  "name": "menu",
+                  "description": "Root menu element.",
                   "type": {
-                    "text": "string"
+                    "text": "HTMLElement"
                   }
                 }
               ],
-              "description": "Navigates through options using keyboard."
+              "description": "Handles nested menu structure.",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "updateActiveOption",
+              "name": "navigateOptions",
               "parameters": [
                 {
-                  "name": "indexOrOption",
-                  "description": "Index of the option or the option element to make active.",
+                  "name": "direction",
+                  "description": "The direction to navigate.",
                   "type": {
-                    "text": "number|HTMLElement"
+                    "text": "'up'|'down'"
                   }
                 }
               ],
-              "description": "Updates the active option state and dispatches events.\nAccepts either a numeric index or an HTMLElement option."
+              "description": "Navigates the menu options in the specified direction.",
+              "privacy": "protected"
+            },
+            {
+              "kind": "method",
+              "name": "handleSlotChange",
+              "description": "Handles slot change events.",
+              "privacy": "private"
             },
             {
               "kind": "method",
@@ -16357,9 +16832,12 @@
               "name": "notifySelectionChange",
               "parameters": [
                 {
-                  "name": "source",
-                  "default": "undefined",
+                  "name": "{value, stringValue, keys, options, reason}",
+                  "default": "{}"
+                },
+                {
                   "description": "The source that triggers this event.",
+                  "name": "source",
                   "type": {
                     "text": "any"
                   }
@@ -16368,32 +16846,6 @@
               "description": "Notifies selection change to parent components.",
               "privacy": "private"
             },
-            {
-              "kind": "method",
-              "name": "selectionEquals",
-              "parameters": [
-                {
-                  "name": "current",
-                  "description": "Current selection.",
-                  "type": {
-                    "text": "any"
-                  }
-                },
-                {
-                  "name": "next",
-                  "description": "New selection to compare.",
-                  "type": {
-                    "text": "any"
-                  }
-                }
-              ],
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              }
-            },
             {
               "kind": "method",
               "name": "isOptionSelected",
@@ -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"
-          }
-        }
-      ]
     }
   ]
 }