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

package/custom-elements.json

@@ -2,269 +2,6 @@
   "schemaVersion": "1.0.0",
   "readme": "",
   "modules": [
-    {
-      "kind": "javascript-module",
-      "path": "components/bibtemplate/src/auro-bibtemplate.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "The `auro-bibtemplate` element provides users a template for creating modal dialog elements.",
-          "name": "AuroBibtemplate",
-          "slots": [
-            {
-              "description": "The default slot for the main content.",
-              "name": "default"
-            },
-            {
-              "description": "Slot for the header content.",
-              "name": "header"
-            },
-            {
-              "description": "Slot for the subheader content.",
-              "name": "subheader"
-            },
-            {
-              "description": "Slot for the footer content.",
-              "name": "footer"
-            },
-            {
-              "description": "Slot for the close button aria-label.",
-              "name": "ariaLabel.close"
-            }
-          ],
-          "members": [
-            {
-              "kind": "method",
-              "name": "register",
-              "static": true,
-              "parameters": [
-                {
-                  "name": "name",
-                  "default": "\"auro-bibtemplate\"",
-                  "description": "The name of element that you want to register to.",
-                  "optional": true,
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "This will register this element with the browser."
-            },
-            {
-              "kind": "method",
-              "name": "preventBodyScroll",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The touchmove event.",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Prevents scrolling of the body when touching empty areas of the component.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "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.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "onCloseButtonClick"
-            },
-            {
-              "kind": "method",
-              "name": "exposeCssParts",
-              "description": "Exposes CSS parts for styling from parent components.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "large",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "large",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "iconTag",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "headerTag",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "buttonTag",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "isFullscreen",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "attribute": "isFullscreen",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "showFooter",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
-              "attribute": "showFooter",
-              "reflects": true
-            }
-          ],
-          "events": [
-            {
-              "name": "close-click",
-              "type": {
-                "text": "Event"
-              }
-            },
-            {
-              "name": "auro-bibtemplate-connected",
-              "type": {
-                "text": "CustomEvent"
-              }
-            }
-          ],
-          "attributes": [
-            {
-              "name": "isFullscreen",
-              "type": {
-                "text": "boolean"
-              },
-              "fieldName": "isFullscreen"
-            },
-            {
-              "name": "large",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "large"
-            },
-            {
-              "name": "showFooter",
-              "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"
-          }
-        }
-      ]
-    },
-    {
-      "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": []
-    },
     {
       "kind": "javascript-module",
       "path": "components/checkbox/src/auro-checkbox-group.js",
@@ -980,131 +717,394 @@
               "fieldName": "checked"
             },
             {
-              "name": "disabled",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set to true, the checkbox will not be clickable.",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "error",
+              "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"
+            },
+            {
+              "name": "onDark",
+              "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"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "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/index.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/checkbox/src/registered.js",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/bibtemplate/src/auro-bibtemplate.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "The `auro-bibtemplate` element provides users a template for creating modal dialog elements.",
+          "name": "AuroBibtemplate",
+          "slots": [
+            {
+              "description": "The default slot for the main content.",
+              "name": "default"
+            },
+            {
+              "description": "Slot for the header content.",
+              "name": "header"
+            },
+            {
+              "description": "Slot for the subheader content.",
+              "name": "subheader"
+            },
+            {
+              "description": "Slot for the footer content.",
+              "name": "footer"
+            },
+            {
+              "description": "Slot for the close button aria-label.",
+              "name": "ariaLabel.close"
+            }
+          ],
+          "members": [
+            {
+              "kind": "method",
+              "name": "register",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "default": "\"auro-bibtemplate\"",
+                  "description": "The name of element that you want to register to.",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "This will register this element with the browser."
+            },
+            {
+              "kind": "method",
+              "name": "preventBodyScroll",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The touchmove event.",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Prevents scrolling of the body when touching empty areas of the component.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "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.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "onCloseButtonClick"
+            },
+            {
+              "kind": "method",
+              "name": "exposeCssParts",
+              "description": "Exposes CSS parts for styling from parent components.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "large",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "If set to true, the checkbox will not be clickable.",
-              "fieldName": "disabled"
+              "default": "false",
+              "attribute": "large",
+              "reflects": true
             },
             {
-              "name": "error",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set to true, the checkbox will be displayed with an error state.",
-              "fieldName": "error"
+              "kind": "field",
+              "name": "iconTag",
+              "privacy": "private"
             },
             {
-              "name": "id",
-              "type": {
-                "text": "string"
-              },
-              "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
-              "fieldName": "id"
+              "kind": "field",
+              "name": "headerTag",
+              "privacy": "private"
             },
             {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
-              "fieldName": "name"
+              "kind": "field",
+              "name": "buttonTag",
+              "privacy": "private"
             },
             {
-              "name": "onDark",
+              "kind": "field",
+              "name": "isFullscreen",
+              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
-              "fieldName": "onDark"
+              "attribute": "isFullscreen",
+              "reflects": true
             },
             {
-              "name": "value",
+              "kind": "field",
+              "name": "showFooter",
+              "privacy": "public",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
-              "fieldName": "value"
-            },
+              "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
+              "attribute": "showFooter",
+              "reflects": true
+            }
+          ],
+          "events": [
             {
-              "name": "tabindex",
+              "name": "close-click",
               "type": {
-                "text": "number"
-              },
-              "description": "The tabindex attribute for the checkbox.",
-              "fieldName": "tabIndex"
+                "text": "Event"
+              }
             },
             {
-              "name": "aria-checked",
+              "name": "auro-bibtemplate-connected",
               "type": {
-                "text": "string"
+                "text": "CustomEvent"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "isFullscreen",
+              "type": {
+                "text": "boolean"
               },
-              "description": "The aria-checked attribute for the checkbox.",
-              "fieldName": "ariaChecked"
+              "fieldName": "isFullscreen"
             },
             {
-              "name": "aria-disabled",
+              "name": "large",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "The aria-disabled attribute for the checkbox.",
-              "fieldName": "ariaDisabled"
+              "default": "false",
+              "fieldName": "large"
             },
             {
-              "name": "role",
+              "name": "showFooter",
               "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.",
-              "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": []
     },
@@ -2041,7 +2041,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Value selected for the dropdown menu.",
+              "description": "Value selected for the dropdown menu. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` and `optionSelected` are cleared to `undefined`. `hidden` options (including those filtered out by type-ahead) remain selectable by value.",
               "attribute": "value"
             },
             {
@@ -2443,7 +2443,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Value selected for the dropdown menu.",
+              "description": "Value selected for the dropdown menu. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` and `optionSelected` are cleared to `undefined`. `hidden` options (including those filtered out by type-ahead) remain selectable by value.",
               "fieldName": "value"
             },
             {
@@ -16533,6 +16533,26 @@
             }
           }
         },
+        {
+          "kind": "function",
+          "name": "serializeMultiSelectValue",
+          "parameters": [
+            {
+              "name": "values",
+              "description": "The selected values.",
+              "type": {
+                "text": "Array<string>|undefined"
+              }
+            }
+          ],
+          "description": "Serializes a multi-select value array back into the String `value` property.\nAn empty (or missing) array collapses to `undefined` so an emptied selection\nclears `value` rather than reflecting a `\"[]\"` attribute.",
+          "privacy": "private",
+          "return": {
+            "type": {
+              "text": "string|undefined"
+            }
+          }
+        },
         {
           "kind": "function",
           "name": "arraysAreEqual",
@@ -16580,6 +16600,25 @@
             }
           }
         },
+        {
+          "kind": "function",
+          "name": "isSelectableByValue",
+          "parameters": [
+            {
+              "name": "option",
+              "description": "The option to check.",
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ],
+          "description": "Validates if an option may be selected by matching a programmatic value.\nUnlike `isOptionInteractive`, `hidden` is allowed: the combobox toggles\n`hidden` as its type-ahead filter, so a filtered-out option is still a\nvalid programmatic selection. Only disabled and static options — which are\nnever selectable — are rejected.",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          }
+        },
         {
           "kind": "function",
           "name": "dispatchMenuEvent",
@@ -16620,6 +16659,14 @@
             "module": "components/menu/src/auro-menu-utils.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "serializeMultiSelectValue",
+          "declaration": {
+            "name": "serializeMultiSelectValue",
+            "module": "components/menu/src/auro-menu-utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "arraysAreEqual",
@@ -16636,6 +16683,14 @@
             "module": "components/menu/src/auro-menu-utils.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "isSelectableByValue",
+          "declaration": {
+            "name": "isSelectableByValue",
+            "module": "components/menu/src/auro-menu-utils.js"
+          }
+        },
         {
           "kind": "js",
           "name": "dispatchMenuEvent",
@@ -16770,7 +16825,7 @@
                   }
                 }
               ],
-              "description": "Selects options by value.",
+              "description": "Selects options by value. Options marked `disabled` or `static` are not selectable; `hidden` options remain selectable. In single-select mode, if the value matches a non-selectable option the selection is cleared and `auroMenu-selectValueFailure` is dispatched. In multi-select mode, non-selectable entries are dropped and the remaining selectable entries are selected; `auroMenu-selectValueFailure` is dispatched only when none of the entries match a selectable option. Passing `undefined`, `null`, an empty string, or an empty array clears the selection without dispatching a failure.",
               "privacy": "public"
             },
             {
@@ -17120,7 +17175,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.",
+              "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.\nOptions marked `disabled` or `static` are not selectable by value; `hidden` options remain selectable. In single-select mode, if the value matches a non-selectable option the selection is cleared (`optionSelected` becomes `undefined`) and `auroMenu-selectValueFailure` is dispatched. In multi-select mode, non-selectable entries are dropped from the value and the remaining selectable entries are selected; `auroMenu-selectValueFailure` is dispatched only when none of the entries match a selectable option.",
               "default": "undefined",
               "attribute": "value",
               "reflects": true
@@ -17132,9 +17187,9 @@
               "type": {
                 "text": "object"
               },
-              "description": "An array of currently selected menu options, type `HTMLElement` by default. In multi-select mode, `optionSelected` is an array of HTML elements.",
-              "default": "undefined",
-              "attribute": "optionSelected"
+              "description": "The currently selected menu option(s). In single-select mode this is a single `HTMLElement` (or `undefined` when nothing is selected). In multi-select mode this is an array of `HTMLElement`s.",
+              "readonly": true,
+              "default": "undefined"
             },
             {
               "kind": "field",
@@ -17167,8 +17222,8 @@
                 "text": "object"
               },
               "description": "Specifies the current active menuOption.",
-              "default": "undefined",
-              "attribute": "optionactive"
+              "readonly": true,
+              "default": "undefined"
             },
             {
               "kind": "field",
@@ -17380,30 +17435,12 @@
               "default": "false",
               "fieldName": "noCheckmark"
             },
-            {
-              "name": "optionactive",
-              "type": {
-                "text": "object"
-              },
-              "description": "Specifies the current active menuOption.",
-              "default": "undefined",
-              "fieldName": "optionActive"
-            },
-            {
-              "name": "optionSelected",
-              "type": {
-                "text": "object"
-              },
-              "description": "An array of currently selected menu options, type `HTMLElement` by default. In multi-select mode, `optionSelected` is an array of HTML elements.",
-              "default": "undefined",
-              "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.",
+              "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.\nOptions marked `disabled` or `static` are not selectable by value; `hidden` options remain selectable. In single-select mode, if the value matches a non-selectable option the selection is cleared (`optionSelected` becomes `undefined`) and `auroMenu-selectValueFailure` is dispatched. In multi-select mode, non-selectable entries are dropped from the value and the remaining selectable entries are selected; `auroMenu-selectValueFailure` is dispatched only when none of the entries match a selectable option.",
               "default": "undefined",
               "fieldName": "value"
             },
@@ -17620,6 +17657,8 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "**Deprecated.** Use the `value` attribute on `auro-menu` to set the selected option when the menu renders (or call `menu.selectByValue(value)` programmatically). Support for the child-level `selected` attribute will be removed in a future major release.",
+              "deprecated": "Use the `value` attribute on `auro-menu` instead.",
               "default": "false",
               "attribute": "selected",
               "reflects": true
@@ -17658,6 +17697,18 @@
               "attribute": "nomatch",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "persistent",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, this option is excluded from `matchWord` DOM rewriting — useful for utility rows (e.g., \"Add new…\") that must render identically regardless of the current filter.",
+              "default": "false",
+              "attribute": "persistent",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "tabIndex",
@@ -17783,6 +17834,13 @@
             }
           ],
           "attributes": [
+            {
+              "type": {
+                "text": "Boolean"
+              },
+              "description": "When present, marks the option as non-interactive — it renders but is skipped during keyboard navigation and cannot be selected. Useful for section headers, informational rows inside a menu, or attaching event listeners.",
+              "name": "static"
+            },
             {
               "name": "noCheckmark",
               "type": {
@@ -17796,6 +17854,8 @@
               "type": {
                 "text": "boolean"
               },
+              "description": "**Deprecated.** Use the `value` attribute on `auro-menu` to set the selected option when the menu renders (or call `menu.selectByValue(value)` programmatically). Support for the child-level `selected` attribute will be removed in a future major release.",
+              "deprecated": "Use the `value` attribute on `auro-menu` instead.",
               "default": "false",
               "fieldName": "selected"
             },
@@ -17838,6 +17898,15 @@
               "default": "false",
               "fieldName": "noMatch"
             },
+            {
+              "name": "persistent",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, this option is excluded from `matchWord` DOM rewriting — useful for utility rows (e.g., \"Add new…\") that must render identically regardless of the current filter.",
+              "default": "false",
+              "fieldName": "persistent"
+            },
             {
               "name": "layout",
               "type": {
@@ -19387,9 +19456,14 @@
               "name": "setMenuValue",
               "parameters": [
                 {
-                  "name": "value"
+                  "name": "value",
+                  "description": "The value to match against the menu options.",
+                  "type": {
+                    "text": "string"
+                  }
                 }
-              ]
+              ],
+              "description": "Sets the selected value by matching it against the menu options. Options marked `disabled` or `static` are not selectable: if the value matches one, the selection is rejected and `value` is cleared to `undefined` while `optionSelected` is cleared to `undefined` in single-select or `[]` in multiSelect. `hidden` options remain selectable."
             },
             {
               "kind": "method",
@@ -20002,7 +20076,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Value selected for the component.",
+              "description": "Value selected for the component. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` is cleared to `undefined` while `optionSelected` is cleared to `undefined` in single-select or `[]` in multiSelect. `hidden` options remain selectable by value.",
               "attribute": "value",
               "reflects": true
             },
@@ -20351,7 +20425,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Value selected for the component.",
+              "description": "Value selected for the component. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` is cleared to `undefined` while `optionSelected` is cleared to `undefined` in single-select or `[]` in multiSelect. `hidden` options remain selectable by value.",
               "fieldName": "value"
             },
             {